Addestra un modello di etichettatura delle immagini con AutoML Vision Edge

Per addestrare un modello di etichettatura delle immagini, fornisci ad AutoML Vision Edge un set immagini ed etichette corrispondenti. AutoML Vision Edge utilizza questo set di dati per addestrare nuovo modello nel cloud, che puoi utilizzare per l'etichettatura delle immagini dell'app. (consulta la Panoramica per informazioni generali su questa funzionalità.)

AutoML Vision Edge è un servizio servizio cloud. L'utilizzo del servizio è soggetto al contratto di licenza della piattaforma Google Cloud e ai Termini specifici di servizio, e viene fatturato di conseguenza. Per informazioni sulla fatturazione, consulta la pagina Prezzi di AutoML.

Prima di iniziare

1. Raccogliere i dati di addestramento

Per prima cosa, devi creare un set di dati di addestramento di immagini etichettate. Tieni presenti le seguenti linee guida:

  • Le immagini devono essere in uno dei seguenti formati: JPEG, PNG, GIF, BMP, ICO.

  • Ogni immagine deve avere dimensioni massime di 30 MB. Tieni presente che AutoML Vision Edge riduce la dimensione della maggior parte delle immagini durante la preelaborazione, pertanto in genere non è vantaggioso fornire immagini ad altissima risoluzione.

  • Includi almeno 10 ed eventualmente 100 o più esempi di ogni etichetta.

  • Includi più angolazioni, risoluzioni e sfondi per ogni etichetta.

  • I dati di addestramento devono essere il più simili possibile ai dati su cui devono essere eseguite le previsioni. Ad esempio, se il tuo caso d'uso prevede immagini sfocate immagini a bassa risoluzione (ad esempio quelle di una videocamera di sicurezza), i dati di addestramento deve essere composto da immagini sfocate e a bassa risoluzione.

  • I modelli generati da AutoML Vision Edge sono ottimizzati per le fotografie di oggetti nel mondo reale. Potrebbero non funzionare bene per raggi X, disegni a mano, documenti scansionati, ricevute e così via.

    Inoltre, in genere i modelli non possono prevedere etichette che non possono essere assegnate dagli esseri umani. Pertanto, se un essere umano non riesce ad assegnare le etichette guardando l'immagine per 1-2 secondi, è probabile che il modello non possa essere addestrato a farlo.

Quando le immagini di addestramento sono pronte, preparale per l'importazione in Firebase. Hai a disposizione tre opzioni:

Opzione 1: archivio ZIP strutturato

Organizza le immagini di addestramento in directory, ognuna denominata in base a un'etichetta e contenente immagini che sono esempi di quell'etichetta. Quindi comprimi la directory in un archivio ZIP.

I nomi di directory in questo archivio ZIP possono contenere fino a 32 caratteri ASCII e può contenere solo caratteri alfanumerici e il trattino basso (_).

Ad esempio:

my_training_data.zip
  |____accordion
  | |____001.jpg
  | |____002.jpg
  | |____003.jpg
  |____bass_guitar
  | |____hofner.gif
  | |____p-bass.png
  |____clavier
    |____well-tempered.jpg
    |____well-tempered (1).jpg
    |____well-tempered (2).jpg

Opzione 2: Cloud Storage con indice CSV

Carica le immagini di addestramento su Google Cloud Storage e prepara un file CSV che elenca l'URL di ogni immagine e, facoltativamente, il campo le etichette corrette per ogni immagine. Questa opzione è utile quando si utilizzano set di dati molto grandi.

Ad esempio, carica le immagini su Cloud Storage e prepara un file CSV come le seguenti:

gs://your-training-data-bucket/001.jpg,accordion
gs://your-training-data-bucket/002.jpg,accordion
gs://your-training-data-bucket/003.jpg,accordion
gs://your-training-data-bucket/hofner.gif,bass_guitar
gs://your-training-data-bucket/p-bass.png,bass_guitar
gs://your-training-data-bucket/well-tempered.jpg,clavier
gs://your-training-data-bucket/well-tempered%20(1).jpg,clavier
gs://your-training-data-bucket/well-tempered%20(2).jpg,clavier

Le immagini devono essere archiviate in un bucket che fa parte del progetto Google Cloud corrispondente del tuo progetto Firebase.

Per saperne di più sulla preparazione del file CSV, consulta Preparazione dei dati di addestramento nella documentazione di Cloud AutoML Vision.

Opzione 3: immagini non etichettate

Etichetta le immagini di addestramento nella console Firebase dopo averle caricate individualmente o in un file ZIP non strutturato. Vedi il passaggio successivo.

2. Addestra il modello

Quindi, addestra un modello utilizzando le tue immagini:

  1. Apri la pagina Set di dati di Vision nella console Google Cloud. Seleziona il progetto quando richiesto.

  2. Fai clic su Nuovo set di dati, inserisci un nome per il set di dati e seleziona il tipo modello che vuoi addestrare e fai clic su Crea set di dati.

  3. Nella scheda Importa del set di dati, carica un'archivio ZIP delle immagini di addestramento o un file CSV contenente le località Cloud Storage in cui le hai caricate. Vedi Raccogliere i dati di addestramento.

  4. Al termine dell'attività di importazione, utilizza la scheda Immagini per verificare i dati di addestramento ed etichettare le immagini non etichettate.

  5. Nella scheda Addestra, fai clic su Inizia addestramento.

    1. Assegna un nome al modello e seleziona il tipo di modello Edge.

    2. Configura le seguenti impostazioni di addestramento, che regolano il rendimento del modello generato:

      Ottimizza il modello per... La configurazione del modello da utilizzare. Puoi addestrare modelli più veloci e più piccoli se la latenza ridotta o le dimensioni ridotte del pacchetto sono importanti oppure modelli più lenti e più grandi se la precisione è più importante.
      Budget ora nodo

      Il tempo massimo, in ore di calcolo, per l'addestramento del un modello di machine learning. Un tempo di addestramento maggiore di solito si traduce in una maggiore precisione un modello di machine learning.

      Tieni presente che l'addestramento può essere completato in meno rispetto tempo se il sistema determina che il modello è ottimizzato un ulteriore addestramento non migliorerebbe l'accuratezza. Ti vengono addebitate solo le ore effettivamente utilizzate.

      Tempi di addestramento tipici
      Set molto piccoli1 ora
      500 immagini2 ore
      1000 immagini3 ore
      5000 immagini6 ore
      10.000 immagini7 ore
      50.000 immagini11 ore
      100.000 immagini13 ore
      1.000.000 di immagini18 ore

3. valuta il modello

Al termine dell'addestramento, puoi fare clic sulla scheda Valuta per vedere le metriche delle prestazioni del modello.

Un uso importante di questa pagina è determinare la soglia di confidenza ottimale per il tuo modello. La soglia di confidenza è il livello minimo di confidenza che il modello deve avere per assegnare un'etichetta a un'immagine. Spostando il dispositivo di scorrimento Soglia di affidabilità, puoi vedere in che modo soglie diverse influiscono sul rendimento del modello. Le prestazioni del modello vengono misurate utilizzando due metriche: precisione e richiamo.

Nel contesto della classificazione delle immagini, la precisione è il rapporto tra il numero di immagini etichettate correttamente e il numero di immagini etichettate dal modello in base alla soglia selezionata. Quando un modello ha una precisione elevata, assegna le etichette possono essere errate con minore frequenza (meno falsi positivi).

Per richiamo si intende il rapporto tra il numero di immagini etichettate correttamente e il numero di immagini con contenuti che il modello avrebbe dovuto essere in grado di etichettare. Quando un modello ha un richiamo elevato, non riesce ad assegnare alcuna etichetta con minore frequenza (meno false parole chiave escluse).

L'ottimizzazione in base alla precisione o al richiamo dipende dal caso d'uso. Per ulteriori informazioni, consulta la guida per principianti di AutoML Vision e la guida al machine learning inclusivo: AutoML.

Quando trovi una soglia di confidenza che produce metriche con cui ti senti a tuo agio, prendine nota; userai la soglia di confidenza per configurare il modello dell'app. Puoi utilizzare questo strumento in qualsiasi momento per ottenere un valore di soglia appropriato.

4. Pubblicare o scaricare il modello

Se ritieni che le prestazioni del modello vadano bene e vuoi utilizzarlo in un'app, hai tre opzioni tra cui scegliere: esegui il deployment del modello per la previsione online, pubblicalo su Firebase o scaricalo e raggruppalo con la tua app.

Esegui il deployment del modello

Nella scheda Testa e utilizza del set di dati, puoi eseguire il deployment del modello per la previsione online, che esegue il modello nel cloud. Questa opzione è descritta nella documentazione di Cloud AutoML. La documenti su questo sito con le due opzioni rimanenti.

Pubblica il modello

Se pubblichi il modello in Firebase, puoi aggiornarlo senza rilasciarlo una nuova versione dell'app e puoi usare Remote Config e A/B Testing per di pubblicare dinamicamente modelli diversi per insiemi di utenti diversi.

Se scegli di fornire solo il modello ospitandolo su Firebase e di non includerlo nella tua app, puoi ridurre le dimensioni del download iniziale dell'app. Tuttavia, tieni presente che se il modello non è incluso nella tua app, qualsiasi funzionalità correlata al modello non sarà disponibile finché l'app non lo scarica per la prima volta.

Per pubblicare il modello, puoi utilizzare uno dei due metodi seguenti:

  • Scarica il modello TF Lite dalla pagina Testa e utilizza del set di dati nella console Google Cloud, quindi caricalo nella pagina Modello personalizzato della console Firebase. Di solito è il modo più semplice per pubblicare un singolo modello.
  • Pubblica il modello direttamente dal progetto Google Cloud su Firebase utilizzando l'SDK Admin. Puoi usare questo metodo per pubblicare in batch più modelli o per creare pipeline di pubblicazione automatizzate.

Per pubblicare il modello con l'API di gestione dei modelli di SDK Admin:

  1. Installa e inizializza l'SDK.

  2. Pubblica il modello.

    Dovrai specificare l'identificatore della risorsa del modello, che è una stringa simile all'esempio seguente:

    projects/PROJECT_NUMBER/locations/us-central1/models/MODEL_ID
    PROJECT_NUMBER Il numero del progetto del bucket Cloud Storage che contiene il modello. Potrebbe essere il tuo progetto Firebase o un altro Google Cloud progetto. Puoi trovare questo valore nella pagina Impostazioni del Console Firebase o la dashboard della console Google Cloud.
    MODEL_ID L'ID del modello, che hai ricevuto dall'API AutoML Cloud.

    Python

    # First, import and initialize the SDK.
    
    # Get a reference to the AutoML model
    source = ml.TFLiteAutoMlSource('projects/{}/locations/us-central1/models/{}'.format(
        # See above for information on these values.
        project_number,
        model_id
    ))
    
    # Create the model object
    tflite_format = ml.TFLiteFormat(model_source=source)
    model = ml.Model(
        display_name="example_model",  # This is the name you will use from your app to load the model.
        tags=["examples"],             # Optional tags for easier management.
        model_format=tflite_format)
    
    # Add the model to your Firebase project and publish it
    new_model = ml.create_model(model)
    new_model.wait_for_unlocked()
    ml.publish_model(new_model.model_id)
    

    Node.js

    // First, import and initialize the SDK.
    
    (async () => {
      // Get a reference to the AutoML model. See above for information on these
      // values.
      const automlModel = `projects/${projectNumber}/locations/us-central1/models/${modelId}`;
    
      // Create the model object and add the model to your Firebase project.
      const model = await ml.createModel({
        displayName: 'example_model',  // This is the name you use from your app to load the model.
        tags: ['examples'],  // Optional tags for easier management.
        tfliteModel: { automlModel: automlModel },
      });
    
      // Wait for the model to be ready.
      await model.waitForUnlocked();
    
      // Publish the model.
      await ml.publishModel(model.modelId);
    
      process.exit();
    })().catch(console.error);
    

Scaricare e raggruppare il modello con l'app

Se combini il modello con l'app, puoi assicurarti che le funzionalità di ML dell'app continuino a funzionare anche quando il modello ospitato su Firebase non è disponibile.

Se pubblichi il modello e lo combini con la tua app, l'app utilizzerà la versione più recente disponibile.

Per scaricare il modello, fai clic su TF Lite nella pagina Testa e utilizza del set di dati.

Passaggi successivi

Ora che hai pubblicato o scaricato il modello, scopri come utilizzarlo in iOS+ e App per Android.