Skip to main content

footsbviz

Zero-friction helpers to visualize StatsBomb Open Data — without manual data engineering.

⚠️ Not affiliated with StatsBomb. Please respect the StatsBomb Open Data license.

PyPI version

Install

pip install footsbviz
# or with optional viz extras:
pip install "footsbviz[viz]"

Quickstart

import footsbviz as fz

# events_df = (your StatsBomb events DataFrame with standard columns)
fig, ax = fz.create_shot_map_team(
    events_df, team_name="Belgium", team_colour="#d00",
    pitch_length_x=120, pitch_length_y=80,
    orientation="horizontal", aspect="full",
    x_dimensions=15, y_dimensions=7,
    subtitle="Example Match", save_path=None, show=True
)

Credits

This library draws inspiration from community work on StatsBomb visuals. Certain function ideas and column expectations originated in publicly shared scripts; we re-implemented them in a package-friendly way and added a stable API. See CREDITS.md for attribution.

Metadata

Release files for footsbviz 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for footsbviz 0.2.0
File Size Uploaded Provenance Actions
footsbviz-0.2.0.tar.gz 19.7 kB Without provenance Details for footsbviz-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for footsbviz 0.2.0
File Interpreter ABI Platform Actions
footsbviz-0.2.0-py3-none-any.whl Python 3 none any Details for footsbviz-0.2.0-py3-none-any.whl

Total release size: 36.5 kB

Release files / footsbviz-0.2.0.tar.gz

Download URL footsbviz-0.2.0.tar.gz
Size 19.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3561ab7b9f99888b5dbc3be5030e0101e65ead76ec2ec90e22f8d6d8e741578e
BLAKE2b-256 checksum
How to use checksums
11dbe7080c40cc1073e763efd4f987eecd8dcd46b8cf88dba6960d503d9c74d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.4

Release files / footsbviz-0.2.0-py3-none-any.whl

Download URL footsbviz-0.2.0-py3-none-any.whl
Size 16.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e30c76e7f78c20cc8e96d33bcdd6a6bfd11f7e435d04b1bf1f441692087be117
BLAKE2b-256 checksum
How to use checksums
d321d9598f776796c1ca8571a0ffeaf92b6bd5f8a80507d9b701b3af04eee22b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.4

Security for footsbviz 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page