AgentToFluid

Converts agents (discrete items) into the flow.

Serves as an interface block between the Process Modeling Library (or any other library based on it) and the Fluid Library. Each agent is assumed to contain a certain amount of fluid or bulk matter, and upon arrival of an agent, this block starts the outflow. Similar to FluidSource, this block has desired output rate, and the actual rate may be less or equal the desired rate. 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.

AgentToFluid may contain only one agent at a time, and the next agent will not be let in until the fluid of the current agent has completely flown out.

The Fluid Library will try to maximize the outflow of all fluid sources; therefore, the priority of AgentToFluid out flow is set to 1 by default. Sometimes, to resolve flow priority conflicts, you may need to customize the outflow priority by further increasing it.

Optionally, AgentToFluid can generate batches, one batch per agent. The batch type and color can depend on the agent as the agent can be accessed from the Batch dynamic field.

Fluid in agent

Determines the amount of fluid in the current agent that has arrived at this block (in cubic meters). The amount value cannot be less than Utils.TOLERANCE.

Value type: double
Local variable: agent — the current agent

Rate

The maximum (desired) output rate.

Syntax: double rate
Set new value at runtime: set_rate(new value)

Custom priority

If the option is set (the value equals true), the priority of outflow will be defined by the Output flow priority parameter below, otherwise it equals 1. Priority affects the LP solver when it tries to maximize the flow through the system.

Syntax: boolean customPriority
Set new value at runtime: set_customPriority(new value)

Output flow priority

[Visible and applies only if the Custom priority option is set] Custom priority of the outflow of this block in the overall flowchart. Must be a positive integer.

Syntax: int priorityOutCustom
Set new value at runtime: set_priorityOutCustom(new value)

Custom batches

If the option is selected (the value is true), the block will generate custom batches (which may depend on the agent). The batch corresponding to the agent will be defined by the Batch parameter below. Otherwise, the batch will be BatchTypes.DEFAULT_BATCH.

Value type: boolean
Local variable: Agent agent — the current agent

Batch

[Visible and applies only if the Custom batches option is set] Defines the batch to be created for the current agent.

Value type: Object
Local variable: Agent agent — the current agent

Custom batch color

[Visible and applies only if the Custom batch option is set] If set, the batch color is defined by the Batch color parameter below, otherwise the standard color mapping applies.

Syntax: boolean customBatchColor
Set new value at runtime: set_customBatchColor(new valuefalse)

Batch color

[Visible and applies only if the Custom batch color option is set] Defines the color of the current batch, which may depend on the agent and the batch.

Value type: Color
Local variables:
Agent agent — the current agent
Object batch — the current batch

Agent location

Space markup shape (node or path) where the agents are located while being in this block’s internal Queue.

Name: entityLocation

Storage tank

Here you can specify the name of Storage tank space markup shape used to animate AgentToFluid (both in 2D and 3D animation). The storage tank animates the fluid the block currently contains.

Syntax: StorageTank storageTank

Show batches in flowchart

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

Syntax: boolean showBatchesInFlowchart

On enter

Action executed upon arrival of an agent at the block.

Local variable: Agent agent — the agent

On agent done

Action executed upon the total amount of fluid corresponding to the current agent has passed out of the block. The agent will be discarded after that, and the next agent will be allowed to enter.

Local variables:
Agent agent — the agent
double amount — the amount corresponding to the agent

On rate change

Action executed when the flow rate 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 variable: double outrate — the current output rate

Fluid amount

Function	Description
double amount()	Returns the amount currently contained in the block and waiting to flow out. This amount is less than the total amount in the current agent. If the amount is less than Utils.TOLERANCE, this function returns 0.
double amount(AmountUnits units)	Returns the amount of fluid (in given units) currently contained in the block and waiting to flow out. This amount is less than the total amount of fluid in the current agent. If the amount is less than Utils.TOLERANCE, this function returns 0.
double amountPassed()	Returns the total amount passed through the output port of the block since the start of the simulation.
double amountPassed(AmountUnits units)	Returns the total amount of fluid (in given units) passed through the output port of the block since the start of the simulation.

Flow rate

Function	Description
double currentRate()	Returns the current flow rate of the fluid at the block’s output.
double currentRate(FlowRateUnits units)	Returns the current flow rate (in given units) of the fluid at the block’s output.

Agent

Function	Description
Agent agent()	Returns the current agent being "unfilled", or null if there is no agent.
double totalAmountInAgent(AmountUnits units)	Returns the total amount of fluid (in given units) corresponding to the current agent being "unfilled", or 0 if there is no agent in the block.
double totalAmountInAgent()	Returns the total amount of fluid corresponding to the current agent being "unfilled", or 0 if there is no agent in the block.

Resetting statistics

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

in

The input port.

out

The output port.

How can we improve this article?

Send