3 TSP Data Format

The essence of the system is a common data format in which time series polarimetry data can be represented. This format is based on the Starlink standard data format described in SGP/38. In particular the polarimetry example given in that document is the basis for the TSP data format. The hierarchical structure of a typical TSP dataset is shown below.

Component Type Description
DATA_ARRAY(N,M) _REAL Stokes I array
VARIANCE(N,M) _REAL Variance on I array
LABEL _CHAR Label for data
UNITS _CHAR Units for data
AXIS(2) Structure Array Axis information
   AXIS(1) AXIS Wavelength Axis
      .DATA_ARRAY(N) _REAL Wavelength Axis Data
      .LABEL _CHAR Wavelength Axis Label
      .UNITS _CHAR Wavelength Axis Units
   AXIS(2) AXIS Time Axis
      .DATA_ARRAY(M) _DOUBLE Time Axis Data
      .LABEL _CHAR Time Axis Label
      .UNITS _CHAR Time Axis Units
MORE EXT Extension structure
   .POLARIMETRY EXT Polarimetry Extension
      .STOKES_Q NDF Q Stokes parameter structure
      .DATA_ARRAY(N,M) _REAL Stokes Q array
      .VARIANCE(N,M) _REAL Variance on Q array
      .STOKES_U NDF U Stokes parameter structure
      .DATA_ARRAY(N,M) _REAL Stokes U array
      .VARIANCE(N,M) _REAL Variance on U array

The DATA_ARRAY component shown here may actually be replaced by a structure which holds the data array and other components.

The TSP structure is a special case of the NDF (Extensible N-Dimensional Data Format) described in SGP/38. The main data array of the NDF structure contains the I or Intensity Stokes parameter data. A polarimetry extension structure contains up to 3 additional NDF structures corresponding to the Stokes parameters containing the polarization information. Any number from zero to three of these additional Stokes structures may be present. The above example has the two linear polarization Stokes parameters in structures STOKES_Q and STOKES_U. For circular polarization data a structure called STOKES_V would be used.

The STOKES NDF structures contain only DATA_ARRAY and optionally VARIANCE components. The axis, label and units information pertaining to the Stokes parameters is that in the main structure.

All the data arrays used in TSP are simple or primitive arrays. Other types of data arrays such as SCALED arrays, SPACED arrays etc. described in SGP/38 are not supported at present.

The TITLE, QUALITY and HISTORY components described in SGP/38 are not currently used by TSP. If present they will be propagated from input to output files.

TSP datasets may be one, two or three dimensional. A 1D dataset represents a polarization spectrum. The axis is a wavelength axis. As well as representing spectra the wavelength axis is also used to contain the wavelengths of a small number of broad band channels for data resulting from instruments such as the Hatfield Polarimeter.

2D datasets may be either time series polarization spectra, or polarization images. For time series polarization spectra the first axis is the wavelength axis, and the second axis is the time axis. The time is represented in the form of the Modified Julian Date (MJD = JD - 2400000.5) in a double precision array. Note that special cases of the time series dataset are those with a wavelength axis of size 1, and with no additional Stokes parameters. Thus simple time series photometry can be represented in this way.

3D datasets represent time series imaging (or imaging polarimetry) data.