Control de captura
Cada recorrido recibe un control de captura en la parte superior de sus resultados. Indica cómo se grabó el recorrido y avisa cuando es probable que la grabación dé conteos poco fiables.
Qué mide
- Resolución del original.
- Nitidez: la varianza del laplaciano en cada fotograma, con su lado largo redimensionado a 1024 px, para que los clips de cualquier resolución compartan una misma escala. Indica la mediana y el percentil 10 sobre los fotogramas.
- Tamaño del fruto: el lado corto de cada caja de fruto a la misma escala de 1024 px, como p10, mediana y p90.
- Proporción sin maduración: los frutos cuyo recorte era demasiado pequeño para evaluarlo.
Avisos y umbrales
| Aviso | Se activa cuando | Qué hacer |
|---|---|---|
| Demasiado lejos | El fruto mediano mide menos de 29 px, o la mitad o más de los frutos no tienen maduración | Acérquese o grabe en 4K |
| Demasiado cerca | El fruto del percentil 90 supera los 60 px | Aléjese. Un tomate grande puede recibir varias cajas |
| Desenfocado | La nitidez mediana es inferior a 300, o el percentil 10 es inferior a 300 en tres fotogramas o más | Camine más despacio, mantenga el móvil firme y limpie el objetivo |
Los avisos de tamaño necesitan al menos 5 frutos en el recorrido. «Demasiado lejos» y «demasiado cerca» nunca se activan a la vez. Cuando la mediana indica «demasiado lejos» pero los frutos grandes indican «demasiado cerca», prevalece «demasiado cerca»: de cerca, el detector añade cajas pequeñas sobre partes de tomates grandes, y esas cajas hacen bajar la mediana.
De dónde salen los umbrales
- 29 px es el fruto más pequeño cuyo recorte con margen alcanza los 32 px que evalúa el clasificador de maduración.
- 60 px en el percentil 90 procede de fotogramas medidos uno a uno. En 60 fotogramas 4K tomados de cerca con el móvil, marca 40. En esos fotogramas, el análisis descarta las cajas cuyo lado corto es inferior al 15 % del percentil 90, en su mayoría trozos de un mismo tomate grande, lo que lleva su conteo de un 61 % por encima a un 31 % por encima. Los otros 20 fotogramas de móvil quedan por debajo del límite porque sus cajas pequeñas hacen bajar el percentil 90. El análisis también descarta las cajas inferiores al 35 % del percentil 90 en un fotograma por debajo del límite cuando al menos el 12 % de sus cajas se solapan con una caja de 2,5 veces su área y el percentil 90 es al menos 2,2 veces la mediana. Eso lleva esos 20 fotogramas de un 158 % por encima a un 100 % por encima. No cambia ningún fotograma de dron, de recorrido de prueba ni de foto de ejemplo, y en el conjunto de pasillos conserva todos los frutos etiquetados que encontraba antes. En un conjunto público de pasillos marca 5 de 146 fotogramas, todos ellos tomas cercanas. No marca ninguno de 35 fotogramas de dron, ni de 12 fotogramas de un recorrido en 960×540, ni de las 4 fotos de ejemplo. La mediana no sirve aquí: las cajas de más sobre partes de tomates grandes la hacen bajar a unos 25 px en los fotogramas cercanos.
- 300 queda por debajo de los conjuntos públicos nítidos (percentil 10 entre 555 y 764) y por encima de una foto de ejemplo poco nítida (178).
Control en directo al grabar
Los mismos umbrales también funcionan en directo. Grabar un recorrido, en la aplicación, envía un fotograma aproximadamente una vez por segundo y muestra un único resultado con una indicación sencilla, antes de empezar a caminar y mientras graba (consulte Grabar un recorrido).
| Resultado | Aparece cuando |
|---|---|
| Acérquese | El fotograma recibiría el aviso «demasiado lejos»: fruto mediano por debajo de 29 px, o la mitad o más de los frutos demasiado pequeños para la maduración |
| Aléjese | El fotograma recibiría el aviso «demasiado cerca»: fruto del percentil 90 por encima de 60 px |
| Estabilice | La nitidez del fotograma es inferior a 300 |
| No hay frutos a la vista | Menos de 5 frutos, demasiado pocos para juzgar la distancia |
| Bien | Ninguno de los anteriores |
La distancia va primero: un fotograma que está a la vez demasiado lejos y desenfocado indica «Acérquese». Sobre el fotograma solo se ejecuta el detector de frutos, así que el control responde en menos de un segundo. No evalúa la maduración, no guarda ninguna copia del fotograma y nunca cuenta como recorrido. La proporción de frutos demasiado pequeños para la maduración se calcula con la resolución a la que usted graba, de modo que una grabación en 4K considera suficientemente grandes más frutos que el fotograma de vista previa, más pequeño.
Un fotograma puede diferir del recorrido completo. El control de captura del recorrido subido es el que tiene la última palabra.
En la API
El mismo bloque figura en el resultado de la observación como quality, con resolution, sharpness, fruit_px (cuyo campo detections cuenta cajas sobre todos los fotogramas analizados, no frutos; count es un nombre antiguo para lo mismo y se eliminará), without_ripeness, thresholds y una lista warnings de {code, message}. Los códigos son too_far, too_close y blurry.
El control en directo es POST /api/capture/check con una clave de organización. Envíe un JPEG en el campo de formulario frame, de 2 MB como máximo y 4096 px como máximo en su lado largo, y opcionalmente source_long_side, el lado largo de la grabación en píxeles. Devuelve verdict (move_closer, move_back, hold_steady, good o no_fruit), advice, fruit_count, median_fruit_px, p90_fruit_px, too_small_for_ripeness, sharpness y thresholds. Cada clave puede hacer un control por segundo, con ráfagas de tres. Los controles más rápidos reciben 429 con una cabecera Retry-After.