Command Sessions
Record pitch command by marking the intended target and the actual location of every pitch, then review miss distance, execution rate, heat maps and progress across sessions.
Overview
A command session is a bullpen log. For every pitch you mark where the pitcher meant to throw and where the ball went, on a strike zone split into 13 zones, and enter the pitch type and velocity. The app works out how far the pitch missed in inches, whether it counts as executed, and charts the session as a pitch plot or heat map. Across sessions it tracks average miss distance so you can see command improve.
Pitch Command sits under Data Tracking in the sidebar. It is a toggleable feature, on by default; Connected Performance support can switch it off for an organization. Coaches, club coaches and admins record sessions. Athletes see the menu and can review their own sessions and analytics, but recording is a staff action.
How To
Find an athlete's sessions
Staff land on /app/command, a table of every athlete in the organization:
| Column | What it shows |
|---|---|
| Athlete Name | Filter it with Filter by athlete name; Clear resets. |
| Total Command Sessions | Count of sessions recorded for the athlete. |
| Actions | Add New starts a session; View (N) opens their list. |
"No command sessions recorded yet." means no athlete has a session.
An athlete who opens Pitch Command goes straight to their own list at /app/command/:athleteId. That page shows the analytics (below), Input New Command Session, and Recent Sessions: the ten most recent sessions, each with its number, Date, Athlete, pitch count, View Details and Delete. Deleting is immediate and shows "Session Deleted".
Record a session
- Click Add New (staff table) or Input New Command Session (athlete page). The tracker opens at
/app/command/:athleteId/input. - Step 1 of 2, Intended Location: click the target spot on the zone, or press a zone number 1 to 13 on the keyboard. Zones 1 to 9 are the strike zone grid; 10 to 13 are the four outer corners.
- Step 2 of 2, Actual Location: click or key in where the pitch ended up. Shift + Tab goes back to step 1.
- Under Pitch Details enter Velocity (mph) and pick a Pitch Type: FF, CH, CB, SL, 2S, SP, S or CU.
- Click Submit Pitch. It stays disabled until both a type and a velocity are set. Clear wipes the two marks.
The first submitted pitch creates the session, dated today, and the URL changes to /app/command/:athleteId/input/:sessionId. Every pitch after that saves straight into the session ("Pitch saved successfully") and appears in Session Progress: #, Distance, X Miss, Y Miss, Velocity, Type, Executed.
How a pitch is scored:
- The zone image is 300 by 450 pixels and represents 17 by 44 inches. Miss distances are converted at that scale.
- A pitch is Executed when the actual mark lands inside the target circle. An executed pitch has a total distance of 0; its X and Y miss are still recorded.
- Keyboard zone entry waits a quarter second after the last digit, so 1 then 2 within that window is zone 12.
Click Complete Session when you are done. It takes you to the session's view page.
Continue a session later
Open the session with View Details and click Continue session. New pitches append to the same session; the session date does not change.
Review a session
/app/command/:athleteId/view/:sessionId shows "Command Session {date}" with:
- Show Heat Map / Show Pitch Plot to switch views. The plot draws each target as a blue circle, the actual location as a green dot (executed) or red dot (missed), and an arrow between them. Hover a dot for type, velocity and distance.
- Average miss distance in inches and Execution Percentage for the session.
- A pitch table: Pitch #, Pitch Type, Total Distance, X Miss Distance, Y Miss Distance, Velocity, Executed.
Back returns to /app/command.
Read the analytics
The top of an athlete's session list (/app/command/:athleteId) is built from /api/commandSession/analytics, which pools every pitch the athlete has recorded:
- A heat map of all pitches.
- Session Progress: a line chart of Average Miss Distance (inches) per session, oldest to newest (Sessions (Chronological Order)). Only sessions that contain pitches count.
The section is hidden until the athlete has at least one pitch. Executed pitches count as 0 inches, so a session of all executed pitches pulls the line down to zero.
Record command from a workout
Exercises whose type is Command show a Tracker button while an athlete tracks the workout. It opens the same input page. Complete Session then returns to the workout and marks that exercise complete ("Command session completed") instead of opening the session view.
Who can do what
| Action | Athlete | Parent | Staff (coach, club coach, admin) |
|---|---|---|---|
| See the Command menu | Yes | No | Yes |
| List sessions and analytics | Own only | Linked athletes | Any athlete in org |
| Record, continue or delete a session | No | No | Yes |
A session belongs to its athlete, so staff of another organization get a not-found response for its id.
Tips
- Record from a laptop and use the number keys. A pitch is two keystrokes plus velocity and type, which keeps up with a live bullpen.
- Enter velocity before the first pitch; Submit Pitch is disabled without it, and the value stays in the field for the next pitch.
- Complete the session when the bullpen ends. The analytics line uses the session date, which is the day the first pitch was saved.
- Deleting a session from the list has no confirmation step. Open View Details first if you are not sure which one it is.
Troubleshooting
Submit Pitch is greyed out. A pitch type or velocity is missing. Both are required.
Clicking the zone does nothing. Both marks are already placed. Click Clear, or submit the pitch.
"Failed to create session" or "Failed to save pitch". Recording needs staff access to the athlete. Athlete and parent accounts can view sessions but not add pitches.
The analytics section is empty. It appears only once a pitch exists. "No line graph data available. Sessions need pitch data with miss distances to generate the progress chart." means sessions exist without pitches.
The Command menu is missing. The Command feature is switched off for your organization, or your role is parent.
Related
- Creating & Managing Assessments
- Tracking a Workout (Athletes)
- Single Athlete Reports
- Manage Your Settings