astro py:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- Astropy v5.2.1 »
- Astronomical Coordinate Systems (`astropy.coordinates`) »
- get_moon

# get_moon

astropy.coordinates.get_moon(time, location=None, ephemeris=None)

  Get a `SkyCoord` for the Earth’s Moon as observed from a location on Earth in the `GCRS` reference system.

  Parameters:
    time `Time`

      Time of observation

    location `EarthLocation`

      Location of observer on the Earth. If none is supplied, taken from `time` (if not present, a geocentric observer will be assumed).

    ephemeris `python:str`, optional

      Ephemeris to use. If not given, use the one set with `astropy.coordinates.solar_system_ephemeris.set` (which is set to ‘builtin’ by default).

  Returns:
    skycoord `SkyCoord`

      GCRS Coordinate for the Moon

  Notes

  The coordinate returned is the apparent position, which is the position of the moon at time t minus the light travel time from the moon to the observing location.

  You can either give an explicit ephemeris or use a default, which is normally a built-in ephemeris that does not require ephemeris files. To change the default to be the JPL ephemeris:

      >>> from astropy.coordinates import solar_system_ephemeris
      >>> solar_system_ephemeris.set('jpl')

  Use of any JPL ephemeris requires the jplephem package (https://pypi.org/project/jplephem/). If needed, the ephemeris file will be downloaded (and cached).

  One can check which bodies are covered by a given ephemeris using:

      >>> solar_system_ephemeris.bodies
      ('earth', 'sun', 'moon', 'mercury', 'venus', 'earth-moon-barycenter', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune')