libnova  v 0.16.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,
46  struct ln_lnlat_posn *observer, double horizon, struct ln_rst_time *rst);
47 
52 int LIBNOVA_EXPORT ln_get_solar_rst(double JD, struct ln_lnlat_posn *observer,
53  struct ln_rst_time *rst);
54 
59 void LIBNOVA_EXPORT ln_get_solar_geom_coords(double JD,
60  struct ln_helio_posn *position);
61 
66 void LIBNOVA_EXPORT ln_get_solar_equ_coords(double JD,
67  struct ln_equ_posn *position);
68 
73 void LIBNOVA_EXPORT ln_get_solar_ecl_coords(double JD,
74  struct ln_lnlat_posn *position);
75 
80 void LIBNOVA_EXPORT ln_get_solar_geo_coords(double JD,
81  struct ln_rect_posn *position);
82 
87 double LIBNOVA_EXPORT ln_get_solar_sdiam(double JD);
88 
89 #ifdef __cplusplus
90 };
91 #endif
92 
93 #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:242
ln_lnlat_posn::lng
double lng
Definition: ln_types.h:205
ln_rst_time
Rise, Set and Transit times.
Definition: ln_types.h:314
ln_rect_posn::X
double X
Definition: ln_types.h:240
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:141
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:219
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:198
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:237
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:206
ln_helio_posn::R
double R
Definition: ln_types.h:222
ln_nutation::longitude
double longitude
Definition: ln_types.h:329
ln_rect_posn::Y
double Y
Definition: ln_types.h:241
ln_nutation
Nutation in longitude, ecliptic and obliquity.
Definition: ln_types.h:328
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:221
ln_helio_posn::L
double L
Definition: ln_types.h:220
ln_lnlat_posn
Ecliptical (or celestial) Longitude and Latitude.
Definition: ln_types.h:204
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:176
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:320
ln_get_solar_sdiam
double ln_get_solar_sdiam(double JD)
Calculate the semidiameter of the Sun in arc seconds.
Definition: solar.c:155
ln_rect_posn
Rectangular coordinates.
Definition: ln_types.h:239