Building filtering

A building scene layer typically contains BIM information, which can include architectural elements like doors and walls. The doors and walls are depicted as feature layers organized into the Architectural discipline layer of the building layer. These feature layers contain 3D geometries and have like sets of attributes that may contain model, size, manufacturer, assembly code, and ID number as assigned in the BIM data.

A building scene layer is composed of sublayers. When the visibility for the sublayers is set to invisible by default, the building can be totally or partially invisible. For information about the building scene layer structure, refer to the spec document in GitHub.

The visibility for each sublayer can be changed such as according to their disciplines and names. With building filters, you can control the visibility of sublayers that are 3D object scene layers by filtering with attributes. For example, to see parts of a building that are on the second floor, you can set a filter to show only the second floor as solid (wireframe is not supported).

Apply building filters to layers

You can configure a building filter to toggle the visibility of sublayers. To apply or modify a building filter during the Play mode, use the C# API.

Disciplines & Categories

You can toggle the visibility of sublayers on the Disciplines & Categories window.

In the Disciplines & Categories row, check the box.
Click the gear icon next to Disciplines & Categories. The Disciplines & Categories window opens.
Check the disciplines and categories that you want to be visible.

Building Filter

The detailed information available in a building scene layer can be filtered to show only selected aspects of the layer based on attributes.

In the Building Filter row, check the box.
Click the Building Filter gear icon. The Building Filter window opens.
Click the New Filter tab and click + Add Filters to add a new filter.
Double-click the filter name New Filter and enter a new filter name to identify the filter.
On the Filter Attributes tab, select the filter you created in the previous step, then check the desired filter attributes.
On the Filter Definition tab, for each filter attribute on the left pane, check the desired filter definition values.
Click Generate WHERE Clause, then click Apply.

The scene should update according to the selected filters when the Apply button is clicked.

Note

On the WHERE Clause tab, you can see that the WHERE Clause has been generated.
You can also directly add the filter definition in the WHERE Clause tab with the following format. To add filters for multiple attributes, use and for the operator. Click Apply to see the changes.
Use dark colors for code blocksCopy
1 "ATTRIBUTE" in "DEFINITION_VALUE_1", "DEFINITION_VALUE_2"
Verify that the appropriate layers in the Disciplines and Categories are visible when applying a WHERE Clause.
On the New Filter tab, you can:
Rename filters
Duplicate a filter
Delete a filter
Jump to the WHERE Clause tab

You can toggle the visibility and set the opacity for ArcGISBuildingSceneSublayer.

To filter with attributes, ArcGISBuildingSceneLayerAttributeStatistics can be used to retrieve summary statistics. Use ArcGISSolidBuildingFilterDefinition to define the building filter definition with WHEREClauses. Use ArcGISBuildingAttributeFilter that takes in ArcGISSolidBuildingFilterDefinition to define the filter.

ArcGIS Maps SDK for Unity

Building filtering

Was this page helpful?