all_subnetworks_in_tier (Optional) | Specifies whether all subnetworks in the tier will be updated. To update a subset of subnetworks in the tier, use the subnetwork_name parameter.
- ALL_SUBNETWORKS_IN_TIER—All subnetworks in the tier will be updated. This option uses asynchronous processing to update the subnetworks using the system UtilityNetworkTools geoprocessing service. The service is reserved for utility network geoprocessing tasks and has a longer default timeout setting. This is the default.
- SPECIFIC_SUBNETWORK—Only the subnetworks that are specified in the subnetwork_name parameter will be updated.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Optional) | Sets a traversability barrier condition on features based on a comparison to a network attribute or check for a category string. A condition barrier uses a network attribute or network category, an operator and a type, and an attribute value. For example, stop a trace when a feature has the Device Status attribute equal to the specific value of Open. When a feature meets this condition, the trace stops. If you're using more than one attribute, you can use the Combine using parameter to define an And or an Or condition.
Condition barrier components are as follows: - Name—Filter by any network attribute defined in the system or specify Category to use a network category.
- Operator—Choose from a number of operators.
- Type—Specify either Specific value or Network attribute for the type of value from the Name parameter that will serve as a barrier. The Type parameter must be Specific value when the Name parameter is Category.
- Value—Provide a specific value for the input attribute or category that would cause termination based on the operator value.
- Combine Using—Set this value if you have multiple conditions to add. You can combine them using an And or an Or condition.
The condition barrier Operator values are as follows: - IS_EQUAL_TO—The attribute is equal to the value.
- DOES_NOT_EQUAL—The attribute is not equal to the value.
- IS_GREATER_THAN—The attribute is greater than the value.
- IS_GREATER_THAN_OR_EQUAL_TO—The attribute is greater than or equal to the value.
- IS_LESS_THAN—The attribute is less than the value.
- IS_LESS_THAN_OR_EQUAL_TO—The attribute is less than or equal to the value.
- INCLUDES_THE_VALUES—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value).
- INCLUDES_ANY—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False).
The condition barrier type options are as follows: - SPECIFIC_VALUE—Filter by a specific value or network category.
- NETWORK_ATTRIBUTE—Filter by a network attribute.
The Combine Using values are as follows: - AND—Combine the condition barriers.
- OR—Use if either condition barrier is met.
Learn more about using multiple conditional expressions | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Optional) | Sets a traversability barrier on features based on a function. Function barriers can be used to do such things as restrict how far the trace travels from the starting point, or set a maximum value to stop a trace. For example, the length of each line traveled is added to the total distance traveled so far. When the total length traveled reaches the value specified, the trace stops.
Function barrier components are as follows: - Function—Choose from a number of different calculation functions.
- Attribute—Filter by any network attribute defined in the system.
- Operator—Choose from a number of different operators.
- Value—Set a specific value of the input attribute type that, if discovered, will cause the termination.
- Use Local Values—Calculate values in each direction as opposed to an overall global value. For example, use for a function barrier that is calculating the sum of Shape length in which the trace terminates if the value is greater than or equal to 4. In the global case, after you have traversed two edges with a value of 2, you have already reached a shape length sum of 4, so the trace stops. If local values are used, the local values along each path change, and the trace continues.
- TRUE—Local values will be used.
- FALSE—Global values will be used. This is the default.
The function barrier function options are as follows: - AVERAGE—The average of the input values will be calculated.
- COUNT—The number of features will be identified.
- MAX—The maximum of the input values will be identified.
- MIN—The minimum of the input values will be identified.
- ADD—The sum of the input values will be calculated.
- SUBTRACT—The difference in the input values will be calculated.Subnetwork controllers and loops trace types do not support the
subtract function.
For example, the starting point feature has a value of 20. The next feature has a value of 30. If you use the minimum function, the result is 20, maximum is 30, add is 50, average is 25, count is 2, and subtract is -10. The function barrier operator value options are as follows: - IS_EQUAL_TO—The attribute is equal to the value.
- DOES_NOT_EQUAL—The attribute is not equal to the value.
- IS_GREATER_THAN—The attribute is greater than the value.
- IS_GREATER_THAN_OR_EQUAL_TO—The attribute is greater than or equal to the value.
- IS_LESS_THAN—The attribute is less than the value.
- IS_LESS_THAN_OR_EQUAL_TO—The attribute is less than or equal to the value.
- INCLUDES_THE_VALUES—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value).
- INCLUDES_ANY—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False).
| Value Table |
traversability_scope (Optional) | Specifies the type of traversability that will be applied. Traversability scope determines whether traversability will be applied to junctions, edges, or both. For example, if a condition barrier is defined to stop the trace if DEVICESTATUS is equal to Open and traversability scope is set to edges only, the trace will not stop even if it encounters an open device, because DEVICESTATUS is only applicable to junctions. In other words, this parameter indicates to the trace whether to ignore junctions, edges, or both. - BOTH_JUNCTIONS_AND_EDGES—Traversability will be applied to both junctions and edges. This is the default.
- JUNCTIONS_ONLY—Traversability will be applied to junctions only.
- EDGES_ONLY—Traversability will be applied to edges only.
| String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Optional) |
Specifies the network attributes to propagate as well as how that propagation will occur during a trace.
Propagated class attributes denote the key values on subnetwork controllers that are disseminated to the rest of the features in the subnetwork. For example, in an electric distribution model, you can propagate the phase value. Propagators components are as follows: - Attribute—Filter by any network attribute defined in the system.
- Substitution Attribute—Use a substituted value instead of bitset network attribute values. Substitutions are encoded based on the number of bits in the network attribute being propagated. A substitution is a mapping of each bit in phase to another bit. For example, for Phase AC, one substitution could map bit A to B, and bit C to null. In this example, the substitution for 1010 (Phase AC) is 0000-0010-0000-0000 (512). The substitution captures the mapping so you know that Phase A was mapped to B and Phase C was mapped to null, and not the other way around (that is, Phase A was not mapped to null and Phase C was not mapped to B).
- Function—Choose from a number of calculation functions.
- Operator—Choose from a number of operators.
- Value—Provide a specific value for the input attribute type that would cause termination based on the operator value.
The propagators function value options are as follows: - PROPAGATED_BITWISE_AND—Compare the values from one feature to the next.
- PROPAGATED_MIN—Get the minimum value.
- PROPAGATED_MAX—Get the maximum value.
The propagators operator value options are as follows: - IS_EQUAL_TO—The attribute is equal to the value.
- DOES_NOT_EQUAL—The attribute is not equal to the value.
- IS_GREATER_THAN—The attribute is greater than the value.
- IS_GREATER_THAN_OR_EQUAL_TO—The attribute is greater than or equal to the value.
- IS_LESS_THAN—The attribute is less than the value.
- IS_LESS_THAN_OR_EQUAL_TO—The attribute is less than or equal to the value.
- INCLUDES_THE_VALUES—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value).
- INCLUDES_ANY—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False).
| Value Table |