Global app_planet (double jd_tt, const object *restrict ss_body, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec, double *restrict dis): place_tod() or the frame-based novas_sky_pos() are now preferred.
Global app_star (double jd_tt, const cat_entry *restrict star, enum novas_accuracy accuracy, double *restrict ra, double *restrict dec): place_tod() or the frame-based novas_sky_pos() are now preferred.
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 cio_array (double jd_tdb, long n_pts, ra_of_cio *restrict cio): This function is no longer used within SuperNOVAS. It is still provided, however, in order to retain 100% API compatibility with NOVAS C.
Global cio_basis (double jd_tdb, double ra_cio, enum novas_cio_location_type loc_type, enum novas_accuracy accuracy, double *restrict x, double *restrict y, double *restrict z): This function is no longer used internally in the library, and users are recommended against using it themselves, since SuperNOVAS provides better ways to convert between GCRS and CIRS using frames or via gcrs_to_cirs() / cirs_to_gcrs() functions.
Global cio_location (double jd_tdb, enum novas_accuracy accuracy, double *restrict ra_cio, short *restrict loc_type): This function is no longer used internally in the library. Given that the CIO is defined on the dynamical equator of date, it is not normally meaningful to provide an R.A. coordinate for it in GCRS, in general. Instead, you might use cio_ra() to get the same value w.r.t. the equinox of date (on the same CIRS/TOD dynamical equator, or else ira_equinox() to return the negated value.
Global ee_ct (double jd_tt_high, double jd_tt_low, enum novas_accuracy accuracy): (for internal 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 an atmospheric refraction correction if appropriate.
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 make_object (enum novas_object_type type, long number, const char *name, const cat_entry *star, object *source): More functionality and more readable, code results from using one of the specific alternatives: make_cat_object(), make_redshifted_object(), make_planet(), make_ephem_object(), or make_orbital_object().
Global make_observer (enum novas_observer_place where, const on_surface *loc_surface, const in_space *loc_space, observer *obs): It is recommended that you use one of the more specific ways of initializing the observer data structure, e.g. with make_itrf_observer(), make_gps_observer(), make_observer_at_site(), make_airborne_observer() make_solar_system_observer(), ormake_observer_at_geocenter()`. This function will be available for the foreseeable future also.
Global make_observer_on_surface (double latitude, double longitude, double height, double temperature, double pressure, observer *restrict obs): This old NOVAS C function has a few too many caveats. It is recommended that you use make_itrf_observer(), make_gps_observer(), or make_observer_at_site() instead (all of which set default mean annual weather parameters for approximate refraction correction), and optionally set actual weather data afterwards, based on the measurements available. This function will be available for the foreseeable future also.
Global make_on_surface (double latitude, double longitude, double height, double temperature, double pressure, on_surface *restrict loc): This old NOVAS C function has a few too many caveats. It is recommended that you use make_itrf_site() or make_gps_site() instead (both of which set default mean annual weather parameters for approximate refraction correction), and optionally set actual weather data afterwards, based on the measurements available. This function will be available for the foreseeable future also.
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 / novas_set_ephem_provider() instead, for dynamically configured implementations at runtime. This prototype is provided only to extend support for legacy NOVAS applications only, where an inplementation had to be linked always.
Global set_cio_locator_file (const char *restrict filename): SuperNOVAS no longer uses a NOVAS-type CIO locator file. However, if users want to access such files directly, this function remains accessible to provide API compatibility with previous versions.
Global sidereal_time (double jd_ut1_high, double jd_ut1_low, double ut1_to_tt, enum novas_equinox_type gst_type, enum novas_earth_rotation_measure erot, enum novas_accuracy accuracy, double *restrict gst): Use novas_gmst() or novas_gast() instead to get the same results simpler.
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*.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*.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 the frame-based novas_sky_pos() is now preferred for topocentric calculations, especially when high precision is required.
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 the frame-based novas_sky_pos() is now preferred for topocentric calculations, especially when high precision is required.