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|svg|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.
For programmatic invocation,
the Task class for this
command is uk.ac.starlink.ttools.task.TableHistogram
.
Parameter values are assigned on the command line as explained in Section 2.3. They are as follows:
antialias = true|false
(Boolean)
[Default: true
]
barstyleNS = fill|open|...
(BarShape)
fill
open
tops
semi
semitops
spikes
fillover
openover
[Default: fill
]
binbase = <float-value>
(Double)
[Default: 0.0
]
binwidth = <float-value>
(Double)
cmdN = <cmds>
(ProcessingStep[])
Commands may alternatively 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,
and lines which are blank or which start with a
'#
' character are ignored.
A backslash character '\
' at the end of a line
joins it with the following line.
colourNS = <rrggbb>|red|blue|...
(Color)
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
(Boolean)
[Default: false
]
dashNS = dot|dash|...|<a,b,...>
(float[])
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|...
(String)
serif
sansserif
monospaced
dialog
dialoginput
aakar
abyssinica_sil
ani
anjalioldlipi
bitstream_charter
c059
cantarell
cantarell_extra_bold
cantarell_light
cantarell_thin
century_schoolbook_l
chandas
chilanka
courier
courier_10_pitch
d050000l
dejavu_math_tex_gyre
dejavu_sans
dejavu_sans_condensed
dejavu_sans_light
dejavu_sans_mono
dejavu_serif
dejavu_serif_condensed
dingbats
...
[Default: dialog
]
fontsize = <int-value>
(Integer)
[Default: 12
]
fontstyle = plain|bold|italic|bold-italic
(Integer)
plain
,
bold
,
italic
and
bold-italic
.
[Default: plain
]
grid = true|false
(Boolean)
[Default: true
]
ifmtN = <in-format>
(String)
inN
.
The known formats are listed in Section 5.1.1.
This flag can be used if you know what format your
table is in.
If it has the special value
(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.
This parameter is ignored for scheme-specified tables.
[Default: (auto)
]
inN = <table>
(StarTable)
-
",
meaning standard input.
In this case the input format must be given explicitly
using the ifmtN
parameter.
Note that not all formats can be streamed in this way.:<scheme-name>:<scheme-args>
.<
" character at the start,
or a "|
" character at the end
("<syscmd
" or
"syscmd|
").
This executes the given pipeline and reads from its
standard output.
This will probably only work on unix-like systems.istreamN = true|false
(Boolean)
inN
parameter
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 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).
This parameter is ignored for scheme-specified tables.
[Default: false
]
legend = true|false
(Boolean)
linewidthNS = <int-value>
(Integer)
[Default: 2
]
nameNS = <value>
(String)
norm = true|false
(Boolean)
[Default: false
]
ofmt = png|png-transp|gif|jpeg|pdf|svg|eps|eps-gzip
(GraphicExporter)
png
: PNGpng-transp
: PNG with transparent backgroundgif
: GIFjpeg
: JPEGpdf
: Portable Document Formatsvg
: Scalable Vector Graphicseps
: Encapsulated PostScripteps-gzip
: Gzipped Encapsulated PostScriptout
.
omode = swing|out|cgi|discard|auto
(PaintMode)
swing
:
Plot will be displayed in a window on the screen.
This plot is "live"; it can be resized and (except for old-style plots)
navigated around with mouse actions in the same way as plots in TOPCAT.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>
(uk.ac.starlink.util.Destination)
sequence = <suffix>,<suffix>,...
(String[])
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>
(String)
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>
(String)
weightN = <value>
(String)
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>
(String)
xflip = true|false
(Boolean)
[Default: false
]
xhi = <float-value>
(Double)
xlabel = <value>
(String)
xlo = <float-value>
(Double)
xlog = true|false
(Boolean)
[Default: false
]
xpix = <int-value>
(Integer)
[Default: 400
]
yhi = <float-value>
(Double)
ylabel = <value>
(String)
[Default: Count
]
ylo = <float-value>
(Double)
[Default: 0.0
]
ylog = true|false
(Boolean)
[Default: false
]
ypix = <int-value>
(Integer)
[Default: 300
]