pymel.core.animation.evaluationManager — PyMEL 1.0.7 documentation

pymel.core.animation.evaluationManager

evaluationManager(*args, **kwargs)

Handles turning on and off the evaluation manager method of evaluating the DG. Query the ‘mode’ flag to see all available evaluation modes. The special mode ‘off’ disables the evaluation manager.

Flags:

Long Name / Short Name Argument Types Properties
asyncUpdate / asu bool ../../../_images/create.gif ../../../_images/query.gif
 

This option turns on/off the concurrent update of the Viewport 2.0 database and the evaluation in the Evaluation Graph. This can improve performance in those cases when the viewport update takes a long time and is mostly serialized due to the structure of the Evaluation Graph. It may help performance in those specific circumstances though you will have to measure it on a case-by-case basis.

cycleCluster / ccl unicode ../../../_images/create.gif ../../../_images/query.gif
 

Returns a list of nodes that are stored together with the given one in a cycle cluster. The list will be empty when the evaluation mode is not active or the node is not in a cycle.

downstreamFrom / dst unicode ../../../_images/create.gif ../../../_images/query.gif
 

Find the DG nodes that are immediately downstream of the named one in the evaluation graph. Note that the connectivity is via evaluation mode connections, not DG connections. In query mode the graph is walked and any nodes downstream of the named one are returned. The return type is alternating pairs of values that represent the graph level and the node name, e.g. if you walk downstream from A in the graph A -B -C then the return will be the array of strings (0,A,1,B,2,C). Scripts can deconstruct this information into something more visually recognizable. Note that cycles are likely to be present so any such scripts would have to handle them.

enabled / e bool ../../../_images/query.gif
 
Valid in query mode only. Checks to see if the evaluation manager is currently enabled. This is independent of the current mode.
invalidate / inv bool ../../../_images/create.gif ../../../_images/query.gif
 
This option invalidates the graph. Value is used to control auto rebuilding on idle (false) or forced (true). This command should be used as a last resort.
manipulation / man bool ../../../_images/create.gif ../../../_images/query.gif
 
This option is used to activate evaluation manager manipulation support.
mode / m unicode ../../../_images/create.gif ../../../_images/query.gif
 
Changes the current evaluation mode in the evaluation manager. Supported values are off, serial, serialUncachedand parallel.
nodeTypeParallel / ntp bool ../../../_images/create.gif ../../../_images/query.gif
 

This option is used only when the evaluation manager is in parallelmode but can be set at anytime. It activates or deactivates parallel scheduling for the class name argument(s) in the evaluation manager. Legal object values are class type names: e.g. transform, skinCluster, mesh. When queried without specified nodes, it returns the list of nodes with parallel scheduling active.

nodeTypeSerializeGlobally / ntg bool ../../../_images/create.gif ../../../_images/query.gif
 

This option is used only when the evaluation manager is in parallelmode but can be set at anytime. It activates or deactivates global serialization for the class name argument(s) in the evaluation manager that are not parallelized. Legal object values are class type names: e.g. transform, skinCluster, mesh. When queried without specified nodes, it returns the list of nodes with global serialization active.

nodeTypeUntrusted / ntu bool ../../../_images/create.gif ../../../_images/query.gif
 

This option is used only when the evaluation manager is in parallelmode but can be set at anytime. It activates or deactivates untrusted scheduling for the class name argument(s) in the evaluation manager that are not parallelized. Such scheduling will allow nodes to be evaluated in critical section, separately of any other evaluation. It should be used only as a last resort, since high contention of such evaluation can greatly reduce performance. Legal object values are class type names: e.g. transform, skinCluster, mesh. When queried without specified nodes, it returns the list of nodes with untrusted scheduling option active.

safeMode / sfm bool ../../../_images/create.gif ../../../_images/query.gif
 

This option activates/deactivates parallel evaluation safe mode. When enabled, parallel execution will fall back to serial when evaluation graph is missing dependencies. Detection is happening on scheduling of parallel evaluation, which means potential fallback will happen at the next evaluation. WARNING: This mode should be disabled with extreme caution. It will prevent parallel mode from falling back to serial mode when an invalid evaluation is detected. Sometimes the evaluation will still work correctly in those situations and use of this flag will keep the peak parallel performance running. However since the safe mode is used to catch invalid evaluation disabling it may also cause problems with evaluation, anything from invalid values, missing evaluation, or even crashes.

upstreamFrom / ust unicode ../../../_images/create.gif ../../../_images/query.gif
 

Find the DG nodes that are immediately upstream of the named one in the evaluation graph. Note that the connectivity is via evaluation mode connections, not DG connections. In query mode the graph is walked and any nodes upstream of the named one are returned. The return type is alternating pairs of values that represent the graph level and the node name, e.g. if you walk upstream from C in the graph A -B -C then the return will be the array of strings (0,C,1,B,2,A). Scripts can deconstruct this information into something more visually recognizable. Note that cycles are likely to be present so any such scripts would have to handle them. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.evaluationManager