Houdini 20.5 Nodes APEX nodes

sim::EvaluateAtTime

Returns the geometry from a simulation at a specified time.

On this page
Since 20.0

Performs any necessary simulation timesteps if the engine does not already have cached simulation data for the requested time.

Similar to a DOP network, if the simulation parameters are changed, this marks the simulation as out of date and re-simulates the current frame. Returning to the first simulation frame (a simtime of 0) also causes re-simulation if the parameters were modified.

Inputs

engine: ApexSimEngine

The simulation engine.

simtime: Float

The simulation time at which to evaluate the output geometry. Note that this is not a global time and is relative to the simulation’s start time.

forceresetsim: Bool

If set to True, forces the simulation to be reset. This causes all timesteps from the start time to the simtime to be solved.

autoresimframe: Bool

If set to True, re-simulates the specified simulation frame if it has not been re-simulated since the last parameter change (also clears any subsequent cached frames). This allows you to quickly preview the behavior of a parameter change on earlier frames without resetting the entire simulation, done by simply rewinding to an earlier frame and playing forward. However, for expensive simulations, this additional re-simulation may be undesirable.

If set to False, parameter changes only re-simulate the current frame, so any earlier frames return their original cached results.

parms: Dict

A dictionary containing custom parameters for the engine’s pre-simulation step graph. Changes to this input marks the simulation as out of date.

datapath: String

The name of the geometry subdata to evaluate. This may contain slashes to refer to nested subdata.

Outputs

geo: Geometry

The geometry from the datapath. This is empty if the subdata is not a geometry type.

See also

APEX nodes