Saltar al contenido principal

Seguimiento de AprilTags

Los AprilTags se rastrean utilizando los valores estándar "tx", "ty" y "ta". No se requieren cambios de código para actualizar un robot de seguimiento de color/retroreflectivo a AprilTags. "botpose" y "campose" también se pueden utilizar para el seguimiento 3D en el espacio del campo y del objetivo.

Para un uso más avanzado con múltiples etiquetas, se puede utilizar el volcado de resultados JSON.

Inicio rápido para AprilTags en FRC​

  • Pestaña de entrada - Cambiar "Tipo de pipeline" a "Marcadores fiduciales"

  • Pestaña de entrada - Utilizar la resolución más alta disponible para seguimiento 3D, o usar 640x480 para seguimiento 2D puro.

  • Pestaña estándar - Asegurarse de que "familia" esté configurada como "AprilTag Classic 36h11"

  • Pestaña de entrada - Establecer "Nivel de negro" a cero

  • Pestaña de entrada - Establecer "Ganancia" a 15

  • Pestaña de entrada - Reducir la exposición para disminuir la pérdida de seguimiento durante el movimiento debido al desenfoque por movimiento. Dejar de reducir una vez que disminuya la fiabilidad del seguimiento. Es posible que necesite aumentar la exposición en eventos con poca iluminación.

  • Pestaña estándar - Si desea aumentar su velocidad de fotogramas, aumente el "Reducción de escala del detector"

  • Si desea utilizar seguimiento 3D y seguimiento 2D tx/ty simultáneamente, establezca la prioridad de ID de etiqueta en networktables para configurar la etiqueta preferida para el seguimiento 2D.

  • Haga clic en el icono de "Engranaje" y asegúrese de que el número de su equipo esté configurado y que se haya configurado una IP estática.

  • Haga clic en "Cambiar número de equipo" y "Cambiar configuración de IP" si cambió la configuración correspondiente. Reinicie su robot.

  • ¡Listo! Utilice "tx" y "ty" de networktables. Copie el ejemplo de código en la página de "primeros pasos".

Consejos​

Para un seguimiento ideal, considere lo siguiente:

  • Sus etiquetas deben ser lo más planas posible.
  • Su Limelight debe montarse por encima o por debajo de la altura de la etiqueta y angularse hacia arriba/abajo de manera que el objetivo esté centrado. Su objetivo debe verse lo más trapezoidal posible desde la perspectiva de su cámara. No querrá que su cámara esté completamente "de frente" a una etiqueta si desea evitar el volteo de etiquetas.

Existe una interacción entre las siguientes variables para el seguimiento de AprilTags:

  • Aumentar la resolución de captura siempre aumentará la precisión 3D y aumentará la estabilidad 3D. Esto también reducirá la tasa de volteo por ambigüedad desde la mayoría de las perspectivas. Generalmente aumentará el alcance. Esto reducirá la velocidad de fotogramas del pipeline.
  • Aumentar la reducción de escala del detector siempre aumentará la velocidad de fotogramas del pipeline. Disminuirá el alcance efectivo, pero en algunos casos esto puede ser insignificante. No afectará la precisión 3D, la estabilidad 3D o la precisión de decodificación.
  • Reducir la exposición siempre mejorará la resistencia al desenfoque por movimiento. Esto es realmente fácil de observar. Puede reducir el alcance.
  • Reducir el brillo y el contraste de la imagen generalmente mejorará la velocidad de fotogramas del pipeline y reducirá el alcance.
  • Aumentar la ganancia del sensor le permite aumentar el brillo sin aumentar la exposición. Puede reducir la estabilidad 3D y puede reducir la estabilidad del seguimiento.

Pestaña de entrada​

La pestaña de entrada aloja controles para cambiar la imagen de la cámara sin procesar antes de que pase por el pipeline de procesamiento. Consulte la página "Construyendo un pipeline retroreflectivo/de color" para obtener más detalles.

Para rastrear AprilTags:

  • Cambiar "Tipo de pipeline" a "Marcadores fiduciales"
  • Establecer "Nivel de negro" a cero

En este punto, se trata de equilibrar la ganancia del sensor y el tiempo de exposición. Desea poder ver las etiquetas con la exposición más pequeña posible para minimizar el desenfoque por movimiento. Esto generalmente requiere una configuración de ganancia del sensor alta. Para el seguimiento 2D simple, a menudo es aconsejable maximizar la ganancia del sensor y luego aumentar la exposición desde cero hasta que los objetivos se rastreen suficientemente. Asegúrese de que la familia correcta esté seleccionada en la pestaña "Estándar" si el seguimiento no funciona.

Pestaña estándar​

Familia​

Selecciona el tipo de familia fiducial/AprilTag. Para FRC, debe seleccionar "AprilTag Classic 36h11"

Tamaño del marcador​

Establece el tamaño esperado de las etiquetas que su robot encontrará en mm. Para FRC, esto debe establecerse en 165.1 (152.4 para etiquetas de 2023)

Reducción de escala del detector​

Aumentar este número resultará en mejoras significativas de rendimiento. Esto a veces resultará en un alcance reducido, pero el costo suele ser mínimo.

Filtros de ID​

Los filtros de ID le permiten especificar exactamente qué etiquetas le interesan. Para la mayoría de los equipos de FRC, cada pipeline debe configurarse para rastrear exactamente una ID de etiqueta. Esta es una lista de números separados por comas (por ejemplo, "0,1"). Esta característica es importante para eliminar la gran mayoría de falsos positivos.

Recorte​

El recorte elimina contenido de la imagen para obtener enormes mejoras de rendimiento. Use la clave NT "crop" para recortar dinámicamente durante los partidos

Clasificación y agrupación de múltiples objetivos​

Esto permite la funcionalidad exacta de agrupación que se ve en los pipelines retroreflectivos estándar. En la mayoría de los juegos, la única característica a modificar es el filtro de "Área", que le permitirá filtrar etiquetas pequeñas.