Frame DT check test

Test Objectives

Exercise the frame commands getFrameData, concatFrameData and getFrameElements commands to obtain the dt value from frame adcData:Container

Verify dt value is correct for the time range.

APIs affected by this test

managerAPI: directs processing of the insertion user commands to other APIs and returns the user command status to the user.
diskcacheAPI:
- Retrieves the frame file names required by the frame query in ldas command.
frameAPI:
- Retrives the frame data specified

Setup

ligotools package is required for running this test. Check that it is mounted

Install the following tests script in a directory on your local machine or the ldas system
- dtcheck.tcl

S2 data must be mounted on ldas system and known to diskcacheAPI; frame query is done on ADC data of channel H0:PEM-LVEA_SEISX.


        Test Execution

		cd <your scripts directory>

		
        Usage: dtcheck.tcl [options] >& dtcheck.log & 

        

            
                Option
                Description
			

                <-s>
                ldas site e.g. dev, llo, cit, ldas-suntest3
        
e.g.

            dtcheck.tcl -s dev >& dtcheck.log &
            
		
		
Test Validation:
        The duration is computed from the accumulated dt data and sampleRate.
        Example of the AdcData fields used in computation of duration (in bold):
        
          <ilwd name=':adcData:Container(AdcData):Frame'>
            <ilwd name='H0\:PEM-LVEA_SEISX::AdcData:730524016:0:Frame' size='14'>
                <lstring name='comment'></lstring>
                <int_4u name='channelGroup'>14</int_4u>
                <int_4u name='channelNumber'>258</int_4u>
                <int_4u name='nBits'>16</int_4u>
                <real_4 name='bias'>0.0000000e+00</real_4>
                <real_4 name='slope'>6.1028000e-05</real_4>
                <lstring name='units' size='1'>V</lstring>
                <real_8 name='sampleRate'>2.5600000000000000e+02</real_8>
                <real_8 name='timeOffset'>0.0000000000000000e+00</real_8>
                <real_8 name='fShift'>0.0000000000000000e+00</real_8>
                <real_4 name='phase'>0.0000000e+00</real_4>
                <int_2u name='dataValid'>0</int_2u>
                <real_8 name='dt'>4.0000000000000000e+00</real_8>
                ...
        


		When test has completed, check the end for all passes. 
        As of ldas 1.2.3 here are the expected results:
        e.g. 

        dtcheck.tcl:	Total   172     Passed  172     Skipped 0       Failed  0