explaingit

arkndjl/pitch-visualizer

Analysis updated 2026-05-18

1PythonAudience · dataComplexity · 2/5Setup · easy

TLDR

A Streamlit app that turns MLB Statcast data into pitch movement, velocity, and usage charts for any pitcher and season since 2015.

Mindmap

mindmap
  root((pitch visualizer))
    What it does
      Visualizes pitch data
      Search any pitcher
      Multi season charts
    Tech stack
      Python
      Streamlit
      pybaseball
    Use cases
      Movement charts
      Velocity distribution
      CSV export
    Audience
      Data analysts
      Baseball fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search any MLB pitcher and visualize their pitch movement across seasons

USE CASE 2

Compare a pitcher's velocity distribution and pitch usage in one view

USE CASE 3

Export a per-pitch summary table of velocity, spin rate, and movement to CSV

USE CASE 4

Study why certain pitchers are hard to read by comparing overlapping pitch profiles

What is it built with?

PythonStreamlitpandasmatplotlibpybaseball

How does it compare?

arkndjl/pitch-visualizera-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/53/5
Audiencedataresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

pip install requirements then streamlit run, needs internet access to pull Statcast data via pybaseball.

In plain English

Pitch Visualizer is a Python app built with Streamlit that lets you explore any MLB pitcher's arsenal using Statcast data, the tracking system baseball uses to measure things like pitch speed, spin, and movement. You search for a pitcher by name, choose one or more seasons going back to 2015 when Statcast data begins, and the app generates charts showing how their pitches move, how fast they are thrown, and how often each pitch type is used. The movement chart accounts for whether the pitcher throws left or right handed, adjusting the horizontal break direction so comparisons make sense regardless of handedness. Alongside the charts, the app shows a summary table with average velocity, spin rate, and movement for each pitch type, and that table can be exported as a CSV file for further analysis elsewhere. Data comes from the pybaseball library, which pulls MLB Statcast data, and the visualizations are built with pandas and matplotlib underneath the Streamlit interface. Setup is a simple pip install of the requirements followed by running the app with Streamlit. The README includes a sample walkthrough using pitcher Nolan McLean's 2025 season, showing how his pitch movement, usage, and velocity charts reveal that several of his pitches share similar speed and movement profiles, making them harder for batters to distinguish out of his hand. Planned future additions include a pitcher versus pitcher comparison view, filters based on count, batter handedness, or game situation, and overlays showing pitch outcomes like whiffs or hard contact. No license is stated in the README.

Copy-paste prompts

Prompt 1
Help me set up Pitch Visualizer locally and run it with Streamlit
Prompt 2
Show me how to add a pitcher versus pitcher comparison view to Pitch Visualizer
Prompt 3
Explain how pybaseball pulls Statcast data for use in Pitch Visualizer
Prompt 4
Walk me through exporting a pitcher's per-pitch summary table to CSV in this app

Frequently asked questions

What is pitch-visualizer?

A Streamlit app that turns MLB Statcast data into pitch movement, velocity, and usage charts for any pitcher and season since 2015.

What language is pitch-visualizer written in?

Mainly Python. The stack also includes Python, Streamlit, pandas.

How hard is pitch-visualizer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pitch-visualizer for?

Mainly data.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.