Skip to content

Commit

Permalink
deploy: bb25740
Browse files Browse the repository at this point in the history
  • Loading branch information
@JanCaha
JanCaha committed Nov 14, 2024
1 parent cca6f0e commit 9e5a029
Show file tree
Hide file tree
Showing 36 changed files with 735 additions and 208 deletions.
4 changes: 4 additions & 0 deletions 404.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,10 @@
<a href="/qgis_los_tools/tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="/qgis_los_tools/tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="/qgis_los_tools/tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
4 changes: 4 additions & 0 deletions changelog/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
Binary file added images/tool_extract_horizon_lines_by_distances.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
45 changes: 25 additions & 20 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down Expand Up @@ -243,11 +247,11 @@

<li class="nav-item" data-bs-level="1"><a href="#los-tools" class="nav-link">LoS Tools</a>
<ul class="nav flex-column">
<li class="nav-item" data-bs-level="2"><a href="#link-to-qgis-plugin-repository" class="nav-link">Link to QGIS Plugin repository</a>
<li class="nav-item" data-bs-level="2"><a href="#link-to-qgis-plugin-repository" class="nav-link">Link to QGIS Plugin Repository</a>
<ul class="nav flex-column">
</ul>
</li>
<li class="nav-item" data-bs-level="2"><a href="#important-terms" class="nav-link">Important terms</a>
<li class="nav-item" data-bs-level="2"><a href="#important-terms" class="nav-link">Important Terms</a>
<ul class="nav flex-column">
</ul>
</li>
Expand All @@ -263,23 +267,24 @@
<div class="col-md-9" role="main">

<h1 id="los-tools">LoS Tools</h1>
<p>QGIS plugin to create and analyse lines-of-sight. Provides also set of supporting tools. The plugin is focused on point to point visibility, in contrast to classic viewshed analysis which is point to area. Besides that it provides tools for identification of horizon points (on LoS), horizon lines (from a set of LoS) and also additional useful tools related to visibility analysis.</p>
<h2 id="link-to-qgis-plugin-repository">Link to QGIS Plugin repository</h2>
<p>Plugin is available here: <a href="https://plugins.qgis.org/plugins/los_tools/">https://plugins.qgis.org/plugins/los_tools/</a></p>
<h2 id="important-terms">Important terms</h2>
<h3 id="line-of-sight-los">Line-of-sight (LoS)</h3>
<p>Line from a specific observer point (observer) that to or through specific target point. This plugin defines three types of LoS: local, global, without target.</p>
<p>The local and global LoS are used to describe visibility of specific target (i.e. highest point of building, top of the hill etc.) from observing points. Local LoS is strictly between observer and target and does not allow to assess the visibility behind the target. Global LoS is from observer through target but continues behind it as much as underlying elevation raster allows. Global LoS allows assesment of visibility of target with respect to surface located behind it.</p>
<p>LoS without target is a special case of LoS where the target point serves only as descriptor of direction and is not used to evaluate visibility at all. The target points for this can be generated by tools <a href="tools/Points%20Creation/tool_points_around/">Create points around</a> and <a href="tools/Points%20Creation/tool_points_in_direction/">Create points in direction</a>. Sets of LoS generated using these tools can be used to identify horizon lines.</p>
<p>QGIS plugin to create and analyze lines-of-sight. It also provides a set of supporting tools. The plugin focuses on point-to-point visibility, in contrast to classic viewshed analysis, which is point-to-area. Additionally, it provides tools for identifying horizon points (on LoS), horizon lines (from a set of LoS), and other useful tools related to visibility analysis.</p>
<h2 id="link-to-qgis-plugin-repository">Link to QGIS Plugin Repository</h2>
<p>The plugin is available here: <a href="https://plugins.qgis.org/plugins/los_tools/">https://plugins.qgis.org/plugins/los_tools/</a></p>
<h2 id="important-terms">Important Terms</h2>
<h3 id="line-of-sight-los">Line-of-Sight (LoS)</h3>
<p>A line from a specific observer point (observer) to or through a specific target point. This plugin defines three types of LoS: local, global, and without target.</p>
<p>Local and global LoS are used to describe the visibility of a specific target (e.g., the highest point of a building, the top of a hill) from observing points. Local LoS is strictly between the observer and the target and does not allow for the assessment of visibility behind the target. Global LoS extends from the observer through the target and continues behind it as far as the underlying elevation raster allows. Global LoS allows for the assessment of the visibility of the target with respect to the surface located behind it.</p>
<p>LoS without target is a special case of LoS where the target point serves only as a descriptor of direction and is not used to evaluate visibility at all. The target points for this can be generated by the tools <a href="tools/Points%20Creation/tool_points_around/">Create Points Around</a> and <a href="tools/Points%20Creation/tool_points_in_direction/">Create Points in Direction</a>. Sets of LoS generated using these tools can be used to identify horizon lines.</p>
<h3 id="horizons">Horizons</h3>
<p>Generally, horizon is a point on LoS that is visible and is immediately followed by an invisible point. There are several types of horizons mentioned in the plugin's tools. Mainly local and global horizons and horizon lines. </p>
<p>Global horizon is a horizon that is highest on LoS and if the surface raster extent is sufficient it should be the point where LoS meets the sky. LoS have just one global horizon.</p>
<p>Local horizon is any horizon on LoS that is not global. There may be any number of local horizons on LoS. Amogst these local horizons the highest local horizon can be useful for some analyses. The maximal local horizon is the highest horizon that is not global.</p>
<h3 id="dem-use-in-the-plugin">DEM use in the plugin</h3>
<p>Most tools in the plugin allow you to use more than one DEM raster. The rasters are ordered from smallest cell size to the biggest. The cell size of each raster must be unique to form complete ordering of rasters. Elevation is always obtained from raster with smallest cell size that has valid elevation value (no data is not considered as valid value). This allows utilization of DEM with large cells as addition to DEM with smaller cells. For example DEM with cell size 1 meter can be used within city for areas close to observers and SRTM data (30 meter cell size) in areas around the city, far from the observer.</p>
<h3 id="los-sampling-strategy">LoS Sampling strategy</h3>
<p>For tools <a href="tools/LoS%20Creation/tool_create_global_los/">Create Global LoS</a>, <a href="tools/LoS%20Creation/tool_create_local_los/">Create Local LoS</a>, <a href="tools/LoS%20Creation/tool_create_notarget_los/"># Create No Target LoS</a> parametrizes LoS by so called <strong>Sampling distance - distance table</strong>. This approach is significantly more flexible, as it allows the sampling distance to change based on distance from the observer. The table is output of tools Calculate Object Distances<a href="tools/Calculate%20Parameters%20Settings/tool_distances_for_sizes/"></a> and <a href="tools/Calculate%20Parameters%20Settings/tool_sizes_at_distances/">Calculate Object Sizes</a>. Each row specifies distance from which specific sampling size should be used. For example row with column values of <strong>Distance (meters)</strong> 1000 and <strong>Size of object (meters)</strong> 1.754 specifies that sampling distance of 1.754 meters should be used on LoS when the length exceeds 1000 meters. Maximal length of LoS is given by maximal value of <strong>Distance (meters)</strong>.</p>
<p>There can be two special rows in the table with values of <strong>Distance (meters)</strong> 0 and -1. Row with value 0 specifies sampling distance for distance smaller than smallest provided distance (default value is 1). Row with value -1 means that there is no maximal LoS length and that the limit is provided by raster data extent.</p>
<p>Generally, a horizon is a point on LoS that is visible and is immediately followed by an invisible point. There are several types of horizons mentioned in the plugin's tools, mainly local and global horizons and horizon lines.</p>
<p>A global horizon is the highest point on the LoS and, if the surface raster extent is sufficient, it should be the point where the LoS meets the sky. Each LoS has just one global horizon.</p>
<p>A local horizon is any horizon on the LoS that is not global. There may be multiple local horizons on an LoS. Among these local horizons, the highest local horizon can be useful for some analyses. The maximal local horizon is the highest horizon that is not global.</p>
<h3 id="dem-use-in-the-plugin">DEM Use in the Plugin</h3>
<p>Most tools in the plugin allow you to use more than one DEM raster. The rasters are ordered from the smallest cell size to the largest. The cell size of each raster must be unique to form a complete ordering of rasters. Elevation is always obtained from the raster with the smallest cell size that has a valid elevation value (no data is not considered a valid value). This allows the utilization of DEMs with large cells in addition to DEMs with smaller cells. For example, a DEM with a cell size of 1 meter can be used within a city for areas close to observers, and SRTM data (30 meter cell size) can be used in areas around the city, far from the observer.</p>
<h3 id="los-sampling-strategy">LoS Sampling Strategy</h3>
<p>For tools <a href="tools/LoS%20Creation/tool_create_global_los/">Create Global LoS</a>, <a href="tools/LoS%20Creation/tool_create_local_los/">Create Local LoS</a>, and <a href="tools/LoS%20Creation/tool_create_notarget_los/">Create No Target LoS</a>, the LoS is determined by <strong>sampling distance</strong>, which specifies how often a point is placed on the LoS, and optionally by <strong>maximal LoS length</strong>.</p>
<p>The tool <a href="./tools/LoS%20Creation/tool_create_notarget_los_v2.md">Create No Target LoS V2</a> parametrizes LoS by a so-called <strong>Sampling distance - distance table</strong>. This approach is significantly more flexible, as it allows the sampling distance to change based on the distance from the observer. The table is the output of the tools <a href="tools/Calculate%20Parameters%20Settings/tool_distances_for_sizes/">Calculate Object Distances</a> and <a href="tools/Calculate%20Parameters%20Settings/tool_sizes_at_distances/">Calculate Object Sizes</a>. Each row specifies the distance from which a specific sampling size should be used. For example, a row with column values of <strong>Distance (meters)</strong> 1000 and <strong>Size of object (meters)</strong> 1.754 specifies that a sampling distance of 1.754 meters should be used on the LoS when the length exceeds 1000 meters. The maximal length of the LoS is given by the maximal value of <strong>Distance (meters)</strong>.</p>
<p>There can be two special rows in the table with values of <strong>Distance (meters)</strong> 0 and -1. A row with a value of 0 specifies the sampling distance for distances smaller than the smallest provided distance (default value is 1). A row with a value of -1 means that there is no maximal LoS length and that the limit is provided by the raster data extent.</p>
<h2 id="citation">Citation</h2>
<p>The citation for the plugin should be:</p>
<pre><code>Jan Caha (2023). LoS Tools. QGIS Plugin version 1.0. https://jancaha.github.io/qgis_los_tools/
Expand Down Expand Up @@ -374,6 +379,6 @@ <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
</html>

<!--
MkDocs version : 1.6.0
Build Date UTC : 2024-07-18 12:36:51.123506+00:00
MkDocs version : 1.6.1
Build Date UTC : 2024-11-14 15:17:04.718601+00:00
-->
4 changes: 4 additions & 0 deletions interactive tools/tool_los_without_target/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
4 changes: 4 additions & 0 deletions interactive tools/tool_los_without_target_sampling_settings/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
4 changes: 4 additions & 0 deletions interactive tools/tool_optimize_point_location/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
4 changes: 4 additions & 0 deletions interactive tools/tool_raster_validations/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
4 changes: 4 additions & 0 deletions interactive tools/tool_set_camera/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@
<a href="../../tools/Horizons/tool_extract_horizon_lines/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizon_lines_by_distances/" class="dropdown-item">Extract Horizon Lines</a>
</li>

<li>
<a href="../../tools/Horizons/tool_extract_horizons/" class="dropdown-item">Extract Horizons</a>
</li>
Expand Down
25 changes: 17 additions & 8 deletions js/base.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -57,10 +57,10 @@ document.addEventListener("DOMContentLoaded", function () {
var page;
switch (key) {
case shortcuts.next:
page = document.querySelector('.navbar a[rel="next"]:first').getAttribute('href');
page = document.querySelector('.navbar a[rel="next"]');
break;
case shortcuts.previous:
page = document.querySelector('.navbar a[rel="prev"]:first').getAttribute('href');
page = document.querySelector('.navbar a[rel="prev"]');
break;
case shortcuts.search:
e.preventDefault();
Expand All @@ -74,9 +74,9 @@ document.addEventListener("DOMContentLoaded", function () {
break;
default: break;
}
if (page) {
if (page && page.hasAttribute('href')) {
keyboard_modal.hide();
window.location.href = page;
window.location.href = page.getAttribute('href');
}
});

Expand All @@ -91,7 +91,7 @@ document.addEventListener("DOMContentLoaded", function () {

// First, close any sibling dropdowns.
var container = item.parentElement.parentElement;
container.querySelectorAll('> .dropdown-submenu > a').forEach(function(el) {
container.querySelectorAll(':scope > .dropdown-submenu > a').forEach(function(el) {
if (el !== item) {
hideInnerDropdown(el);
}
Expand All @@ -118,8 +118,14 @@ document.addEventListener("DOMContentLoaded", function () {
item.classList.remove('open');

popup.scrollTop = 0;
popup.querySelector('.dropdown-menu').scrollTop = 0;
popup.querySelector('.dropdown-submenu > a').classList.remove('open');
var menu = popup.querySelector('.dropdown-menu');
if (menu) {
menu.scrollTop = 0;
}
var dropdown = popup.querySelector('.dropdown-submenu > a');
if (dropdown) {
dropdown.classList.remove('open');
}
}

document.querySelectorAll('.dropdown-submenu > a').forEach(function(item) {
Expand All @@ -138,7 +144,10 @@ document.addEventListener("DOMContentLoaded", function () {
document.querySelectorAll('.dropdown-menu').forEach(function(menu) {
menu.parentElement.addEventListener('hide.bs.dropdown', function() {
menu.scrollTop = 0;
menu.querySelector('.dropdown-submenu > a').classList.remove('open');
var dropdown = menu.querySelector('.dropdown-submenu > a');
if (dropdown) {
dropdown.classList.remove('open');
}
menu.querySelectorAll('.dropdown-menu .dropdown-menu').forEach(function(submenu) {
submenu.classList.remove('show');
});
Expand Down
2 changes: 1 addition & 1 deletion search/search_index.json
View file

Large diffs are not rendered by default.

Loading

0 comments on commit 9e5a029

Please sign in to comment.