Editor de anotaciones#

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

graph TB
    subgraph Draw["Shape set by the dataset task"]
        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 compatibles#

El editor de anotaciones proporciona herramientas de anotación para 6 tipos de tareas de YOLO:

La verdad fundamental de profundidad es un mapa asociado que cargas, no algo que dibujas, por lo que el editor se abre en modo de solo lectura para un conjunto de datos de profundidad.

Detalles de la tarea#

Primeros pasos#

Para anotar imágenes:

1. Ve a tu conjunto de datos
2. Haz clic una vez en una imagen para abrir el editor de anotaciones a pantalla completa
3. Usa el modo predeterminado Draw o cambia a Smart cuando sea compatible
4. Selecciona una clase y añade o ajusta las 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

En los conjuntos de datos que puedes editar, los controles de anotación se activan en cuanto el visor a pantalla completa se abre en el escritorio. No hay ningún modo de edición independiente ni 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, pose y OBB, la barra de herramientas también proporciona el modo Smart cuando la anotación inteligente está disponible:

La anotación de pose utiliza Draw con una plantilla de esqueleto; su modo Smart ofrece únicamente modelos de pose YOLO, sin selector de SAM ni interruptor de aplicación automática. La clasificación utiliza directamente la barra lateral de clases y no muestra ninguna barra de herramientas de dibujo ni el botón Smart.

La anotación inteligente no está disponible actualmente para conjuntos de datos conectados respaldados por almacenamiento en la nube o On Premise.

Herramientas del modo Dibujar#

Cuadro delimitador (detección)#

Dibuja cuadros 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 el cuadro

Polígono (segmentación)#

Dibuja máscaras poligonales 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 puntos densos a mano alzada
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 mediante plantillas de esqueletos. Selecciona una plantilla en la barra de herramientas, haz clic una vez para colocar todos los puntos clave y, después, arrastra puntos clave 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 a la vez
4. Arrastra puntos clave individuales para ajustar sus posiciones

Plantillas de esqueletos 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 + situado junto al selector de plantillas
2. Si quieres, haz clic en Empezar desde... para cargar los puntos clave y las conexiones de una plantilla existente como punto de partida
3. Coloca los puntos clave en el lienzo haciendo clic
4. Asigna un nombre a cada punto clave y personaliza los colores
5. Conecta los puntos clave seleccionando dos puntos (las conexiones se dibujan automáticamente al colocar puntos clave consecutivos)
6. Guarda la plantilla para reutilizarla en todo tu conjunto de datos

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

Cuadro delimitador orientado (OBB)#

Dibuja cuadros girados para objetos inclinados:

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 controlador de rotación para ajustar el ángulo
4. Arrastra los controladores 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 a pantalla completa
2. Selecciona una clase en la barra lateral de clases o pulsa una tecla numérica del 1-9

Anotación inteligente#

La anotación inteligente añade anotación asistida por modelo al editor. En el modo inteligente, puedes usar el Segment Anything Model (SAM) para la anotación basada en clics o utilizar modelos Ultralytics YOLO previamente entrenados y tus propios modelos YOLO ajustados para añadir predicciones como anotaciones. La anotación inteligente de SAM está disponible para las tareas de detect, segment, semantic y OBB; la anotación inteligente de YOLO también cubre pose.

Anotación inteligente con SAM#

Con un modelo SAM seleccionado:

1. Selecciona Smart o pulsa S
2. Haz clic en el objeto que quieras anotar; SAM genera una máscara inicial en tiempo real
3. Perfecciona la máscara con clics adicionales: haz clic fuera de la máscara actual para ampliar la 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 auto-apply para trabajar con 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 con SAM puede generar:

• Polígonos para tareas de segmentación
• Cuadros delimitadores para tareas de detección
• Cuadros orientados para tareas OBB

Modo de aplicación automática#

El modo de aplicación automática acelera la anotación inteligente al guardar automáticamente la máscara de SAM después de cada clic, sin necesidad de pulsar Enter. Actívalo o desactívalo con el botón de aplicación automática de la barra de herramientas o pulsa A.

Selección del modelo SAM#

Cuando el modo inteligente está activo, aparece un selector de modelos en la barra de herramientas. Hay seis modelos SAM disponibles; elige según la relación entre velocidad y precisión que mejor se adapte a tu conjunto de datos:

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

Anotación inteligente con 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

Anotación por lotes#

La anotación por lotes ejecuta un modelo YOLO en todo un conjunto de datos en lugar de en la imagen abierta. Ábrela desde la página del conjunto de datos con Más acciones > Anotación por lotes, o desde la acción Inferencia de todo en la notificación flotante tras una predicción de YOLO en el editor. Está disponible para los editores de conjuntos de datos en conjuntos de datos alojados en Platform con hasta tres canales de imagen, para todas las tareas excepto profundidad.

1. Selecciona un modelo del selector (Official o My Models)
2. Ajusta los controles deslizantes de confianza (predeterminado 0.25) e IoU (predeterminado 0.7): la franja de Ejecución de prueba muestra lo que el modelo encuentra en unas pocas imágenes de muestra a medida que los mueves
3. Activa Incluir imágenes anotadas para ejecutar también sobre imágenes que ya tienen etiquetas; la ejecución añade lo que el modelo encuentra y conserva las etiquetas que ya tienen
4. Revisa el Costo estimado y haz clic en Iniciar

De forma predeterminada, solo se anotan las imágenes sin etiquetar y las etiquetas existentes nunca se modifican. Una ejecución necesita clases del conjunto de datos. Si las clases del modelo difieren de las del conjunto de datos, un paso de Mapear clases asigna cada clase del modelo a una clase del conjunto de datos o la omite, y en un conjunto de datos sin clases las crea; la ejecución comienza solo después de que existen las clases. Iniciar una ejecución guarda primero una versión del conjunto de datos, por lo que puedes restaurar el conjunto de datos si no te gusta el resultado.

La página del conjunto de datos muestra el progreso de la ejecución, y Detener conserva y factura las imágenes procesadas hasta el momento. Cuando finaliza la ejecución, un resumen muestra las imágenes procesadas y las anotaciones y clases añadidas.

Barra lateral de clases#

El editor de anotaciones incluye una barra lateral de clases contraíble 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 cuando haya una coincidencia exacta para seleccionarla o crea una clase nueva si no existe ninguna coincidencia.
• Crear una clase nueva 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 el nombre de una clase en línea: pasa el cursor 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 situada junto a cualquier clase para cambiar su color.
• Recuento de anotaciones por clase: cada fila de clase muestra un recuento superíndice de anotaciones.
• Expandir/contraer: haz clic en la flecha para expandir una clase y ver debajo las anotaciones individuales.
• Resaltado bidireccional al pasar el cursor: al pasar el cursor sobre una anotación en el lienzo, esta se resalta en la barra lateral, y viceversa. La barra lateral se desplaza automáticamente hasta la clase correspondiente.
• Ocultar/mostrar una clase completa: haz clic en el icono del ojo de una fila de clase para ocultar o mostrar a la vez todas las anotaciones de esa clase.
• Ocultar/mostrar anotaciones individuales: haz clic en el icono del ojo de cualquier fila de anotación para alternar su visibilidad en el lienzo.
• Eliminar anotaciones: haz clic en el icono de la papelera de cualquier fila de anotación para eliminarla.
• Atajos de teclado: Pulsa 1-9 para seleccionar rápidamente las 9 primeras clases, o H para alternar la visibilidad de todas las anotaciones de la imagen.

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 en forma de retícula#

Durante la anotació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 las anotaciones con precisión. Actívala o desactívala mediante el menú desplegable de visibilidad.

Vista previa al pasar el cursor con SAM#

En el modo Smart, SAM proporciona una vista previa en tiempo real al pasar el cursor antes de que hagas clic en cualquier punto. Esta vista previa está disponible para las tareas detect, segment, semantic y OBB. Cuando añades clics de refinamiento, la vista previa se actualiza para reflejar la máscara actual y el tipo de anotación de la tarea activa.

Edición de vértices de polígonos#

En las anotaciones de segmentación, puedes editar los vértices del polígono después de dibujarlo:

• Mover vértices: Arrastra cualquier controlador de vértice para cambiarlo de posición
• 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 de tu conjunto de datos en la pestaña Classes:

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

Añadir una clase nueva durante la anotación#

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

1. Dibuja una anotación en 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. Pulsa Intro para crearla y asignarla

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

Edición de clases#

• Cambiar el nombre: Haz clic en el nombre de una clase de la tabla para editarlo en línea
• Cambiar el color: Haz clic en la muestra de color para abrir el selector de color
• Buscar: Utiliza el campo de búsqueda para filtrar las clases por nombre
• Ordenar: Haz clic en los encabezados de las columnas para ordenar por índice, nombre, número de anotaciones o número de imágenes

Colores de las clases#

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

Atajos de teclado#

Anota de forma 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 el tamaño y girar)
• 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 y mover)
• Mover puntos clave

Guardar anotaciones#

Los cambios se guardan automáticamente un segundo después de la última edición de una anotación. También se guardan cuando pasas a otra imagen o cierras el editor a 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, fuera de la imagen o pulsa Escape; al cerrar, se guardan en segundo plano los cambios pendientes

Preguntas frecuentes#