controlDistributorType

complexType · extension complexBaseType · all

Control distributor

single controlDistributor bundling several controlElements

Within some analyses, it might occur that overlapping control element settings are specified. In this case, it is assumed that a cumulative setting is built by summing up the individual settings. As the behavior of these settings is not necessarily linear, a certain order of summation has to be followed:

  1. The command inputs for each <controlDistributor>, coming from the <configurationUID>, as well as from separate settings have to be summed up to a total <commandInput>.
  2. With this total <commandInput>, each corresponding <controlDistributor> definition has to be evaluated, in order to get <controlParameter> settings for a number of <controlDevices>.
  3. All <controlParameter> settings for a control device, coming from the <configurationUID> , from the <controlDistributors> and from separate control device settings have to be summed up to get a total <controlParameter> for each controlDevice.
  4. With this total <controlParameter>, each corresponding control device definition has to be evaluated, in order to find out what the control device finally is doing.
  5. During the summation process (depending on the order of processing within step 1 to 4), <commandInputs> or <controlParameters> might exceed the specified limits for that <controlDistributor> or <controlDevices>. As an intermediate result, this should be accepted – however, when it comes to evaluation in step 2 and 4, all <commandInputs> and <controlParameters> have to be within the specified limits.

Attributes

NameTypeConstraintsUseDefaultDescription
@externalDataDirectoryxsd:stringoptionalDirectory of the external file the element was read from, as URI
@externalDataNodePathxsd:stringoptionalPath of the parent element in the merged dataset, at which the element was inserted from an external file
@externalFileNamexsd:stringoptionalName of the external file the element was read from
@uIDxsd:IDrequiredUID

Child elements

NameTypeConstraintsOccurrenceHow often the element may appear at this place. The schema writes it as minOccurs and maxOccurs on the declaration.DefaultDescription
allThe children below may appear in any order. Each may appear at most once.
namestringBaseType[0..1] optionalName
descriptionstringBaseType[0..1] optionalDescription
commandInputsstringVectorBaseType[1..1] requiredVector of command inputs. The minimum and maximum value is given by the lowest and highest entry of the vector, respectively.
controlElementscontrolElementsType[1..1] requiredControl elements driven by the control distributor

Used by

In a dataset · 2 paths

In the schema · 1 declaration

TypeName
controlDistributorsTypecontrolDistributor