Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
kst(1)				     kst2				kst(1)

NAME
       kst -- plots scientific data

SYNOPSIS
       kst

       kst    [	-F DATASOURCE ]	[ -f STARTFRAME	] [ -n NUMFRAMES ] [ -s
	      FRAMESPERSAMPLE [	-a ] ] kstfile

       kst    datasource [ -f STARTFRAME ] [ -n	NUMFRAMES ] [ -s
	      FRAMESPERSAMPLE [	-a ] ] [ -P PLOTNAME ] [ -A] [ -d ] [ -l ] [
	      -b ] [ -x	FIELD ]	[ -e FIELD ] [ -r RATE ] [ -y FIELD ] [	-p
	      FIELD ] [	-h FIELD ] [ -z	FIELD ]	[ --png	filename ] [ --print
	      filename [ --landscape | --portrait ] [ --Letter | --A4 ]	]

DESCRIPTION
       kst is a	graphical data plotting	tool, which includes  the  ability  to
       plot  live data (contiuously update the plot as new data	becomes	avail-
       able).

       kst may be run entirely from within its GUI, in which case  no  command
       line  arguments	are needed.  kst has a powerful	wizard for easily set-
       ting up new plots.

       In the second invocation, kst loads pre-saved plot specifications  from
       the  file  kstfile  and optionally may override some of the settings in
       that file.

       In the third invocation,	kst displays plots of the data as directed  in
       the  default  manner.   Additional  datasources may be specified	on the
       command line with options for that datasource  following	 it.   Command
       line  options  generally	 apply	to all subsequent options unless later
       overridden.

OPTIONS
       -A     plot all curves in separate plots

       -a     average frames (simple mean) when	plotting with -s.

       --A4   use A4 sized paper for printing.	Requires --print.

       -b     plot as bargraphs.

       -d     use points when plotting curves.

       -e FIELD
	      use FIELD	as the magnitude of error bars	applied	 to  the  next
	      plot.

       -F datasource
	      override the datasource indicated	in the kstfile and instead use
	      datasource.

       -f STARTFRAME
	      begin plotting at	STARTFRAME frames into the data.  Set to -1 to
	      start at NUMFRAMES from the end of the data.

       -h FIELD
	      plot FIELD as a histogram.

       -l     use lines	when plotting curves.

       --landscape
	      use  landscape  orientation  for	printing.   Requires  --print.
	      --Letter use US  Letter  sized  paper  for  printing.   Requires
	      --print.

       -n NUMFRAMES
	      plot  at	most  NUMFRAMES	frames of data.	 Set to	-1 to indicate
	      all of the data.

       -P PLOTNAME
	      plot all plots in	the plot named PLOTNAME.

       -p FIELD
	      plot FIELD as a power spectrum plot.

       --png filename
	      render to	a portable network graphics (png) image	with file name
	      filename and quit.

       --portrait
	      use portrait orientation for printing.  Requires --print.

       --print filename
	      print the	plot to	file filename and quit.

       -s FRAMESPERSAMPLE
	      plot every FRAMESPERSAMPLE frames	when plotting.

       -x FIELD
	      use FIELD	as the X-axis vector.

       -y FIELD
	      plot FIELD as an XY plot.

       -z FIELD
	      plot FIELD as an image.

EXAMPLES
       Plot all	data in	column 2 from data.dat.
	      kst data.dat -y 2

       Same as above, except only read 20 lines, starting at line 10.
	      kst data.dat -f 10 -n 20 -y 2

       also read col 1.	One plot per curve.
	      kst data.dat -f 10 -n 20 -y 1 -y 2

       Read col	1 from data2.dat and col 1 from	data.dat
	      kst data.dat -f 10 -n 20 -y 2 data2.dat -y 1

       Same as above, except read 40 lines starting at 30 in data2.dat
	      kst data.dat -f 10 -n 20 -y 2 data2.dat -f 30 -n 40 -y 1

       Specify	the  X vector and error	bars: Plot x = col 1 and Y = col 2 and
       error flags = col 3 from	data.dat
	      kst data.dat -x 1	-e 3 -y	2

       Get the X vector	from data1.dat,	and the	Y vector from data2.dat.
	      kst data1.dat -x 1 data2.dat -y 1

       Placement: Plot column 2	and column 3 in	plot P1	and column 4  in  plot
       P2
	      kst data.dat -P P1 -y 2 -y 3 -P P2 -y 4

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

AUTHOR
       Matthew Truch <matt@truch.net>

LICENSE
       Permission is granted to	copy, distribute and/or	modify	this  document
       under  the  terms of the	GNU Free Documentation License,	Version	1.2 or
       any later version published by the Free Software	 Foundation;  with  no
       Invariant  Sections,  with no Front-Cover Texts,	and with no Back-Cover
       Texts.  A copy of the license is	included in the	`COPYING.DOC' file  as
       part of the kst distribution.

Version	2.0.8		       22 February 2011				kst(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | BUGS | AUTHOR | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=kst2&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help