Skip to content

Changelog¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased ¶

2.2.6.post1 - 2025-12-14¶

Changed¶

Removed unnecessary atmosphere precalculation in C++ rk4 integrator
Removed unnecessary 'edited' trigger from pypi-publish.yml

2.2.6 – 2025-12-13¶

Changed¶

Optimized C++ based RK4 integrator performance
V3dT uses square check instead of sqrt for magnitude calculation for performance

Fixed¶

C++ based TrajectoryDataFilter initialization fix

Compatibility¶

Fully compatible with v2.2.3 (no breaking changes).
Rebuilding wheels is recommended for distributors.

2.2.5 – 2025-12-11¶

Added¶

Improvements in integrator termination control and integration helpers.
CI/CD enhancements including reusable wheel builds and better version extraction.

Changed¶

Major internal migration to a C++-centric engine design.
Simplified Cython bindings and improved Python-level ergonomics.
Significant memory usage optimizations.
Thread-safety improvements in core engine components.
Updated documentation, README, and contributor guidelines.

Fixed¶

Eliminated redundant copying in internal data pipelines.
Fixed documentation build issues.
Numerous bug fixes across the engine, wrappers, and integration logic.

Compatibility¶

Fully compatible with v2.2.3 (no breaking changes).
Rebuilding wheels is recommended for distributors.
Thread-safety improvements may positively affect multi-threaded usage.

2.2.5rc3 - 2025-12-10¶

Changed¶

Refactoring and features improvements
Attempted to use std::function for better functionality

Fixed¶

Made type annotations better and more accurate

2.2.5rc2 - 2025-12-02¶

Added¶

C++-level GenericTerminator for better control
CythonizedBaseIntegrationEngine.integrate_raw_at method to integrate by key_attribute and target_value
Thread safety with std::recursive_mutex for BCLIBC_Engine fields

Changed¶

Control integrator termination from external handlers
Much more safe BCLIBC_EssentialTerminators usage
Refactored termination control from outer BCLIBC_EssentialTerminators

Fixed¶

C++ memory usage optimization

2.2.5rc1 - 2025-11-28¶

Added¶

Automatic version detection during build/install using setuptools-scm
RAII initialization to prevent memory leaks in trajectory filters
Dense output support for trajectory handling

Changed¶

Major refactor: Fully ported ballistic engine from C/Cython to C++ with thin Cython wrappers
Cython now provides only a thin interface with most computations in native C++
BaseTrajSeq, TrajectoryDataFilter, V3dT, BCLIBC_Coriolis, BCLIBC_Wind, and BCLIBC_ShotProps refactored as C++ classes/enum classes
Optimized solvers (rk4, euler) and trajectory computations
Enhanced trajectory data filtering and interpolation
Unified exception handling in apex, range, and zero-finding calculations

Fixed¶

Memory management across engine and trajectory structures
Pickling support for Calculator interface
Log level issues
TDF caching and timestep handling
Numerical stability including look angles near 90°

Improved¶

Performance through optimized internal data structures using std::vector
Reduced complexity and duplication in Cython wrappers
Partial compile-time logging disabling to reduce overhead
Zero-finding and engine computations robustness

2.2.5b2 - 2025-11-27¶

Fixed¶

interface::Calculator custom serialization methods for pickling

2.2.5b1 - 2025-11-11¶

Added¶

C++ TrajectoryDataFilter implementation

Changed¶

Ported TDF to C++
Refactored C++ Engine wrapper
Wrapped Engine.release_trajectory in C++

Fixed¶

macOS builds compatibility
TDF exceptions handling
CythonizedBaseIntegrationEngine.integrate errors check
Removed useless arguments from integratefunc

2.2.4rc1 - 2025-11-09¶

Added¶

Namespace organization improvements
Helper functions for better code organization

Changed¶

Multiple refactoring passes (Refactor2C_4, Refactor2C_5, Refactor2C_6)
C-level optimizations for better performance
Cythonized and C sources updates

Fixed¶

Log level configuration
Setup process
Conftest configuration
TDF cache interpolation for efficiency
TDF time step check
Annotations in TDF
BCLIBC_Coriolis_adjustRange function
Memory management with memset

2.2.3 - 2025-10-19¶

Added¶

Python 3.14 and 3.14t support
ARM wheel building support
Manual pytest workflow runner for GitHub Actions
Thread safety improvements for interface.Calculator

Changed¶

Dropped support for Python 3.9
Updated CI workflows to include Python 3.14
Refactored WindSock_t to use built-in structure
Reduced .ipynb dependency footprint for VS Code and PyCharm
Updated reusable pytest workflows with exit code checks

Fixed¶

Dependency issues for new Python versions
Coriolis_t_from_pyobject handling
ShotProps_t_freeResources to safely NULLIFY internal pointers
.pylintrc issues
Dependabot configuration

Removed¶

Deprecated runners (macos-13)
Deprecated workflows (cibuildwheel_test.yml)
Deprecated interface.Calculator.cdm property

2.2.2 - 2025-10-16¶

Added¶

Valgrind-based workflows for leak detection
New benchmarking details in documentation
CBaseTrajSeq_t_len helper function
Enhanced test helpers and internal data structure creation utilities

Changed¶

Moved integration routines (_integrate_rk4, _integrate_euler) fully to C
CBaseTrajSeq now wraps pure-C CBaseTrajSeq_t
Replaced Python-level calls with direct C invocations
Improved BaseTrajDataT structure and method access

Fixed¶

Multiple memory leaks in trajectory and curve management
Enhanced C++ compatibility with extern "C" declarations
Typos and mkdocs build issues
termination_reason checks in C integrators

Removed¶

Redundant pointer dereferences and casts
Redundant imports and legacy declarations

2.2.1 - 2025-10-08¶

Added¶

Import guards for optional dependencies (pandas, numpy, scipy)
Version-matching guards in exts

Changed¶

Updated hooks and contribution guides
Refreshed code examples for clarity

Fixed¶

Engine loading to prevent import errors when scientific libraries are missing
Mypy and ruff checks now pass cleanly

Removed¶

Redundant include guard from bind.c

2.2.0 - 2025-10-03¶

Added¶

New RK4 (Runge-Kutta 4) integrator
Coriolis effect support in trajectory calculations
Python 3.13 support
Entry points for engines
Override for getCalcStep in RK4 engine

Changed¶

Set RK4 engine as default
Refactored integration with SciPy
General Cythonization of critical paths
Some components rewritten directly in C
Standardized slant terminology
Restructured and prettified documentation

Fixed¶

RK4 engine implementation
Type annotations and configuration
Tests and logger cleanup

Improved¶

Zeroing features and refinements with Cython implementation
Documentation expanded with user guides and explanations

2.2.0rc2 - 2025-09-25¶

Changed¶

Extended documentation

Fixed¶

Various issues from v2.2.0rc1

2.2.0rc1 - 2025-09-15¶

Added¶

Entry points for engines
RK4 integrator with passing tests
New tests for zeroing
Coriolis effect implementation

Changed¶

Refactored trajectory_calc.py
Cythonized engines refactoring
Inline vector operations optimization
Restructured and prettified documentation
Updated README

Fixed¶

Test fixes and logger cleanup
Various SciPy engine configuration issues

2.2.0b7 - 2025-08-26¶

Added¶

Piecewise Cubic Hermite Interpolation (PCHIP) to trajectory data
Optional[RangeError] to HitResult
Implemented new dense_output flag
Cython-specific unit tests
Enhanced documentation with standardized docstrings

Changed¶

RK4 engines run with larger DEFAULT_STEP for faster results
Replaced EngineProtocol.trajectory() with .integrate()
Rewrote TrajectoryDataFilter to interpolate for all requested points
Rewrote chunks of Cython for better test compatibility
Renamed density_factor to density_ratio
Renamed PreferredUnits.defaults() to .restore_defaults()

Deprecated¶

helpers.py::must_fire() - use Calculator.fire(raise_range_error=True) instead
extra_data flag

Fixed¶

Multiple issues including #199, #202, #203, #209, #211, and #35

Removed¶

Dev dependencies from standard install

2.2.0b6 - 2025-08-09¶

Added¶

ZeroStudy.ipynb with zeroing/fire-solution performance study
BenchmarkEngines.md analysis
Enhanced zeroing features

Changed¶

RK4 engine set as default after fixes
Standardized slant terminology in README
Cythonized engines refactoring
Inline vector operations

Fixed¶

RK4 engine implementation
mkdocs build

Improved¶

All engines now support .find_max_range() for any angle

2.2.0b5 - 2025-07-04¶

Changed¶

Type annotations updates
Ruff CI setup

Fixed¶

SciPy engine annotations
SciPy configuration issues

2.2.0b4 - 2025-07-01¶

Added¶

RK4 getCalcStep override

Changed¶

SciPy integration improvements

2.2.0b3.post1 - 2025-06-25¶

Changed¶

SciPy integration refinements

2.2.0b3 - 2025-06-25¶

Changed¶

SciPy integration improvements

2.2.0b2 - 2025-06-20¶

Changed¶

SciPy integration enhancements

2.2.0b1 - 2025-06-13¶

Added¶

RK4 integrator implementation

Fixed¶

Test suite improvements
InterfaceConfigDict usages

2.1.1b3 - 2025-06-10¶

Added¶

Python 3.13 support

2.1.1b2 - 2025-06-04¶

Changed¶

Refactored trajectory_calc.py

2.1.1b1 - 2025-06-03¶

Added¶

Entry points for engines

2.1.0 - 2025-05-22¶

Added¶

Vacuum atmosphere implementation
Helper utilities and test helpers
add_time_of_flight_axis method
Enhanced documentation with docstrings
Automatic CI with UV for better performance

Changed¶

Switched to powder temperature and sensitivity options
Boostrap Cython modules
Refactored munition cythonization
Refactored wind_vector
Configuration bind refactoring for cythonic TrajectoryCalc

Fixed¶

Atmospheric model issues
Vector performance (changed to NamedTuple)
Velocity for temperature calculations
Exception handling improvements
Incomplete shot handling
Trajectories that bend backwards
_init_trajectory issues
Issue #130

Improved¶

Performance optimizations with high-optimized Euler
CI pipelines with UV
Type annotations with Mypy

2.1.0rc2 - 2025-04-27¶

Fixed¶

Partial fix to issue #155

2.1.0rc1 - 2025-04-13¶

Fixed¶

Completed implementation for issue #164

2.1.0b7 - 2025-03-25¶

Added¶

Vacuum Atmo implementation
Unit test for issue #160

Changed¶

Vector changed to NamedTuple for better performance
Switched CI to UV for performance boost

Fixed¶

All atmospheric model issues from #157
Simple fix to #160
CI pipelines
Mypy typing issues

2.1.0b6 - 2025-02-18¶

Changed¶

Various improvements and refinements

2.1.0b5 - 2025-02-06¶

Added¶

Incomplete shot handling

2.1.0b4 - 2025-01-25¶

Added¶

Helper utilities and test helpers
add_time_of_flight_axis method
Trusted publishers support

Changed¶

Configuration bind refactoring for cythonic TrajectoryCalc

Fixed¶

Issue #141
Trajectories that bend backwards