solaris-rs

Crates.iosolaris-rs
lib.rssolaris-rs
version0.1.0
sourcesrc
created_at2022-12-04 05:02:37.268548
updated_at2024-10-15 04:07:55.583302
descriptionA library to predict the position of the Sun
homepage
repositoryhttps://github.com/ctrlaltf2/solaris
max_upload_size
id729424
size190,717
Caleb (ctrlaltf2)

documentation

README


Solaris is a Rust library to efficiently predict the position of the Sun at any time and any location on Earth between the years 2017 and 2116.

Paper

Solaris is a clean-room Rust implementation of SolTrack (arXiv:2209.01557v1). The equations are simple enough to run efficently on embedded systems. The equations were verified by the authors to have high accuracy between 2017 and 2116. This library is an implementation of the paper based solely on the equations presented in the arXiv preprint.

Progress

Initial version is available at tag v0.1. Expect breaking API changes. Initial version verified against NASA Horizons System and were within acceptable ranges.

Validation

The library implementation will be validated using the same methods the paper presents as well as some extra validation. VSOP87 will be used as ground-truth in all tests.

Accuracy

  • What the paper authors did:
    • VSOP87 comparison: Position of sun seen from Arnhem, Netherlands near sunset/sunrise time
  • Further VSOP87 comparison:
    • Random lat/long/time: scale up # timepoints proportionally based on Sun's apparent motion

Further Steps

I intend to take the paper a bit further once I implement my own version in Rust. Most of the paper's optimizations center around dropping higher order terms from standard equations and measuring their effects on the system, effectively finding a local minima where accuracy vs. speed that was good enough to publish. I want to take this a bit further, and allow the number of higher order terms included to be configured at compile-time and on top of that, find other configurations that may compare to their paper in terms of accuracy vs. speed. Each configuration would be defined as the numbers of higher order terms to keep for each of the many sub-equations that make up the mathematical formulas.

Disclaimer

In addition to the disclaimers noted in the license, the author(s) of this are in no way associated with the authors of the SolTrack paper and make no claim to be.

FAQ

Why "Solaris"?

Predicting the position of three suns was done by Trisolaris, thus, the prediction of the position of just one sun must be done by none other than Solaris (it only makes sense!).

Citations

@misc{https://doi.org/10.48550/arxiv.2209.01557,
  doi       = {10.48550/ARXIV.2209.01557},
  url       = {https://arxiv.org/abs/2209.01557}, 
  author    = {van der Sluys, Marc and van Kan, Paul},
  keywords  = {Instrumentation and Methods for Astrophysics (astro-ph.IM), Computational Physics (physics.comp-ph), FOS: Physical sciences, FOS: Physical sciences},
  title     = {SolTrack: a free, fast and accurate routine to compute the position of the Sun},
  publisher = {arXiv},
  year      = {2022},
  copyright = {Creative Commons Attribution Non Commercial Share Alike 4.0 International}
}
Commit count: 21

cargo fmt