satkit 0.3.0__tar.gz → 0.3.2__tar.gz

{satkit-0.3.0 → satkit-0.3.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "satkit"
-version = "0.3.0"
+version = "0.3.2"
 edition = "2021"
 description = "Satellite Toolkit"
 readme = "README.md"
@@ -20,23 +20,25 @@ name = "satkit"
 
 
 [dependencies]
-nalgebra = "0.33.0"
-ndarray = "0.15.6"
-libc = "0.2"
+nalgebra = { version = "0.33.0", features = ["serde-serialize"] }
+ndarray = "0.15.4"
+libc = "0.2.158"
 chrono = "0.4.19"
 cty = "0.2.2"
 num-traits = "0.2"
-thiserror = "1.0"
+thiserror = "1.0.63"
 simba = "0.9"
 once_cell = "1.6.0"
 numpy = { version = "0.21.0", optional = true }
 pyo3 = { version = "0.21", features = ["extension-module"], optional = true }
-ureq = "2.9.1"
+ureq = "2.10.1"
 json = "0.12.4"
 process_path = "0.1.4"
+serde = { version = "1.0.130", features = ["derive"] }
+serde-pickle = "1.1.1"
 
 [build-dependencies]
-cc = { version = "1.0.74", features = ["parallel"] }
+cc = { version = "1.1.15", features = ["parallel"] }
 chrono = "0.4.38"
 pyo3-build-config = { version = "0.21", optional = true }
 

{satkit-0.3.0/python/satkit.egg-info → satkit-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: satkit
-Version: 0.3.0
+Version: 0.3.2
 Summary: Satellite Orbital Dynamics Toolkit
 Author-email: Steven Michael <ssmichael@gmail.com>
 Maintainer-email: Steven Michael <ssmichael@gmail.com>

{satkit-0.3.0 → satkit-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "satkit"
-version = "0.3.0"
+version = "0.3.2"
 dependencies = ["numpy>=1.20.0"]
 requires-python = ">= 3.8"
 authors = [{ name = "Steven Michael", email = "ssmichael@gmail.com" }]

{satkit-0.3.0 → satkit-0.3.2}/python/satkit/__init__.pyi

@@ -5,7 +5,6 @@ from . import jplephem
 from . import frametransform
 from . import moon
 from . import sun
-from . import satprop
 from . import density
 from . import utils
 from . import planets
@@ -30,8 +29,13 @@ __all__ = [
     "moon",
     "sun",
     "planets",
-    "satprop",
     "satstate",
     "density",
     "utils",
+    "propagate", 
+    "propsettings",
+    "satproperties_static",
+    "propresult", 
+    "propstats",
+    "satstate",
 ]

{satkit-0.3.0 → satkit-0.3.2}/python/satkit/satkit.pyi

@@ -1490,9 +1490,213 @@ class satstate:
         Args:
             time (satkit.time|satkit.duration): Time or duration from current time to which to propagate the state
 
-        Keyword Arguments:
-            propsettings: satkit.satprop.propsettings object describing settings to use in the propagation. If omitted, default is used 
+        Keyword Args:
+            propsettings: satkit.propsettings object describing settings to use in the propagation. If omitted, default is used 
 
         Returns:
             satstate: New satellite state object representing the state at the new time
-        """
+        """
+
+class propstats:
+    @property
+    def num_eval() -> int:
+        """Number of function evaluations"""
+
+    @property
+    def num_accept() -> int:
+        """Number of accepted steps in adaptive RK integrator"""
+
+    @property
+    def num_reject() -> int:
+        """Number of rejected steps in adaptive RK integrator"""
+
+class propresult:
+    """Results of a satellite propagation
+    
+    This class lets the user access results of the satellite propagation
+    """
+
+    @property
+    def pos() -> npt.ArrayLike[float]:
+        """GCRF position of satellite, meters"""
+
+    @property
+    def vel() -> npt.ArrayLike[float]:
+        """GCRF velocity of satellite, meters/second"""
+
+    @property
+    def state() -> npt.ArrayLike[float]:
+        """6-element state (pos + vel) of satellite in meters & meters/second"""
+
+    @property
+    def time() -> satkit.time:
+        """Time at which state is valid"""
+
+    @property
+    def stats() -> propstats:
+        """Statistics of propagation"""
+
+    @property
+    def phi() -> npt.ArrayLike[np.float64]|None:
+        """6x6 State transition matrix 
+        or None if not computed
+        """        
+
+    def interp(time: satkit.time, output_phi: bool=False) -> npt.ArrayLike[np.float64]|typing.Tuple[npt.ArrayLike[np.float64], npt.ArrayLike[np.float64]]:
+        """Interpolate state at given time
+
+        Args:
+            time (satkit.time): Time at which to interpolate state
+
+        Keyword Arguments:
+            output_phi (bool): Output 6x6 state transition matrix at the interpolated time
+
+        Returns:
+            6-element vector representing state at given time
+            if output_phi, also output 6x6 state transition matrix at given time
+        """
+    
+
+class satproperties_static:
+    """Satellite properties relevant for drag and radiation pressure
+
+    This class lets the satellite radiation pressure and drag
+    paramters be set to static values for duration of propagation
+    """
+
+    def __init__(self, *args, **kwargs):
+        """Create a satproperties_static object with given craoverm and cdaoverm in m^2/kg
+
+        Args:
+            cdaroverm (float): Coefficient of drag times area over mass in m^2/kg
+            craoverm (float): Coefficient of radiation pressure times area over mass in m^2/kg
+        
+        Keyword Arguments:
+            craoverm (float): Coefficient of radiation pressure times area over mass in m^2/kg
+            cdaoverm (float): Coefficient of drag times area over mass in m^2/kg
+
+
+        Notes:
+        The two arguments can be passed as positional arguments or as keyword arguments
+            
+        Example:
+
+        >>> properties = satproperties_static(craoverm = 0.5, cdaoverm = 0.4)
+        
+        or with same output
+        
+        >>> properties = satproperties_static(0.5, 0.4)
+
+        """
+
+        @property
+        def cdaoverm() -> float:
+            """Coeffecient of drag times area over mass.  Units are m^2/kg
+            """
+
+        @property
+        def craoverm() -> float:
+            """Coefficient of radiation pressure times area over mass.  Units are m^2/kg
+            """
+
+
+class propsettings:
+    """This class contains settings used in the high-precision orbit propgator part of the "satkit" python toolbox
+    """
+
+    def __init__(self):
+        """ Create default propsetting object
+
+        Notes:
+            * Default settings:
+                * abs_error: 1e-8
+                * rel_error: 1e-8
+                * gravity_order: 4
+                * use_spaceweather: True
+                * use_jplephem: True
+
+
+        Returns:
+            propsettings: New propsettings object with default settings
+        """
+
+    @property
+    def abs_error() -> float:
+        """Maxmum absolute value of error for any element in propagated state following ODE integration
+
+        Default: 1e-8
+        """
+
+    @property
+    def rel_error() -> float:
+        """Maximum relative error of any element in propagated state following ODE integration
+
+        Default: 1e-8
+        """
+
+    @property
+    def gravity_order() -> int:
+        """Earth gravity order to use in ODE integration
+
+        Default: 4
+        """
+
+    @property
+    def use_spaceweather() -> bool:
+        """Use space weather data when computing atmospheric density for drag forces
+
+        Default: true
+
+        Notes:
+            * Space weather data can have a large effect on the density of the atmosphere
+            * This can be important for accurate drag force calculations
+            * Space weather data is updated every 3 hours.  Most-recent data can be downloaded with ``satkit.utils.update_datafiles()``
+
+        """
+
+    @property
+    def use_jplephem() -> bool:
+        """Use high-precision but computationally expensive JPL ephemerides for sun and mun when computing their gravitational force
+        """
+
+def propagate(
+    pos: npt.ArrayLike[float],
+    vel: npt.ArrayLike[float],
+    start: time,
+    **kwargs,
+) -> propresult:
+    """High-precision orbit propagator
+
+    Notes:
+        * Propagator uses advanced Runga-Kutta integrators and includes the following forces:
+            * Earth gravity with higher-order zonal terms
+            * Sun, Moon gravity
+            * Radiation pressure
+            * Atmospheric drag: NRL-MISE 2000 density model, with option to include space weather effects (can be large)
+        * Stop time must be set by keyword argument, either explicitely or by duration
+        * Solid Earth tides are not (yet) included in the model
+
+
+    Propagate statellite ephemeris (position, velocity in gcrs & time) to new time
+    and output new position and velocity via Runge-Kutta integration.
+
+    Inputs and outputs are all in the Geocentric Celestial Reference Frame (GCRF)
+
+    Args:
+        pos (npt.ArrayLike[float]): 3-element numpy array representing satellite GCRF position in meters
+        vel (npt.ArrayLike[float]): 3-element numpy array representing satellite GCRF velocity in m/s
+        tm (satkit.time): satkit.time object representing instant at which satellite is at "pos" & "vel"
+
+    Keyword Args: 
+        stop_time (satkit.time): satkit.time object representing instant at which new position and velocity will be computed
+        duration_secs (float): duration in seconds from "tm" for at which new position and velocity will be computed.
+        duration_days (float): duration in days from "tm" at which new position and velocity will be computed.
+        duration (satkit.duration): duration from "tm" at which new position & velocity will be computed.
+        output_phi (bool): Output 6x6 state transition matrix between "starttime" and "stoptime" (and at intervals, if specified)
+        propsettings (propsettings): "propsettings" object with input settings for the propagation. if left out, default will be used.
+        satproperties (satproperties_static): "SatPropertiesStatic" object with drag and radiation pressure succeptibility of satellite. If left out, drag and radiation pressure are neglected
+        output_dense: boolean indicting whether or not dense output should be recorded.  Default is false.  If true, this will allow for calling the "interp" function to query states at arbitrary times between the start time and the stop time
+
+    Returns:
+        (propresult): Propagation result object holding state outputs, statistics, and dense output if requested
+    """

{satkit-0.3.0 → satkit-0.3.2}/python/satkit/satprop.pyi

@@ -228,17 +228,15 @@ def propagate(
         vel (npt.ArrayLike[float]): 3-element numpy array representing satellite GCRF velocity in m/s
         tm (satkit.time): satkit.time object representing instant at which satellite is at "pos" & "vel"
 
-    Keyword Arguments:
+    Keyword Args: 
         stop_time (satkit.time): satkit.time object representing instant at which new position and velocity will be computed
         duration_secs (float): duration in seconds from "tm" for at which new position and velocity will be computed.
         duration_days (float): duration in days from "tm" at which new position and velocity will be computed.
         duration (satkit.duration): duration from "tm" at which new position & velocity will be computed.
         output_phi (bool): Output 6x6 state transition matrix between "starttime" and "stoptime" (and at intervals, if specified)
         propsettings (propsettings): "propsettings" object with input settings for the propagation. if left out, default will be used.
-        satproperties (satproperties_static): "SatPropertiesStatic" object with drag and radiation pressure succeptibility of satellite. 
-                                            If left out, drag and radiation pressure are neglected
-        output_dense: boolean indicting whether or not dense output should be recorded.  Default is false.  If true, this will allow for calling the "interp" function
-                      to query states at arbitrary times between the start time and the stop time
+        satproperties (satproperties_static): "SatPropertiesStatic" object with drag and radiation pressure succeptibility of satellite. If left out, drag and radiation pressure are neglected
+        output_dense: boolean indicting whether or not dense output should be recorded.  Default is false.  If true, this will allow for calling the "interp" function to query states at arbitrary times between the start time and the stop time
 
     Returns:
         (propresult): Propagation result object holding state outputs, statistics, and dense output if requested

{satkit-0.3.0 → satkit-0.3.2}/python/satkit/utils.pyi

@@ -12,7 +12,7 @@ import satkit
 def update_datafiles(**kwargs):
     """Download & store data files needed for "satkit" computations
 
-    Keyword Arguments:
+    Keyword Args:
 
       overwrite (bool):  Download and overwrite files if they already exist
       dir(string): Target directory for files.  Uses existing data directory if not specified. (see "datadir" function)

{satkit-0.3.0 → satkit-0.3.2/python/satkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: satkit
-Version: 0.3.0
+Version: 0.3.2
 Summary: Satellite Orbital Dynamics Toolkit
 Author-email: Steven Michael <ssmichael@gmail.com>
 Maintainer-email: Steven Michael <ssmichael@gmail.com>

{satkit-0.3.0 → satkit-0.3.2}/python/test/orbitprop_gps_fit.py

@@ -25,26 +25,20 @@ import os
 basedir = os.getenv(
     "SATKIT_TESTVEC_ROOT", default="../.." + os.path.sep + "satkit-testvecs"
 )
+fname = (
+    basedir + os.path.sep + "orbitprop" + os.path.sep
+    + "ESA0OPSFIN_20233640000_01D_05M_ORB.SP3"
+)
+
+[pitrf, timearr] = read_sp3file(fname)
+pgcrf = np.stack(
+    np.fromiter(
+        (q * p for q, p in zip(sk.frametransform.qitrf2gcrf(timearr), pitrf)),
+        list,
+    ),
+    axis=0,
+)
 
-sp3names = ['mid22630.sp3', 'mid22631.sp3', 'mid22632.sp3',
-          'mid22633.sp3', 'mid22634.sp3', 'mid22635.sp3',
-          'mid22636.sp3']
-
-sp3names = ['mid22630.sp3', 'mid22631.sp3', 'mid22632.sp3']
-pitrf = np.zeros((0,3), np.float64)
-timearr = np.array([])
-
-for sp3name in sp3names:
-    fname = (
-        basedir
-        + os.path.sep
-        + "orbitprop"
-        + os.path.sep
-        + sp3name
-    )
-    [pitrf1, timearray1] = read_sp3file(fname)
-    pitrf = np.append(pitrf, pitrf1, axis=0)
-    timearr = np.append(timearr, timearray1)
 
 print(pitrf.shape)
 print(timearr.shape)
@@ -62,14 +56,15 @@ vgcrf = (pgcrf[1, :] - pgcrf[0, :]) / (timearr[1] - timearr[0]).seconds()
 
 # Initial state for non-linear least squares is initial velocity
 # and susceptibility to radiation pressuer : Cr A / m
-v0 = np.array([vgcrf[0], vgcrf[1], vgcrf[2], 0.01])
-
+#v0 = np.array([vgcrf[0], vgcrf[1], vgcrf[2], 0.02])
+v0 = np.array([2.47130555e03, 2.94682777e03, -5.34171918e02, 2.13018578e-02])
 
 def minfunc(v):
     tstart = timearr[0]
     tend = timearr[-1]
     settings = sk.satprop.propsettings()
     settings.use_jplephem = False
+    settings.gravity_order = 10
     satprops = sk.satprop.satproperties_static()
     satprops.craoverm = v[3]
 
@@ -78,12 +73,15 @@ def minfunc(v):
         v[0:3],
         tstart,
         stoptime=tend,
-        dt=sk.duration.from_minutes(5),
         propsettings=settings,
-        satproperties=satprops,
+        satproperties=satprops,            
+        output_dense=True,
     )
+    pest = np.zeros((len(timearr), 3))
+    for i in range(len(timearr)):
+        pest[i, :] = res.interp(timearr[i])[0:3]
 
-    return np.sum(np.sum((res["pos"] - pgcrf) ** 2, axis=1), axis=0)
+    return np.sum(np.sum((pest - pgcrf) ** 2, axis=1), axis=0)
 
 
 # Minimize difference between true satellite state and propagated state
@@ -91,6 +89,10 @@ def minfunc(v):
 r = minimize(minfunc, v0, method="Nelder-Mead")
 print(r)
 
+# %%
+print(v0)
+print(r.x)
+
 # %%
 import plotly.graph_objects as go
 
@@ -100,11 +102,15 @@ satprops = sk.satprop.satproperties_static()
 satprops.craoverm = r.x[3]
 res = sk.satprop.propagate(
     pgcrf[0,:], r.x[0:3], timearr[0],
-    stoptime=timearr[-1], dt=sk.duration(minutes=5),
-    propsettings=settings, satproperties=satprops
+    stoptime=timearr[-1],
+    propsettings=settings, satproperties=satprops,
+    output_dense=True
 )
-perr = res['pos'] - pgcrf
+perr = np.zeros((len(timearr), 3))
+for i in range(len(timearr)):
+    perr[i,:] = res.interp(timearr[i])[0:3] - pgcrf[i,:]
 fig = go.Figure()
+
 fig.add_trace(go.Scatter(x=[t.datetime() for t in timearr], y=perr[:,0], mode='lines', name='X'))
 fig.add_trace(go.Scatter(x=[t.datetime() for t in timearr], y=perr[:,1], mode='lines', name='Y'))
 fig.add_trace(go.Scatter(x=[t.datetime() for t in timearr], y=perr[:,2], mode='lines', name='Z'))

{satkit-0.3.0 → satkit-0.3.2}/python/test/test.py

@@ -595,16 +595,22 @@ class TestHighPrecisionPropagation:
             ),
             axis=0,
         )
-        settings = sk.satprop.propsettings()
+        settings = sk.propsettings()
         settings.use_jplephem = False
 
+        # Determined by orbitprop_gps_fit.py
+        fitparam = np.array(
+            [ 2.47130562e+03,  2.94682753e+03, -5.34172176e+02,  2.32565692e-02]
+        )
+
+
         # Values for craoverm and velocity come from orbitprop_gps_fit.py
-        satprops = sk.satprop.satproperties_static()
-        satprops.craoverm = 2.13018578e-2
-        print(satprops)
-        res = sk.satprop.propagate(
+        satprops = sk.satproperties_static()
+        satprops.craoverm = fitparam[3]
+
+        res = sk.propagate(
             pgcrf[0, :],
-            np.array([2.47130555e03, 2.94682777e03, -5.34171918e02]),
+            fitparam[0:3],
             timearr[0],
             stoptime=timearr[-1],
             propsettings=settings,
@@ -613,12 +619,12 @@ class TestHighPrecisionPropagation:
         )
         print(res)
 
-        # See if propagator is accurate to < 10 meters over 1 day on
+        # See if propagator is accurate to < 8 meters over 1 day on
         # each Cartesian axis
         for iv in range(pgcrf.shape[0]-5):            
             state = res.interp(timearr[iv])
             for ix in range(0, 3):
-                assert m.fabs(state[ix] - pgcrf[iv, ix]) < 10
+                assert m.fabs(state[ix] - pgcrf[iv, ix]) < 8
 
 class TestSatState:
     def test_lvlh(self):

{satkit-0.3.0 → satkit-0.3.2}/src/astrotime.rs

@@ -35,7 +35,11 @@
 //!
 //! For a good description, see [here](https://www.stjarnhimlen.se/comp/time.html)
 //!
-#[derive(PartialEq, PartialOrd, Copy, Clone, Debug)]
+//!
+
+use serde::{Deserialize, Serialize};
+
+#[derive(PartialEq, PartialOrd, Copy, Clone, Debug, Serialize, Deserialize)]
 pub struct AstroTime {
     pub(crate) mjd_tai: f64,
 }

{satkit-0.3.0 → satkit-0.3.2}/src/earthgravity.rs

@@ -159,7 +159,7 @@ type Mat3 = na::Matrix3<f64>;
 /// * `pos` - Position as ITRF coordinate (satkit.itrfcoord) or numpy
 ///                3-vector representing ITRF position in meters
 ///
-/// * `order` - Order of the gravity model
+/// * `order` - Order of the gravity model, up to 40
 ///
 /// # References
 ///
@@ -199,8 +199,56 @@ impl Gravity {
             self.accel_t::<14, 18>(pos)
         } else if order == 15 {
             self.accel_t::<15, 19>(pos)
-        } else {
+        } else if order == 16 {
             self.accel_t::<16, 20>(pos)
+        } else if order == 17 {
+            self.accel_t::<17, 21>(pos)
+        } else if order == 18 {
+            self.accel_t::<18, 22>(pos)
+        } else if order == 19 {
+            self.accel_t::<19, 23>(pos)
+        } else if order == 20 {
+            self.accel_t::<20, 24>(pos)
+        } else if order == 21 {
+            self.accel_t::<21, 25>(pos)
+        } else if order == 22 {
+            self.accel_t::<22, 26>(pos)
+        } else if order == 23 {
+            self.accel_t::<23, 27>(pos)
+        } else if order == 24 {
+            self.accel_t::<24, 28>(pos)
+        } else if order == 25 {
+            self.accel_t::<25, 29>(pos)
+        } else if order == 26 {
+            self.accel_t::<26, 30>(pos)
+        } else if order == 27 {
+            self.accel_t::<27, 31>(pos)
+        } else if order == 28 {
+            self.accel_t::<28, 32>(pos)
+        } else if order == 29 {
+            self.accel_t::<29, 33>(pos)
+        } else if order == 30 {
+            self.accel_t::<30, 34>(pos)
+        } else if order == 31 {
+            self.accel_t::<31, 35>(pos)
+        } else if order == 32 {
+            self.accel_t::<32, 36>(pos)
+        } else if order == 33 {
+            self.accel_t::<33, 37>(pos)
+        } else if order == 34 {
+            self.accel_t::<34, 38>(pos)
+        } else if order == 35 {
+            self.accel_t::<35, 39>(pos)
+        } else if order == 36 {
+            self.accel_t::<36, 40>(pos)
+        } else if order == 37 {
+            self.accel_t::<37, 41>(pos)
+        } else if order == 37 {
+            self.accel_t::<38, 42>(pos)
+        } else if order == 39 {
+            self.accel_t::<39, 43>(pos)
+        } else {
+            self.accel_t::<40, 44>(pos)
         }
     }
 
@@ -235,8 +283,56 @@ impl Gravity {
             self.accel_and_partials_t::<14, 18>(pos)
         } else if order == 15 {
             self.accel_and_partials_t::<15, 19>(pos)
-        } else {
+        } else if order == 16 {
             self.accel_and_partials_t::<16, 20>(pos)
+        } else if order == 17 {
+            self.accel_and_partials_t::<17, 21>(pos)
+        } else if order == 18 {
+            self.accel_and_partials_t::<18, 22>(pos)
+        } else if order == 19 {
+            self.accel_and_partials_t::<19, 23>(pos)
+        } else if order == 20 {
+            self.accel_and_partials_t::<20, 24>(pos)
+        } else if order == 21 {
+            self.accel_and_partials_t::<21, 25>(pos)
+        } else if order == 22 {
+            self.accel_and_partials_t::<22, 26>(pos)
+        } else if order == 23 {
+            self.accel_and_partials_t::<23, 27>(pos)
+        } else if order == 24 {
+            self.accel_and_partials_t::<24, 28>(pos)
+        } else if order == 25 {
+            self.accel_and_partials_t::<25, 29>(pos)
+        } else if order == 26 {
+            self.accel_and_partials_t::<26, 30>(pos)
+        } else if order == 27 {
+            self.accel_and_partials_t::<27, 31>(pos)
+        } else if order == 28 {
+            self.accel_and_partials_t::<28, 32>(pos)
+        } else if order == 29 {
+            self.accel_and_partials_t::<29, 33>(pos)
+        } else if order == 30 {
+            self.accel_and_partials_t::<30, 34>(pos)
+        } else if order == 31 {
+            self.accel_and_partials_t::<31, 35>(pos)
+        } else if order == 32 {
+            self.accel_and_partials_t::<32, 36>(pos)
+        } else if order == 33 {
+            self.accel_and_partials_t::<33, 37>(pos)
+        } else if order == 34 {
+            self.accel_and_partials_t::<34, 38>(pos)
+        } else if order == 35 {
+            self.accel_and_partials_t::<35, 39>(pos)
+        } else if order == 36 {
+            self.accel_and_partials_t::<36, 40>(pos)
+        } else if order == 37 {
+            self.accel_and_partials_t::<37, 15>(pos)
+        } else if order == 38 {
+            self.accel_and_partials_t::<38, 16>(pos)
+        } else if order == 39 {
+            self.accel_and_partials_t::<39, 17>(pos)
+        } else {
+            self.accel_and_partials_t::<40, 20>(pos)
         }
     }