MiriadeClass

class astroquery.imcce.MiriadeClass[source]

Bases: 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, *[, ...])

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]

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

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