readme.md created 5-oct-2017 by Alois Treindl
last update 20 September 2023
Swiss Ephemeris (SE) is a software toolbox for programmers of astrological software. It is of little use for a non-programmer
Swiss Ephemeris was developed by Dieter Koch and Alois Treindl, while both were employed by Astrodienst AG in Zollikon/Zürich Switzerland.
Most astrological programmers all over the world use Swiss Ephemeris in their software.
SE ist built according to the highest standards of precision available in astronomical data, with raw data from Nasa's JPL. It is able to reproduce the ephemeris data in astronomical standard books up to the last printed digit.
Detailed information is available at https://www.astro.com/swisseph or in the documentation files included here (folder doc).
In the public Swiss Ephemeris github repository folder ephe https://github.com/aloistr/swisseph/tree/master/ephe
or from Alois' public Dropbox area in folder 'ephe' with this link
https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0
In the public Swiss Ephemeris Github repository https://github.com/aloistr/swisseph
in the public Swiss Ephemeris Github repository folder doc https://github.com/aloistr/swisseph/tree/master/doc
in the public Swiss Ephemeris github repository folder windows https://github.com/aloistr/swisseph containing
sweph.zip
The complete Swiss Ephemeris package for Windows (32bit),
except the ephemeris data files.
See online documentation at https://www.astro.com/swisseph
or in the doc directory for more details.
Small sample programs and build-projects are included for
- Visual C++ .net 2003
- Visual Basic 5.0
- Delphi 32-bit
Note: Visual Basic files may not have been updated and
tested, as we currently do not possess a working copy of VB at Astrodienst.
swephzip.txt
overview of content of the sweph.zip package
folder vb:
declarations for 32-bit and 64-bit Visual Basic
folder programs:
A directory containing sample and utility programs for Windows:
swetest.exe:
executable Swiss Ephemeris program.
This is a 32-bit Console mode application.
To get information about the many features of this program, run
swetest -? > out.txt
and print the file out.txt, or view it with your text editor.
This is just a sample to demonstrate the precision of the
ephemeris, and to show the typical use of a few calls.
now directly from jpl, see https://www.astro.com/ftp/swisseph/jplfiles/index.htm
or from Alois' public Dropbox area in folder 'jpl binary files' with this link
https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0
md5-keys
1ef6191b614b2b854adae8675b1b981f de200.eph
1ef768440cc1617b6c8ad27a9a788135 de406e.eph
fad0f432ae18c330f9e14915fbf8960a de431.eph
a7b2a5b8b2ebed52ea4da2304958053b de441.eph
Each file covers 600 years, from 1500 - 2099. They are organized in folders of 1000 files each, available in Alois' public Dropbox area in folder 'all_ast' with this link:
https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0
The total volume was 29 Gb in September 2023.
Each file covers the long range of 6000 years, from 3000 BCE to 2999 CE. available in Alois' public Dropbox area in folder 'long_ast' with this link
https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0
The total volume was 11 Gb in September 2023.
Swissephe code uses an internal swed.ephepath for the directory names where it looks for its data files.
It defaults to \sweph\ephe on Windows and to ".:/users/ephe2/:/users/ephe/" on Linux or other Unix-like systems like Android or Mac OS-X.
The characters ; in Windows and ; or : in Linux serve as path separators. In the default setting on Linux, the three directories . , /users/ephe and /users/ephe2 are searched when Swiss Ephemeris looks for a file.
The programmer can call the function swe_set_ephe_path() to set the ephepath variable, and may include path separators.
The user of a program can also set an evironment variable which override the builtin default.
The compressed planetary ephemeris files like sepl*.se1, sem*.se1 and seas*.se1 must be directly in one of the path elements.
Asteroid files must be in subdirectories named astN like ast0, ast1, ... ast623, where N is the asteroid number divided by 1000.
The folders all_ast and long_ast are only used inside the Dropbox area to organize the files. Once downloaded, the astN directory must be placed directly in one of the elements of ephepath. Short asteroid files and long asteroid filese differ by an s in the file name, like se1001.ses and se1001s.se1. They can be merged into the same astN directory, in this case ast1. Astrodienst keeps them traditionally separate in /ephe and /ephe2, but that distinction is not technically necessary.
folder contrib: It contains open source code and applications using the Swiss Ephemeris. See the readme file in directory contrib for more details.
The SWISS EPHEMERIS can be licensed by programmers to include this calculation engine in their software. More information is found at https://www.astro.com/swisseph/
Depending on your application the free edition under the Public License may apply, or you may have to acquire a professional license for a fee.
Read LICENSE.TXT
We maintain a mailing list which servers for discussion between developers and as the main support channel. All Swiss Ephemeris support is public. There is no private support by email.
If you want to have your name added to this mailing list, please visit https://groups.io/g/swisseph
We welcome any suggestions and comments you may have about the Swiss Ephemeris. Please email to swisseph@groups.io
If you want your feedback distributed to all members of the swisseph mailing list, please subscribe to https://groups.io/g/swisseph
Thomas Mack has ported the Swiss Ephemeris library to Java.
His work can be found at: http://www.th-mack.de/international/download/
If you use it for commercial or for non-open-source purposes, please be aware that AGPL Public License of Swiss Ephemeris also applies for the Java version, besides any additional requirements which may be defined by Thomas Mack.
found on Github https://github.com/cyjoelchen/php-sweph
found on Github https://github.com/aloistr/perl-sweph
the numerical integrator to prepare swisss ephemeris files is not in a state fit for publication.