CDS Processing Priority

In the GeoCue Command Dispatch System (CDS) the Processing Priority (or simply priority) determines the processing order of subtasks that could otherwise process in any order. Priority in the CDS is a floating point number ranging from 0.0 to MAX_FLOAT. Higher values are considered higher priority. For example, assume that two LIDAR Orthos are in the CDS dispatch queue and that these ortho subtasks have priorities of 1.0 and 7.3. Also assume that only one machine is available for processing. In this simple scenario, the ortho with priority 7.3 will be processed prior to the ortho with priority 1.0.

Subtask priority is computed in GeoCue as subtasks are entered into the dispatch queue. Priority is set at three levels in GeoCue: 

  • Entity 
  • Project 
  • Processing Cloud

These priorities are combined in a priority weighting equation to arrive at a single final priority value.

The ultimate priority of a subtask in the CDS is computed based on the individual priority settings for Entities, Project and Processing Group. The computed priority is scaled by priority weights that are set in Environment Builder and Dispatch Manager -> Configuration -> Options -> Priority . The parameters that are used in ultimate priority computation are given in the following table.

Parameter Description Notes
Entity Relative Priority (ERP) The priority assigned to an individual entity The valid range is 0.0 to MAX_FLOAT. The system default is 1.0.  Can be interactively assigned using Entity Manager.
Project Relative Priority (PRP) The priority assigned to an individual project. The valid range is 0.0 to MAX_FLOAT. The system default is 1.0. Assigned using Project Properties or Project Utilities.
Group Relative Priority (GRP) The priority assigned to a Processing Cloud. The valid range is 0.0 to MAX_FLOAT. The system default is 1.0. Assigned using the Configuration tab of Dispatch Manager, Clouds sub-tab.
Entity Priority Weight (EPW) A weighting factor applied to the Entity Relative Priority.  The valid range is 0.0 to MAX_FLOAT. The default value is 1.0.  Assigned using the Entity tab of Environment Builder, Entity Types section, Modify option.
Project Priority

Weight (PPW)

A weighting factor applied to the Project Relative Priority.  The valid range is 0.0 to MAX_FLOAT. Assigned using the Configuration tab of Dispatch Manager, Options, Priority sub-tab.
Group Priority Weight (GPW) A weighting factor applied to the Group Relative Priority.  The valid range is 0.0 to MAX_FLOAT. Assigned using the Configuration tab of Dispatch Manager, Options, Priority sub-tab.

It is important to note that the Command Dispatch System will order the processing of subtasks based on the final computed priority of the subtask. Thus, depending on the priority parameters and weights, a subtask from a low priority project may ultimately process prior to a subtask from a higher priority subtask.

If clipping is not being used, the ultimate priority of a subtask is given by the formula of:

Priority = (ERP x EPW) + (PRP x PPW) + (GRP x GPW)

Priority Range Clipping are values that you can set to clip the maximum value of each of the partial priorities (entity, project, group) above. This provides more flexibility in setting up system priority schemes.

NOTE: Priority is global within the Command Dispatch System. For example, assume task A comprising 100 subtasks, each having priority 10 is dispatched. Sometime later, Task B comprising subtasks of priority 11 is launched. All of the Task B subtasks will move ahead of the remaining Task A subtasks due to their higher priority values. The priority for each subtask can be reviewed on the subtask pane of Dispatch Manager.

Priority Visible in Dispatch Manager

Share

GeoCue Support has written 724 articles