Software: PyKE
Version: 2.0.1
Contributor: Martin Still

NAME
kepdraw -- Interactive plotting of Kepler time series data

USAGE
kepdraw infile outfile datacol ploterr errcol quality lcolor lwidth fcolor falpha labelsize ticksize xsize ysize fullrange plotgrid 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 PNG plot file.

datacol = string
The FITS column within extension 1 of infile to be plotted against time.

ploterr = boolean
Plot error bars with the data?

errcol = string
The uncertainty data coupled to datacol. If ploterr=yes then these data will be plotted as error bars

quality = boolean
Ignore bad data and cadence gaps in datacol?

lcolor = string
The color of the line plot. These can be chosen in html notation, e.g. black is #000000 and white is #ffffff. The html color scheme can be browsed in multiple online charts.

lwidth = float
The width of the plot line in arbitrary units. The plotting default width is 1.0.

fcolor = string
The color of the fill under the plot line. These can be chosen in html notation, e.g. black is #000000 and white is #ffffff. The html color scheme can be browsed in multiple online charts.

falpha = float
The transparency of the fill color. 0.0 is transparent, 1.0 is opaque.

labelsize = float
The font size of the plot labels.

ticksize = float
The axes tick sizes within the plot.

xsize = float
The length of the plotting window in arbitrary units. A typical value is 16.0

ysize = float
The height of the plotting window in arbitrary units. A typical value is 8.0

fullrange = boolean (optional)
Plot the flux range between zero and the maximum and 101% of the flux maximum? Otherwise plot the range 99% of the flux minimum to 101% of the flux maximum.

plotgrid = boolean (optional)
Plot a grid over the data on the major tick marks?

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
kepdraw plots a chosen data column within a FITS light curve over time. The standard functionality within the matplotlib plotting library allows the user to zoom and pan before saving to a file.

EXAMPLE

• kepdraw infile=kplr002436324-2009259160929_llc.fits outfile=kplr002436324-2009259160929_llc.png datacol=SAP_FLUX ploterr=n errcol=SAP_FLUX_ERR quality=y lcolor='#0000ff' lwidth=1.0 fcolor='#ffff00' falpha=0.2 labelsize=24 ticksize=16 xsize=18 ysize=6 fullrange=n plotgrid=y verbose=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
The Kepler PyRAF package is privately-developed software made available to the community through the contributed software page of the GO program at http://keplergo.arc.nasa.gov/ContributedSoftware.shtml. It is not an official software product of the Kepler mission. Bugs and errors are not the responsibility of NASA or the Kepler Team. Please send bug reports and suggestions to keplergo@mail.arc.nasa.gov.

HISTORY