MPSkyEphemerisQueryTask

class lsst.ap.association.MPSkyEphemerisQueryTask(*, config: PipelineTaskConfig | None = None, log: logging.Logger | LsstLogAdapter | None = None, initInputs: dict[str, Any] | None = None, **kwargs: Any)

Bases: PipelineTask

Task to query the MPSky service and retrieve the solar system objects that are observable within the input visit.

Methods Summary

read_mp_sky_response(response)	Extract ephemerides from an MPSky web request
run(predictedRegionTime)	Parse the information on the current visit and retrieve the observable solar system objects from MPSky.

Methods Documentation

read_mp_sky_response(response)

Extract ephemerides from an MPSky web request

Parameters

responserequests.Response

MPSky message

Returns

objIDnp.ndarray

Designations of nearby objects

ranp.ndarray

Array of object right ascensions

decnp.ndarray

Array of object declinations

object_polynomialnp.ndarray, (N,M)

Array of object cartesian position polynomials

observer_polynomialnp.ndarray, (N,M)

Array of observer cartesian position polynomials

t_minnp.ndarray

Lower time bound for polynomials

t_maxnp.ndarray

Upper time bound for polynomials

elementspandas.DataFrame or NoneType

Orbital elements of ssObjects (to pass to alerts)

run(predictedRegionTime)

Parse the information on the current visit and retrieve the observable solar system objects from MPSky.

Parameters

predictedRegionTimelsst.pipe.base.utils.RegionTimeInfo

Predicted footprint and timespan of the exposure

Returns

resultlsst.pipe.base.Struct

Results struct with components:

• ssObjectspandas.DataFrame

  DataFrame containing Solar System Objects near the detector footprint as retrieved by MPSky. The columns are as follows:

  Name

  object name (str)

  ra

  RA in decimal degrees (float)

  dec

  DEC in decimal degrees (float)

  obj_X_poly, obj_Y_poly, obj_Z_poly

  Chebyshev coefficients for object path

  obs_X_poly, obs_Y_poly, obs_Z_poly

  Chebyshev coefficients for observer path

  t_min

  Lower time bound for polynomials

  t_max

  Upper time bound for polynomials