EMK:Water Values - Revision history

WoodsM: /* Water Value Contour Files */

2013-04-02T00:37:45Z

Water Value Contour Files

WoodsM: /* Calculating Water Values */

2013-03-07T23:16:55Z

Calculating Water Values

Sisep at 20:56, 7 February 2013

2013-02-07T20:56:31Z

Sisep: /* Calculating Water Values */

2012-12-04T03:42:22Z

Calculating Water Values

Sisep at 03:16, 29 November 2012

2012-11-29T03:16:52Z

Sisep at 03:16, 29 November 2012

2012-11-29T03:16:32Z

Sisep at 21:02, 25 November 2012

2012-11-25T21:02:25Z

Sisep at 21:01, 25 November 2012

2012-11-25T21:01:57Z

Sisep: /* Editing Water Value Files */

2012-11-21T19:38:49Z

Editing Water Value Files

Sisep: /* Editing Water Value Files */

2012-11-21T19:34:53Z

Editing Water Value Files

@@ Line 9: / Line 9: @@
 ===Water Value Contour Files===
-The Water Value file is named '''<Run Name>_WV.csv''' in the ''WVs'' sub-directory of the ''Data'' directory. When the Water Values are calculated using a Run Definition, the name given is the name of that Run Definition, e.g. if Water Values are provided for a Run Definition named "RunA" then the Water Value file created will be named "RunA_WV.csv".
+The Water Value file is named '''<Run Name>_WVMD.csv''' ('''<Run Name>_WV.csv''' for the older 2D water values) in the ''WVs'' sub-directory of the ''Data'' directory. When the Water Values are calculated using a Run Definition, the name given is the name of that Run Definition, e.g. if Water Values are provided for a Run Definition named "RunA" then the Water Value file created will be named "RunA_WVMD.csv".
-The format of the file is as shown to the right (click to enlarge). All rows of the file are delimited by an equal number of commas so that it can be edited in Excel. The file contains the Water Values for the Hydro Systems and Hydro Stations. Due to lack of space the entire format is not shown here. The rows extend downward so there is a row for the contours for each week 1 through to 53. There is an n x 53 block of entries for the Waikato contours below the Waikato block, then another three n x 53 blocks for Waitaki, Clutha and Manapouri respectively, where n is the number of contours. After the Hydro Systems there are blocks corresponding to any hydro stations (such as: Cobb, Coleridge) in your Connections Resource.
+The format of the file is as shown to the right (click to enlarge). The basic format is the standard comma separated value (csv) format. These files can be edited and viewed in Microsoft Excel, although caution should be taken that the files conform to the expected layout when editing is done.  The file contains the Water Values for the Hydro Systems and Hydro Stations. Due to lack of space the entire format is not shown here.
+There is a single line header containing the date from which the water values are valid (always a monday), the number of weeks of water values in the file and the number of weeks for which these values are considered valid. The data for weeks beyond the valid weeks is not used by EMarket in runs and is mainly for verification purposes.
-The Water Value contour prices and names in the first and second rows apply to the contours for all four Hydro Systems and Hydro Stations, if any. Note that Water Values must increase in price from left to right across each row.
+The file header is followed by a section for each hydro system.  Each of these sections is laid out as follows:
-Maximum storage figures and contour values are in GWh.
+The section has a header with the name of the system, it's nominal maximum storage in GWh, and a multiplier that is normally one but is greater than one for tributary systems.  This multiplier is used to convert the stored energy available to the system to the amount of energy this storage can provide to the market as a whole.
 ===Calculating Water Values===

@@ Line 25: / Line 25: @@
 Alternatively, Water Values can also be automatically calculated at run time. This can be done by setting ''Auto Calc Water Values'' field to 'True' in the '''Water Values Options''' Box in the '''''Run Window.'''''
 The results of a Water Value calculation can be viewed graphically by double-clicking the ''Water Value Profile'' field in the '''Water Values Options Box''' in the '''''Run Window.''''' The '''''Water Values Profile Window''''' will be displayed showing individual Water Value contours.  A Water Value contour relates storage levels to a particular Thermal Generator's Offer Price, and is used to determine which Offers Hydro Generators will make.
-The left area of the window shows a plot of the Water Value contours in the current Water Value profile. The box to the right of the window shows the value of each Water Value contour and allows you to see which Offer Band of a thermal Generator is setting the value on any given contour. Click on the name tabs at the top of the window to show the contours for a different Hydro System or station.
+The left area of the window shows a plot of the Water Value contours in the current Water Value profile. The box to the right of the window shows the value of each Water Value contour. The contours shown in this box can be clicked on to select them, this will highlight the selected contour in the graph.  Click on the name tabs at the top of the window to show the contours for a different Hydro System or station.
 The title of this form is Water Value Profile - <Water Value profile name>. Often the Run Definition name and the Water Value profile name will be the same.

@@ Line 6: / Line 6: @@
 EMarket has a facility for auto-calculating Water Values. If you have changed settings within a particular Run Definition you will need to use the '''Calculate Water Values Now''' Button on the '''''Run Resource Window''''' if you require fresh Water Values; alternatively you need to set the ''Auto Calc Water Values'' field to True.
-More information on Water Values and how they are calculated can be found in: [[EMK:Water Values Bulletins | The Water Values Technical Bulletin]]
+More information on Water Values and how they are calculated can be found in: '''''[[EMK:Water Values Bulletins | The Water Values Technical Bulletin]]'''''
 ===Water Value Contour Files===

@@ Line 20: / Line 20: @@
 Water Values are calculated on the basis of an entire Run Definition and are dependent on nearly all of the parameters defined for a Run. A Run Definition must have a Water Value file associated with it.
-To see which file is being used in the Run Definition click the '''Hydro Parameters Button''' in the '''''Run Window''''' and look in the ''Water Value Profile'' field.
+To see which file is being used in the Run Definition click the '''Hydro Parameters Button''' in the '''''[[EMK:Run Window | Run Window]]''''' and look in the ''Water Value Profile'' field.
 EMarket can calculate Water Values at any time using a specific Run's resource files.  To do this use the '''Calculate Water Value Now''' button in the '''Water Values Options''' Box in the special parameters area of '''''Run window.'''''

@@ Line 1: / Line 1: @@
 {{#hidens:}}
 [[File:Water value Contour.jpg|250px|thumb|right|Example Water Value Contour File]]
-For detailed explanations of ''EMarket'' Water Values refer to [[EMK:Water Values Bulletins | The Water Values Technical Bulletins]]
+For detailed explanations of ''EMarket'' Water Values refer to '''''[[EMK:Water Values Bulletins | The Water Values Technical Bulletins]]'''''
 EMarket has a facility for auto-calculating Water Values. If you have changed settings within a particular Run Definition you will need to use the '''Calculate Water Values Now''' Button on the '''''Run Resource Window''''' if you require fresh Water Values; alternatively you need to set the ''Auto Calc Water Values'' field to True.

← Older revision		Revision as of 19:38, 21 November 2012
Line 37:		Line 37:

	To avoid confusion, you should now save this file with a different but easily recognisable name. Once you have linked the new Water Value contour file to your Run Definition you can view it directly from the model.		To avoid confusion, you should now save this file with a different but easily recognisable name. Once you have linked the new Water Value contour file to your Run Definition you can view it directly from the model.
		+
		+
		+	[[EMK:EMarket User Manual \| Back to User Manual Main Page]]

← Older revision		Revision as of 19:34, 21 November 2012
Line 31:		Line 31:
	===Editing Water Value Files===		===Editing Water Value Files===
	'''Warning:''' Every time a Run is executed, the Water Values will use values for the generic generators that are named in the Water Value Profile window.		'''Warning:''' Every time a Run is executed, the Water Values will use values for the generic generators that are named in the Water Value Profile window.
		+
		+	At some stage you may want to use Water Value contours containing generic Generator Offer values that do not correlate with the generic Generator Offers in your Run Definition. In this situation it is necessary to give the contour another name. For example, if you want the third contour value to be $20/MWh instead of $30/MWh, you would have to give the contour a name that doesn't correspond to any Generators in your Connections Resource. To do this, open and edit the appropriate Water Value contour file from your data set in Excel.
		+
		+	Change the value of the contour and rename it.
		+
		+	To avoid confusion, you should now save this file with a different but easily recognisable name. Once you have linked the new Water Value contour file to your Run Definition you can view it directly from the model.