Definition

Use the nodes in the definition group to build a filtering sentence.

The definition group contains nodes responsible for building a filtering sentence. Filtering sentences add labels to lists of objects and pass them to translation nodes. Filtering itself, based on the labels, is performed inside the translation nodes, so actions are performed on the filtered elements. Then, the full list of objects may be returned and passed to other nodes.

The composition of filters is called a filtering schedule.

Example: Peek Column

Filters.PickColumns Defines way of filtering objects from the selection: extract all columns from the selection
Library		Dynamo4AM → Utilities → FilterElements
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line executing extraction of columns from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickElementsOfCategory Defines way of filtering objects from the selection: extract all elements of the given category from the selection
Library		Dynamo4AM → Utilities → FilterElements
Input	selection	Any list of objects and filtering schedule, if defined
	elementCatego ry	Identifier of the category to be extracted from the selection
Output	selection	A list of objects and filtering schedule, including the line executing extraction of elements of the given category from the selection
Remarks		Identifiers of the category are integer numbers and indicate elements that are recognized and manipulated by the script. It includes: 1 - Framing, 2 - columns, 3 - floors, 4 - walls. This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickElementsOfType Defines way of filtering objects from the selection: extract all elements of the given types from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
	type0	Element types to be extracted from the selection
	...	Use plus and minus icons to add more types to the definition
Output	selection	A list of objects and filtering schedule, including the line executing extraction of elements of the given types from the selection
Remarks		Types are labels passed from the Revit → Selection → Family Types, Floor Types or Wall Types nodes. This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickFloors Defines way of filtering objects from the selection: extract all floors from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line executing extraction of floors from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickFraming Defines way of filtering objects from the selection: extract framing (beams and braces) from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection
Output	selection
Remarks
Filters.PickWalls Defines way of filtering objects from the selection: extract walls from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line executing extraction of walls from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickLinearElements Defines way of filtering objects from the selection: extract all linear elements (beams, braces and columns) from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line executing extraction of linear elements from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickPlanarElements Defines way of filtering objects from the selection: extract all planar elements (floors and walls) from the selection
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line executing extraction of planar elements from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.PickNothing Defines way of filtering objects from the selection: do not extract anything
Library		Dynamo4AM → Definition → Filters
Input	selection	Any list of objects and filtering schedule, if defined
Output	selection	A list of objects and filtering schedule, including the line excluding all elements from the selection
Remarks		This node does not filter elements but flattens the input list and adds a filtering label at its end. The filtering will be executed by translation nodes. Filtering may be also performed by the Filters.Peek node.
Filters.Peek Filters objects basing on a defined filtering schedule
Library		Dynamo4AM → Definition → Filters
Input	selection	Any set of objects and a filtering schedule, if defined
	preview	Whether the filtered elements should be changed for lines and surfaces that are visualized in Dynamo preview
Output	output	A list of elements that are extracted from the selection basing on the defined filtering schedule
Remarks		Filtering is also executed inside translation nodes.