Warning: this page is no longer updated and may contain outdated information.

Please refer to the new Kepler/K2 science website at http://keplerscience.arc.nasa.gov

NASA - National Aeronautics and Space Administration Follow this link to skip to the main content + Contact NASA
Kepler Guest Observer Program

Contributed Software - KEPHEAD

Software: PyKE
Version: 2.0.0

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

kephead infile outfile keyname clobber verbose logfile status

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.

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.


  • 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

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.

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.


Initial software release (MS)
Code can now be run from the command line (TB)

kepconvert, kepmask

Questions concerning Kepler's science opportunities and open programs, public archive or community tools? Contact us via the email address.
FirstGov - Your First Click to the US Government
+ Freedom of Information Act
+ Budgets, Strategic Plans and Accountability Reports
+ The President's Management Agenda
+ NASA Privacy Statement, Disclaimer,
and Accessibility Certification

+ Inspector General Hotline
+ Equal Employment Opportunity Data Posted Pursuant
to the No Fear Act

+ Information-Dissemination Priorities and Inventories
NASA - National Aeronautics and Space Administration
Editor: Martin Still
NASA Official: Jessie Dotson
Last Updated: Jan 11, 2013
+ Contact NASA