ifference between revisions of "EMK:Functional Architecture"
(13 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
==Functional Components== | ==Functional Components== | ||
− | #Four 'Calculation Engines:' | + | #'''Four 'Calculation Engines:'''' |
##Water Value calculation module | ##Water Value calculation module | ||
##Dispatch module (SPD simulation) | ##Dispatch module (SPD simulation) | ||
##Short term river chain optimisation module | ##Short term river chain optimisation module | ||
##Company optimisation module | ##Company optimisation module | ||
− | #A 'Volatility Engine' which includes: | + | #'''A 'Volatility Engine' which includes:''' |
##A '''''Volatility Matrix''''' (incorporating inflow variability) | ##A '''''Volatility Matrix''''' (incorporating inflow variability) | ||
##A Monte Carlo series Generator | ##A Monte Carlo series Generator | ||
− | #A scripting language which includes: | + | #'''A scripting language which includes:''' |
##A script editor (effectively the EMarket user interface) | ##A script editor (effectively the EMarket user interface) | ||
##A script interpreter (controls the system operation) the scripting language underlies all EMarket operations. It is used to: | ##A script interpreter (controls the system operation) the scripting language underlies all EMarket operations. It is used to: | ||
Line 17: | Line 17: | ||
###Control and coordinate the operation of the calculation and volatility engines | ###Control and coordinate the operation of the calculation and volatility engines | ||
###Control the production and formatting of output data | ###Control the production and formatting of output data | ||
+ | |||
+ | The script for a complete EMarket working environment is contained in the Resources.txt file stored in the Data folder of the associated Working Directory. With a copy of this script it is possible to recreate the same working environment on a different computer running EMarket and produce the same Forecast Results. However to reproduce exactly the same Forecast Data on a different computer with a script, both computers must be running the same version of EMarket and be using the same Demand and Inflow data. Differences in Forecast output may also occur if the associated Run Definition relies on randomly seeded unit outages or data series created by the Monte Carlo Generator. | ||
+ | |||
+ | ==The Run== | ||
+ | A Run is a unique execution of the EMarket model. It produces Forecast distributions of electricity market data from a set of pre-defined modelling assumptions. After production the Forecast data may be used as input into a risk management system for risk assessment or analysed in conjunction with data from other Runs to investigate interesting aspects of the electricity market. The Run uses a Run Definition to identify which input data to use and what form output data is to take. The Run is completely specified by the modelling and data formatting Resources assigned to it in the Run Definition. | ||
+ | |||
+ | A typical EMarket Run has three stages: | ||
+ | #Water Values Calculation | ||
+ | #Dispatch case solution (iterative) | ||
+ | #Run finalisation | ||
+ | |||
+ | '''Calculating Water Values''' | ||
+ | |||
+ | Water Values are used to derive Hydro System Offers at any stage of a Run, based on: | ||
+ | *Reservoir storage levels | ||
+ | *The Offers (marginal costs) of thermal Generators | ||
+ | *The potential reservoir inflows | ||
+ | |||
+ | Typically Water Values are calculated in a single preliminary step at the start of a Run. However, it is possible pre-calculate Water Values as an independent operation, and to instruct EMarket to use these Water Values at run time. | ||
+ | |||
+ | For more information on Water Values see: '''''[[EMK:Water Values | Water Values]]''''' | ||
+ | |||
+ | '''Iterative Dispatch''' | ||
+ | |||
+ | Once equipped with a set of Water Values and a valid Definition the Run progresses to solving a series of dispatch cases. Each case requires a single execution of the dispatch engine (and may include execution of the short term river chain optimisation, volatility and Company optimisation engines). A single case represents a basic unitary time period, called a Tick, which can range in duration from one half hour to one week. In most instances Forecast data produced by the Run will contain one value per [[EMK:Entity.Traits | Entity.Trait]] per Tick. The Tick duration and number of ticks (Forecast duration) for a Forecast are determined in the '''''[[EMK:Run Window | Run Window]].''''' | ||
+ | |||
+ | It is possible to have multiple Tick types in a single Run Definition. Forecast data produced from such a Definition will contain outputs at different levels of granularity (e.g. some half hourly and some four hourly data). However where a Run involves mixed Tick types the output data will be continuous from start to end over the whole Forecast (i.e. no gaps) and also contiguous (i.e. no overlaps). | ||
+ | |||
+ | The typical cycle of events for each Tick iteration is: | ||
+ | #Derive transmission system properties by checking for scheduled changes to: | ||
+ | ##Line limits | ||
+ | ##Equation constraint limits | ||
+ | #Derive Nodal Demand using: | ||
+ | ##A Demand profile from the external Demand file | ||
+ | ##The Region Demand figures entered into the Run Definition | ||
+ | ##Any scheduled changes to Demand | ||
+ | #Derive Offers using: | ||
+ | ##Thermal Offers entered into the Run Definition | ||
+ | ##Hydro Offers derived from Water Values (this will involve running the Short Term River Chain Optimisation engine if this is enabled in the Run Definition) | ||
+ | ##Any scheduled changes to Offers or Generator availability | ||
+ | ##The Company optimisation engine (if enabled in the Run Definition) | ||
+ | ##Any random Generator outages | ||
+ | #Execute the Dispatch Model | ||
+ | #Derive additional output data from dispatch results (e.g. Company Revenue) | ||
+ | #Write dispatch results and additional data to Binary file | ||
+ | |||
+ | Note: Derivation of the dispatch input data listed above may include the use of the volatility engine through the use of formulae in the Run Definition to express data item values. | ||
+ | |||
+ | '''Run Finalisation''' | ||
+ | |||
+ | During Run finalisation EMarket: | ||
+ | #Outputs data in text format | ||
+ | #Enters Run details in the '''''System Log''''' | ||
+ | #Creates the Run Resource text file capturing the entire context of the Run (effectively a script for the Run) to enable future Run recreation and analysis | ||
+ | |||
+ | ==The Run Definition== | ||
+ | The Run Definition Resource determines how EMarket will execute a Run. | ||
+ | |||
+ | More information on how this is created can be found in the '''''[[EMK:Run Window | Run Window]]''''' section. | ||
+ | |||
+ | Multiple Runs can be executed from a single Run Definition over time. However, a Run Definition can also be changed at any time even when Forecast data has already been produced using the Definition. In other words several differing sets of Results data can be made using the same Run Definition. To ensure that Results can always be interpreted against the exact Run Definition Instance used to produce them, each Run completed in EMarket is assigned a unique Batch number. The Batch number is used to name a sub-folder containing the Run Results data together with a copy of the Run Definition Instance used by the Run. This allows the context of a set of Results to be recreated at a future time (conditional upon certain input data such as Demand profiles being subject to appropriate version control and backup). The numbered sub-folder is located in the Results data folder in the current Working Directory, under the name of the relevant Run Definition. | ||
+ | |||
+ | Note: Where a Batch contains more than one Run Definition, each Run will receive the same Batch Number (but the results will be saved under different Run Definition Resource Names in the Results folder. | ||
+ | |||
+ | '''Warning:''' Submitting several identical Run Definitions into the same Batch will cause the results from each Run to over-write each other. | ||
+ | |||
+ | |||
+ | [[EMK:EMarket User Manual | Back to User Manual Main Page]] |
Latest revision as of 09:19, 8 February 2013
This section describes the components which make EMarket work.
Functional Components
- Four 'Calculation Engines:'
- Water Value calculation module
- Dispatch module (SPD simulation)
- Short term river chain optimisation module
- Company optimisation module
- A 'Volatility Engine' which includes:
- A Volatility Matrix (incorporating inflow variability)
- A Monte Carlo series Generator
- A scripting language which includes:
- A script editor (effectively the EMarket user interface)
- A script interpreter (controls the system operation) the scripting language underlies all EMarket operations. It is used to:
- Describe the characteristics of all Resource Instances
- Control and coordinate the operation of the calculation and volatility engines
- Control the production and formatting of output data
The script for a complete EMarket working environment is contained in the Resources.txt file stored in the Data folder of the associated Working Directory. With a copy of this script it is possible to recreate the same working environment on a different computer running EMarket and produce the same Forecast Results. However to reproduce exactly the same Forecast Data on a different computer with a script, both computers must be running the same version of EMarket and be using the same Demand and Inflow data. Differences in Forecast output may also occur if the associated Run Definition relies on randomly seeded unit outages or data series created by the Monte Carlo Generator.
The Run
A Run is a unique execution of the EMarket model. It produces Forecast distributions of electricity market data from a set of pre-defined modelling assumptions. After production the Forecast data may be used as input into a risk management system for risk assessment or analysed in conjunction with data from other Runs to investigate interesting aspects of the electricity market. The Run uses a Run Definition to identify which input data to use and what form output data is to take. The Run is completely specified by the modelling and data formatting Resources assigned to it in the Run Definition.
A typical EMarket Run has three stages:
- Water Values Calculation
- Dispatch case solution (iterative)
- Run finalisation
Calculating Water Values
Water Values are used to derive Hydro System Offers at any stage of a Run, based on:
- Reservoir storage levels
- The Offers (marginal costs) of thermal Generators
- The potential reservoir inflows
Typically Water Values are calculated in a single preliminary step at the start of a Run. However, it is possible pre-calculate Water Values as an independent operation, and to instruct EMarket to use these Water Values at run time.
For more information on Water Values see: Water Values
Iterative Dispatch
Once equipped with a set of Water Values and a valid Definition the Run progresses to solving a series of dispatch cases. Each case requires a single execution of the dispatch engine (and may include execution of the short term river chain optimisation, volatility and Company optimisation engines). A single case represents a basic unitary time period, called a Tick, which can range in duration from one half hour to one week. In most instances Forecast data produced by the Run will contain one value per Entity.Trait per Tick. The Tick duration and number of ticks (Forecast duration) for a Forecast are determined in the Run Window.
It is possible to have multiple Tick types in a single Run Definition. Forecast data produced from such a Definition will contain outputs at different levels of granularity (e.g. some half hourly and some four hourly data). However where a Run involves mixed Tick types the output data will be continuous from start to end over the whole Forecast (i.e. no gaps) and also contiguous (i.e. no overlaps).
The typical cycle of events for each Tick iteration is:
- Derive transmission system properties by checking for scheduled changes to:
- Line limits
- Equation constraint limits
- Derive Nodal Demand using:
- A Demand profile from the external Demand file
- The Region Demand figures entered into the Run Definition
- Any scheduled changes to Demand
- Derive Offers using:
- Thermal Offers entered into the Run Definition
- Hydro Offers derived from Water Values (this will involve running the Short Term River Chain Optimisation engine if this is enabled in the Run Definition)
- Any scheduled changes to Offers or Generator availability
- The Company optimisation engine (if enabled in the Run Definition)
- Any random Generator outages
- Execute the Dispatch Model
- Derive additional output data from dispatch results (e.g. Company Revenue)
- Write dispatch results and additional data to Binary file
Note: Derivation of the dispatch input data listed above may include the use of the volatility engine through the use of formulae in the Run Definition to express data item values.
Run Finalisation
During Run finalisation EMarket:
- Outputs data in text format
- Enters Run details in the System Log
- Creates the Run Resource text file capturing the entire context of the Run (effectively a script for the Run) to enable future Run recreation and analysis
The Run Definition
The Run Definition Resource determines how EMarket will execute a Run.
More information on how this is created can be found in the Run Window section.
Multiple Runs can be executed from a single Run Definition over time. However, a Run Definition can also be changed at any time even when Forecast data has already been produced using the Definition. In other words several differing sets of Results data can be made using the same Run Definition. To ensure that Results can always be interpreted against the exact Run Definition Instance used to produce them, each Run completed in EMarket is assigned a unique Batch number. The Batch number is used to name a sub-folder containing the Run Results data together with a copy of the Run Definition Instance used by the Run. This allows the context of a set of Results to be recreated at a future time (conditional upon certain input data such as Demand profiles being subject to appropriate version control and backup). The numbered sub-folder is located in the Results data folder in the current Working Directory, under the name of the relevant Run Definition.
Note: Where a Batch contains more than one Run Definition, each Run will receive the same Batch Number (but the results will be saved under different Run Definition Resource Names in the Results folder.
Warning: Submitting several identical Run Definitions into the same Batch will cause the results from each Run to over-write each other.