Daemons - Filter
This daemon is used to swap particles from one emitter to another and to separate them. "Filter" requires two emitters: a source emitter and a target. For an easy workflow, it is best to use the "Container" node, because this is nothing but an empty bin which gathers the swapped particles from the source.
Please visit the → “Quick Start Tutorials - Foam with Standard Particle Fluids” to learn how to use this daemon.
Source
Define one or more particle source(s) by choosing an existing emitter from a node browser. Target and source emitters must share the same "Resolution" value. Currently, this field does not accept node names with blanks (e.g. Source Emitter).
Target (True)
This is the emitter where the particles will be moved to when the adjusted “Condition” is true – ideally this would be a → "Container” node with → standard particles. If the field is left blank the filtered particles will be deleted. Target and source emitters must share the same "Resolution" value.
Filter When False
These are your options:
- “Yes” means that, if the condition of the emitter is fulfilled, the particles will be sent to the emitter under “Target Emitter (True)”. If the condition is not fulfilled the particle will be moved to the emitter from “@ Target Emitter (False)”.
- With “No”, particles will only be moved to the emitter from "@ Target Emitter (True)" when the condition is fulfilled.
@ Target (False)
If “Filter When False” is set to “Yes” all particles which do not fulfil the given condition will be sent to this emitter. This field does not necessarily need an entry and can be left blank.
Condition
You can select the desired condition by simply choosing one of the eight predefined options:
- A condition tells RealFlow when a particle has to be transferred.
- Once the condition is fulfilled, the particle will be attached to the target emitter and removed from the source.
- With “In Range” or “Out of Range” the “@ Min Value” and “@ Max Value” fields are unlocked. You can then define a range with a minimum and a maximum value which will be used for this condition.
@ Attribute
When you are shifting particles you also need an attribute to be compared, e.g. “If speed is greater than 2.0 shift the particle from the source to the target emitter”. In this case, “@Attribute” is “Speed”, the “@ Value” parameter is 2.0 and the “Condition” is “greater than”.
@ Value
This is the trigger value for the condition. Please note that this field is inactive with “Condition” set to “In Range”, “Out of Range” and “Expression”.
@ Min Value
With “Condition” set to “In Range” or “Out of Range”, this field becomes unlocked, giving you the possibility to define a range between “@ Min Value” and “@ Max Value”.
@ Max Value
With “Condition” set to “In Range” or “Out of Range”, this field becomes unlocked, giving you the possibility to define a range between “@ Min Value” and “@ Max Value”.
@ Expression
This field becomes active when “Condition” is set to “Expression”. RealFlow constantly checks against the given → expression during a simulation and decides whether the condition is fulfilled or not. There is a long list of keywords that can be used to create a certain condition:
Attribute | Expression keyword |
---|---|
Age |
|
Collision |
|
Density |
|
Force |
|
ID |
|
Mass |
|
Neighbors |
|
Normal |
|
Position |
|
Pressure |
|
Temperature |
|
Texture |
|
Velocity |
|
Viscosity |
|
Vorticity |
|
An example:
Let's assume you want to filter the particles from “Square01” against the particles' velocities:
If a particle' speed is lower than 2.0 the particle should be attached to “Container01”
Source Emitter > Square01
Target Emitter (True) > Container01
Condition > Expression
Under “@ Expression” enter:
particle.speed < 2.0
You can use any other keyword from the table and modify the expression to your needs. It is also possible to combine expressions, e.g.
if particle.age > particle.velocity
Split
When the given condition is fulfilled RealFlow will create additional particles – their number is defined under “@ # child”.
@ # child
Here the number of child particles is specified when a certain condition is fulfilled. You should start with moderate values, because the amount of additional particles can become huge.
Bounded
With this option it is possible to restrict the daemon to a certain volume.
@ Filter inside
With “Yes”, the particles inside the daemon's bounding box will be affected; “No” only filters the particles outside this box.
Override Target (True)
This feature is needed when you work with emitters in cache mode, the "Binary Loader" or the "NBinary Loader". These “emitters” are cleared with each frame and load new particles from already saved BIN files. Using them as source emitters will lead to instabilities, because the particles are not moved, but simply copied. If you also clear the target emitters with each step, you can avoid these problems. Please note that the result with this mode might slightly differ from the original simulation of the source emitter. Here, the target is only overwritten when the given "Condition" is fulfilled.
Override Target (False)
This feature is needed when you work with emitters in cache mode, the "Binary Loader" or the "NBinary Loader". These “emitters” are cleared with each frame and load new particles from already saved BIN files. Using them as source emitters will lead to instabilities, because the particles are not moved, but simply copied. If you also clear the target emitters with each step, you can avoid these problems. Please note that the result with this mode might slightly differ from the original simulation of the source emitter. Here, the target is only overwritten when the given "Condition" is not fulfilled.