4 Supported data formats

 4.1 Handling 2 and 3D data

SPLAT-VO can read and write spectra stored in a wide variety of formats, either stored as 1D spectra or as columns in tables. 1D spectral formats supported are Starlink NDF & NDX, FITS and simple TEXT files. Table formats supported are FITS (binary and ascii), VOTable and more complex TEXT files. The 1D data formats currently have the best coordinate system support, so are recommended when a choice can be made. Some support is available for 2 and 3D data, see later).

Normally SPLAT-VO differentiates these types using a preset list of file extensions, for instance NDFs can only be stored in container files that have the extension .sdf, FITS files usually have one of the extensions .fits or .fit and TEXT files .txt or .lis and NDX format spectra, when stored on disk, will have extension .xml. However, you can choose a specific format when opening a file using the File->Open dialogue, so you can ask that a TEXT file is opened as a table, this allows you to select the columns. There is also a special type known as guess. When you choose that attempts to open the spectrum as different types are made until one succeeds, or the possibilities are exhausted.

You can specify a type for all the spectra opened on the command-line using the --type argument. Valid values for --type are:

    fits
    hds
    text
    hdx
    table
    line ids
    guess

You free to truncate these values as long as they remain unique (so --type line will work for line identifiers).

Currently line identifier catalogues represent a special case and currently may have a single format - TEXT based in files with extension .ids.

1D spectra stored in TEXT files must have the format of one, two or three columns of data, separated by whitespace (that is spaces or tabs). Any comments in the file must be indicated by a hash sign, blank lines are also allowed. The three columns should have the following values:

    [wavelength] count [error-in-count]

The wavelength and error columns being optional (if you don’t have a wavelength column a simple row index is used, note you cannot have errors without wavelengths) . If you choose to open a TEXT file as a table you can select which columns should be used for these values, and the following rules apply:

The format of line identification catalogues is like that of simple TEXT spectral files, except the second column contains a string that identifies the line (with no spaces, i.e. H-alpha not H alpha). It is also possible to define the system of the coordinate values in a header section, see the SPLAT-VO built-in catalogues for examples of this.

NDFs stored within container files can be accessed, but only by entering the full HDS path on the command-line or in the File->Open dialogue. FITS extensions may also be open in this fashion (by appending the extension number in square brackets).

An alternative to specifying the component information is to use the component browser window PIC , to see the contents of FITS and NDF files and choose the component to display directly. This uses the same techniques as the special guess type.

Internally all these formats are stored as double precision coordinates and data values. SPLAT-VO only requires that coordinates increase or decrease monotonically when performing any analyses.