Package adql.db

Class STCS.CoordSys

java.lang.Object
adql.db.STCS.CoordSys
Enclosing class:
STCS
public static class STCS.CoordSys extends Object

Object representation of an STC coordinate system.

A coordinate system is composed of three parts: a frame (frame), a reference position (refpos) and a flavor (flavor).

The default value - also corresponding to an empty string - should be: STCS.Frame.UNKNOWNFRAME STCS.RefPos.UNKNOWNREFPOS STCS.Flavor.SPHERICAL2. Once built, it is possible to know whether the coordinate system is the default one or not thanks to function isDefault().

An instance of this class can be easily serialized into STC-S using toSTCS(), toFullSTCS() or toString(). toFullSTCS() will display default values explicitly on the contrary to toSTCS() which will replace them by empty strings.

Important note: The flavors CARTESIAN2 and CARTESIAN3 can not be used with other frame and reference position than UNKNOWNFRAME and UNKNOWNREFPOS. In the contrary case an IllegalArgumentException is throw.

Since:
1.3
Version:
1.3 (10/2014)
Author:
Grégory Mantelet (ARI)

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    final STCS.Flavor
    flavor
    Third and last item of a coordinate system expression: the flavor.
    final STCS.Frame
    frame
    First item of a coordinate system expression: the frame.
    final STCS.RefPos
    refpos
    Second item of a coordinate system expression: the reference position.

  • Constructor Summary

    Constructors
    Constructor
    Description
    CoordSys()
    Build a default coordinate system (UNKNOWNFRAME UNKNOWNREFPOS SPHERICAL2).
    CoordSys(STCS.Frame fr, STCS.RefPos rp, STCS.Flavor fl)
    Build a coordinate system with the given parts.
    CoordSys(String coordsys)
    Build a coordinate system by parsing the given STC-S expression.

  • Method Summary

    Modifier and Type
    Method
    Description
    final boolean
    isDefault()
    Tell whether this is the default coordinate system (UNKNOWNFRAME UNKNOWNREFPOS SPHERICAL2).
    String
    toFullSTCS()
    Get the STC-S expression of this coordinate system, in which default values are explicitly written.
    String
    toSTCS()
    Get the STC-S expression of this coordinate system, in which default values are not written (they are replaced by empty strings).
    String
    toString()
    Convert this coordinate system into a STC-S expression.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Field Details

    • frame

      public final STCS.Frame frame
      First item of a coordinate system expression: the frame.

    • refpos

      public final STCS.RefPos refpos
      Second item of a coordinate system expression: the reference position.

    • flavor

      public final STCS.Flavor flavor
      Third and last item of a coordinate system expression: the flavor.

  • Constructor Details

    • CoordSys

      public CoordSys()
      Build a default coordinate system (UNKNOWNFRAME UNKNOWNREFPOS SPHERICAL2).

    • CoordSys

      public CoordSys(STCS.Frame fr, STCS.RefPos rp, STCS.Flavor fl) throws IllegalArgumentException
      Build a coordinate system with the given parts.
      Parameters:
      fr - Frame part.
      rp - Reference position part.
      fl - Flavor part.
      Throws:
      IllegalArgumentException - If a cartesian flavor is used with a frame and reference position other than UNKNOWNFRAME and UNKNOWNREFPOS.

    • CoordSys

      public CoordSys(String coordsys) throws ParseException
      Build a coordinate system by parsing the given STC-S expression.
      Parameters:
      coordsys - STC-S expression representing a coordinate system. Empty string and NULL are allowed values ; they correspond to a default coordinate system.
      Throws:
      ParseException - If the syntax of the given STC-S expression is wrong or if it is not a coordinate system only.

  • Method Details

    • isDefault

      public final boolean isDefault()
      Tell whether this is the default coordinate system (UNKNOWNFRAME UNKNOWNREFPOS SPHERICAL2).
      Returns:
      true if it is the default coordinate system, false otherwise.

    • toSTCS

      public String toSTCS()
      Get the STC-S expression of this coordinate system, in which default values are not written (they are replaced by empty strings).
      Returns:
      STC-S representation of this coordinate system.

    • toFullSTCS

      public String toFullSTCS()
      Get the STC-S expression of this coordinate system, in which default values are explicitly written.
      Returns:
      STC-S representation of this coordinate system.

    • toString

      public String toString()
      Convert this coordinate system into a STC-S expression.
      Overrides:
      toString in class Object
      See Also: