NAME
kst - A plotting and data viewing program
SYNOPSIS
The options are:
kst [Qt-options] [KDE-options] [options] [file...]
OPTIONS
[file...]
A .kst file, or one or more data files. Supported formats are
ASCII columns, BOOMERANG frame files, BLAST dirfile files, and
other optionally supported types. A .kst files stores all
options that can be set by other flags. The following flags can
be used to override the options set in the .kst file: -F
datafile, -n NS, -s NS, -f F0, -a. The rest can not be
overridden. If an override flag is given, it is applied to all
vectors in the plot.
ASCII data from stdin can be plotted by including "stdin" in the
list [file...].
-y Y The source for the Y axis data. For ASCII files, this is the
column. For binary files, this is the field name. To plot
multiple curves, this may be specified multiple times. The same
source file, sample ranges, and X axis data are assumed.
--ye equation
The values for the Y axis data are calculated from the equation
sepcified. Multiple equations are allowed.
--xe X Use equation x0:x1:n to specify the X vector (INDEX). x0:x1
specifies the range of the vector, and n specifies the the
number of values in X vector.
e.g. -10:10:21 creates this static vector: X =
{-10,-9,-8,...0...8,9,10}
-E text
Pass argument to extension. text is of format
extensionname:argumentlist
e.g. kst -E js:"loadScript(’intplTest.js’)"
-e E Error bars for Y axis data. For ASCII file, refer to the column
holding the data. For binary files use the field name. If
multiple -y Y options are given, this may also be used multiple
times. Individual Y entries are associated in order with
multiple E entries.
-x X The source for the X axis data. For ASCII files, this is the
column. For readata files, this is the field name. If this
option is not specified, the row number in the file is used.
This option can only be given once.
-z Z The source for the Z matrix data (which gets displayed as an
image). For ASCII files, this is the column containing the z
data. For other optional formats (HEALPix, FITS image, etc),
this is the name of the desired matrix field, as displayed in
the matrix dialog. Some matrix-compatible datasources also allow
using an alias which is the number of the desired matrix field.
To plot multiple matrices, this may be specified multiple times.
-p P The source for power spectra. For ASCII files, this is the
column. For binary files, this is the field name. To plot power
spectra of multiple curves, this may be specified multiple
times. The same source file, sample ranges and fft lengths are
used for all Power Spectra requested from the command line.
-l P The length of the FFT used in power specra estimation is 2^P.
-r f Specify sample rate: f for power spectrum
--ru U Specify the units U for psd sample rate
--yu U Specify the units U for psd sample rate
-h H The source for histograms. For ASCII files, this is the column.
For binary files, this is the field name. Multiple histograms
can be defined from the command line.
-m NC Used when multiple curves have been defined. Rather than
plotting all curves in the same plot, plot each in its own plot,
-f F0 The starting frame number (for readdata files) or row (for ASCII
files) to read.
-n The number of frames (for readdata files) or rows (for ASCII
files) to read.
-s NS The number of frames or rows to skip each read. This is useful
when working with very large data files, to speed up response
and conserve memory, in the case that the data are slowly
varying.
-g Provide a legend box
-w file
Display the data wizard
--nq Bypass the quickstart dialog
-a Used in with the -s NS: rather than skipping each NS frames,
average them. This provides a combination of very basic high
pass filtering, and memory conservation.
-F Datafile
Override the file to read the data from for all vectors listed
in the .kst file. Can only be used in conjunction with a kst
file.
--print psfile
Rather than displaying the plot, export the image to a
postscript file and exit. *BUG note: even though no windows are
opened on screen, access to the X server is still required.*
--png pngfile
Rather than displaying the plot, export the image to a png file
of dimensions 640x480 and exit. *BUG note: even though no
windows are opened on screen, access to the X server is still
required.*
COMMAND LINE EXAMPLES
Several examples of typical use follow.
To plot column 1 a file (tmp.dat) of ASCII data:
kst -y 1 tmp.dat
To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 1 plot:
kst -x 1 -y 2 -y 3 -y 4 tmp.dat
To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 3 plots,
arranged in 1 column:
kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat
To plot 500 rows of column 2 of an ASCII file, starting at line 100:
kst -y 2 -f 100 -n 500 tmp.dat
To plot the first 100,000 rows of column 2 of an ASCII file, averaging
every 100 rows:
kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat
Using command to plot a spectrum from a data field of an ASCII data
file with sample rate = 10HZ and FFT length = 2^14
kst -p 2 /usr/share/apps/kst/tutorial/gytodata.dat -r 10 -l 14
(Using optional HEALPix Data Source) To plot the first 3 maps in a
HEALPix FITS file in a 2x2 grid:
kst -z 1 -z 2 -z 3 -m 2 healpix_example_sm.fits
(Using optional HEALPix Data Source) To plot a map with a specific
field name in a HEALPix FITS file:
kst -z "1 - TEMPERATURE (Kelvin)" healpix_example_sm.fits
AUTHORS
Duncan Hanson, Rick Chern, Philip Rodrigues, Barth Netterfield, Yiwen
Mao.
KST COMMAND LINE(1)