Skip to content

webknossos.skeleton.group

# &nbsp class Group:
# &nbsp Group( name: str, skeleton: webknossos.skeleton.skeleton.Skeleton, enforced_id: Union[int, NoneType] = None )

To create a group, it is recommended to use webknossos.skeleton.skeleton.Skeleton.add_group or Group.add_group. That way, the newly created group is automatically attached as a child to the object the method was called on.

A small usage example:

subgroup = group.add_group("a subgroup")
tree = subgroup.add_tree("a tree")
# &nbsp name: str
# &nbsp id: int

Read-only property.

# &nbsp def add_tree( self, name_or_tree: Union[str, webknossos.skeleton.tree.Tree], color: Union[Tuple[float, float, float, float], Tuple[float, float, float], NoneType] = None, _enforced_id: Union[int, NoneType] = None ) -> webknossos.skeleton.tree.Tree:

Adds a tree to the current group. If the first parameter is a string, a new tree will be added with the provided name and color if specified. Otherwise, the first parameter is assumed to be a tree object (e.g., from another skeleton). A copy of that tree will then be added. If the id of the tree already exists, a new id will be generated.

# &nbsp def add_graph( self, name: str, color: Union[Tuple[float, float, float, float], Tuple[float, float, float], NoneType] = None, _enforced_id: Union[int, NoneType] = None ) -> webknossos.skeleton.tree.Tree:

Deprecated, please use add_tree.

# &nbsp def remove_tree_by_id(self, tree_id: int) -> None:
# &nbsp children: collections.abc.Iterator[typing.Union[webknossos.skeleton.group.Group, webknossos.skeleton.tree.Tree]]

Returns all (immediate) children (groups and trees) as an iterator.

# &nbsp trees: Iterator[webknossos.skeleton.tree.Tree]

Returns all (immediate) tree children as an iterator. Use flattened_trees if you need also need trees within subgroups.

# &nbsp graphs: Iterator[webknossos.skeleton.tree.Tree]

Deprecated, please use trees.

# &nbsp groups: collections.abc.Iterator[webknossos.skeleton.group.Group]

Returns all (immediate) group children as an iterator. Use flattened_groups if you need also need groups within subgroups.

# &nbsp def add_group( self, name: str, _enforced_id: Union[int, NoneType] = None ) -> webknossos.skeleton.group.Group:

Adds a (sub) group to the current group with the provided name.

# &nbsp def get_total_node_count(self) -> int:

Returns the total number of nodes of all trees within this group (and its subgroups).

# &nbsp def get_max_tree_id(self) -> int:

Returns the highest tree id of all trees within this group (and its subgroups).

# &nbsp def get_max_graph_id(self) -> int:

Deprecated, please use get_max_tree_id.

# &nbsp def get_max_node_id(self) -> int:

Returns the highest node id of all nodes of all trees within this group (and its subgroups).

# &nbsp def flattened_trees(self) -> Iterator[webknossos.skeleton.tree.Tree]:

Returns an iterator of all trees within this group (and its subgroups).

# &nbsp def flattened_graphs(self) -> Iterator[webknossos.skeleton.tree.Tree]:

Deprecated, please use flattened_trees.

# &nbsp def flattened_groups(self) -> collections.abc.Iterator[webknossos.skeleton.group.Group]:

Returns an iterator of all groups within this group (and its subgroups).

# &nbsp def get_node_by_id(self, node_id: int) -> webknossos.skeleton.node.Node:

Returns the node which has the specified node id.

# &nbsp def get_tree_by_id(self, tree_id: int) -> webknossos.skeleton.tree.Tree:

Returns the tree which has the specified tree id.

# &nbsp def has_tree_id(self, tree_id: int) -> bool:

Returns true if this group (or a subgroup) contains a tree with the given id.

# &nbsp def get_graph_by_id(self, graph_id: int) -> webknossos.skeleton.tree.Tree:

Deprecated, please use get_tree_by_id.

# &nbsp def get_group_by_id(self, group_id: int) -> webknossos.skeleton.group.Group:

Returns the group which has the specified group id.

# &nbsp def as_nml_group(self) -> webknossos._nml.group.Group:

Returns a named tuple representation of this group.