<?xml version="1.0" encoding="UTF-8"?><metadata>
<Esri>
<CreaDate>20181108</CreaDate>
<CreaTime>14204200</CreaTime>
<ArcGISFormat>1.0</ArcGISFormat>
<SyncOnce>TRUE</SyncOnce>
<ModDate>20181108</ModDate>
<ModTime>15302500</ModTime>
</Esri>
<dataIdInfo>
<idCitation>
<resTitle>Determine Optimum Travel Cost Network (Raster Analysis)</resTitle>
<date>
<createDate>20181108</createDate>
</date>
</idCitation>
<idAbs>
<para>Calculates the optimum cost network from a set of input regions.</para>
</idAbs>
<descKeys KeyTypCd="005">
<keyTyp>
<keyTyp>005</keyTyp>
</keyTyp>
<keyword>Distance</keyword>
<keyword>Distance</keyword>
<keyword>Connection</keyword>
<keyword>Connectivity</keyword>
<keyword>Cost</keyword>
<keyword>Cost Connectivity</keyword>
<keyword>Costconnectivity</keyword>
<keyword>Least</keyword>
<keyword>Least Cost</keyword>
<keyword>Least-Cost</keyword>
<keyword>Neighboring Connections</keyword>
<keyword>Network</keyword>
<keyword>Optimal</keyword>
</descKeys>
</dataIdInfo>
<distInfo>
<distributor>
<distorFormat>
<formatName Sync="TRUE">ArcToolbox Tool</formatName>
</distorFormat>
</distributor>
</distInfo>
<mdDateSt>20181108</mdDateSt>
<mdContact>
<rpOrgName>Environmental Systems Research Institute, Inc. (Esri)</rpOrgName>
<rpCntInfo>
<cntAddress>
<delPoint>380 New York Street</delPoint>
<city>Redlands</city>
<adminArea>California</adminArea>
<postCode>92373-8100</postCode>
<eMailAdd>info@esri.com</eMailAdd>
<country>United States</country>
</cntAddress>
<cntPhone>
<voiceNum>909-793-2853</voiceNum>
<faxNum>909-793-5953</faxNum>
</cntPhone>
<cntOnlineRes>
<linkage>http://www.esri.com</linkage>
</cntOnlineRes>
</rpCntInfo>
<role>
<RoleCd>007</RoleCd>
</role>
</mdContact>
<tool displayname="Determine Optimum Travel Cost Network (Raster Analysis)" name="DetermineOptimumTravelCostNetwork" softwarerestriction="none" toolboxalias="ra">
<summary>
<para>Calculates the optimum cost network from a set of input regions.</para>
</summary>
<alink_name>DetermineOptimumTravelCostNetwork_ra</alink_name>
<toolIllust alt="Determine Optimum Travel Cost Network tool illustration" src="withheld" type="dialog"/>
<toolIllust alt="Determine Optimum Travel Cost Network tool illustration" src="withheld" type="illustration"/>
<parameters>
<param datatype="Raster Layer; Image Service; Feature Layer; String" direction="Input" displayname="Input Regions Raster or Features" expression="inputRegionsRasterOrFeatures" name="inputRegionsRasterOrFeatures" sync="true" type="Required">
<pythonReference>
<para>The input regions that are to be connected by the least-cost network.</para>
<para>Regions can be defined by either an image service or a feature service.</para>
<para>If the region input is a raster, the regions are defined by groups of contiguous (adjacent) cells of the same value. Each region must be uniquely numbered. The cells that are not part of any region must be NoData. The raster type must be integer, and the values can be either positive or negative.</para>
<para>If the region input is a feature, it can be polygons, lines, or points. Polygon feature regions cannot be composed of multipart polygons.</para>
</pythonReference>
<dialogReference>
<para>The input regions that are to be connected by the least-cost network.</para>
<para>Regions can be defined by either an image service or a feature service.</para>
<para>If the region input is a raster, the regions are defined by groups of contiguous (adjacent) cells of the same value. Each region must be uniquely numbered. The cells that are not part of any region must be NoData. The raster type must be integer, and the values can be either positive or negative.</para>
<para>If the region input is a feature, it can be polygons, lines, or points. Polygon feature regions cannot be composed of multipart polygons.</para>
</dialogReference>
</param>
<param datatype="Raster Layer; Image Service; String" direction="Input" displayname="Input Cost Raster" expression="inputCostRaster" name="inputCostRaster" sync="true" type="Required">
<pythonReference>
<para>A raster defining the impedance or cost to move planimetrically through each cell.</para>
<para>The value at each cell location represents the cost-per-unit distance for moving through the cell. Each cell location value is multiplied by the cell resolution while also compensating for diagonal movement to obtain the total cost of passing through the cell.</para>
<para>The values of the cost raster can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).</para>
</pythonReference>
<dialogReference>
<para>A raster defining the impedance or cost to move planimetrically through each cell.</para>
<para>The value at each cell location represents the cost-per-unit distance for moving through the cell. Each cell location value is multiplied by the cell resolution while also compensating for diagonal movement to obtain the total cost of passing through the cell.</para>
<para>The values of the cost raster can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).</para>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="Output Optimum Network Name" expression="outputOptimumNetworkName" name="outputOptimumNetworkName" sync="true" type="Required">
<pythonReference>
<para>The name of the output optimum network feature service.</para>
<para>The polyline feature service of the optimum (least-cost) network of paths necessary to connect each of the input regions.</para>
<para>Each path (or line) is uniquely numbered, and additional fields in the attribute table store specific information about the path. Those fields include the following:</para>
<bulletList>
<bullet_item>PATHID—Unique identifier for the path</bullet_item>
<bullet_item>PATHCOST—Total accumulative cost for the path</bullet_item>
<bullet_item>REGION1—The first region the path connects</bullet_item>
<bullet_item>REGION2—The other region the path connects</bullet_item>
</bulletList>
<para>This information provides you insight into the paths within the network.</para>
<para>Since each path is represented by a unique line, there will be multiple lines in locations where paths travel the same route.</para>
</pythonReference>
<dialogReference>
<para>The name of the output optimum network feature service.</para>
<para>The polyline feature service of the optimum (least-cost) network of paths necessary to connect each of the input regions.</para>
<para>Each path (or line) is uniquely numbered, and additional fields in the attribute table store specific information about the path. Those fields include the following:</para>
<bulletList>
<bullet_item>PATHID—Unique identifier for the path</bullet_item>
<bullet_item>PATHCOST—Total accumulative cost for the path</bullet_item>
<bullet_item>REGION1—The first region the path connects</bullet_item>
<bullet_item>REGION2—The other region the path connects</bullet_item>
</bulletList>
<para>This information provides you insight into the paths within the network.</para>
<para>Since each path is represented by a unique line, there will be multiple lines in locations where paths travel the same route.</para>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="Output Neighbor Network Name" expression="outputNeighborNetworkName" name="outputNeighborNetworkName" sync="true" type="Optional">
<pythonReference>
<para>The name of the output Neighbor network feature service.</para>
<para>The polyline feature service identifying all paths from each region to each of its closest-cost neighbors.</para>
<para>Each path (or line) is uniquely numbered, and additional fields in the attribute table store specific information about the path. Those fields include the following:</para>
<bulletList>
<bullet_item>PATHID—Unique identifier for the path</bullet_item>
<bullet_item>PATHCOST—Total accumulative cost for the path</bullet_item>
<bullet_item>REGION1—The first region the path connects</bullet_item>
<bullet_item>REGION2—The other region the path connects</bullet_item>
</bulletList>
<para>This information provides you insight into the paths within the network and is particularly useful when deciding which paths should be removed if necessary.</para>
<para>Since each path is represented by a unique line, there will be multiple lines in locations where paths travel the same route.</para>
</pythonReference>
<dialogReference>
<para>The name of the output Neighbor network feature service.</para>
<para>The polyline feature service identifying all paths from each region to each of its closest-cost neighbors.</para>
<para>Each path (or line) is uniquely numbered, and additional fields in the attribute table store specific information about the path. Those fields include the following:</para>
<bulletList>
<bullet_item>PATHID—Unique identifier for the path</bullet_item>
<bullet_item>PATHCOST—Total accumulative cost for the path</bullet_item>
<bullet_item>REGION1—The first region the path connects</bullet_item>
<bullet_item>REGION2—The other region the path connects</bullet_item>
</bulletList>
<para>This information provides you insight into the paths within the network and is particularly useful when deciding which paths should be removed if necessary.</para>
<para>Since each path is represented by a unique line, there will be multiple lines in locations where paths travel the same route.</para>
</dialogReference>
</param>
</parameters>
<returnvalues/>
<environments>
<environment label="Cell size" name="cellSize"/>
<environment label="Output extent" name="extent"/>
<environment label="Mask" name="mask"/>
<environment label="Output coordinate system" name="outputCoordinateSystem"/>
<environment label="Snap raster" name="snapRaster"/>
</environments>
<usage>
<bullet_item>
<para>One example application of this tool is finding the best network for emergency vehicles.</para>
</bullet_item>
<bullet_item>
<para>The input regions can be either image services or feature services.</para>
</bullet_item>
<bullet_item>
<para>In a raster, a region is a group of cells with the same value that are contiguous to one another (adjacent). When your input regions are identified by a raster, if any zones (cells with the same value) are composed of multiple regions, first preprocess the data to assign unique values to each region.</para>
</bullet_item>
<bullet_item>
<para>Cell locations with NoData in the Input cost raster act as barriers.</para>
</bullet_item>
<bullet_item>
<para>The Input cost raster cannot contain values of zero since the algorithm is a multiplicative process. If your cost raster does contain values of zero, and these values represent areas of lowest cost, change values of zero to a small positive value (such as 0.01) before running Determine Optimum Travel Cost Network</para>
</bullet_item>
<bullet_item>
<para>For Ouput neighbor network, the neighbors are not identified by Euclidean distance but instead are identified by cost distance. Therefore, a region's closest neighbor is the cheapest one to travel to, not the one that is closest in distance</para>
</bullet_item>
</usage>
<scriptExamples>
<scriptExample>
<title>DetermineOptimumTravelCostNetwork example 1 (Python window)</title>
<para>This example calculates the optimum travel cost network.</para>
<code xml:space="preserve">import arcpy
arcpy.DetermineOptimumTravelCostNetwork_ra(
"https://myserver/rest/services/sources/ImageServer", "https://myserver/rest/services/costsurface/ImageServer", "outoptimumnetwork1")
</code>
</scriptExample>
<scriptExample>
<title>DetermineOptimumTravelCostNetwork example 2 (stand-alone script)</title>
<para>This example calculates the optimum travel cost network.</para>
<code xml:space="preserve">#-------------------------------------------------------------------------------
# Name: DetermineOptimumTravelCostNetwork_Ex_02.py
# Description: Calculates the optimum travel cost network.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputSourceLayer = 'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer = 'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
outputOptimumNetworkName = 'outNetworkRaster'
outputNeighborName = 'outNeighborRaster'
arcpy.DetermineOptimumTravelCostNetwork_ra(inputSourceLayer, zoneField, inputCostLayer,
outputOptimumNetworkName, outputNeighborName)
</code>
</scriptExample>
</scriptExamples>
<shortdesc>ArcGIS geoprocessing tool that calculates the optimum travel cost network.</shortdesc>
<arcToolboxHelpPath>withheld</arcToolboxHelpPath>
</tool>
</metadata>
