Global app_planet (double jd_tt, const object *restrict ss_body, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec, double *restrict dis)

Use place_cirs() is now preferred, especially for high accuracy calculations.

Global app_star (double jd_tt, const cat_entry *restrict star, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec)

Use place_cirs() is now preferred, especially for high accuracy calculations.

Global BARYC

Old definition of the Barycenter origin. NOVAS_BARYCENTER is preferred.

Global cel2ter (double jd_ut1_high, double jd_ut1_low, double ut1_to_tt, enum novas_earth_rotation_measure erot, enum novas_accuracy accuracy, enum novas_equatorial_class coordType, double xp, double yp, const double *in, double *out)

This function can be confusing to use due to the input coordinate system being specified by a combination of two options. Use itrs_to_cirs() or itrs_to_tod() instead. You can then follow these with other conversions to GCRS (or whatever else) as appropriate.

Global cel_pole (double jd_tt, enum novas_pole_offset_type type, double dpole1, double dpole2)

This old way of incorporating Earth orientation parameters into the true equator and equinox is now disfavored. Instead, wobble() should be used to convert between the Terrestrial Intermediate Reference System (TIRS) / Pseudo Earth Fixed (PEF) and the International Terrestrial Reference System (ITRS) going forward.

Global ee_ct (double jd_tt_high, double jd_tt_low, enum novas_accuracy accuracy)

(for intrernal use) There is no good reason why this function should be exposed to users of the library. It is intended only for use by e_tilt() internally.

Global equ2hor (double jd_ut1, double ut1_to_tt, enum novas_accuracy accuracy, double xp, double yp, const on_surface *restrict location, double ra, double dec, enum novas_refraction_model ref_option, double *restrict zd, double *restrict az, double *restrict rar, double *restrict decr)

The name of this function does not reveal what type of equatorial coordinates it requires. To make it less ambiguous, you should use tod_to_itrs() followed by itrs_to_hor() instead, possibly following it with refract_astro() if you also want to apply optical refraction.

Global HELIOC

Old definition of the Center of Sun as the origin. NOVAS_HELIOCENTER is preferred.

Global ira_equinox (double jd_tdb, enum novas_equinox_type equinox, enum novas_accuracy accuracy)

(for internal use) There is no good reason why this function should be exposed to users. It is intended only for cio_location() internally.

Global readeph (int mp, const char *restrict name, double jd_tdb, int *restrict error)

This old ephemeris reader is prone to memory leaks, and lacks some useful functionality. Users are strongly encouraged to use the new novas_ephem_provider instead, which can provide dynamically configured implementations at runtime.

(legacy function) Use set_ephem_provider() instead to specify what function should be used to calculate ephemeris positions for Solar-system objects. This prototype is provided to extend support for legacy NOVAS C applications only. In NOVAS, the function had to be user defined, as a custom implementation.

Global solarsystem (double jd_tdb, short body, short origin, double *restrict position, double *restrict velocity)

(legacy function) Use set_planet_provider() instead to specify what function should be used to calculate ephemeris positions for major planets. This function is provided to extend support for legacy NOVAS C applications only. In NOVAS, the function had to be user defined, either by linking against a solsys[1-3].c module, or by providing a custom user implementation.

Global solarsystem_hp (const double jd_tdb[restrict 2], short body, short origin, double *restrict position, double *restrict velocity)

(legacy function) Use set_planet_provider_hp() instead to specify what function should be used to calculate high-precision ephemeris positions for major planets. This function is provided to extend support for legacy NOVAS C applications only. In NOVAS, the function had to be user defined, either by linking against a solsys[1-3].c module, or by providing a custom user implementation.

Global ter2cel (double jd_ut1_high, double jd_ut1_low, double ut1_to_tt, enum novas_earth_rotation_measure erot, enum novas_accuracy accuracy, enum novas_equatorial_class coordType, double xp, double yp, const double *in, double *out)

This function can be confusing to use due to the output coordinate system being specified by a combination of two options. Use itrs_to_cirs() or itrs_to_tod() instead. You can then follow these with other conversions to GCRS (or whatever else) as appropriate.

Global topo_planet (double jd_tt, const object *restrict ss_body, double ut1_to_tt, const on_surface *restrict position, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec, double *restrict dis)

Using place() with system NOVAS_CIRS is now preferred for topocentric calculations, especially when high precision is required. However, you will have to follow the IAU 2000 method consistently to produce equivalent calculations throughout.

Global topo_star (double jd_tt, double ut1_to_tt, const cat_entry *restrict star, const on_surface *restrict position, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec)

Using place() with system NOVAS_CIRS is now preferred for topocentric calculations, especially when high precision is required. However, you will have to follow the IAU 2000 method consistently to produce equivalent calculations throughout.