Next Previous Up Contents
Next: plot2d: Old-style 2D Scatter Plot
Up: plot2time: Draws a time plot
Previous: Usage

### B.19.2 Examples

Here are some examples of `plot2time`:

    stilts plot2time xpix=1000 ypix=300
                     in=ACE_data.vot t=epoch
                     layer.r=line y.r=Br color.r=grey
                     layer.t=line y.t=Bt color.t=cyan
                     layer.n=line y.n=Bn color.n=pink

  Three time series are plotted on the same axes as lines in different colours. In this case we trust the markup in the VOTable input to describe the format of the `epoch` column.

    stilts plot2time xpix=1000 ypix=1000
                     in=ACE_data.vot t=fp_year ttype=decyear
                     layer.r=line y.r=Br zone.r=ZR
                     layer.t=line y.t=Bt zone.t=ZT
                     layer.n=line y.n=Bn zone.n=ZN
                     titleZR="Br" titleZT="Bt" titleZN="Bn"

  The same data is plotted as in the previous example, but in this case each line is drawn in a different panel (zone), stacked vertically. The default colour is used for each line. Each plot is given a different title; note the `title` parameter suffixes refer to the zone identifiers not the layer identifiers. The time coordinate in this case is supplied as a decimal year column which does not have sufficient metadata to identify it as such, so we specify the time format explicitly as `decyear`.

    stilts plot2time tmin=2007-06-07T02:40 tmax=2007-06-07T06:20 tformat=mjd
                     in=STEREO_STA_L1_SEPT_20070607_V05.cdf t=epoch_ns
                     ylabel=Channel
                     layer_3=spectrogram spectrum_3=Spec_0_NS
                     auxmap=accent auxfunc=log

  Plots a spectrogram from a CDF file. The range along the horizontal axis is specified explicitly using ISO-8601 date strings, but it is labelled in Modified Julian Date.

    stilts plot2time in=STEREO_STA_L1_SEPT_20070607_V05.cdf t=epoch_ns
                     layer_1=spectrogram spectrum_1=spec_0_ns zone_1=A
                     layer_2=spectrogram spectrum_2=spec_0_e  zone_2=B
                     layer_3=line y_3='mean(spec_0_ns)' color_3=plum    zone_3=C
                     layer_4=line y_4='mean(spec_0_e)'  color_4=skyblue zone_4=C
                     ylogC=true
                     auxfunc=sqrt auxmapA=viridis auxmapB=magma

  This is a 3-zone plot; zones `A` and `B` each contains a spectrogram (layers `_1` and `_2`), and zone `C` contains two line plots (layers `_3` and `_4`). The Y axis is set to logarithmic for zone C only. The colour ramps are configured with `aux*` parameters; the stretch function is set to `sqrt` for all zones, and the colour map is set to different values for zones A and B.

Next Previous Up Contents
Next: plot2d: Old-style 2D Scatter Plot
Up: plot2time: Draws a time plot
Previous: Usage

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk
Mailing list: topcat-user@jiscmail.ac.uk