Metadata-Version: 2.1
Name: histastro
Version: 0.0.2
Summary: A Python package for historical-astronomy calculations of Sun, Moon and planets
Home-page: https://github.com/MarcvdSluys/HistAstro
Author: Marc van der Sluys
License: GPLv3+
Keywords: astronomy,history,ephemeris,sun,moon,planets
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Sociology :: History
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: fortranformat

# HistAstro #

A Python package for historical-astronomy calculations of Sun, Moon and planets.


## Installation ##

This package can be installed using `pip install histastro`.  This should automatically install the
dependency packages `numpy` and `fortranformat` if they haven't been installed already.  If you are installing
by hand, you have to ensure these packages are installed as well.


### Data files ###

You will need to manually download the eight data files `VSOP87D.xxx` from
[ftp://ftp.imcce.fr/pub/ephem/planets/vsop87/](ftp://ftp.imcce.fr/pub/ephem/planets/vsop87/), one for each of
the planets, and save them in a directory of your choice (e.g. the subdirectory `data/` of your working
directory).  To compute the Moon position, the file `moonposMeeus.csv` is needed, which can be downloaded from
this page: http://astro.ru.nl/~sluys/HistAstro/


## HistAstro pages ##

* [Radboud University](http://astro.ru.nl/~sluys/HistAstro/): data files
* [Pypi](https://pypi.org/project/histastro/): Python package
* [GitHub](https://github.com/MarcvdSluys/HistAstro): source code


## Author and licence ##

* Author: Marc van der Sluys
* Contact: http://astro.ru.nl/~sluys/
* Website: [Github](https://github.com/MarcvdSluys/HistAstro), [PyPI](https://pypi.org/project/histastro/)
* Licence: [GPLv3+](https://www.gnu.org/licenses/gpl.html)


## References ##

* Meeus, [Astronomical algorithms](https://www.willbell.com/math/MC1.HTM), 2nd Ed.
* VSOP87 planet theory: [Bretagnon & Francou, 1988A+A...202..309B](https://ui.adsabs.harvard.edu/abs/1988A%26A...202..309B/)
* [VSOP87 data files](ftp://ftp.imcce.fr/pub/ephem/planets/vsop87/) &mdash; in case [FTP urls don't work in Markdown](https://github.com/gollum/gollum/issues/759): ftp://ftp.imcce.fr/pub/ephem/planets/vsop87/
* This Python code is adapted from the Fortran implementation in [libTheSky](http://libthesky.sourceforge.net/)


