Skip to main content

Retrieve, represent and manipulate JPL Horizons ephemerides.

Project description


The eph package provides some useful functions, classes and tools to retrieve, parse and manipulate ephemerides in an astropy-compatible way.

See eph-howto (jupyter notebook) for more info.

Basic Usage

import eph

req = eph.JplReq() # create the request'eph.ini', section='jplparams') # read parameters from 'jplparams' section in 'eph.ini'
    'COMMAND': 'venus',
    'START_TIME': '2007-11-17',
    'STOP_TIME': '2017-4-22'
    'STEP_SIZE': '10d'
    }) # set parameters from dictionary
req['OBJ_DATA'] = False # set parameter dict-like
req.csv = True # set parameter as attributes
) # set position vectors output

res = req.query() # perform the request obtaining a response from Jpl Horizons service
e = res.parse() # parse the ephemeris in an astropy QTable

from import ascii

ascii.write(e, format='csv') # write output data

The content of eph.ini can be something like this (see for a complete description of JPL parameters)



eph package defines also some useful shortcut functions to easily access Jpl Horizons data. Instead of building a JplReq and get back a JplRes to parse, you can get an astropy QTable with

from eph import *
from datetime import datetime

e = get('venus', dates=['2000-1-1',])

Shortcut functions accept also one-date queries (non-interval) and multiple target objects. Behind the scenes eph makes multiple calls to JPL Horizons system and merge the results in one table. In this case non-key (used to join) columns are renamed with a prefix referring to the object (e.g. column X for object venus becomes venus_X). Meta info are listified and collapsed in a single value only if they take the same value for all objects.

from eph import *

e = get(['venus', 'mars'], dates='2017-04-22')

Dates has as default value so it can be omitted if you want present data.

from eph import *

e = get(['venus', 'mars'], table_type='V', vec_table=1) # present vector positional data for Venus and Mars

There are other shortcut functions like vec, pos, vel, elem, obs, radec, altaz, etc.. to simplify parameter settings.

For example, if you want vectors, type

e = vec('venus', dates=['2018-1-1', '2020-1-1']).

Command line tool

eph package also provides a command line tool:

$ eph venus --dates 2007-11-07 2017-04-22

This command gives you an ephemeris table of Venus starting from 2007-11-17 to 2017-4-22. You can also change the reference frame, the time-step size, the output etc.. through the options provided or setting up a config file. Check available options typing

$ eph --help

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for eph, version 1.1.4
Filename, size & hash File type Python version Upload date
eph-1.1.4-py3-none-any.whl (69.7 kB) View hashes Wheel py3
eph-1.1.4.tar.gz (62.5 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page