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 inHorizonsClass
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: Falseget_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 inHorizonsClass
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: Falseget_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 inHorizonsClass
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; ifFalse
, 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: Falseget_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 inHorizonsClass
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; ifFalse
, 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: Falseget_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 inHorizonsClass
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: Falseget_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 inHorizonsClass
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: Falseget_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
-