Installation¶

Installation is as simple as:

pipuv

pip install pyballistic

uv add pyballistic

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

Optional dependencies¶

pyballistic has the following optional dependencies:

exts: Cython based implementation of some classes to increase performance. pyballistic.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 pyballistic:

pipuv

# with the cython extensions:
pip install "pyballistic[exts]"

# with dependencies for charting:
pip install "pyballistic[charts]"

# with the cython extensions:
uv add "pyballistic[exts]"

# with dependencies for charting:
uv add "pyballistic[charts]"

You can also install requirements manually. For example:

pipuv

pip install pyballistic.exts pandas matplotlib

uv add pyballistic.exts pandas matplotlib

To install latest version from sources in editable mode:

git clone https://github.com/dbookstaber/pyballistic
cd pyballistic

pipuv

# from repo root
py -m pip install -e .[dev]                        # main package editable
py -m pip install -e ./pyballistic.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)