Model output

From ILMS-Wiki
(Difference between revisions)
Jump to: navigation, search
(Graphical display)
(Numerical output)
 
(32 intermediate revisions by one user not shown)
Line 7: Line 7:
 
===Graphical display===
 
===Graphical display===
  
The 'TSVisualization' component of the JAMS builder brings graphical display of different output variables when the model is run. As an example, the output of simulated runoff plot is provided below:
+
The model provides the graphical display output for many variables. As an example, the output of simulated runoff plot is provided below:
  
 
*An example of runoff Plot
 
*An example of runoff Plot
[[file:RunoffPlot.png|Four different runoff component]]
+
[[file:RunoffPlot.png|800x800px|Four different runoff component]]
  
The 'TSVisualization' component can be expanded (click + and - sign on the left side to expand and reduce) as shown in Figure below. The existing TS plots will be shown. The new plot can be created by using the existing plot. Drag one of the existing plots (example, Glacier contribution) and hold CTRL key (a + sign will appear) and leave both the keys. The new plot will appear with the new name (Glacier contribution_1). From the right window, the name and the values of the new plot can be changed. Mainly, four things has to be changed for the new plot.
+
The 'TSVisualization' component of the JAMS builder brings graphical display of different output variables. The 'TSVisualization' component can be expanded (click + and - sign on the left side to expand and reduce) as shown in Figure below. The existing TS plots will be shown. The new plot can be created by using the existing plot. Drag one of the existing plots (example, Glacier contribution) and hold CTRL key (a + sign will appear) and leave both the keys. The new plot will appear with the new name (Glacier contribution_1). From the right window, the name and the values of the new plot can be changed. Mainly, four things has to be changed for the new plot.
  
 
1. Change the name of the component. Click the [...] box on the right hand side of the 'Name'. This will bring a new window and you can change the name of the new plot.
 
1. Change the name of the component. Click the [...] box on the right hand side of the 'Name'. This will bring a new window and you can change the name of the new plot.
  
2. Provide new names for the legend used in the plot. Click on the 'titleLeft' row and change the name of the legends under 'Value' window. In case of more than one legend, seperate the name by semicolon.
+
2. Provide new names for the legend used in the plot. Click on the 'titleLeft' row and change the name of the legends under 'Value' window. In case of more than one legend, separate the name by semicolon.
  
 
3. Provide colors to the legends. Click 'colorLeft' row and change the color name under 'Value' window.
 
3. Provide colors to the legends. Click 'colorLeft' row and change the color name under 'Value' window.
Line 22: Line 22:
 
4. Provide value for the legends. When 'valueLeft' row is clicked, the window below is activated. The value can be choosen from Timeloop. Use CTRL key to choose more than one value.
 
4. Provide value for the legends. When 'valueLeft' row is clicked, the window below is activated. The value can be choosen from Timeloop. Use CTRL key to choose more than one value.
  
[[file:TSPlot.png|TSPlot]]
+
[[file:TSPlot.png|800x800px|TSPlot]]
  
 
Alternatively, this information can be changed by editing the model xml file which has been explained below.
 
Alternatively, this information can be changed by editing the model xml file which has been explained below.
Line 28: Line 28:
 
With these lines in xml file as shown in figure below, users can define which output files they wish to see as a plot/graph. In the figure below, four different runoff components is displayed.  
 
With these lines in xml file as shown in figure below, users can define which output files they wish to see as a plot/graph. In the figure below, four different runoff components is displayed.  
  
[[file:Tsplot1.png|tsplot]]
+
[[file:Tsplot1.png|800x800px|tsplot]]
  
After defining the plot, users also need to define a line in a 'Plot & Maps' component of the xml to bring it in the JAMS framework. This has to be done by directly editing the model xml. For example: The lastline is dedicated to display the Runoff component plot.  
+
After defining the plot, users also need to define a line in a 'Plot & Maps' component of the xml to bring it in the JAMS framework. This has to be done by directly editing the model xml. For example: The last line is dedicated to display the Runoff component plot.  
  
[[file:RunoffcomponentPlot.png|xml lines for graph]]
+
[[file:RunoffcomponentPlot.png|1100x1100px|xml lines for graph]]
  
The Runoff component Plot will appear in 'Plots & Maps' group in the JAMS launcher after loading the xml file in JAMS, which users can switch on/off to display as a graph. The spatial distribution of some variables can also be dispaled as a map, for which the different component of 'Maps' (as shown in rectangular red window) has to be activated as shown in Figure below. In this example, the average evapotranspiration of the model run period is activated.
+
The Runoff component Plot will appear in 'Plots & Maps' group in the JAMS launcher after loading the xml file in JAMS, which users can switch on/off to display as a graph. The spatial distribution of some variables can also be displayed as a map, for which the different component of 'Maps' (as shown in rectangular red window) has to be activated as shown in Figure below. In this example, the average evapotranspiration of the model run period is activated.
  
 
[[file:Jamslauncher_map1.png|defining in xml]]
 
[[file:Jamslauncher_map1.png|defining in xml]]
Line 43: Line 43:
 
*Runoff component components
 
*Runoff component components
  
[[file:ComponentPlot.png|Four different runoff component]]
+
[[file:ComponentPlot.png|800x800px|Four different runoff component]]
  
  
Line 49: Line 49:
  
  
[[file:Jamsmap2D.png|Four different runoff component]]
+
[[file:Jamsmap2D.png|700x700px|Four different runoff component]]
  
The values are provided in daily average. Users can zoom in and out the map. Similaly, the values can be downloaded by clicking the save botton (the red box in right hand side). The GIS shape file with HRU ID and values associated with each HRUs are saved.
+
The values are provided in daily average. Users can zoom in and out the map. Similarly, the values can be downloaded by clicking the save button (the red box in right hand side). The GIS shape file with HRU ID and values associated with each HRUs are saved.
  
  
 
To display the spatial distribution of evapotranspiration in 3D map, users have to click the 'Map 3D'.
 
To display the spatial distribution of evapotranspiration in 3D map, users have to click the 'Map 3D'.
  
[[file:Jamsmap3D.png|Four different runoff component]]
+
[[file:Jamsmap3D.png|700x700px|Four different runoff component]]
  
 
===Numerical output===
 
===Numerical output===
  
The model outputs on a daily resolution are provided in the output folder (current-->> Timeloop.dat filename) after each model run. The  variables which need to be produced as output data is deterimed inside the TimeLoop.xml file which is placed outside the current folder.
+
The outputs of different variables produced by the model are provided in the output folder (current-->> Timeloop.dat filename) after each model run. These variables which need to be produced as output data is determined inside the TimeLoop.xml file which is placed outside the current folder. These variables of the timeloop can be changed directly from the JAMS builder before running the model as shown in Figure below. After uploading the model xml file, users need to click on the button 'configure model output' (as shown in red box in the figure). This will bring a new window 'Datastore editor' from where users can include or exclude the output variables.  
  
The TimeLoop.xml has daily output variables as shown in Figure below. If users do not need some variables, they can comment out the particular variables as shown in the case of netRain in the figure.
+
[[file:Jams_timeloop.png|1000x1000px| Timeloop file]]
  
*TimeLoop.xml file
+
The output variables in the timeloop can be viewed instantly after the model run. The following tutorial describes the detailed information about the use and fuctions of JADE component within the JAMS framework. [http://ilms.uni-jena.de/ilmswiki/index.php/Tutorial_Basic_Users#Exercises_for_the_Tutorial_Basic_Users Data analysis using JADE]
[[file:Timeloop.png| Timeloop file]]
+
  
The HRULoop.xml is responsible for producing the daily average values of each variables of interest (as defined inside the xml file) for all HRUs. Users can comment out some variables as shown in the case of wind below.
+
Similarly, the HRULoop.xml is responsible for producing the daily average values of each variables of interest (as defined inside the xml file) for all HRUs. Users can exclude or include the variables as described in previous paragraph for
  
*HRULoop.xml file
+
Please note that the HRULoop produces a file which is large in size (due to the information associated all HRUs at each time step). Therefore, it is advised not to produce HRULoop.dat every time when the model is run. Disabling the HRULoop.xml will not produce HRULoop.dat file.
[[file:HRULoop.png| HRULoop file]]
+
 
+
Please note that the HRULoop produces a file which is large in size (due to the information associated all HRUs at each time step). Therefore, it is advised to not to produce HRULoop.dat everytime when the model is run. By removing the HRULoop.xml file (from output folder) will not produce HRULoop.dat file.
+
  
 
===Efficiency measurement===
 
===Efficiency measurement===
  
The model produces different efficiency results at the end of each model run. The results are published at the bottom of 'ExicutionInfo' of the JAMS launcher. The model is able to break the time period (such as calibration and validation) into different periods as defined by users.
+
The model produces different efficiency results at the end of each model run. The results are published at the bottom of 'ExecutionInfo' of the JAMS launcher. The model is able to break the time period (such as calibration and validation) into different periods as defined by users.
  
[[file:Jams efficiency.png| JAMS efficiency]]
+
[[file:Efficiency2.png|700x700px| JAMS efficiency]]
  
 
The details of the objective functions are provided below:
 
The details of the objective functions are provided below:
  
[[file:Jams efficiency2.png| JAMS efficiency detail]]
+
 
 +
[[file:Jams_efficiency2.png| JAMS efficiency detail]]
  
 
To understand more about the objectives function and their pros and cons in terms of simulating different parts of hydrological dynamics, the article (Krause, 2005) might be helpful:
 
To understand more about the objectives function and their pros and cons in terms of simulating different parts of hydrological dynamics, the article (Krause, 2005) might be helpful:
  
 
Krause, P., Boyle, D.P., Bäse, F., 2005. Comparison of different efficiency criteria for hydrological model assessment. Advances in Geosciences 31, 89–97.
 
Krause, P., Boyle, D.P., Bäse, F., 2005. Comparison of different efficiency criteria for hydrological model assessment. Advances in Geosciences 31, 89–97.

Latest revision as of 09:40, 17 October 2012

The model results and efficiency are provided in three different ways:

  • Graphical display
  • Numerical output
  • Efficiency measurement

Graphical display

The model provides the graphical display output for many variables. As an example, the output of simulated runoff plot is provided below:

  • An example of runoff Plot

Four different runoff component

The 'TSVisualization' component of the JAMS builder brings graphical display of different output variables. The 'TSVisualization' component can be expanded (click + and - sign on the left side to expand and reduce) as shown in Figure below. The existing TS plots will be shown. The new plot can be created by using the existing plot. Drag one of the existing plots (example, Glacier contribution) and hold CTRL key (a + sign will appear) and leave both the keys. The new plot will appear with the new name (Glacier contribution_1). From the right window, the name and the values of the new plot can be changed. Mainly, four things has to be changed for the new plot.

1. Change the name of the component. Click the [...] box on the right hand side of the 'Name'. This will bring a new window and you can change the name of the new plot.

2. Provide new names for the legend used in the plot. Click on the 'titleLeft' row and change the name of the legends under 'Value' window. In case of more than one legend, separate the name by semicolon.

3. Provide colors to the legends. Click 'colorLeft' row and change the color name under 'Value' window.

4. Provide value for the legends. When 'valueLeft' row is clicked, the window below is activated. The value can be choosen from Timeloop. Use CTRL key to choose more than one value.

TSPlot

Alternatively, this information can be changed by editing the model xml file which has been explained below.

With these lines in xml file as shown in figure below, users can define which output files they wish to see as a plot/graph. In the figure below, four different runoff components is displayed.

tsplot

After defining the plot, users also need to define a line in a 'Plot & Maps' component of the xml to bring it in the JAMS framework. This has to be done by directly editing the model xml. For example: The last line is dedicated to display the Runoff component plot.

xml lines for graph

The Runoff component Plot will appear in 'Plots & Maps' group in the JAMS launcher after loading the xml file in JAMS, which users can switch on/off to display as a graph. The spatial distribution of some variables can also be displayed as a map, for which the different component of 'Maps' (as shown in rectangular red window) has to be activated as shown in Figure below. In this example, the average evapotranspiration of the model run period is activated.

defining in xml


After running the model, users can see the plot of different variables as provided below:

  • Runoff component components

Four different runoff component


  • Spatial distribution of evapotranspiration


Four different runoff component

The values are provided in daily average. Users can zoom in and out the map. Similarly, the values can be downloaded by clicking the save button (the red box in right hand side). The GIS shape file with HRU ID and values associated with each HRUs are saved.


To display the spatial distribution of evapotranspiration in 3D map, users have to click the 'Map 3D'.

Four different runoff component

Numerical output

The outputs of different variables produced by the model are provided in the output folder (current-->> Timeloop.dat filename) after each model run. These variables which need to be produced as output data is determined inside the TimeLoop.xml file which is placed outside the current folder. These variables of the timeloop can be changed directly from the JAMS builder before running the model as shown in Figure below. After uploading the model xml file, users need to click on the button 'configure model output' (as shown in red box in the figure). This will bring a new window 'Datastore editor' from where users can include or exclude the output variables.

Timeloop file

The output variables in the timeloop can be viewed instantly after the model run. The following tutorial describes the detailed information about the use and fuctions of JADE component within the JAMS framework. Data analysis using JADE

Similarly, the HRULoop.xml is responsible for producing the daily average values of each variables of interest (as defined inside the xml file) for all HRUs. Users can exclude or include the variables as described in previous paragraph for

Please note that the HRULoop produces a file which is large in size (due to the information associated all HRUs at each time step). Therefore, it is advised not to produce HRULoop.dat every time when the model is run. Disabling the HRULoop.xml will not produce HRULoop.dat file.

Efficiency measurement

The model produces different efficiency results at the end of each model run. The results are published at the bottom of 'ExecutionInfo' of the JAMS launcher. The model is able to break the time period (such as calibration and validation) into different periods as defined by users.

JAMS efficiency

The details of the objective functions are provided below:


JAMS efficiency detail

To understand more about the objectives function and their pros and cons in terms of simulating different parts of hydrological dynamics, the article (Krause, 2005) might be helpful:

Krause, P., Boyle, D.P., Bäse, F., 2005. Comparison of different efficiency criteria for hydrological model assessment. Advances in Geosciences 31, 89–97.

Personal tools