NAME:
rdphalt
PURPOSE: (one line)
Reads photometry from an alternate format basphote log file.
DESCRIPTION:
This routine reads a photometry log file such as is written by basphote.
The file is organized so that a single measurement is recorded on each
line. The file format is a blend of variable and fixed length fields.
The argument list for this routine corresponds one-for-one to the columns
in the file. The first three columns are read as variable length fields.
The filename of the image file is in the first column and is delimited
by a blank (' '). The second column is the name of the object. This
name must be enclosed within a pair of single quotes. This is done to
permit object names with imbedded blanks. The third column is the name
of the filter. The rest of the line is read as a fixed format field
starting with the julian date. The format of this portion is:
'(d13.5,f9.3,f7.2,3f8.3,i5,2f9.3,f6.2,f8.1,f9.4,f8.4,i2)'
Note that the last field (bad, 'i2') does not need to be present (for
reasons of backward compatibility). If that field is absent it is treated
as 0.
Here's a few example lines from such a log file (just remember the leading
semicolon has been added for this documentation and does not appear in the
file):
filename object filter JD exptime gain rdnoise rad sky1 sky2 serial xpos ypos fwhm maxcnt sky skyer
PHOTFILE v1.1
PHOTFILE v1.1
010610.020 'SAO 160066' 2 2452070.68978 9.300 2.40 10.23 5.000 15.000 50.100 0000 206.714 410.874 4.93 5714.0 5.66 0.08
010610.021 'SAO 160066' 1 2452070.69017 37.000 2.40 11.97 5.000 15.000 50.100 0000 205.951 411.056 5.31 4021.3 -1.84 0.09
Warning! Do NOT attempt to line up the fields in a file like this by
adding extra blanks. There is only supposed to be a single blank between
fields (note that some fields themselves contain blanks in the fixed field
areas). This file is not meant to be usefully read by eye.
CATEGORY:
File I/O
CALLING SEQUENCE:
rdphalt,logname,filename,obj,fil,jd,exptime,gain,rad,sky1,sky2,serial, $
xpos,ypos,fwhm,maxcnt,sky,skyerr,mag,err,bad,rdnoise
INPUTS:
logname - string containing the photometry log file to read from.
OPTIONAL INPUT PARAMETERS:
KEYWORD INPUT PARAMETERS:
SKIPLINES - Initial number of lines to skip in the file. If not
specified start at the beginning of the file.
NUMLINES - Number of lines to process, starting at the first
line subsequent to those skipped (if any). If
not specified, process to the end of the file.
OUTPUTS:
filename - Original image file name for each point.
obj - String array containing all object names.
fil - String array with filter codes.
jd - Julian date of mid-time of observation.
exptime - Exposure time in seconds.
gain - Gain of system in photons per count.
rad - Radius of object aperture in pixels.
sky1 - Inner radius of sky annulus in pixels.
sky2 - Outer radius of sky annulus in pixels.
serial - Serial number for observation.
xpos - vector containing the x position for each point.
ypos - vector containing the y position for each point.
fwhm - Full-width at half maximum in arcseconds.
maxcnt - Original DN of maximum in image.
sky - Sky signal in counts/pixel.
skyerr - Uncertainty of the sky signal.
mag - Instrumental magnitude.
err - Uncertainties of the magnitudes.
bad - flag that marks data as bad. 1 is bad, 0 or missing is good.
rdnoise - readout noise in electrons
COMMON BLOCKS:
SIDE EFFECTS:
The version change to this program affects the following programs:
crmatch, logmanip, onchip, reductor, rephot
RESTRICTIONS:
PROCEDURE:
MODIFICATION HISTORY:
Written 1/19/93 - Marc W. Buie, Lowell Observatory.
2/4/93, MWB, Rewrote file read to eliminate array concatenation.
96/01/11, MWB, added NUMLINE, SKIPLINE keywords
96/10/31, MWB, added bad flag argument and field.
2000/06/02, MWB, file format changed to PHOTFILE v1.0 (added sky and skyerr)
2006/05/03, Peter L. Collins, Lowell Observatory
file format changed to PHOTFILE v1.1 (added rdnoise)