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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
Metadata-Version: 2.2
Name: ephem
Version: 4.2
Summary: Compute positions of the planets and stars
Home-page: http://rhodesmill.org/pyephem/
Author: Brandon Rhodes
Author-email: brandon@rhodesmill.org
License: MIT
Project-URL: Source, https://github.com/brandon-rhodes/pyephem
Classifier: Development Status :: 6 - Mature
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Description-Content-Type: text/x-rst
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: project-url
Dynamic: summary
==============
PyEphem README
==============
.. _ephem: http://pypi.python.org/pypi/ephem/
.. _pyephem: http://pypi.python.org/pypi/pyephem/
.. _XEphem: https://xephem.github.io/XEphem/Site/xephem
.. _Quick Reference: http://rhodesmill.org/pyephem/quick
.. _Tutorial: http://rhodesmill.org/pyephem/tutorial
.. _PyEphem web site: http://rhodesmill.org/pyephem/
PyEphem provides an ``ephem`` Python package
for performing high-precision astronomy computations.
The underlying numeric routines are coded in C
and are the same ones that drive the popular `XEphem`_ astronomy application,
whose author, Elwood Charles Downey,
generously gave permission for their use in PyEphem.
The name *ephem* is short for the word *ephemeris*,
which is the traditional term for a table
giving the position of a planet, asteroid, or comet for a series of dates.
The `PyEphem web site`_ offers documentation
and also links to the project bug tracker, user support forum,
and source code repository.
If you have a C compiler and the
`pip Python installer tool <https://pip.pypa.io/en/latest/installing.html>`_
on your system,
then installing PyEphem should be as easy as::
pip install ephem
There are also Windows installers in the downloads section below.
The design of PyEphem emphasizes convenience and ease of use.
Both celestial bodies and the observer's location on Earth
are represented by Python objects,
while dates and angles automatically print themselves
in standard astronomical formats::
>>> import ephem
>>> mars = ephem.Mars()
>>> mars.compute('2008/1/1')
>>> print(mars.ra)
5:59:27.35
>>> print(mars.dec)
26:56:27.4
The documentation includes both a `Quick Reference`_ and a `Tutorial`_,
which are included in text files within the module itself
as well as being available on the `PyEphem web site`_.
The features provided by PyEphem include:
* Find where a planet, comet, or asteroid is in the sky.
* High-precision orbital routines are provdied
for the Moon, Sun, planets, and the major planet moons.
* The user can supply the orbital elements of a comet, asteroid,
or Earth-orbiting satellite, and have its location computed.
* The positions of 94 bright stars come built-in,
and the user can create further fixed objects as needed
for their calculations.
* Determine where in the sky an object appears for a particular observer.
* The user can supply the longitude, latitude, and altitude
of the location from which they will be observing.
* For convenience, a small database of longitudes and latitudes
for 122 world cities is included.
* For specified weather conditions (temperature and pressure),
PyEphem will compensate for atmospheric refraction
by adjusting the positions of bodies near the horizon.
* Compute when a body will rise, transit overhead, and set
from a particular location.
* Parse and use orbital data in either the traditional XEphem file format,
or the standard TLE format used for tracking Earth-orbiting satellites.
* Determine the dates of the equinoxes and solstices.
* Compute the dates of the various phases of the Moon.
* Convert from the Greenwich Time (more precisely, Ephemeris Time)
which PyEphem uses to the local time of the user.
* Convert positions between the equatorial, ecliptic, and galactic
coordinate systems.
* Determine on which page of the Uranometria or the Millennium Star Atlas
a particular star should appear.
* Return the Julian Date corresponding to any calendar date.
Developers
----------
If you are interested in learning about how PyEphem works or in
exploring its source code, check out this repository from GitHub. It is
hosted at:
https://github.com/brandon-rhodes/pyephem
If you lack expertise with version control, you can instead simply
download a static copy of the most recent source code using this link:
https://github.com/brandon-rhodes/pyephem/archive/master.zip
To run its source code in place, create a `virtual environment
<http://docs.python-guide.org/en/latest/dev/virtualenvs/>`_, activate
it, change directory to the root of the PyEphem source code, and run::
python setup.py build_ext -i
You can then run the PyEphem test suite to see whether all of its
features are working correctly on your operating system and platform::
python -m unittest discover ephem
PyEphem’s documentation is organized as a standard `Sphinx
<http://www.sphinx-doc.org/en/master/>`_ document project. You can
build the documentation either with the Sphinx command line::
sphinx-build -b html pyephem/ephem/doc/ ./my_documentation_directory/
— or, more typically, by invoking one of the targets in the
documentation’s Makefile::
make -C ephem/doc html
|
