Welcome to spv-rs!

This crate is a set of functions for either extracting or manipulating astronomcial data. However it is (at least for now) mainly focused on position and velocity data.

Examples

First if you want to see a calculator like application usecase please check the sourcecode for the SPV gui utility at SPV github repo.

Now we will look at the position function as an example: For the [position::position] function we use three input variables. Parallax for the distance to the object, you can read more about parallax here. Right ascension and Declination is basically a dots position on a sphere where the distance we get from the Parllax is the radius of the sphere.

One easy way to use this function if you had the required variables would be like this:

use spv_rs::position::position;
use glam::f64::DVec3;

fn main() {
    let parallax = 1.5_f64;
    let right_ascension = 35.8_f64;
    let declination = 67.3_f64;

    let body_name = "x";

    let position = position(parallax, right_ascension, declination).to_array();

    println!("The body {} was at the position x: {}, y: {}, z: {} at epoch J2000",
    body_name, position[0], position[1], position[2]);
}

The same general principles apply to most functions.

Extra

Feel free to propose additions/changes, file issues and or help with the project over on GitHub!