Terrains: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
m (Redirected page to Areas)
m (Replaced content with "#REDIRECT Areas")
Line 1: Line 1:
#REDIRECT [[Areas]]
#REDIRECT [[Areas]]
{{learned|file=Terrain-Q3-2015.jpg|what Terrain is|how Terrains relate to the Tygron engine|about the different Terrain types in the Tygron engine|how to add Terrain to your project|how to change Terrain in your project}}
==What is Terrain==
: Terrain (plural terrains): An area of land and/ or the particular features of it.
==What does Terrain mean in the Tygron Engine?==
: In the Tygron Engine terrain types can be selected for a specified area in the 3D world. Such a terrain type can have different features assigned according to the specific type selected. Terrain types in the Tygron Engine are; Flooding Terrain, Sewer Terrain, Safe Zone Terrain, Normal Terrain, Terrain imported from [https://www.arcgis.com/features ArcGIS] and Terrain imported as [[Glossary#GeoJSON file|GeoJSON file]].
==Available terrain types in the Tygron Engine?==
===Flooding Terrain===
: A Flooding Terrain is a visualization of an inundation of (a part of) the 3D world. The user can select tha area, the amount of water and color of the flooding overlay. To visualize the Flooding Terrain on both the 3D world and mini map, a dedicated overlay can be added. In order to trigger the flooding manually/ as part of an event, the Flooding terrain needs to be linked to the [[weather]] type Flooding (in [[Animations]]).
===Sewer Terrain===
: This terrain type sets the amount of drainage for a specified area. This terrain can then be visualized as overlay.
===Safe Zone Terrain===
: Implementing this terrain type enables the user to assign areas that will not be flooded by a [[Safe Zone Flooding]]. This can be used to visualize the effects of flood protection alignments. Areas in this Safe Zone will not be flooded, and areas added to this safe zone by adding levees and alignments are indicated by a separate color.
===Terrain imported from ArcGIS===
: It is possible to import terrain layers from the [[Glossary#A#ArcGIS|ArcGIS]] service from [[Glossary#E#Esri|Esri]], for those terrain data layers that are not by default loaded when creating a project in the Tygron Engine. An Esri/ ArcGIS account is not required to be able to import publicly published services from the online ArcGIS repository. When the user wants to create his own ArcGIS terrains, appropriate software is needed to create such [[Custom_Shapefiles|shapefiles]] and contour polygons, after which the file needs to be uploaded and published as a feature service in the ArcGIS account of the user/ organisation. It is important to publish the data as a feature service, because this service allows for queries to search the included data. A Map service for example, is only a polygon as an image, that can better be used as an overlay, as there is not data in this published map format that can be searched for with a query. See also [[TQL|Tygron Query Language]]
===Terrain imported as GeoJSON file===
: Because the Tygron Engine uses the GeoJSON file format, it is also possible to upload GeoJSON files directly into your project. This process has as advantage that (proprietary) data does not need to be published as feature service first. A third party GIS editor is needed to export shapefiles into GeoJSON format.
===Normal Terrain===
: A normal terrain is a terrain which can be used in combination with the Tygron Query Language [[TQL|(TQL)]]. You can use this terrain to separate your project in different specific locations, each with their own objective.
==What types of terrain can be used in the Tygron Engine?==
===Flooding Terrain===
: A Flooding Terrain is a visualization of an inundation of (a part of) the 3D world. The user can select the area to be flooded, the amount of flood water and the color of the flooding on the [[overlay]]. To visualize the Flooding Terrain on both the 3D world and mini map, a dedicated overlay can be added. In order to trigger the flooding manually/ as part of an event, the flooding terrain needs to be linked to the [[weather]] type Flooding (in [[Animations]]).
====Creating a Flooding terrain====
{{Editor steps|title=create a Flooding Terrain|Select 3D World > Terrains > Add Flooding Terrain|Rename the new Flooding Terrain in the 'Name' field on the right side of main view, if desired|Select a color from the drop down menu 'Color on Overlay'|Enter a value for 'Flood water level in meters/ ft'|Select if the Flooding Terrain is 'Active in Simulation'|Select the 'Adjust Area' button to enable the brush panel under the main view port|Select the area if the 3D world where the flooding takes place|Apply selection}}
<br />
<gallery mode="nolines">
File:AddFloodingTerrain-Q3-2015.jpg|1. Add Flooding Terrain
File:RenameFloodingTerrain-Q3-2015.jpg|2. Enter a (new) name
File:ColorFloodingTerrain-Q3-2015.jpg|3. Select a color
File:WaterLevelFloodingTerrain-Q3-2015.jpg|4. Set the water level of the flooding
File:ActivatelFloodingTerrain-Q3-2015.jpg|5. Select if 'Active in Simulation'
File:AdjustFloodingTerrain-Q3-2015.jpg|6. Select to draw the terrain
File:DrawFloodingTerrain-Q3-2015.jpg|7. Draw terrain in 3D world
File:ApplyFloodingTerrain-Q3-2015.jpg|8. Apply (or cancel) the selection
</gallery>
====Adding a Flooding Terrain Overlay====
{{Editor steps|title=add a Flooding Terrain Overlay|Select 3D World > Overlays|Select 'TERRAIN_FLOODING' from the drop down menu on the bottom left of the screen|Select to Add the terrain overlay|Notice Overlay icon is now available under mini map}}
<br />
<gallery mode="nolines">
File:SelectOverlayFloodingTerrain-Q3-2015.jpg|1. Select Overlays from 3D World
File:SelectTerrainFlooding-Q3-2015.jpg|2. Select 'TERRAIN_FLOODING' Overlay from the drop down menu
File:AddTerrainFloodingOverlay-Q3-2015.jpg|3. Add overlay
File:OverlayIconFloodingTerrain-Q3-2015.jpg|4. Overlay icon is added under mini map
</gallery>
====Linking Flooding Terrain to Flooding Weather, to manually trigger flooding====
: To enable the flooding to be triggered manually, a dedicated measure must be created. In this measure, the Flooding Terrain and Flooding Weather type are linked. The measure can then be assigned to an Action menu, to be accessible for the user.
{{Editor steps|title=link Flooding Terrain to Flooding Weather|Select Animations > Weather > Add Flooding|Rename the new Flooding Weather in the 'Name' field on the right side of main view, if desired|Select visual effect and Auto trigger, if desired|Enter values for 'Weather Duration in seconds', 'Flooding waterlevel in meters/ ft', 'Amount of rain', 'Duration of rainfall' and 'Annual rainfall increment'|Select Stakeholders > Measures > Add empty measure|Select 'Events' for the newly created measure|Add on the right side panel a Server event 'TERRAIN_SET_ACTIVE'|Add the Flooding Terrain to this event from the drop down list underneath the main view port|Add on the right side panel a Client event 'ACTIVATE_WEATHER'|Add the Weather ID 'Flooding' to this event from the drop down list underneath the main view port|Select 3D world > Actions|Add a new action menu|Assign the newly created measure to the new Action menu}}
<br />
<gallery mode="nolines">
File:SelectWeatherAddFlooding-Q3-2015.jpg|1. Select Animations > Weather > Add Flooding
File:RenameFloodingWeather-Q3-2015.jpg|2. Rename the new Flooding Weather type
File:VisualEffectFloodingWeather-Q3-2015.jpg|3. Select visual effect and Auto trigger
File:OtherValuesFloodingWeather-Q3-2015.jpg|4. Adjust the other values too
File:AddEmptyMeasure-Q3-2015.jpg|5. Select Stakeholders > Measures > Add empty measure
File:SelectEventsNewMeasure-Q3-2015.jpg|6. Select 'Events' for the newly created measure
File:AddServerEvent-Q3-2015.jpg|7. Add server event 'TERRAIN_SET_ACTIVE'
File:AddTerrainID-Q3-2015.jpg|8. Add the correct Terrain ID (Test Flood 1)
File:AddClientEvent-Q3-2015.jpg|9. Add client event 'ACTIVATE_WEATHER'
File:AddWeatherID-Q3-2015.jpg|10. Add the correct Weather ID (Test Flood 1)
File:Select3DWorldActions-Q3-2015.jpg|11. Select 3D world > Actions
File:AddNewActionMenu-Q3-2015.jpg|12. Add new Action menu
File:AssignNewMeasureToActionMenu-Q3-2015.jpg|13. Assign the new measure to the new Action menu
</gallery>
===Sewer Terrain===
: This terrain type sets the amount of drainage for a specified area. This terrain can then be visualized as overlay.
====Adding a Sewer Terrain & Overlay====
{{Editor steps|title=add Sewer Terrain & Overlay|Select 3D World > Terrains > Add Sewer Terrain|Rename the terrain in the 'Name' field, if desired|Select an appropriate overlay color|Enter a value for 'Sewer Water Storage per min'|Check to activate terrain in simulation|Select 'Adjust Area' to draw the terrain in the 3D world|Select 3D world > Overlays| Select to add a 'TERRAIN_SEWER' overlay}}
<br />
<gallery mode="nolines">
File:AddSewerTerrain-Q3-2015.jpg|1. Select 3D World > Terrains > Add Sewer Terrain
File:RenameSewerTerrain-Q3-2015.jpg|2. Rename the terrain, if desired
File:SelectColorSewerTerrain-Q3-2015.jpg|3. Select color
File:SetWaterStorageSewerTerrain-Q3-2015.jpg|4. Enter water storage value
File:ActivateSewerTerrain-Q3-2015.jpg|5. Check to activate terrain
File:AdjustFloodingTerrain-Q3-2015.jpg|6. Adjust area in 3D world
File:SelectOverlay-Q3-2015.jpg|7. Select 3D world > Overlays
File:AddTerrainSewerOverlay-Q3-2015.jpg|8. Select to add a 'TERRAIN_SEWER' overlay
</gallery>
===Safe Zone Terrain===
: Implementing this terrain type enables the user to assign areas that will not be flooded by a [[Safe Zone Flooding]]. This can be used to visualize the effects of flood protection alignments. Areas in this Safe Zone will not be flooded, and areas added to this safe zone by adding levees and alignments are indicated by a separate color.
====Adding a Safe Zone Terrain & Overlay====
{{Editor steps|title=add Safe Zone Terrain & Overlay|Select 3D World > Terrains > Add Safe Zone Terrain|Rename the terrain in the 'Name' field, if desired|Select an appropriate overlay color for the original safe zone and extended safe zone|Check to activate terrain in simulation|Select 'Adjust Area' to draw the original safe zone terrain in the 3D world|Select 3D world > Overlays| Select to add a 'TERRAINS' overlay|Highlight the new 'Special Terrain' and select 'Safe Zone Terrain' from the right side panel}}
<br />
<gallery mode="nolines">
File:AddSafeZoneTerrain-Q3-2015.jpg|1. Select 3D World > Terrains > Add Safe Zone Terrain
File:RenameSafeZoneTerrain-Q3-2015.jpg|2. Rename the terrain, if desired
File:SelectColorSafeZoneTerrain-Q3-2015.jpg|3. Select color
File:ActivateSafeZoneTerrain-Q3-2015.jpg|4. Check to activate terrain
File:AdjustFloodingTerrain-Q3-2015.jpg|5. Adjust area in 3D world
File:SelectOverlay-Q3-2015.jpg|6. Select 3D world > Overlays
File:AddTerrainsOverlay-Q3-2015.jpg|7. Select to add a 'TERRAINS' overlay
File:AddTerrainSafeZoneOverlay-Q3-2015.jpg|8. Select 'Safe Zone Terrain' from the right side panel
</gallery>
===Normal Terrain===
: This terrain type can be used to designate/ revert areas with other terrain types, back to normal terrain features. This avoids having to manually remove other terrains, for instance when overlapping.
====Adding Normal Terrain & Overlay====
{{Editor steps|title=add Normal Terrain & Overlay|Select 3D World > Terrains > Add Normal Terrain|Rename the terrain in the 'Name' field, if desired|Select an appropriate overlay color|Check to activate terrain in simulation|Select 'Adjust Area' to draw the terrain in the 3D world|Select 3D world > Overlays| Select to add a 'TERRAINS' overlay|Highlight the new 'Special Terrain' and select 'Normal Terrain' from the right side panel}}
<br />
<gallery mode="nolines">
File:AddSafeZoneTerrain-Q3-2015.jpg|1. Select 3D World > Terrains > Add Normal Terrain
File:RenameNormalTerrain-Q3-2015.jpg|2. Rename the terrain, if desired
File:SelectColorNormalTerrain-Q3-2015.jpg|3. Select color
File:ActivateNormalTerrain-Q3-2015.jpg|4. Check to activate terrain
File:AdjustFloodingTerrain-Q3-2015.jpg|5. Adjust area in 3D world
File:SelectOverlay-Q3-2015.jpg|6. Select 3D world > Overlays
File:AddTerrainsOverlay-Q3-2015.jpg|7. Select to add a 'TERRAINS' overlay
File:AddTerrainNormalOverlay-Q3-2015.jpg|8. Select 'Safe Zone Terrain' from the right side panel
</gallery>
===Terrain imported from ArcGIS===
: It is possible to import terrain layers from the [[Glossary#A#ArcGIS|ArcGIS]] service from [[Glossary#E#Esri|Esri]], for those terrain data layers that are not by default loaded when creating a project in the Tygron Engine. An Esri/ ArcGIS account is not required to be able to import publicly published services from the online ArcGIS repository. When the user wants to create his own ArcGIS terrains, appropriate software is needed to create such [[shapefiles]] and contour polygons, after which the file needs to be uploaded and published as a feature service in the ArcGIS account of the user/ organisation. It is important to publish the data as a feature service, because this service allows for queries to search the included data. A Map service for example, is only a polygon as an image, that can better be used as an overlay, as there is not data in this published map format that can be searched for with a query. See also [[TQL|Tygron Query Language]]
: To better illustrate 'How to use' these ArcGIS terrains, we will look at a specific example; the flooding issues in Lower Manhattan. As the Sandy flooding has been well documented, searching for relevant data is not very difficult.
====How to import ArcGIS terrains====
[[File:QueriesForLayerArcGISImport-Q3-2015.jpg|450px|right|thumb|Clauses from the NFHL feature service from Fema]]
: We will import a terrain based on the National Flood Hazard Layer (NFHL) from the Federal Emergency Management Agency (Fema) for New York City. The searchable query is <code>ZONE_SUBTY</code> (Zone Subtype) and we search for the flood hazard of one flooding per 500 years. For this we use the clauses <code>'AREA OF MINIMAL FLOOD HAZARD'</code> and <code>'0.2 PCT ANNUAL CHANCE FLOOD HAZARD'</code>.
: This results in the following query:<br>
: <code>ZONE_SUBTY='AREA OF MINIMAL FLOOD HAZARD' OR ZONE_SUBTY='0.2 PCT ANNUAL CHANCE FLOOD HAZARD'</code>
: ''Please note that when querying a text string, enclosing quotation marks are required around these text strings (see example). When querying for a numerical value, these quotation marks are redundant.''
: As the searched for data in our example has been published by Fema as a public feature service, logging in to an ArcGIS account is not required. This being said, when using a custom made feature service that is not intended for public use (confidential information or intellectual property for instance), logging into ArcGIS is required to access private data sets that are only visible within the organisation.
<br />
{{Editor steps|title=import ArcGIS terrains|Load or create a project based on real data, situated in the area for which an ArcGIS terrain (feature service) is available|Log in with ArcGIS credentials on the top right side of the Tygron Editor window (for private feature services only)|Select 3D World > Terrains > Import terrain from ArcGIS|Enter 'National Flood Hazard Layer' in the search bar of the newly opened Esri Import panel|Highlight any suitable layer that appears as search result|Ensure the correct Feature Sevice Layer is selected ('Flood Hazard Zones', should be by default)|Select the appropriate field > 'ZONE_SUBTY'|Specify layer features with an appropriate query|Select 'SAFE_ZONE' from the drop down list to designate the imported terrain type as a protected area|Add the terrain to start the import process|The new terrain is now imported, and can be edited. Under the mini map a new icon for the overlay has appeared}}
<br />
<gallery mode="nolines">
File:ArcGISLogin-Q3-2015.jpg|2. Log in with ArcGIS credentials (not required for this example!)
File:SelectArcGISterrain-Q3-2015.jpg|3. Select 3D world > Terrains > import from ArcGIS
File:SearchLayerArcGISImport-Q3-2015.jpg|4. Search for 'National Flood Hazard Layer'
File:HighlightLayerArcGISImport-Q3-2015.jpg|5. Highlight suitable layer
File:FeatureServiceLayerArcGISImport-Q3-2015.jpg|6. Ensure 'Flood hazard Zones' is selected
File:ShowLayerFieldsArcGISImport-Q3-2015.jpg|7. Select 'ZONE_SUBTY'
File:QueryLayerArcGISImport-Q3-2015.jpg|8. Enter query to specify layer features
File:TerrainTypeLayerArcGISImport-Q3-2015.jpg|9. Designate the desired terrain type
File:AddTerrainLayerArcGISImport-Q3-2015.jpg|10. Add the terrain
File:ImportedTerrainLayerArcGISImport-Q3-2015.jpg|11. The terrain is ready for use
</gallery>
===Terrain imported as GeoJSON file===
: When a specific terrain data set is available for your project and, for any reason, the ArcGIS method is not desirable, it is also possible to upload the terrain data directly into the project. For this, the data needs to be available in GeoJSON format. To convert shapefiles into this format, a third party GIS editor tool can be used. The [http://desktop.arcgis.com/en/ ArcGIS desktop module] is capable to do so, however, free tools such as QGIS also perform the task. QGIS ([http://www.qgis.org/en/site/ Quantum GIS]) is a free and open source tool we suggest and use in the below example, however, other tools (openjump, FreeGIS, etc) are also freely available, but are not (yet) tested by Tygron.
[[File:QGIS-logo.jpg|left|150px]]
<br clear=all>
====How to import Terrains as GeoJSON file====
: To better illustrate how to import GIS data as terrain in the GeoJSON format into a project, we will describe the use case of importing a noise contour terrain and overlay in a project in Amsterdam, using freely available data from the [http://maps.amsterdam.nl/open_geodata/ Amsterdam Municipality] and QGIS to convert the shape file to GeoJSON.
{{Editor steps|title=convert a terrain data shape file into GeoJSON format|Have the GIS data shape file locally available|Open a new QGIS project and drop the shapefile (.zip folder) into the main editor panel|If the file contains multiple vector layers, select the desired layers (or select all) on the newly opened window|Now the file is visualized on the main view panel of QGIS, while a new panel shows a list of imported layers on the left of the main view panel|Right-click on the desired layer to export, and select 'save as' (It is possible to select multiple layers together)|Select GeoJSON as format, enter a suitable name and target location, and ensure that 'EPGS:3857 - WGS 84/ Pruedo Mercator' is selected as CRS style|The newly created GeoJSON file now appears on the left side, as new layer, and on the target location}}
<br />
<gallery mode="nolines">
File:SHP-file-available.jpg|1. Have the GIS data shape file locally available
File:QGIS-main.jpg|2. Open a new QGIS project and drop the shapefile (.zip folder) into the main editor panel
File:QGIS_Select_vector_Layers.jpg|3. Select the desired layers (or select all) on the newly opened window
File:QGIS-ImportedFile-Main.jpg|4. The file is visualized on the main view panel of QGIS and a list of imported layers appears on the left of the main view panel
File:QGIS-SAveAs.jpg|5. Right-click on the desired layer to export, and select 'save as'
File:QGIS-SaveVectorLayerAs.jpg|6. Select GeoJSON as format, enter a suitable name and target location, and ensure that 'EPGS:3857 - WGS 84/ Pruedo Mercator' is selected as CRS style, then confirm
File:QGIS-newGeoJSON.jpg|7. The newly created GeoJSON file now appears on the left side, as new layer, and on the target location
</gallery>
{{Editor steps|title=import a GeoJSON file as terrain in the Tygron enditor|Open the Tygron Editor and create or load a project for the selected area|Drag and drop the new GeoJSON file anywhere on the editor window|When a new panel asks what to do with the file, select to import as a terrain|Another new panel now asks for certain features to be set, such as 'Merge polygons' and which layer features to filter| The Values button displays an information panel with all available values for the selected layer feature|Enter one value and select Send, a new terrain is now imported, with a polygon of one piece and depicting the selected value|Repeat the process for each desired consecutive value for the selected feature layer|Rename the imported terrains to a more logical name, this name will also appear in the legend of the terrain overlay (see below)|Select an appropriate color for the just created terrain layer}}
<br />
<gallery mode="nolines">
File:QGIS-GenerateProject.jpg|1. Create or load a project for the selected area in the Tygron Editor
File:QGIS-DropGeoJSON.jpg|2. Drag and drop the new GeoJSON file anywhere on the Tygron editor window
File:QGIS-ImportAsTerrain.jpg|3. Select to import as a terrain when prompted
File:QGIS-SelectMergeAndFilterFeature.jpg|4. Select, if desired, 'Merge polygons' and which layer feature to filter
File:QGIS-FeatureValues.jpg|5. The Values button displays an information panel with all available values for the selected layer feature
File:QGIS-EnterValues.jpg|6. Enter the desired value and select Send, a new terrain is now imported (3D World > Terrains > Edit Terrains)
File:QGIS-Repeat.jpg|7. Repeat the process for each desired consecutive value for the selected feature layer
File:QGIS-rename.jpg|8. Rename the imported terrains to a more logical name, this name will also appear in the legend of the terrain overlay
File:QGIS-SelectOverlayColor.jpg|9. Select an appropriate color for the just created terrain layer
</gallery>
{{Editor steps|title=make an overlay for a GeoJSON file based terrain in the Tygron editor|Open the Tygron Editor and load the project for the selected area|Select 3D World > Overlays > Edit Overlays|On the left side, select to add a new 'terrain'|Select the newly added terrain from the list|Rename the new overlay with a suitable name on the right side panel|Check the selection boxes of the desired terrains from the list on the right side. A new overlay icon and legend will appear in the editor main view|The new overlay is now selectable, showing all colored terrain layers in one image}}
<br />
<gallery mode="nolines">
File:QGIS-GenerateProject.jpg|1. Open the Tygron Editor and load the project for the selected area
File:QGIS-SelectEditOverlay.jpg|2. Select 3D World > Overlays > Edit Overlays
File:QGIS-AddNewOverlay.jpg|3. On the left side, select to add a new 'terrain' overlay
File:QGIS-SelectNewlyAdded.jpg|4. Select the newly added terrain overlay from the list
File:QGIS-RenameOverlay.jpg|5. Rename the new overlay with a suitable name on the right side panel
File:QGIS-CheckDesiredTerrains.jpg|6. Check the selection boxes of the desired terrains from the list on the right side
File:QGIS-TerrainOverlay.jpg|7. The new overlay is now selectable, showing all colored terrain layers in one image
</gallery>

Revision as of 11:05, 13 October 2016

Redirect to:

Retrieved from "https://support.tygron.com/w/index.php?title=Terrains&oldid=10829"