Task
The task is the main sub-unit of the asset
object in the Ango Annotation Format. When obtaining an export from Ango Hub, you are essentially getting a list of assets, with each containing a task.
Tasks are what contain the actual labeling data (e.g. points, classifications, relations, etc.) as well as metadata regarding the labeling task (who labeled the asset, when, etc.)
This page details tasks and their metadata in the Ango Export Format.
General Structure
"task" : {
taskId // string, ID of the task
stage // string, name of the task (e.g. "Review Stage 2")
stageId // string, ID of the stage (e.g. "f9313189-d532-4fa3-ad9e-876af7321f6b")
updatedAt // string, last task update time (e.g. "2023-09-01T13:02:49.271Z")
updatedBy // string, email of user who last updated task (e.g. "[email protected]")
tools // list, annotation information pertaining to labels created with tools. See below for more.
classifications // list, annotation information pertaining to classifications. See below for more.
relations // list, annotation information pertaining to relations. See below for more.
brushDataUrl // string, signed, expiring URL to PNG mask containing brush traces.
medicalBrushDataUrl // string, signed, expiring URL to compressed .seg.nrrd segmentation file containing medical brush traces
stageHistory // list, contains more 'task' objects for each stage the asset has been through
totalDuration // integer, total duration of the task in milliseconds
consensusAverage // integer, from 0 to 100, the consensus score for the task
consensusDetailed // list, list of consensus scores for each compatible labeling tool (i.e. class)
}
Task Object Fields
taskId
Str
Unique alphanumeric ID assigned to the labeling task.
"taskId": "64e5e5b985eb730015b4ebd9"
stage
Str
Name of the stage from which the task has been exported.
"stage": "Complete"
stageId
Str
Unique ID of the stage from which the task has been exported. By default, the first Start, Label, and Complete stages automatically created by Hub on project creation have an ID of "Start", "Label", and "Complete" respectively.
"stageId": "f9313189-d532-4fa3-ad9e-876af7321f6b"
updatedAt
Str
GMT time and date at which the task was last updated in the stage from which the export was obtained.
"updatedAt": "2023-08-23T11:36:38.027Z"
updatedBy
Str
Email of the user who last updated the task in the stage from which the export was obtained.
"updatedBy": "[email protected]"
totalDuration
Int
The time it took, in milliseconds, to label the asset in the stage from which the export was obtained. The timer starts when a user opens the asset and stops when they click on "Submit." In the near future, as the idle time detection features come online, the export will contain a more detailed breakdown of time, including active and idle time.
"totalDuration": 49596
tools
List
Annotation data related to labels created with non-classification and non-relation tools (e.g. bounding box, entity, polygon, etc.) This object contains the actual annotation information (e.g. coordinates). Documentation for this object can be found at the Tools page.
"tools": [
{
"bounding-box": {
"x": 301.6699801192843,
"y": 429.05027932960894,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"objectId": "765742a3b676d3f26898792",
"classifications": [],
"metadata": {
"createdAt": "2023-08-23T11:20:32.792Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"schemaId": "b1c6805d054f0e44ae11500",
"page": 504,
"title": "bb"
}
]
classifications
List
Annotation data related to labels created with classification tools. This object contains the classification questions and answers, as well as classification metadata. Documentation for this object can be found at the Classifications page.
"classifications": [
{
"objectId": "3d5cd10ba190b29d2850724",
"schemaId": "6421df1fa34ac13204ea157",
"tool": "radio",
"title": "rdo",
"answer": "1",
"metadata": {
"createdAt": "2023-08-23T11:20:51.725Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
}
]
relations
List
Annotation data related to labels created with relation tools. Documentation for this object can be found at the Relations page.
"relations": [
{
"from": "ea5d40fe8a8093fa2680331",
"to": "4385a5c80ad1ee0e5cd2693",
"objectId": "c7a5cffbcd8cfaf05a2f248",
"schemaId": "8f8e617174718e80bbea268",
"direction": "straight",
"page": 0,
"title": "sng"
}
]
brushDataUrl
Str
URL pointing to a PNG image file containing the brush traces created on the asset with Brush tools. Only one such URL is generated for each asset. The URL is valid for 120000 seconds from its creation (e.g. time of export). The resulting PNG will be a file with the same width and height as the original asset, it will have a transparent background, and brush traces will be drawn on it with a color with the same hex value as the color of the brush tool used.
"brushDataUrl": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/64f1de0ca7fabb00150e9b53-1693573237278.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230901%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230901T131148Z&X-Amz-Expires=120000&X-Amz-Signature=eecea8981441f531ab947d6bcaf5e5c0ad2c6525f4def969ff67ad2e4b6227d5&X-Amz-SignedHeaders=host&x-id=GetObject"
medicalBrushDataUrl
Str
URL pointing to a compressed .seg.nrrd
file containing the segmentations created on the asset with Medical Brush tools.
Only one such URL is generated for each asset.
The URL is valid for 120000 seconds from its creation (e.g. time of export).
"medicalBrushDataUrl": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/medical-uncompressed-nifti-2023-09-01-13_03_01_GMT.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230901%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230901T131148Z&X-Amz-Expires=120000&X-Amz-Signature=84d94e319ac5b6ecc7a6e1e39829b697c064dabe54815a6459b9bcaf9f53eb84&X-Amz-SignedHeaders=host&x-id=GetObject"
stageHistory
List
If enabled in export settings, stageHistory
contains one task
objects of the asset for each of the previous stages the asset has passed through.
For example, if the asset went through Start -> Label -> Review -> Complete, and you obtained the export for Complete, the stageHistory object will list three task
objects, one each for Start, Label, and Review.
In each, you will get the state of the task as it was when it left its stage.
"stageHistory": [
{
"stage": "Start",
"stageId": "Start",
"duration": 0,
"completedAt": "2023-08-23T10:55:53.495Z",
"tools": [],
"classifications": [],
"relations": []
}, { ... }
]
consensusAverage
Integer
The consensus score for this task, from 0 to 100.
"consensusAverage": 39
consensusDetailed
List
A list of consensus scores for each consensus-compatible labeling tool (i.e. class) in the task.
"consensusDetailed": [
{
"score": "100",
"schemaId": "5b803d45s221s",
"title": "Vehicle"
}, { ... }
]
Sample Task
{
"taskId": "64e5e5b985eb730015b4ebd9",
"stage": "Complete",
"stageId": "Complete",
"updatedAt": "2023-08-23T11:36:38.027Z",
"updatedBy": "[email protected]",
"totalDuration": 49596,
"tools": [
{
"bounding-box": {
"x": 301.6699801192843,
"y": 429.05027932960894,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"objectId": "765742a3b676d3f26898792",
"classifications": [],
"metadata": {
"createdAt": "2023-08-23T11:20:32.792Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"schemaId": "b1c6805d054f0e44ae11500",
"page": 504,
"title": "bb"
},
{
"polygon": [
[
593.6779324055666,
1121.9664804469273
],
[
443.3797216699801,
1349.36312849162
],
[
576.5009940357853,
1375.1061452513966
]
],
"objectId": "408deff4664cc342d236127",
"classifications": [],
"metadata": {
"createdAt": "2023-08-23T11:20:37.127Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"schemaId": "a966c7799383465850cd803",
"page": 504,
"title": "gon"
},
{
"objectId": "765742a3b676d3f26898792",
"schemaId": "b1c6805d054f0e44ae11500",
"classifications": [],
"bounding-box": {
"x": 801.948310139165,
"y": 1428.7374301675977,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"metadata": {
"createdAt": "2023-08-23T11:20:40.952Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"page": 506,
"title": "bb"
},
{
"objectId": "408deff4664cc342d236127",
"schemaId": "a966c7799383465850cd803",
"classifications": [],
"polygon": [
[
217.93240556660038,
229.54189944134077
],
[
67.63419483101391,
456.9385474860335
],
[
200.75546719681907,
482.68156424581
]
],
"metadata": {
"createdAt": "2023-08-23T11:20:42.215Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"page": 506,
"title": "gon"
}
],
"classifications": [
{
"objectId": "3d5cd10ba190b29d2850724",
"schemaId": "6421df1fa34ac13204ea157",
"tool": "radio",
"title": "rdo",
"answer": "1",
"metadata": {
"createdAt": "2023-08-23T11:20:51.725Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
},
{
"objectId": "f4e53917c222c8e62dbb715",
"schemaId": "1ea7a275ce5c9cf30a6f148",
"tool": "checkbox",
"title": "chk",
"answer": [
"1"
],
"metadata": {
"createdAt": "2023-08-23T11:20:52.716Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
},
{
"objectId": "0b057a52a2bb648b197f180",
"schemaId": "a2b4a50bb90eb6523b88376",
"tool": "single-dropdown",
"title": "sdr",
"answer": "1",
"metadata": {
"createdAt": "2023-08-23T11:20:54.180Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
},
{
"objectId": "19ae5491832a3bd42704684",
"schemaId": "11f6ed8e4ac4852d3422341",
"tool": "multi-dropdown",
"title": "mdr",
"answer": [
"1"
],
"metadata": {
"createdAt": "2023-08-23T11:20:55.684Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
},
{
"objectId": "7ed41243066d9b09e652723",
"schemaId": "c2b5eb27e55b186f84f3898",
"tool": "tree-dropdown",
"title": "tre",
"answer": [
"1",
"1 / 2"
],
"metadata": {
"createdAt": "2023-08-23T11:20:59.723Z",
"createdBy": "[email protected]",
"createdIn": "Label",
"updatedAt": "2023-08-23T11:21:01.940Z",
"updatedBy": "[email protected]",
"updatedIn": "Label"
},
"classifications": []
},
{
"objectId": "bde3bab1fbdbcecdc891100",
"schemaId": "6590a72d09f1760a4578032",
"tool": "text",
"title": "txt",
"answer": "2",
"metadata": {
"createdAt": "2023-08-23T11:21:01.100Z",
"createdBy": "[email protected]",
"createdIn": "Label"
},
"classifications": []
}
],
"relations": [],
"stageHistory": [
{
"stage": "Start",
"stageId": "Start",
"duration": 0,
"completedAt": "2023-08-23T10:55:53.495Z",
"tools": [],
"classifications": [],
"relations": []
},
{
"stage": "Label",
"stageId": "Label",
"duration": 46753,
"completedAt": "2023-08-23T11:21:04.393Z",
"completedBy": "[email protected]",
"tools": [
{
"bounding-box": {
"x": 301.6699801192843,
"y": 429.05027932960894,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"objectId": "765742a3b676d3f26898792",
"classifications": [],
"schemaId": "b1c6805d054f0e44ae11500",
"page": 504,
"title": "bb"
},
{
"polygon": [
[
593.6779324055666,
1121.9664804469273
],
[
443.3797216699801,
1349.36312849162
],
[
576.5009940357853,
1375.1061452513966
]
],
"objectId": "408deff4664cc342d236127",
"classifications": [],
"schemaId": "a966c7799383465850cd803",
"page": 504,
"title": "gon"
},
{
"objectId": "765742a3b676d3f26898792",
"schemaId": "b1c6805d054f0e44ae11500",
"classifications": [],
"bounding-box": {
"x": 801.948310139165,
"y": 1428.7374301675977,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"page": 506,
"title": "bb"
},
{
"objectId": "408deff4664cc342d236127",
"schemaId": "a966c7799383465850cd803",
"classifications": [],
"polygon": [
[
217.93240556660038,
229.54189944134077
],
[
67.63419483101391,
456.9385474860335
],
[
200.75546719681907,
482.68156424581
]
],
"page": 506,
"title": "gon"
}
],
"classifications": [
{
"objectId": "3d5cd10ba190b29d2850724",
"schemaId": "6421df1fa34ac13204ea157",
"tool": "radio",
"title": "rdo",
"answer": "1",
"classifications": []
},
{
"objectId": "f4e53917c222c8e62dbb715",
"schemaId": "1ea7a275ce5c9cf30a6f148",
"tool": "checkbox",
"title": "chk",
"answer": [
"1"
],
"classifications": []
},
{
"objectId": "0b057a52a2bb648b197f180",
"schemaId": "a2b4a50bb90eb6523b88376",
"tool": "single-dropdown",
"title": "sdr",
"answer": "1",
"classifications": []
},
{
"objectId": "19ae5491832a3bd42704684",
"schemaId": "11f6ed8e4ac4852d3422341",
"tool": "multi-dropdown",
"title": "mdr",
"answer": [
"1"
],
"classifications": []
},
{
"objectId": "7ed41243066d9b09e652723",
"schemaId": "c2b5eb27e55b186f84f3898",
"tool": "tree-dropdown",
"title": "tre",
"answer": [
"1",
"1 / 2"
],
"classifications": []
},
{
"objectId": "bde3bab1fbdbcecdc891100",
"schemaId": "6590a72d09f1760a4578032",
"tool": "text",
"title": "txt",
"answer": "2",
"classifications": []
}
],
"relations": []
},
{
"stage": "Review",
"stageId": "5e8f78a7-ef6a-473d-b02f-f4024c9ee486",
"duration": 2843,
"reviewStatus": "Accepted",
"completedAt": "2023-08-23T11:36:38.074Z",
"completedBy": "[email protected]",
"tools": [
{
"bounding-box": {
"x": 301.6699801192843,
"y": 429.05027932960894,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"objectId": "765742a3b676d3f26898792",
"classifications": [],
"schemaId": "b1c6805d054f0e44ae11500",
"page": 504,
"title": "bb"
},
{
"polygon": [
[
593.6779324055666,
1121.9664804469273
],
[
443.3797216699801,
1349.36312849162
],
[
576.5009940357853,
1375.1061452513966
]
],
"objectId": "408deff4664cc342d236127",
"classifications": [],
"schemaId": "a966c7799383465850cd803",
"page": 504,
"title": "gon"
},
{
"objectId": "765742a3b676d3f26898792",
"schemaId": "b1c6805d054f0e44ae11500",
"classifications": [],
"bounding-box": {
"x": 801.948310139165,
"y": 1428.7374301675977,
"height": 173.76536312849163,
"width": 118.09145129224652
},
"page": 506,
"title": "bb"
},
{
"objectId": "408deff4664cc342d236127",
"schemaId": "a966c7799383465850cd803",
"classifications": [],
"polygon": [
[
217.93240556660038,
229.54189944134077
],
[
67.63419483101391,
456.9385474860335
],
[
200.75546719681907,
482.68156424581
]
],
"page": 506,
"title": "gon"
}
],
"classifications": [
{
"objectId": "3d5cd10ba190b29d2850724",
"schemaId": "6421df1fa34ac13204ea157",
"tool": "radio",
"title": "rdo",
"answer": "1",
"classifications": []
},
{
"objectId": "f4e53917c222c8e62dbb715",
"schemaId": "1ea7a275ce5c9cf30a6f148",
"tool": "checkbox",
"title": "chk",
"answer": [
"1"
],
"classifications": []
},
{
"objectId": "0b057a52a2bb648b197f180",
"schemaId": "a2b4a50bb90eb6523b88376",
"tool": "single-dropdown",
"title": "sdr",
"answer": "1",
"classifications": []
},
{
"objectId": "19ae5491832a3bd42704684",
"schemaId": "11f6ed8e4ac4852d3422341",
"tool": "multi-dropdown",
"title": "mdr",
"answer": [
"1"
],
"classifications": []
},
{
"objectId": "7ed41243066d9b09e652723",
"schemaId": "c2b5eb27e55b186f84f3898",
"tool": "tree-dropdown",
"title": "tre",
"answer": [
"1",
"1 / 2"
],
"classifications": []
},
{
"objectId": "bde3bab1fbdbcecdc891100",
"schemaId": "6590a72d09f1760a4578032",
"tool": "text",
"title": "txt",
"answer": "2",
"classifications": []
}
],
"relations": []
}
]
}
Last updated