BALLDocumentación de BallTrack
Guía oficial para calibrar el entorno, entender el motor 3D y maximizar la precisión de la inferencia neuronal en tus pitcheos.
El Umpire Digital (Pitch Tracker)
La esencia de BallTrack es actuar como un sistema de arbitraje y análisis avanzado. Es un tracker de pitcheos automatizado que determina con precisión matemática si un lanzamiento es Bola o Strike.
Utilizando una Red Neuronal Propietaria procesada a través de ONNX Runtime, el sistema rastrea la bola fotograma a fotograma. Tras soltar el pitcheo, reconstruye la trayectoria exacta en un estadio virtual 3D y la hace cruzar a través de tu zona de strike personalizada para emitir un veredicto casi instantáneo.
Ejecución Local
No necesitas conexión a internet para correr BallTrack. Toda la inferencia pesada ocurre en tu GPU/CPU local, asegurando privacidad total y cero latencia de red.
Montaje de Cámara (Hardware)
La calidad de la cámara y su posición son el 90% del éxito. El algoritmo hace magia, pero necesita ojos claros para trabajar.
- Ángulo Óptimo: Detrás del umpire (viendo hacia el pitcher) o en el jardín central (viendo hacia el home). La cámara debe estar alineada al centro del plato.
- Altura y Línea de Visión: Es crucial elevar la cámara (preferiblemente anclada a la malla superior del backstop o usando un trípode alto de más de 2 metros) apuntando ligeramente hacia abajo. Una cámara baja a nivel del terreno corre el riesgo constante de que el pitcher, el umpire, o los jugadores del cuadro (como el short stop o segunda base) bloqueen visualmente la trayectoria de la bola.
- Estabilidad: Es obligatorio el uso de un trípode resistente. Un celular vibrando en las manos arruinará el eje Z.
Calibración y Mapeo Espacial
Para que la inferencia sea precisa, debes hacer coincidir los elementos del mundo real con el entorno virtual. Durante el Modo Calibración, utiliza exclusivamente tu teclado para posicionar y escalar las zonas críticas:
Zona de Strike (Home)
↑ ↓ ← → Mover la posición de la zona de strike
Z X C V Ajustar el tamaño (alto y ancho) de la zona
Zona de Windup (Detección del Pitcher)
T F G H Mover la caja de detección de lanzamiento
7 8 9 0 Ajustar las dimensiones de la zona de windup
Placa del Pitcher
W A S D Desplazar la placa de pitcheo físicamente
Q E Modificar el ancho de la placa
Cámaras 3D y Navegación de Repeticiones
Una vez lanzado el pitcheo y fuera del modo calibración, BallTrack genera un replay tridimensional. Puedes pausar o inspeccionar el lanzamiento desde cualquier ángulo.
Atajos de Teclado Universales
W A S D Mover la cámara por el estadio
Click Derecho (Mantener) Rotar el ángulo de visión
Rueda del Ratón Zoom dinámico sobre la bola
Personalización Visual y Temas
BallTrack está diseñado no solo como una herramienta analítica, sino también como un producto listo para ser transmitido (Broadcast-ready). Puedes darle un toque único a tus streams o adaptar la estética del simulador a la identidad visual de tu propia liga o equipo.
- Temas del Entorno 3D: Cambia instantáneamente la atmósfera del estadio virtual alternando entre modos como Día Soleado, Noche (con iluminación artificial en el diamante) o el vibrante Cyber Neon. Todo depende del estilo que quieras proyectar a tu audiencia.
- Filtros de Feed de Cámara: De forma independiente al entorno 3D, el panel cuenta con sliders de Saturación, Gamma y Exposición, útiles si necesitas compensar o ajustar el color crudo que está enviando tu cámara física.
Escenarios Críticos a Evitar
Nuestro algoritmo visual está entrenado para ignorar ruido visual, pero tiene puntos ciegos. Evita a toda costa los siguientes escenarios para no quebrar el tracking:
Pérdida Crítica de Inferencia
- Motion Blur severo: Si tu cámara graba a baja velocidad de obturación (shutter speed), la bola rápida se verá como una "mancha transparente". La IA no detecta fantasmas.
- Contraluz (Lens Flare): Apuntar el lente directamente al sol poniente o a los reflectores gigantes del estadio cegará al sensor.
- Camuflaje: Evita usar bolas extremadamente sucias o negras si estás en campos de tierra oscura. El contraste es tu mejor amigo.
- Tráfico Peatonal: Evita que los jugadores calienten caminando de izquierda a derecha por detrás del pitcher en la línea de visión directa.