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 - KEPCONVERT

Software: PyKE
Version: 2.0.0
Contributor:

NAME
kepconvert -- Convert Kepler FITS time series to or from a different file format

USAGE
kepconvert infile outfile conversion columns baddata clobber verbose logfile status

PARAMETERS
infile = string
The name of an input file, e.g. a MAST standard format FITS file containing a Kepler light curve within the first data extension, or an ASCII table.

outfile = string
The name of the output file, e.g. a FITS structure or ASCII table.

conversion = string (fits2asc|asc2fits)
Define the type of file conversion.

columns = string
A comma-delimited list of data column names or descriptors.

baddata = boolean (optional)
If yes, all the rows from the input FITS file are output to an ascii file. If no then only rows with SAP_QUALITY equal to zero will but output. This option is only applicable if conversion = fits2asc.

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 PyRAF tasks perform exclusively upon a standardized FITS file format. kepconvert converts tabular data to or from FITS format. Currently, only ASCII conversions are supported.

EXAMPLE

  1. Convert data from a FITS format to ASCII.
    • kepconvert infile=kplr002436324-2009259160929_llc.fits outfile=2436324-Q3.txt conversion=fits2asc columns=TIME,RAW_FLUX,RAW_FLUX_ERR,SAP_QUALITY

  2. Convert data from ASCII format to FITS.
    • kepconvert infile=2436324-Q3.txt outfile=kplr002436324-Q3.fits conversion=asc2fits columns=TIME,RAW_FLUX,RAW_FLUX_ERR

TIME REQUIREMENTS
Full completion upon one quarter of Kepler long cadence target using a 3.06 GHz Intel Core 2 Duo Mac running OS 10.6.4 takes 1 second.

BUGS AND LIMITATIONS
Please send bug reports and suggestions to keplergo@mail.arc.nasa.gov.

HISTORY

Date
Version
Description
2010-06-29
1.0.0
Initial software release (MS)
2011-07-01
1.0.1
Updated for Kepler FITS v2.0 (MS)
2011-08-30
1.0.2
Precision of FITS-ASCII conversion increased (TB)
2011-10-02
1.0.3
Added option to only output those rows which have a data quality flag of zero (i.e. no known issues with that cadence). (TB)
2012-03-27
2.0.0
Code can now be run from the command line (TB)

SEE ALSO
kephead


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