Survey the data gathered with dssbase_run_markII that has been written to a Store_DSS directory. This routine basically preapred two files that can be used in downstream applications. This routine is not particularly fast, but one IMPORTANT thing to remember is that obes these files are built, and they match the number of FITS images present in the Store_DSS directory, then this routine exits. Hence, these files are rebuilt necessarily rebuilt with each call. For each DSS image in the Store_DSS directory this code prepares entries in the files:
dssbase_path/local_red/Store_DSS/DSS.basenames
The basename of the DSS FITS files.
dssbase_path/local_red/Store_DSS/DSS.params
The Ra,Dec in degree units and the (x) radius of the DSS image in units of
arcminutes. The image basename is also included at the end of each line.
With these two files, we can quickly search the DSS database and find the
most appropriate image to be used for a calibration task. In most cases, we simply
take the image with a center that is closest to an input Ra,Dec position (usually
the Ra,Dec of our image to be calibrated).
The command syntax is fairly simple but can be used in a number of ways.
Usage: dssbase_list Y
arg1 - allow a rebuild of the DSS.list file (Y/N)
Additional options:
-v = print verbose comments
--help = view a help document
NOTE: Use a local DSSBASE.PATH file to read from custom location.
% dssbase_list
% dssbase_list --help
% dssbase_list -v
% dssbase_list Y -v
% dssbase_list N
Some helpful examples:
% cat DSSBASE.PATH
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS
% ls /home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/*fits
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/dss_RA01c17c31p268DEC+53c20c40p56_475.fits
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/dss_RA10c47c49p989DEC+12c34c55p92_1426.fits
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/dss_RA20c34c52p157DEC+60c09c13p46_1426.fits
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/dss_RA23c04c57p191DEC+12c19c16p77_1426.fits
% ls /home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/DSS*
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/DSS.basenames
/home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/DSS.params
% cat /home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/DSS.basenames
dss_RA10c47c49p989DEC+12c34c55p92_1426
dss_RA01c17c31p268DEC+53c20c40p56_475
dss_RA20c34c52p157DEC+60c09c13p46_1426
dss_RA23c04c57p191DEC+12c19c16p77_1426
% cat /home/sco/AUTO_match_for_wcs/run_sco2019/local_red/Store_DSS/DSS.params
161.95829 12.58220 11.975408 10:47:49.9884 +12:34:55.9200 dss_RA10c47c49p989DEC+12c34c55p92_1426
19.38028 53.34460 3.980930 01:17:31.2684 +53:20:40.5600 dss_RA01c17c31p268DEC+53c20c40p56_475
308.71732 60.15374 11.976938 20:34:52.1580 +60:09:13.4640 dss_RA20c34c52p157DEC+60c09c13p46_1426
346.23830 12.32132 11.976243 23:04:57.1908 +12:19:16.7520 dss_RA23c04c57p191DEC+12c19c16p77_1426
The DSS.params file is written free-format with the floating point values first so
that this file can be read easily by a bash script or a gfortran free-format read.