SOURCE
Keywords: pako

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

- SOURCE /CATALOG
- SOURCE /GREP
- SOURCE /VELOCITY
- SOURCE EXAMPLES