nrl-tracker 0.22.0__tar.gz → 0.22.2__tar.gz

{nrl_tracker-0.22.0/nrl_tracker.egg-info → nrl_tracker-0.22.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nrl-tracker
-Version: 0.22.0
+Version: 0.22.2
 Summary: Python port of the U.S. Naval Research Laboratory's Tracker Component Library for target tracking algorithms
 Author: Original: David F. Crouse, Naval Research Laboratory
 Maintainer: Python Port Contributors

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2/nrl_tracker.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nrl-tracker
-Version: 0.22.0
+Version: 0.22.2
 Summary: Python port of the U.S. Naval Research Laboratory's Tracker Component Library for target tracking algorithms
 Author: Original: David F. Crouse, Naval Research Laboratory
 Maintainer: Python Port Contributors

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nrl-tracker"
-version = "0.22.0"
+version = "0.22.2"
 description = "Python port of the U.S. Naval Research Laboratory's Tracker Component Library for target tracking algorithms"
 readme = "README.md"
 authors = [

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/__init__.py

@@ -20,7 +20,7 @@ References
        no. 5, pp. 18-27, May 2017.
 """
 
-__version__ = "0.22.0"
+__version__ = "0.22.2"
 __author__ = "Python Port Contributors"
 __original_author__ = "David F. Crouse, Naval Research Laboratory"
 
@@ -30,14 +30,16 @@ __original_author__ = "David F. Crouse, Naval Research Laboratory"
 # Specialized domains (Phase 6)
 # Assignment algorithms (Phase 5)
 # Core utilities
-from pytcl import assignment_algorithms
-from pytcl import astronomical
-from pytcl import atmosphere
-from pytcl import core
-from pytcl import navigation
-from pytcl import performance_evaluation
-from pytcl import plotting
-from pytcl import trackers
+from pytcl import (
+    assignment_algorithms,
+    astronomical,
+    atmosphere,
+    core,
+    navigation,
+    performance_evaluation,
+    plotting,
+    trackers,
+)
 
 
 # Version tuple for programmatic access

nrl_tracker-0.22.2/pytcl/assignment_algorithms/__init__.py

@@ -0,0 +1,94 @@
+"""
+Assignment algorithms for data association in target tracking.
+
+This module provides:
+- 2D assignment algorithms (Hungarian, Auction)
+- K-best 2D assignment (Murty's algorithm)
+- 3D assignment algorithms (Lagrangian relaxation, Auction)
+- Gating methods (ellipsoidal, rectangular)
+- Data association algorithms (GNN, JPDA)
+"""
+
+from pytcl.assignment_algorithms.data_association import (
+    AssociationResult,
+    compute_association_cost,
+    gated_gnn_association,
+    gnn_association,
+    nearest_neighbor,
+)
+from pytcl.assignment_algorithms.gating import (
+    chi2_gate_threshold,
+    compute_gate_volume,
+    ellipsoidal_gate,
+    gate_measurements,
+    mahalanobis_distance,
+    rectangular_gate,
+)
+from pytcl.assignment_algorithms.jpda import (
+    JPDAResult,
+    JPDAUpdate,
+    compute_likelihood_matrix,
+    jpda,
+    jpda_probabilities,
+    jpda_update,
+)
+from pytcl.assignment_algorithms.three_dimensional import (
+    Assignment3DResult,
+    assign3d,
+    assign3d_auction,
+    assign3d_lagrangian,
+    decompose_to_2d,
+    greedy_3d,
+)
+from pytcl.assignment_algorithms.two_dimensional import (
+    AssignmentResult,
+    KBestResult,
+    assign2d,
+    auction,
+    hungarian,
+    kbest_assign2d,
+    linear_sum_assignment,
+    murty,
+    ranked_assignments,
+)
+
+__all__ = [
+    # 2D Assignment
+    "hungarian",
+    "auction",
+    "linear_sum_assignment",
+    "assign2d",
+    "AssignmentResult",
+    # K-Best 2D Assignment
+    "KBestResult",
+    "murty",
+    "kbest_assign2d",
+    "ranked_assignments",
+    # 3D Assignment
+    "Assignment3DResult",
+    "assign3d",
+    "assign3d_lagrangian",
+    "assign3d_auction",
+    "greedy_3d",
+    "decompose_to_2d",
+    # Gating
+    "ellipsoidal_gate",
+    "rectangular_gate",
+    "gate_measurements",
+    "mahalanobis_distance",
+    "chi2_gate_threshold",
+    "compute_gate_volume",
+    # Data Association
+    "gnn_association",
+    "nearest_neighbor",
+    "compute_association_cost",
+    "gated_gnn_association",
+    "AssociationResult",
+    # JPDA
+    "JPDAResult",
+    "JPDAUpdate",
+    "jpda",
+    "jpda_update",
+    "jpda_probabilities",
+    "compute_likelihood_matrix",
+]

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/data_association.py

@@ -5,16 +5,12 @@ This module provides algorithms for associating measurements to tracks,
 including Global Nearest Neighbor (GNN) and related methods.
 """
 
-from typing import List
-from typing import NamedTuple
-from typing import Optional
+from typing import List, NamedTuple, Optional
 
 import numpy as np
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 
-from pytcl.assignment_algorithms.gating import mahalanobis_batch
-from pytcl.assignment_algorithms.gating import mahalanobis_distance
+from pytcl.assignment_algorithms.gating import mahalanobis_batch, mahalanobis_distance
 from pytcl.assignment_algorithms.two_dimensional import assign2d
 
 

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/gating.py

@@ -5,13 +5,11 @@ This module provides gating methods to determine which measurements
 fall within a validation region around predicted track states.
 """
 
-from typing import List
-from typing import Tuple
+from typing import List, Tuple
 
 import numpy as np
 from numba import njit
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 from scipy.stats import chi2
 
 

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/jpda.py

@@ -9,15 +9,11 @@ This is more sophisticated than GNN which makes hard assignment decisions,
 as JPDA can handle measurement origin uncertainty in cluttered environments.
 """
 
-from typing import List
-from typing import NamedTuple
-from typing import Optional
-from typing import Tuple
+from typing import List, NamedTuple, Optional, Tuple
 
 import numpy as np
 from numba import njit
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 from scipy.stats import chi2
 
 from pytcl.assignment_algorithms.gating import mahalanobis_distance

nrl_tracker-0.22.2/pytcl/assignment_algorithms/three_dimensional/__init__.py

@@ -0,0 +1,24 @@
+"""
+Three-dimensional assignment algorithms.
+
+This module provides algorithms for solving 3D assignment problems,
+which arise in multi-sensor data fusion and multi-scan tracking.
+"""
+
+from pytcl.assignment_algorithms.three_dimensional.assignment import (
+    Assignment3DResult,
+    assign3d,
+    assign3d_auction,
+    assign3d_lagrangian,
+    decompose_to_2d,
+    greedy_3d,
+)
+
+__all__ = [
+    "Assignment3DResult",
+    "assign3d",
+    "assign3d_lagrangian",
+    "assign3d_auction",
+    "greedy_3d",
+    "decompose_to_2d",
+]

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/three_dimensional/assignment.py

@@ -11,14 +11,10 @@ cost subject to the constraint that each index appears in at most one
 selected tuple.
 """
 
-from typing import List
-from typing import NamedTuple
-from typing import Optional
-from typing import Tuple
+from typing import List, NamedTuple, Optional, Tuple
 
 import numpy as np
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 from scipy.optimize import linear_sum_assignment as scipy_lsa
 
 

nrl_tracker-0.22.2/pytcl/assignment_algorithms/two_dimensional/__init__.py

@@ -0,0 +1,35 @@
+"""
+Two-dimensional assignment algorithms.
+
+This module provides optimal and suboptimal algorithms for solving
+the 2D assignment problem (bipartite matching), as well as k-best
+assignment algorithms for Multiple Hypothesis Tracking.
+"""
+
+from pytcl.assignment_algorithms.two_dimensional.assignment import (
+    AssignmentResult,
+    assign2d,
+    auction,
+    hungarian,
+    linear_sum_assignment,
+)
+from pytcl.assignment_algorithms.two_dimensional.kbest import (
+    KBestResult,
+    kbest_assign2d,
+    murty,
+    ranked_assignments,
+)
+
+__all__ = [
+    # 2D Assignment
+    "hungarian",
+    "auction",
+    "linear_sum_assignment",
+    "assign2d",
+    "AssignmentResult",
+    # K-Best Assignment
+    "KBestResult",
+    "murty",
+    "kbest_assign2d",
+    "ranked_assignments",
+]

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/two_dimensional/assignment.py

@@ -5,13 +5,10 @@ This module provides algorithms for solving the 2D assignment (bipartite matchin
 problem, which is fundamental to data association in target tracking.
 """
 
-from typing import NamedTuple
-from typing import Optional
-from typing import Tuple
+from typing import NamedTuple, Optional, Tuple
 
 import numpy as np
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 from scipy.optimize import linear_sum_assignment as scipy_lsa
 
 

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/assignment_algorithms/two_dimensional/kbest.py

@@ -6,18 +6,16 @@ This module provides algorithms for finding the k best solutions to the
 Multiple Hypothesis Tracking (MHT).
 """
 
-from typing import List
-from typing import NamedTuple
-from typing import Optional
-from typing import Tuple
+from typing import List, NamedTuple, Optional, Tuple
 
 import numpy as np
-from numpy.typing import ArrayLike
-from numpy.typing import NDArray
+from numpy.typing import ArrayLike, NDArray
 from scipy.optimize import linear_sum_assignment as scipy_lsa
 
-from pytcl.assignment_algorithms.two_dimensional.assignment import AssignmentResult
-from pytcl.assignment_algorithms.two_dimensional.assignment import assign2d
+from pytcl.assignment_algorithms.two_dimensional.assignment import (
+    AssignmentResult,
+    assign2d,
+)
 
 
 class KBestResult(NamedTuple):

nrl_tracker-0.22.2/pytcl/astronomical/__init__.py

@@ -0,0 +1,274 @@
+"""
+Astronomical calculations for target tracking.
+
+This module provides time system conversions, orbital mechanics,
+Lambert problem solvers, reference frame transformations, and high-precision
+ephemerides for celestial bodies.
+
+Examples
+--------
+>>> from pytcl.astronomical import kepler_propagate, OrbitalElements
+>>> import numpy as np
+
+>>> # Propagate an orbit forward in time
+>>> elements = OrbitalElements(a=7000, e=0.01, i=0.5, raan=0, omega=0, nu=0)
+>>> new_elements = kepler_propagate(elements, 3600)  # 1 hour
+
+>>> # Solve Lambert's problem
+>>> from pytcl.astronomical import lambert_universal
+>>> r1 = np.array([5000, 10000, 2100])
+>>> r2 = np.array([-14600, 2500, 7000])
+>>> sol = lambert_universal(r1, r2, 3600)
+
+>>> # Query Sun position with high precision
+>>> from pytcl.astronomical import sun_position
+>>> r_sun, v_sun = sun_position(2451545.0)  # J2000.0
+"""
+
+from pytcl.astronomical.ephemerides import (
+    DEEphemeris,
+    barycenter_position,
+    moon_position,
+    planet_position,
+    sun_position,
+)
+from pytcl.astronomical.lambert import (
+    LambertSolution,
+    bi_elliptic_transfer,
+    hohmann_transfer,
+    lambert_izzo,
+    lambert_universal,
+    minimum_energy_transfer,
+)
+from pytcl.astronomical.orbital_mechanics import (
+    GM_EARTH,  # Constants; Types; Anomaly conversions; Element conversions; Propagation; Orbital quantities
+)
+from pytcl.astronomical.orbital_mechanics import (
+    GM_JUPITER,
+    GM_MARS,
+    GM_MOON,
+    GM_SUN,
+    OrbitalElements,
+    StateVector,
+    apoapsis_radius,
+    circular_velocity,
+    eccentric_to_mean_anomaly,
+    eccentric_to_true_anomaly,
+    escape_velocity,
+    flight_path_angle,
+    hyperbolic_to_true_anomaly,
+    kepler_propagate,
+    kepler_propagate_state,
+    mean_motion,
+    mean_to_eccentric_anomaly,
+    mean_to_hyperbolic_anomaly,
+    mean_to_true_anomaly,
+    orbit_radius,
+    orbital_elements_to_state,
+    orbital_period,
+    periapsis_radius,
+    specific_angular_momentum,
+    specific_orbital_energy,
+    state_to_orbital_elements,
+    time_since_periapsis,
+    true_to_eccentric_anomaly,
+    true_to_hyperbolic_anomaly,
+    true_to_mean_anomaly,
+    vis_viva,
+)
+from pytcl.astronomical.reference_frames import (
+    earth_rotation_angle,  # Time utilities; Precession; Nutation; Earth rotation; Polar motion; Full transformations; Ecliptic/equatorial
+)
+from pytcl.astronomical.reference_frames import (
+    ecef_to_eci,
+    eci_to_ecef,
+    ecliptic_to_equatorial,
+    equation_of_equinoxes,
+    equatorial_to_ecliptic,
+    gast_iau82,
+    gcrf_to_itrf,
+    gmst_iau82,
+    itrf_to_gcrf,
+    julian_centuries_j2000,
+    mean_obliquity_iau80,
+    nutation_angles_iau80,
+    nutation_matrix,
+    polar_motion_matrix,
+    precession_angles_iau76,
+    precession_matrix_iau76,
+    sidereal_rotation_matrix,
+    true_obliquity,
+)
+from pytcl.astronomical.relativity import (
+    C_LIGHT,  # Physical constants; Schwarzschild metric; Time dilation; Shapiro delay; Precession; PN effects; Range corrections
+)
+from pytcl.astronomical.relativity import (
+    G_GRAV,
+    geodetic_precession,
+    gravitational_time_dilation,
+    lense_thirring_precession,
+    post_newtonian_acceleration,
+    proper_time_rate,
+    relativistic_range_correction,
+    schwarzschild_precession_per_orbit,
+    schwarzschild_radius,
+    shapiro_delay,
+)
+from pytcl.astronomical.time_systems import (
+    JD_GPS_EPOCH,  # Julian dates; Time scales; Unix time; GPS week; Sidereal time; Leap seconds; Constants
+)
+from pytcl.astronomical.time_systems import (
+    JD_J2000,
+    JD_UNIX_EPOCH,
+    MJD_OFFSET,
+    TT_TAI_OFFSET,
+    LeapSecondTable,
+    cal_to_jd,
+    gast,
+    get_leap_seconds,
+    gmst,
+    gps_to_tai,
+    gps_to_utc,
+    gps_week_seconds,
+    gps_week_to_utc,
+    jd_to_cal,
+    jd_to_mjd,
+    jd_to_unix,
+    mjd_to_jd,
+    tai_to_gps,
+    tai_to_tt,
+    tai_to_utc,
+    tt_to_tai,
+    tt_to_utc,
+    unix_to_jd,
+    utc_to_gps,
+    utc_to_tai,
+    utc_to_tt,
+)
+
+__all__ = [
+    # Time systems - Julian dates
+    "cal_to_jd",
+    "jd_to_cal",
+    "mjd_to_jd",
+    "jd_to_mjd",
+    # Time systems - Time scales
+    "utc_to_tai",
+    "tai_to_utc",
+    "tai_to_tt",
+    "tt_to_tai",
+    "utc_to_tt",
+    "tt_to_utc",
+    "tai_to_gps",
+    "gps_to_tai",
+    "utc_to_gps",
+    "gps_to_utc",
+    # Time systems - Unix time
+    "unix_to_jd",
+    "jd_to_unix",
+    # Time systems - GPS week
+    "gps_week_seconds",
+    "gps_week_to_utc",
+    # Time systems - Sidereal time
+    "gmst",
+    "gast",
+    # Time systems - Leap seconds
+    "get_leap_seconds",
+    "LeapSecondTable",
+    # Time systems - Constants
+    "JD_J2000",
+    "JD_UNIX_EPOCH",
+    "JD_GPS_EPOCH",
+    "MJD_OFFSET",
+    "TT_TAI_OFFSET",
+    # Orbital mechanics - Constants
+    "GM_SUN",
+    "GM_EARTH",
+    "GM_MOON",
+    "GM_MARS",
+    "GM_JUPITER",
+    # Orbital mechanics - Types
+    "OrbitalElements",
+    "StateVector",
+    # Orbital mechanics - Anomaly conversions
+    "mean_to_eccentric_anomaly",
+    "mean_to_hyperbolic_anomaly",
+    "eccentric_to_true_anomaly",
+    "true_to_eccentric_anomaly",
+    "hyperbolic_to_true_anomaly",
+    "true_to_hyperbolic_anomaly",
+    "eccentric_to_mean_anomaly",
+    "mean_to_true_anomaly",
+    "true_to_mean_anomaly",
+    # Orbital mechanics - Element conversions
+    "orbital_elements_to_state",
+    "state_to_orbital_elements",
+    # Orbital mechanics - Propagation
+    "kepler_propagate",
+    "kepler_propagate_state",
+    # Orbital mechanics - Orbital quantities
+    "orbital_period",
+    "mean_motion",
+    "vis_viva",
+    "specific_angular_momentum",
+    "specific_orbital_energy",
+    "flight_path_angle",
+    "periapsis_radius",
+    "apoapsis_radius",
+    "time_since_periapsis",
+    "orbit_radius",
+    "escape_velocity",
+    "circular_velocity",
+    # Lambert problem
+    "LambertSolution",
+    "lambert_universal",
+    "lambert_izzo",
+    "minimum_energy_transfer",
+    "hohmann_transfer",
+    "bi_elliptic_transfer",
+    # Reference frames - Precession
+    "julian_centuries_j2000",
+    "precession_angles_iau76",
+    "precession_matrix_iau76",
+    # Reference frames - Nutation
+    "nutation_angles_iau80",
+    "nutation_matrix",
+    "mean_obliquity_iau80",
+    "true_obliquity",
+    # Reference frames - Earth rotation
+    "earth_rotation_angle",
+    "gmst_iau82",
+    "gast_iau82",
+    "sidereal_rotation_matrix",
+    "equation_of_equinoxes",
+    # Reference frames - Polar motion
+    "polar_motion_matrix",
+    # Reference frames - Full transformations
+    "gcrf_to_itrf",
+    "itrf_to_gcrf",
+    "eci_to_ecef",
+    "ecef_to_eci",
+    # Reference frames - Ecliptic/equatorial
+    "ecliptic_to_equatorial",
+    "equatorial_to_ecliptic",
+    # Ephemerides - Classes
+    "DEEphemeris",
+    # Ephemerides - Functions
+    "sun_position",
+    "moon_position",
+    "planet_position",
+    "barycenter_position",
+    # Relativity - Constants
+    "C_LIGHT",
+    "G_GRAV",
+    # Relativity - Functions
+    "schwarzschild_radius",
+    "gravitational_time_dilation",
+    "proper_time_rate",
+    "shapiro_delay",
+    "schwarzschild_precession_per_orbit",
+    "post_newtonian_acceleration",
+    "geodetic_precession",
+    "lense_thirring_precession",
+    "relativistic_range_correction",
+]

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/astronomical/ephemerides.py

@@ -49,9 +49,7 @@ References
 
 """
 
-from typing import Literal
-from typing import Optional
-from typing import Tuple
+from typing import Literal, Optional, Tuple
 
 import numpy as np
 

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/astronomical/lambert.py

@@ -15,8 +15,7 @@ References
        orbital boundary-value problem," Celestial Mechanics, 1990.
 """
 
-from typing import NamedTuple
-from typing import Tuple
+from typing import NamedTuple, Tuple
 
 import numpy as np
 from numpy.typing import NDArray

{nrl_tracker-0.22.0 → nrl_tracker-0.22.2}/pytcl/astronomical/time_systems.py

@@ -11,8 +11,7 @@ This module provides conversions between various time systems:
 - Sidereal time (GMST, GAST)
 """
 
-from typing import List
-from typing import Tuple
+from typing import List, Tuple
 
 import numpy as np
 

nrl_tracker-0.22.2/pytcl/atmosphere/__init__.py

@@ -0,0 +1,37 @@
+"""
+Atmospheric models for tracking applications.
+
+This module provides standard atmosphere models used for computing
+temperature, pressure, density, and other properties at various altitudes.
+"""
+
+from pytcl.atmosphere.models import G0  # Constants
+from pytcl.atmosphere.models import (
+    GAMMA,
+    P0,
+    RHO0,
+    T0,
+    AtmosphereState,
+    R,
+    altitude_from_pressure,
+    isa_atmosphere,
+    mach_number,
+    true_airspeed_from_mach,
+    us_standard_atmosphere_1976,
+)
+
+__all__ = [
+    "AtmosphereState",
+    "us_standard_atmosphere_1976",
+    "isa_atmosphere",
+    "altitude_from_pressure",
+    "mach_number",
+    "true_airspeed_from_mach",
+    # Constants
+    "T0",
+    "P0",
+    "RHO0",
+    "G0",
+    "R",
+    "GAMMA",
+]