Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# TensorFlow Classificazione delle immagini Lite
<a name="tensorflow-lite-image-classification-component"></a>

Il componente di classificazione delle immagini TensorFlow Lite (`aws.greengrass.TensorFlowLiteImageClassification`) contiene un codice di inferenza di esempio per eseguire l'inferenza della classificazione delle immagini utilizzando il runtime [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) e un modello quantizzato MobileNet 1.0 pre-addestrato di esempio. Questo componente utilizza la variante [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) e [TensorFlow Runtime Lite](tensorflow-lite-component.md) i componenti come dipendenze per scaricare il runtime TensorFlow Lite e il modello di esempio.

Per utilizzare questo componente di inferenza con un modello TensorFlow Lite personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) del componente dipendente del Model Store. Per utilizzare il proprio codice di inferenza personalizzato, è possibile utilizzare la ricetta di questo componente come modello per [creare un](ml-customization.md#create-inference-component) componente di inferenza personalizzato.

**Topics**
+ [Versioni](#tensorflow-lite-image-classification-component-versions)
+ [Tipo](#tensorflow-lite-image-classification-component-type)
+ [Sistema operativo](#tensorflow-lite-image-classification-component-os-support)
+ [Requisiti](#tensorflow-lite-image-classification-component-requirements)
+ [Dipendenze](#tensorflow-lite-image-classification-component-dependencies)
+ [Configurazione](#tensorflow-lite-image-classification-component-configuration)
+ [File di registro locale](#tensorflow-lite-image-classification-component-log-file)
+ [Changelog](#tensorflow-lite-image-classification-component-changelog)

## Versioni
<a name="tensorflow-lite-image-classification-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x

## Tipo
<a name="tensorflow-lite-image-classification-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-image-classification-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-image-classification-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="tensorflow-lite-image-classification-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-image-classification-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 and 2.1.12 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.11 e 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------

## Configurazione
<a name="tensorflow-lite-image-classification-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`accessControl`  
<a name="ml-config-accesscontrol-desc"></a>(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare messaggi nell'argomento delle notifiche predefinito.   
Impostazione predefinita:   

```
{
   "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.TensorFlowLiteImageClassification:mqttproxy:1": {
         "policyDescription": "Allows access to publish via topic ml/tflite/image-classification.",
         "operations": [
            "aws.greengrass#PublishToIoTCore"
         ],
         "resources": [
            "ml/tflite/image-classification"
         ]
      }
   }
}
```

`PublishResultsOnTopic`  
<a name="ml-config-publishresultsontopic-desc"></a>(Facoltativo) L'argomento su cui si desidera pubblicare i risultati dell'inferenza. Se modificate questo valore, dovete modificare anche il valore del `accessControl` parametro `resources` in modo che corrisponda al nome dell'argomento personalizzato.  
Impostazione predefinita: `ml/tflite/image-classification`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageDirectory`  
<a name="ml-config-imagedirectory-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo in cui i componenti di inferenza leggono le immagini. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui si ha read/write accesso.  
<a name="ml-config-imagedirectory-img-default"></a>Impostazione predefinita: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/`  
Se imposti il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`ImageName`  
<a name="ml-config-imagename-desc"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per effettuare una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` Per impostazione predefinita, il componente utilizza l'immagine di esempio nella directory delle immagini predefinita. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-img-default"></a>Impostazione predefinita: `cat.jpeg`  
Se si imposta il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    "model": "TensorFlowLite-Mobilenet"
}
```

`UseCamera`  <a name="ml-config-usecamera"></a>
(Facoltativo) Valore di stringa che definisce se utilizzare le immagini di una fotocamera collegata al dispositivo principale Greengrass. I valori supportati sono `true` e `false`.  
Quando impostate questo valore su`true`, il codice di inferenza di esempio accede alla fotocamera del dispositivo ed esegue l'inferenza localmente sull'immagine acquisita. I valori dei `ImageDirectory` parametri `ImageName` and vengono ignorati. Assicuratevi che l'utente che esegue questo componente abbia read/write accesso alla posizione in cui la fotocamera memorizza le immagini acquisite.  
Impostazione predefinita: `false`  
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

## File di registro locale
<a name="tensorflow-lite-image-classification-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="tensorflow-lite-image-classification-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.12  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione iniziale.  |