Dependent Tasks

Some tasks cannot be created until a root task they depend on has been completed (see 2D/3D Lidar Linking). Rather than waiting for the root task to complete before manually creating the dependent tasks, we can declare dependent tasks when creating the root task itself. In particular, this is currently supported for creating lidarlinking or lidarsegmentation tasks based off a Lidar Annotation task.

Currently, this relationship is defined either via the dependents field when creating a lidarannotation task or by specifying a lidar_task when creating a lidarlinking or lidarsegmentation task (see Start From Completed LIDAR Task.

To enable dependent tasks, you must include a dependents object when creating your lidarannotation task.

Definition: Dependents

{
  "annotation_attributes": {
    ...
  },
  "dependents": {
    "defs": [
      {
        "type": "lidarlinking",
        "annotation_type": "imageannotation",
        "instruction": "Adjust the annotations around the cars.",
        "callback_url": "https://www.example.com/callback",
      },
    ],
    "require_audit": true
  },
}

The dependents object describes what dependent tasks to create upon completion of this task.

Definition: DependentDef

"defs": [
    {
      "type": "lidarlinking",
      "annotation_type": "imageannotation",
      "instruction": "Adjust the annotations around the cars.",
      "callback_url": "http://www.example.com/callback2"
    }
  ]

DependentDef objects are used to describe the dependent task to be created, the properties of which are the same as the properties of a regular request to the corresponding endpoint, without the params that refer to the base task (e.g. lidar_task for lidarlinking tasks). These params will be added to the dependent task when it is created. In addition, a type parameter must be specified to identify the type of task to create. For example, if we were to create a dependent Lidar linking task based off a Lidar task, a sample DependentDef is shown above.

To learn more about lidarlinking params and tasks, see 2D/3D Linking.
To learn more about lidarsegmentation params and tasks, see Lidar Segmentation.