EarthOrbit
==========



Access to Astronomical Solutions for Earth Paleoclimates. There are three researches (in 1993, 2004, and 2010) about
earth orbital parameters' data. This service only uses the 2004 data.

For more information, check out
http://vo.imcce.fr/insola/earth/online/earth/earth.html.

Original datasets are available at:

- http://vo.imcce.fr/insola/earth/online/earth/La2004/INSOLN.LA2004.BTL.100.ASC
- http://vo.imcce.fr/insola/earth/online/earth/La2004/INSOLN.LA2004.BTL.250.ASC
- http://vo.imcce.fr/insola/earth/online/earth/La2004/INSOLN.LA2004.BTL.ASC
- http://vo.imcce.fr/insola/earth/online/earth/La2004/INSOLP.LA2004.BTL.ASC
- http://vo.imcce.fr/webservices/miriade/proxy.php?file=http://145.238.217.35//tmp/insola/insolaouto7Yk3u&format=text
- http://vo.imcce.fr/webservices/miriade/proxy.php?file=http://145.238.217.38//tmp/insola/insolaouteXT96X&format=text



.. toctree::
    :maxdepth: 2
    :titlesonly:
    :caption: RPC Categories





RPCS
----

.. function:: EarthOrbit.getEccentricity(startyear: Number?, endyear: Number?)

    Get eccentricity by year. For more information about eccentricity, please visit:
    https://climate.nasa.gov/news/2948/milankovitch-orbital-cycles-and-their-role-in-earths-climate/
    
    If ``startyear`` or ``endyear`` is provided, only measurements within the given range will be returned.

    **Arguments:**

    - ``startyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - first year of data to include
    - ``endyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - last year of data to include

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - list of historical eccentricity values for each year


.. function:: EarthOrbit.getInsolation(startyear: Number?, endyear: Number?)

    Get insolation by year. Insolation here is the amount of solar radiation received at 65 N in June on Earth.
    
    If ``startyear`` or ``endyear`` is provided, only measurements within the given range will be returned.

    **Arguments:**

    - ``startyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - first year of data to include
    - ``endyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - last year of data to include

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - list of historical insolation values for each year


.. function:: EarthOrbit.getLongitude(startyear: Number?, endyear: Number?)

    Get longitude of perihelion from moving equinox by year. For more information about this, please visit:
    https://www.physics.ncsu.edu/classes/astron/orbits.html
    
    If ``startyear`` or ``endyear`` is provided, only measurements within the given range will be returned.

    **Arguments:**

    - ``startyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - first year of data to include
    - ``endyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - last year of data to include

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - longitude - longitude of perihelion from moving equinox


.. function:: EarthOrbit.getObliquity(startyear: Number?, endyear: Number?)

    Get obliquity by year. For more information about obliquity, please visit:
    https://climate.nasa.gov/news/2948/milankovitch-orbital-cycles-and-their-role-in-earths-climate/
    
    If ``startyear`` or ``endyear`` is provided, only measurements within the given range will be returned.

    **Arguments:**

    - ``startyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - first year of data to include
    - ``endyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - last year of data to include

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - list of historical obliquity values for each year


.. function:: EarthOrbit.getPrecession(startyear: Number?, endyear: Number?)

    Get precession by year. For more information about precession, please visit:
    https://climate.nasa.gov/news/2948/milankovitch-orbital-cycles-and-their-role-in-earths-climate/
    
    If ``startyear`` or ``endyear`` is provided, only measurements within the given range will be returned.

    **Arguments:**

    - ``startyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - first year of data to include
    - ``endyear: Number?`` (`Number </docs/fundamentals/rpc-arg-types.html#Number>`__) - last year of data to include

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - list of historical precession values for each year