EphemerisSources.jl

EphemerisSources.jl: Idiomatic Ephemeris Sourcing and Parsing in Julia - Published in JOSS (2024)

https://github.com/juliaastro/ephemerissources.jl

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • Committers with academic emails
    1 of 5 committers (20.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

astrodynamics astronomy ephemerides ephemeris

Keywords from Contributors

pde interpretability meshing fluxes standardization
Last synced: 6 months ago · JSON representation

Repository

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

Basic Info
Statistics
  • Stars: 7
  • Watchers: 1
  • Forks: 1
  • Open Issues: 2
  • Releases: 20
Topics
astrodynamics astronomy ephemerides ephemeris
Created almost 2 years ago · Last pushed 9 months ago
Metadata Files
Readme License Code of conduct

README.md

Tests Documentation JOSS DOI <!-- CodeCov -->

🪐 EphemerisSources.jl

[!IMPORTANT]

The packages described in this documentation are not affiliated with or endorsed by NASA, JPL, Caltech, or any other organization! They are independently written packages by an astrodynamics hobbyist.

Installation

Choose one of the following, or manually install one or more of the sub-packages below.

julia pkg> add EphemerisSources

julia import Pkg Pkg.add("EphemerisSources")

Overview

This project contains several packages which ease the processes of ephemeris sourcing and parsing, and one top-level package: EphemerisSources.jl. For usage examples, and instructions, please see the project's stable documentation. Any potential new features for this package will be released very quickly after they are developed; the stable documentation will always track the in-development documentation closely.

Contributions

Currently, this project only supports the fetching and parsing of Cartesian state vectors from two ephemeris sources: NASA JPL's Generic Kernels, and NASA JPL's Horizons platform. In addition, EphemerisSources.jl is very new, and test coverage is another major opportunity for improvement. This project welcomes all contributions and comments. If you would like to help add tests or parsing for the two other common ephemeris formats — observer tables and osculating orbital elements — please add a comment in an issue! If you find bugs, want to request features, or if you have any other comments about the project's capabilities and code, please file an issue. Please treat all contributors with respect, as described in the project's Code of Conduct.

Packages

This repository includes the top-level documentation for several solar system ephemeris tools, all written with the Julia Programming Language. To learn more about how to use these tools, consult the documentation website.

| Package | Description | |--------------------|----------------------------------------------------| | EphemerisSources.jl | A top-level package which provides, and re-exports, names from HorizonsAPI, HorizonsEphemeris, SPICEKernels, and SPICEBodies. | | HorizonsAPI.jl | A precise JPL Horizons REST API client implementation, with keyword arguments for each acceptable parameter. | | HorizonsEphemeris.jl | Convenience wrappers around the JPL Horizons REST API. | | SPICEKernels.jl | All generic kernels exported as variable constants. | | SPICEBodies.jl | Idiomatic wrappers around SPICE and SPICE.jl methods. |

Paper

This repository holds a JOSS submission under paper/. The paper is published to as a pre-print to HTML, PDF, and Markdown on the gh-pages branch.

External Resources

Other Julia packages for interfacing with solar system ephemeris data are available, including the three external packages below. These are not affiliated with this repository, or this documentation's author.

| Package | Description | |---------------------------------------|---------------------------------| | HORIZONS.jl | Functions for spawning the telnet interface, and querying files. | | SPICE.jl | A Julia interface to the CSPICE library provided by NASA JPL. | | Ephemerides.jl | Ephemeris kernel reading and interpolation in pure Julia. |

Owner

  • Name: Julia Astro
  • Login: JuliaAstro
  • Kind: organization
  • Email: julia-astro@googlegroups.com

JOSS Publication

EphemerisSources.jl: Idiomatic Ephemeris Sourcing and Parsing in Julia
Published
October 10, 2024
Volume 9, Issue 102, Page 6914
Authors
Joseph D. Carpinelli ORCID
Independent Researcher, USA
Editor
Axel Donath ORCID
Tags
Astrodynamics Astronomy Astrophysics Ephemeris SPICE Horizons

GitHub Events

Total
  • Create event: 4
  • Commit comment event: 36
  • Release event: 3
  • Watch event: 6
  • Delete event: 1
  • Issue comment event: 49
  • Push event: 387
  • Pull request event: 15
  • Pull request review event: 4
  • Fork event: 1
Last Year
  • Create event: 4
  • Commit comment event: 36
  • Release event: 3
  • Watch event: 6
  • Delete event: 1
  • Issue comment event: 49
  • Push event: 387
  • Pull request event: 15
  • Pull request review event: 4
  • Fork event: 1

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 490
  • Total Committers: 5
  • Avg Commits per committer: 98.0
  • Development Distribution Score (DDS): 0.2
Past Year
  • Commits: 133
  • Committers: 3
  • Avg Commits per committer: 44.333
  • Development Distribution Score (DDS): 0.346
Top Committers
Name Email Commits
Joey Carpinelli j****y@l****s 392
Joey Carpinelli j****i@l****s 87
CompatHelper Julia c****y@j****g 9
github-actions[bot] 4****] 1
Warrick Ball W****l@b****k 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 11
  • Total pull requests: 44
  • Average time to close issues: 26 days
  • Average time to close pull requests: 10 days
  • Total issue authors: 4
  • Total pull request authors: 4
  • Average comments per issue: 25.55
  • Average comments per pull request: 0.07
  • Merged pull requests: 17
  • Bot issues: 0
  • Bot pull requests: 40
Past Year
  • Issues: 4
  • Pull requests: 27
  • Average time to close issues: 7 days
  • Average time to close pull requests: 10 days
  • Issue authors: 1
  • Pull request authors: 4
  • Average comments per issue: 2.25
  • Average comments per pull request: 0.11
  • Merged pull requests: 15
  • Bot issues: 0
  • Bot pull requests: 23
Top Authors
Issue Authors
  • andrew-saydjari (5)
  • cadojo (4)
  • tamasgal (1)
Pull Request Authors
  • github-actions[bot] (51)
  • cadojo (3)
  • icweaver (2)
  • warrickball (2)
Top Labels
Issue Labels
enhancement (1) help wanted (1) good first issue (1)
Pull Request Labels

Packages

  • Total packages: 6
  • Total downloads:
    • julia 33 total
  • Total dependent packages: 1
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 128
juliahub.com: EphemerisSourcesBase

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 3 Total
Rankings
Dependent repos count: 3.2%
Downloads: 3.3%
Average: 7.6%
Dependent packages count: 16.3%
Last synced: 6 months ago
juliahub.com: EphemerisSources

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 8
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 3 Total
Rankings
Dependent repos count: 3.2%
Downloads: 3.3%
Average: 12.4%
Forks count: 14.4%
Dependent packages count: 16.3%
Stargazers count: 24.8%
Last synced: 6 months ago
juliahub.com: HorizonsEphemeris

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 14
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 4 Total
Rankings
Dependent repos count: 9.8%
Dependent packages count: 38.7%
Average: 39.7%
Stargazers count: 55.0%
Forks count: 55.2%
Last synced: 6 months ago
juliahub.com: SPICEBodies

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 12 Total
Rankings
Dependent repos count: 10.2%
Dependent packages count: 37.8%
Average: 44.3%
Forks count: 54.3%
Stargazers count: 74.9%
Last synced: 6 months ago
juliahub.com: SPICEKernels

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 86
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 7 Total
Rankings
Dependent repos count: 9.8%
Dependent packages count: 38.3%
Average: 44.4%
Forks count: 54.6%
Stargazers count: 75.0%
Last synced: 7 months ago
juliahub.com: HorizonsAPI

Access HORIZONS and SPICE ephemeris sources with idiomatic Julia.

  • Versions: 6
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 4 Total
Rankings
Dependent repos count: 9.9%
Dependent packages count: 38.8%
Average: 44.9%
Forks count: 55.3%
Stargazers count: 75.6%
Last synced: 6 months ago

Dependencies

.github/workflows/Documentation.yml actions
  • actions/checkout v2 composite
  • julia-actions/cache v1 composite
  • julia-actions/setup-julia latest composite
.github/workflows/CompatHelper.yml actions
  • julia-actions/setup-julia v1 composite
.github/workflows/Paper.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v3 composite
  • quarto-dev/quarto-actions/render v2 composite
  • quarto-dev/quarto-actions/setup v2 composite
.github/workflows/Register.yml actions
  • peter-evans/commit-comment v3 composite
.github/workflows/SPICE.yml actions
  • actions/cache v1 composite
  • actions/checkout v3 composite
  • julia-actions/setup-julia v1 composite
  • peter-evans/create-pull-request v5 composite
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/Tests.yml actions
  • actions/cache v4 composite
  • actions/checkout v4 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v2 composite