The usage of plothist
is
stilts <stilts-flags> plothist 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|png-transp|gif|jpeg|pdf|eps|eps-gzip inN=<table> ifmtN=<in-format> istreamN=true|false cmdN=<cmds> xdataN=<expr> xlo=<float-value> xhi=<float-value> xlog=true|false xflip=true|false xlabel=<value> subsetNS=<expr> nameNS=<value> colourNS=<rrggbb>|red|blue|... barstyleNS=fill|open|... linewidthNS=<int-value> dashNS=dot|dash|...|<a,b,...> grid=true|false antialias=true|false sequence=<suffix>,<suffix>,... ylo=<float-value> yhi=<float-value> ylog=true|false ylabel=<value> weightN=<value> binwidth=<float-value> norm=true|false cumulative=true|false binbase=<float-value>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
]
barstyleNS = fill|open|...
fill
open
tops
spikes
fillover
openover
[Default: fill
]
binbase = <float-value>
[Default: 0
]
binwidth = <float-value>
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.
cumulative = true|false
[Default: false
]
dashNS = dot|dash|...|<a,b,...>
dot
dash
longdash
dotdash
4,2,8,2
".
A null
value indicates a solid line.
Only certain bar styles are affected by the dash pattern.
font = dialog|serif|...
serif
sansserif
monospaced
dialog
dialoginput
abyssinica_sil
ar_pl_uming_cn
ar_pl_uming_hk
ar_pl_uming_tw
ar_pl_uming_tw_mbe
bitstream_charter
century_schoolbook_l
cm_roman
cm_roman_asian
cm_roman_ce
cm_roman_cyrillic
cm_roman_greek
cm_sans
cm_sans_asian
cm_sans_ce
cm_sans_cyrillic
cm_sans_greek
cm_typewriter
cm_typewriter_asian
cm_typewriter_ce
cm_typewriter_cyrillic
cm_typewriter_greek
courier_10_pitch
cursor
[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
]
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
linewidthNS = <int-value>
[Default: 2
]
nameNS = <value>
norm = true|false
[Default: false
]
ofmt = png|png-transp|gif|jpeg|pdf|eps|eps-gzip
png
: PNGpng-transp
: PNG with transparent backgroundgif
: GIFjpeg
: JPEGpdf
: Portable Document Formateps
: Encapsulated PostScripteps-gzip
: Gzipped Encapsulated PostScriptout
.
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).
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>
weightN = <value>
When weighted, bars can be of negative height. An anomaly of the plot as currently implemented is that the Y axis never descends below zero, so any such bars are currently invisible. This may be amended in a future release (contact the author to lobby for such an amendment).
[Default: 1
]
xdataN = <expr>
xflip = true|false
[Default: false
]
xhi = <float-value>
xlabel = <value>
xlo = <float-value>
xlog = true|false
[Default: false
]
xpix = <int-value>
[Default: 400
]
yhi = <float-value>
ylabel = <value>
[Default: Count
]
ylo = <float-value>
[Default: 0
]
ylog = true|false
[Default: false
]
ypix = <int-value>
[Default: 300
]