Metadata-Version: 2.4
Name: histastro
Version: 0.0.8
Summary: A Python package for historical-astronomy calculations of Sun, Moon and planets
Author-email: Marc van der Sluys <git@vandersluys.nl>
License-Expression: GPL-3.0-or-later
Project-URL: GitHub, https://github.com/MarcvdSluys/HistAstro
Project-URL: ReadTheDocs, https://histastro.readthedocs.io
Project-URL: Homepage, https://astro.ru.nl/~sluys/HistAstro
Keywords: astronomy,history,ephemeris,sun,moon,planets
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
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
License-File: LICENCE
Requires-Dist: fortranformat
Requires-Dist: numpy
Dynamic: license-file

# 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`](http://cdsarc.u-strasbg.fr/viz-bin/Cat?cat=VI/81) (click on FTP), 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/): HistAstro homepage: data files and code documentation
* [Pypi](https://pypi.org/project/histastro/): HistAstro Python package
* [GitHub](https://github.com/MarcvdSluys/HistAstro): HistAstro source code


## Author and licence ##

* Author: Marc van der Sluys
* Contact: http://astro.ru.nl/~sluys/
* 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](http://cdsarc.u-strasbg.fr/viz-bin/Cat?cat=VI/81)
* This Python code is adapted from the Fortran implementation in [libTheSky](http://libthesky.sourceforge.net/)
* [Celestial mechanics in a nutshell (CMiaNS)](https://cmians.sourceforge.io/)
