include/predict/predict.h

Go to the documentation of this file.

#ifndef _PREDICT_H_
#define _PREDICT_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <time.h>
#include <stdbool.h>

#define PREDICT_VERSION_MAJOR 1
#define PREDICT_VERSION_MINOR 0
#define PREDICT_VERSION_PATCH 0
#define PREDICT_VERSION (PREDICT_VERSION_MAJOR * 100 * 100 + PREDICT_VERSION_MINOR * 100 + PREDICT_VERSION_PATCH)
#define PREDICT_VERSION_STRING "1.0.0"
  
int predict_version_major();

int predict_version_minor();

int predict_version_patch();

int predict_version();

char *predict_version_string();

typedef double predict_julian_date_t;

predict_julian_date_t predict_to_julian(time_t time);

time_t predict_from_julian(predict_julian_date_t date);

typedef struct {
    double epoch;
    double xndt2o;
    double xndd6o;
    double bstar;
    double xincl;
    double xnodeo;
    double eo;
    double omegao;
    double xmo;
    double xno;
    int catnum;
    int elset;
    int revnum;
} predict_tle_t; 

enum predict_ephemeris {
  EPHEMERIS_SGP4 = 0,
  EPHEMERIS_SDP4 = 1,
  EPHEMERIS_SGP8 = 2,
  EPHEMERIS_SDP8 = 3
};

typedef struct {
    char name[128];

    predict_julian_date_t time;
    double position[3];
    double velocity[3];

    double latitude;
    double longitude;
    double altitude;
    int eclipsed;
    double eclipse_depth;
    enum predict_ephemeris ephemeris;
    char line1[70];
    char line2[70];
    predict_tle_t tle;

    int catnum;
    long setnum;
    char designator[10];
    int year;
    double refepoch;
    double incl;
    double raan;
    double eccn;
    double argper;
    double meanan;
    double meanmo;
    double drag;
    double nddot6;
    double bstar;
    int orbitnum;

    void *ephemeris_data;
} predict_orbit_t;


predict_orbit_t *predict_create_orbit(char *tle[]);

void predict_destroy_orbit(predict_orbit_t *orbit);

int predict_orbit(predict_orbit_t *x, predict_julian_date_t time);

bool predict_is_geostationary(const predict_orbit_t *x);

double predict_apogee(const predict_orbit_t *x);

double predict_perigee(const predict_orbit_t *x);

bool predict_aos_happens(const predict_orbit_t *x, double latitude);

bool predict_decayed(const predict_orbit_t *x);

bool predict_is_eclipsed(const predict_orbit_t *x);

double predict_eclipse_depth(const predict_orbit_t *x);

typedef struct {
    char name[128];
    double latitude;
    double longitude;
    double altitude;
} predict_observer_t;

struct predict_observation {
    predict_julian_date_t time;                       
    double azimuth;
    double azimuth_rate;
    double elevation;
    double elevation_rate;
    double range;                        
    double range_x, range_y, range_z; 
    double range_rate;      
};

predict_observer_t *predict_create_observer(const char *name, double lat, double lon, double alt);

void predict_destroy_observer(predict_observer_t *obs);

void predict_observe_orbit(const predict_observer_t *observer, const predict_orbit_t *orbit, struct predict_observation *obs);

void predict_observe_moon(const predict_observer_t *observer, predict_julian_date_t time, struct predict_observation *obs);

void predict_observe_sun(const predict_observer_t *observer, predict_julian_date_t time, struct predict_observation *obs);

predict_julian_date_t predict_next_aos(const predict_observer_t *observer, predict_orbit_t *orbit, predict_julian_date_t start_time);

predict_julian_date_t predict_next_los(const predict_observer_t *observer, predict_orbit_t *orbit, predict_julian_date_t start_time);

double predict_doppler_shift(const predict_observer_t *observer, const predict_orbit_t *orbit, double downlink_frequency);

double predict_squint_angle(const predict_observer_t *observer, const predict_orbit_t *orbit, double alon, double alat);

double predict_refraction(double el);

double predict_refraction_ext(double el, double pressure, double temp);

double predict_refraction_from_apparent(double apparent_el);

double predict_refraction_from_apparent_ext(double apparent_el, double pressure, double temp);

double predict_refraction_rate(double el, double el_rate);

double predict_refraction_rate_ext(double el, double el_rate, double pressure, double temp);

double predict_apparent_elevation(double el);

double predict_apparent_elevation_ext(double el, double pressure, double temp);

double predict_apparent_elevation_rate(double el, double el_rate);

double predict_apparent_elevation_rate_ext(double el, double el_rate, double pressure, double temp);

#ifdef __cplusplus
}
#endif

#endif //_PREDICT_H_