HorizonsClass

class astroquery.jplhorizons.HorizonsClass(id=None, location=None, epochs=None, id_type='smallbody')[source]

Bases: astroquery.query.BaseQuery

A class for querying the JPL Horizons service.

Instantiate JPL query.

Parameters:
id : str, required

Name, number, or designation of the object to be queried

location : str or dict, optional

Observer’s location for ephemerides queries or center body name for orbital element or vector queries. Uses the same codes as JPL Horizons. If no location is provided, Earth’s center is used for ephemerides queries and the Sun’s center for elements and vectors queries. Arbitrary topocentic coordinates for ephemerides queries can be provided in the format of a dictionary. The dictionary has to be of the form {'lon': longitude in deg (East positive, West negative), 'lat': latitude in deg (North positive, South negative), 'elevation': elevation in km above the reference ellipsoid, ['body': Horizons body ID of the central body; optional; if this value is not provided it is assumed that this location is on Earth]}.

epochs : scalar, list-like, or dictionary, optional

Either a list of epochs in JD or MJD format or a dictionary defining a range of times and dates; the range dictionary has to be of the form {'start':’YYYY-MM-DD [HH:MM:SS]’, 'stop':’YYYY-MM-DD [HH:MM:SS]’, 'step':’n[y|d|m|s]’}. If no epochs are provided, the current time is used.

id_type : str, optional

Identifier type, options: 'smallbody', 'majorbody' (planets but also anything that is not a small body), 'designation', 'name', 'asteroid_name', 'comet_name', 'id' (Horizons id number), or 'smallbody' (find the closest match under any id_type), default: 'smallbody'

Examples

>>> from astroquery.jplhorizons import Horizons
>>> eros = Horizons(id='433', location='568',
...              epochs={'start':'2017-01-01',
...                      'stop':'2017-02-01',
...                      'step':'1d'})
>>> print(eros) # doctest: +SKIP
JPLHorizons instance "433"; location=568, epochs={'start': '2017-01-01', 'step': '1d', 'stop': '2017-02-01'}, id_type=smallbody

Attributes Summary

TIMEOUT

Methods Summary

elements(*args, **kwargs) Queries the service and returns a table object.
elements_async([get_query_payload, …]) Query JPL Horizons for osculating orbital elements.
ephemerides(*args, **kwargs) Queries the service and returns a table object.
ephemerides_async([airmass_lessthan, …]) Query JPL Horizons for ephemerides.
vectors(*args, **kwargs) Queries the service and returns a table object.
vectors_async([get_query_payload, …]) Query JPL Horizons for state vectors.

Attributes Documentation

TIMEOUT = 30

Methods Documentation

elements(*args, **kwargs)

Queries the service and returns a table object.

Query JPL Horizons for osculating orbital elements. The location parameter in HorizonsClass refers in this case to the center body relative to which the elements are provided.

The following table lists the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime_str epoch Date (str, Calendar Date (TDB))
datetime_jd epoch Julian Date (float, JDTDB)
e eccentricity (float, EC)
q periapsis distance (float, au, QR)
a semi-major axis (float, au, A)
incl inclination (float, deg, IN)
Omega longitude of Asc. Node (float, deg, OM)
w argument of the perifocus (float, deg, W)
Tp_jd time of periapsis (float, Julian Date, Tp)
n mean motion (float, deg/d, N)
M mean anomaly (float, deg, MA)
nu true anomaly (float, deg, TA)
period orbital period (float, (Earth) d, PR)
Q apoapsis distance (float, au, AD)
Parameters:
refsystem : string

Element reference system for geometric and astrometric quantities: 'J2000' or 'B1950'; default: 'J2000'

refplane : string

Reference plane for all output quantities: 'ecliptic' (ecliptic and mean equinox of reference epoch), 'earth' (Earth mean equator and equinox of reference epoch), or 'body' (body mean equator and node of date); default: 'ecliptic'

tp_type : string

Representation for time-of-perihelion passage: 'absolute' or 'relative' (to epoch); default: 'absolute'

closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response: boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
table : A Table object.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='433', location='500@10',
...                epochs=2458133.33546)
>>> el = obj.elements() # doctest: +SKIP
>>> print(el) # doctest: +SKIP
    targetname      datetime_jd  ...       Q            P
       ---               d       ...       AU           d
------------------ ------------- ... ------------- ------------
433 Eros (1898 DQ) 2458133.33546 ... 1.78244263804 642.93873484
elements_async(get_query_payload=False, refsystem='J2000', refplane='ecliptic', tp_type='absolute', closest_apparition=False, no_fragments=False, get_raw_response=False, cache=True)[source]

Query JPL Horizons for osculating orbital elements. The location parameter in HorizonsClass refers in this case to the center body relative to which the elements are provided.

The following table lists the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime_str epoch Date (str, Calendar Date (TDB))
datetime_jd epoch Julian Date (float, JDTDB)
e eccentricity (float, EC)
q periapsis distance (float, au, QR)
a semi-major axis (float, au, A)
incl inclination (float, deg, IN)
Omega longitude of Asc. Node (float, deg, OM)
w argument of the perifocus (float, deg, W)
Tp_jd time of periapsis (float, Julian Date, Tp)
n mean motion (float, deg/d, N)
M mean anomaly (float, deg, MA)
nu true anomaly (float, deg, TA)
period orbital period (float, (Earth) d, PR)
Q apoapsis distance (float, au, AD)
Parameters:
refsystem : string

Element reference system for geometric and astrometric quantities: 'J2000' or 'B1950'; default: 'J2000'

refplane : string

Reference plane for all output quantities: 'ecliptic' (ecliptic and mean equinox of reference epoch), 'earth' (Earth mean equator and equinox of reference epoch), or 'body' (body mean equator and node of date); default: 'ecliptic'

tp_type : string

Representation for time-of-perihelion passage: 'absolute' or 'relative' (to epoch); default: 'absolute'

closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response: boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
response : requests.Response

The response of the HTTP request.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='433', location='500@10',
...                epochs=2458133.33546)
>>> el = obj.elements() # doctest: +SKIP
>>> print(el) # doctest: +SKIP
    targetname      datetime_jd  ...       Q            P
       ---               d       ...       AU           d
------------------ ------------- ... ------------- ------------
433 Eros (1898 DQ) 2458133.33546 ... 1.78244263804 642.93873484
ephemerides(*args, **kwargs)

Queries the service and returns a table object.

Query JPL Horizons for ephemerides. The location parameter in HorizonsClass refers in this case to the location of the observer.

The following tables list the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime epoch (str, Date__(UT)__HR:MN:SC.fff)
datetime_jd epoch Julian Date (float, Date_________JDUT)
solar_presence information on Sun’s presence (str)
flags information on Moon, target status (str)
RA target RA (float, deg, DEC_(XXX))
DEC target DEC (float, deg, DEC_(XXX))
RA_app target apparent RA (float, deg, R.A._(a-app))
DEC_app target apparent DEC (float, deg, DEC_(a-app))
RA_rate target rate RA (float, arcsec/hr, RA*cosD)
DEC_rate target RA (float, arcsec/hr, d(DEC)/dt)
AZ Azimuth (float, deg, EoN, Azi_(a-app))
EL Elevation (float, deg, Elev_(a-app))
AZ_rate Azimuth rate (float, arcsec/minute, dAZ*cosE)
EL_rate Elevation rate (float, arcsec/minute, d(ELV)/dt)
sat_X satellite X position (arcsec, X_(sat-prim))
sat_Y satellite Y position (arcsec, Y_(sat-prim))
sat_PANG satellite position angle (deg, SatPANG)
siderealtime local apparent sidereal time (str, L_Ap_Sid_Time)
airmass target optical airmass (float, a-mass)
magextinct V-mag extinction (float, mag, mag_ex)
V V magnitude (float, mag, APmag)
Tmag comet Total magnitude (float, mag, T-mag)
Nmag comet Nucleaus magnitude (float, mag, N-mag)
surfbright surf brightness (float, mag/arcsec^2, S-brt)
illumination frac of illumination (float, percent, Illu%)
illum_defect Defect of illumination (float, arcsec, Dec_illu)
sat_sep Target-primary angular separation (float, arcsec, ang-sep)
sat_vis Target-primary visibility (str, v)
ang_width Angular width of target (float, arcsec, Ang-diam)
PDObsLon Apparent planetodetic longitude (float, deg, Ob-lon)
PDObsLat Apparent planetodetic latitude (float, deg, Ob-lat)
PDSunLon Apparent planetodetic longitude of the Sun (float, deg, Sl-lon)
PDSunLat Apparent planetodetic latitude of the Sun (float, deg, Sl-lat)
SubSol_ang Target sub-solar point position angle (float, deg, SN.ang)
SubSol_dist Target sub-solar point position angle distance (float, arcsec, SN.dist)
NPole_ang Target’s North Pole position angle (float, deg, NP.ang)
NPole_dist Target’s North Pole position angle distance (float, arcsec, NP.dist)
EclLon heliocentr ecl long (float, deg, hEcl-Lon)
EclLat heliocentr ecl lat (float, deg, hEcl-Lat)
ObsEclLon obscentr ecl long (float, deg, ObsEcLon)
ObsEclLat obscentr ecl lat (float, deg, ObsEcLat)
r heliocentric distance (float, au, r)
r_rate heliocentric radial rate (float, km/s, rdot)
delta distance from observer (float, au, delta)
delta_rate obs-centric rad rate (float, km/s, deldot)
lighttime one-way light time (float, min, 1-way_LT)
vel_sun Target center velocity wrt Sun (float, km/s, VmagSn)
vel_obs Target center velocity wrt Observer (float, km/s, VmagOb)
elong solar elongation (float, deg, S-O-T)
elongFlag app. position relative to Sun (str, /r)
alpha solar phase angle (float, deg, S-T-O)
lunar_elong Apparent lunar elongation angle wrt target (float, deg, T-O-M)
lunar_illum Lunar illumination percentage (float, percent, MN_Illu%)
IB_elong Apparent interfering body elongation angle wrt target (float, deg, T-O-I)
IB_illum Interfering body illumination percentage (float, percent, IB_Illu%)
sat_alpha Observer-Primary-Target angle (float, deg, O-P-T)
OrbPlaneAng orbital plane angle (float, deg, PlAng)
sunTargetPA -Sun vector PA (float, deg, EoN, PsAng)
velocityPA -velocity vector PA (float, deg, EoN, PsAMV)
constellation constellation ID containing target (str, Cnst)
TDB-UT difference between TDB and UT (float, seconds, TDB-UT)
NPole_RA Target’s North Pole RA (float, deg, N.Pole-RA)
NPole_DEC Target’s North Pole DEC (float, deg, N.Pole-DC)
GlxLon galactic longitude (float, deg, GlxLon)
GlxLat galactic latitude (float, deg, GlxLat)
solartime local apparent solar time (string, L_Ap_SOL_Time)
earth_lighttime observer lighttime from center of Earth (float, minutes, 399_ins_LT
RA_3sigma 3 sigma positional uncertainty in RA (float, arcsec, RA_3sigma)
DEC_3sigma 3 sigma positional uncertainty in DEC (float, arcsec, DEC_3sigma)
SMAA_3sigma 3sig pos unc error ellipse semi-major axis (float, arcsec, SMAA_3sig)
SMIA_3sigma 3sig pos unc error ellipse semi-minor axis (float, arcsec, SMIA_3sig)
Theta_3sigma pos unc error ellipse position angle (float, deg, Theta)
Area_3sigma 3sig pos unc error ellipse are (float, arcsec^2, Area_3sig)
RSS_3sigma 3sig pos unc error ellipse root-sum-square (float, arcsec, POS_3sigma)
r_3sigma 3sig range uncertainty (float, km, RNG_3sigma)
r_rate_3sigma 3sig range rate uncertainty (float, km/second, RNGRT_3sigma)
SBand_3sigma 3sig Doppler radar uncertainties at S-band (float, Hertz, DOP_S_3sig)
XBand_3sigma 3sig Doppler radar uncertainties at X-band (float, Hertz, DOP_X_3sig)
DoppDelay_3sigma 3sig Doppler radar round-trip delay unc (float, second, RT_delay_3sig)
true_anom True Anomaly (float, deg, Tru_Anom)
hour_angle local apparent hour angle (string, sexagesimal angular hours, L_Ap_Hour_Ang)
alpha_true true phase angle (float, deg, phi)
PABLon phase angle bisector longitude (float, deg, PAB-LON)
PABLat phase angle bisector latitude (float, deg, PAB-LAT)
Parameters:
airmass_lessthan : float, optional

Defines a maximum airmass for the query, default: 99

solar_elongation : tuple, optional

Permissible solar elongation range: (minimum, maximum); default: (0,180)

max_hour_angle : float, optional

Defines a maximum hour angle for the query, default: 0

rate_cutoff : float, optional

Angular range rate upper limit cutoff in arcsec/h; default: disabled

skip_daylight : boolean, optional

Crop daylight epochs in query, default: False

refraction : boolean

If True, coordinates account for a standard atmosphere refraction model; if False, coordinates do not account for refraction (airless model); default: False

refsystem : string

Coordinate reference system: 'J2000' or 'B1950'; default: 'J2000'

closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

quantities : integer or string, optional

single integer or comma-separated list in the form of a string corresponding to all the quantities to be queried from JPL Horizons using the coding according to the JPL Horizons User Manual Definition of Observer Table Quantities; default: all quantities

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response : boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
table : A Table object.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='Ceres', location='568',
...             epochs={'start':'2010-01-01',
...                     'stop':'2010-03-01',
...                     'step':'10d'})
>>> eph = obj.ephemerides() # doctest: +SKIP
>>> print(eph) # doctest: +SKIP
targetname    datetime_str   datetime_jd ...   GlxLat  RA_3sigma
DEC_3sigma
   ---            ---             d      ...    deg      arcsec
arcsec
---------- ----------------- ----------- ... --------- ---------
----------
   1 Ceres 2010-Jan-01 00:00   2455197.5 ... 24.120057       0.0
0.0
   1 Ceres 2010-Jan-11 00:00   2455207.5 ... 20.621496       0.0
0.0
   1 Ceres 2010-Jan-21 00:00   2455217.5 ... 17.229529       0.0
0.0
   1 Ceres 2010-Jan-31 00:00   2455227.5 ...  13.97264       0.0
0.0
   1 Ceres 2010-Feb-10 00:00   2455237.5 ... 10.877201       0.0
0.0
   1 Ceres 2010-Feb-20 00:00   2455247.5 ...  7.976737       0.0
0.0
ephemerides_async(airmass_lessthan=99, solar_elongation=(0, 180), max_hour_angle=0, rate_cutoff=None, skip_daylight=False, refraction=False, refsystem='J2000', closest_apparition=False, no_fragments=False, quantities='1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43', get_query_payload=False, get_raw_response=False, cache=True)[source]

Query JPL Horizons for ephemerides. The location parameter in HorizonsClass refers in this case to the location of the observer.

The following tables list the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime epoch (str, Date__(UT)__HR:MN:SC.fff)
datetime_jd epoch Julian Date (float, Date_________JDUT)
solar_presence information on Sun’s presence (str)
flags information on Moon, target status (str)
RA target RA (float, deg, DEC_(XXX))
DEC target DEC (float, deg, DEC_(XXX))
RA_app target apparent RA (float, deg, R.A._(a-app))
DEC_app target apparent DEC (float, deg, DEC_(a-app))
RA_rate target rate RA (float, arcsec/hr, RA*cosD)
DEC_rate target RA (float, arcsec/hr, d(DEC)/dt)
AZ Azimuth (float, deg, EoN, Azi_(a-app))
EL Elevation (float, deg, Elev_(a-app))
AZ_rate Azimuth rate (float, arcsec/minute, dAZ*cosE)
EL_rate Elevation rate (float, arcsec/minute, d(ELV)/dt)
sat_X satellite X position (arcsec, X_(sat-prim))
sat_Y satellite Y position (arcsec, Y_(sat-prim))
sat_PANG satellite position angle (deg, SatPANG)
siderealtime local apparent sidereal time (str, L_Ap_Sid_Time)
airmass target optical airmass (float, a-mass)
magextinct V-mag extinction (float, mag, mag_ex)
V V magnitude (float, mag, APmag)
Tmag comet Total magnitude (float, mag, T-mag)
Nmag comet Nucleaus magnitude (float, mag, N-mag)
surfbright surf brightness (float, mag/arcsec^2, S-brt)
illumination frac of illumination (float, percent, Illu%)
illum_defect Defect of illumination (float, arcsec, Dec_illu)
sat_sep Target-primary angular separation (float, arcsec, ang-sep)
sat_vis Target-primary visibility (str, v)
ang_width Angular width of target (float, arcsec, Ang-diam)
PDObsLon Apparent planetodetic longitude (float, deg, Ob-lon)
PDObsLat Apparent planetodetic latitude (float, deg, Ob-lat)
PDSunLon Apparent planetodetic longitude of the Sun (float, deg, Sl-lon)
PDSunLat Apparent planetodetic latitude of the Sun (float, deg, Sl-lat)
SubSol_ang Target sub-solar point position angle (float, deg, SN.ang)
SubSol_dist Target sub-solar point position angle distance (float, arcsec, SN.dist)
NPole_ang Target’s North Pole position angle (float, deg, NP.ang)
NPole_dist Target’s North Pole position angle distance (float, arcsec, NP.dist)
EclLon heliocentr ecl long (float, deg, hEcl-Lon)
EclLat heliocentr ecl lat (float, deg, hEcl-Lat)
ObsEclLon obscentr ecl long (float, deg, ObsEcLon)
ObsEclLat obscentr ecl lat (float, deg, ObsEcLat)
r heliocentric distance (float, au, r)
r_rate heliocentric radial rate (float, km/s, rdot)
delta distance from observer (float, au, delta)
delta_rate obs-centric rad rate (float, km/s, deldot)
lighttime one-way light time (float, min, 1-way_LT)
vel_sun Target center velocity wrt Sun (float, km/s, VmagSn)
vel_obs Target center velocity wrt Observer (float, km/s, VmagOb)
elong solar elongation (float, deg, S-O-T)
elongFlag app. position relative to Sun (str, /r)
alpha solar phase angle (float, deg, S-T-O)
lunar_elong Apparent lunar elongation angle wrt target (float, deg, T-O-M)
lunar_illum Lunar illumination percentage (float, percent, MN_Illu%)
IB_elong Apparent interfering body elongation angle wrt target (float, deg, T-O-I)
IB_illum Interfering body illumination percentage (float, percent, IB_Illu%)
sat_alpha Observer-Primary-Target angle (float, deg, O-P-T)
OrbPlaneAng orbital plane angle (float, deg, PlAng)
sunTargetPA -Sun vector PA (float, deg, EoN, PsAng)
velocityPA -velocity vector PA (float, deg, EoN, PsAMV)
constellation constellation ID containing target (str, Cnst)
TDB-UT difference between TDB and UT (float, seconds, TDB-UT)
NPole_RA Target’s North Pole RA (float, deg, N.Pole-RA)
NPole_DEC Target’s North Pole DEC (float, deg, N.Pole-DC)
GlxLon galactic longitude (float, deg, GlxLon)
GlxLat galactic latitude (float, deg, GlxLat)
solartime local apparent solar time (string, L_Ap_SOL_Time)
earth_lighttime observer lighttime from center of Earth (float, minutes, 399_ins_LT
RA_3sigma 3 sigma positional uncertainty in RA (float, arcsec, RA_3sigma)
DEC_3sigma 3 sigma positional uncertainty in DEC (float, arcsec, DEC_3sigma)
SMAA_3sigma 3sig pos unc error ellipse semi-major axis (float, arcsec, SMAA_3sig)
SMIA_3sigma 3sig pos unc error ellipse semi-minor axis (float, arcsec, SMIA_3sig)
Theta_3sigma pos unc error ellipse position angle (float, deg, Theta)
Area_3sigma 3sig pos unc error ellipse are (float, arcsec^2, Area_3sig)
RSS_3sigma 3sig pos unc error ellipse root-sum-square (float, arcsec, POS_3sigma)
r_3sigma 3sig range uncertainty (float, km, RNG_3sigma)
r_rate_3sigma 3sig range rate uncertainty (float, km/second, RNGRT_3sigma)
SBand_3sigma 3sig Doppler radar uncertainties at S-band (float, Hertz, DOP_S_3sig)
XBand_3sigma 3sig Doppler radar uncertainties at X-band (float, Hertz, DOP_X_3sig)
DoppDelay_3sigma 3sig Doppler radar round-trip delay unc (float, second, RT_delay_3sig)
true_anom True Anomaly (float, deg, Tru_Anom)
hour_angle local apparent hour angle (string, sexagesimal angular hours, L_Ap_Hour_Ang)
alpha_true true phase angle (float, deg, phi)
PABLon phase angle bisector longitude (float, deg, PAB-LON)
PABLat phase angle bisector latitude (float, deg, PAB-LAT)
Parameters:
airmass_lessthan : float, optional

Defines a maximum airmass for the query, default: 99

solar_elongation : tuple, optional

Permissible solar elongation range: (minimum, maximum); default: (0,180)

max_hour_angle : float, optional

Defines a maximum hour angle for the query, default: 0

rate_cutoff : float, optional

Angular range rate upper limit cutoff in arcsec/h; default: disabled

skip_daylight : boolean, optional

Crop daylight epochs in query, default: False

refraction : boolean

If True, coordinates account for a standard atmosphere refraction model; if False, coordinates do not account for refraction (airless model); default: False

refsystem : string

Coordinate reference system: 'J2000' or 'B1950'; default: 'J2000'

closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

quantities : integer or string, optional

single integer or comma-separated list in the form of a string corresponding to all the quantities to be queried from JPL Horizons using the coding according to the JPL Horizons User Manual Definition of Observer Table Quantities; default: all quantities

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response : boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
response : requests.Response

The response of the HTTP request.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='Ceres', location='568',
...             epochs={'start':'2010-01-01',
...                     'stop':'2010-03-01',
...                     'step':'10d'})
>>> eph = obj.ephemerides() # doctest: +SKIP
>>> print(eph) # doctest: +SKIP
targetname    datetime_str   datetime_jd ...   GlxLat  RA_3sigma
DEC_3sigma
   ---            ---             d      ...    deg      arcsec
arcsec
---------- ----------------- ----------- ... --------- ---------
----------
   1 Ceres 2010-Jan-01 00:00   2455197.5 ... 24.120057       0.0
0.0
   1 Ceres 2010-Jan-11 00:00   2455207.5 ... 20.621496       0.0
0.0
   1 Ceres 2010-Jan-21 00:00   2455217.5 ... 17.229529       0.0
0.0
   1 Ceres 2010-Jan-31 00:00   2455227.5 ...  13.97264       0.0
0.0
   1 Ceres 2010-Feb-10 00:00   2455237.5 ... 10.877201       0.0
0.0
   1 Ceres 2010-Feb-20 00:00   2455247.5 ...  7.976737       0.0
0.0
vectors(*args, **kwargs)

Queries the service and returns a table object.

Query JPL Horizons for state vectors. The location parameter in HorizonsClass refers in this case to the center body relative to which the vectors are provided.

The following table lists the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime_str epoch Date (str, Calendar Date (TDB))
datetime_jd epoch Julian Date (float, JDTDB)
x x-component of position vector (float, au, X)
y y-component of position vector (float, au, Y)
z z-component of position vector (float, au, Z)
vx x-component of velocity vector (float, au/d, VX)
vy y-component of velocity vector (float, au/d, VY)
vz z-component of velocity vector (float, au/d, VZ)
lighttime one-way lighttime (float, d, LT)
range range from coordinate center (float, au, RG)
range_rate range rate (float, au/d, RR)
Parameters:
closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response: boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
table : A Table object.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='2012 TC4', location='257',
...             epochs={'start':'2017-10-01',
...                     'stop':'2017-10-02',
...                     'step':'10m'})
>>> vec = obj.vectors() # doctest: +SKIP
>>> print(vec) # doctest: +SKIP
targetname  datetime_jd  ...      range          range_rate
   ---           d       ...        AU             AU / d
---------- ------------- ... --------------- -----------------
(2012 TC4)     2458027.5 ... 0.0429332099306 -0.00408018711862
(2012 TC4) 2458027.50694 ... 0.0429048742906 -0.00408040726527
(2012 TC4) 2458027.51389 ... 0.0428765385796 -0.00408020747595
(2012 TC4) 2458027.52083 ... 0.0428482057142  -0.0040795878561
(2012 TC4) 2458027.52778 ...  0.042819878607 -0.00407854931543
(2012 TC4) 2458027.53472 ... 0.0427915601617  -0.0040770935665
       ...           ... ...             ...               ...
(2012 TC4) 2458028.45833 ... 0.0392489462501 -0.00405496595173
(2012 TC4) 2458028.46528 ...   0.03922077771 -0.00405750632914
(2012 TC4) 2458028.47222 ...  0.039192592935 -0.00405964084539
(2012 TC4) 2458028.47917 ...  0.039164394759 -0.00406136516755
(2012 TC4) 2458028.48611 ... 0.0391361860433 -0.00406267574646
(2012 TC4) 2458028.49306 ... 0.0391079696711  -0.0040635698239
(2012 TC4)     2458028.5 ... 0.0390797485422 -0.00406404543822
Length = 145 rows
vectors_async(get_query_payload=False, closest_apparition=False, no_fragments=False, get_raw_response=False, cache=True)[source]

Query JPL Horizons for state vectors. The location parameter in HorizonsClass refers in this case to the center body relative to which the vectors are provided.

The following table lists the values queried, their definitions, data types, units, and original Horizons designations (where available). For more information on the definitions of these quantities, please refer to the Horizons User Manual.

Column Name Definition
targetname official number, name, designation (string)
H absolute magnitude in V band (float, mag)
G photometric slope parameter (float)
M1 comet total abs mag (float, mag, M1)
M2 comet nuclear abs mag (float, mag, M2)
k1 total mag scaling factor (float, k1)
k2 nuclear mag scaling factor (float, k2)
phasecoeff comet phase coeff (float, mag/deg, PHCOFF)
datetime_str epoch Date (str, Calendar Date (TDB))
datetime_jd epoch Julian Date (float, JDTDB)
x x-component of position vector (float, au, X)
y y-component of position vector (float, au, Y)
z z-component of position vector (float, au, Z)
vx x-component of velocity vector (float, au/d, VX)
vy y-component of velocity vector (float, au/d, VY)
vz z-component of velocity vector (float, au/d, VZ)
lighttime one-way lighttime (float, d, LT)
range range from coordinate center (float, au, RG)
range_rate range rate (float, au/d, RR)
Parameters:
closest_apparition : boolean, optional

Only applies to comets. This option will choose the closest apparition available in time to the selected epoch; default: False. Do not use this option for non-cometary objects.

no_fragments : boolean, optional

Only applies to comets. Reject all comet fragments from selection; default: False. Do not use this option for non-cometary objects.

get_query_payload : boolean, optional

When set to True the method returns the HTTP request parameters as a dict, default: False

get_raw_response: boolean, optional

Return raw data as obtained by JPL Horizons without parsing the data into a table, default: False

Returns:
response : requests.Response

The response of the HTTP request.

Examples

>>> from astroquery.jplhorizons import Horizons
>>> obj = Horizons(id='2012 TC4', location='257',
...             epochs={'start':'2017-10-01',
...                     'stop':'2017-10-02',
...                     'step':'10m'})
>>> vec = obj.vectors() # doctest: +SKIP
>>> print(vec) # doctest: +SKIP
targetname  datetime_jd  ...      range          range_rate
   ---           d       ...        AU             AU / d
---------- ------------- ... --------------- -----------------
(2012 TC4)     2458027.5 ... 0.0429332099306 -0.00408018711862
(2012 TC4) 2458027.50694 ... 0.0429048742906 -0.00408040726527
(2012 TC4) 2458027.51389 ... 0.0428765385796 -0.00408020747595
(2012 TC4) 2458027.52083 ... 0.0428482057142  -0.0040795878561
(2012 TC4) 2458027.52778 ...  0.042819878607 -0.00407854931543
(2012 TC4) 2458027.53472 ... 0.0427915601617  -0.0040770935665
       ...           ... ...             ...               ...
(2012 TC4) 2458028.45833 ... 0.0392489462501 -0.00405496595173
(2012 TC4) 2458028.46528 ...   0.03922077771 -0.00405750632914
(2012 TC4) 2458028.47222 ...  0.039192592935 -0.00405964084539
(2012 TC4) 2458028.47917 ...  0.039164394759 -0.00406136516755
(2012 TC4) 2458028.48611 ... 0.0391361860433 -0.00406267574646
(2012 TC4) 2458028.49306 ... 0.0391079696711  -0.0040635698239
(2012 TC4)     2458028.5 ... 0.0390797485422 -0.00406404543822
Length = 145 rows