api.h

Go to the documentation of this file.

 
#pragma once
 
#include "libgravix2/libgravix2_export.h"
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
GRVX_EXPORT const char *grvx_version(void);
 
struct GrvxPlanets;
 
typedef struct GrvxPlanets *GrvxPlanetsHandle;
 
struct GrvxTrajectory {
    double x[100][3]; 
    double v[100][3]; 
};
 
GRVX_EXPORT GrvxPlanetsHandle grvx_new_planets(uint32_t n);
 
GRVX_EXPORT void grvx_delete_planets(GrvxPlanetsHandle handle);
 
GRVX_EXPORT uint32_t grvx_count_planets(GrvxPlanetsHandle handle);
 
GRVX_EXPORT int32_t grvx_set_planet(GrvxPlanetsHandle handle,
                                    uint32_t i,
                                    double lat,
                                    double lon);
 
GRVX_EXPORT int32_t grvx_get_planet(GrvxPlanetsHandle handle,
                                    uint32_t i,
                                    double *lat,
                                    double *lon);
 
GRVX_EXPORT uint32_t grvx_pop_planet(GrvxPlanetsHandle handle);
 
typedef struct GrvxTrajectory *GrvxTrajectoryBatch;
 
GRVX_EXPORT GrvxTrajectoryBatch grvx_new_missiles(uint32_t n);
 
GRVX_EXPORT void grvx_delete_missiles(GrvxTrajectoryBatch batch);
 
GRVX_EXPORT struct GrvxTrajectory *
grvx_get_trajectory(GrvxTrajectoryBatch batch, uint32_t i);
 
GRVX_EXPORT int32_t grvx_init_missile(struct GrvxTrajectory *trj,
                                      double lat,
                                      double lon,
                                      double v,
                                      double dlat,
                                      double dlon);
 
GRVX_EXPORT int32_t grvx_launch_missile(struct GrvxTrajectory *trj,
                                        GrvxPlanetsHandle planets_handle,
                                        uint32_t planet_id,
                                        double v_abs,
                                        double psi);
 
GRVX_EXPORT uint32_t grvx_propagate_missile(struct GrvxTrajectory *trj,
                                            GrvxPlanetsHandle planets,
                                            double h,
                                            int32_t *premature);
 
GRVX_EXPORT double grvx_lat(double z);
 
GRVX_EXPORT double grvx_lon(double x, double y);
 
GRVX_EXPORT double
grvx_vlat(double vx, double vy, double vz, double lat, double lon);
 
GRVX_EXPORT double grvx_vlon(double vx, double vy, double vz, double lon);
 
GRVX_EXPORT double grvx_v_esc(void);
 
GRVX_EXPORT double grvx_v_scrcl(double r);
 
GRVX_EXPORT double grvx_orb_period(double v0, double h);
 
GRVX_EXPORT void grvx_perturb_measurement(GrvxPlanetsHandle planets_handle,
                                          uint32_t planet_id,
                                          double angular_error,
                                          double *lat,
                                          double *lon);
 
struct GrvxConfig {
    const char *pot_type;
 
    int32_t n_pot;
 
    int32_t trajectory_size;
 
    int32_t int_steps;
 
    double min_dist;
 
    const char *composition_scheme;
 
    int32_t n_stages;
};
 
GRVX_EXPORT struct GrvxConfig *grvx_get_config(void);
 
GRVX_EXPORT void grvx_free_config(struct GrvxConfig *cfg);
 
#ifdef __cplusplus
} // extern "C"
#endif
 // end of group API