Setup Level Territory Shape Parameters (Territory Design)

Summary

Tool allows setup level parameters for further create or balance territories.

Usage

• Territory Level must be at format: Level_Name[Level_Index]

• Available range for Compactness parameter is from 0 to 100

Syntax

SetupLevelTerritoryShapeParameters_TD_td (in_territory_solution_layer, in_level, {in_measure_type}, {in_compactness}, {in_use_only_closest}, {in_territory_center_location}, {in_summary_attribute})

Parameter	Explanation	Data Type
in_territory_solution_layer	Territory Solution layer to setup parameters	GP TD Layer
in_level	Territory Level to modify	String
in_measure_type (Optional)	Measure type for building territory shape STRAIGHT_LINE_DISTANCE —straight line distance will be used for calculate Maximum Distance, Minimum Distance and Minimum Distance Between Territory Centers DRIVE_DISTANCE —results of ArcGIS Network Analyst extension solver with Distance Units will be used for calculate distances DRIVE_TIME —results of ArcGIS Network Analyst extension solver with Time Units will be used for calculate distances	String
in_compactness (Optional)	This parameter can adjust preference between fine shape of territories and resulted balance of variables. Low value means good balance but worse shape, high value means good shape but worse balance.	Integer
in_use_only_closest (Optional)	This option overrides previously set balancing and minimum attribute capacity constraints to ensure a more ideal territory shape. Territories can only acquire features that are closest to their territory center, instead of centers of surrounding territories. This essentially puts less emphasis on statistical inputs and applies a heavier weight to maintaining a territory boundary. USE_ONLY_CLOSEST_FEATURES —only closest features will be used for growing territories USE_ALL_FEATURES —all surround features will be used for growing territories	Boolean
in_territory_center_location (Optional)	Location of non-fixed (created not from seed points) centers can be defined by this parameter. Territory center’s location will be automatically changed on every territory shape change, but always inside of territory shape. GEOMETRIC_CENTER —territory center will place into geometric center of territory (center of territory’s bound box) MEAN_CENTER —territory center will be placed into territory’s mean center by spatial locations with or without specified summary attribute DENSITY_CENTER —territory center will be placed into territory’s density center by spatial locations with or without specified summary attribute FARTHEST_POINT_FROM_ALL_BOUNDARIES —territory center will be located within a territory farthest from all its territory boundaries	String
in_summary_attribute (Optional)	Territories can be calculated using the geographic	Field

Code Sample

SetupLevelTerritoryShapeParameters_TD example (Python window)

The following Python window script demonstrates how to use the tool in immediate mode.

import arcgisscripting
gp = arcgisscripting.create()
gp.SetupLevelTerritoryShapeParameters_TD("new layer", "Territories[1]", "STRAIGHT_LINE_DISTANCE", 50, "USE_ALL_FEATURES", "MEAN_CENTER", "TOTPOP_CY")

SetupLevelTerritoryShapeParameters_TD example 2 (stand-alone script)

The following stand-alone script demonstrates how to use the tool.

# Import system modules
import arcgisscripting
gp = arcgisscripting.create()

# Set local variables
solution = "new layer"
level = "Territories[1]"
measureType = "STRAIGHT_LINE_DISTANCE"
compactness = 50
useFeatures = "USE_ALL_FEATURES"
territoryCenterLocation = "MEAN_CENTER"
summaryAttribute = "TOTPOP_CY"

# Execute tool
gp.SetupLevelTerritoryShapeParameters_TD(solution, level, measureType, compactness, useFeatures, territoryCenterLocation, summaryAttribute)

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcGIS for Desktop Basic: Requires Business Analyst

ArcGIS for Desktop Standard: Requires Business Analyst

ArcGIS for Desktop Advanced: Requires Business Analyst