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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
Metadata-Version: 1.1
Name: PyMeeus
Version: 0.4.3
Summary: Python implementation of Jean Meeus astronomical routines
Home-page: https://github.com/architest/pymeeus
Author: Dagoberto Salazar
Author-email: dagoberto.salazar@gmail.com
License: LGPLv3
Download-URL: https://github.com/architest/pymeeus
Description: PyMeeus
=======
**Library of astronomical algorithms in Python**.
PyMeeus is a Python implementation of the astronomical algorithms
described in the classical book 'Astronomical Algorithms, 2nd Edition,
Willmann-Bell Inc. (1998)' by Jean Meeus.
There are great astronomical libraries out there. For instance, if
you're looking for high precision and speed you should take a look at
`libnova <http://libnova.sourceforge.net/>`__. For a set of python
modules aimed at professional astronomers, you should look at
`Astropy <http://www.astropy.org/>`__. On the other hand, the advantages
of PyMeeus are its simplicity, ease of use, ease of reading, ease of
installation (it has the minimum amount of dependencies) and abundant
documentation.
Installation
------------
The easiest way of installing PyMeeus is using pip:
.. code:: sh
pip install pymeeus
Or, for a per-user installation:
.. code:: sh
pip install --user pymeeus
If you prefer Python3, you can use:
.. code:: sh
pip3 install --user pymeeus
Meta
----
Author: Dagoberto Salazar
Distributed under the GNU Lesser General Public License v3 (LGPLv3). See
``LICENSE.txt`` and ``COPYING.LESSER`` for more information.
Documentation: https://pymeeus.readthedocs.io/en/latest/
GitHub: https://github.com/architest/pymeeus
If you have Sphinx installed, you can generate your own, latest
documentation going to directory 'docs' and issuing:
.. code:: sh
make html
Then the HTML documentation pages can be found in 'build/html'.
Contributing
------------
The preferred method to contribute is through forking and pull requests:
1. Fork it (https://github.com/architest/pymeeus/fork)
2. Create your feature branch (``git checkout -b feature/fooBar``)
3. Commit your changes (``git commit -am 'Add some fooBar'``)
4. Push to the branch (``git push origin feature/fooBar``)
5. Create a new Pull Request
Please bear in mind that PyMeeus follows the PEP8 style guide for Python
code `(PEP8) <https://www.python.org/dev/peps/pep-0008/?>`__. We suggest
you install and use a linter like
`Flake8 <http://flake8.pycqa.org/en/latest/>`__ before contributing.
Additionally, PyMeeus makes heavy use of automatic tests. As a general
rule, every function or method added must have a corresponding test in
the proper place in ``tests`` directory.
Finally, documentation is also a big thing here. Add proper and abundant
documentation to your new code. This also includes in-line comments!!!.
Contributors
------------
- `Neil Freeman <https://github.com/fitnr>`__ - Fixed undefined
variable in Epoch.tt2ut
- `molsen234 <https://github.com/molsen234>`__ - Fixed bug when using
fractional seconds, minutes, hours or days
- `Sebastian Veigl <https://github.com/sebastian1306>`__ - Added
functionality for Jupiter's moons
- Sophie Scholz - Added functionality for Jupiter's moons
- Vittorio Serra - Added functionality for Jupiter's moons
- Michael Lutz - Added functionality for Jupiter's moons
- `Ben Dilday <https://github.com/bdilday>`__ - Added ``__hash__()``
method to class Epoch
What's new
----------
- 0.4.3
- Added method ``ring_parameters()`` to Saturn class.
- 0.4.2
- Added method ``__hash__()`` to Epoch. Now Epoch objects can be
used as keys in a dictionary.
- 0.4.1
- Added funtionality to compute the positions of Jupiter's Galilean
moons
- 0.4.0
- Added methods to compute Saturn's ring inclination and longitude
of ascending node
- 0.3.13
- Additional encoding changes
- 0.3.12
- Deleted ``encoding`` keyword from setup.py, which was giving
problems
- 0.3.11
- Added encoding specification to setup.py
- 0.3.10
- Fixed characters with the wrong encoding
- 0.3.9
- Relaxed requirements, added contributor molsen234, and fixed
format problems showed by flake8
- 0.3.8
- Fixed undefined variable in ``Epoch.tt2ut``
- 0.3.7
- Fix bug when using fractional seconds, minutes, hours or days,
plus documentation improvements
- 0.3.6
- Add method to compute rising and setting times of the Sun
- 0.3.5
- Add method ``magnitude()`` to planet classes
- 0.3.4
- Add method to compute the parallax correction to Earth class
- 0.3.3
- Add methods to compute the passage through the nodes
- 0.3.2
- Add methods to compute the perihelion and aphelion of all planets
- 0.3.1
- Fix errors in the elongation computation, add tests and examples
of use of methods ``geocentric_position()``, and tests and
examples for ``Pluto`` class
- 0.3.0
- Added ``Pluto`` class
Keywords: Meeus astronomy module library
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering :: Astronomy
|
