Hydro Power Library - Release Information

Version 2.6 contains the changes described below.

New features

  • New pump model and a pump storage example

Improvements

  • Improved input and output connector position of governor, generator, grid and turbine, This makes it easier and more clear how to connect components.
  • Improved graphical apperance of example models with visualization of summary variables

Fixed issues

  • Corrected display temperature unit of Visualizers.DisplayVis_Q_T_pin_pout
  • Corrected summary reference p_in, Q_in and T_in in PipeValve.
  • All inputs in HydroPower.HydroSystems.HydroComponents.Containers.LongPipeSegment has now a dialog annotation so they appear in the parameter dialog under group "Inputs".
  • The start value of the output of HydroPower.ControllersAndSensors.Internal.RampsAndFilters.rampF is explicit set to 0.

Library structure changes

Obsolete classes
  • MechanicalSystems.MechanicalComponents.Turbines.KaplanLeakage
  • MechanicalSystems.MechanicalComponents.Turbines.KaplanPowerEff
  • MechanicalSystems.MechanicalComponents.Turbines.KaplanTurbine

Conversion of user libraries

Automatic conversion of user libraries from version 2.5 is supported using the included conversion script ConvertHydroPower_2.5_to_HydroPower_2.6.mos located under HydroPower/Resources/Scripts

Requirements

This version is based on Modelon Base Library 2.4 and Modelica Standard Library 3.2.2.  

It has been tested with:

  • Dymola 2017
  • Dymola 2016 FD01

Version 2.5 contains the changes described below.

This release has been focused on improving the documentation and there has been a major revision of the model documentation. Old obsolete models has also been removed from the library.

Improvements

  • Improved model documentation
  • Removal of obsolete models
  • Updated icons

Library structure changes

Fixes issues

  • Corrected calculation of velocity in HydroPower.HydroSystems.HydroComponents.Valves.Internal.Valve01 by replacing KvIn with a new time constant parameter. This correction may change the result of a simulation.
  • Corrected propagation of parameter firstSeed in HydroPower.Basic.MathBlocks.RNG.NormalIntegerRNG
  • Corrected propagation of parameter startTime in HydroPower.Basic.MathBlocks.RNG.NormalRNG


Obsolete classes

  • HydroPower.Basic.Interfaces.connectIO
  • HydroPower.Basic.Interfaces.FlowPortOpenIn
  • HydroPower.Basic.Interfaces.FlowPortOpenOut
  • HydroPower.Basic.PropertyCalculation -> HydroPower.Basic.Deprecated.PropertyCalculation
  • HydroPower.Basic.UtilityFunctions.andV
  • HydroPower.Basic.UtilityFunctions.atanFunc
  • HydroPower.Basic.UtilityFunctions.booleanVector
  • HydroPower.Basic.UtilityFunctions.corrClc
  • HydroPower.Basic.UtilityFunctions.expFunc
  • HydroPower.Basic.UtilityFunctions.getOutVector
  • HydroPower.Basic.UtilityFunctions.HPcalculations.CMoutH0
  • HydroPower.Basic.UtilityFunctions.HPcalculations.effTurb
  • HydroPower.Basic.UtilityFunctions.HPcalculations.p0Matrix
  • HydroPower.Basic.UtilityFunctions.HPcalculations.pTLiquid
  • HydroPower.Basic.UtilityFunctions.HPcalculations.TaTw
  • HydroPower.Basic.UtilityFunctions.Jcalc
  • HydroPower.Basic.UtilityFunctions.Ktotal
  • HydroPower.Basic.UtilityFunctions.revV
  • HydroPower.Basic.UtilityFunctions.setInVector1
  • HydroPower.Basic.UtilityFunctions.sumPoly
  • HydroPower.Basic.UtilityFunctions.VectorClc
  • HydroPower.Basic.UtilityFunctions.VectorProduct
  • HydroPower.Basic.UtilityFunctions.VectorShift
  • HydroPower.ControllersAndSensors.Internal.PIDdiscrete
  • HydroPower.ControllersAndSensors.Internal.TurbineGovernorAnalog

Conversion of user libraries

Automatic conversion of user libraries from version 2.4 is supported using the included conversion script ConvertHydroPower_2.4_2_to_HydroPower_2.5.mos located under HydroPower/Resources/Scripts.

Requirements

This version is based on Modelon Base Library 2.3 and Modelica Standard Library 3.2.1.  

It has been tested with:

  • Dymola 2016 FD01
  • Dymola 2016
  • Improvements

    • Improved model documentation
    • Improved table directory compliance with Modelica

    Conversion of user libraries

    No conversion from Hydro power 2.4 is needed.

     

     

     

     

2014-04-30

Available for: Dymola 2015

Dependencies: Modelica Standard Library Version: 3.2.1 and Modelon Base Library 2.0

Conversion script from previous version HPL 2.3 provided.

Improvements:

  • New surge tank model with support for more complex tank geometries. A surge tank with a chamber can now be modelled.
  • Faster simulations. The simulation time for the plant examples has been reduced with approximately 50%, due to a more efficient media implementation.

Release notes of HydroPower library version 2.4.1. The previous version was HydroPower library 2.4.

This release has been focused on improving the Modelica compliance and removal of tool dependent implementations.

Improvements

  • Modelica compliance modifications of base models. All models will now pass Dymolas 2015 FD01 Modelica Pedantic check.
  • Removal of Dymola specific table based functions. They have been replaced by table models in MSL. Note that there might be a difference in the interpolation between the different implementations.

Bug fixes

  • Corrected steady-state initialization of temperatures in HydroPower.HydroSystems.HydroComponents.Containers.ClosedVolume

Library structure changes

  • Obsolete models
    • HydroPower.Basic.MathBlocks.HPcombiTable1Ds, replaced by Modelica.Blocks.Tables.CombiTable1Ds
    • HydroPower.Basic.MathBlocks.HPcombiTable2D, replaced by Modelica.Blocks.Tables.CombiTable2D
    • HydroPower.HydroSystems.HydroComponents.Containers.Internal.TransportDelay, replaced by Modelon.ThermoFluid.FlowChannels.TransportDelay
  • Components rename
    • HydroPower.Visualizers.DynamicDiagram → HydroPower.Basic.Deprecated.DynamicDiagram 

Conversion of user libraries

Automatic conversion of user libraries from version 2.4 is supported using the included conversion script ConvertHydroPower_2.4_to_HydroPower_2.4.1.mos located under HydroPower/Resources/Scripts.

Library dependencies

Hydro Power Library 2.4.1 is based on Modelon Base Library 2.1 and Modelica Standard Library 3.2.1.

It has been tested on:

  • Dymola 2015 FD01
  • Dymola 2015

Release notes of HydroPower library version 2.4. The previous version was HydroPower library 2.3.

This release contains two major improvements. A new surge tank model with support for more complex geometries and a reduction of simulation speed of approximatley 50% due to a more efficient media implementation.

Summary of changes:

  • Major improvements:
    • New new surge tank model, SurgeTankWithChamber, with support for more complex geometries.
    • Faster simulations. Simulation time for plant examples has been reduced with approximatley 50%. This is due to a more efficient media implementation.
  • Minor improvements:
    • classDirectory replaced by new standard variant from MSL 3.2.1 (Modelica.Utilities.Files.loadResource)
    • HydroPower.MechanicalSystems.BasicTurbine: Default value of QTableName changed from TabQ to Qtab to match provided mat-file.
    • HydroPower.MechanicalSystems.BasicKaplanTurbine: Default value of QTableName changed from TabQ to Qtab to match provided mat-file.
  • Model name changes:
    • HydroPower.Basic.Records.SummaryRecords.VavleSummary → HydroPower.Basic.Records.SummaryRecords.ValveSummary, 

Conversion from HydroPower 2.3

Models that are using HydroPower 2.3 will automatically be converted to HydroPower 2.4 (Dymola will automatically run conversion script ConvertHydroPower_2.3_to_HydroPower_2.4.mos located under HydroPower/Resources/Scripts when the models are loaded into Dymola)

Release notes of HydroPower library version 2.3. The previous version was HydroPower library 2.2.

This release contains several major improvements. HydroPower is now compatible with the Modelon.Thermofluid library and uses a media structure based on the Modelon.Media. HydroPower library has therefore now a dependency to the Modelon library.

Summary of changes:

Connectors have been changed to be compatible with Modelon.ThermoFluid.

The Media has been changed slightly and is now based on Modelon.Media instead of Modelica.Media.

Improved names of connector components and better icons to make the connection principles more clearly.

  • Model name changes:
    • HydroPower.Basic.Interfaces.FlowA → HydroPower.Basic.Interfaces.VolumePort, 
    • HydroPower.Basic.Interfaces.FlowB → HydroPower.Basic.Interfaces.FlowPort, 
    • HydroPower.Basic.Interfaces.FlowOpenA → HydroPower.Basic.Interfaces.VolumePortOpen, 
    • HydroPower.Basic.Interfaces.FlowOpenB → HydroPower.Basic.Interfaces.FlowPortOpen, 
    • HydroPower.Basic.Icons → Modelon.Icons, 
    • HydroPower.Basic.UtilityFunctions.HPcalculations.SmoothExp → Modelon.Math.Smoothing.smoothExp, 
    • HydroPower.Basic.UtilityFunctions.HPcalculations.SmoothExp_der → Modelon.Math.Smoothing.smoothExp_der, 

Conversion from HydroPower 2.2

Models that are using HydroPower 2.2 will automatically be converted to HydroPower 2.3 (Dymola will automatically run conversion script ConvertHydroPower_2.2_to_HydroPower_2.3.mos located under HydroPower/Resources/Scripts when the models are loaded into Dymola)

Release notes of HydroPower library version 2.2. The previous version was HydroPower library 2.1.

This release contains several major improvements. The largest change is the introduction of the system component System_HPL. A system component is needed now in each model to provide system-wide settings, such as modeling assumptions and default values. The system settings are propagated to the fluid models using the inner/outer mechanism. Model assumptions such as using constant temperature or steady-state initialization can now be turned on/off globally instead of having to modify all components locally.

There has also been a major speedup due to a more efficient friction implementation. Example HydroPower.Examples.PlantConnectAndDisconnectToGrid simulate now in 4 seconds, it took 6 seconds before.

Other improvements concerns mainly user friendliness with improved documentation, new icon visualization, more descriptive model names, new visualizer objects etc.

Summary of changes:

  • New system component System_HPL (all models need to include a system component)
  • Improved default steady-state initialization, default value of Q_start changed to a slightly positive value
  • More efficient friction model implementation, which will result in simulation speedup. HydroPower.HydroSystems.HydroComponents.ConnectingModules.FrictionModels.DetailedFrictionModel replaces now PipeFrictionClc and PipeFrictionInit.
  • Default temperature start and boundary parameter values set to 10 degC
  • Fully specified mass flow initialization of HydroPower.HydroSystems.HydroComponents.ConnectingModules.MassFlow and changed parameters m_dot0 to Q_start, and L_par to L (This will not be backward compatible due to L_par was a vector).
  • New display visualizer HydroPower.Visualizers.DisplayVis_Q_T_pin_pout that uses connector instead of manual variable reference to retrieve values to display.y. Model FourValueDisplay and FourValueLegend have been moved to HydroPower.Basic.Deprecated.
  • Introduction of elevation visualization in the icon layer in several components, e.g. pipe models. The visualization can be switched off by modifying parameter showDataInIcon to false.
  • Improved component documentation.
  • Model name changes:
    • HydroPower.HydroSystems.Penstock → HydroPower.HydroSystems.Pipe, 
    • HydroPower.HydroSystems.PenstockValve → HydroPower.HydroSystems.PipeValve
    • HydroPower.HydroSystems.PenstockTLM → HydroPower.HydroSystems.PipeTLM
    • HydroPower.Examples.PenstockValveClosing → HydroPower.Examples.WaterHammer
    • HydroPower.Examples.ReservoirPenstockSurgetank → HydroPower.Examples.SurgeTankOscillation
  • Removal of obsolete models:
    • HydroPower.Basic.Interfaces.getProperty
    • HydroPower.Basic.Interfaces.FlowPortOut
    • HydroPower.Basic.Interfaces.inFlowOpen
    • HydroPower.Basic.Interfaces.inMedia
    • HydroPower.Basic.Interfaces.inMediaOpen
    • HydroPower.Basic.Interfaces.MediaPort
    • HydroPower.Basic.Interfaces.outFlow
    • HydroPower.Basic.Interfaces.outFlowOpen
    • HydroPower.Basic.Interfaces.outMedia
    • HydroPower.Basic.Interfaces.outMediaOpen
    • HydroPower.Basic.PropertyCalculation.GenerateWaterProperties
    • HydroPower.Basic.PropertyCalculation.WaterPropertiesOld
    • HydroPower.Basic.MathBlocks.Constant replaced with Modelica.Blocks.Sources.Constant
    • HydroPower.Basic.MathBlocks.Step replaced with Modelica.Blocks.Sources.Step
    • HydroPower.Basic.MathBlocks.AbsNoEvent replaced with Modelica.Blocks.Math.Abs
  • Bug fixes:
    • BooleanPulse in model HydroPower.ElectricalSystems.ElectricalComponents.MCB has been replaced with a Boolean table. The previous implementation could result in unintentional opening and closing of the breaking after long simulations ~10000s.
  • Minor changes:
    • Better names for pipe components used in examples (penstock replaced with headrace etc.)
    • Changed parameter dialogs Options to Assumptions in several components.

Conversion from HydroPower 2.1

Models that are using HydroPower 2.1 will automatically be converted to HydroPower 2.2 (Dymola will automatically run conversion script ConvertHydroPower_2.1_to_HydroPower_2.2.mos located under HydroPower/Resources/Scripts when the models are loaded into Dymola)

Release notes of the HydroPower library version 2.1. This library was previously named HydroPlant. The last release of HydroPower was version 2.0.4.

Introduction

Hydro Power Library (HPL) is an tool for commissioning, testing of new control strategies and development and verification of new hydro power plant designs. It offers an environment for testing new control strategies and tuning plant controllers for optimal performance. It can also be used for analysis of extreme working conditions of the plant, such as load rejection.

HPL can be used to assist in a number of engineering tasks concerning hydro power plant design and analysis including waterway dynamics, multiple turbines connected to a common penstock.

Planning of commissioning tests and procedures can be set-up, thereby reducing the risk of unexpected events and minimizing costly tests done on the actual plant.

Changes after HydroPlant 2.0.4

  • Rename of HydroPlant library to HydroPower library
  • Improved user friendliness:
    • Improved information class documentation
    • Rename of example models to more descriptive names
    • New graphical package layout
    • New parameter dialog images to Surgetank and Reservoir
    • Propagation of constant temperature option up to top-level in hydro components
    • Changed default value of parameter enableRamp to false in model HydroPower.ControllersAndSensors.TurbineGovernorAnalog
  • Removal of obsolete models:
    • HydroPlant.HydroSystems.HydroComponents.ConnectingModules.ReaTurbineFlow
    • HydroPlant.MechanicalSystems.KaplanT
    • HydroPlant.MechanicalSystems.MechanicalComponents.Turbines.KaplanTurbine1
  • Bug fixes:
    • Corrected torque calculation in HydroPower.MechanicalSystems.MechanicalComponents.Turbines.HPturbine
    • Propagated down Qlossfactor in model HydroPower.HydroSystems.Penstock to component tubeSeg

Conversion from HydroPlant

Models that have been using HydroPlant library can be converted to HydroPower library by running conversion script ConvertHydroPlant_2.0.4_to_HydroPower_2.1.mos located under Resources\Scripts folder and then loading your models into Dymola.

The conversion script is compatible with HydroPlant 2.0.4. If an older version of HydroPlant has been used some manual conversion might needs to be done.