Merge pull request #46 from JuliaSpaceMissionDesign/dev

Update to v1.2.1

Author: MicheleCeresoli

.github/workflows/ci.yml

@@ -3,7 +3,7 @@ on:
   - push
   - pull_request
 env:
-  JULIA_NUM_THREADS: 1
+  JULIA_NUM_THREADS: 4
 jobs:
   test:
     name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }} - ${{ github.event_name }}

Artifacts.toml

@@ -1,7 +1,7 @@
 [testdata]
-git-tree-sha1 = "b58880275ed655c31bcb6be63df686bc1539af6e"
-lazy = true
+git-tree-sha1 = "d97cce4a3c744330b363c292097a96a1aab69e6d"
+lazy = true 
 
     [[testdata.download]]
-    sha256 = "4fc7a9ef011b2f90379f5129e3015d30ff313dd0493724cec5c55fc560180e13"
-    url = "https://gist.github.com/MicheleCeresoli/ff9f8eeea149022b32979e94ef969d96/raw/b58880275ed655c31bcb6be63df686bc1539af6e.tar.gz"
+    sha256 = "4d8ca82289ffe9161cdb49b68b0a373b472fc393255544d5d43ca6ead1774baa"
+    url = "https://gist.github.com/MicheleCeresoli/141622fbf94e6da4c9fec7ff815192da/raw/d97cce4a3c744330b363c292097a96a1aab69e6d.tar.gz"

Project.toml

@@ -1,22 +1,22 @@
 name = "Ephemerides"
 uuid = "6a9c3322-c8fe-4c26-8ad6-14a6f8acd2a0"
 authors = ["JSMD Team"]
-version = "1.2.0"
+version = "1.2.1"
 
 [deps]
 JSMDInterfaces = "6b30ee2f-618e-4a15-bf4e-7df7b496e609"
 LazyArtifacts = "4af54fe1-eca0-43a8-85a7-787d91b784e3"
 Mmap = "a63ad114-7e13-5084-954f-fe012c677804"
 PreallocationTools = "d236fae5-4411-538c-8e31-a6e3d9e00b46"
 PrecompileTools = "aea7be01-6a6a-4083-8856-8a6e6704d82a"
-StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
+StaticArraysCore = "1e83bf80-4336-4d27-bf5d-d5a4f845583c"
 
 [compat]
 JSMDInterfaces = "1.4"
 LazyArtifacts = "1"
 PreallocationTools = "0.4"
 PrecompileTools = "1"
-StaticArrays = "1"
+StaticArraysCore = "1.4"
 julia = "1.7"
 
 [extras]

README.md

@@ -67,9 +67,9 @@ angles = ephem_rotation3(eph, 1, 31006, time)
 ```
 
 ## Current Limitations
-- The supported JPL binary SPK/PCK segments types are: 1, 2, 3, 8, 9, 12, 13, 14, 18, 19, 20, 21. 
+- The supported JPL binary SPK/PCK segments types are: 1, 2, 3, 5, 8, 9, 12, 13, 14, 15, 17, 18, 19, 20, 21. 
 - Binary INPOP kernels are not supported. 
-- Acceleration and jerk computations are natively unavailable for SPK segments of type 1 and 21, but can be computed with Automatic Differentiation (AD) of the position and velocity components.
+- Acceleration and jerk computations are natively unavailable for SPK segments of type 1, 5, 15, 17 and 21, but can be computed with Automatic Differentiation (AD) of the position and velocity components.
 
 ## Documentation 
 For further information on this package please refer to the [stable documentation](https://juliaspacemissiondesign.github.io/Ephemerides.jl/stable/)

docs/src/api/lapi.md

@@ -125,6 +125,13 @@ Ephemerides.SPKSegmentCache2
 Ephemerides.SPKSegmentType2
 ```
 
+### SPK Type 5
+```@docs 
+Ephemerides.SPKSegmentHeader5
+Ephemerides.SPKSegmentCache5
+Ephemerides.SPKSegmentType5
+```
+
 ### SPK Type 8 and 12
 ```@docs 
 Ephemerides.SPKSegmentHeader8
@@ -148,6 +155,27 @@ Ephemerides.SPKSegmentType14
 !!! note 
     SPK segments of type 14 have the same cache structure of SPK type 2 and 3.
 
+
+### SPK Type 15
+```@docs
+Ephemerides.SPKSegmentHeader15
+Ephemerides.SPKSegmentType15
+```
+
+!!! note 
+    The cache of SPK Type 15 segments is made of [`Ephemerides.TwoBodyUniversalCache`](@ref) objects.
+
+
+### SPK Type 17
+```@docs
+Ephemerides.SPKSegmentHeader17
+Ephemerides.SPKSegmentType17
+```
+
+!!! note 
+    SPK segments of type 17 do not require a cache structure.
+
+
 ### SPK Type 18 and 19
 ```@docs
 Ephemerides.SPKSegmentHeader18
@@ -181,8 +209,6 @@ Ephemerides.find_logical_record
 Ephemerides.get_coefficients!
 ```
 
-### Parsing 
-
 ## Interpolating Functions
 
 ### Caches 
@@ -227,5 +253,12 @@ Ephemerides.final_times
 Ephemerides.analyse_timespan 
 ```
 
+## TwoBody Routines 
+```@docs 
+Ephemerides.TwoBodyUniversalCache 
+Ephemerides.update_cache!
+Ephemerides.propagate_twobody
+Ephemerides.stumpff
+```
 
 

docs/src/index.md

@@ -62,6 +62,6 @@ angles = ephem_rotation3(eph, 1, 31006, time)
 ```
 
 ## Current Limitations
-- The supported JPL binary SPK/PCK segments types are: 1, 2, 3, 8, 9, 12, 13, 14, 18, 19, 20, 21. 
+- The supported JPL binary SPK/PCK segments types are: 1, 2, 3, 5, 8, 9, 12, 13, 14, 15, 17, 18, 19, 20, 21. 
 - Binary INPOP kernels are not supported. 
-- Acceleration and jerk computations are unavailable for SPK segments of type 1 and 21.
+- Acceleration and jerk computations are unavailable for SPK segments of type 1, 5, 15, 17 and 21.

docs/src/tutorials/load.md

@@ -2,7 +2,7 @@
 
 This tutorial will walk you through the basic features and interfaces that allow you to load binary ephemeris kernels.
 
-The supported sources of ephemerides are currently limited to binary PCK and SPK segments of type: 1, 2, 3, 8, 9, 12, 13, 18, 19, 20 and 21. 
+The supported sources of ephemerides are currently limited to binary PCK and SPK segments of type: 1, 2, 3, 5, 8, 9, 12, 13, 14, 15, 17, 18, 19, 20, and 21. 
 
 !!! note 
     Support for IMCCE INPOP ephemerides is yet to be implemented.

docs/src/tutorials/position.md

@@ -50,7 +50,7 @@ pvaj = ephem_vector12(eph, 3, 399, 0)
 In all these examples, the returned data is always in the form of a `StaticArray` in order to minimise memory allocations.
 
 !!! warning 
-    SPK segments of types 1 and 21 do not natively support acceleration and jerk computations. However, these values can be computed by Automatic Differentiation (AD) of the position and/or velocity components.
+    SPK segments of types 1 5, 15, 17 and 21 do not natively support acceleration and jerk computations. However, these values can be computed by Automatic Differentiation (AD) of the position and/or velocity components.
 
 
 ## Computing orientation angles

src/Ephemerides.jl

@@ -5,7 +5,7 @@ using LazyArtifacts
 using Mmap
 using PreallocationTools
 using PrecompileTools: PrecompileTools
-using StaticArrays
+using StaticArraysCore
 
 import JSMDInterfaces.Ephemeris as jEph
 
@@ -18,6 +18,9 @@ include("interp/hermite.jl")
 include("interp/lagrange.jl")
 include("interp/chebyshev.jl")
 
+# Twobody utilities 
+include("twobody.jl")
+
 # SPK segment types definitions
 include("spk/spktypes.jl")
 
@@ -27,9 +30,12 @@ include("daf.jl")
 # SPK segments implementations
 include("spk/spk1.jl")
 include("spk/spk2.jl")
+include("spk/spk5.jl")
 include("spk/spk8.jl")
 include("spk/spk9.jl")
 include("spk/spk14.jl")
+include("spk/spk15.jl")
+include("spk/spk17.jl")
 include("spk/spk18.jl")
 include("spk/spk19.jl")
 include("spk/spk20.jl")

src/daf.jl

@@ -588,25 +588,34 @@ function create_spk_segment(daf::DAF, desc::DAFSegmentDescriptor)
 
     mapped_spktype = SPK_SEGMENTLIST_MAPPING[segment_type(desc)]
     if mapped_spktype == 1
-        SPKSegmentType1(daf, desc)
+        SPKSegmentType2(daf, desc)
 
     elseif mapped_spktype == 2
-        SPKSegmentType2(daf, desc)
+        SPKSegmentType9(daf, desc)
 
     elseif mapped_spktype == 3 
-        SPKSegmentType8(daf, desc)
+        SPKSegmentType1(daf, desc)
 
     elseif mapped_spktype == 4 
-        SPKSegmentType9(daf, desc)
+        SPKSegmentType14(daf, desc)
 
     elseif mapped_spktype == 5
-        SPKSegmentType14(daf, desc)
+        SPKSegmentType15(daf, desc)
 
     elseif mapped_spktype == 6 
+        SPKSegmentType8(daf, desc)
+
+    elseif mapped_spktype == 7
         SPKSegmentType19(daf, desc)
 
-    else
+    elseif mapped_spktype == 8
         SPKSegmentType20(daf, desc)
+        
+    elseif mapped_spktype == 9
+        SPKSegmentType5(daf, desc)
+        
+    else 
+        SPKSegmentType17(daf, desc)
     end
 
 end