HalfFace.cells_attributes

HalfFace.cells_attributes(names=None, values=None, cells=None)

Get or set multiple attributes of multiple cells.

Parameters:

nameslist[str], optional

The names of the attribute. Default is None.

valueslist[Any], optional

The values of the attributes. Default is None.

cellslist[int], optional

A list of cell identifiers.

Returns:

list[dict[str, Any]] | list[list[Any]] | None

If the parameter names is empty, a list containing per cell an attribute dict with all attributes (default + custom) of the cell. If the parameter names is empty, a list containing per cell a list of attribute values corresponding to the requested names. None if the function is used as a “setter”.

Raises:

KeyError

If any of the faces does not exist.

See also

cell_attribute(), cell_attributes(), cells_attribute()

vertex_attributes(), edge_attributes(), face_attributes()