Need better scanning performance?

Get a FREE customized reading template.

OutputTaskSetting Parameters

The OutputTaskSetting object configures how to output the expected results of a TargetROIDef by filtering the results of descendant TargetROIDef objects.

Example JSON

{
    "OutputTaskSettingOptions": [
        {
            "Name": "output_task",
            "OutputCondition": {
                "TaskResultArray": [
                    {
                        "TargetROIDefName": "B",
                        "TaskSettingNameArray": ["B_task"],
                        "Operator": "AND"
                    }
                ],
                "Operator": "AND"
            }
        }
    ]
}

Hierarchical Structure

This tree shows one OutputTaskSetting object inside OutputTaskSettingOptions.

OutputTaskSetting
├── Name
└── OutputCondition

Top-Level Parameters

Parameter Name	Description
`Name`	The unique name of the OutputTaskSetting object.
`OutputCondition`	The condition for outputting results.

How OutputCondition Works

OutputCondition defines how OutputTaskSetting filters and combines results from related ROIs.

Core Concepts

Concept	Description
Reference TargetROIDef	The `TargetROIDef` where the output task runs. It is the anchor ROI used to correlate descendant results.
Descendant TargetROIDef	A `TargetROIDef` linked to the reference ROI through location reference relationships. Its task results can be selected for output filtering.

Configuration Flow

Attach OutputTaskSetting to the reference TargetROIDef.
In OutputCondition.TaskResultArray, list descendant ROIs to participate in filtering.
For each entry, use BackwardReferenceOutput (when needed) to align descendant results back to the reference context.
Use Operator (AND/OR) to combine all condition entries.

Complete Example

The following example shows a complete OutputCondition configuration:

{
    "TargetROIDefOptions": [
        {
            "Name": "A_roi",
            "TaskSettingNameArray": ["ddn_task", "output_task"]
        },
        {
            "Name": "B_roi",
            "TaskSettingNameArray": ["dbr_task"],
            "Location": {
                "ReferenceObjectFilter": {
                    "ReferenceTargetROIDefNameArray": ["A_roi"],
                    "ReferenceTaskNameArray": ["ddn_task"]
                }
            }
        },
        {
            "Name": "C_roi",
            "TaskSettingNameArray": ["dlr_task"],
            "Location": {
                "ReferenceObjectFilter": {
                    "ReferenceTargetROIDefNameArray": ["A_roi"],
                    "ReferenceTaskNameArray": ["ddn_task"]
                }
            }
        }
    ],
    "OutputTaskSettingOptions": [
        {
            "Name": "output_task",
            "OutputCondition": {
                "TaskResultArray": [
                    {
                        "TargetROIDefName": "B_roi",
                        "BackwardReferenceOutput": {
                            "ReferenceTaskNameArray": ["ddn_task"]
                        }
                    },
                    {
                        "TargetROIDefName": "C_roi",
                        "BackwardReferenceOutput": {
                            "ReferenceTaskNameArray": ["ddn_task"]
                        }
                    }
                ],
                "Operator": "AND"
            }
        }
    ]
}

OutputTaskSetting example

Example Breakdown

Reference ROI: A_roi contains ddn_task and output_task.
Descendant ROIs: B_roi (dbr_task) and C_roi (dlr_task) are both linked to A_roi.
Filtering behavior: output_task collects eligible results from B_roi and C_roi, maps them through BackwardReferenceOutput, and applies AND logic.