[GRASS-SVN] r66491 - grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended
svn_grass at osgeo.org
svn_grass at osgeo.org
Wed Oct 14 05:24:36 PDT 2015
Author: Giulia
Date: 2015-10-14 05:24:36 -0700 (Wed, 14 Oct 2015)
New Revision: 66491
Modified:
grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.html
grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.py
grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_input.png
grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_output_park.png
grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_output_points.png
Log:
r.green: add PNAM example
Modified: grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.html
===================================================================
--- grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.html 2015-10-14 03:38:15 UTC (rev 66490)
+++ grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.html 2015-10-14 12:24:36 UTC (rev 66491)
@@ -1,31 +1,75 @@
<h2>DESCRIPTION</h2>
-<em>r.green.hydro.recommended</em> detects the position of the potential hydropower plants including the legal constrains and the user's recommendations. Deciding the range of plant length, the distance between plants, the legal discharge we can exploit and the areas we want to exclude from the calculation (ex. protected areas and the ones according to user's recommendations), the module returns a vector file with the potential plants.
+<em>r.green.hydro.recommended</em> detects the position of the potential hydropower plants including legal or ecological constrains and the user's recommendations that can limit the technical potential to a more sustainable one. <br>
+Deciding the range of plant length, the distance between plants, the legal discharge we can exploit and the areas we want to exclude from the calculation (ex. protected areas and the ones according to user's recommendations), the module returns two different vector files with recommended available river segments, optimal position of the plants with their powers and their intakes and restitutions. <br>
<h2>NOTES</h2>
-The difference between this module and r.green.hydro.optimal is that here we can consider a legal dicharge and add areas which will be deleted from the considered streams map used to compute the potential plants.<br> <br>
+The difference between this module and r.green.hydro.optimal is that here we can consider a legal discharge and add areas which will be deleted from the considered streams map used to compute the potential plants. <br><br>
-The input files are : <br> <br>
+<h2>Explanation of Parameters</h2>
-<blockquote>- the <b>rivers considered</b> (vector) on which the potential plants wille be computed<br><br>
+<blockquote>-<b> elevation</b>=name [required] <br>
+raster map, to calculate the gross head <br><br>
-- the <b>current discharge</b> (raster) for each point of these rivers. <br>
-In the section Legal discharge, you can take into consideration the <b>Minimal Flow Discharge (MFD)</b>. It is the amount of water which has to remain in the river to preserve the ecosystems. There are three different ways to proceed which depend on the data you have :<br><br>
+-<b> river</b>=name [required] <br>
+vector on which the potential plants will be computed <br><br>
-<blockquote>or the MFD can be considered as a percentage of the natural discharge, which is the discharge of the river without considering the structures exploiting the water. In this case, you have to give in input the percentage you want to consider and the raster map of the natural discharge. The discharge considered in the calculation will be the current discharge minus the MFD thus calculated.<br><br>
+-<b> efficiency</b>=double [required] <br>
+efficiency of the plant <br><br>
-or you already have the raster map with the MFD. In this case, the discharge considered in the calculation will be the current discharge minus the MFD read in your input raster map. The module r.green.hydro.discharge can compute the raster map of the MFD according to the legislation of some regions.<br><br>
+-<b> len_plant</b>=double [required] <br>
+maximum length of the plant <br><br>
-or you already have the raster map with the legal discharge. In this case, you can add this map as current discharge input and not use the parameters MFD and natural discharge.<br><br>
+-<b> len_min</b>=double [required] <br>
+minimum plant length <br><br>
-But for each case the raster map of the current discharge is a required input.</blockquote>
+-<b> distance</b>=double [required] <br>
+minimum distance among the plants <br><br>
-- the <b>areas to exclude</b> (vector). You can exclude some areas adding in input a vector map of them with or without a buffer around them. Only the rivers outside these excluded areas will be considered to compute the potential plants. There's also the possibility to add an input vector map with points of interest. Then, an area corresponding to the fields of vision from these points is computed, the latter correspond to visibility zones. You can choose to exclude these areas or the areas where several visibility zones are superimposed. The number of points for the visibility corresponds to the number of visibility zones which are superimposed. For example, if this number is 3, the areas where two or less visibility zones are superimposed will be excluded.<br><br>
+-<b> output_plant</b>=name [required] <br>
+name of the output vector with the potential segments <br><br>
-- the <b>elevation</b> raster map, to calculate the gross head <br><br>
+-<b> discharge_current</b>=name [required] <br>
+current discharge; raster for each point of these rivers or raster map with the legal discharge <br>
-- the <b>range of plant length, distance between plants, minimum power and efficiency</b> (optional parameters)<br><br></blockquote>
+<blockquote>[required (only if discharge_current=currentdischarge)]<br><br>-<b> mfd</b>=name <br>
+minimum amount of water to remain in the river to preserve the ecosystem <br>
+In this case, the discharge considered in the calculation will be the current discharge minus the MFD read in your input raster map.<br>
+The module r.green.hydro.discharge can compute the raster map of the MFD according to the legislation of some regions.<br><br>
+<u><b>or</b></u><br><br>
+
+-<b> discharge_natural</b>=name <br>
+discharge of the river without considering the structures exploiting the water <br>
+-<b> percentage</b>=double <br>
+percentage used to calculate the MFD as an amount of the natural discharge <br>
+
+</blockquote>
+
+-<b> area</b>=name [optional] <br>
+areas to exclude from the planning of hydropower stations; only the rivers outside these excluded areas will be considered to compute the potential plants<br><br>
+
+-<b> buff</b>=double [optional] <br>
+buffer around the excluded areas <br><br>
+
+-<b> points_view</b>=name [optional] <br>
+input vector map with points of interest <br><br>
+
+-<b> visibility_resolution</b>=float [optional] <br>
+vision from the points of interest <br>
+An area corresponding to the fields of vision from the points of interest is computed, the latter correspond to visibility zones. <br>
+You can choose to exclude these areas or the areas where several visibility zones are superimposed. <br><br>
+
+-<b> n_points</b>=integer [optional] <br>
+number of points for the visibility corresponding to the number of visibility zones which are superimposed <br>
+For example, if this number is 3, the areas where two or less visibility zones are superimposed will be excluded. <br><br>
+
+-<b> output_vis</b>=name [optional] <br>
+name of the output vector with the viewed areas <br><br>
+
+-<b> p_min</b>=double [optional] <br>
+minimum mean power of the plant <br><br></blockquote>
+
The power is defined as :<br>
<center>P=η * ρ * g * Q * Δh</center>
@@ -38,20 +82,69 @@
The module maximizes the power over a given range by a brute-force search in order to examine all possible arrangements of Q and Δh. Thus, the potential segments can be shorter than the maximum length plant chosen because it depends on the maximization of the product Q * Δh. For each potential segment, the potential power is given in kW in attribute.<br><br>
-<h2>EXAMPLE</h2>
-This example is based on the case-study of Mis valley in Belluno province, Veneto, Italy.<br><br>
+<h2>EXAMPLES</h2>
+<b>EXAMPLE 1</b><br><br>
+
+This example is based on the case-study of the Gesso and Vermenagna valleys located in the Piedmont Region, in South-West Italy, close to the Italian and French border.<br><br>
+
+In the map below you can see the file availablestreams of the considered streams. The river segments already exploited by an existing plant do not appear in the file.<br>
+
+This example is based on the case-study of Gesso and Vermenagna valleys in the Natural Park of the Maritime Alps, Piedmont, Italy.<br><br>
+
+<center><br>
+<img src="r_green_hydro_recommended_input_PNAM.png" alt="input"><br>
+input vector map availablestreams
+</center><br><br>
+
+First of all reset the region settings with g.region making them match the map elevation.<br>
+<br>
+
+To create the map of this example, you can type in the following code in the command console or if you prefer you can only type in the main function names like r.green.hydro.recommended, d.vect or v.buffer in the console and specify the other parameters of the code like elevation or efficiency by using the graphical user interface.<br>
+<div class="code"><pre>
+r.green.hydro.recommended \
+ elevation=elevation \
+ river=availablestreams \
+ efficiency=0.9 \
+ len_plant=200 \
+ len_min=10 \
+ distance=100 \
+ output_plant=output_plant \
+ discharge_current=currentdischarge \
+ mfd=mvf \
+ area=nationalparks \
+ buff=100 \
+ p_min=20
+
+d.vect map=output_plant color=blue
+
+v.buffer input=nationalparks output=buff_park distance=100
+
+d.vect map=buff_park7 color=0:128:0 fill_color=144:238:144 width=1
+</pre></div><br>
+
+As you can see in the output map below, this code calculates the energy potential for a range of plant length from 10 to 200 m and a distance between the plants of 100 m. The areas with the national park and a buffer of 100 m around it are excluded. The discharge considered here is the current discharge of rivers reduced by 30% of the Minimum Flow Discharge.<br><br>
+
+<center>
+<img src="r_green_hydro_recommended_output_PNAM3.png" alt="output park"><br><br>
+output vector map : superimposition of the potential segments vector file (potentialplants, in blue) and the excluded national park (in green) and the buffer (in dark green)
+</center><br><br>
+
+<b><br>EXAMPLE 2</b><br><br>
+
+The second example is based on the case-study of Mis valley in Belluno province, Veneto, Italy.<br><br>
+
Here is the vector file availablestreams of the considered streams. The river segments already exploited by an existing plant do not appear in the file.<br>
In superimposition, there are the vector map (in grey) of the national park we want to exclude and the points of interest (in green) used to create the visibility zones. These points were placed according to experts' recommendations during a focus group made in Veneto region.
<center>
<img src="r_green_hydro_recommended_input.png" alt="input"><br>
-Input vector map availablestreams with the national park and points of interest
+input vector map availablestreams with the national park and points of interest
</center><br><br>
Points of interest are placed in the park so two different cases are presented here :<br>
-1) The national park and a buffer of 200 m around it are excluded.<br>
-2) The visibility zones from points of interest is excluded.<br><br>
+1) The national park and a buffer of 200 m around it are excluded<br>
+2) The visibility zones from points of interest is excluded<br><br>
<blockquote>1) In the first case, the code used is :<br>
<div class="code"><pre>
@@ -67,11 +160,8 @@
distance=150 \
area=nationalparks \
buff=200 \
- output_plant=potentialplants \
- output_point=potentialpoints
+ output_plant=potentialplants
-d.vect map=potentialpoints color=red
-
d.vect map=potentialplants color=blue
v.buffer input=nationalparks output=buff_park distance=200
@@ -83,7 +173,7 @@
<center>
<img src="r_green_hydro_recommended_output_park.png" alt="output park"><br>
-Output vector map : superimposition of the potential segments vector file (potentialplants, in blue), the potential intakes and restitution vector file (potentialpoints, in red), the excluded national park (in grey) and the buffer (in light red)
+output vector map : superimposition of the potential segments vector file (potentialplants, in blue), the excluded national park (in grey) and the buffer (in light red)
</center><br><br>
2) In the second case, the code used is :<br>
@@ -100,8 +190,7 @@
points_view=pointsinterest \
n_points=1 \
output_plant=potentialplants \
- output_vis=vis \
- output_point=potentialpoints
+ output_vis=vis
d.vect map= potentialpoints color=red
@@ -116,7 +205,7 @@
<center>
<img src="r_green_hydro_recommended_output_points.png" alt="output points"><br>
-Output vector map : superimposition of the potential segments vector file (potentialplants, in blue), the potential intakes and restitution vector file (potentialpoints, in red), the points of interest (in green) and the visibility zones (in light green)
+output vector map : superimposition of the potential segments vector file (potentialplants, in blue), the points of interest (in green) and the visibility zones (in light green)
</center></blockquote>
<h2>SEE ALSO</h2>
Modified: grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.py
===================================================================
--- grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.py 2015-10-14 03:38:15 UTC (rev 66490)
+++ grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r.green.hydro.recommended.py 2015-10-14 12:24:36 UTC (rev 66491)
@@ -29,7 +29,7 @@
#%end
#%option G_OPT_V_INPUT
#% key: river
-#% label: Name of vector map with interested segments of rivers
+#% label: Name of vector map with interesting segments of rivers
#% description: Vector map with the segments of the river that will be analysed
#% required: yes
#%end
@@ -132,7 +132,7 @@
#%option G_OPT_V_INPUT
#% key: points_view
#% label: Vector points of viewing position to exclude
-#% description: Vector with the point that are used to compute the visibility
+#% description: Vector with the points that are used to compute the visibility
#% required: no
#% guisection: Areas to exclude
#%end
@@ -179,8 +179,9 @@
#%end
#%rules
-#%exclusive: mfd, discharge_natural
-#%requires: discharge_natural, percentage
+#%exclusive: mfd, discharge_natural
+#%exclusive: mfd, percentage
+#%requires: discharge_natural, percentage
#%end
# import system libraries
Modified: grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_input.png
===================================================================
(Binary files differ)
Modified: grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_output_park.png
===================================================================
(Binary files differ)
Modified: grass-addons/grass7/raster/r.green/r.green.hydro/r.green.hydro.recommended/r_green_hydro_recommended_output_points.png
===================================================================
(Binary files differ)
More information about the grass-commit
mailing list