Package org.kigalisim.engine.state

Class StreamParameterization

java.lang.Object
org.kigalisim.engine.state.StreamParameterization
public class StreamParameterization extends Object
Class for managing stream-specific parameters and settings.

Handles configuration of GHG intensity, initial charge, recharge rates, recovery rates, and other stream-specific values.

  • Constructor Details

    • StreamParameterization

      public StreamParameterization()
      Create a new stream parameterization instance.

  • Method Details

    • setGhgIntensity

      public void setGhgIntensity(EngineNumber newValue)
      Set the greenhouse gas intensity.
      Parameters:
      newValue - The new GHG intensity value

    • getGhgIntensity

      public EngineNumber getGhgIntensity()
      Get the greenhouse gas intensity.
      Returns:
      The current GHG intensity value

    • setEnergyIntensity

      public void setEnergyIntensity(EngineNumber newValue)
      Set the energy intensity.
      Parameters:
      newValue - The new energy intensity value

    • getEnergyIntensity

      public EngineNumber getEnergyIntensity()
      Get the energy intensity.
      Returns:
      The current energy intensity value

    • setInitialCharge

      public void setInitialCharge(String stream, EngineNumber newValue)
      Set the initial charge for a stream.
      Parameters:
      stream - The stream identifier ('domestic' or 'import')
      newValue - The new initial charge value

    • getInitialCharge

      public EngineNumber getInitialCharge(String stream)
      Get the initial charge for a stream.
      Parameters:
      stream - The stream identifier ('domestic' or 'import')
      Returns:
      The initial charge value for the stream

    • setRechargePopulation

      public void setRechargePopulation(EngineNumber newValue)
      Set the recharge population percentage.
      Parameters:
      newValue - The new recharge population value

    • getRechargePopulation

      public EngineNumber getRechargePopulation()
      Get the recharge population percentage.
      Returns:
      The current recharge population value

    • setRechargeIntensity

      public void setRechargeIntensity(EngineNumber newValue)
      Set the recharge intensity.
      Parameters:
      newValue - The new recharge intensity value

    • getRechargeIntensity

      public EngineNumber getRechargeIntensity()
      Get the recharge intensity.
      Returns:
      The current recharge intensity value

    • setRecoveryRate

      public void setRecoveryRate(EngineNumber newValue)
      Set the recovery rate percentage.
      Parameters:
      newValue - The new recovery rate value

    • setRecoveryRate

      public void setRecoveryRate(EngineNumber newValue, RecoverOperation.RecoveryStage stage)
      Set the recovery rate percentage for a specific stage.
      Parameters:
      newValue - The new recovery rate value
      stage - The recovery stage (EOL or RECHARGE)

    • getRecoveryRate

      public EngineNumber getRecoveryRate()
      Get the recovery rate percentage.
      Returns:
      The current recovery rate value

    • getRecoveryRate

      public EngineNumber getRecoveryRate(RecoverOperation.RecoveryStage stage)
      Get the recovery rate percentage for a specific stage.
      Parameters:
      stage - The recovery stage (EOL or RECHARGE)
      Returns:
      The current recovery rate value

    • setYieldRate

      public void setYieldRate(EngineNumber newValue)
      Set the yield rate percentage for recycling.
      Parameters:
      newValue - The new yield rate value

    • setYieldRate

      public void setYieldRate(EngineNumber newValue, RecoverOperation.RecoveryStage stage)
      Set the yield rate percentage for recycling for a specific stage.
      Parameters:
      newValue - The new yield rate value
      stage - The recovery stage (EOL or RECHARGE)

    • getYieldRate

      public EngineNumber getYieldRate()
      Get the yield rate percentage for recycling.
      Returns:
      The current yield rate value

    • getYieldRate

      public EngineNumber getYieldRate(RecoverOperation.RecoveryStage stage)
      Get the yield rate percentage for recycling for a specific stage.
      Parameters:
      stage - The recovery stage (EOL or RECHARGE)
      Returns:
      The current yield rate value

    • setInductionRate

      public void setInductionRate(EngineNumber newValue)
      Set the induction rate percentage for recycling.
      Parameters:
      newValue - The new induction rate value

    • setInductionRate

      public void setInductionRate(EngineNumber newValue, RecoverOperation.RecoveryStage stage)
      Set the induction rate percentage for recycling for a specific stage.
      Parameters:
      newValue - The new induction rate value
      stage - The recovery stage (EOL or RECHARGE)

    • getInductionRate

      public EngineNumber getInductionRate()
      Get the induction rate percentage for recycling.
      Returns:
      The current induction rate value

    • getInductionRate

      public EngineNumber getInductionRate(RecoverOperation.RecoveryStage stage)
      Get the induction rate percentage for recycling for a specific stage.
      Parameters:
      stage - The recovery stage (EOL or RECHARGE)
      Returns:
      The current induction rate value

    • setRetirementRate

      public void setRetirementRate(EngineNumber newValue)
      Set the retirement rate percentage.

      This method accumulates retirement rates across multiple retire commands in the same year to support cumulative retirement behavior. If the resulting retirement rate is negative, it is clamped to zero (no retirement).

      Parameters:
      newValue - The new retirement rate value to add

    • getRetirementRate

      public EngineNumber getRetirementRate()
      Get the retirement rate percentage.
      Returns:
      The current retirement rate value

    • getRetirementBasePopulation

      public Optional<EngineNumber> getRetirementBasePopulation()
      Get the retirement base population for cumulative calculations.
      Returns:
      The base population, or empty if not yet captured this step

    • setRetirementBasePopulation

      public void setRetirementBasePopulation(EngineNumber value)
      Set the retirement base population for cumulative calculations.
      Parameters:
      value - The base population value

    • getAppliedRetirementAmount

      public Optional<EngineNumber> getAppliedRetirementAmount()
      Get the applied retirement amount for cumulative calculations.
      Returns:
      The total amount already retired this step

    • setAppliedRetirementAmount

      public void setAppliedRetirementAmount(EngineNumber value)
      Set the applied retirement amount for cumulative calculations.
      Parameters:
      value - The total amount retired this step

    • getHasReplacementThisStep

      public boolean getHasReplacementThisStep()
      Get the replacement mode for this step's retire commands.
      Returns:
      true if with replacement, false if without replacement

    • setHasReplacementThisStep

      public void setHasReplacementThisStep(boolean value)
      Set the replacement mode for this step's retire commands.
      Parameters:
      value - true for with replacement, false for without replacement

    • getRetireCalculatedThisStep

      public boolean getRetireCalculatedThisStep()
      Get whether retire has been calculated this step.
      Returns:
      true if retire was calculated, false otherwise

    • setRetireCalculatedThisStep

      public void setRetireCalculatedThisStep(boolean calculated)
      Set whether retire has been calculated this step.
      Parameters:
      calculated - true if retire was calculated, false otherwise

    • getRechargeBasePopulation

      public Optional<EngineNumber> getRechargeBasePopulation()
      Get the recharge base population for cumulative calculations.
      Returns:
      The base population, or empty if not yet captured this step

    • setRechargeBasePopulation

      public void setRechargeBasePopulation(EngineNumber value)
      Set the recharge base population for cumulative calculations.
      Parameters:
      value - The base population value

    • getAppliedRechargeAmount

      public Optional<EngineNumber> getAppliedRechargeAmount()
      Get the applied recharge amount for cumulative calculations.
      Returns:
      The total amount already recharged this step in kg

    • setAppliedRechargeAmount

      public void setAppliedRechargeAmount(EngineNumber value)
      Set the applied recharge amount for cumulative calculations.
      Parameters:
      value - The total amount recharged this step in kg

    • isRecyclingCalculatedThisStep

      public boolean isRecyclingCalculatedThisStep()
      Get whether recycling has been calculated this step.
      Returns:
      true if recycling was calculated, false otherwise

    • setRecyclingCalculatedThisStep

      public void setRecyclingCalculatedThisStep(boolean calculated)
      Set whether recycling has been calculated this step.
      Parameters:
      calculated - true if recycling was calculated, false otherwise

    • accumulateRecharge

      public void accumulateRecharge(EngineNumber population, EngineNumber intensity)
      Accumulate recharge parameters. Sets when not previously set, accumulates otherwise.

      Multiple calls accumulate rates (addition) and intensities (weighted-average). Population rates are added, intensities are weighted-averaged using absolute values for weights to handle negative adjustments correctly.

      Weighted average formula: (|rate1| × intensity1 + |rate2| × intensity2) / (|rate1| + |rate2|)

      Parameters:
      population - The recharge population rate to add
      intensity - The recharge intensity for this rate

    • setLastSpecifiedValue

      public void setLastSpecifiedValue(String streamName, EngineNumber value)
      Set the last specified value for a stream.

      This tracks the value and units last used when setting streams to preserve user intent across carry-over years.

      Parameters:
      streamName - The name of the stream
      value - The last specified value with units

    • getLastSpecifiedValue

      public EngineNumber getLastSpecifiedValue(String streamName)
      Get the last specified value for a stream.
      Parameters:
      streamName - The name of the stream
      Returns:
      The last specified value with units, or null if not set

    • hasLastSpecifiedValue

      public boolean hasLastSpecifiedValue(String streamName)
      Check if a stream has a last specified value.
      Parameters:
      streamName - The name of the stream
      Returns:
      true if the stream has a last specified value, false otherwise

    • markStreamAsEnabled

      public void markStreamAsEnabled(String streamName)
      Mark a stream as having been enabled (set to non-zero value).
      Parameters:
      streamName - The name of the stream to mark as enabled

    • hasStreamBeenEnabled

      public boolean hasStreamBeenEnabled(String streamName)
      Check if a stream has ever been enabled (set to non-zero value).
      Parameters:
      streamName - The name of the stream to check
      Returns:
      true if the stream has been enabled, false otherwise

    • isSalesIntentFreshlySet

      public boolean isSalesIntentFreshlySet()
      Check if sales intent has been freshly set in the current processing cycle.
      Returns:
      true if sales intent was freshly set, false otherwise

    • setSalesIntentFreshlySet

      public void setSalesIntentFreshlySet(boolean freshlySet)
      Set the flag indicating whether sales intent has been freshly set.
      Parameters:
      freshlySet - true if sales intent was freshly set, false otherwise

    • resetStateAtTimestep

      public void resetStateAtTimestep()
      Reset state at the beginning of a timestep.

      This method resets recovery rate to 0% and induction rate to 100% between steps since recycling programs may cease and should not be expected to continue unchanged, but default induction behavior should return to induced demand (100%).

    • clearLastSpecifiedValue

      public void clearLastSpecifiedValue(String stream)
      Clear the last specified value in this parameterization.

      The last specified value tracks the user specified target for a stream such that commands changing those values respect user directives like maintaining units-based tracking with implicit recharge. This method clears that directive so that, for example, a set command can override a prior given value. This, for example, allows the user to switch from units-based to volume-based tracking.

      This will clear the stream and those dependent upon it. Therefore, clearing sales will also clear substreams domestic and import. Similarly, clearing domestic will clear sales but not import.

      Parameters:
      stream - The name of the stream like "sales" or "import" in which to clear.