ballistic-solver 0.3.2__tar.gz

ballistic_solver-0.3.2/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        config: [Release]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure (CMake)
+        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=${{ matrix.config }}
+
+      - name: Build
+        run: cmake --build build --config ${{ matrix.config }} -j
+
+      - name: Test (ctest)
+        run: ctest --test-dir build -C ${{ matrix.config }} --output-on-failure

ballistic_solver-0.3.2/.github/workflows/release.yml

@@ -0,0 +1,208 @@
+name: Release Native + PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "v0.3.2"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  id-token: write
+
+env:
+  TAG: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.ref_name }}
+
+jobs:
+  native:
+    name: Build native (${{ matrix.os }})
+    if: >
+      (github.event_name == 'push' && startsWith(github.ref_name, 'v')) ||
+      (github.event_name == 'workflow_dispatch' && startsWith(inputs.tag, 'v'))
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: refs/tags/${{ env.TAG }}
+
+      - name: Configure (CMake Release)
+        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build
+        run: cmake --build build --config Release --parallel
+
+      - name: Test
+        run: ctest --test-dir build -C Release --output-on-failure
+
+      - name: Package native (Linux/macOS)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: |
+          set -euo pipefail
+          mkdir -p dist
+          cp -f include/ballistic_solver_c_api.h dist/
+
+          if [[ "${RUNNER_OS}" == "Linux" ]]; then
+            libpath="$(find build -maxdepth 10 -type f -name "libballistic_solver.so" -print -quit)"
+          else
+            libpath="$(find build -maxdepth 10 -type f -name "libballistic_solver.dylib" -print -quit)"
+          fi
+
+          if [[ -z "${libpath:-}" ]]; then
+            echo "ERROR: shared library not found under build/"
+            exit 1
+          fi
+
+          cp -f "$libpath" dist/
+          os="$(echo "${RUNNER_OS}" | tr '[:upper:]' '[:lower:]')"
+          (cd dist && zip -r "../ballistic_solver_${TAG}_${os}.zip" .)
+
+      - name: Package native (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force dist | Out-Null
+          Copy-Item -Force include\ballistic_solver_c_api.h dist\
+
+          $dll = Get-ChildItem -Path build -Recurse -Filter ballistic_solver.dll -ErrorAction SilentlyContinue | Select-Object -First 1
+          if (-not $dll)
+          {
+            Write-Error "ERROR: ballistic_solver.dll not found under build/"
+            exit 1
+          }
+
+          Copy-Item -Force $dll.FullName dist\
+          Compress-Archive -Path dist\* -DestinationPath "ballistic_solver_$($env:TAG)_windows.zip" -Force
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: native-${{ runner.os }}
+          path: ballistic_solver_*.zip
+          if-no-files-found: error
+
+  py_wheels:
+    name: Build python wheels (${{ matrix.os }})
+    if: >
+      (github.event_name == 'push' && startsWith(github.ref_name, 'v')) ||
+      (github.event_name == 'workflow_dispatch' && startsWith(inputs.tag, 'v'))
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: refs/tags/${{ env.TAG }}
+
+      - name: Build wheels (cibuildwheel)
+        uses: pypa/cibuildwheel@v3.3.1
+        with:
+          package-dir: .
+          output-dir: wheelhouse
+        env:
+          CIBW_BUILD: "cp310-* cp311-* cp312-*"
+          CIBW_SKIP: "*-win32 *-manylinux_i686 *-musllinux_*"
+          CIBW_ARCHS_MACOS: "universal2"
+          CIBW_BUILD_VERBOSITY: "3"
+          CIBW_TEST_COMMAND: >-
+            python -c "import ballistic_solver; print('import_ok')"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pywheels-${{ runner.os }}
+          path: wheelhouse/*.whl
+          if-no-files-found: error
+
+  sdist:
+    name: Build python sdist
+    if: >
+      (github.event_name == 'push' && startsWith(github.ref_name, 'v')) ||
+      (github.event_name == 'workflow_dispatch' && startsWith(inputs.tag, 'v'))
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: refs/tags/${{ env.TAG }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        shell: bash
+        run: |
+          set -euo pipefail
+          python -m pip install -U pip build
+          python -m build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pysdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  publish:
+    name: Publish (PyPI + GitHub Release assets)
+    needs: [native, py_wheels, sdist]
+    if: >
+      (github.event_name == 'push' && startsWith(github.ref_name, 'v')) ||
+      (github.event_name == 'workflow_dispatch' && startsWith(inputs.tag, 'v'))
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: Collect PyPI dist
+        shell: bash
+        run: |
+          set -euo pipefail
+          mkdir -p dist
+          find artifacts -type f \( -name "*.whl" -o -name "*.tar.gz" \) -exec cp {} dist/ \;
+          ls -la dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+
+      - name: Create release if missing
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          if gh release view "${TAG}" > /dev/null 2>&1; then
+            echo "Release ${TAG} already exists."
+          else
+            gh release create "${TAG}" --title "${TAG}" --generate-notes
+          fi
+
+      - name: Upload assets to GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          gh release upload "${TAG}" artifacts/*.zip --clobber
+          gh release upload "${TAG}" dist/* --clobber

ballistic_solver-0.3.2/.gitignore

@@ -0,0 +1,60 @@
+# Build outputs
+build/
+out/
+cmake-build-*/
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+Makefile
+compile_commands.json
+**/dist/
+
+# Object / binary / library files
+*.o
+*.obj
+*.exe
+*.out
+*.a
+*.lib
+*.so
+*.dll
+*.dylib
+*.whl
+*.zip
+
+# Debug symbols / misc
+*.pdb
+*.ilk
+*.dSYM/
+*.log
+
+# IDE/editor
+.vscode/
+.idea/
+*.user
+*.suo
+*.vcxproj*
+*.filters
+*.xcodeproj/
+*.xcworkspace/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Visual Studio
+.vs/
+
+# .NET build outputs
+**/bin/
+**/obj/
+
+# Python
+__pycache__/
+*.py[cod]
+**/*.egg-info/
+.venv/
+venv/
+
+# Assets
+assets/

ballistic_solver-0.3.2/CMakeLists.txt

@@ -0,0 +1,108 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(ballistic_solver
+    VERSION 0.3.0
+    LANGUAGES C CXX
+)
+
+set(CMAKE_C_STANDARD 11)
+set(CMAKE_C_STANDARD_REQUIRED ON)
+set(CMAKE_C_EXTENSIONS OFF)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+add_library(ballistic_solver SHARED
+    src/ballistic_solver_c_api.cpp
+)
+
+target_include_directories(ballistic_solver
+    PUBLIC
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+        $<INSTALL_INTERFACE:include>
+)
+
+target_compile_definitions(ballistic_solver PRIVATE
+    BALLISTIC_SOLVER_EXPORTS
+    BALLISTIC_SOLVER_ABI_VERSION=2
+    BALLISTIC_SOLVER_VERSION_STRING=\"${PROJECT_VERSION}\"
+)
+
+if (MSVC)
+    target_compile_options(ballistic_solver PRIVATE /W4 /utf-8)
+else()
+    target_compile_options(ballistic_solver PRIVATE -Wall -Wextra -Wpedantic)
+endif()
+
+add_executable(ballistic_solver_example
+    examples/c/basic.c
+)
+target_link_libraries(ballistic_solver_example PRIVATE ballistic_solver)
+
+include(CTest)
+if (BUILD_TESTING)
+    add_executable(smoke_test
+        tests/smoke_test.c
+    )
+    target_link_libraries(smoke_test PRIVATE ballistic_solver)
+
+    add_test(
+        NAME smoke_test
+        COMMAND $<TARGET_FILE:smoke_test>
+    )
+endif()
+
+include(GNUInstallDirs)
+
+install(TARGETS ballistic_solver
+    EXPORT ballistic_solverTargets
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+)
+
+install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/include/
+    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+)
+
+# Minimal find_package(CONFIG) support
+set(_pkgdir ${CMAKE_INSTALL_LIBDIR}/cmake/ballistic_solver)
+
+install(EXPORT ballistic_solverTargets
+    FILE ballistic_solverTargets.cmake
+    NAMESPACE ballistic_solver::
+    DESTINATION ${_pkgdir}
+)
+
+include(CMakePackageConfigHelpers)
+
+file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/ballistic_solverConfig.cmake"
+"include(\"\${CMAKE_CURRENT_LIST_DIR}/ballistic_solverTargets.cmake\")\n"
+)
+
+write_basic_package_version_file(
+    "${CMAKE_CURRENT_BINARY_DIR}/ballistic_solverConfigVersion.cmake"
+    VERSION ${PROJECT_VERSION}
+    COMPATIBILITY SameMajorVersion
+)
+
+install(FILES
+    "${CMAKE_CURRENT_BINARY_DIR}/ballistic_solverConfig.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/ballistic_solverConfigVersion.cmake"
+    DESTINATION ${_pkgdir}
+)
+
+set_target_properties(ballistic_solver PROPERTIES OUTPUT_NAME "ballistic_solver")
+
+if(DEFINED SKBUILD_PLATLIB_DIR)
+  set(BS_NATIVE_DIR "${SKBUILD_PLATLIB_DIR}/ballistic_solver/_native")
+else()
+  set(BS_NATIVE_DIR "${CMAKE_INSTALL_LIBDIR}")
+endif()
+
+install(TARGETS ballistic_solver
+  RUNTIME DESTINATION "${BS_NATIVE_DIR}"  # Windows .dll
+  LIBRARY DESTINATION "${BS_NATIVE_DIR}"  # Linux .so / macOS .dylib
+  ARCHIVE DESTINATION "${BS_NATIVE_DIR}"  # .lib
+)

ballistic_solver-0.3.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 <ujinf74>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ballistic_solver-0.3.2/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: ballistic-solver
+Version: 0.3.2
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<img width="2024" height="512" alt="banner" src="https://github.com/user-attachments/assets/f4e57e3f-f584-4938-a321-e9dd83dbbac3" />
+
+**ballistic-solver** is a native C/C++ numerical solver that computes launch angles to intercept **moving targets** under **gravity** and **quadratic air drag**.
+Unlike vacuum / closed-form approaches, this solver **simulates the projectile** and **solves the intercept numerically**, targeting robustness for real-time simulations even when trajectories are strongly curved.
+
+---
+
+## Quick start
+
+### Python (wheel)
+
+```bash
+pip install ballistic-solver
+````
+
+Requires Python **>= 3.10**.
+
+```python
+import ballistic_solver as bs
+
+result = bs.solve(
+    relPos0=(120, 30, 5),
+    relVel=(2, -1, 0),
+    v0=90,
+    kDrag=0.002,
+)
+
+print(result["theta"], result["phi"], result["miss"])
+print(result["success"], result["status"], result["message"])
+```
+
+#### Signature (actual binding)
+
+```python
+solve(relPos0, relVel, v0, kDrag, arcMode=0, params=None) -> dict
+```
+
+* `arcMode` accepts `0/1` or `"low"/"high"` (case-insensitive).
+* **Important:** the `arcMode` argument **overrides** `params.arcMode` even if `params` is provided.
+
+Returned dict keys include:
+
+* `success`, `theta`, `phi`, `miss`, `tStar`, `relMissAtStar`
+* `status`, `message`
+* `iterations`, `acceptedSteps`, `lastLambda`, `lastAlpha`
+
+### C ABI (stable interface)
+
+```c
+void ballistic_inputs_init(BallisticInputs* in);
+int32_t ballistic_solve(const BallisticInputs* in, BallisticOutputs* out);
+```
+
+See `ballistic_solver_c_api.h` for `BallisticInputs/Outputs` definitions and defaults.
+
+---
+
+## Demo (Unity)
+
+Highly curved trajectories under strong air drag, still converging to a hit against moving targets.
+
+[https://github.com/user-attachments/assets/dcaf7479-cb94-477a-b71e-470a5b4c6004](https://github.com/user-attachments/assets/dcaf7479-cb94-477a-b71e-470a5b4c6004)
+
+---
+
+## Key properties
+
+* Moving targets supported
+* Strong air resistance (quadratic drag) supported
+* Robust in strongly nonlinear regimes (no analytic assumptions)
+* Best-effort result returned even without perfect convergence
+* Explicit success / failure reporting (+ diagnostic message)
+* Stable C ABI for multi-language use
+* Header-only C++ core
+* Low / High arc selection (since v0.2.0)
+
+---
+
+## Arc mode (since v0.2.0)
+
+C ABI convention:
+
+* `arcMode = 0` → Low
+* `arcMode = 1` → High
+
+High arc example:
+
+[https://github.com/user-attachments/assets/4334ed87-597e-4ad4-b21e-c1a1a17e8cd8](https://github.com/user-attachments/assets/4334ed87-597e-4ad4-b21e-c1a1a17e8cd8)
+
+---
+
+## How it works (high level)
+
+1. Simulate projectile motion using RK4 integration with drag (+ wind in core/C ABI)
+2. Track the closest approach between projectile and target
+3. Express the miss at closest approach as an angular residual
+4. Solve the nonlinear system using damped least squares (Levenberg–Marquardt)
+5. Accelerate Jacobian updates with Broyden-style refinement
+6. Return the best solution found
+
+Failure cases are explicitly detected and reported.
+
+---
+
+## Advanced parameters (C ABI)
+
+`BallisticInputs` exposes additional controls (all have defaults via `ballistic_inputs_init`):
+
+* `g` (gravity)
+* `wind[3]` (wind vector)
+* `dt` (RK4 step)
+* `tMax` (max sim time)
+* `tolMiss` (hit tolerance)
+* `maxIter` (LM iterations)
+
+Note: The current Python binding exposes many tuning parameters via `BallisticParams`,
+but does **not** expose `wind` as a Python field.
+
+---
+
+## Status codes (SolveStatus)
+
+`BallisticOutputs.status` / Python `result["status"]` corresponds to the core enum:
+
+* `0` = Ok
+* `1` = InvalidInput
+* `2` = InitialResidualFailed
+* `3` = JacobianFailed
+* `4` = LMStepSingular
+* `5` = ResidualFailedDuringSearch
+* `6` = LineSearchRejected
+* `7` = LambdaTriesExhausted
+* `8` = MaxIterReached
+
+`message` contains a short diagnostic string.
+
+---
+
+## Using prebuilt binaries
+
+Download the archive for your platform from **Releases**.
+
+Each release contains:
+
+* Shared library
+
+  * Windows: `ballistic_solver.dll`
+  * Linux: `libballistic_solver.so`
+  * macOS: `libballistic_solver.dylib`
+* C ABI header: `ballistic_solver_c_api.h`
+
+---
+
+## C# / Unity usage
+
+A C# P/Invoke example is available in:
+
+```text
+examples/dotnet/
+```
+
+On Windows, place `ballistic_solver.dll` next to the executable
+(or ensure it is discoverable via PATH),
+then call `ballistic_solve` via `DllImport`.
+
+---
+
+## Build from source
+
+```bash
+cmake -S . -B build
+cmake --build build -j
+ctest --test-dir build
+```
+
+The shared library target is `ballistic_solver`.
+
+---
+
+## ABI notes
+
+* Plain C layout across the ABI boundary
+* Fixed-size arrays only
+* No dynamic allocation across the boundary
+
+---
+
+## License
+
+MIT License