Water Connection Generator and I3S: Difference between pages

From Tygron Support wiki
(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
__NOTOC__
3D models in different formats, such as BIM data or a SketchUp model, can be converted to the I3S format with a SLPK file. See the text below to learn more about this.
The Water Connection Generator enables users to generate (and remove) underground [[buildings]] using a set of parameters. This generator can be used for example when creating a project with the [[Water Overlay]], but a dataset with all culverts is not available. With the water connection generater, the [[Culvert_(Water_Overlay)|culverts]] can be generated.
The parameters are explained below under {{inlink|Advanced Options}}.
The water connection generator panel can be found in the Current Situation tab:
{{editor location|Buildings|dropdown=Generate Water Connections}}


[[File:Water_connection_generator.PNG|The Water Connection Generator panel|400px]]
==What is I3S?==
The I3S (Indexed 3D Scene Layer Specification) is a format for large 3D Geo datasets. The specification is especially designed for streaming large 3D data over the web. The specification originates from Esri and was adopted as a Community Standard by the OGC (Open Geospatial Consortium) in 2017. An I3S dataset is also called a Scene Layer.


==Options==
==What is an SLPK?==
[[File:Water_connection_generator_function.png|thumb|right|200px|Select the function and the location of the to be generated connections]]
A Scene Layer Package (SLPK) is a file format for the storage/exchange of one I3S layer.
There are a few basic options which form the foundation of using the Water Connection Generator. These options are displayed at the top of the Water Connection Generator's window.


===Function===
What [[Function]] should be applied to the [[Construction]]s generated by the Water Connection Generator. Due to the nature of water connections, only [[Function]]s of the underground [[Function Category]] can be selected.


===Applied on===
==See also==
Where the new [[Construction]]s should be generated. The following settings are allowed:
* [[How_to_import_i3s_scene_layer_in_new_project|How to create a new project with existing I3S data]]
* Entire map: Generate [[Construction]]s across the entire map.
* [[How_to_prepare_a_3D_plan_for_importing|How to prepare a 3D plan before importing]]
* Nearby area: Generate [[Construction]]s only in the vicinity of the [[Camera]]'s current location. This is everything currently visible by the camera, or within 250m of what is currently visible by the camera.
* [[How_to_create_a_SLPK_file|How to create a SLPK file from other 3D data formats]]
* Specific neighborhood: Generate [[Construction]]s only in a specific [[Neighborhood]].
* [[How_to_import_a_SLKP_file|How to import a SLKP file into the {{software}}]]
{{clear}}


==Advanced Options==
{{Template:GeoDataOverview}}
[[File:Water_connection_generator_advanced.png|thumb|right|200px|The advanced options]]
There are a variety of advanced options available which allow fine-tuning the exact circumstances under which [[Construction]]s are or aren't generated. The provided defaults are meant to allow using the Water Connection Generator and getting reasonable result with minimal effort, but by further refining the generator's configuration its possible to improve the results for a given location and use-case.
 
===Minimum and maximum length===
Both the minimum and maximum length in meters can be provided to set the length of the created water connections and to limit the amount of created connections. The length is measured as the closest points between two water bodies.
 
===Large road threshold===
A road is considered large (and therefore impassable by a water connection) when the road's size is larger than the set threshold value. This parameter can be used to prevent water connections crossing large roads. The large road threshold is provided as a surface size in m2. The surface size of each road polygon is then checked against the threshold value.
 
=== Large road straight===
[[File:Large_road_straight_setting2.png|thumb|left|300px|In this schematic image, the large road straight setting is set on 30m. Only one water connection is generated, since there is one waterway that is perpendicular to another waterway.]]
The large road straight parameter is used to measure if waterways are perpendicular to each other. It is measured by extending the placed water connection by x meters and if it is still in a waterway or body, then it is perpendicular and accepted. For parallel waterways, this check will not create a water connection when the defined x is sufficiently large.
{{clear}}
 
=== Maximum height difference ===
<div class='tleft'><ul style='margin-left:unset;'>
<li style = "display:inline-block">[[File:water_connection_max_height.jpg|300px|thumb|none|Two waterways with a levee inbetween. A stricter max height difference can prevent the creation of an unrealistic water connection.]]</li>
<li style = "display:inline-block">[[File:water_connection_height_difference.jpeg|300px|thumb|none|Two waterways, of which one is situated 5 meters lower than the other, where there typically would be no water connection.]]</li>
</ul></div>
The maximum height difference in meters that is allowed for the water connection te be generated. The height difference is measured on the surface where the water connection would be. This parameter can therefore be used to detect levees on the surface and prevent water connections through them. Additionally, this same parameter can be used to prevent connections being created for water ways that have very different water levels.
{{clear}}
 
=== Width ===
The generated water construction will have its width set to this value when generated. The width is provided in meters. For [[Culvert_(Water_Overlay)|culverts]], the width will be the [[Culvert_diameter_(Water_Overlay)|culvert diameter]].
 
=== Ignore upstream ===
Sometimes multiple water connections can be created for the same water bodies. The ignore upstream parameter can be used to remove connections of which its end point differ by more than the indicated amount in meters. It is somewhat  similar to the parameter '''Maximum height difference''', but more restrictive in its application.
 
=== Include water bodies ===
When selected, both [[Terrain_Type#Surface|waterways]] and [[Terrain_Type#Surface|water bodies]] are taken into account as water terrains where water connections to and from are generated. When not selected, only [[Terrain_Type#Surface|waterways]] are taken into account.
 
==Reset and remove==
[[File:Water_connection_generator_reset.png|thumb|right|200px|Reset and remove buttons]]
 
* The '''Reset to defaults''' action reverts the values of the advanced options back to the default settings.
* The '''Remove generated''' action removes all generated constructions of the selected function. Note that this also removes not generated constructions of this function. For example constructions which were imported or manually drawn.
{{clear}}
 
{{article end
|seealso=
* To get started with the Water Connection Generator, see the [[Demo_Create_Culverts_Project|Demo Create Culverts project]] which is available in your domain.
* [[Culvert (Water Overlay)]]
* [[Hydraulic structures (Water Overlay)]]
* For more information on the use of the water connection generator, see this video (Dutch only):
[[File:YoutubeLogo1.jpg|thumb|left|link=https://youtu.be/Ac2yAKAh9aY|Editing the Water Connection Generator (Dutch Only)]]
|howtos=
* [[How to use the Water Connection Generator to generate Constructions]]
* [[How to use the Water Connection Generator with advanced options to generate Constructions]]
* [[How to remove Constructions generated by the Water Connection Generator]]
}}

Revision as of 14:13, 15 March 2021

3D models in different formats, such as BIM data or a SketchUp model, can be converted to the I3S format with a SLPK file. See the text below to learn more about this.

What is I3S?

The I3S (Indexed 3D Scene Layer Specification) is a format for large 3D Geo datasets. The specification is especially designed for streaming large 3D data over the web. The specification originates from Esri and was adopted as a Community Standard by the OGC (Open Geospatial Consortium) in 2017. An I3S dataset is also called a Scene Layer.

What is an SLPK?

A Scene Layer Package (SLPK) is a file format for the storage/exchange of one I3S layer.


See also