libnova  v 0.16.0
lunar.h
1 /*
2  * This library is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU Lesser General Public
4  * License as published by the Free Software Foundation; either
5  * version 2 of the License, or (at your option) any later version.
6  *
7  * This library is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
10  * Lesser General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software
14  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
15  *
16  * Copyright (C) 2000 - 2005 Liam Girdwood
17  */
18 
19 #ifndef _LN_LUNAR_H
20 #define _LN_LUNAR_H
21 
22 #include <libnova/ln_types.h>
23 
24 #define LN_LUNAR_STANDART_HORIZON 0.125
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
41 double LIBNOVA_EXPORT ln_get_lunar_sdiam(double JD);
42 
48 int LIBNOVA_EXPORT ln_get_lunar_rst(double JD, struct ln_lnlat_posn *observer,
49  struct ln_rst_time *rst);
50 
55 /* ELP 2000-82B theory */
56 void LIBNOVA_EXPORT ln_get_lunar_geo_posn(double JD, struct ln_rect_posn *moon,
57  double precision);
58 
63 void LIBNOVA_EXPORT ln_get_lunar_equ_coords_prec(double JD,
64  struct ln_equ_posn *position, double precision);
65 
70 void LIBNOVA_EXPORT ln_get_lunar_equ_coords(double JD,
71  struct ln_equ_posn *position);
72 
77 void LIBNOVA_EXPORT ln_get_lunar_ecl_coords(double JD,
78  struct ln_lnlat_posn *position, double precision);
79 
84 double LIBNOVA_EXPORT ln_get_lunar_phase(double JD);
85 
90 double LIBNOVA_EXPORT ln_get_lunar_disk(double JD);
91 
96 double LIBNOVA_EXPORT ln_get_lunar_earth_dist(double JD);
97 
102 double LIBNOVA_EXPORT ln_get_lunar_bright_limb(double JD);
103 
108 double LIBNOVA_EXPORT ln_get_lunar_long_asc_node(double JD);
109 
114 double LIBNOVA_EXPORT ln_get_lunar_long_perigee(double JD);
115 
120 double LIBNOVA_EXPORT ln_get_lunar_arg_latitude(double JD);
121 
126 void LIBNOVA_EXPORT ln_get_lunar_opt_libr_coords(double JD, struct ln_lnlat_posn *position);
127 
132 void LIBNOVA_EXPORT ln_get_lunar_subsolar_coords(double JD, struct ln_lnlat_posn *position);
133 
138 double LIBNOVA_EXPORT ln_lunar_next_phase(double jd, double phase);
139 
144 double LIBNOVA_EXPORT ln_lunar_previous_phase(double jd, double phase);
145 
150 double LIBNOVA_EXPORT ln_lunar_next_apsis(double jd, int apogee);
151 
156 double LIBNOVA_EXPORT ln_lunar_previous_apsis(double jd, int apogee);
157 
162 double LIBNOVA_EXPORT ln_lunar_next_node(double jd, int mode);
163 
168 double LIBNOVA_EXPORT ln_lunar_previous_node(double jd, int mode);
169 
170 #ifdef __cplusplus
171 };
172 #endif
173 
174 #endif
ln_get_solar_geom_coords
void LIBNOVA_EXPORT ln_get_solar_geom_coords(double JD, struct ln_helio_posn *position)
Calculate solar geometric coordinates.
Definition: solar.c:39
ln_rect_posn::Z
double Z
Definition: ln_types.h:242
ln_lnlat_posn::lng
double lng
Definition: ln_types.h:205
ln_lunar_previous_apsis
double ln_lunar_previous_apsis(double jd, int apogee)
Find previous moon apogee or perigee relative to given time expressed as Julian Day.
Definition: lunar.c:1604
ln_get_lunar_equ_coords
void ln_get_lunar_equ_coords(double JD, struct ln_equ_posn *position)
Calculate lunar equatorial coordinates.
Definition: lunar.c:1212
ln_get_lunar_equ_coords_prec
void ln_get_lunar_equ_coords_prec(double JD, struct ln_equ_posn *position, double precision)
Calculate lunar equatorial coordinates.
Definition: lunar.c:1195
ln_rst_time
Rise, Set and Transit times.
Definition: ln_types.h:314
ln_find_max
double LIBNOVA_EXPORT ln_find_max(double(*func)(double, double *), double from, double to, double *arg)
Find local maximum of function f() at given interval by Golden Section method.
Definition: utility.c:720
ln_rect_posn::X
double X
Definition: ln_types.h:240
ln_get_lunar_arg_latitude
double ln_get_lunar_arg_latitude(double JD)
Calculate the Moon's argument of latitude (mean distance of the Moon from its ascending node)
Definition: lunar.c:1429
ln_equ_posn::ra
double ra
Definition: ln_types.h:177
ln_get_lunar_bright_limb
double ln_get_lunar_bright_limb(double JD)
Calculate the position angle of the Moon's bright limb.
Definition: lunar.c:1319
ln_get_earth_solar_dist
double ln_get_earth_solar_dist(double JD)
Calculate the distance between Earth and the Sun.
Definition: earth.c:2772
ln_helio_posn
Heliocentric position.
Definition: ln_types.h:219
ln_lunar_previous_phase
double ln_lunar_previous_phase(double jd, double phase)
Find previous moon phase relative to given time expressed as Julian Day.
Definition: lunar.c:1551
ln_get_lunar_ecl_coords
void ln_get_lunar_ecl_coords(double JD, struct ln_lnlat_posn *position, double precision)
Calculate lunar ecliptical coordinates.
Definition: lunar.c:1227
ln_get_lunar_long_perigee
double ln_get_lunar_long_perigee(double JD)
Calculate the longitude of the Moon's mean perigee.
Definition: lunar.c:1408
ln_get_lunar_earth_dist
double ln_get_lunar_earth_dist(double JD)
Calculate the distance between the Earth and the Moon.
Definition: lunar.c:1251
ln_get_solar_equ_coords
void LIBNOVA_EXPORT ln_get_solar_equ_coords(double JD, struct ln_equ_posn *position)
Calculate apparent equatorial coordinates.
Definition: solar.c:56
ln_get_equ_from_ecl
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.
Definition: transform.c:198
arg
Definition: aberration.c:29
ln_deg_to_rad
double LIBNOVA_EXPORT ln_deg_to_rad(double degrees)
degrees to radians
Definition: utility.c:93
ln_find_zero
double LIBNOVA_EXPORT ln_find_zero(double(*func)(double, double *), double from, double to, double *arg)
Find zero of function f() at given interval by Newton method.
Definition: utility.c:692
ln_range_degrees
double LIBNOVA_EXPORT ln_range_degrees(double angle)
puts a large angle in the correct range 0 - 360 degrees
Definition: utility.c:237
ln_get_solar_ecl_coords
void LIBNOVA_EXPORT ln_get_solar_ecl_coords(double JD, struct ln_lnlat_posn *position)
Calculate apparent ecliptical coordinates.
Definition: solar.c:87
ln_get_lunar_rst
int ln_get_lunar_rst(double JD, struct ln_lnlat_posn *observer, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for the Moon.
Definition: lunar.c:1355
ln_range_radians
double LIBNOVA_EXPORT ln_range_radians(double angle)
puts a large angle in the correct range 0 - 2PI radians
Definition: utility.c:252
earth_pert
Definition: lunar-priv.h:10
ln_lunar_next_phase
double ln_lunar_next_phase(double jd, double phase)
Find next moon phase relative to given time expressed as Julian Day.
Definition: lunar.c:1526
ln_lnlat_posn::lat
double lat
Definition: ln_types.h:206
ln_get_lunar_opt_libr_coords
void ln_get_lunar_opt_libr_coords(double JD, struct ln_lnlat_posn *position)
Calculate selenographic optical libration coordinates.
Definition: lunar.c:1474
planet_pert
Definition: lunar-priv.h:20
ln_get_lunar_disk
double ln_get_lunar_disk(double JD)
Calculate the illuminated fraction of the Moons disk.
Definition: lunar.c:1298
ln_get_lunar_phase
double ln_get_lunar_phase(double JD)
Calculate the phase angle of the Moon.
Definition: lunar.c:1267
ln_lunar_next_node
double ln_lunar_next_node(double jd, int mode)
Find next moon node relative to given time expressed as Julian Day.
Definition: lunar.c:1632
ln_rect_posn::Y
double Y
Definition: ln_types.h:241
ln_lunar_previous_node
double ln_lunar_previous_node(double jd, int mode)
Find previous lunar node relative to given time expressed as Julian Day.
Definition: lunar.c:1655
ln_get_lunar_geo_posn
void ln_get_lunar_geo_posn(double JD, struct ln_rect_posn *moon, double precision)
Calculate the rectangular geocentric lunar cordinates.
Definition: lunar.c:1092
ln_rad_to_deg
double LIBNOVA_EXPORT ln_rad_to_deg(double radians)
radians to degrees
Definition: utility.c:87
ln_lunar_next_apsis
double ln_lunar_next_apsis(double jd, int apogee)
Find next moon apogee or perigee relative to given time expressed as Julian Day.
Definition: lunar.c:1576
ln_get_lunar_long_asc_node
double ln_get_lunar_long_asc_node(double JD)
Calculate the longitude of the Moon's mean ascending node.
Definition: lunar.c:1386
ln_lnlat_posn
Ecliptical (or celestial) Longitude and Latitude.
Definition: ln_types.h:204
ln_equ_posn
Equatorial Coordinates.
Definition: ln_types.h:176
ln_equ_posn::dec
double dec
Definition: ln_types.h:178
ln_get_body_rst_horizon
int LIBNOVA_EXPORT ln_get_body_rst_horizon(double JD, struct ln_lnlat_posn *observer, void(*get_equ_body_coords)(double, struct ln_equ_posn *), double horizon, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for an object a body, usually Sun, a planet or Moon.
Definition: rise_set.c:320
main_problem
Definition: lunar-priv.h:2
ln_rect_posn
Rectangular coordinates.
Definition: ln_types.h:239
ln_get_lunar_sdiam
double ln_get_lunar_sdiam(double JD)
Calculate the semidiameter of the Moon in arc seconds.
Definition: lunar.c:1370