Skip to content

← control_flow package

FunctionCall

Call/apply a function with some positional arguments and/or named ("keyword") arguments.

This will invoke a function that is declared elsewhere using the Function node and return the result. The arguments apply in the order in which they are listed in the function's graph [signature] parameter. Besides positional arguments, Call can also bind named placeholders before evaluating the graph. Note though that placeholders that are bound by any lambda in the contained graph cannot be assigned by name, i.e., only free placeholders can be assigned this way. More Info... Version 1.0.0

Ports/Properties

function

Function to call. This can be the name of a function that is declared elsewhere, or it can also be a callable object, for example as returned by the Lambda node. When used in scripts, this can also be any other callable Python object. Lastly, if the as_python option is set, this may also be the name of a Python function or an in-place defined lambda function (see also as_python option).

verbose name
Function
default value
None
port type
Port
value type
object (can be None)

stateful

Persist graph's state across calls. If this is unset, the call behaves like a regular function call such that the graph's state is reset on every call. If set, the call behaves statefully, that is, any stateful nodes in the called graph (e.g., filters) will retain their state across calls. Thus, the call behaves as if the graph was materialized at the call size. Different call sites to the same graph still have independent state (i.e., different calls are different materializations).

verbose name
Stateful
default value
False
port type
BoolPort
value type
bool (can be None)

as_python

If set to unsafe, the funcname will be interpreted as a Python function name or in-place defined lambda expression. In this case, BE SURE to never pass untrusted inputs into the funcname argument.

verbose name
Python Code
default value
no
port type
EnumPort
value type
str (can be None)

needs_deepcopy

If set, the function call will perform a deep copy of all input arguments before passing them to the function. This is useful when the function modifies its input arguments and you want to prevent these modifications from propagating back to the caller.

verbose name
Needs Deepcopy
default value
False
port type
BoolPort
value type
bool (can be None)

pos1

Positional Argument 1.

verbose name
Pos1
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos2

Positional Argument 2.

verbose name
Pos2
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos3

Positional Argument 3.

verbose name
Pos3
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos4

Positional Argument 4.

verbose name
Pos4
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos5

Positional Argument 5.

verbose name
Pos5
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos6

Positional Argument 6.

verbose name
Pos6
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos7

Positional Argument 7.

verbose name
Pos7
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos8

Positional Argument 8.

verbose name
Pos8
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

pos9

Positional Argument 9.

verbose name
Pos9
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

posN

Additional positional arguments.. .

verbose name
Posn
default value
None
port type
DataPort
value type
list (can be None)
data direction
IN

name1

Keyword argument name 1.

verbose name
Name1
default value
port type
StringPort
value type
str (can be None)

val1

Keyword argument value 1.

verbose name
Val1
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name2

Keyword argument name 2.

verbose name
Name2
default value
port type
StringPort
value type
str (can be None)

val2

Keyword argument value 2.

verbose name
Val2
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name3

Keyword argument name 3.

verbose name
Name3
default value
port type
StringPort
value type
str (can be None)

val3

Keyword argument value 3.

verbose name
Val3
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name4

Keyword argument name 4.

verbose name
Name4
default value
port type
StringPort
value type
str (can be None)

val4

Keyword argument value 4.

verbose name
Val4
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name5

Keyword argument name 5.

verbose name
Name5
default value
port type
StringPort
value type
str (can be None)

val5

Keyword argument value 5.

verbose name
Val5
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name6

Keyword argument name 6.

verbose name
Name6
default value
port type
StringPort
value type
str (can be None)

val6

Keyword argument value 6.

verbose name
Val6
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name7

Keyword argument name 7.

verbose name
Name7
default value
port type
StringPort
value type
str (can be None)

val7

Keyword argument value 7.

verbose name
Val7
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name8

Keyword argument name 8.

verbose name
Name8
default value
port type
StringPort
value type
str (can be None)

val8

Keyword argument value 8.

verbose name
Val8
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name9

Keyword argument name 9.

verbose name
Name9
default value
port type
StringPort
value type
str (can be None)

val9

Keyword argument value 9.

verbose name
Val9
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

nameN

Additional keyword argument names.. .

verbose name
Additional Names
default value
None
port type
ListPort
value type
list (can be None)

valN

Additional keyword argument values.. .

verbose name
Valn
default value
None
port type
DataPort
value type
list (can be None)
data direction
IN

argdict

Additional keyword arguments.. .

verbose name
Additional Keyword Arguments
default value
None
port type
DictPort
value type
dict (can be None)

result

Result of function call.

verbose name
Result
default value
None
port type
DataPort
value type
object (can be None)
data direction
OUT

snapshot

Snapshot of function graph after call.

verbose name
Snapshot
default value
None
port type
GraphPort
value type
Graph

pos0

Positional Argument 0 (deprecated).

verbose name
Pos0
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

name0

Keyword argument name 0 (deprecated).

verbose name
Name0
default value
port type
StringPort
value type
str (can be None)

val0

Keyword argument value 0 (deprecated).

verbose name
Val0
default value
None
port type
DataPort
value type
object (can be None)
data direction
IN

funcname

Function to call.

verbose name
Funcname
default value
None
port type
AliasPort
value type
object (can be None)

funchandle

Function to call.

verbose name
Funchandle
default value
None
port type
AliasPort
value type
object (can be None)

set_breakpoint

Set a breakpoint on this node. If this is enabled, your debugger (if one is attached) will trigger a breakpoint.

verbose name
Set Breakpoint (Debug Only)
default value
False
port type
BoolPort
value type
bool (can be None)

metadata

User-definable meta-data associated with the node. Usually reserved for technical purposes.

verbose name
Metadata
default value
{}
port type
DictPort
value type
dict (can be None)