libnova  v 0.15.0
solar.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_SOLAR_H
20 #define _LN_SOLAR_H
21 
22 #include <libnova/ln_types.h>
23 
24 #define LN_SOLAR_STANDART_HORIZON -0.8333
25 #define LN_SOLAR_CIVIL_HORIZON -6.0
26 #define LN_SOLAR_NAUTIC_HORIZON -12.0
27 #define LN_SOLAR_ASTRONOMICAL_HORIZON -18.0
28 
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
32 
45 int LIBNOVA_EXPORT ln_get_solar_rst_horizon (double JD, struct ln_lnlat_posn * observer, double horizon, struct ln_rst_time * rst);
46 
51 int LIBNOVA_EXPORT ln_get_solar_rst (double JD, struct ln_lnlat_posn * observer, struct ln_rst_time * rst);
52 
57 void LIBNOVA_EXPORT ln_get_solar_geom_coords (double JD, struct ln_helio_posn * position);
58 
63 void LIBNOVA_EXPORT ln_get_solar_equ_coords (double JD, struct ln_equ_posn * position);
64 
69 void LIBNOVA_EXPORT ln_get_solar_ecl_coords (double JD, struct ln_lnlat_posn * position);
70 
75 void LIBNOVA_EXPORT ln_get_solar_geo_coords (double JD, struct ln_rect_posn * position);
76 
81 double LIBNOVA_EXPORT ln_get_solar_sdiam (double JD);
82 
83 #ifdef __cplusplus
84 };
85 #endif
86 
87 #endif
ln_get_solar_geom_coords
void 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:241
ln_lnlat_posn::lng
double lng
Definition: ln_types.h:202
ln_rst_time
Rise, Set and Transit times.
Definition: ln_types.h:318
ln_rect_posn::X
double X
Definition: ln_types.h:239
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_get_solar_rst
int ln_get_solar_rst(double JD, struct ln_lnlat_posn *observer, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for the Sun.
Definition: solar.c:139
ln_get_solar_geo_coords
void ln_get_solar_geo_coords(double JD, struct ln_rect_posn *position)
Calculate geocentric coordinates (rectangular)
Definition: solar.c:116
ln_helio_posn
Heliocentric position.
Definition: ln_types.h:217
ln_get_solar_equ_coords
void 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:192
ln_get_nutation
void LIBNOVA_EXPORT ln_get_nutation(double JD, struct ln_nutation *nutation)
Calculate nutation.
Definition: nutation.c:189
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:234
ln_get_solar_ecl_coords
void ln_get_solar_ecl_coords(double JD, struct ln_lnlat_posn *position)
Calculate apparent ecliptical coordinates.
Definition: solar.c:87
ln_lnlat_posn::lat
double lat
Definition: ln_types.h:203
ln_helio_posn::R
double R
Definition: ln_types.h:220
ln_nutation::longitude
double longitude
Definition: ln_types.h:334
ln_rect_posn::Y
double Y
Definition: ln_types.h:240
ln_nutation
Nutation in longitude, ecliptic and obliquity.
Definition: ln_types.h:333
ln_get_solar_rst_horizon
int ln_get_solar_rst_horizon(double JD, struct ln_lnlat_posn *observer, double horizon, struct ln_rst_time *rst)
Return solar rise/set time over local horizon (specified in degrees).
Definition: solar.c:129
ln_helio_posn::B
double B
Definition: ln_types.h:219
ln_helio_posn::L
double L
Definition: ln_types.h:218
ln_lnlat_posn
Ecliptical (or celestial) Longitude and Latitude.
Definition: ln_types.h:201
ln_get_rect_from_helio
void LIBNOVA_EXPORT ln_get_rect_from_helio(struct ln_helio_posn *object, struct ln_rect_posn *position)
Calculate geocentric coordinates from heliocentric coordinates
Definition: transform.c:36
ln_equ_posn
Equatorial Coordinates.
Definition: ln_types.h:171
ln_get_earth_helio_coords
void ln_get_earth_helio_coords(double JD, struct ln_helio_posn *position)
Calculate Earth's heliocentric coordinates.
Definition: earth.c:2699
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:275
ln_get_solar_sdiam
double ln_get_solar_sdiam(double JD)
Calculate the semidiameter of the Sun in arc seconds.
Definition: solar.c:151
ln_rect_posn
Rectangular coordinates.
Definition: ln_types.h:238