Skip To Content ArcGIS for Developers Sign In Dashboard

UtilityTraceConfiguration Class


The set of utility network parameters that define elements of a trace or of a subnetwork. More...

Header: #include <UtilityTraceConfiguration>
Since: Esri::ArcGISRuntime 100.7
Inherits: Object

Public Functions

UtilityTraceConfiguration(QObject *parent = nullptr)
UtilityDomainNetwork *domainNetwork() const
UtilityTraceFilter *filter() const
bool isIgnoreBarriersAtStartingPoints() const
bool isIncludeBarriers() const
bool isIncludeContainers() const
bool isIncludeContent() const
bool isIncludeIsolatedFeatures() const
bool isIncludeStructures() const
bool isValidateConsistency() const
UtilityPropagatorListModel *propagators() const
void setDomainNetwork(UtilityDomainNetwork *domainNetwork)
void setFilter(UtilityTraceFilter *filter)
void setIgnoreBarriersAtStartingPoints(bool ignoreBarriersAtStartingPoints)
void setIncludeBarriers(bool includeBarriers)
void setIncludeContainers(bool includeContainers)
void setIncludeContent(bool includeContent)
void setIncludeIsolatedFeatures(bool includeIsolatedFeatures)
void setIncludeStructures(bool includeStructures)
void setSourceTier(UtilityTier *sourceTier)
void setTargetTier(UtilityTier *targetTier)
void setTraversability(UtilityTraversability *traversability)
void setValidateConsistency(bool validateConsistency)
UtilityTier *sourceTier() const
UtilityTier *targetTier() const
UtilityTraversability *traversability() const
  • 31 public functions inherited from QObject

Additional Inherited Members

Detailed Description

The set of utility network parameters that define elements of a trace or of a subnetwork.

Member Function Documentation

UtilityTraceConfiguration::UtilityTraceConfiguration(QObject *parent = nullptr)

Creates a UtilityTraceConfiguration with default values.

  • parent - The optional parent object.



UtilityDomainNetwork *UtilityTraceConfiguration::domainNetwork() const

Returns the UtilityDomainNetwork from which to start the trace.

The UtilityDomainNetwork property is required and only used with subnetwork-based traces (UtilityTraceType::Subnetwork, UtilityTraceType::Upstream, and so on).

See also setDomainNetwork().

UtilityTraceFilter *UtilityTraceConfiguration::filter() const

Returns the criteria that define the dynamic barriers for the trace.

This function was introduced in Esri::ArcGISRuntime 100.8.

See also setFilter().

bool UtilityTraceConfiguration::isIgnoreBarriersAtStartingPoints() const

Returns whether to ignore barriers at starting points.

The default is false.

One example of how this can be used is with an upstream protective device trace. The first call to the trace will return the first upstream device that meets the protective device criteria. To find the next device upstream, you would set a starting point on the device returned by the first trace. With IgnoreBarriersAtStartingPoints set to false, this second trace would immediately stop at the starting point, since it meets the trace termination criteria. Setting this option to true will allow the trace to ignore the starting point, and continue to the subsequent device upstream.

See also setIgnoreBarriersAtStartingPoints.

bool UtilityTraceConfiguration::isIncludeBarriers() const

Returns whether to include barriers in the trace results or subnetwork.

The default is true.

See also setIncludeBarriers.

bool UtilityTraceConfiguration::isIncludeContainers() const

Returns whether to include containment features in the trace results or subnetwork.

The default is false.

See also setIncludeContainers.

bool UtilityTraceConfiguration::isIncludeContent() const

Returns whether to include content in the trace results or subnetwork.

The default is false.

See also setIncludeContent.

bool UtilityTraceConfiguration::isIncludeIsolatedFeatures() const

Returns whether to include isolated features in the trace results when used in conjunction with the Isolation Trace.

The default is false.

This function was introduced in Esri::ArcGISRuntime 100.8.

See also setIncludeIsolatedFeatures.

bool UtilityTraceConfiguration::isIncludeStructures() const

Returns whether to include structure features in the trace results or subnetwork.

The default is false.

See also setIncludeStructures.

bool UtilityTraceConfiguration::isValidateConsistency() const

Returns whether to validate network consistency as part of the trace operation.

If set to true, trace operations will fail if dirty areas are encountered during the trace. The default is true.

UtilityPropagatorListModel *UtilityTraceConfiguration::propagators() const

Returns a collection of UtilityPropagator objects to execute while performing the trace.

Propagator objects allow a subset of UtilityNetworkAttribute values to propagate through a network while executing a trace. For example, in phase propagation, open devices along the network will restrict some phases from continuing along the trace. Propagators only apply to subnetwork-based traces. (UtilityTraceType::Upstream, UtilityTraceType::Downstream, and so on).

void UtilityTraceConfiguration::setDomainNetwork(UtilityDomainNetwork *domainNetwork)

Sets the domainNetwork to domainNetwork.

See also domainNetwork().

void UtilityTraceConfiguration::setFilter(UtilityTraceFilter *filter)

Sets the filter to filter.

This function was introduced in Esri::ArcGISRuntime 100.8.

See also filter().

void UtilityTraceConfiguration::setIgnoreBarriersAtStartingPoints(bool ignoreBarriersAtStartingPoints)

Sets the ignoreBarriersAtStartingPoints to ignoreBarriersAtStartingPoints.

See also isIgnoreBarriersAtStartingPoints().

void UtilityTraceConfiguration::setIncludeBarriers(bool includeBarriers)

Sets the includeBarriers to includeBarriers.

See also isIncludeBarriers().

void UtilityTraceConfiguration::setIncludeContainers(bool includeContainers)

Sets the includeContainers to includeContainers.

See also isIncludeContainers().

void UtilityTraceConfiguration::setIncludeContent(bool includeContent)

Sets the includeContent to includeContent.

See also isIncludeContent().

void UtilityTraceConfiguration::setIncludeIsolatedFeatures(bool includeIsolatedFeatures)

Sets includeIsolatedFeatures to includeIsolatedFeatures.

This function was introduced in Esri::ArcGISRuntime 100.8.

See also isIncludeIsolatedFeatures().

void UtilityTraceConfiguration::setIncludeStructures(bool includeStructures)

Sets the includeStructures to includeStructures.

See also isIncludeStructures().

void UtilityTraceConfiguration::setSourceTier(UtilityTier *sourceTier)

Sets the sourceTier to sourceTier.

See also sourceTier().

void UtilityTraceConfiguration::setTargetTier(UtilityTier *targetTier)

Sets the targetTier to targetTier.

See also targetTier().

void UtilityTraceConfiguration::setTraversability(UtilityTraversability *traversability)

Sets the traversability to traversability.

See also traversability().

void UtilityTraceConfiguration::setValidateConsistency(bool validateConsistency)

Sets the validateConsistency to validateConsistency.

See also isValidateConsistency().

UtilityTier *UtilityTraceConfiguration::sourceTier() const

Returns the UtilityTier that is used as the start of the trace.

This property is only used with subnetwork-based traces (such as subnetwork upstream). If UtilityTraceConfiguration::domainNetwork represents a partitioned network, this property is optional. If not null, the trace routines will perform an additional check to validate that the starting points and barriers belong to this tier. If UtilityTraceConfiguration::domainNetwork represents a hierarchical network, this property is required. Since rows in hierarchical networks can belong to multiple tiers, this property tells the subnetwork tracer which tier to use for tracing.

See also setSourceTier().

UtilityTier *UtilityTraceConfiguration::targetTier() const

Returns the UtilityTier that is used to constrain the tiers returned by the upstream and downstream traces.

This property is optional. If null, the upstream and downstream traces will stop in the current tier. If a target tier is specified, the trace will continue upstream or downstream into the specified tier (inclusive).

See also setTargetTier().

UtilityTraversability *UtilityTraceConfiguration::traversability() const

Returns the traversability conditions for the trace.

See also setTraversability().

Feedback on this topic?