Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gethead(1) [debian man page]

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

wcstools(1)						      General Commands Manual						       wcstools(1)

Name
       wcstools - Programs to access image world coordinate systems and catalogs

Setting an Image World Coordinate System
       imwcs  Automatically  find stars in a FITS or IRAF image, match them to HST Guide USNO A or USNO UJ Stars, compute the relation between sky
	      coordinates and image coordinates, and write in in the image header. [after U of Iowa SETWCS]

       delwcs Delete the WCS keywords from an image. If both EPOCH and EQUINOX are present, EQUINOX is also deleted.

Using an Image World Coordinate System
       imcat  List catalog sources which should be found in the area of the sky covered by a specific image.

       imsize Print center and size of image using WCS keywords in header

       imstar Find and list the n brightest stars in an IRAF or FITS image, with their sky coordinates if there is WCS information  in	the  image
	      header.

       sky2xy Print image pixel coordinates for given sky coordinates on the command line or in a list file.

       xy2sky Print sky coordinates for given image pixel coordinates on the command line or in a list file.

Catalog Utility Programs
       scat   Search the HST GSC, USNO-A2.0, or other catalog given a region on the sky.

       skycoor
	      Convert between J2000, B1950, and Galactic coordinates from the command line or a file.

Image Utility Programs
       addpix Add a constant value(s) to specified pixel(s)

       edhead Edit the header of a FITS file or the user parameters of an IRAF image file using a the text editor specified by the EDITOR environ-
	      ment variable.

       gethead
	      Return values for keyword(s) specified after filename.

       getpix Return value(s) of specified pixel(s)

       i2f    Read two-dimensional IRAF image file and write FITS image file

       imhead Print FITS or IRAF header

       imrot  Rotate and/or reflect FITS or IRAF image files

       setpix Set specified pixel(s) to specified value(s)

       sethead
	      Set header parameters in FITS or IRAF images.

       subpix Subtract a constant value(s) from specified pixel(s)

Author
       Doug Mink, SAO (dmink@cfa.harvard.edu)

6 July 2001							     WCSTools							       wcstools(1)
Man Page