1KST COMMAND LINE(1) KST COMMAND LINE(1)
2
6 kst - A plotting and data viewing program
7
9 The options are:
10 kst [Qt-options] [KDE-options] [options] [file...]
12
15 [file...]
16 A .kst file, or one or more data files. Supported formats are
17 ASCII columns, BOOMERANG frame files, BLAST dirfile files, and
18 other optionally supported types. A .kst files stores all op‐
19 tions that can be set by other flags. The following flags can be
20 used to override the options set in the .kst file: -F datafile,
21 -n NS, -s NS, -f F0, -a. The rest can not be overridden. If an
22 override flag is given, it is applied to all vectors in the
23 plot.
24 ASCII data from stdin can be plotted by including "stdin" in the
26 list [file...].
27 -y Y The source for the Y axis data. For ASCII files, this is the
30 column. For binary files, this is the field name. To plot multi‐
31 ple curves, this may be specified multiple times. The same
32 source file, sample ranges, and X axis data are assumed.
33 --ye equation
36 The values for the Y axis data are calculated from the equation
37 sepcified. Multiple equations are allowed.
38 --xe X Use equation x0:x1:n to specify the X vector (INDEX). x0:x1
41 specifies the range of the vector, and n specifies the the num‐
42 ber of values in X vector.
43 e.g. -10:10:21 creates this static vector: X =
45 {-10,-9,-8,...0...8,9,10}
46 -E text
49 Pass argument to extension. text is of format extensionname:ar‐
50 gumentlist
51 e.g. kst -E js:"loadScript('intplTest.js')"
53 -e E Error bars for Y axis data. For ASCII file, refer to the column
56 holding the data. For binary files use the field name. If multi‐
57 ple -y Y options are given, this may also be used multiple
58 times. Individual Y entries are associated in order with multi‐
59 ple E entries.
60 -x X The source for the X axis data. For ASCII files, this is the
63 column. For readata files, this is the field name. If this op‐
64 tion is not specified, the row number in the file is used. This
65 option can only be given once.
66 -z Z The source for the Z matrix data (which gets displayed as an im‐
69 age). For ASCII files, this is the column containing the z data.
70 For other optional formats (HEALPix, FITS image, etc), this is
71 the name of the desired matrix field, as displayed in the matrix
72 dialog. Some matrix-compatible datasources also allow using an
73 alias which is the number of the desired matrix field. To plot
74 multiple matrices, this may be specified multiple times.
75 -p P The source for power spectra. For ASCII files, this is the col‐
78 umn. For binary files, this is the field name. To plot power
79 spectra of multiple curves, this may be specified multiple
80 times. The same source file, sample ranges and fft lengths are
81 used for all Power Spectra requested from the command line.
82 -l P The length of the FFT used in power specra estimation is 2^P.
85 -r f Specify sample rate: f for power spectrum
88 --ru U Specify the units U for psd sample rate
91 --yu U Specify the units U for psd sample rate
94 -h H The source for histograms. For ASCII files, this is the column.
97 For binary files, this is the field name. Multiple histograms
98 can be defined from the command line.
99 -m NC Used when multiple curves have been defined. Rather than plot‐
102 ting all curves in the same plot, plot each in its own plot,
103 -f F0 The starting frame number (for readdata files) or row (for ASCII
106 files) to read.
107 -n The number of frames (for readdata files) or rows (for ASCII
110 files) to read.
111 -s NS The number of frames or rows to skip each read. This is useful
114 when working with very large data files, to speed up response
115 and conserve memory, in the case that the data are slowly vary‐
116 ing.
117 -g Provide a legend box
120 -w file
123 Display the data wizard
124 --nq Bypass the quickstart dialog
127 -a Used in with the -s NS: rather than skipping each NS frames,
130 average them. This provides a combination of very basic high
131 pass filtering, and memory conservation.
132 -F Datafile
135 Override the file to read the data from for all vectors listed
136 in the .kst file. Can only be used in conjunction with a kst
137 file.
138 --print psfile
141 Rather than displaying the plot, export the image to a post‐
142 script file and exit. *BUG note: even though no windows are
143 opened on screen, access to the X server is still required.*
144 --png pngfile
147 Rather than displaying the plot, export the image to a png file
148 of dimensions 640x480 and exit. *BUG note: even though no win‐
149 dows are opened on screen, access to the X server is still re‐
150 quired.*
151
154 Several examples of typical use follow.
155 To plot column 1 a file (tmp.dat) of ASCII data:
158 kst -y 1 tmp.dat
161 To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 1 plot:
164 kst -x 1 -y 2 -y 3 -y 4 tmp.dat
167 To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 3 plots,
170 arranged in 1 column:
171 kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat
174 To plot 500 rows of column 2 of an ASCII file, starting at line 100:
177 kst -y 2 -f 100 -n 500 tmp.dat
180 To plot the first 100,000 rows of column 2 of an ASCII file, averaging
183 every 100 rows:
184 kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat
187 Using command to plot a spectrum from a data field of an ASCII data
190 file with sample rate = 10HZ and FFT length = 2^14
191 kst -p 2 /usr/share/apps/kst/tutorial/gytodata.dat -r 10 -l 14
194 (Using optional HEALPix Data Source) To plot the first 3 maps in a
198 HEALPix FITS file in a 2x2 grid:
199 kst -z 1 -z 2 -z 3 -m 2 healpix_example_sm.fits
202 (Using optional HEALPix Data Source) To plot a map with a specific
205 field name in a HEALPix FITS file:
206 kst -z "1 - TEMPERATURE (Kelvin)" healpix_example_sm.fits
209
212 Duncan Hanson, Rick Chern, Philip Rodrigues, Barth Netterfield, Yiwen
213 Mao.
214 KST COMMAND LINE(1)