Next Previous Up Contents
Next: Plot Parameters
Up: Top
Previous: Multi-Object Matches

## 8 Plotting

As of version 3.0 (October 2014), STILTS offers plotting commands corresponding to the new-style plots in version 4 of the TOPCAT application. The commands are currently:

- `plot2plane`: Draws a plane plot
- `plot2sky`: Draws a sky plot
- `plot2cube`: Draws a cube plot
- `plot2sphere`: Draws a sphere plot
- `plot2corner`: Draws a matrix of plane plots
- `plot2time`: Draws a time plot

(In previous versions the less capable commands `plot2d`, `plot3d` and `plothist` were available - these are now deprecated, but described in Section 9).

These commands all have a similar structure. The plot surface, or geometry of the plot, is defined by which command you use (for instance, if you want to plot longitude/latitude data on the celestial sphere, use `plot2sky`). Content is added to the plot by specifying zero or more plot layers, as described in Section 8.3 below. Section 8.4 describes the shading modes which affect how colouring is performed for some of the layer types. Once a plot has been specified, it can be displayed on the screen or exported in some way according to a selected output mode (Section 8.5) and perhaps export format (Section 8.6). Plots displayed to the screen are by default "live" - they can be resized and navigated around (pan, zoom, rotate, ...) using the mouse in the same way as in a TOPCAT window.

These commands allow you to make all the plots that can be produced with TOPCAT, in some cases with more flexibility in configuration. Unlike TOPCAT, the size of table you can plot is not limited by the size of table you can load into the application. In most cases, STILTS will generate plots from arbitrarily large data sets with fixed (and modest) memory requirements. Performance is of course highly dependent on the details of the plot, but for instance an all-sky density plot for 2 billion points can be produced in the order of 30 minutes.

- 8.1 Plot Parameters

- 8.1.1 Global Parameters
- 8.1.2 Layer Parameters
- 8.1.3 Animation

- 8.2 Surface Types
- 8.3 Layer Types

- 8.3.1 `mark`
- 8.3.2 `size`
- 8.3.3 `sizexy`
- 8.3.4 `xyvector`
- 8.3.5 `xyerror`
- 8.3.6 `xyellipse`
- 8.3.7 `xycorr`
- 8.3.8 `link2`
- 8.3.9 `mark2`
- 8.3.10 `poly4`
- 8.3.11 `mark4`
- 8.3.12 `polygon`
- 8.3.13 `area`
- 8.3.14 `central`
- 8.3.15 `lines`
- 8.3.16 `marks`
- 8.3.17 `handles`
- 8.3.18 `yerrors`
- 8.3.19 `xyerrors`
- 8.3.20 `statline`
- 8.3.21 `statmark`
- 8.3.22 `arrayquantile`
- 8.3.23 `line`
- 8.3.24 `linearfit`
- 8.3.25 `label`
- 8.3.26 `arealabel`
- 8.3.27 `contour`
- 8.3.28 `grid`
- 8.3.29 `fill`
- 8.3.30 `vecfield`
- 8.3.31 `quantile`
- 8.3.32 `histogram`
- 8.3.33 `kde`
- 8.3.34 `knn`
- 8.3.35 `densogram`
- 8.3.36 `gaussian`
- 8.3.37 `function`
- 8.3.38 `skyvector`
- 8.3.39 `skyellipse`
- 8.3.40 `skycorr`
- 8.3.41 `skydensity`
- 8.3.42 `skyvecfield`
- 8.3.43 `healpix`
- 8.3.44 `skygrid`
- 8.3.45 `xyzvector`
- 8.3.46 `xyzerror`
- 8.3.47 `line3d`
- 8.3.48 `spheregrid`
- 8.3.49 `yerror`
- 8.3.50 `spectrogram`

- 8.4 Shading Modes

- 8.4.1 `auto`
- 8.4.2 `flat`
- 8.4.3 `translucent`
- 8.4.4 `transparent`
- 8.4.5 `density`
- 8.4.6 `aux`
- 8.4.7 `weighted`
- 8.4.8 `paux`
- 8.4.9 `pweighted`

- 8.5 Output Modes

- 8.5.1 `swing`
- 8.5.2 `out`
- 8.5.3 `cgi`
- 8.5.4 `discard`
- 8.5.5 `auto`

- 8.6 Export Formats
- 8.7 Colour Maps

Next Previous Up Contents
Next: Plot Parameters
Up: Top
Previous: Multi-Object Matches

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