XMM-Newton Science Analysis System
dstoplot (dsplot-1.27) [xmmsas_20211130_0941-20.0.0]
The task will convert a dal
table into a format that can be
read with the interactive plotting program Grace. The user can specify
the name of the table, the name of the column and a list of column
names. When Grace reads the output of this task it will produce a plot of the
specified curves, one curve for each column as a function of the
column. The plot is titled with the name of the set and the name of the table.
The axis is labeled with the name and units of the column.
If there is only one column, the axis is labeled with the name and
units of this column; if there are multiple columns then a legend
is added. The user can subsequently process the data and customize the plot
using the graphical interface of Grace. The task dsplot
combines the two steps: It generates a plot file using dstoplot
and then automatically invokes Grace on it.
A second distinct functionality of dstoplot
is the ability to
plot abscissa data ranges as horizontal markers given as values stored
in separate tables. These range markers can be plotted separately or
overlaid onto a collection of plotted data curves. A practical example
is to plot one or several Good-Time-Interval sets together with a
time-series data set or visualize the result of a GTI-merging process
(see e.g. gtimerge).
Please note: Only numerical and boolean columns can be plotted where
in the latter case true translates to 1 and false to 0.
Vector columns are supported - see description of parameter y
On the command line the dstoplot
task is typically applied like this:
dstoplot table=test.dat:some > tmp.grace && xmgrace tmp.grace
XMM-Newton SOC -- 2021-11-30