The createRDS verify Test

Test objectives

Verify that createRDS command works for level 1 and level frame data

APIs affected by this test

managerAPI:
- directs processing of the 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:
- Reads complex data from ADC data of channels
datacondAPI:
- outs the frame comparison result ilwd command
ligotools package is required for running this test. Check that it is mounted

Setup

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

Create a test directory on gateway machine e.g. /ldas_usr/ldas/test/rdsverify .

Copy the following test scripts from the build source directory ldas/api/test/System to test directory created:


        RDSVerify.tcl
        qatest.tcl  
        qalib.tcl
        qaS3.tcl
        qailwd.tcl
        qaE11pre1.tcl
        runrds.tcl
        rdsclean.tcl
        adcdecimate_L-RDS_R_L3-S3.txt
        adcdecimate_H-RDS_R_L1-S3.txt  
        adcdecimate_H-RDS_R_L2-S3.txt
        adcdecimate_H-RDS_R_L3-S3.txt
        adcdecimate_L-RDS_R_L1-S3.txt
        adcdecimate_L-RDS_R_L2-S3.txt

Test Execution

Establish the ldas manager environment variable for ligotools:
```
setenv LDASMANAGER dev 
```
Turn on verbose mode if more information is desired other than passed or failed.
```
setenv TEST_VERBOSE_MODE true 
```

The directory on dev containing the output RDS frames, e.g. /scratch/frames/RDSVerify will be cleared out by the script before each round of execution.

cd <your scripts directory>

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

Option Description
<-v or --verify> set to 1 to verify result frames or 0 to skip verification via conditionData
<-t or --test> specify list of tests to run instead of the default: TestOneToOne TestMultiFrame TestConcatFrame TestMultiConcatFrame TestOneToOneS3_L TestMultiFrameS3_L TestConcatFrameS3_L TestMultiConcatFrameS3_L TestMultiFrameE11 TestConcatFrameE11 TestMultiConcatFrameE11
<-st or --starttime> specify start time of frame query instead of using default data set start time.
<-e or --endtime> specify end time of frame query instead of using default data set end time.
<-d or --dump> dump the RDS ldas command to file in specified directory
<-j or --job_frame_time> number of secs of frame data per job; default is 64 secs.
<-l or --looping> specify 1 for continuous loop mode or 0 for one time execution
<-d or --dump> dump the createRDS command to be submitted to file in the specified directory.
<-t or --list of tests to run> list of tests to run instead of default to all tests.
<-delay > secs to delay submitting the level 2 createRDS after level 1 has been submitted.
<-outputdir > specify the output directory for frames.

Option	Description
`<-v or --verify>`	set to 1 to verify result frames or 0 to skip verification via conditionData
`<-t or --test>`	specify list of tests to run instead of the default: TestOneToOne TestMultiFrame TestConcatFrame TestMultiConcatFrame TestOneToOneS3_L TestMultiFrameS3_L TestConcatFrameS3_L TestMultiConcatFrameS3_L TestMultiFrameE11 TestConcatFrameE11 TestMultiConcatFrameE11
`<-st or --starttime>`	specify start time of frame query instead of using default data set start time.
`<-e or --endtime>`	specify end time of frame query instead of using default data set end time.
`<-d or --dump>`	dump the RDS ldas command to file in specified directory
`<-j or --job_frame_time>`	number of secs of frame data per job; default is 64 secs.
`<-l or --looping>`	specify 1 for continuous loop mode or 0 for one time execution
`<-d or --dump>`	dump the createRDS command to be submitted to file in the specified directory.
`<-t or --list of tests to run>`	list of tests to run instead of default to all tests.
`<-delay >`	secs to delay submitting the level 2 createRDS after level 1 has been submitted.
`<-outputdir >`	specify the output directory for frames.

Example: the following will run only tests TestOneToOne and TestMultiFrame with verification via conditionData and output the frames to directory /usr1/lcldsk/frames/RDSVerify.


            RDSVerify.tcl -t {TestOneToOne TestMultiFrame} -outputdir /usr1/lcldsk/frames/RDSVerify >& RDSVerify.log &

Example: the following will run all tests without verification, and delay 10 secs before submitting level 2 jobs; it will run in a continous loop and output the frames to directory /usr1/lcldsk/frames/RDSVerify; the output directory will be cleared out after each round of testing.


            RDSVerify.tcl -v 0 -l -delay 10 -outputdir /usr1/lcldsk/frames/RDSVerify >& RDSVerify.log &

Test Validation:

Verify all jobs completed ok for ldas.

The RDSVerify output log indicates whether a test passed or failed if verification is enabled:

        
        -- PASS: MultiConcatFrame(E11pre1): Creation of Level 1: 
        -- PASS: MultiConcatFrame(E11pre1): Creation of Level 2: 
        -- PASS: MultiConcatFrame(E11pre1): Verification: 
        -- INFO: MultiConcatFrame(E11pre1): Verification: ILwd File contents: 
            -1.4901161193847656e-08
            6.6072494795565689e-06
            9.7656250000000000e-04
            0.0000000000000000e+00
            0.0000000000000000e+00
            0.0000000000000000e+00
            0.0000000000000000e+00
            0.0000000000000000e+00
            0.0000000000000000e+00
        
        -- INFO: MultiConcatFrame(E11pre1): Verification: Mean Verification: passed
        -- INFO: MultiConcatFrame(E11pre1): Verification: Mean Verification: passed
        -- INFO: MultiConcatFrame(E11pre1): Verification: Mean Verification: passed
        TestMultiConcatFrameE11 1 current status 1
        -- PASS: PASSED