Skip to main content

ballistics_engine/
lib.rs

1//! # Ballistics Engine
2//!
3//! High-performance ballistics trajectory calculation engine with comprehensive physics modeling.
4//!
5//! ## Interactive Web Demo
6//!
7//! Try the ballistics engine directly in your browser at [https://ballistics.rs/](https://ballistics.rs/)
8//!
9//! ## Features
10//!
11//! - Professional-grade trajectory calculations with multiple drag models
12//! - Advanced physics including spin drift, Coriolis effect, and Magnus force
13//! - Monte Carlo simulations for uncertainty analysis
14//! - WebAssembly support for browser-based applications
15//! - FFI bindings for iOS and Android development
16
17// Re-export the main types and functions
18pub use cli_api::{
19    calculate_zero_angle, calculate_zero_angle_with_conditions, estimate_bc_from_trajectory,
20    run_monte_carlo, run_monte_carlo_with_wind, AtmosphericConditions, BallisticInputs,
21    BallisticsError, MonteCarloParams, MonteCarloResults, TrajectoryPoint, TrajectoryResult,
22    TrajectorySolver, WindConditions,
23};
24pub use drag_model::DragModel;
25
26// Module declarations
27pub mod cli_api;
28mod drag_model;
29pub mod ffi;
30#[cfg(target_arch = "wasm32")]
31pub mod wasm;
32#[cfg(test)]
33mod wasm_tests;
34// MBA-154: Make constants public for ballistics_rust wrapping
35pub mod atmosphere;
36pub mod constants;
37pub mod drag;
38mod drag_tables;
39pub mod wind;
40// MBA-153: Make wind_shear public for ballistics_rust wrapping
41pub mod wind_shear;
42// MBA-154: Make derivatives public for ballistics_rust wrapping
43pub mod derivatives;
44pub mod trajectory_sampling;
45// MBA-154: Make fast_trajectory public for ballistics_rust wrapping
46pub mod fast_trajectory;
47// MBA-155: Add advanced integration methods (RK4, RK45)
48pub mod trajectory_integration;
49// MBA-149 Phase 5 Priority 2: Export enhanced spin_drift
50pub mod pitch_damping;
51pub mod spin_decay;
52pub mod spin_drift;
53pub mod spin_drift_advanced;
54// MBA-149 Phase 5 Priority 2: Export enhanced precession_nutation
55pub mod precession_nutation;
56// MBA-153: Make aerodynamic_jump public for ballistics_rust wrapping
57pub mod aerodynamic_jump;
58// MBA-149 Phase 5 Priority 2: Export enhanced angle_calculations
59pub mod angle_calculations;
60pub mod transonic_drag;
61// MBA-153: Make reynolds public for ballistics_rust wrapping
62pub mod reynolds;
63// MBA-149 Phase 5 Priority 2: Export enhanced form_factor
64pub mod form_factor;
65// MBA-153: Make monte_carlo public for ballistics_rust wrapping
66pub mod bc_estimation;
67pub mod cluster_bc;
68pub mod monte_carlo;
69pub mod stability;
70pub mod stability_advanced;
71
72// Online mode: HTTP client for Flask API (feature-gated)
73#[cfg(feature = "online")]
74pub mod api_client;
75
76// BC5D table auto-download (feature-gated)
77#[cfg(feature = "online")]
78pub mod bc_table_download;
79
80// BC correction table for offline mode
81pub mod bc_table;
82
83// 5D BC correction tables (caliber-specific, ML-derived)
84pub mod bc_table_5d;
85
86// Internal type alias for compatibility
87pub(crate) type InternalBallisticInputs = BallisticInputs;
88
89// BC segment data for velocity-dependent BC
90#[derive(Debug, Clone)]
91pub struct BCSegmentData {
92    pub velocity_min: f64,
93    pub velocity_max: f64,
94    pub bc_value: f64,
95}