Description
Create a multi-panel PostScript image or wiggle plot from sampled vector
fields. Select the plotting style and fields, then set clipping, scaling, and
axis options to suit the data; output is PostScript, not a raster image.
Axis formats starting with time: display UTC dates and times from numeric Unix
epoch seconds, with calendar-aligned automatic ticks. Sample coordinates can
use an epoch-valued s0 attribute and a sampling interval ds in seconds.
Synopsis
sgplotps <stdin layout=subgroup out=stdout eps=false #data.label=FIELDNAME #data.image=grey #data.wiggle=false #data.wiggle.scale=1.0 #data.wiggle.linewidth=0.1 #data.wiggle.ccurv="50" #data.wiggle.cleft=NULL #data.wiggle.cright=NULL #data.wiggle.cpos="50" #data.wiggle.cneg=NULL image.bar=true image.bar.length=1.0 image.bar.thick=6 image.bar.space=4 graph=NULL #graph.color="000000" #graph.label=FIELDNAME #graph.linewidth=0.5 graph.legend=none graph.legend.font=Roman graph.legend.style=normal graph.legend.size=8 left= right= top= bottom= xreverse=false yreverse=trueParameters
| Parameter | Type | Default | Description |
|---|---|---|---|
in |
ifile |
stdin
|
input dataset; each group produces a page, with panels arranged by subgroup and vector |
layout |
enum |
subgroup
|
arrange subgroups or vectors side by side |
out |
figure |
stdout
|
output PostScript figure |
eps |
bool |
false
|
write Encapsulated PostScript |
#data.label |
str |
FIELDNAME
|
vector label |
#data.image |
image |
grey
|
image-rendering parameters for this vector |
#data.wiggle |
bool |
false
|
enable a wiggle plot for this vector |
#data.wiggle.scale |
float |
1
|
scale for wiggles |
#data.wiggle.linewidth |
float |
0.1
|
wiggle line width |
#data.wiggle.ccurv |
str |
50
|
curve color in hexadecimal format |
#data.wiggle.cleft |
str |
NULL
|
left fill color in hexadecimal format; NULL disables fill |
#data.wiggle.cright |
str |
NULL
|
right fill color in hexadecimal format; NULL disables fill |
#data.wiggle.cpos |
str |
50
|
positive fill color in hexadecimal format |
#data.wiggle.cneg |
str |
NULL
|
negative fill color in hexadecimal format; NULL disables fill |
image.bar |
bool |
true
|
show color bars for image plots |
image.bar.length |
float |
1
|
colorbar length in ratio |
image.bar.thick |
float |
6
|
colorbar thickness in points |
image.bar.space |
float |
4
|
colorbar space to plot in points |
graph |
fields |
NULL
|
scalar fields to draw as graphs over the panels |
#graph.color |
str |
000000
|
graph color |
#graph.label |
str |
FIELDNAME
|
graph label |
#graph.linewidth |
float |
0.5
|
graph linewidth |
graph.legend |
enum |
none
|
graph-legend position |
graph.legend.font |
enum |
Roman
|
legend font |
graph.legend.style |
enum |
normal
|
font style |
graph.legend.size |
float |
8
|
font size in points |
left |
axis |
Unknown | axis for vector sample coordinates |
right |
axis |
Unknown | right-axis settings; image and wiggle panels do not draw this axis |
top |
axis |
Unknown | axis for column coordinates |
bottom |
axis |
Unknown | subgroup labels, one centered value per subgroup |
xreverse |
bool |
false
|
reverse the x axis |
yreverse |
bool |
true
|
reverse the y axis |
Input and output
Input
input dataset; each group produces a page, with panels arranged by subgroup and vector
Output
output PostScript figure
Examples
1. Label a sampled epoch-time axis in UTC
sgplotps left.label="UTC" left.fmt="time:%m-%d %H:%M:%S" \
left.tic=auto5 out.edge.left=90 <sampled.sg >sampled.psThe selected vector's s0 attribute must contain Unix epoch seconds and ds
must contain its sampling interval in seconds. Values remain numeric;
the format changes tick labels and automatic spacing, not the samples.