USAGE:
tslg {
NOFILE | file.ts [
tslist-options ] } { +options | +
} [ psxy-options ]
PURPOSE:
Make a plot from
the binary file file.ts
A component of a
multi-component files are plotted with the -Llabel option.
In principle, even
ASCII-files can be processed; however, the tslist-options might
become tedious. A
suggestion is to pre-run an ASCII-BIN conversion.
For appending
BIN-files, a tslist-app job must be issued as a
pre-runner.
In ~/TD there is a
script tslapp specialized on gravimeter files.
If NOFILE is
specified, the call may just close the current plot (+cont,
no +keep).
This is useful if tslg
must be called inside a loop with an unknown number of courses.
(With +keep +cont
you may thus add a legend line.)
NOFILE can be
skipped if the first option is a nontrivial +option
Advertisement
Do you like a plot like this? Then consider tsllg
It was made with
tsllg -LUL -from
2015,01,01,00,00,00 -ls 32400 -L G+V -L G+B -D +M
"A title" +P testd.ps -
tslist-OPTIONS:
N.B.: This routine will run in a sub-directory
./plot/ (iff one exists).
Therefore, file
names in the option string have to either anticipate
the change to a
subdir (e.g. edit option -E../deci.tse,L ) or, for
convenience, the
file name can be prepended with `pwd`/
-tp[dfmt] - this is a
special code not recognized by tslist. Instead, the option is
expanded to -Ft1,f13.6,$dfmt -p2:1,2
-N -n1
suitable for t-point files. Default dfmt = f10.2
+OPTIONS:
Options
controlling this very script start with a `+´ sign.
They must be
kept together, i.e. they cannot be mixed with the options to
neither psxy nor
tslist.
If all-default
is intended, a lone `+´ must be given.
Some options work only
in the first (-F-), some only
in the last (-L-)
of a series of tslg
invocations.
+V
- verbose.
+VV
- verbose with set echo
+left -F- draw a y-axis
only to the left (intending a +right axis later);
default is the same axis left and right.
+keep -
don't close the plot yet. Additional curves can be added.
Take the curve with the widest
Y-range first, else you must
edit the .tslg file.
+cont
- continue on a previous tslg plot.
+first
- continue on a previous plot drawing
a new psbasemap.
+right
- continue on a previous plot but add a
right Y-axis.
Only one such extension and
ensuing ordinate scaling can be applied.
+S
- in combination with GMT -Woption: Staircase line
(boxcar, sample-and-hold)
default is a regular line
+H "words"
- headline. Default is derived from input file name.
With EMPTY as the only word, no headline is plotted.
With +LEG the headline goes into the
legend.
+H NOFEED - With
+LEG : If a curve must be composed of a number of
tslg calls
(e.g. plotting error bars, symbols and lines), the legend position
is not incremented and no text is added. Only the specimen is
placed.
+LEG ["a-opts"]::["p-opts"]
- prepare a legend. A legend item is added.
Without +keep the legend is drawn using the p-opts
a-opts -
Options for addlegend:
lines, symbols, colors, text rendering...
p-opts -L- Options for pslegend:
legend rendering, position, size...
If you need to add a curve manually and its legend entry, look here ("Additional legend entry")
+M "words"
-L-
a subtitle. Enclose more than one word within " "
With EMPTY as the only word, no subtitle is
plotted.
With +LEG the subtitle will be written
as the main title. This is the
last action before the plot is closed.
Without +LEG the subtitle will be written
in 14-pt font size
and placed centered inside the diagram
near the top.
A suggestion: Rely first on axes defaults
before you try and tailor them with
+YAX and +TAX .
The Calendar option isn't easy to handle either.
+T title -F- time-axis label.
Default = "Year". Shorthands exist, see below.
title may consist of more than one word. Everything is
taken as
title text until a leading `+´ is encountered. A lone + will
be
necessary before a coming `-´ option.
Since colons cause interference with the GMT title delimiter,
use the octal code \072 instead.
Example: +T "s from 03\07200\07200"
+ yields [s] from
03:00:00
Since brackets cause difficulties inside the script,
enclose a unit in double slashes. For example,
+T
Length //m// + will be translated to Length [m]
+T EMPTY
yields an untitled and
unenumerated axis.
+TAX
"opts" -F-
time-axis options for axlim4ts in addition to -RB
-pf10.3
+TAX F rlo/rhi ticks
-F- "forced" =
user-supplied parameters for GMT psxy -Rrlo/rhi and
-Bticks
+C title -L- add calendar, month
names, monthly divides, and 10-day ticks.
Rules for title are the same as under +T
+CF title
-L- like
+C, plus an alternating color background for each month.
+CO "opts" -L- options
for calaxis. Use calaxis -h for
information.
+Y title -
ordinate label. Default = "Signal". Shorthands exist, see below.
Rules for title are the same as under +T
+YAX "opt" - ordinate
options for axlim4ts in addition to -RB -pf10.3
+YAX F rlo/rhi ticks
- "forced"
= user-supplied parameters for GMT psxy -R../rlo/rhi
and -B../ticks
+YAX F0
- include zero in the axis range.
+P psfile
-F- PS output
(PNG too), default is derived from input file name and label:
`basename file.ts`.ps
or `basename file.ts`_label.ps
+A word -F- to add a word at the
end of the PS-file name (before the last `.´
+cc
- "continuous curve", removes the -m option in psxy.
+tn [tfile] -L- Make (i.e. renew) a
html page with a thumbnail collection;
requirement: PNGOUT has been set, and an
html-template
tfile (default:
/home/hgs/TD/tslg-collection_html.template) exists
(~/bin/make-img-index-html is used)
+EMPH color - very special,
apply together with psxy option -S for a symbol that can
be filled (e.g. -Sc0.8) : Plot the abs-max point
filled with color
(cannot change the outline colour nor the stroke).
+EMPHMIN color emphasize the data
minimum
+EMPHMAX color
emphasize the data maximum
For control from environment, setenv KINDEMPH {-1|0|+1}
and
specify option +EMPH color to emphasize {min|max-abs|max}.
What we don't offer (yet) is both.
PSXY OPTIONS:
You probably need -m for coping
with gaps. That's a default.
If that's a problem, use option +cc
(continuous curve)
-W3/0 - the default.
SHORTHANDS FOR AXIS TITLES:
TIME AXIS, first element of string:
y | j | any
-> [Years] | [MJD] | [any]
The default will yield Time [-]
second element of string:
@
-> "on date" where date is derived from input file
ORDINATE:
g | a | p
-> "Gravity [nm/s@+2@+]" | "Acceleration [nm/s@+2@+]"
| "Pressure [hPa]"
Shorthands can be extended; edit the script at "# Shorthands:"
or
write a csh source script with definitions. The variables
are called
tunits
and yunits.
ENVIRONMENT:
PNGOUT - the
directory where to put the final PNG-file. Defaults to PNG/
or plot/PNG or plot/ or ./
PNGRSL - the
resolution of the final PNG plot. Default = 144x144
TSLG_FRAME - the size of the
diagram, default = -JX9/5
TSLG_XORIGIN - the horizontal
distance between the left paper edge and
the diagram's origo. Default 1.5
TSLG_YORIGIN - the vertical
distance between the lower paper edge and
the
diagram's origo. Default = psbasemap's default.
TSLG_LEGFEED - 1 or -1 for legend
entries going up or down. Default is 1, up.
FILES:
If a
file
./.tslg.shorthands
exists, it
will be sourced.
The
PS file name is stored in
(plot/).tslg.ps
for re-use
with +cont or +right
A
little csh source script for parameter setting is saved /
loaded:
(plot/).tslg
(plot/).tslg.basemap-left
(plot/).tslg.basemap-right
- output only, maybe
useful for interspersing GMT commands
Contains
axes ranges and projection/diagram size
EXAMPLES:
setenv PNGOUT ~/www/4me/tslg/
tslg d/g100201-130515-1h.mc -L'B|V'
-BHc2012,5,1 -U2012,7,1 +T Year +Y "Air pressure [hPa]" \
-m -Sc0.03
-W1/0 -G0
Note: In this example, tslist's default time format is used, float
years.
With -N time tags, the
calendar option will not function.
RJD and floating-point
years are possible with +C
tslg d/G1_garb_131125-1s.mc
-L'G|B' -E`pwd`/deci.tse,D10 -N -n/360 -D \
-BHc2013,11,25,6 -U2013,11,25,7,20 -D \
+T "Hours on 2013-11-25" +Y
"Gravity [nm/s@+2@+]" \
+P
eq_SouthAtlantic_2013-11-25_06-07.ps \
+M "USGS:
2013-11-25 06:27:33 (M7.0) SOUTH ATLANTIC OCEAN -53.9 -54.9
(43a6c)"
tslg d/G1_garb_131125-1s.mc -L'G|B' -N
-n/3600 +
A
bare minimum. We specify -N -n/3600
in order to get labels and ticks in units of hours (incl. an
offset from midnight)..
A single-component
file spanning more than a year would cope with
tslg file.ts +
A particularly nice example
is in Ttide/SCG/prl-files-and-coeffs
Another nice one in TD/cal1504/calplot
calplot +P +O -ph
A quick-view into a multi-year
MC-file, plotting all components:
foreach label ( `tslql -L, file.mc` )
tslg file.mc $label +
end
For shorter and much shorter
files you'll need some ascii output options of tslist
Drawing tilt control curves:
setenv PNGOUT $pngout
tslg d/A1_t_090701-ystrdy-1h.mc -LTX
-E`pwd`/tiltclean.tse,C \
+keep +T y +LEG
-W8/0/0/255:: +P A1_t_090701-ystrdy.ps +H TX-Power -W3/0/0/255
tslg d/A1_t_090701-ystrdy-1h.mc -LTY
-E`pwd`/tiltclean.tse,C \
+cont +LEG
-W8/255/0/::-JX2/0.5 +H TY-Power \
+M "Tilt control
up to "`tslqd e -: d/A1_t_090701-ystrdy-1h.mc` -W3/255/0/0
from ~/TD/tilt-control-monitor . With legend.
Additional legend entry:
cd plot/
source .tslg
# plot your curve, e.g. with
psxy -R$tax[1]/$yax[1] -JX -K
-O -W3/128 >> PS/ps-file
# you can obtain the ps-file name with
eval
`head -1 .tslg.ps`
set yleg=`echo "SCG resid" | addlegend -y$yleg -d1
-W7/128`
echo set yleg = $yleg >> .tslg
cd ../
or simpler with the special script
~/bin/tslg-addlegend
cd plot/
source .tslg
set ps=`tslg-addlegend "SCG
resid [@~m@~Gal]" -W3/128`
psxy ... >> PS/$ps
cd ../
.bye