libnova  v 0.16.0
hyperbolic_motion.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_HYPERBOLIC_MOTION_H
20 #define _LN_HYPERBOLIC_MOTION_H
21 
22 #include <libnova/ln_types.h>
23 
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
39 double LIBNOVA_EXPORT ln_solve_hyp_barker(double Q1, double G, double t);
40 
45 double LIBNOVA_EXPORT ln_get_hyp_true_anomaly(double q, double e, double t);
46 
51 double LIBNOVA_EXPORT ln_get_hyp_radius_vector(double q, double e, double t);
52 
57 void LIBNOVA_EXPORT ln_get_hyp_geo_rect_posn(struct ln_hyp_orbit *orbit,
58  double JD, struct ln_rect_posn *posn);
59 
60 
65 void LIBNOVA_EXPORT ln_get_hyp_helio_rect_posn(struct ln_hyp_orbit *orbit,
66  double JD, struct ln_rect_posn *posn);
67 
73 void LIBNOVA_EXPORT ln_get_hyp_body_equ_coords(double JD,
74  struct ln_hyp_orbit *orbit, struct ln_equ_posn *posn);
75 
81 double LIBNOVA_EXPORT ln_get_hyp_body_earth_dist(double JD,
82  struct ln_hyp_orbit *orbit);
83 
89 double LIBNOVA_EXPORT ln_get_hyp_body_solar_dist(double JD,
90  struct ln_hyp_orbit *orbit);
91 
96 double LIBNOVA_EXPORT ln_get_hyp_body_phase_angle(double JD,
97  struct ln_hyp_orbit *orbit);
98 
103 double LIBNOVA_EXPORT ln_get_hyp_body_elong(double JD,
104  struct ln_hyp_orbit *orbit);
105 
110 int LIBNOVA_EXPORT ln_get_hyp_body_rst(double JD,
111  struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit,
112  struct ln_rst_time *rst);
113 
118 int LIBNOVA_EXPORT ln_get_hyp_body_rst_horizon(double JD,
119  struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit,
120  double horizon, struct ln_rst_time *rst);
121 
126 int LIBNOVA_EXPORT ln_get_hyp_body_next_rst(double JD,
127  struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit,
128  struct ln_rst_time *rst);
129 
134 int LIBNOVA_EXPORT ln_get_hyp_body_next_rst_horizon(double JD,
135  struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit,
136  double horizon, struct ln_rst_time *rst);
137 
142 int LIBNOVA_EXPORT ln_get_hyp_body_next_rst_horizon_future(double JD,
143  struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit,
144  double horizon, int day_limit, struct ln_rst_time *rst);
145 
146 #ifdef __cplusplus
147 };
148 #endif
149 
150 #endif
double LIBNOVA_EXPORT ln_get_hyp_body_earth_dist(double JD, struct ln_hyp_orbit *orbit)
Calculate the distance between a body and the Earth.
Definition: hyperbolic_motion.c:257
Rectangular coordinates.
Definition: ln_types.h:239
int LIBNOVA_EXPORT ln_get_hyp_body_rst(double JD, struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for a body with a hyperbolic orbit.
Definition: hyperbolic_motion.c:360
int LIBNOVA_EXPORT ln_get_hyp_body_next_rst_horizon(double JD, struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit, double horizon, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for a body with an hyperbolic orbit.
Definition: hyperbolic_motion.c:427
Equatorial Coordinates.
Definition: ln_types.h:176
Hyperbolic Orbital elements.
Definition: ln_types.h:297
int LIBNOVA_EXPORT ln_get_hyp_body_next_rst_horizon_future(double JD, struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit, double horizon, int day_limit, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for a body with an hyperbolic orbit.
Definition: hyperbolic_motion.c:452
double LIBNOVA_EXPORT ln_solve_hyp_barker(double Q1, double G, double t)
Solve Barkers equation.
Definition: hyperbolic_motion.c:46
void LIBNOVA_EXPORT ln_get_hyp_body_equ_coords(double JD, struct ln_hyp_orbit *orbit, struct ln_equ_posn *posn)
Calculate a bodies equatorial coordinates.
Definition: hyperbolic_motion.c:221
void LIBNOVA_EXPORT ln_get_hyp_geo_rect_posn(struct ln_hyp_orbit *orbit, double JD, struct ln_rect_posn *posn)
Calculate an objects rectangular geocentric position.
Definition: hyperbolic_motion.c:195
Ecliptical (or celestial) Longitude and Latitude.
Definition: ln_types.h:204
Rise, Set and Transit times.
Definition: ln_types.h:314
double LIBNOVA_EXPORT ln_get_hyp_radius_vector(double q, double e, double t)
Calculate the radius vector.
Definition: hyperbolic_motion.c:125
void LIBNOVA_EXPORT ln_get_hyp_helio_rect_posn(struct ln_hyp_orbit *orbit, double JD, struct ln_rect_posn *posn)
Calculate an objects rectangular heliocentric position.
Definition: hyperbolic_motion.c:139
double LIBNOVA_EXPORT ln_get_hyp_body_elong(double JD, struct ln_hyp_orbit *orbit)
Calculate the bodies elongation to the Sun.
Definition: hyperbolic_motion.c:327
int LIBNOVA_EXPORT ln_get_hyp_body_next_rst(double JD, struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for a body with an hyperbolic orbit.
Definition: hyperbolic_motion.c:404
double LIBNOVA_EXPORT ln_get_hyp_body_solar_dist(double JD, struct ln_hyp_orbit *orbit)
Calculate the distance between a body and the Sun.
Definition: hyperbolic_motion.c:279
double LIBNOVA_EXPORT ln_get_hyp_true_anomaly(double q, double e, double t)
Calculate the true anomaly.
Definition: hyperbolic_motion.c:103
double LIBNOVA_EXPORT ln_get_hyp_body_phase_angle(double JD, struct ln_hyp_orbit *orbit)
Calculate the phase angle of the body.
Definition: hyperbolic_motion.c:300
int LIBNOVA_EXPORT ln_get_hyp_body_rst_horizon(double JD, struct ln_lnlat_posn *observer, struct ln_hyp_orbit *orbit, double horizon, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for a body with a hyperbolic orbit.
Definition: hyperbolic_motion.c:381