Editor de anotaciones

Ultralytics Platform incluye un potente editor de anotaciones para etiquetar imágenes con cuadros delimitadores, polígonos, puntos clave, cuadros orientados y clasificaciones. El editor admite el dibujo manual y la anotación inteligente basada en SAM.

graph TB
    subgraph Manual["Manual Tools"]
        A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]
    end
    Manual --> H[Save Labels]
    AI --> H

Tipos de tareas admitidas

El editor de anotaciones admite los 5 tipos de tareas de YOLO:

Detalles de la tarea

Introducción

Para anotar imágenes:

1. Navega hasta tu conjunto de datos
2. Haz clic en una imagen para abrir el visor en pantalla completa
3. Haz clic en Edit para entrar en el modo de anotación
4. Selecciona tu herramienta de anotación en la barra de herramientas
5. Dibuja anotaciones en la imagen
6. Haz clic en Save cuando termines

graph LR
    A[Open Dataset] --> B[Click Image]
    B --> C[Click Edit]
    C --> D[Draw Annotations]
    D --> E[Save]
    E --> F[Next Image]
    F --> B

    style C fill:#2196F3,color:#fff
    style D fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff

Modos de anotación

El editor ofrece dos modos de anotación, seleccionables desde la barra de herramientas:

Herramientas de anotación manual

Cuadro delimitador (detección)

Dibuja cuadros rectangulares alrededor de los objetos:

1. Entra en el modo de edición y selecciona Draw
2. Haz clic y arrastra para dibujar un rectángulo
3. Suelta para completar el cuadro
4. Selecciona una clase en el menú desplegable

Polígono (segmento)

Dibuja máscaras poligonales precisas:

1. Entra en el modo de edición y selecciona Draw
2. Haz clic para añadir vértices, o mantén presionada la tecla Shift y mueve el ratón para dibujar puntos densos a mano alzada
3. Haz clic en el primer vértice, o presiona Enter o Escape para cerrar el polígono
4. Selecciona una clase en el menú desplegable

Punto clave (pose)

Anota poses usando plantillas de esqueleto. Selecciona una plantilla en la barra de herramientas, haz clic una vez para colocar todos los puntos clave y luego arrastra cada punto clave individualmente para ajustar las posiciones.

1. Entra en el modo de edición y selecciona Draw
2. Elige una plantilla de esqueleto en el selector de plantillas de la barra de herramientas

3. Haz clic en la imagen para colocar todos los puntos clave a la vez
4. Arrastra los puntos clave individuales para ajustar sus posiciones
5. Presiona Enter para confirmar o Escape para cancelar

Plantillas de esqueleto integradas

El editor incluye 5 plantillas integradas:

Plantillas de esqueleto personalizadas

Crea plantillas personalizadas para cualquier estructura de pose:

1. Haz clic en el botón + junto al selector de plantillas
2. Opcionalmente, haz clic en Start from... para cargar keypoints y conexiones desde una plantilla existente como punto de partida
3. Coloca los keypoints en el lienzo haciendo clic
4. Nombra cada keypoint y personaliza los colores
5. Conecta los keypoints seleccionando dos puntos (las conexiones se dibujan automáticamente a medida que colocas keypoints secuenciales)
6. Guarda la plantilla para reutilizarla en todo tu dataset

Las plantillas personalizadas se guardan en tu cuenta y están disponibles en todos los datasets de pose.

Cuadro delimitador orientado (OBB)

Dibuja cajas rotadas para objetos inclinados:

1. Entra en el modo de edición y selecciona Draw
2. Haz clic y arrastra para dibujar una caja inicial
3. Usa el controlador de rotación para ajustar el ángulo
4. Arrastra los controladores de las esquinas para cambiar el tamaño
5. Selecciona una clase en el menú desplegable

Clasificación (Classify)

Asigna etiquetas de clase a nivel de imagen:

1. Entra en modo edición
2. Aparece un panel lateral con botones de selección de clase
3. Haz clic en los botones de clase o presiona las teclas numéricas 1-9

Anotación inteligente (Smart Annotation)

La anotación inteligente añade anotación asistida por modelos al editor. En modo Smart, puedes usar Segment Anything Model (SAM) para anotación basada en clics o utilizar modelos Ultralytics YOLO preentrenados y tus propios modelos YOLO ajustados para añadir predicciones como anotaciones. La anotación inteligente está disponible para tareas de detect, segment y OBB.

Anotación inteligente SAM

Con un modelo SAM seleccionado:

1. Entra en modo edición y selecciona Smart o presiona S
2. Haz clic en el objeto que quieres anotar: SAM genera una máscara inicial en tiempo real
3. Refina la máscara con clics adicionales: haz clic fuera de la máscara actual para añadir cobertura, o haz clic dentro de la máscara actual para restar regiones
4. Presiona Enter o Escape para guardar la anotación, o habilita auto-apply para flujos de trabajo de un solo clic

graph LR
    A[Press S] --> B[Left-click Object]
    B --> C[SAM Generates Mask]
    C --> D{Auto-apply?}
    D -->|Yes| E[Mask Applied Automatically]
    D -->|No| F{Accurate?}
    F -->|Yes| G[Enter to Save]
    F -->|No| H[Add +/- Points]
    H --> C

    style A fill:#2196F3,color:#fff
    style C fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff
    style G fill:#4CAF50,color:#fff

La anotación inteligente SAM puede generar:

• Polígonos para tareas de segmentación
• Cajas delimitadoras para tareas de detección
• Cajas orientadas para tareas OBB

Modo Auto-Apply

El modo auto-apply acelera la anotación inteligente al guardar automáticamente la máscara SAM después de cada clic; no es necesario presionar Enter. Actívalo con el botón auto-apply en la barra de herramientas o presiona A.

Selección de modelo SAM

Cuando el modo Smart está activo, aparece un selector de modelos en la barra de herramientas. Hay cinco modelos SAM disponibles; elige según el equilibrio entre velocidad y precisión que se adapte a tu dataset:

Cambiar de modelo mientras el modo Smart está activo reinicializa automáticamente el predictor para la imagen actual.

Anotación inteligente YOLO

Con un modelo YOLO seleccionado, la anotación inteligente puede añadir predicciones de modelos Ultralytics preentrenados o tus propios modelos ajustados.

1. Entra en modo edición y selecciona Smart o presiona S
2. Selecciona un modelo YOLO del selector en la barra de herramientas (Official o My Models)
3. Haz clic en Predict
4. Revisa las anotaciones añadidas y realiza las correcciones necesarias

Barra lateral de clases

El editor de anotaciones incluye una barra lateral de clases plegable a la derecha del lienzo. La barra lateral proporciona:

• Buscar clases: Filtra la lista de clases escribiendo en el campo de búsqueda. Presiona Enter en una coincidencia exacta para seleccionarla, o crea una clase nueva si no existe ninguna coincidencia.
• Crear nueva clase en línea: Haz clic en Add class al final de la lista, escribe un nombre y, opcionalmente, elige un color personalizado. Presiona Enter para crearla.
• Editar nombre de clase en línea: Pasa el cursor sobre un nombre de clase y haz clic en el icono del lápiz para renombrarlo.
• Selector de color: Haz clic en la muestra de color junto a cualquier clase para cambiar su color.
• Recuento de anotaciones por clase: Cada fila de clase muestra un recuento en superíndice de las anotaciones.
• Expandir/colapsar: Haz clic en el chevrón para expandir una clase y ver las anotaciones individuales listadas debajo.
• Resaltado bidireccional al pasar el cursor: Pasar el cursor sobre una anotación en el lienzo la resalta en la barra lateral, y viceversa. La barra lateral se desplaza y expande automáticamente a la clase relevante.
• Ocultar/mostrar anotaciones individuales: Haz clic en el icono del ojo en cualquier fila de anotación para alternar su visibilidad en el lienzo.
• Eliminar anotaciones: Haz clic en el icono de la papelera en cualquier fila de anotación para eliminarla.
• Atajos de teclado: Pulsa 1-9 para seleccionar rápidamente las 9 primeras clases.

Menú contextual

Haz clic derecho en las anotaciones seleccionadas para abrir un menú contextual con:

Controles de visibilidad

El menú desplegable de visibilidad (icono del ojo) te permite alternar la visualización de elementos individuales:

Cursor de retícula

En el modo edición, una superposición de retícula sigue la posición del cursor y muestra las coordenadas de los píxeles en el lienzo. Esto ayuda a colocar anotaciones con precisión. Alértalo mediante el menú desplegable de visibilidad.

Vista previa al pasar el ratón SAM

En el modo Inteligente, SAM proporciona una vista previa en tiempo real antes de hacer clic en cualquier punto. Esta vista previa está disponible para tareas de detect, segment y OBB. Una vez que añades clics de refinamiento, la vista previa se actualiza para reflejar la máscara actual y el tipo de anotación para la tarea activa.

Edición de vértices de polígonos

Para anotaciones de segmento, puedes editar los vértices del polígono después de dibujarlos:

• Mover vértices: Arrastra cualquier controlador de vértice para reposicionarlo
• Eliminar vértices: Selecciona un vértice y pulsa Delete para eliminarlo

Gestión de clases

Creación de clases

Define clases de anotación para tu conjunto de datos en la pestaña Classes:

1. Navega a la pestaña Classes
2. Usa el campo de entrada en la parte inferior para escribir el nombre de una clase
3. Haz clic en Add o pulsa Enter
4. Se asigna un color automáticamente de la paleta de Ultralytics

Añadir nueva clase durante la anotación

Puedes crear nuevas clases directamente mientras anotas sin salir del editor:

1. Dibuja una anotación en la imagen
2. En el menú desplegable de clases, haz clic en Add New Class
3. Introduce el nombre de la clase
4. Pulsa Enter para crearla y asignarla

Esto permite un flujo de trabajo fluido donde puedes definir clases a medida que encuentras nuevos tipos de objetos en tus datos.

Edición de clases

• Renombrar: Haz clic en el nombre de una clase en la tabla para editarlo en línea
• Cambiar color: Haz clic en la muestra de color para abrir el selector de color
• Buscar: Usa el campo de búsqueda para filtrar clases por nombre
• Ordenar: Haz clic en los encabezados de columna para ordenar por nombre, recuento de etiquetas o recuento de imágenes

Colores de clase

Cada clase tiene asignado un color de la paleta de Ultralytics. Puedes personalizar los colores usando el selector de color en la pestaña Classes. Los colores son consistentes en toda la plataforma para un fácil reconocimiento.

Atajos de teclado

Anotación eficiente con atajos de teclado:

Deshacer/Rehacer

El editor de anotaciones mantiene un historial completo de deshacer/rehacer:

• Deshacer: Cmd/Ctrl+Z
• Rehacer: Cmd/Ctrl+Y

El historial registra:

• Añadir anotaciones (individuales y por lotes)
• Editar anotaciones (mover, cambiar tamaño, rotar)
• Eliminar anotaciones (individuales y por lotes)
• Cambiar clases (individuales y por lotes)
• Reordenar anotaciones (orden Z)
• Editar vértices de polígono (añadir, eliminar, mover)
• Mover puntos clave

Guardar anotaciones

Las anotaciones se guardan cuando haces clic en Save o presionas Cmd/Ctrl+S:

• Guardar: Haz clic en el botón de guardar o presiona Cmd/Ctrl+S
• Cancelar: Haz clic en cancelar para descartar los cambios
• Escape: Guarda si hay cambios sin guardar; de lo contrario, sale del modo de edición

Preguntas frecuentes

¿Qué tan precisa es la anotación de SAM?

SAM proporciona máscaras de alta calidad para la mayoría de los objetos. La precisión depende de:

• La distinción del objeto respecto al fondo
• La calidad y resolución de la imagen
• El número de puntos positivos/negativos proporcionados

Para obtener los mejores resultados, comienza con un clic en el centro del objeto, luego usa clics fuera de la máscara para añadir cobertura y clics dentro de la máscara para sustraer objetos cercanos o fondo.

¿Puedo importar anotaciones existentes?

Sí, sube tu conjunto de datos con archivos de etiquetas en formato YOLO. La plataforma los analiza y muestra automáticamente en el editor.

¿Cómo anoto múltiples objetos de la misma clase?

Después de dibujar una anotación:

1. Mantén seleccionada la misma clase
2. Dibuja la siguiente anotación
3. Repite hasta que todos los objetos estén etiquetados

El atajo de teclado 1-9 selecciona clases rápidamente.

¿Puedo entrenar con conjuntos de datos parcialmente anotados?

Sí, pero para obtener los mejores resultados:

• Etiqueta todos los objetos de tus clases objetivo en cada imagen
• Usa el filtro de etiquetas establecido en Unlabeled para identificar las imágenes que aún necesitan anotación
• Las imágenes no etiquetadas se excluyen del entrenamiento; solo las imágenes etiquetadas contribuyen a la pérdida

¿Qué modelo SAM debería usar?

SAM 3 es el modelo predeterminado y de última generación: empieza por ahí para obtener máscaras de mayor calidad. Cambia a SAM 2.1 Small para un flujo de trabajo interactivo más rápido en objetos comunes, o SAM 2.1 Large cuando necesites una mayor precisión de máscara en formas complejas. Usa SAM 2.1 Tiny para obtener la máxima velocidad en objetos simples de alto contraste.

¿Qué tareas admiten la anotación inteligente SAM?

La anotación inteligente SAM está disponible para las tareas de detect, segment y OBB. Las tareas de clasificación y pose solo usan anotación manual.

¿Puedo crear plantillas de esqueleto personalizadas para la anotación de pose?

Sí. Haz clic en el botón + junto al selector de plantillas de esqueleto para abrir el editor de plantillas. Coloca puntos clave, nómbralos, dibuja conexiones y guarda. Las plantillas personalizadas se almacenan en tu cuenta y están disponibles en todos los conjuntos de datos de pose.

¿Cómo cambio entre plantillas de esqueleto?

Haz clic en el menú desplegable del selector de plantillas en la barra de herramientas de anotación. Selecciona cualquier plantilla integrada (Person, Hand, Face, Dog, Box) o tus plantillas personalizadas guardadas. La plantilla seleccionada determina qué puntos clave se colocan al hacer clic en la imagen.