MiriadeClass¶

class astroquery.imcce.MiriadeClass[source]¶

Bases: astroquery.query.BaseQuery

A class for querying the IMCCE/Miriade service.

Attributes Summary

uri

URI used in query to service.

Methods Summary

`get_ephemerides`(args, *kwargs)	Queries the service and returns a table object.
`get_ephemerides_async`(targetname[, objtype, ...])	Query the IMCCE Miriade ephemcc service.

Attributes Documentation

uri¶: URI used in query to service.

Methods Documentation

get_ephemerides(*args, **kwargs)¶

Queries the service and returns a table object.

Query the IMCCE Miriade ephemcc service.

Parameters

targetnamestr: Name of the target to be queried.
objtypestr, optional: Type of the object to be queried. Available are: 'asteroid', 'comet', 'dwarf planet', 'planet', 'satellite'. Default: 'asteroid'
epochTime object, float, str,``None``, optional: Start epoch of the query. If a float is provided, it is expected to be a Julian Date; if a str is provided, it is expected to be an iso date of the form 'YYYY-MM-DD HH-MM-SS'. If None is provided, the current date and time are used as epoch. Default: None
epoch_stepstr, optional: Step size for ephemerides calculation. Must consist of a decimal number followed by a single character: (d)ays, (h)ours, (m)inutes or (s)econds. Default: '1d'
epoch_nstepsint, optional: Number of increments of epoch_step starting from epoch for which ephemerides are calculated. Maximum number of steps is 5000. Default: 1
locationstr, optional: Location of the observer on Earth as a code or a set of coordinates. See the Miriade manual for details. Default: geocentric location ('500')
coordtypeint, optional: Type of coordinates to be calculated: 1: spherical, 2: rectangular, 3: local coordinates (azimuth and elevation), 4: hour angle coordinates, 5: dedicated to observation, 6: dedicated to AO observation. Default: 1
timescalestr, optional: The time scale used in the computation of the ephemerides: 'UTC' or 'TT'. Default: 'UTC'
planetary_theorystr, optional: Planetary ephemerides set to be utilized in the calculations: 'INPOP', 'DE405', 'DE406'. Default: 'INPOP'
ephtypeint, optional: Type of ephemerides to be calculated: 1: astrometric J2000, 2: apparent of the date, 3: mean of the date, 4: mean J2000, Default: 1
refplanestr, optional: Reference plane: 'equator' or 'ecliptic'. Default: 'equator'
elementsstr, optional: Set of osculating elements to be used in the calculations: 'ASTORB' or 'MPCORB'. Default: 'ASTORB'
radial_velocitybool, optional: Calculate additional information on the target’s radial velocity. Default: False
get_query_payloadbool, optional: When set to True the method returns the HTTP request parameters as a dict, default: False
get_raw_responsebool, optional: Return raw data as obtained by Miriade without parsing the data into a table, default: False
cachebool, optional: If True the query will be cached. Default: True

Returns

tableA Table object.

Notes

The following parameters can be queried using this function. Note that different coordtype setting provide different sets of parameters; number in parentheses denote which coordtype settings include the parameters.

Column Name	Definition
`target`	Target name (str, 1, 2, 3, 4, 5, 6 )
`epoch`	Ephemerides epoch (JD, float, 1, 2, 3, 4, 5, 6)
`RA`	Target RA at `ephtype` (deg, float, 1)
`DEC`	Target declination at `ephtype` (deg, float, 1, 4, 5)
`RAJ2000`	Target RA at J2000 (deg, float, 5, 6)
`DECJ2000`	Target declination at J2000 (deg, float, 5, 6)
`AZ`	Target azimuth (deg, float, 3, 5)
`EL`	Target elevation (deg, float, 3, 5)
`delta`	Distance from observer (au, float, 1, 2, 3, 4, 5, 6)
`delta_rate`	Rate in observer distance (km/s, float, 1, 5, 6)
`V`	Apparent visual magnitude (mag, float, 1, 2, 3, 4, 5, 6)
`alpha`	Solar phase angle (deg, 1, 2, 3, 4, 5, 6)
`elong`	Solar elongation angle (deg, 1, 2, 3, 4, 5, 6)
`RAcosD_rate`	Rate of motion in RA * cos(DEC) (arcsec/min, float, 1, 5, 6)
`DEC_rate`	Rate of motion in DEC (arcsec/min, float, 1, 5, 6)
`x`	X position state vector (au, float, 2)
`y`	Y position state vector (au, float, 2)
`z`	Z position state vector (au, float, 2)
`vx`	X velocity state vector (au/d, float, 2)
`vy`	Y velocity state vector (au/d, float, 2)
`vz`	Z velocity state vector (au/d, float, 2)
`rv`	Radial velocity (km/s, float, 2)
`heldist`	Target heliocentric distance (au, float, 2, 5, 6)
`x_h`	X heliocentric position vector (au, float, 2)
`y_h`	Y heliocentric position vector (au, float, 2)
`z_h`	Z heliocentric position vector (au, float, 2)
`vx_h`	X heliocentric vel. vector (au/d, float, 2)
`vy_h`	Y heliocentric vel. vector (au/d, float, 2)
`vz_h`	Z heliocentric vel. vector (au/d, float, 2)
`hourangle`	Target hour angle (deg, float, 4, 5)
`siderealtime`	Local sidereal time (hr, float, 5, 6)
`refraction`	Atmospheric refraction (arcsec, float, 5, 6)
`airmass`	Target airmass (float, 5, 6)
`posunc`	Positional uncertainty (arcsec, float, 5, 6)

Examples

>>> from astroquery.imcce import Miriade
>>> from astropy.time import Time
>>> epoch = Time('2019-01-01', format='iso')
>>> Miriade.get_ephemerides('3552', epoch=epoch)  
<Table masked=True length=1>
   target          epoch                 RA         ...  DEC_rate   delta_rate
                     d                  deg         ... arcs / min    km / s
  bytes20         float64             float64       ...  float64     float64
----------- -------------------- ------------------ ... ---------- ------------
Don Quixote            2458484.5 16.105294999999998 ...   -0.25244   31.4752734

get_ephemerides_async(targetname, objtype='asteroid', epoch=None, epoch_step='1d', epoch_nsteps=1, location=500, coordtype=1, timescale='UTC', planetary_theory='INPOP', ephtype=1, refplane='equator', elements='ASTORB', radial_velocity=False, get_query_payload=False, get_raw_response=False, cache=True)[source]¶