Class LNGAgeingResult

java.lang.Object
neqsim.process.equipment.lng.LNGAgeingResult
All Implemented Interfaces:
Serializable
public class LNGAgeingResult extends Object implements Serializable
Snapshot of LNG ageing KPIs at a single time step.

Captures all quality metrics, thermodynamic state, and operational parameters for the LNG cargo at one point in time. A list of these snapshots forms the complete ageing trajectory.

Quality metrics tracked:

  • Wobbe Index (WI) — combustion interchangeability, MJ/Sm3
  • Gross Calorific Value (GCV) — energy content, MJ/Sm3 and MJ/kg
  • Methane Number (MN) — knock resistance for gas engines
  • Density — LNG liquid density per ISO 6578, kg/m3
  • Boil-off rate — daily mass loss percentage
Version:
1.0
Author:
NeqSim
See Also:

  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      Serialization version UID.
      See Also:

    • timeHours

      private double timeHours
      Time elapsed since start of scenario (hours).

    • temperature

      private double temperature
      LNG bulk temperature (K).

    • pressure

      private double pressure
      Tank pressure (bara).

    • liquidVolume

      private double liquidVolume
      LNG liquid volume remaining (m3).

    • liquidMass

      private double liquidMass
      LNG liquid mass remaining (kg).

    • liquidMoles

      private double liquidMoles
      Moles of LNG remaining (mol).

    • density

      private double density
      LNG liquid density per ISO 6578 (kg/m3).

    • wobbeIndex

      private double wobbeIndex
      Wobbe Index of the boil-off gas (MJ/Sm3).

    • gcvVolumetric

      private double gcvVolumetric
      Gross Calorific Value — volumetric (MJ/Sm3).

    • gcvMass

      private double gcvMass
      Gross Calorific Value — mass basis (MJ/kg).

    • methaneNumber

      private double methaneNumber
      Methane Number of the BOG.

    • boilOffRatePctPerDay

      private double boilOffRatePctPerDay
      Boil-off rate (%/day of LNG mass).

    • bogMassFlowRate

      private double bogMassFlowRate
      BOG mass flow rate (kg/hr).

    • heatIngressKW

      private double heatIngressKW
      Heat ingress into the tank (kW).

    • liquidComposition

      private Map<String,Double> liquidComposition
      Liquid composition — mole fractions keyed by component name.

    • vaporComposition

      private Map<String,Double> vaporComposition
      Vapor composition — mole fractions keyed by component name.

    • numberOfLayers

      private int numberOfLayers
      Number of liquid layers (1 = well-mixed, >1 = stratified).

    • maxLayerDensityDifference

      private double maxLayerDensityDifference
      Maximum density difference between layers (kg/m3). Zero if single layer.

    • rolloverRisk

      private boolean rolloverRisk
      Rollover risk flag.

    • ambientTemperature

      private double ambientTemperature
      Ambient temperature at this time step (K).

    • operationalMode

      private String operationalMode
      Operational mode description (e.g., "LOADED_VOYAGE", "UNLOADING").

  • Constructor Details

    • LNGAgeingResult

      public LNGAgeingResult()
      Default constructor.

    • LNGAgeingResult

      public LNGAgeingResult(double timeHours)
      Constructor with time stamp.
      Parameters:
      timeHours - time elapsed since start (hours)

  • Method Details

    • getTimeHours

      public double getTimeHours()
      Get the elapsed time.
      Returns:
      time since scenario start (hours)

    • setTimeHours

      public void setTimeHours(double timeHours)
      Set the elapsed time.
      Parameters:
      timeHours - time since scenario start (hours)

    • getTemperature

      public double getTemperature()
      Get the LNG bulk temperature.
      Returns:
      temperature (K)

    • setTemperature

      public void setTemperature(double temperature)
      Set the LNG bulk temperature.
      Parameters:
      temperature - temperature (K)

    • getPressure

      public double getPressure()
      Get the tank pressure.
      Returns:
      pressure (bara)

    • setPressure

      public void setPressure(double pressure)
      Set the tank pressure.
      Parameters:
      pressure - pressure (bara)

    • getLiquidVolume

      public double getLiquidVolume()
      Get the LNG liquid volume.
      Returns:
      liquid volume (m3)

    • setLiquidVolume

      public void setLiquidVolume(double liquidVolume)
      Set the LNG liquid volume.
      Parameters:
      liquidVolume - liquid volume (m3)

    • getLiquidMass

      public double getLiquidMass()
      Get the LNG liquid mass.
      Returns:
      mass (kg)

    • setLiquidMass

      public void setLiquidMass(double liquidMass)
      Set the LNG liquid mass.
      Parameters:
      liquidMass - mass (kg)

    • getLiquidMoles

      public double getLiquidMoles()
      Get the moles of LNG remaining.
      Returns:
      moles (mol)

    • setLiquidMoles

      public void setLiquidMoles(double liquidMoles)
      Set the moles of LNG remaining.
      Parameters:
      liquidMoles - moles (mol)

    • getDensity

      public double getDensity()
      Get the LNG density.
      Returns:
      density (kg/m3)

    • setDensity

      public void setDensity(double density)
      Set the LNG density.
      Parameters:
      density - density (kg/m3)

    • getWobbeIndex

      public double getWobbeIndex()
      Get the Wobbe Index of the boil-off gas.
      Returns:
      WI (MJ/Sm3)

    • setWobbeIndex

      public void setWobbeIndex(double wobbeIndex)
      Set the Wobbe Index.
      Parameters:
      wobbeIndex - WI (MJ/Sm3)

    • getGcvVolumetric

      public double getGcvVolumetric()
      Get the gross calorific value (volumetric basis).
      Returns:
      GCV (MJ/Sm3)

    • setGcvVolumetric

      public void setGcvVolumetric(double gcvVolumetric)
      Set the gross calorific value (volumetric).
      Parameters:
      gcvVolumetric - GCV (MJ/Sm3)

    • getGcvMass

      public double getGcvMass()
      Get the gross calorific value (mass basis).
      Returns:
      GCV (MJ/kg)

    • setGcvMass

      public void setGcvMass(double gcvMass)
      Set the gross calorific value (mass basis).
      Parameters:
      gcvMass - GCV (MJ/kg)

    • getMethaneNumber

      public double getMethaneNumber()
      Get the methane number.
      Returns:
      methane number (dimensionless)

    • setMethaneNumber

      public void setMethaneNumber(double methaneNumber)
      Set the methane number.
      Parameters:
      methaneNumber - methane number (dimensionless)

    • getBoilOffRatePctPerDay

      public double getBoilOffRatePctPerDay()
      Get the boil-off rate.
      Returns:
      boil-off rate (%/day)

    • setBoilOffRatePctPerDay

      public void setBoilOffRatePctPerDay(double boilOffRatePctPerDay)
      Set the boil-off rate.
      Parameters:
      boilOffRatePctPerDay - boil-off rate (%/day)

    • getBogMassFlowRate

      public double getBogMassFlowRate()
      Get the BOG mass flow rate.
      Returns:
      BOG flow rate (kg/hr)

    • setBogMassFlowRate

      public void setBogMassFlowRate(double bogMassFlowRate)
      Set the BOG mass flow rate.
      Parameters:
      bogMassFlowRate - BOG flow rate (kg/hr)

    • getHeatIngressKW

      public double getHeatIngressKW()
      Get the heat ingress.
      Returns:
      heat ingress (kW)

    • setHeatIngressKW

      public void setHeatIngressKW(double heatIngressKW)
      Set the heat ingress.
      Parameters:
      heatIngressKW - heat ingress (kW)

    • getLiquidComposition

      public Map<String,Double> getLiquidComposition()
      Get the liquid composition.
      Returns:
      map of component name to mole fraction

    • setLiquidComposition

      public void setLiquidComposition(Map<String,Double> liquidComposition)
      Set the liquid composition.
      Parameters:
      liquidComposition - map of component name to mole fraction

    • getVaporComposition

      public Map<String,Double> getVaporComposition()
      Get the vapor composition.
      Returns:
      map of component name to mole fraction

    • setVaporComposition

      public void setVaporComposition(Map<String,Double> vaporComposition)
      Set the vapor composition.
      Parameters:
      vaporComposition - map of component name to mole fraction

    • getNumberOfLayers

      public int getNumberOfLayers()
      Get the number of liquid layers.
      Returns:
      number of layers (1 = well-mixed)

    • setNumberOfLayers

      public void setNumberOfLayers(int numberOfLayers)
      Set the number of liquid layers.
      Parameters:
      numberOfLayers - number of layers

    • getMaxLayerDensityDifference

      public double getMaxLayerDensityDifference()
      Get the maximum density difference between layers.
      Returns:
      density difference (kg/m3)

    • setMaxLayerDensityDifference

      public void setMaxLayerDensityDifference(double maxLayerDensityDifference)
      Set the maximum density difference between layers.
      Parameters:
      maxLayerDensityDifference - density difference (kg/m3)

    • isRolloverRisk

      public boolean isRolloverRisk()
      Check if rollover risk is present.
      Returns:
      true if rollover risk detected

    • setRolloverRisk

      public void setRolloverRisk(boolean rolloverRisk)
      Set the rollover risk flag.
      Parameters:
      rolloverRisk - true if rollover risk detected

    • getAmbientTemperature

      public double getAmbientTemperature()
      Get the ambient temperature.
      Returns:
      ambient temperature (K)

    • setAmbientTemperature

      public void setAmbientTemperature(double ambientTemperature)
      Set the ambient temperature.
      Parameters:
      ambientTemperature - ambient temperature (K)

    • getOperationalMode

      public String getOperationalMode()
      Get the operational mode.
      Returns:
      operational mode description

    • setOperationalMode

      public void setOperationalMode(String operationalMode)
      Set the operational mode.
      Parameters:
      operationalMode - operational mode description

    • getTimeDays

      public double getTimeDays()
      Get the elapsed time in days.
      Returns:
      time since start (days)

    • getTemperatureCelsius

      public double getTemperatureCelsius()
      Get the temperature in Celsius.
      Returns:
      temperature (C)

    • toMap

      public Map<String,Object> toMap()
      Convert this result to a map for JSON serialization.
      Returns:
      map of all result fields

    • toSummaryString

      public String toSummaryString()
      Create a summary string for logging.
      Returns:
      formatted summary string

    • toTimeSeries

      public static Map<String,double[]> toTimeSeries(List<LNGAgeingResult> results)
      Utility to collect multiple results into a tabular map.
      Parameters:
      results - list of ageing results over time
      Returns:
      map of arrays keyed by property name for plotting