Installation¶

Installation is as simple as:

pipuv

pip install py-ballisticcalc

uv add py-ballisticcalc

If you have Python 3.10+ and pip installed, you're good to go.

Optional dependencies¶

py-ballisticcalc has the following optional dependencies:

exts: Cython based implementation of some classes to increase performance. py_ballisticcalc.exts package.
charts: Includes matplotlib for creating charts and pandas for creating DataFrame tables.
scipy: Installs support for the SciPyIntegrationEngine.

To install optional dependencies along with py-ballisticcalc:

pipuv

# with the cython extensions:
pip install "py-ballisticcalc[exts]"

# with dependencies for charting:
pip install "py-ballisticcalc[charts]"

# with the cython extensions:
uv add "py-ballisticcalc[exts]"

# with dependencies for charting:
uv add "py-ballisticcalc[charts]"

You can also install requirements manually. For example:

pipuv

pip install py-ballisticcalc.exts pandas matplotlib

uv add py-ballisticcalc.exts pandas matplotlib

To install latest version from sources in editable mode:

git clone https://github.com/o-murphy/py-ballisticcalc
cd py-ballisticcalc

pipuv

# from repo root
py -m pip install -e .[dev]                        # main package editable
py -m pip install -e ./py_ballisticcalc.exts[dev]  # build/install C extensions (optional)

# from repo root
uv sync --dev                        # main package editable
uv sync --dev --extra exts           # build/install C extensions (optional)