Clasificación de Imágenes con Potato

La clasificación de imágenes es una piedra angular de la visión por computadora. Ya sea que estés construyendo un sistema de categorización de productos, un pipeline de moderación de contenido o un clasificador de imágenes médicas, Potato proporciona las herramientas que necesitas para un etiquetado eficiente de imágenes.

Lo Que Aprenderás

Configurar tareas de anotación de imágenes
Clasificación de etiqueta única y multi-etiqueta
Estructuras de categorías jerárquicas
Control de calidad para tareas de imágenes

Clasificación Básica de Imágenes

Comencemos con una tarea simple de clasificación de etiqueta única.

Configuración

yaml

annotation_task_name: "Product Image Classification"
 
# Image data
data_files:
  - data/products.json
 
item_properties:
  id_key: product_id
  text_key: image_url
 
# Classification labels
annotation_schemes:
  - annotation_type: image_annotation
    name: category
    description: "What type of product is shown?"
    labels:
      - Electronics
      - Clothing
      - Home & Garden
      - Sports & Outdoors
      - Books & Media
      - Other
    keyboard_shortcuts:
      Electronics: "1"
      Clothing: "2"
      "Home & Garden": "3"
      "Sports & Outdoors": "4"
      "Books & Media": "5"
      Other: "6"

Formato de Datos

Crea data/products.json:

json

{"product_id": "P001", "image_url": "/images/products/laptop.jpg"}
{"product_id": "P002", "image_url": "/images/products/tshirt.jpg"}
{"product_id": "P003", "image_url": "/images/products/garden_tools.jpg"}
{"product_id": "P004", "image_url": "https://example.com/images/basketball.jpg"}

Las imágenes pueden ser rutas locales o URLs.

Clasificación Multi-Etiqueta

Para imágenes que pertenecen a múltiples categorías:

yaml

annotation_schemes:
  - annotation_type: multiselect
    name: attributes
    description: "Select all attributes that apply to this image"
    labels:
      - Contains people
      - Outdoor scene
      - Indoor scene
      - Contains text
      - Product photo
      - Lifestyle photo
      - Close-up shot
      - Wide angle
    min_selections: 1
    max_selections: 5

Categorías Jerárquicas

Para taxonomías complejas, usa etiquetas anidadas:

yaml

annotation_schemes:
  - annotation_type: radio
    name: main_category
    description: "Primary category"
    labels:
      - Apparel
      - Electronics
      - Home
 
  - annotation_type: radio
    name: subcategory
    description: "Subcategory"
    conditional:
      depends_on: main_category
      options:
        Apparel:
          - Tops
          - Bottoms
          - Footwear
          - Accessories
        Electronics:
          - Phones
          - Computers
          - Audio
          - Cameras
        Home:
          - Furniture
          - Decor
          - Kitchen
          - Bedding

Evaluación de Calidad de Imagen

Agrega verificaciones de calidad junto con la clasificación:

yaml

annotation_schemes:
  - annotation_type: radio
    name: category
    description: "Product category"
    labels: [Electronics, Clothing, Home, Other]
 
  - annotation_type: radio
    name: image_quality
    description: "Is this image suitable for the product catalog?"
    labels:
      - name: Approved
        description: "Clear, well-lit, product is visible"
      - name: Needs review
        description: "Minor issues but potentially usable"
      - name: Rejected
        description: "Poor quality, wrong product, or inappropriate"
 
  - annotation_type: multiselect
    name: quality_issues
    description: "If not approved, what issues are present?"
    labels:
      - Blurry or out of focus
      - Poor lighting
      - Wrong product shown
      - Watermark or text overlay
      - Inappropriate content
      - Multiple products in frame
    conditional:
      depends_on: image_quality
      show_when: ["Needs review", "Rejected"]

Configuración Avanzada de Imágenes

Para personalización avanzada de la visualización de imágenes, configura el tipo image_annotation en tus esquemas de anotación y usa CSS o estilos personalizados según sea necesario.

Ejemplo Completo

Aquí tienes una configuración lista para producción:

yaml

annotation_task_name: "E-commerce Image Classification"
 
data_files:
  - data/images.json
 
item_properties:
  id_key: sku
  text_key: image_path
 
annotation_schemes:
  - annotation_type: image_annotation
    name: primary_category
    description: "Select the main product category"
    labels:
      - Electronics
      - Clothing & Accessories
      - Home & Living
      - Beauty & Personal Care
      - Sports & Fitness
      - Toys & Games
      - Other
    required: true
    keyboard_shortcuts:
      Electronics: "1"
      "Clothing & Accessories": "2"
      "Home & Living": "3"
      "Beauty & Personal Care": "4"
      "Sports & Fitness": "5"
      "Toys & Games": "6"
      Other: "7"
 
  - annotation_type: multiselect
    name: image_attributes
    description: "Select all that apply"
    labels:
      - White background
      - Lifestyle shot
      - Multiple angles
      - Model wearing/using
      - Size reference included
      - Brand visible
    required: false
 
  - annotation_type: radio
    name: listing_ready
    description: "Is this image ready for product listing?"
    labels:
      - Yes - Ready to publish
      - No - Needs editing
      - No - Reshoot required
    required: true
 
annotation_guidelines:
  title: "Image Classification Guidelines"
  content: |
    ## Category Selection
    Choose the most specific category that fits the product.
 
    ## Image Quality
    - "Ready to publish": Clear, professional, meets standards
    - "Needs editing": Good photo but needs cropping/color correction
    - "Reshoot required": Fundamentally unsuitable

Consejos para la Anotación de Imágenes

Configuración consistente del monitor: Asegurar que los anotadores tengan pantallas calibradas
Definiciones claras de categorías: Incluir imágenes de ejemplo en las guías
Manejar casos extremos: Documentar qué hacer con imágenes ambiguas
Calibración regular: Revisar muestras juntos como equipo

Próximos Pasos

Aprender anotación de cuadros delimitadores para detección de objetos
Configurar anotación de polígonos para segmentación
Explorar anotación de video para tareas temporales

Ver documentación completa de anotación de imágenes en /docs/features/image-annotation.