

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à.

# File di configurazione delle categoria di etichettatura con riferimento alle categorie di etichette e agli attributi dei frame
<a name="sms-label-cat-config-attributes"></a>

Quando crei un lavoro di etichettatura con nuvole di punti o fotogrammi video 3D utilizzando l'operazione SageMaker API di Amazon`CreateLabelingJob`, utilizzi un file di configurazione della categoria di etichette per specificare le etichette e le istruzioni per l'operatore. Facoltativamente, puoi anche fornire quanto segue nel tuo file di attributi di categoria dell’etichetta:
+ Puoi fornire gli *attributi di categoria dell’etichetta* per il fotogramma video e il monitoraggio di oggetti della nuvola di punti 3D e i tipi di attività di monitoraggio di oggetti. I worker possono usare uno o più attributi per fornire ulteriori informazioni su un oggetto. Ad esempio, potresti utilizzare l'attributo *occluded* per consentire ai worker di individuare quando un oggetto è parzialmente ostruito. Puoi specificare un attributo di categoria dell’etichetta per una singola etichetta utilizzando il parametro `categoryAttributes` o per tutte le etichette utilizzando il parametro `categoryGlobalAttributes`. 
+ Puoi fornire *attributi del fotogramma* per i tipi di attività di tracciamento e rilevamento di oggetti con nuvole di punti 3D e fotogrammi video utilizzando `frameAttributes`. Quando crei un attributo del fotogramma, questo viene visualizzato su ogni fotogramma o nuvola di punti dell'attività del worker. Nei processi di etichettatura di fotogrammi video, si tratta di attributi che i worker assegnano a un intero fotogramma video. Per i processi di etichettatura con nuvole di punti 3D, questi attributi vengono applicati a una singola nuvola di punti. Utilizza gli attributi dei fotogrammi per consentire ai worker di fornire maggiori informazioni sulla scena in un fotogramma o in una nuvola di punti specifici.
+ Per i processi di etichettatura di fotogrammi video, utilizza il file di configurazione della categoria dell’etichetta per specificare il tipo di attività (riquadro di delimitazione, polilinea, poligono o keypoint) da inviare ai worker. 

Per i worker, specificare i valori per gli attributi della categoria dell’etichetta e gli attributi dei fotogrammi sarà facoltativo.

**Importante**  
Devi specificare un nome per l’attributo dell’etichetta in `auditLabelAttributeName` solo se esegui un processo di audit per verificare o regolare le etichette. Usa questo parametro per inserire quello [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)utilizzato nel processo di etichettatura che ha generato le annotazioni che desideri che il lavoratore modifichi. Quando crei un lavoro di etichettatura nella console, se non hai specificato il nome di un attributo di etichetta, il **nome** del tuo lavoro viene utilizzato come. LabelAttributeName

I seguenti argomenti mostrano esempi di file di configurazione delle categorie di etichette per diversi tipi di processi di etichettatura. Spiegano inoltre lo schema e le quote di un file di configurazione delle categorie.

**Topics**
+ [Esempi: file di configurazione delle categorie di etichette per processi di etichettatura in una nuvola di punti 3D](#sms-label-cat-config-attributes-3d-pc)
+ [Esempio: file di configurazione delle categorie di etichette per i processi di etichettatura in frame video](#sms-label-cat-config-attributes-vid-frame)
+ [Schema del file di configurazione delle categorie di etichette](#sms-label-cat-config-attributes-schema)
+ [Etichetta e quote dell'attributo di categoria dell’etichetta](#sms-point-cloud-label-cat-limits)

## Esempi: file di configurazione delle categorie di etichette per processi di etichettatura in una nuvola di punti 3D
<a name="sms-label-cat-config-attributes-3d-pc"></a>

I seguenti argomenti mostrano esempi di file di configurazione delle categorie di etichette in una nuvola di punti 3D per processi di rilevamento e tracciamento di oggetti, segmentazione semantica, regolazione ed etichettatura di verifica.

**Topics**
+ [Esempio: tracciamento e rilevamento di oggetti in una nuvola di punti 3D](#example-3d-point-cloud-object)
+ [Esempio: segmentazione semantica in una nuvola di punti 3D](#example-3d-point-cloud-semantic)
+ [Esempio: regolazione in una nuvola di punti 3D](#example-3d-point-cloud-adjustment)
+ [Esempio: verifica in una nuvola di punti 3D](#example-3d-point-cloud-verification)

### Esempio: tracciamento e rilevamento di oggetti in una nuvola di punti 3D
<a name="example-3d-point-cloud-object"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta che include gli attributi della categoria dell’etichetta per un processo di etichettatura di oggetti con nuvole di punti 3D di rilevamento o monitoraggio di oggetti. Questo esempio include due attributi di fotogramma, che verranno aggiunti a tutte le nuvole di punti inviate al processo di etichettatura. L'etichetta `Car` includerà quattro attributi di categoria dell'etichetta: `X`, `Y`, `Z` e l'attributo globale, `W`.

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"],
            "isRequired":true 
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"]
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"}
}
```

### Esempio: segmentazione semantica in una nuvola di punti 3D
<a name="example-3d-point-cloud-semantic"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura della segmentazione semantica con nuvole di punti 3D. 

Gli attributi di categoria dell’etichetta non sono supportati per i tipi di attività di segmentazione semantica con nuvole di punti 3D. Gli attributi dei fotogrammi sono supportati. Gli attributi di categoria dell’etichetta per un processo di etichettatura di segmentazione semantica eventualmente forniti verranno ignorati.

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "labels": [
        {
            "label": "Car",
        },
        {
            "label": "Pedestrian",
        },
        {
            "label": "Cyclist",
        }
    ],
    "instructions": {"shortInstruction":"Select the appropriate label and paint all objects in the point cloud that it applies to the same color", "fullInstruction":"<html markup>"}
}
```

### Esempio: regolazione in una nuvola di punti 3D
<a name="example-3d-point-cloud-adjustment"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura per il rilevamento di oggetti con nuvole di punti 3D o per la regolazione del monitoraggio di oggetti. Per i processi di etichettatura di regolazione con segmentazione semantica con nuvole di punti 3D, `categoryGlobalAttributes` e `categoryAttributes` non sono supportati. 

È necessario includere `auditLabelAttributeName` per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di regolazione. Facoltativamente, è possibile utilizzare il parametro `editsAllowed` per specificare se un attributo di etichetta o fotogramma può essere modificato. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"none",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"any",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"any",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

### Esempio: verifica in una nuvola di punti 3D
<a name="example-3d-point-cloud-verification"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta utilizzabile per un processo di etichettatura per il rilevamento di oggetti con nuvole di punti 3D o per la verifica del monitoraggio di oggetti. Per un processo di etichettatura di verifica con segmentazione semantica con nuvole di punti 3D, `categoryGlobalAttributes` e `categoryAttributes` non sono supportati. 

È necessario includere `auditLabelAttributeName` per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Inoltre, è necessario utilizzare il parametro `editsAllowed` per specificare che non è possibile modificare alcuna etichetta. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"any", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"any", 
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"none", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"none", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"none"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label verification jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

## Esempio: file di configurazione delle categorie di etichette per i processi di etichettatura in frame video
<a name="sms-label-cat-config-attributes-vid-frame"></a>

Gli strumenti di annotazione disponibili per il worker e il tipo di attività utilizzati dipendono dal valore specificato per `annotationType`. Ad esempio, se desideri che i worker utilizzino i punti chiave per monitorare le modifiche nella posa di oggetti specifici su più fotogrammi, devi specificare `Keypoint` per `annotationType`. Se non specifichi un tipo di annotazione, per impostazione predefinita verrà utilizzato `BoundingBox`. 

I seguenti argomenti mostrano esempi di file di configurazione di categorie di frame video.

**Topics**
+ [Esempio: keypoint in frame video](#example-video-frame-keypoint)
+ [Esempio: regolazione nei frame video](#example-video-frame-adjustment)
+ [Esempio: verifica nei frame video](#example-video-frame-verification)

### Esempio: keypoint in frame video
<a name="example-video-frame-keypoint"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta dei punti chiave dei fotogrammi video con gli attributi della categoria dell’etichetta. Questo esempio include due attributi di fotogrammi, che verranno aggiunti a tutti i fotogrammi inviati al processo di etichettatura. L'etichetta `Car` includerà quattro attributi di categoria dell'etichetta: `X`, `Y`, `Z` e l'attributo globale, `W`. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"]
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"}
}
```

### Esempio: regolazione nei frame video
<a name="example-video-frame-adjustment"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta che è possibile utilizzare per un processo di etichettatura di regolazione dei fotogrammi video.

È necessario includere `auditLabelAttributeName` per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Facoltativamente, è possibile utilizzare il parametro `editsAllowed` per specificare se le etichette, gli attributi delle categorie dell’etichetta o gli attributi dei fotogrammi possono essere modificati o meno. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"none", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"any", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"any", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"any"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

### Esempio: verifica nei frame video
<a name="example-video-frame-verification"></a>

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura di fotogrammi video.

È necessario includere `auditLabelAttributeName` per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Inoltre, è necessario utilizzare il parametro `editsAllowed` per specificare che non è possibile modificare alcuna etichetta. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"none", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"any", 
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"none", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"none", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"any"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

## Schema del file di configurazione delle categorie di etichette
<a name="sms-label-cat-config-attributes-schema"></a>

Nella tabella seguente sono elencati gli elementi che è possibile e necessario includere nel file di configurazione della categoria dell’etichetta.

**Nota**  
Il parametro `annotationType` è supportato solo per i processi di etichettatura dei fotogrammi video. 


****  

|  Parametro  |  Obbligatorio  |  Valori accettati  |  Description  | 
| --- | --- | --- | --- | 
| frameAttributes |  No  |  Un elenco di oggetti JSON. **Parametri obbligatori in ogni oggetto JSON:** `name`, `type`, `description` `minimum` e `maximum` sono obbligatori se `type` è `"number"` **Parametri facoltativi in ogni oggetto JSON:** `enum`, `editsAllowed`, `isRequired`  | Utilizza questo parametro per creare un attributo del fotogramma da applicare a tutti i fotogrammi oppure le nuvole di punti 3D nel tuo processo di etichettatura.Per ulteriori informazioni, consulta la terza tabella in questa sezione.  | 
| categoryGlobalAttributes |  No  |  Un elenco di oggetti JSON. **Parametri obbligatori in ogni oggetto JSON:** `name`, `type` `minimum` e `maximum` sono obbligatori se `type` è `"number"` **Parametri facoltativi in ogni oggetto JSON:** `description`, `enum`, `editsAllowed`, `isRequired`   | Utilizza questo parametro per creare attributi della categoria dell’etichetta da applicare a tutte le etichette specificate in `labels`. Per ulteriori informazioni, consulta la terza tabella in questa sezione.  | 
| labels |  Sì  |  Un elenco di 30 oggetti JSON al massimo **Parametri obbligatori in ogni oggetto JSON:** `label` **Parametri facoltativi in ogni oggetto JSON:** `categoryAttributes`, `editsAllowed`  |  Utilizza questo parametro per specificare le etichette o le classi. Aggiungi un elemento `label` per ogni classe.  Per aggiungere un attributo della categoria dell’etichetta a un'etichetta, aggiungi `categoryAttributes` all'etichetta. Utilizza `editsAllowed` per specificare se un'etichetta può essere modificata o meno in un processo di etichettatura di regolazione. Imposta `editsAllowed` su `"none"` per i processi di etichettatura di verifica. Per ulteriori informazioni, consulta la tabella seguente.  | 
| annotationType (supportato solo per i processi di etichettatura di fotogrammi video)  |  No   |  Stringa **Parametri accettati:** `BoundingBox`, `Polyline`, `Polygon`, `Keypoint` **Default**: `BoundingBox`  |  Consente di specificare il tipo di attività per i tuoi processi di etichettatura dei fotogrammi video. Ad esempio, per un'attività di rilevamento di oggetti con fotogrammi video poligonali, scegli `Polygon`.  Se non specifichi un `annotationType` quando crei un processo di etichettatura dei fotogrammi video, Ground Truth utilizzerà un `BoundingBox` per impostazione predefinita.   | 
| instructions |  No  | Un oggetto JSONParametri obbligatori in ogni oggetto JSON:`"shortInstruction"`, `"fullInstruction"` |  Utilizza questo parametro per aggiungere le istruzioni per aiutare i worker a completare le attività. Per ulteriori informazioni sulle istruzioni per i worker, consulta [Istruzioni per il lavoratore](sms-point-cloud-general-information.md#sms-point-cloud-worker-instructions-general).  Le istruzioni brevi devono contenere meno di 255 caratteri e le istruzioni lunghe devono contenere meno di 2.048 caratteri.  Per ulteriori informazioni, consulta [Creare pagine di istruzioni](sms-creating-instruction-pages.md).  | 
| auditLabelAttributeName |  Obbligatorio per i tipi di attività di regolazione e verifica  |  Stringa  |  Inserisci l'elemento [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)utilizzato nel lavoro di etichettatura di cui desideri modificare le annotazioni.  Utilizza questo parametro solo se crei un processo di regolazione per il fotogramma video e nuvole di punti 3D per il rilevamento di oggetti, il tracciamento di oggetti o la segmentazione semantica della nuvola di punti 3D.   | 

### Schema di oggetti di etichette
<a name="sms-labels-schema"></a>

La tabella seguente descrive i parametri che puoi e devi usare per creare un elenco di `Labels`. Ogni parametro deve essere incluso in un oggetto JSON. 


****  

| Parametro | Obbligatorio | Valori accettati | Description | 
| --- | --- | --- | --- | 
| label |  Sì  |  Stringa  |  Il nome della categoria di etichette che viene visualizzato dai worker. Il nome di ciascuna categoria di etichette deve essere univoco.  | 
| categoryAttributes |  No  |  Un elenco di oggetti JSON. **Parametri obbligatori in ogni oggetto JSON:** `name`, `type` `minimum` e `maximum` obbligatori se `type` è `"number"` **Parametri facoltativi in ogni oggetto JSON:** `description`, `enum`, `editsAllowed`, `isRequired`  | Utilizza questo parametro per aggiungere gli attributi di categoria dell’etichetta a determinate etichette specificate in `labels`. Per aggiungere uno o più attributi di categoria dell’etichetta a un'etichetta, includi l'oggetto JSON `categoryAttributes` nello stesso oggetto JSON `labels` di `label`.Per ulteriori informazioni, consulta la tabella seguente.  | 
| editsAllowed |  No  |  Stringa **Valori supportati:** `"none"`: non è consentita nessuna modifica. or `"any"` (Impostazione predefinita): tutte le modifiche sono consentite.  |  Specifica se un'etichetta può essere modificata o meno dai worker. Per i processi di etichettatura di *regolazione* con nuvole di punti 3D, aggiungi questo parametro a uno o più oggetti JSON nell'elenco `labels` per specificare se un worker può modificare o meno un'etichetta. Per i processi di etichettatura con nuvole di punti 3D e *verifica* di fotogrammi video, aggiungi questo parametro con il valore `"none"` a ciascun oggetto JSON nell'elenco `labels`. Ciò renderà tutte le etichette non modificabili.  | 

### FrameAttributes e schema categoryGlobalAttributes
<a name="sms-category-attributes-schema"></a>

La tabella seguente descrive i parametri che puoi e devi utilizzare per creare un attributo del fotogramma utilizzando `frameAttributes` e l’attributo di categoria dell’etichetta usando i parametri `categoryGlobalAttributes` e `categoryAttributes`.


****  

|  Parametro  |  Obbligatorio  |  Valori accettati  |  Description  | 
| --- | --- | --- | --- | 
| name |  Sì  |  Stringa  |  Utilizza questo parametro per assegnare un nome all'attributo di categoria o fotogramma dell’etichetta. Questo è il nome dell’attributo visualizzato dai worker. Il nome di ogni attributo di categoria dell’etichetta nel file di configurazione della categoria dell’etichetta deve essere univoco. Gli attributi globali della categoria dell’etichetta e gli attributi della categoria dell’etichetta specifici dell'etichetta non possono avere lo stesso nome.  | 
| type |  Sì  |  Stringa **Valori obbligatori**: `"string"` o `"number"`  |  Utilizza questo parametro per definire il tipo di attributo della categoria di etichetta o fotogramma.  Se specifichi `"string"` per `type` e fornisci un valore `enum` per questo attributo, i worker potranno scegliere tra una delle scelte fornite.  Se specifichi `"string"` per `type` e non fornisci un valore `enum`, i worker possono inserire testo in forma libera.  Se specifichi `number` per `type`, il worker può inserire un numero compreso tra i numeri `minimum` e`maximum` specificati.   | 
| enum |  No  |  Elenco di stringhe  |  Utilizza questo parametro per definire le opzioni tra cui i worker possono scegliere per questo attributo di categoria di etichetta o fotogramma. I worker possono scegliere un valore specificato in `enum`. Ad esempio, se specifichi `["foo", "buzz", "bar"`] per `enum`, i worker possono scegliere tra `foo`, `buzz` o `bar`. Devi specificare `"string"` per `type` per utilizzare un elenco `enum`.  | 
| description |  `frameAttributes`: Sì `categoryAttributes` oppure `categoryGlobalAttributes`: No  |  Stringa  |  Utilizza questo parametro per aggiungere una descrizione dell'attributo di categoria di etichetta o fotogramma. Puoi utilizzare questo campo per fornire ai worker maggiori informazioni sull'attributo.  Questo campo è obbligatorio per gli attributi del fotogramma.  | 
| minimum e maximum | Obbligatorio se l'attributo type è "number" | Numeri interi |  Utilizza questi parametri per specificare i valori minimi e massimi (inclusi) che i worker possono inserire per gli attributi numerici delle categorie di etichette o del fotogramma. Devi specificare `"number"` per `type` per utilizzare `minimum` e `maximum`.  | 
| editsAllowed |  No  |  Stringa **Valori obbligatori**: `"none"`: non è consentita nessuna modifica. or `"any"` (Impostazione predefinita): tutte le modifiche sono consentite.  |  Speciifica se un attributo di categoria di etichetta o fotogramma può essere modificato o meno dai worker. Per i processi di etichettatura di *regolazione* e *verifica* dei fotogrammi video o della nuvola di punti 3D, aggiungi questo parametro alla categoria dell’etichetta e agli oggetti JSON dell’attributo del fotogramma per specificare se un worker può modificare o meno un attributo.  | 
| isRequired |  No  |  Booleano  |  Specifica se i worker sono tenuti ad annotare un attributo. I worker non possono inviare il processo finché non vengono annotati tutti gli attributi obbligatori.  | 

## Etichetta e quote dell'attributo di categoria dell’etichetta
<a name="sms-point-cloud-label-cat-limits"></a>

È possibile specificare fino a 10 attributi di categoria dell’etichetta per classe. Queste quote di 10 attributi includono gli attributi di categoria dell’etichetta globali. Ad esempio, se crei quattro attributi di categoria dell’etichetta globali e assegni tre attributi di categoria dell’etichetta all'etichetta `X`, tale etichetta avrà 4\$13=7 attributi di categoria dell’etichetta in totale. Per tutti i limiti di categoria dell’etichetta e dell’attributo di categoria dell’etichetta, fai riferimento alla tabella riportata di seguito.


****  

|  Tipo  |  Min  |  Max  | 
| --- | --- | --- | 
|  Etichette (`Labels`)  |  1  |  30  | 
|  Quota di caratteri per il nome dell'etichetta  |  1  |  16  | 
|  Attributi della categoria dell’etichetta per etichetta (somma di `categoryAttributes` e `categoryGlobalAttributes`)  |  0  |  10  | 
|  Attributi della categoria dell’etichetta con immissione di testo in forma libera per etichetta (somma di `categoryAttributes` e `categoryGlobalAttributes`).   | 0 | 5 | 
|  Attributi del fotogramma  |  0  |  10  | 
|  Attributi di immissione di testo in forma libera in `frameAttributes`.  | 0 | 5 | 
|  Quota di caratteri per il nome dell'attributo (`name`)  |  1  |  16  | 
|  Quota di caratteri per la descrizione dell’attributo (`description`)  |  0  |  128  | 
|  Quota di caratteri per il tipo di attributo (`type`)  |  1  |  16  | 
|  Valori consentiti nell'elenco `enum` per un attributo `string`  | 1 | 10 | 
|  Quota di caratteri per un valore nell'elenco `enum`  | 1 | 16 | 
| Numero massimo di caratteri nella risposta di testo in forma libera per testo in forma libera frameAttributes | 0 | 1000 | 
| Numero massimo di caratteri nella risposta di testo in forma libera per testo in forma libera categoryAttributes e categoryGlobalAttributes | 0 | 80 | 