HalfFace.cells_attribute

HalfFace.cells_attribute(name, value=None, cells=None)

Get or set an attribute of multiple cells.

Parameters:

namestr

The name of the attribute.

valueobject, optional

The value of the attribute.

cellslist[int], optional

A list of cell identifiers.

Returns:

list[Any] | None

A list containing the value per face of the requested attribute, or None if the function is used as a “setter”.

Raises:

KeyError

If any of the cells does not exist.

See also

cell_attribute(), cell_attributes(), cells_attributes()

vertex_attribute(), edge_attribute(), face_attribute()