next up previous contents index
Next: SOURCE /CATALOG Up: PAKO Language Internal Help Previous: SHOW   Contents   Index


SOURCE

    SOURCE sourceName
           [[systemName epoch] lambda beta
              [referenceFrame velocity     ] ]
    SOURCE Body sourceName
                perihelionEpoch ascendingNode      argumentOfPerihelion
                inclination     perihelionDistance eccentricity

    Select a source from the source catalog or specify source parameters
    directly on command the line.

    Character*12  :: sourceName            ! don't use: & < > ( ) /
    Character     :: systemName            !
    [C]Real       :: epoch                 ! in units [years]
                                           ! NOTE: epoch should be J2000.0
    Coordinate    :: lambda                ! longitude
    Coordinate    :: beta                  ! latitude
    Character     :: referenceFrame        ! reference system for velocity
    Real          :: velocity              ! in units [km/s]

    IMPORTANT NOTES:

    sourceName is limited to 12 characters.

    So far only Equatorial J2000.0 coordinates are well tested.
    <<TBD:
    Observations of the Sun and near the Sun are not yet supported.
    >>


    NB: Don't use / & < > in names of sources, lines, projects,
    PI, observer, operator, etc. Don't use ()/ in source names.

    IMPORTANT NOTE ON VELOCITY:

    One should not use very large Doppler velocities (thousands  of  kilome-
    ters)  to  achieve  red-shift  corrections  of  frequencies. Instead one
    should enter the red-shifted frequencies in the line  catalog  (or  with
    the RECEIVER command) and use Doppler velocity of 0.0.

    The alternative approach (with very large Doppler velocities) needs spe-
    cial methods and attention in the data processing, which are "*not*  im-
    plemented  in  CLASS  because it is better to observe in such a way that
    minimum modification to the data is done later on"  (J.  Pety).   For  a
    full  discussion of this question see: Gordon et al. 1992, A&A, 264, 337
    in Sect. 6



    The second form accepts 6 Real arguments to specify the orbital
    elements of a solar system body:
    Body                                ! special keyword -- exactly like this!
    Real       :: perihelionEpoch       ! Julian Date [d]
    Real       :: ascendingNode         ! [deg]
    Real       :: argumentOfPerihelion  ! [deg]
    Real       :: inclination           ! [deg]
    Real       :: perihelionDistance    ! [deg]
    Real       :: eccentricity          !

    If only sourceName is specified, we try to read the other parameters
    from the source catalog specified with CATALOG SOURCE fileName. The
    sourceName in the command must match a source name in the source
    catalog with all characters (no minimum match), but the case is
    ignored for the matching. Example: SOURCE w3oh matches W3OH in the
    source catalog, but SOURCE w3o does not!

    The option: /VELOCITY systemVelocity velocity overrides the values in
    the catalog.

    Epoch can optionally start with a 1-character code "J" or "B" to
    distinguish between "J" and "B" epochs/ equatorial coordinates.  (If
    this code letter is not present, "J" is implied!).

    The coordinates are specified in astronomical sexagesimal format:
    with : as field separator, i.e.:

     hh:mm:ss.ss
    ddd:'':"".""

    Examples:
     12:34:56.78 for  12 hours,   34 minutes,     56.78 seconds
    123:45:67.89 for 123 degrees, 45 arc minutes, 67.89 arc seconds

    For systemName: equatorial and haDec, the longitude, lambda, is
    assumed to be in hours; for all other systems it is assumed to be in
    degrees.  Latitude, beta, is always in degrees.

    Choices for systemName:
    "equatorial"
    "horizontal"

    <<TBD: not yet supported:   >>
    <<TBD: "galactic"           >>
    <<TBD: "apparentEquatorial" >>
    <<TBD: "ecliptic"           >>
    <<TBD: "apparentEcliptic"   >>
    <<TBD: "haDec "             >>

    Choices for referenceFrame:
    "LSR"
    "barycentric"
    "heliocentric"

    <<TBD: not yet supported:    >>
    <<TBD: "3K"                  >>
    <<TBD: "galactocentric"      >>
    <<TBD: "body"                >>
    <<TBD: "geocentric"          >>
    <<TBD: "topocentric"         >>
    <<TBD: "null"                >>

    Planets' names are accepted as a special case, if sourceName is one of:
    "Mercury"
    "Venus"
    "Mars"
    "Jupiter"
    "Saturn"
    "Uranus"
    "Neptune"
    "Pluto"

    Satellites' (moons') names are accepted, if sourceName is one of:
    "Phobos"
    "Deimos"
    "Io"
    "Europa"
    "Ganymede"
    "Callisto"
    "Mimas"
    "Enceladus"
    "Tethys"
    "Dione"
    "Rhea"
    "Titan"
    "Hyperion"
    "Iapetus"
    "Miranda"
    "Ariel"
    "Umbriel"
    "Titania"
    "Oberon"
    "Gabriel"
    "Moon"


Subsections

Gildas manager 2023-06-01