Managing tasks

See how you can create and manage tasks on Mindkosh using the SDK

Once you've created a dataset and uploaded files to it, you can create a task to start annotating.

Here is how you can create a task.

from mindkosh import Client, Label

labelsObjects = [
    mindkosh.Label(
        name="Pedestrian",
        color=hex_codes[0],
        sequence=1,
        attributes=[
            {
                'name': 'Age-group',
                'input_type': 'radio',
                'default_value': 'Adult',
                'mutable': False,
                'values': ['Adult', 'Child']
            }
        ]
    ),
    mindkosh.Label(name="Truck", color=hex_codes[1], sequence=2),
]

newTask = client.task.create(
    name="sample-task",
    labels=labelsObjects,
    dataset_id=datasetId,
    project_id=213,
    job_modes=['validation','qc'],
    batches=3,
    tags=['tag1'],
)

Label properties

Property	Type	Required	Description
name	string	Yes	Name of the task.
color	string	Yes	Color of the label in hex string.
sequence	integer	Yes	Order in which the label will appear.
track	boolean	No	Whether this label should be tracked across frames.
lock_dimenions	boolean	No	Only for tracked labels in Point cloud tasks. If set to true, the dimensions of an object stay the same across all frames.
type	non_mask (default), semantic_mask or instance_mask	No	Whether the label is a Segmentation label.
attributes	array of dictionaries	No	See the attributes section below.

Label attributes (properties)

Mindkosh supports the following types of attributes:

Radio button Specify a range of choices from which the labeler can choose only 1.

{
    'name': 'Occlusion',
    'input_type': 'radio',
    'default_value': '0',
    'sequence': 1 ### Similar to label sequence, this specifies the order in which the property appears.
    'mutable': True, ### Only applicable to tracked labels. Can this attribute change from frame to frame?
    'values': ['0', '1', '2']
}

Checkbox Specify an attribute that can take on 2 values - True or False

{
    'name': 'Standing',
    'input_type': 'checkbox',
    'default_value': True,
    'sequence': 1 ### Similar to label sequence, this specifies the order in which the property appears.
    'mutable': True, ### Only applicable to tracked labels. Can this attribute change from frame to frame?
    'values' : ['true']
}

Text Enter freeform text. Can be used for OCR as well.

Number

Task parameters

Property	Type	Required	Description
name	string	Yes	Name of the task
labels	array of Label objects	Yes	Labels
dataset_id	integer	Yes	Dataset ID of the dataset from which to create the task.
tags	array of strings	No	Create a task from the dataset files that have the specified tags
project_id	integer	No	Project ID of an existing project in which this task will be placed.
job_mode	['validation'] or ['validation', 'qc']	No	What annotation modes will be present in the task. By default only the annotation is present.
batches	integer	No	How many batches should the task data be divided into