Block.faces_where

Block.faces_where(conditions=None, data=False, **kwargs)

Get faces for which a certain condition or set of conditions is true.

Parameters:

conditionsdict, optional

A set of conditions in the form of key-value pairs. The keys should be attribute names. The values can be attribute values or ranges of attribute values in the form of min/max pairs.

databool, optional

If True, yield the face attributes in addition to face identifiers.

**kwargsdict[str, Any], optional

Additional conditions provided as named function arguments.

Yields:

int | tuple[int, dict[str, Any]]

If data is False, the next face that matches the condition. If data is True, the next face and its attributes.

See also

vertices_where(), edges_where()

vertices_where_predicate(), edges_where_predicate(), faces_where_predicate()