FormDiagram.faces_where

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

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

Parameters

• conditions (dict, 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.

• data (bool, optional) – If True, yield the face attributes in addition to face identifiers.

• **kwargs (dict[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.