libnova  v 0.16.0
Functions
Transformation of Coordinates

Functions

void LIBNOVA_EXPORT ln_get_hrz_from_equ (struct ln_equ_posn *object, struct ln_lnlat_posn *observer, double JD, struct ln_hrz_posn *position)
 Calculate horizontal coordinates from equatorial coordinates. More...
 
void LIBNOVA_EXPORT ln_get_hrz_from_equ_sidereal_time (struct ln_equ_posn *object, struct ln_lnlat_posn *observer, double sidereal, struct ln_hrz_posn *position)
 Calculate horizontal coordinates from equatorial coordinates, using mean sidereal time.
 
void LIBNOVA_EXPORT ln_get_equ_from_ecl (struct ln_lnlat_posn *object, double JD, struct ln_equ_posn *position)
 Calculate equatorial coordinates from ecliptical coordinates. More...
 
void LIBNOVA_EXPORT ln_get_ecl_from_equ (struct ln_equ_posn *object, double JD, struct ln_lnlat_posn *position)
 Calculate ecliptical coordinates from equatorial coordinates. More...
 
void LIBNOVA_EXPORT ln_get_equ_from_hrz (struct ln_hrz_posn *object, struct ln_lnlat_posn *observer, double JD, struct ln_equ_posn *position)
 Calculate equatorial coordinates from horizontal coordinates. More...
 
void LIBNOVA_EXPORT ln_get_rect_from_helio (struct ln_helio_posn *object, struct ln_rect_posn *position)
 Calculate geocentric coordinates from heliocentric coordinates. More...
 
void LIBNOVA_EXPORT ln_get_ecl_from_rect (struct ln_rect_posn *rect, struct ln_lnlat_posn *posn)
 Transform an objects rectangular coordinates into ecliptical coordinates. More...
 
void LIBNOVA_EXPORT ln_get_equ_from_gal (struct ln_gal_posn *gal, struct ln_equ_posn *equ)
 Transform an object galactic coordinates into equatorial coordinates. More...
 
void LIBNOVA_EXPORT ln_get_equ2000_from_gal (struct ln_gal_posn *gal, struct ln_equ_posn *equ)
 Transform an object galactic coordinate into J2000 equatorial coordinates. More...
 
void LIBNOVA_EXPORT ln_get_gal_from_equ (struct ln_equ_posn *equ, struct ln_gal_posn *gal)
 Transform an object equatorial coordinates into galactic coordinates. More...
 
void LIBNOVA_EXPORT ln_get_gal_from_equ2000 (struct ln_equ_posn *equ, struct ln_gal_posn *gal)
 Transform an object J2000 equatorial coordinates into galactic coordinates. More...
 

Detailed Description

Transformations from one coordinate system to another.

Function Documentation

void ln_get_ecl_from_equ ( struct ln_equ_posn object,
double  JD,
struct ln_lnlat_posn position 
)

Calculate ecliptical coordinates from equatorial coordinates.

Parameters
objectObject coordinates in B1950. Use ln_get_equ_prec2 to transform from J2000.
JDJulian day
positionPointer to store new position.

Transform an objects equatorial cordinates into ecliptical coordinates for the given julian day.

References ln_equ_posn::dec, ln_nutation::ecliptic, ln_lnlat_posn::lat, ln_deg_to_rad(), ln_get_nutation(), ln_rad_to_deg(), ln_range_degrees(), ln_lnlat_posn::lng, ln_nutation::longitude, and ln_equ_posn::ra.

void ln_get_ecl_from_rect ( struct ln_rect_posn rect,
struct ln_lnlat_posn posn 
)

Transform an objects rectangular coordinates into ecliptical coordinates.

Parameters
rectRectangular coordinates.
posnPointer to store new position.

Transform an objects rectangular coordinates into ecliptical coordinates.

References ln_lnlat_posn::lat, ln_rad_to_deg(), ln_range_degrees(), ln_lnlat_posn::lng, ln_rect_posn::X, ln_rect_posn::Y, and ln_rect_posn::Z.

void ln_get_equ2000_from_gal ( struct ln_gal_posn gal,
struct ln_equ_posn equ 
)

Transform an object galactic coordinate into J2000 equatorial coordinates.

Parameters
galGalactic coordinates.
equJ2000 equatorial coordinates.

Transform an object galactic coordinates into equatorial coordinate.

References ln_get_equ_from_gal(), and ln_get_equ_prec2().

void ln_get_equ_from_ecl ( struct ln_lnlat_posn object,
double  JD,
struct ln_equ_posn position 
)

Calculate equatorial coordinates from ecliptical coordinates.

Parameters
objectObject coordinates.
JDJulian day
positionPointer to store new position.

Transform an objects ecliptical coordinates into equatorial coordinates for the given julian day.

References ln_equ_posn::dec, ln_nutation::ecliptic, ln_lnlat_posn::lat, ln_deg_to_rad(), ln_get_nutation(), ln_rad_to_deg(), ln_range_degrees(), ln_lnlat_posn::lng, and ln_equ_posn::ra.

Referenced by ln_get_lunar_equ_coords_prec(), and ln_get_solar_equ_coords().

void ln_get_equ_from_gal ( struct ln_gal_posn gal,
struct ln_equ_posn equ 
)

Transform an object galactic coordinates into equatorial coordinates.

Parameters
galGalactic coordinates.
equB1950 equatorial coordinates. Use ln_get_equ_prec2 to transform to J2000.

Transform an object galactic coordinates into B1950 equatorial coordinate.

References ln_gal_posn::b, ln_equ_posn::dec, ln_gal_posn::l, ln_deg_to_rad(), ln_rad_to_deg(), ln_range_degrees(), and ln_equ_posn::ra.

Referenced by ln_get_equ2000_from_gal().

void ln_get_equ_from_hrz ( struct ln_hrz_posn object,
struct ln_lnlat_posn observer,
double  JD,
struct ln_equ_posn position 
)

Calculate equatorial coordinates from horizontal coordinates.

Parameters
objectObject coordinates.
observerObserver cordinates.
JDJulian day
positionPointer to store new position.

Transform an objects horizontal coordinates into equatorial coordinates for the given julian day and observers position.

Examples:
transforms.c.

References ln_hrz_posn::alt, ln_hrz_posn::az, ln_equ_posn::dec, ln_lnlat_posn::lat, ln_deg_to_rad(), ln_get_apparent_sidereal_time(), ln_rad_to_deg(), ln_range_degrees(), ln_lnlat_posn::lng, and ln_equ_posn::ra.

ln_get_gal_from_equ ( struct ln_equ_posn equ,
struct ln_gal_posn gal 
)

Transform an object equatorial coordinates into galactic coordinates.

Parameters
equB1950 equatorial coordinates.
galGalactic coordinates.

Transform an object B1950 equatorial coordinate into galactic coordinates.

References ln_gal_posn::b, ln_equ_posn::dec, ln_gal_posn::l, ln_deg_to_rad(), ln_rad_to_deg(), ln_range_degrees(), and ln_equ_posn::ra.

Referenced by ln_get_gal_from_equ2000().

void ln_get_gal_from_equ2000 ( struct ln_equ_posn equ,
struct ln_gal_posn gal 
)

Transform an object J2000 equatorial coordinates into galactic coordinates.

Parameters
equJ2000 equatorial coordinates.
galGalactic coordinates.

Transform an object J2000 equatorial coordinate into galactic coordinates.

References ln_get_equ_prec2(), and ln_get_gal_from_equ().

void ln_get_hrz_from_equ ( struct ln_equ_posn object,
struct ln_lnlat_posn observer,
double  JD,
struct ln_hrz_posn position 
)

Calculate horizontal coordinates from equatorial coordinates.

Parameters
objectObject coordinates.
observerObserver cordinates.
JDJulian day
positionPointer to store new position.

Transform an objects equatorial coordinates into horizontal coordinates for the given julian day and observers position.

0 deg azimuth = south, 90 deg = west.

Examples:
asteroid.c, and transforms.c.

References ln_get_hrz_from_equ_sidereal_time(), and ln_get_mean_sidereal_time().

void ln_get_rect_from_helio ( struct ln_helio_posn object,
struct ln_rect_posn position 
)