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

Software: PyKE
Version: 2.0.1
Contributor:

NAME
kepclip -- Remove unwanted time ranges from Kepler time series data

USAGE
kepclip infile outfile ranges plot clobber verbose logfile status

PARAMETERS
infile = string
The name of a MAST standard format FITS file containing a Kepler light curve within the first data extension.

outfile = string
The name of the output FITS file with unwanted data removed.

ranges = string
The user must choose here specific time ranges of data to detrend. Ranges can be supplied using one of two methods.

  1. Time ranges are supplied as comma-separated pairs of Barycentric Julian Dates (BJDs). Multiple ranges are separated by a semi-colon. An example containing two time ranges is:
    '2455012.48517,2455014.50072;2455022.63487,2455025.08231'.

  2. The user can provide time ranges within a pre-prepared ascii file containing one time range per line, e.g.:
    2455012.48517,2455014.50072
    2455022.63487,2455025.08231
    etc
    The file 'arbitraryname.txt' is provided to the task using ranges = @arbitraryname.txt, where the '@' tells the task that a file is being provided. Files containing time ranges can be generated manually or with the aid of data inspection using the task keprange.

plot = boolean
Plot the output data?

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
kepclip allows the user to remove unwanted or problematic data from specified time ranges. Ranges to be removed are provided as pairs of BJDs either as a list or by loading an ASCII file of times. The ASCII file can be constructed using keprange.

EXAMPLE

  • kepclip infile=kplr002436324-2009259160929_llc.fits outfile=output.fits range=@ranges.txt plot=y

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 a few seconds. Running times increase by several factors if input data contains NaNs. These will be filtered out before task execution.

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)
2012-03-27
2.0.0
Code can now be run from the command line (TB)
2012-06-07
2.0.1
more reliable plot rendering on linux operating systems (MS)

SEE ALSO
keprange


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