nrl-tracker 1.7.5__py3-none-any.whl → 1.9.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. {nrl_tracker-1.7.5.dist-info → nrl_tracker-1.9.0.dist-info}/METADATA +2 -2
  2. {nrl_tracker-1.7.5.dist-info → nrl_tracker-1.9.0.dist-info}/RECORD +33 -27
  3. pytcl/__init__.py +3 -3
  4. pytcl/assignment_algorithms/dijkstra_min_cost.py +183 -0
  5. pytcl/assignment_algorithms/network_flow.py +94 -1
  6. pytcl/assignment_algorithms/network_simplex.py +165 -0
  7. pytcl/astronomical/ephemerides.py +8 -4
  8. pytcl/astronomical/relativity.py +20 -0
  9. pytcl/containers/__init__.py +19 -8
  10. pytcl/containers/base.py +82 -9
  11. pytcl/containers/covertree.py +14 -21
  12. pytcl/containers/kd_tree.py +18 -45
  13. pytcl/containers/rtree.py +43 -4
  14. pytcl/containers/vptree.py +14 -21
  15. pytcl/core/__init__.py +59 -2
  16. pytcl/core/constants.py +59 -0
  17. pytcl/core/exceptions.py +865 -0
  18. pytcl/core/optional_deps.py +531 -0
  19. pytcl/core/validation.py +4 -6
  20. pytcl/dynamic_estimation/kalman/matrix_utils.py +427 -0
  21. pytcl/dynamic_estimation/kalman/square_root.py +20 -213
  22. pytcl/dynamic_estimation/kalman/sr_ukf.py +5 -5
  23. pytcl/dynamic_estimation/kalman/types.py +98 -0
  24. pytcl/mathematical_functions/signal_processing/detection.py +19 -0
  25. pytcl/mathematical_functions/transforms/wavelets.py +7 -6
  26. pytcl/plotting/coordinates.py +25 -27
  27. pytcl/plotting/ellipses.py +14 -16
  28. pytcl/plotting/metrics.py +7 -5
  29. pytcl/plotting/tracks.py +8 -7
  30. pytcl/terrain/loaders.py +10 -6
  31. {nrl_tracker-1.7.5.dist-info → nrl_tracker-1.9.0.dist-info}/LICENSE +0 -0
  32. {nrl_tracker-1.7.5.dist-info → nrl_tracker-1.9.0.dist-info}/WHEEL +0 -0
  33. {nrl_tracker-1.7.5.dist-info → nrl_tracker-1.9.0.dist-info}/top_level.txt +0 -0
pytcl/core/__init__.py CHANGED
@@ -5,6 +5,8 @@ This module provides foundational functionality used throughout the library:
5
5
  - Physical and mathematical constants
6
6
  - Input validation utilities
7
7
  - Array manipulation helpers compatible with MATLAB conventions
8
+ - Custom exception hierarchy for consistent error handling
9
+ - Optional dependency management
8
10
  """
9
11
 
10
12
  from pytcl.core.array_utils import (
@@ -23,10 +25,36 @@ from pytcl.core.constants import (
23
25
  WGS84,
24
26
  PhysicalConstants,
25
27
  )
28
+ from pytcl.core.exceptions import (
29
+ ComputationError,
30
+ ConfigurationError,
31
+ ConvergenceError,
32
+ DataError,
33
+ DependencyError,
34
+ DimensionError,
35
+ EmptyContainerError,
36
+ FormatError,
37
+ MethodError,
38
+ NumericalError,
39
+ ParameterError,
40
+ ParseError,
41
+ RangeError,
42
+ SingularMatrixError,
43
+ StateError,
44
+ TCLError,
45
+ UninitializedError,
46
+ ValidationError,
47
+ )
48
+ from pytcl.core.optional_deps import (
49
+ LazyModule,
50
+ check_dependencies,
51
+ import_optional,
52
+ is_available,
53
+ requires,
54
+ )
26
55
  from pytcl.core.validation import (
27
56
  ArraySpec,
28
57
  ScalarSpec,
29
- ValidationError,
30
58
  check_compatible_shapes,
31
59
  ensure_2d,
32
60
  ensure_column_vector,
@@ -48,8 +76,31 @@ __all__ = [
48
76
  "EARTH_ROTATION_RATE",
49
77
  "WGS84",
50
78
  "PhysicalConstants",
51
- # Validation
79
+ # Exceptions (base)
80
+ "TCLError",
81
+ # Exceptions (validation)
52
82
  "ValidationError",
83
+ "DimensionError",
84
+ "ParameterError",
85
+ "RangeError",
86
+ # Exceptions (computation)
87
+ "ComputationError",
88
+ "ConvergenceError",
89
+ "NumericalError",
90
+ "SingularMatrixError",
91
+ # Exceptions (state)
92
+ "StateError",
93
+ "UninitializedError",
94
+ "EmptyContainerError",
95
+ # Exceptions (configuration)
96
+ "ConfigurationError",
97
+ "MethodError",
98
+ "DependencyError",
99
+ # Exceptions (data)
100
+ "DataError",
101
+ "FormatError",
102
+ "ParseError",
103
+ # Validation utilities
53
104
  "validate_array",
54
105
  "validate_inputs",
55
106
  "validate_same_shape",
@@ -68,4 +119,10 @@ __all__ = [
68
119
  "wrap_to_range",
69
120
  "column_vector",
70
121
  "row_vector",
122
+ # Optional dependencies
123
+ "is_available",
124
+ "import_optional",
125
+ "requires",
126
+ "check_dependencies",
127
+ "LazyModule",
71
128
  ]
pytcl/core/constants.py CHANGED
@@ -317,3 +317,62 @@ c = SPEED_OF_LIGHT
317
317
 
318
318
  #: Alias for GRAVITATIONAL_CONSTANT
319
319
  G = GRAVITATIONAL_CONSTANT
320
+
321
+
322
+ __all__ = [
323
+ # Universal Physical Constants
324
+ "SPEED_OF_LIGHT",
325
+ "GRAVITATIONAL_CONSTANT",
326
+ "PLANCK_CONSTANT",
327
+ "BOLTZMANN_CONSTANT",
328
+ "STEFAN_BOLTZMANN_CONSTANT",
329
+ "ELEMENTARY_CHARGE",
330
+ "AVOGADRO_CONSTANT",
331
+ "UNIVERSAL_GAS_CONSTANT",
332
+ "STANDARD_ATMOSPHERE",
333
+ "ABSOLUTE_ZERO_CELSIUS",
334
+ # Earth Parameters
335
+ "EARTH_SEMI_MAJOR_AXIS",
336
+ "EARTH_SEMI_MINOR_AXIS",
337
+ "EARTH_FLATTENING",
338
+ "EARTH_ECCENTRICITY_SQ",
339
+ "EARTH_ECCENTRICITY",
340
+ "EARTH_ECCENTRICITY_PRIME_SQ",
341
+ "EARTH_ROTATION_RATE",
342
+ "EARTH_GM",
343
+ "EARTH_GM_EGM2008",
344
+ "EARTH_MEAN_ANGULAR_VELOCITY",
345
+ "EARTH_MEAN_RADIUS",
346
+ "STANDARD_GRAVITY",
347
+ # Time Constants
348
+ "SECONDS_PER_DAY",
349
+ "SECONDS_PER_JULIAN_CENTURY",
350
+ "DAYS_PER_JULIAN_YEAR",
351
+ "DAYS_PER_JULIAN_CENTURY",
352
+ "J2000_EPOCH_JD",
353
+ "MJD_OFFSET",
354
+ # Mathematical Constants
355
+ "PI",
356
+ "TWO_PI",
357
+ "HALF_PI",
358
+ "DEG_TO_RAD",
359
+ "RAD_TO_DEG",
360
+ "ARCSEC_TO_RAD",
361
+ "RAD_TO_ARCSEC",
362
+ # Dataclasses
363
+ "EllipsoidParameters",
364
+ "PhysicalConstants",
365
+ # Ellipsoid Instances
366
+ "WGS84",
367
+ "GRS80",
368
+ "CLARKE1866",
369
+ "SPHERE_EARTH",
370
+ # Solar System Parameters
371
+ "ASTRONOMICAL_UNIT",
372
+ "SUN_GM",
373
+ "MOON_GM",
374
+ "EARTH_MOON_MASS_RATIO",
375
+ # Aliases
376
+ "c",
377
+ "G",
378
+ ]