Class FloorOperation

java.lang.Object

org.kigalisim.lang.operation.FloorOperation

All Implemented Interfaces:

Operation

public class FloorOperation
extends Object
implements Operation

Operation that floors a stream value to a specified minimum and optionally displaces the excess.

This operation calculates a value and floors a specified stream in the engine to that minimum. The excess can optionally be displaced to another stream. It can also optionally be limited to a specific time period using a ParsedDuring object.

Constructor Summary

Constructors

Constructor	Description
FloorOperation(String stream, Operation valueOperation)	Create a new FloorOperation that applies to all years.
FloorOperation(String stream, Operation valueOperation, String displaceTarget)	Create a new FloorOperation that applies to all years with displacement.
FloorOperation(String stream, Operation valueOperation, String displaceTarget, DisplacementType displacementType)	Create a new FloorOperation that applies to all years with displacement and displacement type.
FloorOperation(String stream, Operation valueOperation, String displaceTarget, ParsedDuring during)	Create a new FloorOperation that applies to a specific time period with displacement.
FloorOperation(String stream, Operation valueOperation, String displaceTarget, ParsedDuring during, DisplacementType displacementType)	Create a new FloorOperation that applies to a specific time period with displacement and displacement type.
FloorOperation(String stream, Operation valueOperation, ParsedDuring during)	Create a new FloorOperation that applies to a specific time period.

Method Summary

Modifier and Type	Method	Description
void	execute(PushDownMachine machine)	Execute the calculation and leave the result at the top of the stack.
DisplacementType	getDisplacementType()	Get the displacement type.
OperationStaticSemantics	getStaticSemantics()	Get a record describing this operation's semantics.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation)

Create a new FloorOperation that applies to all years.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation,
 String displaceTarget)

Create a new FloorOperation that applies to all years with displacement.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

displaceTarget - The name of the stream to displace excess to.

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation,
 String displaceTarget,
 DisplacementType displacementType)

Create a new FloorOperation that applies to all years with displacement and displacement type.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

displaceTarget - The name of the stream to displace excess to.

displacementType - The type of displacement to use.

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation,
 ParsedDuring during)

Create a new FloorOperation that applies to a specific time period.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

during - The time period during which this operation applies.

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation,
 String displaceTarget,
 ParsedDuring during)

Create a new FloorOperation that applies to a specific time period with displacement.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

displaceTarget - The name of the stream to displace excess to.

during - The time period during which this operation applies.

FloorOperation

public FloorOperation(String stream,
 Operation valueOperation,
 String displaceTarget,
 ParsedDuring during,
 DisplacementType displacementType)

Create a new FloorOperation that applies to a specific time period with displacement and displacement type.

Parameters:

stream - The name of the stream to floor.

valueOperation - The operation that calculates the minimum value.

displaceTarget - The name of the stream to displace excess to.

during - The time period during which this operation applies.

displacementType - The type of displacement to use.

Method Details

getDisplacementType

public DisplacementType getDisplacementType()

Get the displacement type.

Returns:

The displacement type.

execute

public void execute(PushDownMachine machine)

Execute the calculation and leave the result at the top of the stack.

Specified by:

execute in interface Operation

Parameters:

machine - The machine in which to execute the calculation if needed.

getStaticSemantics

public OperationStaticSemantics getStaticSemantics()

Get a record describing this operation's semantics.

Get a record describing this operation's semantics that are inferrable from its static expression in code. In other words, properties and effects which do not require inspection at time of executing the operation.

Specified by:

getStaticSemantics in interface Operation

Returns:

Inference of common static properties found for this operation.