Skip to main content

Import Features To Indoor Dataset (Indoors Tools)

Summary

Accepts features representing floor plan elements (such as walls, doors, and windows) as input and uses them to generate features in an Indoors workspace that conforms to the ArcGIS Indoors Information Model. The output of this tool can be used to create floor-aware maps.

Usage

  • Use this tool as part of a larger workflow to import floor plan features generated from point cloud or PDF data to an Indoors workspace.

  • The tool imports data for one level of a facility at a time.

  • The Input Polyline Features parameter value must be a z-enabled polyline feature class or layer with a horizontal coordinate system defined. For example, you can use the output of the Generate Floor Plan From Point Cloud tool or Extract Floor Plan Features From PDF tool as input to this tool. The input polylines should represent the boundaries of interior spaces, such as walls, windows, and doors.

  • Use the Elevation Of Level parameter to set the z-value of output level, unit, and detail features. By default, these features will be created with the same z-value as the input polylines.

  • Input polyline features will be used to create features in the target Indoors workspace, including units, levels, facilities, and, optionally, details.

  • The layers selected for the Target Facility Features, Target Level Features, Target Unit Features, and Target Detail Features parameters must all be sourced from the same Indoors workspace. This can be either a geodatabase or a feature service.

  • The values provided for the Facility Name, Level Name, and Vertical Order parameters will be used to populate attributes in the Facilities and Levels layers.

  • The z-values for the Levels, Units, and Details layers will be populated with the z-values of the input polyline features unless overridden by the Elevation Of Level parameter. Facility footprint features are assigned a z-value of 0.

    Note:

    All input polyline features must have the same z-value. If the input polyline layer contains features from multiple levels, set a selection on the layer so that all input features are at the same elevation.

  • If you choose to import details and the Input Polyline Features parameter value has a USE_TYPE field, values from this field will be written to the USE_TYPE field in the target details layer.

  • The tool does not honor the Allow geoprocessing tools to overwrite existing datasets option. If the data exists in the target feature layers when the tool is run, the following occurs based on the type of target layer:

    • Details—Existing features associated with the level specified in the tool will be deleted and reimported. Existing features associated with other levels will be preserved.

    • Units—Existing features associated with the level specified in the tool will be deleted and reimported. Existing features associated with other levels will be preserved.

    • Levels—If a level feature with the same associated facility, level name, and vertical order exists in the Indoors workspace, it will be updated to include the geometry of the new units being imported. Existing level features associated with other facilities, or with the same facility but having a different level name and vertical order value, will be preserved.

    • Facilities—If a feature with the specified facility name exists in the Indoors workspace, it will be updated to include the geometry of the new level being imported.

  • The Elevation Of Level parameter can be used to specify a value in meters or international feet that will be used to populate z-values for generated polylines or selected Indoors features. If no value is provided, the z-value of the input polylines is used.

  • The Door Identifier parameter can be used to select features in the input polyline features using an SQL query that defines doors that should be closed to create unit features.

  • The Point Features for Unit Attribution parameter can be used to map PDF text data stored in point features to attributes of Units features containing those point features. You can use the output text point features from the Extract Floor Plan Features From PDF tool as input to this parameter.

  • When point features for unit attribution are specified, the Text Point Mapping parameter can be used to specify which point features’ text to map to which Units attributes. Each mapping takes the following inputs:

  • Source Text Field—The field in the point features that contains the text to be mapped. The field must be type Text. This value is required.

  • Target Unit Field—Required. The field in the target Units features to which to map the text. The field must be type Text. This value is required.

  • Expression—Optional. A SQL Where clause to filter point features to map. If no expression is set, the tool maps text from all points in the unit. This value is optional.

  • Rule for Multiple Points Per Unit—Specifies how to map text when more than one text point in a unit matches the expression. This value is optional. The following options are supported:

    • First match—Only the first matching point’s text will be mapped. This is the default.

    • Last match—Only the last matching point’s text will be mapped.

    • Concatenate—All matching points’ text will be concatenated into a single space-delimited string and mapped.

    • Majority—The most common text among the matching points’ text will be mapped. In the event of a tie, the first matching point’s text is mapped.

  • The Gap Tolerance parameter can be used to set the proximity snapping tolerance for dangling endpoints of input features. This can help reduce the number of incomplete units or unused line segments. The default value is 0.039 international inches (1 millimeter).

    Note:

    Increasing gap tolerance temporarily increases the x,y tolerance during tool processing, which may result in reduced accuracy when importing geometry. Verify the accuracy of imported geometry after running the tool when increasing the Gap Tolerance parameter value.

Parameters

Label Explanation Data type

Input Polyline Features

The input polyline feature layer or feature class containing unit boundary data that will be imported into the Indoors workspace.

Feature Layer

Target Facility Features

The Facilities feature layer or feature class in the Indoors workspace that will be updated with imported features.

Feature Layer

Target Level Features

The Levels feature layer or feature class in the Indoors workspace that will be updated with imported features.

Feature Layer

Target Unit Features

The Units feature layer or feature class in the Indoors workspace that will be updated with imported features.

Feature Layer

Facility Name

The name of the facility to which features will be imported.

An existing facility name can be selected from the target Facilities layer, or a new facility name can be provided.

String

Level Name

The name of the level feature that will be created.

An existing value can be selected from the target Levels layer, or a new value can be provided.

String

Vertical Order

An ordinal integer representing the vertical order of each floor. The vertical order of the ground floor is zero (0). Floors above the ground floor have positive vertical order values, and floors below the ground floor have negative values.

Long

Target Detail Features

(Optional)

The Details feature layer or feature class in the Indoors workspace to which features will be imported.

Feature Layer

Gap Tolerance

(Optional)

The proximity tolerance for dangling endpoints of input features that will be snapped together. Values can be provided in millimeters or international inches. The default is 0.039 international inches.

Linear Units

Minimum Unit Width

(Optional)

The minimum width a polygon must be to be created as a unit in the target Units layer. Values can be provided in square meters or square international feet. The default is 3 international feet.

Linear Unit

Minimum Unit Area

(Optional)

The minimum area a polygon must be to be created as a unit in the target Units layer. Values can be provided in square meters or square international feet. The default is 9 square feet.

Areal Unit

Door Identifier

(Optional)

The polyline features that represent doors that are part of a unit boundary. Doors will be closed to create unit polygon features in the target Units layer.

SQL Expression

Elevation Of Level

(Optional)

The elevation of the level relative to a flat terrain. This value will be used to populate the z-value for levels, units, and details features. If no value is provided, the z-value of the output features will be set to the z-value of the input polyline features.

Linear Units

Point Features for Unit Attribution

(Optional)

The input point feature layer or feature class containing PDF text data that will be mapped to Units attributes.

Feature Layer

Text Point Mapping

(Optional)

The field mapping for input point features to populate a Text field in the Indoors workspace's Units layer.

Value table columns:

  • Source Text Field—The input point features' Text field that contains the annotation that will be mapped.

  • Target Unit Field—The text field in the target unit features' layer where the text will be mapped. The field must already exist.

  • Expression—A SQL WHERE clause used to filter input point features before mapping. Only points that meet the expression criteria will be considered for mapping. If no expression is provided, all points will be considered for mapping.

  • Rule for Multiple Points Per Unit—Specifies how to map text when more than one text point in a unit matches the expression.

    • First Match—Only the first matching point's text will be mapped. First match is determined by the features' ObjectID order in the attribute table.

    • Last Match—Only the last matching point's text will be mapped. Last match is determined by the features' ObjectID order in the attribute table.

    • Concatenate—All matching points' text will be concatenated into a single space-delimited string and mapped.

    • Majority—The most common text among the matching points' text will be mapped. In the event of a tie, the first matching point's text is mapped.

Value Table

Derived output

Label Explanation Data type

Updated Details

The updated Details feature layer or feature class.

Feature Layer

Updated Units

The updated Units feature layer or feature class.

Feature Layer

Updated Levels

The updated Levels feature layer or feature class.

Feature Layer

Updated Facilities

The updated Facilities feature layer or feature class.

Feature Layer

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Requires ArcGIS Indoors Pro or ArcGIS Indoors Maps