Software: PyKE
Version: 2.0.0
Contributor:

NAME
kephead -- search for and list FITS keywords in Kepler data files

USAGE
kephead infile outfile keyname clobber verbose logfile status

PARAMETERS
infile = string
The name of a standard format FITS file.

outfile = string
The name of the output ASCII file for storing search results.

keyname = string
The name of a keyword, value and description to print or store within the output file. Partial completions for the keyword are allowed. For example keyname='mag' will return all instances of magnitude keywords (BMAG, VMAG, KEPMAG etc) and their values within the light curves stored at MAST. keyname='all' will return every keyword and their values stored in all extensions within the input FITS file.

clobber = boolean (optional)
Overwrite the output file? if clobber=no and an existing file has the same name as outfile then the task will stop with an error.

verbose = boolean (optional)
Print informative messages and warnings to the shell and logfile?

logfile = string (optional)
Name of the logfile containing error and warning messages.

status = integer
Exit status of the script. It will be non-zero if the task halted with an error. This parameter is set by the task and should not be modified by the user.

DESCRIPTION
The Kepler archive contains science data in Flexible Image Transport System (FITS) format. Images are stored in binary arrays, time series data in binary tables and scalar data as binary keywords. Tools such as kepmask and kepconvert read Kepler image and table data. kephead displays scalar data or converts it from binary to ASCII format. kephead can display all keywords in a file, display individual keywords, or search for character combinations in keywords names.

EXAMPLES

• kepdiffim infile=kplr004150611-2010355172524_llc.fits outfile=kplr004150611-2010355172524-keywords.txt keyname='mag' clobber=yes
• kepdiffim infile=kplr004150611-2010265121752_lpd-targ.fits outfile=kplr004150611-2010265121752-keywords.txt keyname='all' clobber=yes

TIME REQUIREMENTS
Completion upon one target pixel file using a 2.66 GHz Intel Core 2 i7 Mac running OS 10.6.7, takes a few seconds in addition to the manual input required by the tool.

BUGS AND LIMITATIONS
The Kepler PyRAF package is privately-developed software made available to the community through the contributed software page of the Kepler astrophysics program at http://keplergo.arc.nasa.gov/ContributedSoftware.shtml. It is not an official software product of the Kepler mission or NASA. Bugs and errors are not the responsibility of the Kepler Team or NASA. Please send bug reports and suggestions to keplergo@mail.arc.nasa.gov.

HISTORY

SEE ALSO
kepconvert, kepmask