# pyswisseph

**Repository Path**: astrochaos2812/pyswisseph

## Basic Information

- **Project Name**: pyswisseph
- **Description**: Pyswisseph是基于NASA/JPL的DE431星历表而产生的 “瑞士星历表” ，可以计算太阳系天体的位置，时间跨度为13201 BC - 17191 AD，位置精度为0.001角秒。版权遵循GNU Affero General Public License (AGPL)。



- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-06-27
- **Last Updated**: 2022-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

==========
Pyswisseph
==========

This is the Python extension to the Swiss Ephemeris by AstroDienst.

The Swiss Ephemeris is the de-facto standard library for astrological
calculations. It is a high-precision ephemeris, based upon the DE431
ephemerides from NASA's JPL, and covering the time range 13201 BC to AD 17191.

Usage Example
=============

::

    >>> import swisseph as swe
    >>> # first set path to ephemeris files
    >>> swe.set_ephe_path('/usr/share/sweph/ephe')
    >>> # find time of next lunar eclipse
    >>> jd = swe.julday(2007, 3, 3) # julian day
    >>> res = swe.lun_eclipse_when(jd)
    >>> ecltime = swe.revjul(res[1][0])
    >>> print(ecltime)
    (2007, 3, 3, 23.347926892340183)
    >>> # get ecliptic position of asteroid 13681 "Monty Python"
    >>> jd = swe.julday(2008, 3, 21)
    >>> xx, rflags = swe.calc_ut(jd, swe.AST_OFFSET+13681)
    >>> # print longitude
    >>> print(xx[0])
    0.09843983166646618

Links
=====

:Pyswisseph docs:       https://astrorigin.com/pyswisseph
:Launchpad PPA:         https://launchpad.net/~astrorigin/+archive/ubuntu/python-swisseph
:Python Package Index:  https://pypi.org/project/pyswisseph
:AstroDienst:           https://www.astro.com/swisseph

Source code
===========

Clone the Github repository with command:

``git clone --recurse-submodules https://github.com/astrorigin/pyswisseph``

Licensing
=========

The Pyswisseph package adopts the GNU Affero General Public License version 3.
See the ``LICENSE.txt`` file.

The original swisseph library is distributed under a dual licensing system:
GNU Affero General Public License, or Swiss Ephemeris Professional License.
For more information, see file ``libswe/LICENSE``.

Test Suite
==========

For now, the tests can be run with the standard ``python3 setup.py test``
command. For them to pass successfully, you need a basic set of ephemerides
files installed somewhere on your system:

- ``seas_18.se1``
- ``sefstars.txt``
- ``semo_18.se1``
- ``sepl_18.se1``

All downloadable from https://www.astro.com/ftp/swisseph/ephe/

The path to the directory containing those files must be indicated in the
environment variable ``SE_EPHE_PATH``.

For example, on a system with the ``env`` command, you can do::

    env SE_EPHE_PATH="/usr/share/sweph/ephe" python3 setup.py test

Credits
=======

Author: Stanislas Marquis <stan(at)astrorigin.com>

PyPI maintainer (branch pypi): Jonathan de Jong <jonathan(at)automatia.nl>

..