Skip to content

feat: add high accuracy conjunction assessment workflow#37

Merged
thkruz merged 2 commits into
developfrom
claude/conjunction-assessment-workflow-013nkXNDCBzpdeJG9z7Y7N2b
Nov 19, 2025
Merged

feat: add high accuracy conjunction assessment workflow#37
thkruz merged 2 commits into
developfrom
claude/conjunction-assessment-workflow-013nkXNDCBzpdeJG9z7Y7N2b

Conversation

@thkruz
Copy link
Copy Markdown
Owner

@thkruz thkruz commented Nov 19, 2025

Implement comprehensive conjunction assessment capabilities with:

  • ConjunctionEvent: Data structure for storing conjunction analysis results

    • TCA (Time of Closest Approach)
    • Miss distance with RIC (Radial-Intrack-Crosstrack) components
    • Relative velocity
    • Combined covariance matrices
    • Probability of collision
    • Mahalanobis distance calculation
    • High-risk event detection
  • ProbabilityOfCollision: Pc calculation using Chan's 2D method

    • Projects covariance onto encounter plane (B-plane)
    • Computes 2D probability density integration
    • Handles edge cases (low relative velocity)
    • Analytical approximations for performance
    • Covariance matrix combination
  • ConjunctionAssessment: Main workflow orchestrator

    • Supports TLE or state vector inputs
    • Multiple propagator options (SGP4, RungeKutta89)
    • TCA finding using golden section optimization
    • Covariance propagation using sigma-point method
    • Leverages existing TLE quality assessment
    • High-fidelity force model integration

Key Features:

  • Historical TLE accuracy-based covariance initialization
  • Regime-specific covariance aging (LEO/MEO/GEO/HEO)
  • Flexible propagator selection for accuracy/speed tradeoff
  • Comprehensive test coverage
  • Example implementations for common use cases

The workflow integrates with existing OOTK capabilities:

  • CovarianceSample for sigma-point propagation
  • RIC coordinates for relative geometry
  • GoldenSection optimizer for TCA search
  • Multiple propagator types (SGP4, RK4, RK89)
  • Force models for high-fidelity prediction

Example usage in conjunction-assessment-example.ts demonstrates:

  1. Basic TLE-based conjunction assessment
  2. High-fidelity propagation with covariance
  3. Custom covariance matrix input
  4. Multi-object screening workflows

claude and others added 2 commits November 19, 2025 03:09
Implement comprehensive conjunction assessment capabilities with:

- **ConjunctionEvent**: Data structure for storing conjunction analysis results
  - TCA (Time of Closest Approach)
  - Miss distance with RIC (Radial-Intrack-Crosstrack) components
  - Relative velocity
  - Combined covariance matrices
  - Probability of collision
  - Mahalanobis distance calculation
  - High-risk event detection

- **ProbabilityOfCollision**: Pc calculation using Chan's 2D method
  - Projects covariance onto encounter plane (B-plane)
  - Computes 2D probability density integration
  - Handles edge cases (low relative velocity)
  - Analytical approximations for performance
  - Covariance matrix combination

- **ConjunctionAssessment**: Main workflow orchestrator
  - Supports TLE or state vector inputs
  - Multiple propagator options (SGP4, RungeKutta89)
  - TCA finding using golden section optimization
  - Covariance propagation using sigma-point method
  - Leverages existing TLE quality assessment
  - High-fidelity force model integration

Key Features:
- Historical TLE accuracy-based covariance initialization
- Regime-specific covariance aging (LEO/MEO/GEO/HEO)
- Flexible propagator selection for accuracy/speed tradeoff
- Comprehensive test coverage
- Example implementations for common use cases

The workflow integrates with existing OOTK capabilities:
- CovarianceSample for sigma-point propagation
- RIC coordinates for relative geometry
- GoldenSection optimizer for TCA search
- Multiple propagator types (SGP4, RK4, RK89)
- Force models for high-fidelity prediction

Example usage in conjunction-assessment-example.ts demonstrates:
1. Basic TLE-based conjunction assessment
2. High-fidelity propagation with covariance
3. Custom covariance matrix input
4. Multi-object screening workflows
@github-actions
Copy link
Copy Markdown

# npm audit report

brace-expansion  1.0.0 - 1.1.11
brace-expansion Regular Expression Denial of Service vulnerability - https://github.com/advisories/GHSA-v6h2-p8h4-qcjw
fix available via `npm audit fix`
node_modules/brace-expansion

js-yaml  <3.14.2 || >=4.0.0 <4.1.1
Severity: moderate
js-yaml has prototype pollution in merge (<<) - https://github.com/advisories/GHSA-mh29-5h37-fv8m
js-yaml has prototype pollution in merge (<<) - https://github.com/advisories/GHSA-mh29-5h37-fv8m
fix available via `npm audit fix`
node_modules/@eslint/eslintrc/node_modules/js-yaml
node_modules/eslint/node_modules/js-yaml
node_modules/js-yaml

2 vulnerabilities (1 low, 1 moderate)

To address all issues, run:
  npm audit fix

@thkruz thkruz merged commit 3b8e304 into develop Nov 19, 2025
4 of 5 checks passed
@thkruz thkruz deleted the claude/conjunction-assessment-workflow-013nkXNDCBzpdeJG9z7Y7N2b branch November 19, 2025 11:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants