Skip to content

ActionNode

dendron.action_node.ActionNode

Bases: TreeNode

An action node encapsulates the notion of a self-contained action or behavior. The bulk of the observable actions of a behavior tree are due to the action nodes.

ActionNodes are one of the two kinds of leaf nodes in a Behavior Tree - the other being the ConditionNode.

Parameters:

Name Type Description Default
name `str`

The given name of this node.

 required
Source code in src/dendron/action_node.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
class ActionNode(TreeNode):
    """
    An action node encapsulates the notion of a self-contained action
    or behavior. The bulk of the observable actions of a behavior tree
    are due to the action nodes.

    `ActionNode`s are one of the two kinds of leaf nodes in a Behavior
    Tree - the other being the `ConditionNode`.

    Args:
        name (`str`):
            The given name of this node.
    """

    def __init__(self, name) -> None:
        super().__init__(name)

    def set_logger(self, new_logger) -> None:
        """
        Set the logger for this node.
        """
        self.logger = new_logger

    def set_log_level(self, new_level) -> None:
        """
        Set the log level for this node.
        """
        self.log_level = new_level

    def node_type(self) -> NodeType:
        """
        Get the type of this node.

        Returns:
            `NodeType`: The type (`ACTION`).
        """
        return NodeType.ACTION

    def get_node_by_name(self, name : str) -> Optional[TreeNode]:
        """
        Search for a node by its name.

        Args:
            name (`str`):
                The name of the node we are looking for.

        Returns:
            `Optional[TreeNode]`: Either a node with the given name,
            or None.
        """
        if self.name == name:
            return self
        else:
            return None

    def pretty_repr(self, depth = 0) -> str:
        """
        Return a string representation of this node at the given depth.

        Args:
            depth (`int`):
                The depth of this node in a surrounding tree.

        Returns:
            `str`: The indented string representation.
        """
        tabs = '\t'*depth
        repr = f"{tabs}Action {self.name}"
        return repr

set_logger(new_logger)

Set the logger for this node.

Source code in src/dendron/action_node.py 
25
26
27
28
29
def set_logger(self, new_logger) -> None:
    """
    Set the logger for this node.
    """
    self.logger = new_logger

set_log_level(new_level)

Set the log level for this node.

Source code in src/dendron/action_node.py 
31
32
33
34
35
def set_log_level(self, new_level) -> None:
    """
    Set the log level for this node.
    """
    self.log_level = new_level

node_type()

Get the type of this node.

Returns:

Type Description
NodeType

NodeType: The type (ACTION).
Source code in src/dendron/action_node.py 
37
38
39
40
41
42
43
44
def node_type(self) -> NodeType:
    """
    Get the type of this node.

    Returns:
        `NodeType`: The type (`ACTION`).
    """
    return NodeType.ACTION

get_node_by_name(name)

Search for a node by its name.

Parameters:

Name Type Description Default
name `str`

The name of the node we are looking for.

 required

Returns:

Type Description
Optional[TreeNode]

Optional[TreeNode]: Either a node with the given name,
Optional[TreeNode]

or None.
Source code in src/dendron/action_node.py 
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
def get_node_by_name(self, name : str) -> Optional[TreeNode]:
    """
    Search for a node by its name.

    Args:
        name (`str`):
            The name of the node we are looking for.

    Returns:
        `Optional[TreeNode]`: Either a node with the given name,
        or None.
    """
    if self.name == name:
        return self
    else:
        return None