libnova  v 0.16.0
saturn.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_SATURN_H
20 #define _LN_SATURN_H
21 
22 #include <libnova/ln_types.h>
23 
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
39 double LIBNOVA_EXPORT ln_get_saturn_equ_sdiam(double JD);
40 
45 double LIBNOVA_EXPORT ln_get_saturn_pol_sdiam(double JD);
46 
51 int LIBNOVA_EXPORT ln_get_saturn_rst(double JD, struct ln_lnlat_posn *observer,
52  struct ln_rst_time *rst);
53 
58 /* Chapter 31 Pg 206-207 Equ 31.1 31.2 , 31.3 using VSOP 87 */
59 void LIBNOVA_EXPORT ln_get_saturn_helio_coords(double JD,
60  struct ln_helio_posn *position);
61 
66 /* Chapter 31 Pg 206-207 Equ 31.1 31.2 , 31.3 using VSOP 87 */
67 void LIBNOVA_EXPORT ln_get_saturn_equ_coords(double JD,
68  struct ln_equ_posn *position);
69 
75 /* Chapter ?? */
76 double LIBNOVA_EXPORT ln_get_saturn_earth_dist(double JD);
77 
83 /* Chapter ?? */
84 double LIBNOVA_EXPORT ln_get_saturn_solar_dist(double JD);
85 
91 /* Chapter ?? */
92 double LIBNOVA_EXPORT ln_get_saturn_magnitude(double JD);
93 
99 /* Chapter 41 */
100 double LIBNOVA_EXPORT ln_get_saturn_disk(double JD);
101 
107 /* Chapter 41 */
108 double LIBNOVA_EXPORT ln_get_saturn_phase(double JD);
109 
114 void LIBNOVA_EXPORT ln_get_saturn_rect_helio(double JD,
115  struct ln_rect_posn *position);
116 
117 #ifdef __cplusplus
118 };
119 #endif
120 
121 #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_get_saturn_rst
int ln_get_saturn_rst(double JD, struct ln_lnlat_posn *observer, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for Saturn.
Definition: saturn.c:6742
ln_get_saturn_disk
double ln_get_saturn_disk(double JD)
Calculate the illuminated fraction of Saturn's disk.
Definition: saturn.c:6694
ln_rect_posn::Z
double Z
Definition: ln_types.h:242
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_equ_posn::ra
double ra
Definition: ln_types.h:177
ln_get_saturn_equ_sdiam
double ln_get_saturn_equ_sdiam(double JD)
Calculate the equatorial semidiameter of Saturn in arc seconds.
Definition: saturn.c:6756
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_saturn_magnitude
double ln_get_saturn_magnitude(double JD)
Calculate the visible magnitude of Saturn.
Definition: saturn.c:6673
ln_get_saturn_phase
double ln_get_saturn_phase(double JD)
Calculate the phase angle of Saturn.
Definition: saturn.c:6715
ln_get_saturn_pol_sdiam
double ln_get_saturn_pol_sdiam(double JD)
Calculate the polar semidiameter of Saturn in arc seconds.
Definition: saturn.c:6773
ln_helio_posn
Heliocentric position.
Definition: ln_types.h:219
ln_get_saturn_helio_coords
void ln_get_saturn_helio_coords(double JD, struct ln_helio_posn *position)
Calculate Saturn's heliocentric coordinates.
Definition: saturn.c:6548
ln_get_saturn_equ_coords
void ln_get_saturn_equ_coords(double JD, struct ln_equ_posn *position)
Calculate Saturn's equatorial coordinates.
Definition: saturn.c:6502
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_vsop
Definition: vsop87.h:43
ln_helio_posn::R
double R
Definition: ln_types.h:222
ln_get_saturn_solar_dist
double ln_get_saturn_solar_dist(double JD)
Calculate the distance between Saturn and the Sun.
Definition: saturn.c:6655
ln_rect_posn::Y
double Y
Definition: ln_types.h:241
ln_vsop87_to_fk5
void LIBNOVA_EXPORT ln_vsop87_to_fk5(struct ln_helio_posn *position, double JD)
Transform from VSOP87 to FK5 reference system.
Definition: vsop87.c:49
ln_helio_posn::B
double B
Definition: ln_types.h:221
ln_rad_to_deg
double LIBNOVA_EXPORT ln_rad_to_deg(double radians)
radians to degrees
Definition: utility.c:87
ln_get_saturn_earth_dist
double ln_get_saturn_earth_dist(double JD)
Calculate the distance between Saturn and the Earth.
Definition: saturn.c:6622
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_equ_posn::dec
double dec
Definition: ln_types.h:178
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_rect_posn
Rectangular coordinates.
Definition: ln_types.h:239