Skip to content

Commit

Permalink
HTML changes according to last PRs (#75)
Browse files Browse the repository at this point in the history
  • Loading branch information
juleshaas authored Mar 25, 2024
1 parent 057a2b3 commit 5e8977b
Show file tree
Hide file tree
Showing 4 changed files with 32 additions and 30 deletions.
17 changes: 9 additions & 8 deletions grass-gis-addons/m.analyse.trees/v.trees.cd/v.trees.cd.html
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<h2>DESCRIPTION</h2>

<em>v.trees.cd</em> calculates the change between two given treecrown vector
maps (<b>inp_t1</b> and <b>inp_t2</b> for time t1 and t2, respectively).
maps (<b>input</b> and <b>reference</b> for time t1 and t2, respectively).
<p>
It returns three vector maps: <i>&ltbasename&gt_congruent</i> for congruent
trees, <i>&ltbasename&gt_only_&ltinp_t1&gt</i> for gone trees and
<i>&ltbasename&gt_only_&ltinp_t2&gt</i> for new trees,
trees, <i>&ltbasename&gt_only_&ltinput&gt</i> for gone trees and
<i>&ltbasename&gt_only_&ltreference&gt</i> for new trees,
with <i>&ltbasename&gt</i> defined by <b>output</b>.

For the congruent trees the parameter <b>vec_congr_thr</b> can be set,
For the congruent trees the parameter <b>congr_thresh</b> can be set,
defining the threshold of overlap (in percentage) above which trees are
considered to be congruent. Per default it is set to 90%.
<p>
For the two other maps (gone and new trees) two parameters can be set,
to remove small areas: <b>vec_diff_min_size</b> and <b>vec_diff_max_fd</b>.
to remove small areas: <b>diff_min_size</b> and <b>diff_max_fd</b>.
They define the minimum size of identified change areas in sqm (default
0.25 sqm), and the maximum value of fractal dimension of identified change
areas (default 2.5).
Expand All @@ -28,13 +28,13 @@ <h2>EXAMPLE</h2>
<h3>Calculate change detection with tile_size of 500</h3>

<div class="code"><pre>
v.trees.cd inp_t1=treecrowns_2020 inp_t2=treecrowns_2022 output=cd_2020_2022 tile_size=500
v.trees.cd input=treecrowns_2020 reference=treecrowns_2022 output=cd_2020_2022 tile_size=500
</pre></div>

<h3>Calculate change detection with explicit values for filtering congruent and changed maps</h3>

<div class="code"><pre>
v.trees.cd inp_t1=treecrowns_2020 inp_t2=treecrowns_2022 output=cd_2020_2022 vec_congr_thr=80 vec_diff_min_size=1 tile_size=500
v.trees.cd input=treecrowns_2020 reference=treecrowns_2022 output=cd_2020_2022 congr_thresh=80 diff_min_size=1 tile_size=500
</pre></div>

<h2>SEE ALSO</h2>
Expand All @@ -46,4 +46,5 @@ <h2>SEE ALSO</h2>

<h2>AUTHORS</h2>

Julia Haas and Lina Krisztian, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>, Germany
Julia Haas, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>, Germany
Lina Krisztian, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>, Germany
Original file line number Diff line number Diff line change
Expand Up @@ -7,17 +7,17 @@ <h2>DESCRIPTION</h2>
tree height, crown area, crown perimeter, NDVI per single tree, crown volume,
stem position, distance to nearest building and distance to nearest tree.

The module takes as input a raster map of the <b>ndom</b> for computation
The module takes as input a raster map of the <b>ndsm</b> for computation
of the tree height, a raster map of the <b>ndvi</b> for computation of the
NDVI per single tree and a vector map of the <b>buildings</b> for computation
of the distance to the nearest building.
<p>
Optionally, the parameters <b>distance_building</b> and <b>distance_tree</b>
Optionally, the parameters <b>dist_building</b> and <b>dist_tree</b>
can be given, determining the range within neighbouring buildings or trees
are searched for. First the region is set to the tree of interest, then the
region is extended in each direction by <b>distance_building</b> or
<b>distance_tree</b> (given in meters). By default <b>distance_building</b>
is unset, and <b>distance_tree</b> is set to 500 m.
region is extended in each direction by <b>dist_building</b> or
<b>dist_tree</b> (given in meters). By default <b>dist_building</b>
is unset, and <b>dist_tree</b> is set to 500 m.
<p>
The calculation can be done in parallel, with the number of parallel processes
given by <b>nprocs</b>.
Expand All @@ -29,19 +29,19 @@ <h2>EXAMPLES</h2>
<h3>Example 1:</h3>

<div class="code"><pre>
v.trees.param ndom=ndom ndvi=ndvi buildings=hausumringe treecrowns=trees
v.trees.param ndsm=ndsm ndvi=ndvi buildings=hausumringe treecrowns=trees
</pre></div>

<h3>Example 2: run with 5 parallel processes</h3>

<div class="code"><pre>
v.trees.param ndom=ndom ndvi=ndvi buildings=hausumringe treecrowns=trees nprocs=5
v.trees.param ndsm=ndsm ndvi=ndvi buildings=hausumringe treecrowns=trees nprocs=5
</pre></div>

<h3>Example 3: with optional input of <b>distance_tree</b> and <b>distance_building</b></h3>
<h3>Example 3: with optional input of <b>dist_tree</b> and <b>dist_building</b></h3>

<div class="code"><pre>
v.trees.param ndom=ndom ndvi=ndvi buildings=hausumringe treecrowns=trees distance_tree=500 distance_building=500
v.trees.param ndsm=ndsm ndvi=ndvi buildings=hausumringe treecrowns=trees dist_tree=500 dist_building=500
</pre></div>

<h2>SEE ALSO</h2>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ <h3>Classify trees in deciduous and coniferous trees</h3>

<div class="code"><pre>
v.trees.species red_raster=top_red_02 green_raster=top_green_02 \
blue_raster=top_blue_02 nir_raster=top_nir_02 ndvi=top_ndvi_02 \
blue_raster=top_blue_02 nir_raster=top_nir_02 ndvi_raster=top_ndvi_02 \
ndsm=ndsm treecrowns=trees memory=10000
</pre></div>

Expand Down
25 changes: 13 additions & 12 deletions grass-gis-addons/m.import.rvr/m.import.rvr.html
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<h2>DESCRIPTION</h2>

<em>m.import.rvr</em> imports data for the processing of <b>gebaeudedetektion</b>,
<b>dachbegruenung</b> and/or <b>einzelbaumerkennung</b>.
<em>m.import.rvr</em> imports data for the processing of <b>buildings analysis</b>,
<b>green roofs</b> and/or <b>trees analysis</b>.

The module takes as options the paths to the input directories and files.
With the flag <b>-c</b> the module checks only if all required input options
for the selected processing <b>type</b> are set.

The module imports the following data for the different processing <b>type</b>s:
<ul>
<li><b>gebaeudedetektion</b>
<li><b>buildings analysis</b>
<ul>
<li>Flächennutzungskartierung (FNK): imported from given vector file <b>fnk_file</b></li>
<li>Reference buildings: imported from given vector file <b>reference_buildings_file</b> or from openNRW if <b>-b</b> is set</li>
Expand All @@ -20,7 +20,7 @@ <h2>DESCRIPTION</h2>
<li>Normalized Digital Surface Model (nDSM): calculated on the basis of <b>DSM</b> and <b>DTM</b></li>
</ul>
</li>
<li><b>dachbegruenung</b>
<li><b>green roofs</b>
<ul>
<li>Flächennutzungskartierung (FNK): imported from given vector file <b>fnk_file</b></li>
<li>Reference Trees: imported from given vector file <b>tree_file</b></li>
Expand All @@ -32,7 +32,7 @@ <h2>DESCRIPTION</h2>
<li>Normalized Digital Surface Model (nDSM): calculated on the basis of <b>DSM</b> and <b>DTM</b></li>
</ul>
</li>
<li><b>einzelbaumerkennung</b>
<li><b>trees analysis</b>
<ul>
<li>True digital orthophotos (TOP): GTIFF files from given directory <b>top_dir</b> imported and resampled to 0.2 m</li>
<li>Digital surface model (DSM): LAZ files from given directory <b>dsm_dir</b> imported and resampled to 0.2 m</li>
Expand All @@ -59,39 +59,39 @@ <h2>REQUIREMENTS</h2>

<h2>EXAMPLES</h2>

<h3>Import gebaeudedetektion data for Dinslaken 2020</h3>
<h3>Import data for buildings analysis for Dinslaken 2020</h3>

In this example the DTM data will be downloaded from
<a href="https://www.bezreg-koeln.nrw.de/brk_internet/geobasis/">OpenNRW</a>
and also the reference data for buildings will be downloaded from
<a href="https://www.bezreg-koeln.nrw.de/brk_internet/geobasis/">OpenNRW</a>.
<div class="code"><pre>
DATAFOLDER=/mnt/data/Originaldaten_RVR/Dinslaken
m.import.rvr memory=6000 type=gebaeudedetektion \
m.import.rvr memory=6000 type='buildings analysis' \
area=/mnt/data/Dinslaken/fnk_dinslaken/fnk_dinslaken.shp \
fnk_file=/mnt/data/Dinslaken/fnk_dinslaken/fnk_dinslaken.shp \
fnk_column=code_2020 \
dsm_dir=${DATAFOLDER}/2020_Sommer/Punktwolke_2_5D_RGBI \
dop_dir=${DATAFOLDER}/2020_Sommer/DOP -b
</pre></div>

<h3>Import dachbegruenung data for Dinslaken 2020</h3>
<h3>Import data for green roofs detection for Dinslaken 2020</h3>

<div class="code"><pre>
DATAFOLDER=/mnt/data/Originaldaten_RVR/Dinslaken
m.import.rvr memory=6000 type=dachbegruenung -b \
m.import.rvr memory=6000 type='green roofs' -b \
area=/mnt/data/Dinslaken/fnk_dinslaken/fnk_dinslaken.shp \
fnk_file=/mnt/data/Dinslaken/fnk_dinslaken/fnk_dinslaken.shp \
fnk_column=code_2020 \
dsm_dir=${DATAFOLDER}/2020_Sommer/Punktwolke_2_5D_RGBI \
dop_dir=${DATAFOLDER}/2020_Sommer/DOP -b
</pre></div>

<h3>Import einzelbaumerkennung data for Herne 2020</h3>
<h3>Import data for trees analysis for Herne 2020</h3>

<div class="code"><pre>
DATAFOLDER=/mnt/projects/rv_ruhr_baumstandorte/geodata/rvr_data_Herne_2020/
m.import.rvr memory=6000 type=einzelbaumerkennung -b \
m.import.rvr memory=6000 type='trees analysis' -b \
area=${DATAFOLDER}/test_area.gpkg \
reference_buildings_file=${DATAFOLDER}/Shapes/herne_hausumringe_100m_puffer.shp \
top_dir=${DATAFOLDER}/TOP/ \
Expand All @@ -114,4 +114,5 @@ <h2>SEE ALSO</h2>

<h2>AUTHORS</h2>

Anika Weinmann and Momen Mawad, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>
Anika Weinmann, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>
Momen Mawad, <a href="https://www.mundialis.de/">mundialis GmbH &amp; Co. KG</a>

0 comments on commit 5e8977b

Please sign in to comment.