Nodes Properties
Sorry, no results were found.
Getting Started
Learning
Nodes
Nodes Properties
Connections
Custom Variables
Simulations
Collaboration
Unity Plugin (UP) & API
Account & Billing
Pulling & Pushing Resources
success
The Pull or Push action is only available for selected Pools, Gates, and Drains in their Properties panel on the right. This setting determines how resources are moving from one Node to another.
You can choose between pull-any (default), pull-all, push-any, and push-all from the Action drop-down menu.
When a Node fires, it will try to pull Resources through any inputs connected to it. The number of Resources it pulls is determined by the rate and the value of the individual input Resource Connection.
Please take a moment to familiarize yourself with the availability of pull and push for Pools, Gates, and Drains in the graphic below.
success
A Node set to pull mode (pull-all or pull-any) will pull Resources along its input Resource Connections when it fires.
A Node set to pull-any will attempt to pull any available Resource up to the amount specified on the Resource Connection during each step. If less Resources are available it will still pull them.
Available for Pools, Gates, and Drains.
Pull-all nodes only pull when the amount specified on the Resource Connection is available. This is useful when you need a set amount of Resources for a particular action. It ensures that the action will only occur when the necessary Resources are available.
Available for Pools, Gates, and Drains.
info
Pull-all does not affect Sources, as they provide infinite resources.
success
A Node set to push mode (push-all or push-any) will push Resources along its output Resource Connections when it fires.
A node set to push-any will attempt to push any available resource up to the amount specified by the Resource Connection at each step. You can also use that to push resources into a passive drain. A node set to push-any can be distinguished by the p on the bottom right.
Available for Pools only.
info
Passive Pools with only output connections are automatically set to push mode, in which case the p marker is omitted.
Please see the graphic below.
If a Node is trying to pull more Resources than there are at the far end of its inputs, it will handle it in one of two ways:
- By default, a Node pulls as many Resources as it can, up to the flow rates of its inputs. If not enough Resources are available, it still pulls those that are.
- Alternatively, a Node can be set to pull all Resources. In this mode, when not all Resources are available, none are pulled.
A Node set to push-all will only push Resources forward when the amount specified on the Resource Connection is available. This means it will send Resources only when it can supply all of its outputs.
Available for Pools only.
warning
Please be careful when you play around with action modes because two Nodes that move Resources in the same direction will cause double the number of Resources to be transferred.
In the diagram below, using Pools and Resource Connections, we constructed a simple hourglass.
The top Pool (A) is passive and contains 5 Resources, while the bottom Pool (B) is automatic and starts without any Resources. Every Step (in this case 1 second), B will pull one Resource from A, until all Resources have moved from A to B.
Connected reading:
Contents
