File: api-position.rst

package info (click to toggle)
skyfield 1.53%2Bds-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 2,688 kB
  • sloc: python: 14,800; makefile: 278; sh: 41
file content (90 lines) | stat: -rw-r--r-- 2,339 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

========================================
 API Reference — Astronomical Positions
========================================

See `positions` for a detailed guide
to these various kinds of position that Skyfield can compute,
and to the selection of coordinate systems
that can be used to express them.

.. testsetup::

   from __future__ import print_function
   from skyfield.api import load
   from skyfield.positionlib import ICRF
   ts = load.timescale()
   de421 = load('de421.bsp')
   earth = de421['Earth']
   mars = de421['Mars']

.. currentmodule:: skyfield.positionlib

Generic ICRF position
=====================

.. autoclass:: ICRF
   :members:

   .. attribute:: t

      The `Time` coordinate of this position.

   .. attribute:: position

      A `Distance` object offering the position’s |xyz| coordinates.

   .. attribute:: velocity

      A `Velocity` object
      offering the velocity’s (\ *dx/dt,dy/dt,dz/dt*\ ) coordinates.

      This attribute will have the value ``None`` if no velocity was
      specified for this position.

Position measured from the Solar System barycenter
==================================================

.. autoclass:: Barycentric
   :members:

   This class inherits the methods of is parent class :class:`ICRF` as
   well as the orientation of its axes in space.

Astrometric position relative to an observer
============================================

.. autoclass:: Astrometric
   :members:

   This class inherits the methods of is parent class :class:`ICRF` as
   well as the orientation of its axes in space.

Apparent position relative to an observer
=========================================

.. autoclass:: Apparent
   :members:

   This class inherits the methods of is parent class :class:`ICRF` as
   well as the orientation of its axes in space.

Geocentric position relative to the Earth
=========================================

.. autoclass:: Geocentric
   :members:

   This class inherits the methods of is parent class :class:`ICRF` as
   well as the orientation of its axes in space.

Building a position from right ascension and declination
========================================================

.. autofunction:: position_of_radec

The position of the Solar System Barycenter
===========================================

.. autoclass:: SSB
   :members: