saltlog – Create FITS table of observations from image headers


saltlog images outfile (clobber) logfile (verbose) status


String. List of input images including, if necessary, absolute or relative paths to the data. Data can be provided as a comma-separated list, or a string with a wildcard (e.g. ‘images=S20061210*.fits’), or a foreign file containing an ascii list of image filenames. For ascii list option, the filename containing the list must be provided preceded by a ‘@’ character, e.g. 'images=@listoffiles.lis‘. saltlog currently searches for the PROPID and PROPOSER keywords which are not native to raw images. They are written by the tool saltedtky which should be run prior to saltlog to get full value from the observation log.
String. The name of a FITS table file containing output from saltlog. If the output is intended for a different directory the absolute or relative path must be supplied with the file name.
Hidden boolean. If set to ‘yes’ an existing file of the same name will be overwritten by outfile.
String. Name of an ascii file for storing log and error messages written by the task. The file may be new, or messages can also be appended to a pre-existing file.
Boolean. If verbose=n, log messages will be suppressed.
Integer. Provided status=0 is passed to saltlog, a successful run of the task will yield status=0 at completion of the task. Any other value for the status flag at completion indicates failed execution.


saltlog collates all primary keyword headers from a list of input files and creates a tabuated observing log in FITS format. The table contains one column for each keyword and one row for each exposure in a sequence. The first column of the table contains the file name.

The advantage of creating an observation table is convenience but it’s use is possibly limited to the period of time before the SALT database comes online. File contents can be understood, examined and filtered without going to the expense of opening the large image files themselves. most useful during pipeline processing.


  1. To create a FITS observation log from a list of image files:

    --> saltlog images='@images.lis' outfile='obslog.fits'
    clobber='no' logfile='salt.log' verbose='yes'

Time and disk requirements

Individual unbinned full frame RSS image files can be 112MB in size. It is recommended to use workstations with a minimum of 512MB RAM. On a contemporary linux machine, one hundred files can be processed in ~ 1 sec.

Bugs and limitations

Send feedback and bug reports to

See also

saltpipe saltclean

Table Of Contents

Previous topic


Next topic


This Page