Group#

class liesel.model.nodes.Group(name, **nodes_and_vars)[source]#

A group holds a collection of related Var and/or Node objects.

They allow you to do three basic things:

Store related nodes together for easier access.
Access their member nodes and variables via group["name"], where "name" is the group-specific name, which can be different from the Var.name / Node.name.
Easily retrieve a variable’s or a node’s value from a Model.state based on their group-specific name via value_from().

Parameters:

name (str) – The group’s name. Must be unique among the groups of its members, and within a model.
**nodes_and_vars (Node | Var) – An arbitrary number of nodes or variables. The keywords will be used as the group-specific names of the respective objects.

See also

Node.groups and Var.groups are MappingProxyType objects (basically read-only dictionaries) of the groups whose member the respective object is.
GraphBuilder.groups() and Model.groups() are methods that collect and return all groups within the graph/model.

Notes

Note the following:

Examples

Add a variable to a group:

>>> my_var = lsl.Var(0.0, name="long_unique_variable_name")
>>> grp = lsl.Group(name="demo_group", short_name=my_var)
>>> grp
Group<demo_group>

Access the variable by its group-specific name:

>>> grp["short_name"]
Var<long_unique_variable_name>

Retrieve the value of a variable from a model state:

>>> model_state = {my_var.value_node.name: lsl.NodeState(10., False)}
>>> grp.value_from(model_state, "short_name")
10.0

Methods

value_from(model_state, name)

Retrieves the value of a node or variable that is a member of the group from a model state.

Attributes

`name`	The group's name.
`nodes`	A mapping of the nodes in the group with their names as keys.
`nodes_and_vars`	A mapping of all group members with their names as keys.
`vars`	A mapping of the variables in the group with their names as keys.

Group