1kst(1)                               kst2                               kst(1)
2
3
4

NAME

6       kst — plots scientific data
7

SYNOPSIS

9       kst
10
11       kst    [ -F DATASOURCE ] [ -f STARTFRAME ] [ -n NUMFRAMES ] [ -s
12              FRAMESPERSAMPLE [ -a ] ] kstfile
13
14       kst    datasource [ -f STARTFRAME ] [ -n NUMFRAMES ] [ -s
15              FRAMESPERSAMPLE [ -a ] ] [ -P PLOTNAME ] [ -A] [ -d ] [ -l ] [
16              -b ] [ -x FIELD ] [ -e FIELD ] [ -r RATE ] [ -y FIELD ] [ -p
17              FIELD ] [ -h FIELD ] [ -z FIELD ] [ --png filename ] [ --print
18              filename [ --landscape | --portrait ] [ --Letter | --A4 ] ]
19

DESCRIPTION

21       kst is a graphical data plotting tool, which includes  the  ability  to
22       plot  live data (contiuously update the plot as new data becomes avail‐
23       able).
24
25       kst may be run entirely from within its GUI, in which case  no  command
26       line  arguments  are needed.  kst has a powerful wizard for easily set‐
27       ting up new plots.
28
29       In the second invocation, kst loads pre-saved plot specifications  from
30       the  file  kstfile  and optionally may override some of the settings in
31       that file.
32
33       In the third invocation, kst displays plots of the data as directed  in
34       the  default  manner.   Additional  datasources may be specified on the
35       command line with options for that datasource  following  it.   Command
36       line  options  generally  apply  to all subsequent options unless later
37       overridden.
38

OPTIONS

40       -A     plot all curves in separate plots
41
42       -a     average frames (simple mean) when plotting with -s.
43
44       --A4   use A4 sized paper for printing.  Requires --print.
45
46       -b     plot as bargraphs.
47
48       -d     use points when plotting curves.
49
50       -e FIELD
51              use FIELD as the magnitude of error bars  applied  to  the  next
52              plot.
53
54       -F datasource
55              override the datasource indicated in the kstfile and instead use
56              datasource.
57
58       -f STARTFRAME
59              begin plotting at STARTFRAME frames into the data.  Set to -1 to
60              start at NUMFRAMES from the end of the data.
61
62       -h FIELD
63              plot FIELD as a histogram.
64
65       -l     use lines when plotting curves.
66
67       --landscape
68              use  landscape  orientation  for  printing.   Requires  --print.
69              --Letter use US  Letter  sized  paper  for  printing.   Requires
70              --print.
71
72       -n NUMFRAMES
73              plot  at  most  NUMFRAMES frames of data.  Set to -1 to indicate
74              all of the data.
75
76       -P PLOTNAME
77              plot all plots in the plot named PLOTNAME.
78
79       -p FIELD
80              plot FIELD as a power spectrum plot.
81
82       --png filename
83              render to a portable network graphics (png) image with file name
84              filename and quit.
85
86       --portrait
87              use portrait orientation for printing.  Requires --print.
88
89       --print filename
90              print the plot to file filename and quit.
91
92       -s FRAMESPERSAMPLE
93              plot every FRAMESPERSAMPLE frames when plotting.
94
95       -x FIELD
96              use FIELD as the X-axis vector.
97
98       -y FIELD
99              plot FIELD as an XY plot.
100
101       -z FIELD
102              plot FIELD as an image.
103

EXAMPLES

105       Plot all data in column 2 from data.dat.
106              kst data.dat -y 2
107
108       Same as above, except only read 20 lines, starting at line 10.
109              kst data.dat -f 10 -n 20 -y 2
110
111       also read col 1. One plot per curve.
112              kst data.dat -f 10 -n 20 -y 1 -y 2
113
114       Read col 1 from data2.dat and col 1 from data.dat
115              kst data.dat -f 10 -n 20 -y 2 data2.dat -y 1
116
117       Same as above, except read 40 lines starting at 30 in data2.dat
118              kst data.dat -f 10 -n 20 -y 2 data2.dat -f 30 -n 40 -y 1
119
120       Specify  the  X vector and error bars: Plot x = col 1 and Y = col 2 and
121       error flags = col 3 from data.dat
122              kst data.dat -x 1 -e 3 -y 2
123
124       Get the X vector from data1.dat, and the Y vector from data2.dat.
125              kst data1.dat -x 1 data2.dat -y 1
126
127       Placement: Plot column 2 and column 3 in plot P1 and column 4  in  plot
128       P2
129              kst data.dat -P P1 -y 2 -y 3 -P P2 -y 4
130

BUGS

132       Please  report bugs to either the kst mailing list at kst@kde.org or to
133       the kde bugzilla under the kst product at http://bugs.kde.org/.  If you
134       can  run kst, you can easily report bugs by selecting Bug Report Wizard
135       from the Help menu.
136

AUTHOR

138       Matthew Truch <matt@truch.net>
139

LICENSE

141       Permission is granted to copy, distribute and/or modify  this  document
142       under  the  terms of the GNU Free Documentation License, Version 1.2 or
143       any later version published by the Free Software  Foundation;  with  no
144       Invariant  Sections,  with no Front-Cover Texts, and with no Back-Cover
145       Texts.  A copy of the license is included in the `COPYING.DOC' file  as
146       part of the kst distribution.
147
148
149
150Version 2.0.8                  22 February 2011                         kst(1)