Assemble a file that summarizes basic image information given a simple list of input images (e.g. list.BLAH). The assembled information is written to a simple ASCII file (e.g. list.BLAH_Text). This file is accompanied with an explanatory file (e.g. list.BLAH.Text_Explain).
acm_basic_list --help Usage: acm_basic_list list arg1 - Name of file with list of FITS images (can be full path)
Below I show a typical example of a run:
% ls list.BIAS % acm_basic_list list.BIAS r` 6.74399 1410.2 0.01 r` 6.76838 1389.4 0.01 r` 6.77188 1389.6 0.01 r` 6.76886 1389.3 0.01 r` 6.77232 1389.5 0.01 r` 6.77570 1389.5 0.01 r` 6.77913 1389.6 0.01 r` 6.78251 1389.5 0.01 r` 6.78597 1389.4 0.01 r` 6.78940 1389.4 0.01 r` 6.78637 1389.5 0.01 r` 6.78979 1389.4 0.01 Number of images = 12 Mean signal = 1391.19167 Median signal = 1389.500000 mean error = 1.728218 For information on indivual images see the files: list.BIAS.Text list.BIAS.Text_Explain % cat list.BIAS.Text_Explain cat list.BIAS.Text_Explain # Explanation of acm_basic_list-constructed file: list.BIAS.Text # Col01: name of the image FILTER # Col02: time image was taken (in floating point HOURS) # Col03: mean signal in the standard area # Col04: exposure time in seconds (EXPTIME)The final list of summary statistics may or may not be directly useful. In the case of acm bias images this information is highly instructive. The mean bias level for an acm bias frame should BIAS = 1385 adu ± 10 adu. If you observe a differnet mean bais level (usually one much larger), then your images are probably not bias frames! We have found many cases of bias frames take when some source of scatterd light is present in the system that clearly contaminates the bias images.
It might seem that acm_basic_list should just be a part of acm_list. One of the prime uses of the "_Text" made in this process is to overplot information in a tiled ds9 view of many images using the routine ds9_list_load . In practice this is seldom useful for more than 50-70 images. Hence, we want to be able to prepare smaller image lists and view them independently of the generally larger lists built with acm_list.