====== Running a graph ======
To run the current graph, select the '//Graph->Run//' menu option, or select the 'run graph' toolbar button shown below:
| {{plugins:calc:zeograph:userguide:window:toolbar:rungraphbtn.png}} ^ The 'run graph' toolbar button. ^
The graph will then run until all the filters have been rendered, or until an error occurs.
===== Filter rendering order =====
When a graph is run, the filters are executed (or //rendered//) in an order that is determined by their connections ([[plugins:calc:zeograph:userguide:filters:connect|see connecting filters]]). Generally speaking, the order runs left to right, where the filters on the left-hand side are inputs, and those on the right are outputs. Consider the example graph below:
| {{:plugins:calc:zeograph:userguide:graphs:examplegraph.png|:plugins:calc:zeograph:userguide:graphs:examplegraph.png}} |
^ An example graph, containing three filters. ^
In this example, the order in which the filters will be rendered is:
- Perlin
- SetRange (after Perlin has run)
- SetProjectMap
To be more precise, a filter will be rendered when:
* It has not already been rendered, and;
* It does not have any input pins, or;
* It does not have any filters connected to its input pins, or;
* The filters connected to the input pins have all been rendered.
This means that the first filters to be rendered will be those with no connections on their input side. The next to be rendered will be those connected immediately downstream from those filters already rendered, and so on.
A filter with no connections will not be rendered.
====== Stopping a running graph ======
To stop the current graph when running, you may do one of the following:
* Press the 'cancel' button in the progress display (if shown), or;
* Select the '//Graph->Stop//' menu option, or;
* Select the 'stop graph' button on the ZeoGraph toolbar, shown below:
| {{plugins:calc:zeograph:userguide:window:toolbar:stopgraphbtn.png}} ^ The 'stop graph' toolbar button. ^