Description:
Photsum goes through all the sdf files in the current directory and, optionally, DATADIR (defined in
an environment variable) and summarizes files containing photometry observations.
In the absence of the −all
flag, a numeric range is requested. This range only has an effect on raw data or
reduced files which have the run number embedded into the file name. Filenames
with no numbers are treated as scan 0.
Usage:
photsum [-h] [-demod] [-reduced]
[-all|[-begin nn -end nn]]
Parameters:
−h[elp]
Return a help message only. More help can be obtained by using ‘showme sun216’ or ‘scuhelp photsum’.
−all
List all photometry files in the current directory and $DATADIR
−demod
Only list demodulated data files (signified by _dem_ file name)
−reduced
Only list reduced data files (signified by _red_ file name)
−begin nn
First scan number to be
considered (same as −−begin==nn)
−end nn
Final scan number to be
considered (same as −−end=nn)
Examples:
photsum
Ask for a range of scan numbers and then give a summary of every
PHOTOM file matching this criterion in DATADIR and the current directory. photsum
−all
Generate a summary of all photometry files in the current and DATADIR directory. photsum
−−begin=5
−−end=100
Generate a summary of all photometry data from scans 5 to 100 inclusive. photsum
−all
−reduced
Produce a one line summary of all reduced (_red_) photometry files. This will include the photometry
results calculated by the on-line system.
photsum −all
−reduced
>
log.txt
Produce a one line summary of all the reduced photometry files and store
the output in the text file log.txt (note this example is shell specific). photsum
−all
−reduced
−demod
Produce a summary of all reduced (_red_) and demodulated (_dem_) photometry data files (ie not
files produced during off-line data reduction). Notes:
-
If task is run on reduced data (‘_red_’ files) then the photometry results will be listed.
-
Skydip data is printed for convenience.
-
Files are drawn from the current working directory and the directory indicated by the $DATADIR
environment variable.
-
Data reduced by the off-line system will all be treated as run 0 for the purposes of listing unless
numbers are present in the filename.
-
The output can be stored in a file by using unix redirection as long as the search range is fully specified (either
as ‘−all’ or
with ‘−begin’
and ‘−end’).
-
Command line options can be abbreviated.
-
Options that take values can be used either as
‘−flag option’ or
as ‘−−flag=option’
-
It may be necessary to set the HDS_SCRATCH environment variable if files are being logged from
directories for which write access is denied (e.g. setenv HDS_SCRATCH /tmp)
Related Applications
Copyright © 1997-2000,2003 Particle Physics and Astronomy Research Council