The usage of plot2d
is
stilts <stilts-flags> plot2d xpix=<int-value> ypix=<int-value> font=dialog|serif|... fontsize=<int-value> fontstyle=plain|bold|italic|bold-italic legend=true|false title=<value> omode=swing|out|cgi|discard|auto out=<out-file> ofmt=png|gif|jpeg|pdf|eps|eps-gzip inN=<table> ifmtN=<in-format> istreamN=true|false cmdN=<cmds> xdataN=<expr> ydataN=<expr> auxdataN=<expr> xlo=<float-value> ylo=<float-value> auxlo=<float-value> xhi=<float-value> yhi=<float-value> auxhi=<float-value> xlog=true|false ylog=true|false auxlog=true|false xflip=true|false yflip=true|false auxflip=true|false xlabel=<value> ylabel=<value> auxlabel=<value> xerrorN=<expr>|[<lo-expr>],[<hi-expr>] yerrorN=<expr>|[<lo-expr>],[<hi-expr>] auxshader=rainbow|pastel|... txtlabelN=<value> subsetNS=<expr> nameNS=<value> colourNS=<rrggbb>|red|blue|... shapeNS=filled_circle|open_circle|... sizeNS=<int-value> transparencyNS=<int-value> lineNS=DotToDot|LinearRegression linewidthNS=<int-value> dashNS=dot|dash|...|<a,b,...> hideNS=true|false errstyleNS=lines|capped_lines|... grid=true|false antialias=true|false sequence=<suffix>,<suffix>,...If you don't have the
stilts
script installed,
write "java -jar stilts.jar
" instead of
"stilts
" - see Section 3.
The available <stilts-flags>
are listed
in Section 2.1.
Parameter values are assigned on the command line as explained in Section 2.3. They are as follows:
antialias = true|false
[Default: true
]
auxdataN = <expr>
auxflip = true|false
[Default: false
]
auxhi = <float-value>
auxlabel = <value>
auxlo = <float-value>
auxlog = true|false
[Default: false
]
auxshader = rainbow|pastel|...
rainbow
pastel
standard
heat
colour
hue
greyscale
red-blue
hsv_h
hsv_s
hsv_v
intensity
rgb_red
rgb_green
rgb_blue
yuv_y
yuv_u
yuv_v
transparency
[Default: rainbow
]
cmdN = <cmds>
Commands may alteratively be supplied in an external file,
by using the indirection character '@'.
Thus a value of "@filename
"
causes the file filename
to be read for a list
of filter commands to execute. The commands in the file
may be separated by newline characters and/or semicolons.
colourNS = <rrggbb>|red|blue|...
ff00ff
" for magenta.
Alternatively it may be the name of one of the
pre-defined colours.
These are currently
red, blue, green, grey, magenta, cyan, orange, pink, yellow, black and white.
For most purposes, either the American or the British spelling is accepted for this parameter name.
dashNS = dot|dash|...|<a,b,...>
dot
dash
longdash
dotdash
4,2,8,2
".
A null
value indicates a solid line.
Only has an effect if the
lineNS
parameter is set to draw lines.
errstyleNS = lines|capped_lines|...
none
lines
capped_lines
caps
arrows
ellipse
crosshair_ellipse
rectangle
crosshair_rectangle
filled_ellipse
filled_rectangle
[Default: lines
]
font = dialog|serif|...
serif
sansserif
monospaced
dialog
dialoginput
bitstream_charter
bitstream_vera_sans
bitstream_vera_sans_mono
bitstream_vera_serif
century_schoolbook_l
courier
courier_10_pitch
cursor
dejavu_lgc_sans
dejavu_lgc_sans_condensed
dejavu_lgc_sans_light
dejavu_lgc_sans_mono
dejavu_lgc_serif
dejavu_lgc_serif_condensed
dingbats
hershey
liberation_mono
liberation_sans
liberation_serif
lucida_bright
lucida_sans
lucida_sans_typewriter
luxi_mono
luxi_sans
[Default: dialog
]
fontsize = <int-value>
[Default: 12
]
fontstyle = plain|bold|italic|bold-italic
plain
,
bold
,
italic
and
bold-italic
.
[Default: plain
]
grid = true|false
[Default: true
]
hideNS = true|false
[Default: false
]
ifmtN = <in-format>
(auto)
(the default),
then an attempt will be
made to detect the format of the table automatically.
This cannot always be done correctly however, in which case
the program will exit with an error explaining which
formats were attempted.
[Default: (auto)
]
inN = <table>
ifmtN
parameter.
istreamN = true|false
inN
table
will be read as a stream.
It is necessary to give the
ifmtN
parameter
in this case.
Depending on the required operations and processing mode,
this may cause the read to fail (sometimes it is necessary
to read the input table more than once).
It is not normally necessary to set this flag;
in most cases the data will be streamed automatically
if that is the best thing to do.
However it can sometimes result in less resource usage when
processing large files in certain formats (such as VOTable).
[Default: false
]
legend = true|false
lineNS = DotToDot|LinearRegression
null
:
No line is plotted.DotToDot
:
Each point is joined to the next one in sequence
by a straight line.LinearRegression
:
A linear regression line is plotted based on all the points
which are visible in the plot.
Note that the regression coefficients take no account of
points out of the visible range.linewidthNS = <int-value>
Only has an effect if the
lineNS
parameter is set to draw lines.
[Default: 1
]
nameNS = <value>
ofmt = png|gif|jpeg|pdf|eps|eps-gzip
png
: image/png formatgif
: image/gif formatjpeg
: image/jpeg formatpdf
: application/pdf formateps
: application/postscript formateps-gzip
: application/postscript (gzip) formatout
.
omode = swing|out|cgi|discard|auto
swing
:
Plot will be displayed in a window on the screen.out
:
Plot will be written to a file given by out
using the graphics format given by ofmt
.cgi
:
Plot will be written in a way suitable for CGI use direct from a web server.
The output is in the graphics format given by ofmt
,
preceded by a suitable "Content-type" declaration.discard
:
Plot is drawn, but discarded. There is no output.auto
:
Behaves as swing
or out
mode depending on presence of out
parameter[Default: auto
]
out = <out-file>
sequence = <suffix>,<suffix>,...
NS
"
suffixes which appear on the
parameters which apply to subsets.
The sets which are named
will be plotted in order, so the first-named one will be
at the bottom (most likely to be obscured).
Note that if this parameter is supplied, then only those sets
which are named will be plotted,
so this parameter may also be used to restrict which plots appear
(though it may not be the most efficient way of doing this).
If no explicit value is supplied for this parameter,
sets will be plotted in some sequence decided by STILTS
(probably alphabetic by suffix).
shapeNS = filled_circle|open_circle|...
filled_circle
open_circle
cross
x
open_square
open_diamond
open_triangle_up
open_triangle_down
filled_square
filled_diamond
filled_triangle_up
filled_triangle_down
sizeNS = <int-value>
[Default: -1
]
subsetNS = <expr>
NS
".
This is a boolean expression which may be the name of
a boolean-valued column or any other boolean-valued expression.
Rows for which the expression evaluates true will be included
in the subset, and those for which it evaluates false will not.
title = <value>
transparencyNS = <int-value>
<n>
means that opacity is only
achieved (the background is only blotted out)
when <n>
pixels of this colour have been
plotted on top of each other.
The minimum value is 1, which means opaque markers.
txtlabelN = <value>
xdataN = <expr>
xerrorN = <expr>|[<lo-expr>],[<hi-expr>]
<expr>
: symmetric error value<lo-expr>,<hi-expr>
:distinct lower and upper error values<lo-expr>,
: lower error value only,<hi-expr>
: upper error value onlynull
: no errorsxflip = true|false
[Default: false
]
xhi = <float-value>
xlabel = <value>
xlo = <float-value>
xlog = true|false
[Default: false
]
xpix = <int-value>
[Default: 400
]
ydataN = <expr>
yerrorN = <expr>|[<lo-expr>],[<hi-expr>]
<expr>
: symmetric error value<lo-expr>,<hi-expr>
:distinct lower and upper error values<lo-expr>,
: lower error value only,<hi-expr>
: upper error value onlynull
: no errorsyflip = true|false
[Default: false
]
yhi = <float-value>
ylabel = <value>
ylo = <float-value>
ylog = true|false
[Default: false
]
ypix = <int-value>
[Default: 300
]