Functions
novas_ephem_provider	get_ephem_provider ()

novas_nutation_provider	get_nutation_lp_provider ()

novas_planet_provider	get_planet_provider ()

novas_planet_provider_hp	get_planet_provider_hp ()

int	set_ephem_provider (novas_ephem_provider func)

int	set_nutation_lp_provider (novas_nutation_provider func)

int	set_planet_provider (novas_planet_provider func)

int	set_planet_provider_hp (novas_planet_provider_hp func)

Detailed Description

Date: Created on Mar 6, 2025

Author: Attila Kovacs

Functions that allow to define or access user-defined plugin routines.

Function Documentation

◆ get_ephem_provider()

novas_ephem_provider get_ephem_provider ( )

Returns the user-defined ephemeris accessor function.

Returns: the currently defined function for accessing ephemeris data for minor planets or satellites, ot NULL if no function was set via set_ephem_provider() previously.

See also: set_ephem_provider(); get_planet_provider(); get_planet_provider_hp(); ephemeris()

Since: 1.0

Author: Attila Kovacs

◆ get_nutation_lp_provider()

novas_nutation_provider get_nutation_lp_provider ( )

Returns the function configured for low-precision IAU 2000 nutation calculations instead of the default nu2000k().

Returns: the function to use for low-precision IAU 2000 nutation calculations

See also: set_nutation_lp_provider(); nutation_angles()

Since: 1.3

Author: Attila Kovacs

◆ get_planet_provider()

novas_planet_provider get_planet_provider ( )

Returns the custom (low-precision) ephemeris provider function for major planets (and Sun, Moon, SSB...), if any.

Returns: the custom (low-precision) planet ephemeris provider function.

Author: Attila Kovacs

Since: 1.2

See also: set_planet_provider(); get_planet_provider_hp(); get_ephem_provider()

◆ get_planet_provider_hp()

novas_planet_provider_hp get_planet_provider_hp ( )

Returns the custom high-precision ephemeris provider function for major planets (and Sun, Moon, SSB...), if any.

Returns: the custom high-precision planet ephemeris provider function.

Author: Attila Kovacs

Since: 1.2

See also: set_planet_provider_hp(); get_planet_provider(); get_ephem_provider()

◆ set_ephem_provider()

int set_ephem_provider ( novas_ephem_provider func )

Sets the function to use for obtaining position / velocity information for minor planets, or sattelites.

Parameters

func	new function to use for accessing ephemeris data for minor planets or satellites.

Returns: 0 if successful, or else -1 if the function argument is NULL.

Since: 1.0

Author: Attila Kovacs

See also: get_ephem_provider(); set_planet_provider(); set_planet_provider_hp(); ephemeris(); solsys-ephem.c

◆ set_nutation_lp_provider()

int set_nutation_lp_provider ( novas_nutation_provider func )

Set the function to use for low-precision IAU 2000 nutation calculations instead of the default nu2000k().

Parameters

func	the new function to use for low-precision IAU 2000 nutation calculations

Returns: 0 if successful, or -1 if the input argument is NULL

See also: get_nutation_lp_provider(); nutation_angles()

Since: 1.0

Author: Attila Kovacs

◆ set_planet_provider()

int set_planet_provider ( novas_planet_provider func )

Set a custom function to use for regular precision (see NOVAS_REDUCED_ACCURACY) ephemeris calculations instead of the default solarsystem() routine.

Parameters

func	The function to use for solar system position/velocity calculations. See solarsystem() for further details on what is required of this function.

Author: Attila Kovacs

Since: 1.0

See also: get_planet_provider(); set_planet_provider_hp(); solarsystem(); NOVAS_REDUCED_ACCURACY

◆ set_planet_provider_hp()

int set_planet_provider_hp ( novas_planet_provider_hp func )

Set a custom function to use for high precision (see NOVAS_FULL_ACCURACY) ephemeris calculations instead of the default solarsystem_hp() routine.

Parameters

func	The function to use for solar system position/velocity calculations. See solarsystem_hp() for further details on what is required of this function.

Author: Attila Kovacs

Since: 1.0

See also: get_planet_provider_hp(); set_planet_provider(); solarsystem_hp(); NOVAS_FULL_ACCURACY