기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
레이블 범주 및 프레임 속성 참조로 범주 구성 파일 레이블 지정
Amazon SageMaker API 작업 을 사용하여 3D 포인트 클라우드 또는 비디오 프레임 레이블 지정 작업을 생성할 때 레이블 범주 구성 파일을 CreateLabelingJob
사용하여 레이블 및 작업자 지침을 지정합니다. 선택적으로 레이블 범주 속성 파일에 다음을 제공할 수도 있습니다.
-
비디오 프레임 및 3D 포인트 클라우드 객체 추적 및 객체 감지 태스크 유형에 레이블 범주 속성을 제공할 수 있습니다. 작업자는 주석에 하나 이상의 속성을 할당하여 해당 객체에 대한 추가 정보를 제공할 수 있습니다. 예를 들어 occluded 속성을 사용하여 객체가 부분적으로 방해를 받았을 때 작업자가 이를 식별하도록 할 수 있습니다.
categoryAttributes
파라미터를 사용하여 단일 레이블에 대한 레이블 범주 속성을 지정하거나,categoryGlobalAttributes
파라미터를 사용하는 모든 레이블에 대해 레이블 범주 속성을 지정할 수 있습니다. -
frameAttributes
을(를) 사용하여 비디오 프레임 및 3D 포인트 클라우드 객체 추적 및 객체 감지 작업 유형에 대한 프레임 속성을 제공할 수 있습니다. 프레임 속성을 생성하면 작업자 태스크의 각 프레임 또는 포인트 클라우드에 해당 속성이 나타납니다. 비디오 프레임 레이블 지정 작업에서 이러한 속성은 작업자가 전체 비디오 프레임에 할당하는 속성입니다. 3D 포인트 클라우드 레이블 지정 작업의 경우 이러한 속성이 단일 포인트 클라우드에 적용됩니다. 프레임 속성을 사용하면 작업자가 특정 프레임 또는 포인트 클라우드의 장면에 대한 추가 정보를 제공하도록 할 수 있습니다. -
비디오 프레임 레이블 지정 작업의 경우, 레이블 범주 구성 파일을 사용하여 작업자에게 전송된 작업 유형(경계 상자, 폴리라인, 다각형 또는 키포인트) 을 지정합니다.
작업자의 경우, 레이블 범주 속성 및 프레임 속성에 대한 값 지정은 선택 사항입니다.
중요
감사 작업을 실행하여 레이블을 확인하거나 조정하는 경우에만 auditLabelAttributeName
에 레이블 속성 이름을 제공해야 합니다. 이 파라미터를 사용하여 작업자가 조정하려는 주석을 생성한 레이블 지정 작업에 LabelAttributeName 사용되는 를 입력합니다. 콘솔에서 레이블 지정 작업을 생성할 때 레이블 속성 이름을 지정하지 않은 경우 작업 이름이 로 사용됩니다 LabelAttributeName.
다음 주제에서는 다양한 종류의 레이블 지정 작업에 대한 레이블 범주 구성 파일의 예를 보여줍니다. 또한 범주 구성 파일의 스키마와 할당량도 설명합니다.
주제
예: 3D 포인트 클라우드 레이블 지정 작업에 대한 레이블 범주 구성 파일
다음 주제에서는 객체 감지, 객체 추적, 의미 세분화, 조정 및 확인 레이블 지정 작업을 위한 3D 포인트 클라우드 레이블 범주 구성 파일의 예를 보여줍니다.
예: 3D 포인트 클라우드 객체 추적 및 객체 감지
다음은 3D 포인트 클라우드 객체 감지 또는 객체 추적 레이블 지정 작업에 대한 레이블 범주 속성을 포함하는 레이블 범주 구성 파일의 예입니다. 이 예제에는 레이블 지정 작업에 제출된 모든 포인트 클라우드에 추가될 두 프레임 속성이 포함되어 있습니다. Car
레이블에는 네 개의 레이블 범주 속성(X
, Y
, Z
및 글로벌 속성 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>
"} }
예: 3D 포인트 클라우드 의미 체계 세분화
다음은 3D 포인트 클라우드 의미 체계 분할 레이블 지정 작업용 레이블 범주 구성 파일의 예입니다.
3D 포인트 클라우드 의미 체계 분할 태스크 유형에서는 레이블 범주 속성이 지원되지 않습니다. 프레임 속성이 지원됩니다. 의미 체계 분할 레이블 지정 작업에 대한 레이블 범주 속성을 제공하는 경우 해당 속성은 무시됩니다.
{ "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>"} }
예: 3D 포인트 클라우드 조정
다음은 3D 포인트 클라우드 객체 감지 또는 객체 추적 조정 레이블 지정 작업을 위한 레이블 범주 구성 파일의 예입니다. 3D 포인트 클라우드 의미 체계 분할 조정 레이블 지정 작업의 경우, categoryGlobalAttributes
및 categoryAttributes
은(는) 지원되지 않습니다.
조정 레이블 지정 작업을 생성할 때 사용한 이전 레이블 지정 작업의 레이블 속성 이름을 지정하려면 auditLabelAttributeName
을(를) 포함시켜야 합니다. 선택적으로 editsAllowed
파라미터를 사용하여 레이블 또는 프레임 속성을 편집할 수 있는지 여부를 지정할 수 있습니다.
{ "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
" }
예: 3D 포인트 클라우드 확인
다음은 3D 포인트 클라우드 구름 객체 감지 또는 객체 추적 확인 레이블 지정 작업에 사용할 수 있는 레이블 범주 구성 파일의 예입니다. 3D 포인트 클라우드 의미 체계 분할 확인 레이블 지정 작업의 경우, categoryGlobalAttributes
및 categoryAttributes
은(는) 지원되지 않습니다.
확인 레이블 지정 작업을 생성할 때 사용한 이전 레이블 지정 작업의 레이블 속성 이름을 지정하려면 auditLabelAttributeName
을(를) 포함시켜야 합니다. 또한 editsAllowed
파라미터를 사용하여 레이블을 편집할 수 없도록 지정해야 합니다.
{ "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
" }
예: 비디오 프레임 레이블 지정 작업을 위한 레이블 범주 구성 파일
작업자가 사용할 수 있는 주석 도구와 사용되는 작업 유형은 사용자가 annotationType
에 대해 지정한 값에 따라 달라집니다. 예를 들어 작업자가 키 포인트를 사용하여 여러 프레임에 사이에 특정 객체의 포즈 변화를 추적하도록 하려면 annotationType
에 대해 Keypoint
값을 지정합니다. 주석 유형을 지정하지 않으면 기본적으로 BoundingBox
가 사용됩니다.
다음 주제에서는 비디오 프레임 범주 구성 파일의 예를 보여줍니다.
예: 비디오 프레임 키포인트
다음은 레이블 범주 속성이 있는 비디오 프레임 키포인트 레이블 범주 구성 파일의 예입니다. 이 예제에는 레이블 지정 작업에 제출된 모든 프레임에 추가될 두 프레임 속성이 포함되어 있습니다. Car
레이블에는 네 개의 레이블 범주 속성(X
, Y
, Z
및 글로벌 속성 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>
"} }
예: 비디오 프레임 조정
다음은 비디오 프레임 조정 레이블 지정 작업에 사용할 수 있는 레이블 범주 구성 파일의 예입니다.
확인 레이블 지정 작업을 생성할 때 사용한 이전 레이블 지정 작업의 레이블 속성 이름을 지정하려면 auditLabelAttributeName
을(를) 포함시켜야 합니다. 선택적으로 editsAllowed
파라미터를 사용하여 레이블, 레이블 범주 속성 또는 프레임 속성을 편집할 수 있는지 여부를 지정할 수 있습니다.
{ "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
" }
예: 비디오 프레임 확인
다음은 비디오 프레임 레이블 지정 작업을 위한 레이블 범주 구성 파일의 예입니다.
확인 레이블 지정 작업을 생성할 때 사용한 이전 레이블 지정 작업의 레이블 속성 이름을 지정하려면 auditLabelAttributeName
을(를) 포함시켜야 합니다. 또한 editsAllowed
파라미터를 사용하여 레이블을 편집할 수 없도록 지정해야 합니다.
{ "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
" }
레이블 범주 구성 파일 스키마
아래 표에는 레이블 범주 구성 파일에 포함시킬 수 있고 포함시켜야 하는 요소가 나와 있습니다.
참고
annotationType
파라미터는 비디오 프레임 레이블 지정 작업에만 지원됩니다.
파라미터 |
필수 |
허용되는 값 |
설명 |
---|---|---|---|
frameAttributes |
아니요 |
JSON 객체의 목록. 각 JSON 객체의 필수 파라미터:
각 JSON 객체의 선택적 파라미터:
|
이 매개변수를 사용하여 레이블 지정 작업의 모든 프레임 또는 3D 포인트 클라우드에 적용되는 프레임 속성을 생성합니다. 자세한 내용은 이 섹션의 세 번째 표를 참조하세요. |
categoryGlobalAttributes |
아니요 |
JSON 객체의 목록. 각 JSON 객체의 필수 파라미터:
각 JSON 객체의 선택적 파라미터:
|
이 파라미터를 사용하여 |
labels |
예 |
최대 30개의 JSON 객체 목록 각 JSON 객체의 필수 파라미터:
각 JSON 객체의 선택적 파라미터:
|
이 파라미터를 사용하여 레이블 또는 클래스를 지정합니다. 각 클래스에 대해 레이블에 레이블 범주 속성을 추가하려면 해당 레이블에 조정 레이블 지정 작업에서 레이블을 편집할 수 있는지 여부를 지정하는 데 자세한 정보는 다음 표를 참조하세요. |
annotationType (비디오 프레임 레이블 지정 작업에만 지원됨) |
아니요 |
String 허용되는 파라미터:
기본 값:
|
이를 사용하여 비디오 프레임 레이블 지정 작업의 작업 유형을 지정합니다. 예를 들어 다각형 비디오 프레임 객체 감지 작업의 경우 비디오 프레임 레이블 지정 작업을 생성할 때 |
instructions |
아니요 |
JSON 객체 각 JSON 객체의 필수 파라미터:
|
이 파라미터를 사용하여 작업자가 태스크를 완료하는 데 도움이 되는 작업자 지침을 추가합니다. 작업자 지침에 대한 자세한 내용은 작업자 지침 단원을 참조하세요. 간단한 지침은 255자 미만이어야 하며, 긴 지침은 2,048자 미만이어야 합니다. 자세한 내용은 지침 페이지 생성 단원을 참조하십시오. |
auditLabelAttributeName |
조정 및 확인 작업 유형에 필요합니다. |
String |
주석을 조정하려는 레이블 지정 작업에 LabelAttributeName 사용되는 를 입력합니다. 비디오 프레임 및 3D 포인트 클라우드 객체 감지, 객체 추적 또는 3D 포인트 클라우드 의미 체계 분할을 위해 조정 작업을 생성하는 경우에만 이 파라미터를 사용합니다. |
객체 스키마 레이블 지정
다음 표에는 Labels
목록을 만드는 데 사용할 수 있고 사용해야만 하는 파라미터를 설명합니다. 각 파라미터는 JSON 객체에 포함되어야 합니다.
파라미터 | 필수 | 허용되는 값 | Description |
---|---|---|---|
label |
예 |
String |
작업자에게 표시되는 레이블 범주의 이름. 각 레이블 범주 이름은 고유해야 합니다. |
categoryAttributes |
아니요 |
JSON 객체의 목록. 각 JSON 객체의 필수 파라미터:
각 JSON 객체의 선택적 파라미터:
|
이 파라미터를 사용하여 레이블에 하나 이상의 레이블 범주 속성을 추가하려면 |
editsAllowed |
아니요 |
String 지원되는 값:
또는
|
작업자가 레이블을 편집할 수 있는지 여부를 지정합니다. 비디오 프레임 또는 3D 포인트 클라우드 조정 레이블 지정 작업의 경우 3D 포인트 클라우드 및 비디오 프레임 확인 레이블 지정 작업의 경우 이 파라미터를 |
frameAttributes 및 categoryGlobalAttributes 스키마
다음 표에서는 frameAttributes
을(를) 이용한 프레임 속성 생성 그리고 categoryGlobalAttributes
및 categoryAttributes
파라미터를 이용한 레이블 범주 속성 생성에 사용할 수 있고 사용해야 하는 파라미터에 대해 설명합니다.
파라미터 |
필수 |
허용되는 값 |
Description |
---|---|---|---|
name |
예 |
String |
이 파라미터를 사용하여 레이블 범주 또는 프레임 속성에 이름을 지정합니다. 작업자가 볼 수 있는 속성 이름입니다. 레이블 범주 구성 파일의 각 레이블 범주 속성 이름은 고유해야 합니다. 글로벌 레이블 범주 속성과 레이블별 레이블 범주 속성은 같은 이름을 가질 수 없습니다. |
type |
예 |
String 필수 값:
|
이 파라미터를 사용하여 레이블 범주 또는 프레임 속성 유형을 정의합니다.
|
enum |
아니요 |
문자열 목록 |
이 파라미터를 사용하여 작업자가 이 레이블 범주 또는 프레임 속성에 대해 선택할 수 있는 옵션을 정의합니다. 작업자는
|
description |
|
String |
이 파라미터를 사용하여 레이블 범주 또는 프레임 속성에 대한 설명을 추가합니다. 이 필드를 사용하여 작업자에게 속성에 대한 자세한 정보를 제공할 수 있습니다. 이 필드는 프레임 속성에만 필수입니다. |
minimum 및 maximum |
type 속성이 "number" 인 경우 필수 |
정수 |
이 파라미터를 사용하여 작업자가 숫자 레이블 범주 또는 프레임 속성에 입력할 수 있는 최소값 및 최대값(포함)을 지정할 수 있습니다.
|
editsAllowed |
아니요 |
String 필수 값:
또는
|
작업자가 레이블 범주 또는 프레임 속성을 편집할 수 있는지 여부를 지정합니다. 비디오 프레임 또는 3D 포인트 클라우드 조정 및 확인 레이블 지정 작업의 경우 이 파라미터를 레이블 범주 및 프레임 속성 JSON 객체에 추가하여 작업자가 속성을 편집할 수 있는지 여부를 지정합니다. |
isRequired |
아니요 |
불 |
작업자가 속성에 주석을 달아야 하는지 여부를 지정합니다. 작업자는 모든 필수 속성에 주석을 달기 전까지는 작업을 제출할 수 없습니다. |
레이블 및 레이블 범주 속성 할당량
클래스당 최대 10개의 레이블 범주 속성을 지정할 수 있습니다. 이 10개의 속성 할당량에는 전역 레이블 범주 속성이 포함됩니다. 예를 들어, 4개의 전역 레이블 범주 속성을 생성한 다음 X
레이블에 3개의 레이블 범주 속성을 지정하면 해당 레이블에는 총 7개(4+3=7)의 레이블 범주 속성이 포함됩니다. 모든 레이블 범주 및 레이블 범주 속성 제한에 대해서는 다음 표를 참조하세요.
유형 |
최소 |
최대 |
---|---|---|
레이블( |
1 |
30 |
레이블 이름 문자 제한 |
1 |
16 |
레이블당 라벨 범주 속성( |
0 |
10 |
레이블당 자유 형식 텍스트 입력 레이블 범주 속성( |
0 | 5 |
프레임 속성 |
0 |
10 |
|
0 | 5 |
속성 이름 문자 할당( |
1 |
16 |
속성 설명 문자 할당( |
0 |
128 |
속성 유형 문자 할당( |
1 |
16 |
|
1 | 10 |
|
1 | 16 |
자유 형식 텍스트 frameAttributes 에 대한 자유 형식 텍스트 응답의 최대 문자 수 |
0 | 1000 |
자유 형식 텍스트 categoryAttributes 및 categoryGlobalAttributes 에 대한 자유 형식 텍스트 응답의 최대 문자 수 |
0 | 80 |