Next Previous Up Contents
Next: skysim
Up: Table I/O
Previous: Input Locations

5.3 Input Schemes

As well as being able to load tables from external data streams, STILTS offers a way to specify tables that do not correspond to a stream of bytes. These may be defined programmatically or interact with external services in some way that is not as straightforward as decoding a stream of bytes.

Such tables are defined using different schemes, and scheme specifications may be used in the same places as input table names, for instance as the value of the in parameter in tpipe and other commands. If an input location parameter (in) uses a scheme specification, the corresponding input format parameter (ifmt) is ignored.

The form of a scheme specification is:

   :<scheme-name>:<scheme-specific-part>
so that for instance "in=:loop:10" specifies a 10-row single-column table, as described by the loop scheme documentation below. For an example of using such tables, you can try running for instance
   stilts plot2plane in=:attractor:1e7,clifford layer1=mark shading1=density densemap1=plasma x1=x y1=y

The following subsections describe all the schemes that are available by default. It is also possible to add new schemes at runtime by using the startable.schemes system property.


Next Previous Up Contents
Next: skysim
Up: Table I/O
Previous: Input Locations

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