Fuel System Library - Release Information

Release Notes for Fuel System Library 4.3

Fuel System Library 4.3 is part of Modelon’s 2018.1 release.

New versions of Modelon libraries are sold and distributed directly from Modelon, as well as approved resellers.

New features

  • Improved media model simulation performance by implementing legacy constant flag
  • Included an option to use convective heat transfer for the LumpedPipe, enabled by the useHeatTransfer parameter. The heat transfer coefficient is modelled by the replaceable heatTransfer model, exchangeable with the correlations found in Modelon.ThermoFluid.FlowChannels.HeatTransfer.SinglePhase.
  • The pump model has a new parameter n_parallel to set the number of parallel pumps that the component model will represent. This is an alternative to using separate components for parallel pumps. A new library example was added to demonstrate this new feature: FuelSystem.Pumps.Experiments.ParallelPumps.

Improvements

  • Improved documentation for JetADryAir_redStates_Legacy media model
  • Added an error message to indicate when the initial fuel mass in the ConvectiveComplexTank exceeds the capacity. The message will indicate the instance name of the tank and the maximum fuel mass that can be set for its initialization.
  • Improved documentation in the User's Guide for: Connecting principles, Speed up simulation, and Diagnostics.
  • Components like the valves, pumps and flow resistances that use small dynamic volumes are grouped into group name like "Not recommended" and components like lumpedPipe which usually have a significant volume are grouped into group name like "Not recommended when connected to volume" under the "Volume positioning" tab respectively. Also the default value for the useVol parameters under "Not recommended" and "Not recommended when connected to volume" case have been set to false.

Fixed issues

  • The dp_smooth was not properly propagated to frictionB, causing the pressure drops not to be symmetrical in the LumpedPipe between frictionA and frictionB. Now when dp_smooth for the LumpedPipe is changed, it is correctly propagated to both friction models.
  • The open_start parameter for the CheckValve now correctly initializes the opening as 1.0(open_start=true) or 0.0(open_start=false). Beforehand, the opening always started as 1.0 (open) regardless of the value of open_start.
  • The connector(portA and portA_alt) overlap issue in Pumps.Ejector,Pipes.LumpedPipe,Sources.MassFlowBoundary,Templates.PartialTwoPortFlowmodel,Sources.PressureBoundary has been corrected. The connectors were previously placed on top of each other, this caused confusion when the volumes are enabled at the ports as the switching of ports can't be visualized clearly.
  • The sorting order of the variables in the result browser has been updated with the review variables(i.e summary and port variables) placed at the top position for ease of review.

Library structure changes

New classes

  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.NonEvaporating.JetADryAir_redStates_Legacy
  • FuelSystem.Pipes.Experiments.LumpedPipeHeatTransfer
  • FuelSystem.Pumps.Experiments.ParallelPumps

Renamed classes

  • FuelSystem.Examples -> FuelSystem.Experiments
  • FuelSystem.Examples.DrainTanks -> FuelSystem.Experiments.DrainTanks
  • FuelSystem.Examples.FillTanks -> FuelSystem.Experiments.FillTanks
  • FuelSystem.Examples.SpinningTank -> FuelSystem.Volumes.Experiments.SpinningTank
  • FuelSystem.Examples.SpinningTankWithPipes -> FuelSystem.Experiments.SpinningTankWithPipes
  • FuelSystem.Examples.SpinningComplexTankWithPipes -> FuelSystem.Experiments.SpinningComplexTankWithPipes
  • FuelSystem.Examples.SpinningComplexTankWithPipesSTL -> FuelSystem.Experiments.SpinningComplexTankWithPipesSTL
  • FuelSystem.Examples.TankAndPump -> FuelSystem.Experiments.TankAndPump
  • FuelSystem.Examples.PoppetValve -> FuelSystem.Valves.Experiments.PoppetValve
  • FuelSystem.Examples.SystemTransition -> FuelSystem.Experiments.SystemTransition
  • FuelSystem.Examples.FlowResistances -> FuelSystem.FlowResistances.Experiments.FlowResistances
  • FuelSystem.Examples.ControlValveCompressible -> FuelSystem.Valves.Experiments.ControlValveCompressible
  • FuelSystem.Examples.FuelTankInerting -> FuelSystem.Experiments.FuelTankInerting
  • FuelSystem.Examples.Evaporation -> FuelSystem.Experiments.Evaporation
  • FuelSystem.Examples.RockingTankHeatTransfer -> FuelSystem.Volumes.Experiments.RockingTankHeatTransfer.SimpleTank
  • FuelSystem.Examples.RockingTankHeatTransferComplexTank -> FuelSystem.Volumes.Experiments.RockingTankHeatTransfer.ComplexTank
  • FuelSystem.Examples.RockingTankHeatTransferComplexTankSTL -> FuelSystem.Volumes.Experiments.RockingTankHeatTransfer.ComplexTankSTL
  • FuelSystem.Examples.RockingTankHeatTransferComplexTankSTL2 -> FuelSystem.Volumes.Experiments.RockingTankHeatTransfer.ComplexTankSTL2
  • FuelSystem.Examples.Solubility -> FuelSystem.Experiments.Solubility

Conversion of user libraries

Automatic conversion of user libraries from version 4.2.2 is supported using the included conversion script "convert_4.2.2_to_4.3.mos" located under FuelSystem 4.3\Resources\Scripts.

Requirements

Fuel System Library is based on Modelon Base Library 3.1 and Modelica Standard Library 3.2.2. 

Release Notes for Fuel System Library 4.2.2

New versions of Modelon libraries are sold and distributed directly from Modelon, as well as approved resellers. 

New features

  • Implemented a new advanced option for smoothing enthalpy and/or medium composition between control volumes across zero flow. The feature can be enabled with the parameters useSmoothEnthalpy and useSmoothComposition found in the system_AFS block as well as in each components with a dynamic volume.

Improvements

  • Performance improvement for lumped pipe instances that use wall friction only (no lumped losses). The simulation can be twice as fast if all lumped pipes in a model use wall friction only.
  • Performance improvement for lumped pipe and static pipe that uses lumped losses through modifications to SimplePipeResistance models. The simulations can be upto twice as fast in models involving these resistances.

Fixed issues

  • Modelica-based geometry kernels now support physical heat transfer computations.
  • Corrected sign error in acceleration vector of external code geometry kernel.
  • Physical heat transfer models now contain an option to use a beta parameter instead of a beta value computed by the thermodynamic property models. This is set by default. It is useful for non-evaporating media that use an exaggerated beta value in the thermodynamic property models for real-time capability. Due to the exaggerated beta value for real time capability the tank temperature may not drop below 20 degC when using the beta value computed by the thermodynamic property models.

Requirements

  • Fuel System Library 4.2.2 is based on Modelon Base Library 3.0 and Modelica Standard Library 3.2.2. 

Release Notes for Fuel System Library 4.2

Fuel System Library 4.2 is part of Modelon’s 2017.2 release.  

New versions of Modelon libraries are sold and distributed directly from Modelon, as well as approved resellers.

New features

  • Implemented free convection heat transfer correlation based on Nusselt number for the complex tank model
  • Implemented 3D visualization for pipes, boundary conditions, valves, simple tank and pumps

Improvements

  • Added compressibility to non-evaporating and evaporating fuels. Package constant ‘legacyConstants’ when set true, will implement legacy density code for JetA_RT, otherwise it will use a mixture of the CRC data for temperature dependence and the legacy code for pressure dependence. Evaporating fuels will use the same pressure dependence as the non-evaporating fuels.

Fixed issues

  • Fixed initialization of volumes for ‘liquidAtStart’. Reverted to old implementation that uses a lower limit for the gas fraction.

Renamed classes

  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.NonEvaporatingLiquidGasMixtures -> FuelSystem.FluidProperties.Predefined.LiquidGasMixture.NonEvaporating
  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.EvaporatingLiquidGasMixtures.EvaporatingJetADryAir -> FuelSystem.FluidProperties.Predefined.LiquidGasMixture.Evaporating.JetADryAir  
  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.EvaporatingLiquidGasMixtures.EvaporatingJP4DryAir -> FuelSystem.FluidProperties.Predefined.LiquidGasMixture.Evaporating.JP4DryAir 
  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.EvaporatingLiquidGasMixtures.EvaporatingJP5DryAir -> FuelSystem.FluidProperties.Predefined.LiquidGasMixture.Evaporating.JP5DryAir 
  • FuelSystem.FluidProperties.Predefined.LiquidGasMixture.EvaporatingLiquidGasMixtures.EvaporatingJP8DryAir ->  FuelSystem.FluidProperties.Predefined.LiquidGasMixture.Evaporating.JP8DryAir
  • FuelSystem.FluidProperties.Templates.LiquidGasMixture.NonEvaporatingLiquidGasMixtures -> FuelSystem.FluidProperties.Templates.LiquidGasMixture.NonEvaporating
  • FuelSystem.FluidProperties.Templates.LiquidGasMixture.EvaporatingLiquidGasMixtures.PartialCondensingLiquidGasMixtures -> FuelSystem.FluidProperties.Templates.LiquidGasMixture.Evaporating.PartialCondensing  
  • FuelSystem.FluidProperties.Interfaces.LiquidGasMixture.NonEvaporatingLiquidGasMixtures -> FuelSystem.FluidProperties.Interfaces.LiquidGasMixture.NonEvaporating
  • FuelSystem.FluidProperties.Interfaces.LiquidGasMixture.EvaporatingLiquidGasMixtures -> FuelSystem.FluidProperties.Interfaces.LiquidGasMixture.Evaporating
  • FuelSystem.FluidProperties.EquationsOfState.Interfaces.LiquidGasMixture.EvaporatingLiquidGasMixture -> FuelSystem.FluidProperties.EquationsOfState.Interfaces.LiquidGasMixture.Evaporating

Conversion of user libraries

  • Automatic conversion from previous versions is not supported.

Requirements

  • Fuel System Library is based on Modelon Base Library 3.0 and Modelica Standard Library 3.2.2.