Example Suite for the "WCS Transform Model", version 1.0:

The following examples are produced by the modeler using a home-grown python 
utility called 'voefg' (Virtual Observatory Example File Generator).

Example Suite Summary:
    <ext>   Flavor
    -----  -------------------------------------------------------------
     vot   VOTable-1.3 standard syntax
    avot   VOTable-1.3 annotated with VO-DML/Mapping syntax
     xml   XML - validates using test_coords_v1.0.xsd which adds serializable
                 elements to the base Coords model schema
     xxx   An internal DOC format
            XML/DOM structure representing the instances generated when 
            interpreting the template

  ================================================================================
To make the examples simple and easier to read, we will provide samples of each 
complex TOperation as an independent TAtomic mapping (outside of any sequencing),
and provide examples of the TCompound types using the simpler operation types.

  ================================================================================
Input Files:
  The following were downloaded from the example file set for the FITS-WCS papers.
     https://www.atnf.csiro.au/people/mcalabre/WCS/example_data.html
       1904-66_SIN.fits  << SIN projection
       1904-66_TAN.fits  << TAN projection
       orion-wave-1.fits << Spectral projection

  ================================================================================

  atomic_lookup1d.<ext>
    Description:
      1-Dimensional Numeric Lookup table mapping.
      The example is set to perform nearest neighbor interpolation, with no error
      for exceeding the data boundaries.  A 'fill' entry -999 is provides the
      return value for boundary violiation occurances.
 
    Includes: TAtomic, TForward, Lookup, NumericEntry

  atomic_lookup2d.<ext>
    Description:
      2-Dimensional Numeric Lookup table mapping.
      The example is set for No interpolation, and to error for exceeding the data
      boundaries.
 
    Includes: TAtomic, TForward, Lookup, NumericEntry2D

  atomic_lookupStr.<ext>
    Description:
      1-Dimensional Numeric-to-String Lookup table mapping.
      Interpolation and bounds_error flags are left unspecified.

      This particular example maps a numeric value to a Polarization State as
      defined in Table 8.9 of the FITS-3.0 standard.
 
    Includes: TAtomic, TForward, Lookup, StringEntry

  atomic_poly1d.<ext>
    Description:
      Third order 1-D polynomial.
      This example defines and assigns a separate polynomial for the 
      forward and inverse direction.

      Note: both polynomials are dummy examples

    Includes:  TAtomic, TForward, TInverse, Polynomial1D, PolyCoeff1D


  atomic_poly2d.<ext>
    Description:
      Second order 2-D polynomial.
      This example represents the 2-D to 1-D transition
        Y = Poly(R,C) = a + bC + cR + dC**2 + eRC + fR**2

    Includes:  TAtomic, TForward, Polynomial2D, PolyCoeff2D


  atomic_skyproj.<ext>
    Description:
      The Spherical Projection component of the FITS WCS paper II.
      Describes the mapping between the intermediate "Projection Plane" 
      and the "Native Spherical" coordinate systems.

      This example represents a Slant Orthographic projection where the
      latitude axis is #2 (eg: RA,DEC).  The projection angles are provided
      using ProjectionParam instances.

    Includes: TAtomic, TForward, SkyProjection, ProjectionParam


  atomic_skyprojrotate.<ext>
    Description:
      Extends SkyProjection to include the Spherical Rotation component 
      of the FITS WCS paper II.
      Describes the mapping between the "Native Spherical" and the 
      "Celestial" coordinate systems.

      This example represents a Gnomonic (TAN) projection.

    Includes: TAtomic, TForward, SkyProjRotate, ProjectionParam


  atomic_specproj.<ext>
    Description:
      Nonlinear 1-dimensional spectral transform as detailed in 
      the FITS WCS paper III.

    Includes: TAtomic, TForward, SpectralProjection, ProjectionParam


  atomic_matrix.<ext>
    Description:
      Matrix operation (2x2)

    Includes: TAtomic, TForward, Matrix, MatrixElement


  atomic_euler.<ext>
    Description:
      3-D rotation operation using Euler angles.

    Includes: TAtomic, TForward, Euler


  workflow_compound
    Description:
      Combines operations in sequence (TCompose) and parllel (TConcatenate).
      The example uses simple operations for brevity, but any operation or 
      sequence of operations can be used.

    Includes:  TCompose, TConcatenate, TAtomic, TForward,
               Shift, Scale, Rotate2D


  workflow_permute
    Description:
       Permute example from 2D (x,y) => 3D (x,z,y), where the z axis is 
       added with a seeded value.  The result is fed into a concatenation
       of operations to span the new 3D space.

    Includes: TCompose, TConcatenate, TAtomic, TForward,
              Permute, PermuteAxis, Rotate2D, Unit