XMM-Newton Science Analysis System


omqualitymap (omqualitymap-1.5) [xmmsas_20230412_1735-21.0.0]

Testing

The actual testing is controlled by a shell program in the ommergelists test directory and is initiated by typing the command make test. To do the testing in low memory mode, you should set the environment variable SAS_MEMORY_MODEL equal to low. Note that at the daily builds at Vilspa the testing of all SAS software packages is done in both high and low memory modes (referring to the memory model used by the SAS Data Access Layer).

The tests work as follows:

1. A program createtest will execute and-
   • Produce a 2-d image with random sizes in the x and y directions.
   • Produce a 2-d quality-map image with the same dimensions as the image.
   • Produce a source-list containing a random number of sources. For each source-
     • Compute a random x and y image coordinate, within the image boundaries, and a random raw count-rate between 1 and 100 counts/second.
     • If the count-rate is at least 60 counts/sec-
       • Set bit number 1 of all the pixels in the quality map within a column of width 24 unbinned pixels centred on the source.
       • Set bit number 2 of all the pixels in the quality map that lie within a circle of radius 36 unbinned pixels centred on the computed position of a smoke ring produced by the source.
       • Set bit number 6 of all the pixels that lie within a radius of 36 unbinned pixels from the centre of the source.
       • Set quality flags bits 1, 2 and 6 of the source.
   • Produce a source-list file (test.fits with the same structure as an OM source-list file.
   • Produce an image file (testimage.fits containing the 2 images. with the same structure as an OM sky-image.
2. Execute omqualitymap with the parameter updateimage set to true, set set to testimage.fits, srclistset set to test.fits and outset set to test1.fits.

3. A program checkoutput will execute and will-
4. Read in the data for each source from test,fits
5. Load the QUALITY image from testimage.fits
6. Check that the edge quality flags have been set properly.
7. Loop through all the sources and for any with a raw count-rate of at least 60 counts/sec
   • Check that the pixels along a read-out streak centred on the source have bit 1 set.
   • Check that the pixels with a circle of radius 36 pixels centred at the predicted position of the smoke-ring have bit 2 set.
   • Check that the pixels around the source within a radius of 20 pixels have bit 6 set.
8. If any check has failed record a test failure and give some information where it failed.

9. SECOND PART OF TEST (MODE 2)
10. Execute omqualitymap with the parameter mode set to true, set set to testimage.fits, srclistset set to test.fits and outset set to test1.fits.

11. A program checkoutput1 will execute and will-
12. Read in the data for each test source from test.fits
13. Read in the data for each source from test1.fits

14. Load the QUALITY image from testimage.fits
15. Check that the edge quality flags have been set properly.
16. Loop through all the sources from test.fits and for any with a raw count-rate of at least 60 counts/sec
    • Check to see that bits 2 and 6 of the quality-flag have been set in the sources of test1.fits
17. If any check has failed record a test failure and give some information where it failed.

omqualitymap correctly adds quality flags to an OM image, and also that it correctly transfers quality-flag information from a quality image to an OM source-list.