FluidSplit

Splits the input stream into two different streams; the sum of output flow rates equals the input rate.

Can work in three alternative modes:

• Neutral — In Neutral mode neither of the outputs gets priority and no additional constraints apply. If both outputs together can accept more than the input can produce, the flow is distributed between outputs non-deterministically.
• Proportional — In Proportional mode the block applies additional constraint: output 1 rate / Fraction 1 = output 2 rate / Fraction 2, therefore the output rates depend on each other as well as on the input rate.
• Priority — In Priority mode FluidSplit tries to maximize the rate of one of the outputs, and the other output will get what’s left. Sometimes, to avoid flow priority conflicts, you may need to customize the priority values (by assigning integer values) to achieve desired global priorities.

In the priority mode, the dot indicating the priority output becomes orange in case the flow values are not in accordance with the priorities. This may well be a normal situation, but it also may signal that the flows are distributed not in the desired way and that setting custom priorities is required.

The output batch of FluidSplit at both outputs is the same as the input batch. The On new batch action can be used to change the mode and/or priorities depending on the incoming batch.

The input rate is not limited, the output rate can optionally be limited. The specified rate cannot be lower than the value of Utils.RATE_TOLERANCE constant, i.e. 1.0e-9. If rate value falls below this value after recalculation, it will be snapped to 0.

FluidSplit is a zero-capacity block, it does not contain any amount of fluid.

Mode

The mode of split. One of the following:

Neutral — neither of the outputs gets priority
Proportional — output rates must obey the proportion rules
Priority — one of the outputs has priority over another

Get value: mode
Set new value at runtime: set_mode(new value)
Valid values:
FluidSplit.SPLITMERGE_NEUTRAL — Neutral
FluidSplit.SPLITMERGE_PROPORTIONAL — Proportional
FluidSplit.SPLITMERGE_PRIORITY — Priority

Fraction 1

[Visible and applies only if the Mode is Proportional]
In proportion mode, the (relative) fraction of output 1 rate.

Syntax: double fraction1
Set new value at runtime: set_fraction1(new value)

Fraction 2

[Visible and applies only if the Mode is Proportional]
In proportion mode, the (relative) fraction of output 2 rate.

Syntax: double fraction2
Set new value at runtime: set_fraction2(new value)

Custom priorities

[Visible and applies only if the Mode is Priority]
If the option is selected (the value is equal to true), the priorities of outflows will be set to custom values, otherwise — to 0 and 1. Priorities affects the LP solver when it tries to maximize the flow through the system.

Syntax: boolean customPriorities
Change the value at runtime: set_customPriorities(true) or set_customPriorities(false)

Priority of output 1

[Visible and applies only if the Mode is Priority and Custom priorities is selected]
Applies in the priority mode with custom priorities. Defines the priority of the output 1 flow of this block in the overall flowchart. Must be a non-negative integer.

Syntax: int priorityOutput1Custom
Change the value at runtime: set_priorityOutput1Custom(new value)

Priority of output 2

[Visible and applies only if the Mode is Priority and Custom priorities is selected]
Applies in the priority mode with custom priorities. Defines the priority of the output 2 flow of this block in the overall flowchart. Must be a non-negative integer.

Syntax: int priorityOutput2Custom
Change the value at runtime: set_priorityOutput2Custom(new value)

Limited output rate

If the option is selected (the value is equal to true), you are able to specify a custom upper limit of the output rate, per output.

Syntax: boolean limitRateOut
Change the value at runtime: set_limitRateOut(true) or set_limitRateOut(false)

Maximum output rate

[Visible and applies only if the Limited output rate option is set]
Custom upper limit of the output rate, at each output. The default value is 10 cubic meters per second.

Syntax: double maxRateOut
Set new value at runtime: set_maxRateOut(new value)

Show batches in flowchart

If set, the block icon will display the current batch color.

Syntax: boolean showBatchesInFlowchart

On new batch

Action executed when a new batch appears at the block input. It will not necessarily start flowing into the block.

Local variable: Object batch — the batch

On rate change

Action executed when any of the flow rates changes.

Changing something in the action may result in another immediate rate change and immediately following another call of On rate change, so the user can possibly create a livelock.

Local variables:
double inrate — the current input rate
double out1rate — the current output rate at port out1
double out2rate — the current output rate at port out2

Fluid amount

Function	Description
double amountPassed()	Returns the total amount passed through the input port of the block since the start of the simulation.
double amountPassed(AmountUnits units)	Returns the total amount of fluid (in given units), which passed through the input port of the block since the start of the simulation.

Flow rate

Function	Description
double currentRate()	Returns the current flow rate of fluid that goes in.
double currentRate(FlowRateUnits units)	Returns the current flow rate (in given units) of fluid at the block input.

Resetting statistics

Function	Description
void resetStats()	Resets statistics collected for this block, including the statistics collected for its ports.

in

The input port.

out1

The upper output port, out 1.

out2

The lower output port, out 2.

How can we improve this article?

Send