Split_Amount : Helper

Split_Amount - superclass: helper super-superclass:node - classID: #(1962490891, 515064320) 

Particle Flow - Quick Navigation

Description:

The Split_Amount test lets you send a specific number of particles to the next event, keeping all remaining particles in the current event. You can split the particle stream by a specific number or percentage, or by every Nth particle. With a specific number of particles, the splitting takes place once per event, but you can animate the percentage and every Nth values to vary the amount of split-off particles over time.

Constructor:

Split_Amount... 

Properties:

<Split_Amount>.Test_Type Integer default: 0 

0: Fraction Of Particles - Split the particle stream on a percentage basis, specified with the Ratio value. With Ratio greater than 0.0, whether a particular particle is split off depends on a randomization factor; change this with the Uniqueness Seed value.

1: Every Nth Particle - Splits off a regular sample of particles.

2: First N Particles - Splits off the number of particles specified as the N value (below), starting with the first particle to enter the event, and retains the rest.

3: Particles After N First - Splits off all particles starting with the first one after N particles, as specified with the N parameter (below). All particles starting with the first to enter the event up to N are retained in the event.

<Split_Amount>.Ratio Float    default: 50.0   --  animatable; percent; Controller Scaling: (1 : 100.0)

Specifies the percentage of particles that will test True. Animatable. Used only when .Test_Type is set to 0 : Fraction Of Particles

<Split_Amount>.Every_Nth Integer default: 3 

Specifies how often to split off a particle. Animatable. Used only when .Test_Type is set to 0 : Every Nth Particle.

<Split_Amount>.First_N Integer default: 100 

Specifies the number of particles to split off, with 2 : First N Particles, or to retain in the event, with 3 : Particles After N First.

<Split_Amount>.Per_Emission_Source Boolean default: false 

When set to true, the software applies the First_N value for the options First N Particles and Particles After N First separately for each emission source. Use this option with multiple Particle Flow sources converging into a single Split Amount test.

<Split_Amount>.Random_Seed Integer 

Specifies the randomization value.

 Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.