gethead(1) General Commands Manual gethead(1)Name
gethead - Print FITS or IRAF header keyword values
Synopsis
gethead [-hptv] [-d pathname] [-n num] <FITS or IRAF file> kw1 kw2 ... kwn
Description
Print values of the specified keywords from the given image header. By default they are all listed on one line, separated by spaces. The
-v flag causes the keyword names and values to be printed, one keyword per line. To read keywords from a list of files, substitute @<list-
file> for the file names on the command line. To read a lot of keywords, put them, one per line, in a file and substitute @<keylistfile>
on the command line. If two @ commands are present, the program will figure out which contains file names and which contains keywords.
Options-a List file name even if keywords are not found
-d Root directory for input files (default is cwd)
-e Output keyword=value's on one line per file
-f Never print filenames (default is to print them if more than one)
-g Output keyword=value's on one line per keyword
-h flag causes the keyword names to be printed at top of columns.
-n Number of decimal places in numeric output
-o OR conditions instead of ANDing them
-p Print full pathnames of files
-t flag causes the output to be in tab-separated tables with keyword column headings.
-u Always print ___ if keyword not found, event if only one keyword in search
-v Print output as <keyword>=<value>, one per line
Web Page
http://tdc-www.harvard.edu/software/wcstools/gethead.html
Author
Doug Mink, SAO (dmink@cfa.harvard.edu)
6 July 2001 WCSTools gethead(1)
Check Out this Related Man Page
imcat(1) General Commands Manual imcat(1)Name
imcat - List catalog stars in FITS and IRAF image files
Synopsis
imcat [options] FITS or IRAF file(s)
Description
Search given catalog withing area described by the world coordinate system in an image header. May be called as imuac to search the USNO A
1.0 catalog, imusac to search the USNO SA 1.0 catalog, or imgsc to search the HST Guide Star Catalog.
Options-b [<RA> <Dec>]
Output in B1950, optional new image center in B1950 (FK4) RA and Dec to replace that in image header
-c <name>
Reference catalog (gsc(=HST GSC), ua2(=USNO-A2.0), TMC(=2MASS Point Source Catalog), gsc2(=GSC II), ub1(=USNO-B1.0), local file,
etc.)
-d Output RA,Dec positions in fractional degrees
-e Output in ecliptic longitude and latitude
-g Output in galactic longitude and latitude
-h Print heading, else do not
-i Print name instead of number in region file
-j [<RA> <Dec>]
Output in J2000, optional new image center in J2000 (FK5) RA and Dec to replace that in image header
-k <keyword>
Add this keyword to output from tab table search
-m [<bright magnitude>] <faint magnitude>
Limiting catalog magnitude(s) (default none, bright -2 if only faint is given)
-n <num>
Number of brightest stars to print
-o <type>
Set HST Guide Star object class to print (0=stars, 3=nonstars, -1=all, -2=band)
-p <scale>
Initial plate scale in arcsec per pixel (default from file)
-q <c|d|o|s|x|v|+>
Write SAOimage region file with this shape, o=circle, s=square, d=diamond, +=cross, and x=X, with the radius scaled with magnitude
unless specified with a -r command line entry. v will cause stellar Guide Stars to plot with a + and nonstellar Guide Stars to plot
with an x. If character is is preceded by p, the size specified by the -r command is assumed to be in pixels, not arcseconds. A p
alone specifies a circle in pixels.
-r <radius>
Write SAOimage region file with shapes (default CIRCLE) of this radius in arcseconds. SAOimage can then read this file, with will
have positions and radii in pixels and plot it over an image. If the radius is specified as zero, the output radii will scale
between 5 and dim/100 over the range of magnitudes of sources found in the image area. If the -q option is specified with a 'p' in
it, this number is assumed to be in pixels instead of arcseconds.
-s d|m|n|p|r|x|y
Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from center, (r)ight ascension, image (x) or (y).
-t Tab table to standard output as well as file
-u num USNO catalog single plate number to accept
-v Verbose listing of processing intermediate results
-w Write tab table output file imagename.cat
-x x y X and Y coordinates of reference pixel (default is CRPIXn or center of image)
-y epoch
Epoch of image for proper motions
-z Use AIPS classic projections instead of WCSLIB; use CD matrix or CDELT instead of polynomial solution.
See Also
scat()
Web Page
http://tdc-www.harvard.edu/software/wcstools/imcat/
Author
Doug Mink, SAO (dmink@cfa.harvard.edu)
30 January 2003 WCSTools imcat(1)