lsst.pipe.tasks g540474b770+e2881a99e2
Loading...
Searching...
No Matches
lsst.pipe.tasks.ssp.moid Namespace Reference

Classes

class  MOIDSolver
 

Functions

 earth_orbit (epoch_mjd=51544.5)
 
 earth_orbit_J2000 ()
 

Variables

 AU_KM = AU_CONST.to_value(u.km)
 
 EarthElements
 
 MOIDResult
 
 solver
 
tuple el1 = (1.0, 0.1, 5.0, 30.0, 45.0)
 
tuple el2 = (1.5, 0.2, 15.0, 60.0, 10.0)
 
 result = solver.compute(el1, el2)
 

Function Documentation

◆ earth_orbit()

lsst.pipe.tasks.ssp.moid.earth_orbit ( epoch_mjd = 51544.5)
Return Earth’s heliocentric Keplerian elements at a given epoch.

Evaluates a linear secular model for Earth’s orbital elements
in the J2000 ecliptic and equinox frame. The model coefficients
are from JPL’s "Keplerian Elements for Approximate Positions of
the Major Planets" (Standish 1992, Table 1), valid for
3000 BC -- 3000 AD.

Parameters
----------
epoch_mjd : float, optional
    Epoch as Modified Julian Date. Default is 51544.5
    (J2000.0 = 2000 Jan 1.5 TDB).

Returns
-------
EarthElements
    A namedtuple with fields:

    ``a_AU``
        Semi-major axis in AU.
    ``e``
        Eccentricity.
    ``inc_deg``
        Inclination to the ecliptic in degrees. Set to a small
        nonzero value (0.00005°) to avoid singularities in
        rotation matrices; the true value is ~0 by definition
        since the ecliptic *is* Earth’s mean orbital plane.
    ``Omega_deg``
        Longitude of the ascending node in degrees. Zero by
        definition in the ecliptic frame.
    ``omega_deg``
        Argument of perihelion in degrees. Since Omega = 0 in
        the ecliptic frame, this equals the longitude of
        perihelion (ϖ).

Notes
-----
The linear model for each element is::

    element(T) = element_0 + element_dot * T

where T is Julian centuries from J2000.0. The coefficients are:

======  ===============  =================
Param   Value at J2000   Rate (per century)
======  ===============  =================
a       1.00000261 AU    +0.00000562 AU
e       0.01671123       -0.00004392
ϖ       102.93768193°    +0.32327364°
======  ===============  =================

Inclination and Omega are fixed at ~0 (ecliptic frame).

MOID is a purely geometric quantity (no mean anomaly / phase
dependence), but the *shape and orientation* of Earth’s orbit
do evolve slowly. Evaluating at the asteroid’s osculating
element epoch ensures the two orbits are compared at a
consistent time.

References
----------
Standish, E.M. (1992). "Keplerian Elements for Approximate
Positions of the Major Planets." Solar System Dynamics Group,
JPL. https://ssd.jpl.nasa.gov/planets/approx_pos.html

Definition at line 28 of file moid.py.

◆ earth_orbit_J2000()

lsst.pipe.tasks.ssp.moid.earth_orbit_J2000 ( )
Return Earth’s elements at J2000.0. Deprecated; use
`earth_orbit(epoch_mjd)` instead.

Definition at line 105 of file moid.py.

Variable Documentation

◆ AU_KM

lsst.pipe.tasks.ssp.moid.AU_KM = AU_CONST.to_value(u.km)

Definition at line 7 of file moid.py.

◆ EarthElements

lsst.pipe.tasks.ssp.moid.EarthElements
Initial value:
1= namedtuple(
2 "EarthElements",
3 ["a_AU", "e", "inc_deg", "Omega_deg", "omega_deg"],
4)

Definition at line 10 of file moid.py.

◆ el1

tuple lsst.pipe.tasks.ssp.moid.el1 = (1.0, 0.1, 5.0, 30.0, 45.0)

Definition at line 367 of file moid.py.

◆ el2

tuple lsst.pipe.tasks.ssp.moid.el2 = (1.5, 0.2, 15.0, 60.0, 10.0)

Definition at line 368 of file moid.py.

◆ MOIDResult

lsst.pipe.tasks.ssp.moid.MOIDResult
Initial value:
1= namedtuple(
2 "MOIDResult",
3 [
4 "MOID_AU",
5 "DeltaV_kms",
6 "EclipticLongitude_deg",
7 "TrueAnomaly1_deg",
8 "TrueAnomaly2_deg",
9 ],
10)

Definition at line 16 of file moid.py.

◆ result

lsst.pipe.tasks.ssp.moid.result = solver.compute(el1, el2)

Definition at line 370 of file moid.py.

◆ solver

lsst.pipe.tasks.ssp.moid.solver
Initial value:
1= MOIDSolver(
2 mu=GM_sun,
3 n_samples=128,
4 refine_factor=5.0,
5 tol_MOID_abs=1e-8 * u.AU,
6 tol_MOID_rel=1e-8,
7 max_refine=12,
8 )

Definition at line 358 of file moid.py.