ifference between revisions of "EMO:Data Storage Directory Structure"

Latest revision as of 14:43, 17 March 2014

EMarketOffer creates two separate directory structures during installation:

Program files
Data files

Program Files

During the installation process you can choose where EMarketOffer places its program files (default C:\Program Files\Energy Link\EMO). This folder contains the EMarketOffer executable and the dlls (dynamic link libraries) required by the program. On 64 bit Windows systems the default directory is "Program Files (x86)".

Warning! You should not attempt to modify or move the location of any of these files after installation - doing so will cause the program to malfunction.

Data Files

During installation EMarketOffer creates a data directory structure containing these folders:

Connection
Forecast
Inputs
Licence
Maps
Positions
Reports
Results
Settings

You can select the location for the data folders during the installation process. For performance reasons it is recommended that the data folder be located on the same computer as the EMarketOffer executable.

The Connection Folder

The information required to connect EMarketOffer to external databases is stored here.

File	Purpose	Comment
<Configuration_Name>.xml Where <Configuration_Name> is the name of a previously created Database Connectivity Configuration.	Stores database connectivity data referred to during program launch	Editing, deleting or moving this file may cause EMarketOffer to malfunction.

The Forecast Folder

This folder stores the definitions of Forecasts and Powerflow Cases (.xml format). The results (outputs) of Forecasts and Powerflows are stored in binary format in the Results folder. Scenarios are stored in the Results folder in their entirety (definition and results in one .scn binary file per Scenario).

Sub-Folder	File	Purpose	Comment
Forecasts	<My_Forecast>.ibn	Contains the output in binary form of the last run of the 'My_Forecast' Forecast Definition	One .ibn file will exist for each currently available Forecast Definition that has been run. NOTE: Deleting a Forecast Definition using the Main Window Data Source Manager will delete the associated .ibn file.
Forecasts	Forecasts.xml	Contains the latest Definitions for all current Forecasts.	In editing or deleting this file you run the risk of losing all current Forecast Definitions and associated results data.
Powerflows	<My_Powerflow>.ibn	Contains the output in binary form of the last run of the 'My_Powerflow' Powerflow Case Definition	One .ibn file will exist for each currently available Powerflow Case Definition that has been run. NOTE: Deleting a Powerflow Case Definition using the Main Window Data Source Manager will delete the associated .ibn file.
Powerflows	Powerflows.xml	Contains the latest Definitions for all current Powerflow Cases.	In editing or deleting this file you run the risk of losing all current Powerflow Case Definitions and associated results data.
Library	<My_Component>.xml	Contains the definition for a saved Powerflow Case or Forecast Component.

The Inputs Folder

The Inputs folder may contain several folders and sub-folders as shown below:

Demand
Grid
- Grid\Ellsoft
- Grid\EM6
  - Grid\EM6\BaseGrid
  - Grid\EM6\Constraints
  - Grid\EM6\Equations
  - Grid\EM6\Reratings
- Grid\EMO
Offers
Reserves

The Grid\EMO and Reserves folders contain the data which is updated on Energy Link's web site each day, and is the grid and reserves data that we continue to support (includes all grid data from 22-Jul-09 and reserves from January 2010). If present, the Grid\Ellsoft and Grid\EM6 folders contain grid data that we no longer support.

Offers

EMarketOffer can load Offers from a database or from file. Offers files in the standard CSV format as provided on http://www.electricityinfo.co.nz can be placed in the Offers folder, which can also be used as a library for user-defined/amended Offers data.

NOTE: This folder is created during installation for convenience; however EMarketOffer can read properly formatted files from any location.

Grid

EMarketOffer uses accurate Transmission System data for analysis of historical periods and as input into Forecast Definitions and Powerflow Cases.

The Input Data section contains details on each file type.

The Licence Folder

Your customised license file is stored in the License folder.

Warning! This file contains important information about your installation. It is encrypted and you should not attempt to edit this file in any way. The program will fail to startup if the licence file is missing or altered.

The Maps Folder

Data required to support the Mapping function is stored here.

Folder	Purpose
NZ	Specifies a collection of maps (typically NZ) and contains the configuration data files (.config) for the full set of maps. Maps from only one collection can be displayed at a time.
Large Maps	Contains low level detail Map graphics in .emf format
Medium Maps	Contains medium level detail Map graphics in .emf format
Small	Contains high level detail Map graphics in .emf format

The Positions Folder

Map position details for Transmission System elements are stored here.

File	Purpose	Comment
NodePositions.csv	Contains Map positions of Market Nodes.	Updated automatically as Nodes are added and re-positioned through the Presentation Interface - should not be edited manually.
SubstationPositions.csv	Contains Map positions of Substations

The Reports Folder

This is the default folder for storing Report Output files, which are typically in .csv format and named according to their data content and date range.

The Results Folder

The Results folder contains the output in binary form of Scenarios (.csn), Forecasts (.ibn) and Powerflows (.ibn).

The Settings Folder

User settings files are stored in here.

File	Purpose
Companies.xml	Contains the latest Company definition details
EmbeddedGens.xml	Contains the latest list of Embedded Generators, e.g. wind farms
ExcludedEquations.xml	Contains the latest list of Equations Constraints to be excluded when loading Transmission System data into a Forecast Definition
InsetState.csv	Contains the position of inset maps when EMO is closed down
Regions.xml	Contains the latest Region set definitions
Reports.xml	Contains information about batch reports
UIState.xml	Contains information about the state of EMO when it is closed down, e.g. Window state, selected view
UserSettings.xml	Contains information about settings such as database connections and user-defined views.
WatchLists.xml	Contains the latest lists of Watched items

Home

@@ Line 20: / Line 20: @@
 *Positions
 *Reports
+*Results
 *Settings
@@ Line 39: / Line 40: @@
 ===The Forecast Folder===
-This folder stores the definitions of Forecasts and Powerflow Cases (.xml format), and the results of '''''Forecasts, Powerflow Cases''''' and '''''Scenarios''''' (binary form).
+This folder stores the definitions of Forecasts and Powerflow Cases (.xml format).  The results (outputs) of Forecasts and Powerflows are stored in binary format in the Results folder.  Scenarios are stored in the Results folder in their entirety (definition and results in one .scn binary file per Scenario).
 {|class="wikitable"
@@ Line 77: / Line 78: @@
 |
 :In editing or deleting this file you run the risk of losing all current Powerflow Case Definitions and associated results data.
-|-
-! Scenarios
-|
-:''<My_Scenario>.scn''
-|
-:Contains the output in binary form of the 'My_Scenario' Scenario
-|
-:One .scn file will exist for each currently available '''''Scenario'''''
 |-
 ! Library
@@ Line 127: / Line 120: @@
 ==The Maps Folder==
 Data required to support the Mapping function is stored here.
-[[File:Maps Folder.PNG|300px|thumb|right|Figure 3 - The Maps Data Directory]]
 {|class="wikitable"
 ! Folder !! Purpose
@@ Line 177: / Line 166: @@
 ==The Reports Folder==
 This is the default folder for storing '''''Report Output''''' files, which are typically in .csv format and named according to their data content and date range.
+==The Results Folder==
+The Results folder contains the output in binary form of Scenarios (.csn), Forecasts (.ibn) and Powerflows (.ibn).
@@ Line 189: / Line 183: @@
 |
 :Contains the latest '''''Company''''' definition details
-|
 |-
 |
 :''EmbeddedGens.xml''
 |
-:Contains the latest list of '''''Embedded Generators, e.g. wind farms'''''
+:Contains the latest list of '''''Embedded Generators''''', e.g. wind farms
 |-
 |
@@ Line 200: / Line 193: @@
 |
 :Contains the latest list of '''''Equations Constraints''''' to be excluded when loading Transmission System data into a '''''Forecast Definition'''''
-|
 |-
 |
-:''InsetPositions.csv''
+:''InsetState.csv''
-|
-:???If this is for inset boxes, should it be in the Positions folder?
 |
+:Contains the position of inset maps when EMO is closed down
 |-
 |
@@ Line 212: / Line 203: @@
 |
 :Contains the latest '''''Region''''' set definitions
-|
 |-
 |
 :''Reports.xml''
 |
-:Contains the latest ???|
+:Contains information about batch reports
-|-
-|
-:''??Views.xml''
-|
-:Is this still used?
-|
 |-
 |
 :''UIState.xml''
 |
-:Contains ???
+:Contains information about the state of EMO when it is closed down, e.g. Window state, selected view
-|
 |-
 |
 :''UserSettings.xml''
 |
-:Contains ???|
+:Contains information about settings such as database connections and user-defined views.
 |-
 |
@@ Line 240: / Line 223: @@
 |
 :Contains the latest '''''lists of Watched items'''''
-|
 |}
 [[Main Page|Home]]