

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 了解清單檔案摘要
<a name="tm-debugging-summary"></a>

此清單檔案摘要包含以下資訊。
+ 驗證期間遇到的 [終端機資訊清單內容錯誤清單](tm-debugging.md#tm-error-category-combined-terminal) 錯誤資訊。
+ 訓練和測試資料集中 [非終端 JSON 行驗證錯誤的清單](tm-debugging.md#tm-error-category-non-terminal-errors) 的錯誤位置資訊。
+ 錯誤統計資料，例如在訓練和測試資料集中找到的無效 JSON Lines 總數。

如果沒有 [終端機資訊清單檔案錯誤清單](tm-debugging.md#tm-error-category-terminal)，即會在訓練期間建立清單檔案摘要。若要取得清單檔案摘要檔案 (*manifest\$1summary.json*) 的位置，請參閱 [取得驗證結果](tm-debugging-getting-validation-data.md)。

**注意**  
清單檔案摘要中不會回報[服務錯誤](tm-debugging.md#tm-error-category-service)和[清單檔案錯誤](tm-debugging.md#tm-error-category-terminal)。如需詳細資訊，請參閱[終端錯誤](tm-debugging.md#tm-error-categories-terminal)。

如需特定清單檔案內容錯誤的資訊，請參閱 [終端清單檔案內容錯誤](tm-debugging-aggregate-errors.md)。

## 清單檔案摘要檔案格式
<a name="tm-manifest-summary-file"></a>

清單檔案有 2 個區段：`statistics` 和 `errors`。

### 統計資訊
<a name="tm-manifest-summary-statistics"></a>

`statistics` 包含訓練和測試資料集中錯誤的相關資訊。
+ `training` — 在訓練資料集中找到的統計資料和錯誤。
+ `testing` — 在測試資料集中找到的統計資料和錯誤。



`errors` 陣列中的物件包含清單檔案內容錯誤的錯誤代碼和訊息。 ``

`error_line_indices` 陣列包含具有錯誤的訓練或測試清單檔案中每個 JSON Line 的行號。如需詳細資訊，請參閱[修正訓練錯誤](tm-debugging-fixing-validation-errors.md)。

### 錯誤
<a name="tm-manifest-summary-errors"></a>

跨越訓練和測試資料集的錯誤。例如，當沒有足夠的可用標籤與訓練和測試資料集重疊時，就會發生 [ERROR\$1INSUFFICIENT\$1USABLE\$1LABEL\$1OVERLAP](tm-debugging-aggregate-errors.md#tm-error-ERROR_INSUFFICIENT_USABLE_LABEL_OVERLAP)。

```
{
    "statistics": {
        "training": 
            {
                "use_case": String, # Possible values are IMAGE_LEVEL_LABELS, OBJECT_LOCALIZATION and NOT_DETERMINED
                "total_json_lines": Number,   # Total number json lines (images) in the  training manifest.
                "valid_json_lines": Number,   # Total number of JSON Lines (images) that can be used for training.
                "invalid_json_lines": Number, # Total number of invalid JSON Lines. They are not used for training.
                "ignored_json_lines": Number, # JSON Lines that have a valid schema but have no annotations. The aren't used for training and aren't counted as invalid.
                "error_json_line_indices": List[int], # Contains a list of line numbers for JSON line errors in the training dataset.
                "errors": [
                    {
                        "code": String, # Error code for a training manifest content error.
                        "message": String # Description for a training manifest content error.
                    }
                ]
            },
        "testing": 
            {
                "use_case": String, # Possible values are IMAGE_LEVEL_LABELS, OBJECT_LOCALIZATION and NOT_DETERMINED
                "total_json_lines": Number, # Total number json lines (images) in the manifest.
                "valid_json_lines": Number,  # Total number of JSON Lines (images) that can be used for testing.
                "invalid_json_lines": Number, # Total number of invalid JSON Lines. They are not used for testing.
                "ignored_json_lines": Number, # JSON Lines that have a valid schema but have no annotations. They aren't used for testing and aren't counted as invalid.
                "error_json_line_indices": List[int], # contains a list of error record line numbers in testing dataset.
                "errors": [
                    {
                        "code": String,   # # Error code for a testing manifest content error.
                        "message": String # Description for a testing manifest content error.
                    }
                ]  
            }
    },
    "errors": [
        {
            "code": String, # # Error code for errors that span the training and testing datasets.
            "message": String # Description of the error.
        }
    ]
}
```

## 清單檔案摘要範例
<a name="tm-debugging-manifest-summary-example"></a>

下列範例是部分清單檔案摘要，會顯示終端清單檔案內容錯誤 ([ERROR\$1TOO\$1MANY\$1INVALID\$1ROWS\$1IN\$1MANIFEST](tm-debugging-aggregate-errors.md#tm-error-ERROR_TOO_MANY_INVALID_ROWS_IN_MANIFEST))。`error_json_line_indices` 陣列包含對應的訓練或測試驗證清單檔案中非終端 JSON Line 錯誤的行號。

```
{
    "errors": [],
    "statistics": {
        "training": {
            "use_case": "NOT_DETERMINED",
            "total_json_lines": 301,
            "valid_json_lines": 146,
            "invalid_json_lines": 155,
            "ignored_json_lines": 0,
            "errors": [
                {
                    "code": "ERROR_TOO_MANY_INVALID_ROWS_IN_MANIFEST",
                    "message": "The manifest file contains too many invalid rows."
                }
            ],
            "error_json_line_indices": [ 
                15,
                16,
                17,
                22,
                23,
                24,
                 .
                 .
                 .
                 .                 
                300
            ]
        },
        "testing": {
            "use_case": "NOT_DETERMINED",
            "total_json_lines": 15,
            "valid_json_lines": 13,
            "invalid_json_lines": 2,
            "ignored_json_lines": 0,
            "errors": [],
            "error_json_line_indices": [ 
                13,
                15
            ]
        }
    }
}
```