libnova  v 0.16.0
mars.c

Examples of how to use planetary functions.

/*
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU Library General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
Copyright (C) 2003 Liam Girdwood <lgirdwood@gmail.com>
A simple example showing some planetary calculations.
*/
#include <stdio.h>
#include <libnova/mars.h>
#include <libnova/julian_day.h>
#include <libnova/rise_set.h>
#include <libnova/transform.h>
#include <libnova/utility.h>
static void print_date(char *title, struct ln_zonedate *date)
{
fprintf(stdout, "\n%s\n",title);
fprintf(stdout, " Year : %d\n", date->years);
fprintf(stdout, " Month : %d\n", date->months);
fprintf(stdout, " Day : %d\n", date->days);
fprintf(stdout, " Hours : %d\n", date->hours);
fprintf(stdout, " Minutes : %d\n", date->minutes);
fprintf(stdout, " Seconds : %f\n", date->seconds);
}
int main(int argc, const char *argv[])
{
struct ln_helio_posn pos;
struct lnh_equ_posn hequ;
struct ln_equ_posn equ;
struct ln_rst_time rst;
struct ln_zonedate rise, set, transit;
struct ln_lnlat_posn observer;
double JD;
double au;
/* observers location (Edinburgh), used to calc rst */
observer.lat = 55.92; /* 55.92 N */
observer.lng = -3.18; /* 3.18 W */
/* get Julian day from local time */
fprintf(stdout, "JD %f\n", JD);
/* longitude, latitude and radius vector */
fprintf(stdout, "Mars L %f B %f R %f\n", pos.L, pos.B, pos.R);
/* RA, DEC */
ln_equ_to_hequ(&equ, &hequ);
fprintf(stdout, "Mars RA %d:%d:%f Dec %d:%d:%f\n",
hequ.ra.hours, hequ.ra.minutes, hequ.ra.seconds,
hequ.dec.degrees, hequ.dec.minutes, hequ.dec.seconds);
/* Earth - Mars dist AU */
fprintf(stdout, "mars -> Earth dist (AU) %f\n",au);
/* Sun - Mars Dist AU */
fprintf(stdout, "mars -> Sun dist (AU) %f\n",au);
/* Mars disk, magnitude and phase */
au = ln_get_mars_disk(JD);
fprintf(stdout, "mars -> illuminated disk %f\n",au);
fprintf(stdout, "mars -> magnitude %f\n",au);
fprintf(stdout, "mars -> phase %f\n",au);
/* rise, set and transit time */
if (ln_get_mars_rst(JD, &observer, &rst) != 0)
fprintf(stdout, "Mars is circumpolar\n");
else {
ln_get_local_date(rst.rise, &rise);
ln_get_local_date(rst.transit, &transit);
ln_get_local_date(rst.set, &set);
print_date("Rise", &rise);
print_date("Transit", &transit);
print_date("Set", &set);
}
return 0;
}
double ln_get_julian_from_sys()
Calculate julian day from system time.
Definition: julian_day.c:256
void LIBNOVA_EXPORT ln_equ_to_hequ(struct ln_equ_posn *pos, struct lnh_equ_posn *hpos)
human double equatorial position to human readable equatorial position
Definition: utility.c:345
void ln_get_mars_equ_coords(double JD, struct ln_equ_posn *position)
Calculate Mars equatorial coordinates.
Definition: mars.c:6538
double ln_get_mars_solar_dist(double JD)
Calculate the distance between Mars and the Sun.
Definition: mars.c:6692
void ln_get_mars_helio_coords(double JD, struct ln_helio_posn *position)
Calculate Mars heliocentric coordinates.
Definition: mars.c:6585
int ln_get_mars_rst(double JD, struct ln_lnlat_posn *observer, struct ln_rst_time *rst)
Calculate the time of rise, set and transit for Mars.
Definition: mars.c:6781
double ln_get_mars_earth_dist(double JD)
Calculate the distance between Mars and the Earth.
Definition: mars.c:6659
double ln_get_mars_disk(double JD)
Calculate the illuminated fraction of Mars disk.
Definition: mars.c:6731
double ln_get_mars_phase(double JD)
Calculate the phase angle of Mars.
Definition: mars.c:6753
double ln_get_mars_magnitude(double JD)
Calculate the visible magnitude of Mars.
Definition: mars.c:6709
Equatorial Coordinates.
Definition: ln_types.h:176
Heliocentric position.
Definition: ln_types.h:219
Ecliptical (or celestial) Longitude and Latitude.
Definition: ln_types.h:204
double lat
Definition: ln_types.h:206
Rise, Set and Transit times.
Definition: ln_types.h:314
Human readable Date and time with timezone information used by libnova.
Definition: ln_types.h:98
int minutes
Definition: ln_types.h:103
int months
Definition: ln_types.h:100
int hours
Definition: ln_types.h:102
int years
Definition: ln_types.h:99
int days
Definition: ln_types.h:101
double seconds
Definition: ln_types.h:104
Right Ascension and Declination.
Definition: ln_types.h:139