Celestine API Documentation - v0.2.0
    Preparing search index...

    Interface EphemerisOptions

    Options for ephemeris calculations.

    Default options provide arcminute-level accuracy sufficient for astrology. Enable additional corrections for higher precision requirements.

    interface EphemerisOptions {
        includeSpeed?: boolean;
        includeNutation?: boolean;
        includeAberration?: boolean;
        includeLightTime?: boolean;
    }
    Index

    Properties

    includeSpeed?: boolean

    Calculate and include daily motion (speed).

    true
    

    When true, calculates position for JD and JD+1 to determine speed. Disable for slight performance improvement when speed not needed.

    includeNutation?: boolean

    Apply nutation correction to longitude.

    false
    

    Nutation is a small periodic oscillation in Earth's axis (~±17"). For arcminute precision: not needed (error < 0.3') For arcsecond precision: required

    Meeus Ch. 22 for nutation calculation

    includeAberration?: boolean

    Apply aberration correction.

    false (except Sun where it's always applied)
    

    Aberration is the apparent shift due to Earth's orbital velocity combined with the finite speed of light. Effect up to ~20".

    For Sun: always included as it's significant (~20") For planets: optional, typically < 1"

    includeLightTime?: boolean

    Apply light-time correction.

    false
    

    We see planets where they were, not where they are, due to the time light takes to travel from planet to Earth.

    For inner planets: effect < 1" For outer planets: can be several arcseconds