Editor de anotaciones#

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

graph TB
    subgraph Draw["Draw Mode"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

Tipos de tareas admitidos#

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

Detalles de la tarea#

Introducción#

Para anotar imágenes:

1. Navega hasta tu dataset
2. Haz clic una vez en una imagen para abrir el editor de anotaciones en pantalla completa
3. Usa el modo predeterminado Draw, o cambia a Smart donde sea compatible
4. Selecciona una clase y añade o ajusta anotaciones directamente en la imagen
5. Continúa con otra imagen o cierra el editor; los cambios se guardan automáticamente después de cada edición

Para los conjuntos de datos que puedes editar, los controles de anotación están activos en cuanto se abre el visor a pantalla completa en el escritorio. No hay un modo de edición separado ni un botón Edit. En dispositivos móviles, y cuando no tienes acceso de edición, el visor a pantalla completa es de solo lectura.

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

Modos de anotación#

Draw es el modo predeterminado para tareas de anotación espacial. Para conjuntos de datos de detección, segmentación, semántica y OBB, la barra de herramientas también proporciona el modo Smart cuando la anotación inteligente está disponible:

La anotación de postura utiliza Draw con una plantilla de esqueleto. La clasificación utiliza la barra lateral de clases directamente y no muestra la barra de herramientas de dibujo.

La anotación inteligente no está disponible actualmente para conjuntos de datos conectados.

Herramientas del modo Draw#

Caja delimitadora (Detección)#

Dibuja cajas rectangulares alrededor de los objetos:

1. Selecciona una clase en la barra lateral de clases
2. En el modo predeterminado Draw, haz clic y arrastra para dibujar un rectángulo
3. Suelta para completar la caja

Polígono (Segmentación)#

Dibuja máscaras de polígono precisas:

1. Selecciona una clase en la barra lateral de clases
2. En el modo predeterminado Draw, haz clic para añadir vértices, o mantén pulsado Shift y mueve el ratón para dibujar a mano alzada puntos densos
3. Haz doble clic, haz clic en el primer vértice o pulsa Enter o Escape para cerrar el polígono

Punto clave (Pose)#

Anota poses utilizando plantillas de esqueleto. Selecciona una plantilla de la barra de herramientas, haz clic una vez para colocar todos los puntos clave y luego arrastra los puntos individuales para ajustar sus posiciones.

1. Selecciona una clase en la barra lateral de clases
2. En el modo predeterminado Draw, 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 de una vez
4. Arrastra los puntos clave individuales para ajustar sus posiciones

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 puntos clave y conexiones desde una plantilla existente como punto de partida
3. Coloca los puntos clave en el lienzo haciendo clic
4. Pon nombre a cada punto clave y personaliza los colores
5. Conecta los puntos clave seleccionando dos puntos (las conexiones se dibujan automáticamente a medida que colocas puntos clave 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 conjuntos de datos de postura.

Caja delimitadora orientada (OBB)#

Dibuja cajas rotadas para objetos en ángulo:

1. Selecciona una clase en la barra lateral de clases
2. En el modo predeterminado Draw, haz clic y arrastra para dibujar un cuadro inicial
3. Usa el manipulador de rotación para ajustar el ángulo
4. Arrastra los manipuladores de las esquinas para cambiar el tamaño

Clasificación (Classify)#

Asigna etiquetas de clase a nivel de imagen:

1. Haz clic en una imagen para abrir el editor en pantalla completa
2. Selecciona una clase en la barra lateral de clases o pulsa una tecla numérica de 1-9

Anotación inteligente#

La anotación inteligente añade anotación asistida por modelos al editor. En el modo Inteligente, puedes usar Segment Anything Model (SAM) para la 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 las tareas de detect, segment, semantic y OBB.

Anotación inteligente SAM#

Con un modelo SAM seleccionado:

1. Selecciona Smart o pulsa S
2. Haz clic en el objeto que deseas 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. Pulsa Enter o Escape para guardar la anotación, o activa autoaplicar para flujos de trabajo de un solo clic

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

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,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 de aplicación automática#

El modo de autoaplicación acelera la anotación inteligente guardando automáticamente la máscara de SAM después de cada clic; no es necesario pulsar Enter. Altérnalo con el botón de autoaplicación en la barra de herramientas o pulsa A.

Selección de modelo SAM#

Cuando el modo inteligente 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 mejor se adapte a tu dataset:

Cambiar de modelo mientras el modo inteligente 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 de tus propios modelos ajustados.

1. Selecciona Smart o pulsa S
2. Selecciona un modelo YOLO en el selector de modelos de 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 en el lado derecho del lienzo. La barra lateral proporciona:

• Buscar clases: Filtra la lista de clases escribiendo en el campo de búsqueda. Pulsa Enter en una coincidencia exacta para seleccionarla, o crea una nueva clase si no hay ninguna coincidencia.
• Crear nueva clase en línea: Haz clic en Add class en la parte inferior de la lista, escribe un nombre y, opcionalmente, elige un color personalizado. Pulsa Enter para crearla.
• Editar nombre de clase en línea: Pasa el ratón sobre el nombre de una clase y haz clic en el icono del lápiz para cambiarle el nombre.
• 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 contador en superíndice de las anotaciones.
• Expandir/contraer: Haz clic en el cheurón para expandir una clase y ver las anotaciones individuales listadas debajo.
• Resaltado bidireccional al pasar el ratón: Pasar el ratón sobre una anotación en el lienzo la resalta en la barra lateral, y viceversa. La barra lateral se desplaza automáticamente a la clase correspondiente.
• 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 primeras 9 clases.

Menú contextual#

Haz clic derecho sobre 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ículo#

Durante la anotación, una superposición en cruz rastrea la posición del cursor y muestra las coordenadas de los píxeles en el lienzo. Esto ayuda a colocar las anotaciones con precisión. Actívala o desactívala a través del menú desplegable de visibilidad.

Vista previa al pasar el ratón con SAM#

En el modo Inteligente, SAM proporciona una vista previa en tiempo real al pasar el ratón antes de hacer clic en cualquier punto. Esta vista previa está disponible para las tareas de detect, segment, semantic 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ígono#

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 las 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 un nombre de clase
3. Haz clic en Add o pulsa Enter
4. Se asigna un color automáticamente desde la paleta de Ultralytics

Agregar nueva clase durante la anotación#

Puedes crear clases nuevas directamente mientras anotas sin abandonar el editor:

1. Dibuja una anotación sobre la imagen
2. En la barra lateral de clases, haz clic en Add class (o escribe un nombre nuevo en el cuadro de búsqueda de la barra lateral)
3. Introduce el nombre de la clase
4. Presiona Enter para crear y asignar

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#

• Cambiar nombre: 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 índice, nombre, recuento de anotaciones o recuento de imágenes

Colores de clase#

A cada clase se le asigna un color de la paleta de Ultralytics. Puedes personalizar los colores utilizando el selector de color en la pestaña Classes; los colores seleccionados se utilizan en todo ese conjunto de datos.

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 rastrea:

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

Guardar anotaciones#

Los cambios se guardan automáticamente un segundo después de la última edición de anotación. También se guardan cuando pasas a otra imagen o cierras el editor en pantalla completa.

• Guardar ahora: Haz clic en el botón de guardar o pulsa Cmd/Ctrl+S
• Cerrar: Haz clic en el botón de cerrar, haz clic fuera de la imagen o pulsa Escape; al cerrar se activa un guardado en segundo plano para los cambios pendientes

FAQ#

¿Qué tan precisa es la anotación 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 Platform 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 rápidamente las clases.

¿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 Annotations configurado en Unannotated para identificar las imágenes que todavía necesitan anotación

¿Qué modelo SAM debería usar?#

SAM 3 es el modelo predeterminado y de última generación; comienza 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 a 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 y de alto contraste.

¿Qué tareas soportan la anotación inteligente SAM?#

La anotación inteligente SAM está disponible para tareas de detect, segment, semantic y OBB. Las tareas de clasificación y pose usan solo 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 incorporada (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.