DolphiCam Research User Manual
Contents
1. 1 Paraview http www paraview org 192. DolphiCam DataAnalyzer or any other tool that can read HDF5 files The DolphiCam DataAnalyzer is a post procsssing analyzing tool which comes with DolphiCam Research that can be downloaded from http www dolphitech com at Support Software Download Furthermore the DolphiCam DataAnalyzer can ex port data in the vti VTK format These files can then be opened in ParaView for advanced 3D visualization see the DolphiCam DataAnalyzer user manual for more information The included data files in the DolphiCam Research package is shown in Table 1 File Description data_air_filtered rdf CF08 Pulse 1 transducer in air filtered data data_air_filtered hdf5 data_air_unfiltered rdf CF08 Pulse 1 transducer in air unfiltered data data_air_unfiltered hdf5 data plexiglass filtered hdf5 CF08 Pulse 1 plexiglass flower filtered data data_plexiglass_filtered hdf5 data plexiglass filtered vti data plexiglass unfiltered hdf5 CFOS Pulse 1 plexiglass flower unfiltered data data_plexiglass_unfiltered hdf5 data_plexiglass_unfiltered vti plexi_flower_wiener vti CF08 Pulse 1 processed with the Wiener filter Table 1 Example data files included in DolphiCam Research lFor Matlab one can also use the corresponding menu to add the path iD April 20 2015 Revision 4327 3 New GUI Elements for the DolphiCam Research The DolphiCam Research Windows application h
3. SoftwareVersion SoftwareVersion is a string with the software version used Example 1 3 3450 A 5 IsAssumedToBeInitialized IsAssumedToBeInitialized is a Boolean for internal use only Example False aD April 20 2015 Revision 4327 A 6 CurrentSettingsFileName CurrentSettingsFileName is a string with the name of the current settings file if any Example Default A 7 FpgaVersion FpgaVersion is an integer with the major version of the FPGA firmware Example 135 A 8 FpgaSubVersion FpgaSubVersion is an integer with the minor version of the FPGA firmware Example 13 A 9 HardwareVersion HardwareVersion is an integer with model type of the camera A HardwareVersion lt 10 is a CF08 camera and a HardwareVersion gt 10 is a CF16 camera Example 10 A 10 HoldOffTime HoldOffTime is an integer with the number of samples from the start of the transmit pulse to the start of the data acquisition Example 360 A 11 AmplitudeGatingStart AmplitudeGatingStart is an integer with the start sample index of the 1st amplitude gate for future use Example 10 aD April 20 2015 Revision 4327 50 A 12 AmplitudeGatingEnd is an integer with the end sample index of the 1st amplitude gate for future use AmplitudeGatingEnd Example 350 A 13 Time0fFlightGatingStart TimeOfFlightGatingStart is an integer with the start sample index of the 1st time of flight gate for futu
4. a C scan with the mouse clicks and then Window 2 shows a vertical and a horizontal B scan as well as an A scan according to the position that was selected in Window 1 Figure 2 shows an example an impact damage in a 6mm CFRP plate of using the dc_data_ viewer function Y Axis B Scan C scan C scan 2000 1800 S S 5 5 1600 iu fri 1400 T 3 3 1200 gt 100 200 40 60 80 100 120 E a Sample Index Element 5 Es 2 1000 8 A Scan X Axis B Scan 2000 a E 800 lt T 3 1000 z o 600 9 lt ofl WYNN A N E 400 3 5 E 1000 200 2000 20 40 60 80 100 120 0 100 200 300 40 60 80 100 120 Element Sample Index Element a Window 1 b Window 2 Figure 2 Illustration of the dc_data_viewer function aD April 20 2015 Revision 4327 A File Header Description A l DataDimension DataDimension is a 6 element vector which describes the dimension of the data The first four numbers describe element layout of the 2D array the it s a 124 x 124 element sensor and the last two numbers describe the A scan length of the data i e start and stop indexes of the A scan Example O O 123 123 O 359 A 2 TimeStamp TimeStamp is a string with the time stamp when the file was created by the DolphiCam TM Windows application Example 2015 01 21_15 12 09 A 3 CameraSerialNumber is a string with the serial number of the camera CameraSerialNumber Example 13060013 A 4
5. when the data is acquired the new file is stored in the C Programdata DolphiTech DolphiCam RawData folder Start Scan The Start Scan Stop Scan button toggles live scanning Note It takes 12 seconds to acquire a CF08 data set and 24 seconds to acquire a CF16 data set respectively During this time the camera should not be moved otherwise there will be distortions in the acquired data 4 Importing and Viewing DolphiCam Data in Mat lab Octave The DolphiCam Research comes with a set of m files for reading and viewing ultrasound data in Matlab or Octave 4 1 load dc data The 1oad dc data function reads ultrasound data in the rdf text format The function takes a string with the rdf file name as input and returns the ultrasound data in a matrix gt gt Y load dc data DolphiCam 13430025 2015 01 27 13 04 45 rdf The output matrix as an L x 124 1 matrix where L is the A scan length and 124 is the total number of transducer elements on the 2D array The first column in the output matrix contains a sample index vector and remaining columns contain ultrasound data for the corresponding array elements 4 2 dc_data_viewer The dc_data_viewer function can be used for quick viewing of the data It takes a matrix in the format returned by the load_dc_data function gt gt dc_data_viewer Y aD April 20 2015 Revision 4327 and presents two windows of the data In Window 1 one first selects the position in
6. 15 Revision 4327 DOI ee AA Aaa RA oe Ge ow ND 13 FS Ca ra nu ah AA AE NN 13 AJO CameraType on ce ore a RR erur apes FER RR ORG 13 A 27 IsTimeCalibrationActive o 13 A 23 IaScanButtonRegisterB6b eo PR RR RD ER RR Od a yd 14 2 209 IsScanButtonPushed e oa e RO ea A ka RR AH 14 A bk ae YS II NI 14 A 31 NumberOfTransmittingElements Og 14 A 32 AveragesPerTransducerElement ug 14 A33 MIN 15 Fn eh i ora s rdu AA AFF FN NF wD 15 A 35 MatchFilterDivideFactor FR RR A ER UR A 15 A 36 TxPulseShapeAndMatchFilter ug 15 a Ed A a ME TT _ ek E EE Y NND 15 Fie WOM a bo MAT ne KOS RR EG EE BEY REE PERS 16 A 39 IsTimeCorrectedGainActive 24646 dw Rw ee ee 16 A 40 IsTimeCorrectedGainSubpointsActive rr 16 A 4lTimeCorrectedGainValuB8 lt lt Y AR OR OE RK Re ED 16 A 42 TimeCorrectedGainValuesSubPoints I 16 sb 2 a RRA A RRA RARAS AS NU 17 AAS DacOffsetValue onaco ee RR WE RR EL RO EEL OO EES Ru RR 17 A 45 RecordingWindowSamples I ee ee 17 AAG TaRawPatehecording o oec h6 45442440466 Hebe ER ba yu 17 AAT FilterEnable sc coke eC ENA NO FAEN NEF 17 AAS EnablePulseSequence GP FR RR ER RR GR ER 054 18 AAY TzPulgebsg 2 CGA ana anar NY ie CN 18 AMINO a kk SAR h ASRS Oe ER ee eS a 18 fal EnableSleepMode seres wae wee EN A DE EUR EA AUU 18 AD SleepModeWarningTime ise bi hd ee vows ae Peed ee UR A 19 A 53 CameraScanTime e a RAR eRe RE
7. DolphiCam Research 1 3 User Manual Fredrik Lingvall April 20 2015 aD April 20 2015 Revision 4327 Contents 1 Introduction 2 Installation 3 New GUI Elements for the DolphiCam Research 4 Importing and Viewing DolphiCam Data in Matlab Octave Ok een Oo See ck a ee Ee Ee ee See ee ee ee we e A2 dedata viewer SS eu Oe Re RR ae Eee GW RW Bee eS wm A File Header Description Ad PataDinension ee RY SE ee a a ee ee foe Timeptanp o ie Ee BRE ERE Se ee Oe eee Ae CameraSerialNumber lt o gt RA ee eee eee ee ee Re RE AA WR bn o oia AS Iehesumediobelwitislized cisco ke a A 6 CurrentSettingsFileName ug AT Fppalersion a hw ea ws EU YR UU YW EI REEDS es AS FpgacubVWergiok oaoa nuoraa RD PGS eee REP SERS A a os es b doaie di aioe RE BY OS ee ae eee UG a o e ea o or eee de ee NFYFC CEFN ee a i Sl AnplitudeGatingstart sf so ss Pee pa Sa POS eed RA AAD AmplitudeGatingEmd 4 00 conri REPRESS AJS TIMO IU OCIOSO lt o sco eaa ee eR ee RA a AJA TimenfPlightGatingEnd gt oa o PY RR EP GR YRR ae aed amp A 15 AmplitudeGatimpBtart2 coccion e we one naem s AuMCAwplitudeG A DD cierra RH RD A yn A V7 Time0fFlightGatingBtarb2 ce sca be bie DRA RR RR Fu bn WR yn bo ary sd cr PR ew ee bd ae A NE A IG Amg litideGatinestarte o co SR RR ER RY Eee RR Ee EAR A TAPIA UI AIRES sa ORR ia a A31 Time0fFlightGatingStart3 coco RE REU eee da A22TimeD fFlimwtGatinsEnd8 wk ll rra A ER RR E8 pa ee ANNAN Mm April 20 20
8. EERE OEE R 19 BOA DceCorrection copar Ee RE RAR ee OR A 19 Mm April 20 2015 Revision 4327 1 Introduction This document describes DolphiCam Research version 1 3 of the DolphiCam acous tic camera DolphiCam Research is a variant of the normal DolphiCamTM with ad ditional support for saving ultrasound sensor data and use user defined transmit pulses DolphiCam Research comes with a set of m files for loading and analyzing data in Mat lab or GNU Octave DolphiCam Research also comes with the DolphiCam DataAn alyzer software which is stand alone tool for analyzing and viewing DolphiCam data as well as to export data to powerful 3D viewers such as ParaView 1 2 Installation Before installing the DolphiCam Research Windows software one must first have in stalled the standard Windows software as described in the DolphiCam user manual Then the DolphiCam Research can be installed by decompressing the zip file package DolphiCam Research Beta zip on a suitable location on the disk The DolphiCam Research package contains the following files and folders DolphiCam_Research_Beta README txt dc_research_userman_xxxx pdf DolphiCam Research Software lt Windows sw and camera fw gt m_files Contents m dc_data_viewer m load_dc_data m example_data data_air_filtered hdf5 data_air_filtered rdf data_air_unfiltered hdf5 data_air_unfiltered rdf data_plexiglass_filtered hdf5 data_plexiglass_fil
9. as a new window for acquiring data in its graphical user interface GUI which is shown in Figure 1 Dornen S Envelope Filter Custom pulse Y Pulse sequence clock cycles of 1 64MHz 11 6 15 6 4 10 10 Hi L Hi L i Lo Hi Acquire Data Start Scan Figure 1 DolphiCam Research GUI The Research window is activated from the Tools menu by selecting the Research features item and it has the following elements Envelope The Envelope check box switches the envelop on and off in the A scan and the two B scans Filter The Filter check box switches filtering on and off when acquiring data Note that the filters can only be one of the 8 CF08 or 4 CF16 pre defined ones Custom pulse The Custom pulse editor has 8 fields where one can specify the number of clock cycles a 15 625 ns 1 64 MHz for each high and low of the pulse sequence One can define a maximum of four pulses in the pulse sequence where the allowed range for high parts are 4 15 clock cycles and 6 15 clock cycles for the low parts respectively The Set button programs the camera with the new pulse sequence and the Clear button clears all the fields in the pulse editor NB only the editor fields are cleared not the pulse sequence loaded in the camera 6 aD April 20 2015 Revision 4327 Acquire Data The Acquire Data button switches off scanning and starts the data ac quisition A pop up window will be shown during the data acquisition and
10. e index of the 3rd time of flight gate for future use Example 0 A 23 TxLine TxLine is an integer describing the current horizontal cross hair position for future use Example 31 A 24 RxLine RxLine is an integer describing the current vertical cross hair position for future use Example 31 A 25 CameraModeSwitch CameraModeSwitch is a string with the position of the of the mode switch on the camera Example Normal A 26 CameraType CameraType a string with the type of the DolphiCam Example Expert A 27 IsTimeCalibrationActive IsTimeCalibrationActive is a Boolean indicating whether time calibration is used or not for internal use only Example 13 aD April 20 2015 Revision 4327 True A 28 IsScanButtonRegisterSet IsScanButtonRegisterSet is a Boolean indicating the status of an internal register for internal use only Example False A 29 IsScanButtonPushed IsScanButtonPushed is a Boolean indicating if the scan button has been pressed on the camera for internal use only Example False A 30 IsLowBattery IsLowBattery is a Boolean which indicates if the battery was low when the data was acquired Example False A 31 NumberOfTransmittingElements Number0fTransmittingElements is an integer with the number of transmit elements used when acquiring the data Example 4 A 32 AveragesPerTransducerElement AveragesPerTransducerElement is an in
11. hat indicates whether a custom pulse is enabled or not Example False A 49 TxPulseSegA TxPulseSegA is the 2 byte integer which defines the first two pulses in of the pulse sequence definition Example 17990 which is 0x4646 in hexadecimal form The first nibble from left is the number of clock cycles the pulse is high and the second nibble is the number of cycles the pulse is low The format of the nibbles are H high L low OxHLHL The valid range of H is 0x00 0x04 0x0F 0 4 15 and the valid range of a range of L is 0x00 0x06 0x0F 0 6 15 If all H are gt 0 also in TxPulseSegB see Section A 50 then four pulses are used A 50 TxPulseSegB TxPulseSegB is the 2 byte integer which defines the last two pulses in of the pulse seguence definition see Section A 49 for a description of the format A 51 EnableSleepMode EnableSleepMode a Boolean that shows if the sleep mode feature is enabled Example True 18 Mm April 20 2015 Revision 4327 A 52 SleepModeWarningTime SleepModeWarningTime is the number of seconds that the sleep mode warning is shown before the camera enters sleep mode Example 15 A 53 CameraScanTime CameraScanTime is the number of minutes before the camera enters sleep mode Example 15 A 54 DcCorrection DcCorrection is a Boolean that indicates whether DC correction bias correction is on or not It should always be enabled Example True References
12. re use Example 50 A 14 Time0fFlightGatingEnd is an integer with the end sample index of the 1st time of flight gate for future use TimeOfFlightGatingEnd Example 350 A 15 AmplitudeGatingStart2 AmplitudeGatingStart2 is an integer with the start sample index of the 2nd amplitude gate for future use Example 0 A 16 AmplitudeGatingEnd2 AmplitudeGatingEnd2 is an integer with the end sample index of the 2nd amplitude gate for future use Example 0 11 aD April 20 2015 Revision 4327 A 17 TimeOfFlightGatingStart2 TimeOfFlightGatingStart2 is an integer with the start sample index of the 2nd time of flight gate for future use Example 0 A 18 TimeOfFlightGatingEnd2 TimeOfFlightGatingEnd2 is an integer with the end sample index of the 2nd time of flight gate for future use Example 0 A 19 AmplitudeGatingStart3 AmplitudeGatingStart3 is an integer with the start sample index of the 3rd amplitude gate for future use Example 0 A 20 AmplitudeGatingEnd3 AmplitudeGatingEna3 is an integer with the end sample index of the 3rd amplitude gate for future use Example 0 A 21 Time0fFlightGatingStart3 TimeOfFlightGatingStart3 is an integer with the start sample index of the 3rd time of flight gate for future use Example 0 12 aD April 20 2015 Revision 4327 A 22 Time0fFlightGatingEnd3 TimeOfFlightGatingEnd3 is an integer with the end sampl
13. teger with the number of averages used when acquiring the data Example 2 14 aD April 20 2015 Revision 4327 A 33 CaptureMethod CaptureMethod is one of the following strings CaptureGreatestAbsoluteValue CaptureHighestValue CaptureLowestValue which indicates the method used to create the C scan A 34 IsEnteringSleepMode IsEnteringSleepMode is a Boolean which indicates that the camera will sleep in the number seconds defined by SleepModeWarningTime which normally is 15 seconds see also Section A 52 Example False A 35 MatchFilterDivideFactor MatchFilterDivideFactor is an integer used internally when filtering the data Example 512 A 36 TxPulseShapeAndMatchFilter TxPulseShapeAndMatchFilter is an integer defining the pulse and the corresponding filter used when acquiring the data 1 8 for a CF08 camera and 1 4 for a CF16 camera Example 1 A 37 BScanXCoord BScanXCoord is an integer describing the current horizontal cross hair position for future use Example 62 15 aD April 20 2015 Revision 4327 A 38 BScanYCoord BScanYCoord is an integer describing the current horizontal cross hair position for future use Example 61 A 39 IsTimeCorrectedGainActive IsTimeCorrectedGainActive is a Boolean which indicates if time corrected gain is active Example False A 40 IsTimeCorrectedGainSubpointsActive IsTimeCorrectedGainSubpointsActive is a Boolean which indica
14. tered rdf data_plexiglass_filtered vti data_plexiglass_unfiltered hdf5 data_plexiglass_unfiltered rdf data_plexiglass_unfiltered vti plexi_flower_wiener vti The Windows software and firmware files for the camera are located the in DolphiCam Research Software folder There is currently no Windows installer for the DolphiCam Research Windows software the Windows application is simply started by running DolphiCam Research Software DolphiCam exe After starting the DolphiCam exe application one will be asked to install the Research firmware When the firmware has been loaded into camera one should have the new Research features enabled see Section 3 4 aD April 20 2015 Revision 4327 The Matlab Octave functions are located the in the m files folder To use these functions one needs set the Matlab or Octave path to the folder containing the m files The path can be set by for example adding addpath home my_user dc_research_folder m_files replace the path above with the actual one where the m files is located to Matlab s startup m file or Octave s octaverc file DolphiCam Research also comes with a set of example files which are located in the example data folder The files with the file extension rdf can be loaded by the load dc data function by Matlab Octave as described in Section 4 The files with exten sion hdf5 is generated by the stand alone DolphiCam DataAnalyzer tool These files can be loaded by Matlab and
15. tes if sub points of time corrected gain is active Example False A 41 TimeCorrectedGainValues TimeCorrectedGainValues is an integer vector with the values of the internal digital to analog converter DAC used for time corrected gain Example 30 31 32 33 34 35 36 37 38 39 40 41 42 43 A 42 TimeCorrectedGainValuesSubPoints TimeCorrectedGainValuesSubPoints is an integer vector with the values of the DAC used for time corrected gain sub points Example 30 31 32 33 34 35 36 37 38 39 40 41 42 16 Mm April 20 2015 Revision 4327 A 43 DacValue DacValue is an integer used when setting the internal DAC for adjusting the sensor gain The gain is set using two integers DacValue and Dac0ffsetValue see Section A 44 The DAC value DacValue DacOffsetValue Example 30 A 44 DacOffsetValue DacOffsetValue is an integer used when setting the internal DAC for adjusting the sensor gain see also Section A 43 Example 6 A 45 RecordingWindowSamples RecordingWindowSamples is an integer describing the A scan length in samples Example 360 A 46 IsRawDataRecording IsRawDataRecording a Boolean that indicates whether we record data or not it should always be true Example True A 47 FilterEnable FilterEnable a Boolean that indicates whether the data is filtered or not Example True 17 aD April 20 2015 Revision 4327 A 48 EnablePulseSequence EnablePulseSequence a Boolean t
Download Pdf Manuals
Related Search