Skip To Content

Thin Pathways

Available with a portal licensed with the Indoors capability.

Summary

Removes preliminary network pathways that are not needed for routing between selected locations on each floor, reducing the network dataset size and improving its route-solving performance.

Note:

The ArcGIS Indoors geoprocessing tools released at ArcGIS Pro 2.4 are not final and may change in a subsequent release.

Usage

  • When you use this tool, it is assumed that the Input Workspace parameter has a valid ArcGIS Indoors Information Model created by the Create Indoors Database tool.

  • The PrelimPathways features should be created by the Generate Pathways tool.

  • Routes are not calculated for any route location features outside the search tolerance from the PrelimPathways features.

  • During the pathway thinning process, the tool solves for the shortest path along the preliminary pathway between each route location and its N closest neighbors.

    Note:

    Where N is the Facility Solve Count parameter value.

  • Large Facility Solve Count values create better pathway connectivity but increase the solve time.

  • Output features are saved in the Transitions and Pathways feature classes under the Network feature dataset.

  • The Filter By Facility and Filter By Level parameter values are generated from the following fields in the PrelimPathways feature class:

    • FACILITY_NAME
    • LEVEL_NAME_FROM
    • LEVEL_NAME_TO

  • The FACILITY_NAME, LEVEL_NAME_FROM, and LEVEL_NAME_TO values must match in the PrelimPathways and PrelimTransitions features and any selected route locations.

  • The Network\Network ND network dataset must be deleted before the tool can be rerun on a workspace.

  • The following feature classes and attributes must be included in the geodatabase:

    FieldFeature class

    FACILITY_NAME, LEVEL_NAME_FROM, LEVEL_NAME_TO

    PrelimTransitions

    FACILITY_NAME, LEVEL_NAME_FROM, LEVEL_NAME_TO

    PrelimPathways

    FACILITY_ID, LENGTH_3D, LEVEL_NAME_FROM, LEVEL_NAME_TO

    Transitions

    ANGLE, FACILITY_ID, FACILITY_NAME, HEIGHT_FROM, HEIGHT_TO, LENGTH_3D, LEVEL_NAME_FROM, LEVEL_NAME_TO, PATHWAY_TYPE, VERTICAL_ORDER

    Pathways

    FACILITY_NAME, LEVEL_SHORT

    <User-selected routable locations feature classes>

Syntax

ThinPathways_indoors (in_workspace, routable_locations, search_tolerance, facility_solve_count, {filter_facility}, {filter_level})
ParameterExplanationData Type
in_workspace

An Indoors model workspace containing feature classes and tables needed for classification of pathways.

Workspace
routable_locations
[routable_locations,...]

The feature classes that contain all the locations inside a building between which routes will be calculated.

The feature classes must be z-enabled.

Feature Layer
search_tolerance

The search tolerance, in meters, for locating routable locations on the network. The default value is 5.

Note:

The value must be 0 or greater. Routable locations outside this value will be not be located.

Long
facility_solve_count

The number of destination points to solve when calculating routes between routable locations on each floor. The default value is 50.

Note:

The number of neighbors is the facility solve count. The value must be greater than 1. Large values can create better pathway connectivity but increase the solve time.

Long
filter_facility
[filter_facility,...]
(Optional)

The facility for which pathways will be generated or updated.

String
filter_level
[filter_level,...]
(Optional)

The level of the facility for which pathways will be generated or updated.

String

Derived Output

NameExplanationData Type
out_workspace

The input workspace with the Network dataset generated from the thinned pathways.

Workspace

Code sample

ThinPathways example 1 (Python window)

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

import arcpy
arcpy.Indoors.ThinPathways("C:/Indoors/ExampleCampus.gdb", "'C:/Indoors/ExampleCampus.gdb/AIIM/PointsOfInterest'; 'C:/Indoors/ExampleCampus.gdb\AIIM\Events'", 5, 50)
ThinPathways example 2 (stand-alone script)

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

# Name: Indoors_ThinPathways_example2.py
# Description: Thins pathways for an Indoors model input workspace

import arcpy

# set tool parameters
in_ws = 'C:/Indoors/ExampleCampus.gdb'
routable_locations = ["C:/Indoors/ExampleCampus.gdb/AIIM/Points of Interest", "C:/Indoors/ExampleCampus.gdb/AIIM/Events"]
search_tol = 7
facility_solve_count = 75
filter_facility = ["L", "Q", "M"]

# run the tool
arcpy.Indoors.ThinPathways(in_ws, routable_locations, search_tol, facility_solve_count, filter_facility, "#")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Requires Indoors, 3D Analyst, and Network Analyst

Related topics