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:

py_ballisticcalc.exts: Cython based implementation of some classes to increase performance. py_ballisticcalc.exts package.
visualize: 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 `py_ballisticcalc.exts` extra:
pip install 'py-ballisticcalc[exts]'

# with dependencies for data visualisation    
pip install py-ballisticcalc[visualize]

# with the `py_ballisticcalc.exts` extra:
uv add 'py-ballisticcalc[exts]'

# with dependencies for data visualisation    
uv add  'py-ballisticcalc[visualize]'

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 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)