Geo Data tutorial: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
==Getting Started==
==Getting Started==
For this tutorial we use the project Geo_data_tutorial. To get this project, [//tygronsupport.freshdesk.com/support/tickets/new Contact Tygron Support].  
For this tutorial we use the project Geo_data_tutorial. To get this project, [//tygronsupport.freshdesk.com/support/tickets/new Contact Tygron Support].  
In this tutorial, you will learn the different ways to import data in your project.
In this tutorial, you will learn the different ways to import data in your project:
 
# Import data from Web services
===Extra Assignment===
# Import data as a a single, separate file
# Import the other dataset (bomen) by repeating the previous steps (1,2 and 3).
# In step 2 view features of the wizard, notice that there are 10 points in the datset and 0 lines or polygons. In the Engine it is only possible to upload polygons. Therefore, we can buffer the points to create (round polygons) for the trees. Set the buffer size on 1, so as not to create very large trunks and follow the rest of the wizard.
# How would you do the mapping in step 7? As One Function or Function Mapping?
# After finishing the wizard, notice the new trees in the spatial plan area.


==Importing data from Web services==
==Importing data from Web services==
In this section we are going to import data from a WFS ([[WFS|Web Feature Service]]) and a WMS (Web Map Service) to create an archeological value map.  
In this section we are going to import data from a:
* WFS (Web Feature Service)  
* WMS (Web Map Service)
* And we will learn how to import data from a CSW (Catalogue Service).  


===Import data from a WFS===
===Import data from a WFS===
====Import data from a WFS====
====Archeological Value map====
* Firstly, if you don’t have a WFS URL available, search for an open dataset on the Web. For the Netherlands, you can go for example to the: [http://nationaalgeoregister.nl].  On this website you can search for open datasets.  
In this assignment you will create an Archeological Value Map.
* Type in: “archeologie” and click on the first hit: ''Archeologie Catalogus''. Take a moment to read what this dataset is about. Then copy the WFS URL: this is the URL that contains WFS in the URL link.
 
* Log in to the Tygron Engine, open your Project and start the Geo Data Wizard by clicking in the Editor on ''Geo import''.  
# First read what exactly a [[WFS|Web Feature Service]] is.
{{Editor ribbon|header=Geo Data|bar=Geo Import}}
# Now we need to find data that is published as a WFS. For the Netherlands, you can go for example to the: [http://nationaalgeoregister.nl Nationaal Georegister].  On this website you can search for open datasets. Type in: “archeologie” and click on the first hit: ''Archeologie Catalogus''. Take a moment to read what this dataset is about. Then copy the WFS URL: this is the URL that contains WFS in the URL link.
* Start the wizard and choose the correct type for importing the data. Since we are going to create a map which is equivalent to an overlay, choose as type: AREAS. See the [[Geo_Data_Wizard|Geo Data Wizard]] for more information about the differences between the imported types.
# Start the Geo Data Wizard by clicking in the Editor on ''Geo import''. {{Editor ribbon|header=Geo Data|bar=Geo Import}}
* In step 1 of the wizard, choose for add WFS service.  
# Choose the correct type for importing the data. Since we are going to create a map which is equivalent to an overlay, choose as type: AREAS. Read the [[Geo_Data_Wizard|Geo Data Wizard]] for more information about the differences between the imported types.
* Click on ''add a new Feature Service'' and provide a custom name, Service Type (WFS_JSON) and URL of the WFS. If the data is filled in correctly, click on add and then next.  
# In step 1 of the wizard, choose for ''add WFS service''.  
* In step 1.2 all the datasets that are published through this URL are shown (these are called layers). Choose the first layer: ''archeo_monumenten''. If this dataset is not in your project, an error message is given. What could be a reason that the data is not in your project? If this is the case, try one of the other layers. If none of these layers are in your project area, go back one step and use another WFS URL.
# Click on ''add a new Feature Service'' and provide a custom name, Service Type (WFS_JSON) and URL of the WFS. If the data is filled in correctly, click on ''add'' and then ''next''.  
* In step 2 the location of the objects in your project area is shown. Remember that point and line features should be buffered to create polygons. If your datasets is not consistent of polygons, buffer them.
# In step 1.2 all the datasets that are published through this URL are shown (these are called layers). Choose the first layer: ''archeo_monumenten''. If this dataset is not in your project, an error message is given. What could be a reason that the data is not in your project?  
* In step 3 we can filter the features and in step 4 adding as new areas or updating areas. Click 2 times on next.
# In step 2 the location of the objects in your project area is shown.  
* In step 5 we name the features. Click on: Based on specific Attribute and choose for the attribute ''TOPONIEM''. Now the features will be named after their geographic entity.
# In step 3 we can filter the features and in step 4 adding as new areas or updating areas. Click 2 times on ''next''.
* In step 6 the attributes can be selected. Only numerical attributes are imported in the Engine. These are by default checked. Notice that therefore the list of attributes is much smaller than the list of attributes was in step 5. Click on next.  
# In step 5 we name the features. Click on: ''Based on specific Attribute'' and choose for the attribute ''TOPONIEM''. Now the features will be named after their geographic entity.
* In step 7 click on Finish. Now the Geo data wizard is finished and the data is imported.
# In step 6 the attributes that will be imported are selected. Only numerical attributes are imported in the Engine. These are by default checked. Notice that therefore the list of attributes is much shorter than the list of attributes was in step 5. Click on ''next''.  
# In step 7 click on ''Finish''. Now the Geo data wizard is finished and the data is imported.


====Create an overlay====
====Create an overlay====
* Go in the Editor to Areas and notice that on the left side the areas you imported are listed. Click on them and see that in the 3D world the corresponding area is highlighted. In the tab Attributes on the right side of the area the attributes are imported as well.  
# Go in the Editor to Areas and notice that on the left side the areas you have imported are listed. Click on them and see that in the 3D world the corresponding area is highlighted. In the tab ''Attributes'' on the right side of the area the attributes are imported as well.  
{{Editor ribbon|header=Geo Data|bar=AREAS}}
{{Editor ribbon|header=Geo Data|bar=AREAS}}
* Since we don't want to go by these areas one by one to see the archeological value areas, we are going to create a map so we can see them in one view.
# Since we don't want to go by these areas one by one to see the archeological value areas, we are going to create a map so we can see them in one view.
Go therefore in the editor to overlays.
Go therefore in the editor to overlays.
{{Editor ribbon|header=Geo Data|bar=OVERLAYS}}
{{Editor ribbon|header=Geo Data|bar=OVERLAYS}}
* Add a new overlay by clicking in the bottom left corner on ''Add Areas''.
# Add a new overlay by clicking in the bottom left corner on ''Add Areas''.
* Notice a new overlay, named: ''Speciaal gebied'' is added.  
# Notice a new overlay, named: ''Speciaal gebied'' is added.  
* Select this overlay and notice the new menu on the right side.
# Select this overlay and notice the new menu on the right side.
* Give the new overlay a fitting name and check the areas belonging to the archeological value map. If there are a lot of areas, you can also click on the button in the bottom right corner on ''Add Areas with Attribute''. Here you can select a common attribute that the areas have. Select the common attribute, for example ''MONUMENTNR'' and click on Add.
# Give the new overlay a fitting name and check the areas belonging to the archeological value map. If there are a lot of areas, you can also click on the button in the bottom right corner on ''Add Areas with Attribute''. Here you can select a common attribute of these areas. Select the common attribute, for example ''MONUMENTNR'' and click on Add.


===Import data from a WMS===
===Import data from a WMS===
====Import data from a WMS====
====Import data from a WMS====
* Firstly read on the Wiki what a WMS exactly is.  
# Firstly read on the Wiki what a WMS exactly is.  
* Add an Image overlay by hovering over the overlays button and choose the add Image overlay.
# Add an Image overlay by hovering over the overlays button and choose the add Image overlay.
{{Editor ribbon|header=Geo Data|bar=Overlays}}
{{Editor ribbon|header=Geo Data|bar=Overlays}}
* Notice that a new overlay (named Beeldlaag) is added. Change on the right side the name and then open the Configuration Wizard.  
# Notice that a new overlay (named Beeldlaag) is added. Change on the right side the name and then open the Configuration Wizard.  
* Select the second option: import from a Web Image Service
# Select the second option: import from a Web Image Service
* Click on ''add a new Image Service'' and provide a custom name, Service Type (WMS_IMAGE) and URL of the WMS. If the data is filled in correctly, click on add and then next.
# Click on ''add a new Image Service'' and provide a custom name, Service Type (WMS_IMAGE) and URL of the WMS. If the data is filled in correctly, click on add and then next.


===Import data from a Catalogue Service===
===Import data from a Catalogue Service===
====Import data from a CSW====
====Monumental Buildings in Delft====
In this step we are going to create a map (overlay) of all the monumental buildings in Delft.  
In this step we are going to create a map (overlay) of all the monumental buildings in Delft.  
* Read on the Wiki what a CSW exactly is.  
# Read on the Wiki what a CSW exactly is.  
* Open the Geo Data wizard and choose for type ''AREAS''.  
# Open the Geo Data wizard and choose for type ''AREAS''.  
* In step 1 of the wizard, choose for: ''Search for data in a Catalog Service''.  
# In step 1 of the wizard, choose for: ''Search for data in a Catalog Service''.  
* Click on ''Select Catalog Service'' and choose ''ArcGIS online''.
# Click on ''Select Catalog Service'' and choose ''ArcGIS online''.
* In the next screen you can type a keyword of the dataset you want to find. We are going to create a map of the monumental buildings in Delft. Think of a correct keyword to type and click on ''Search''.
# In the next screen you can type a keyword of the dataset you want to find. We are going to create a map of the monumental buildings in Delft. Think of a correct keyword to type and click on ''Search''.
Remeber the project owner of the data should match the location of where you want to find data of.  
Remeber the project owner of the data should match the location of where you want to find data of.  
* Complete the wizard. Don't forget in step 5 to choose the correct attribute to base the name on.
# Complete the wizard. Don't forget in step 5 to choose the correct attribute to base the name on.
* Follow the previous steps for creating an Overlay.
# Follow the previous steps for creating an Overlay.
* Now your map of monumental buildings is done.
# Now your map of monumental buildings is done.


==Importing data from a single, separate file==
==Importing data from a single, separate file==
Line 86: Line 86:
# Finish the wizard.  
# Finish the wizard.  
# Notice the new buildings are now in the 3D model
# Notice the new buildings are now in the 3D model
===Extra Assignment===
# Import the other dataset (bomen) by repeating the previous steps (1,2 and 3).
# In step 2 view features of the wizard, notice that there are 10 points in the datset and 0 lines or polygons. In the Engine it is only possible to upload polygons. Therefore, we can buffer the points to create (round polygons) for the trees. Set the buffer size on 1, so as not to create very large trunks and follow the rest of the wizard.
# How would you do the mapping in step 7? As One Function or Function Mapping?
# After finishing the wizard, notice the new trees in the spatial plan area.

Revision as of 13:43, 18 June 2018

Please note: This page is currently being updated.

Getting Started

For this tutorial we use the project Geo_data_tutorial. To get this project, Contact Tygron Support. In this tutorial, you will learn the different ways to import data in your project:

  1. Import data from Web services
  2. Import data as a a single, separate file

Importing data from Web services

In this section we are going to import data from a:

  • WFS (Web Feature Service)
  • WMS (Web Map Service)
  • And we will learn how to import data from a CSW (Catalogue Service).

Import data from a WFS

Archeological Value map

In this assignment you will create an Archeological Value Map.

  1. First read what exactly a Web Feature Service is.
  2. Now we need to find data that is published as a WFS. For the Netherlands, you can go for example to the: Nationaal Georegister. On this website you can search for open datasets. Type in: “archeologie” and click on the first hit: Archeologie Catalogus. Take a moment to read what this dataset is about. Then copy the WFS URL: this is the URL that contains WFS in the URL link.
  3. Start the Geo Data Wizard by clicking in the Editor on Geo import. Template:Editor ribbon
  4. Choose the correct type for importing the data. Since we are going to create a map which is equivalent to an overlay, choose as type: AREAS. Read the Geo Data Wizard for more information about the differences between the imported types.
  5. In step 1 of the wizard, choose for add WFS service.
  6. Click on add a new Feature Service and provide a custom name, Service Type (WFS_JSON) and URL of the WFS. If the data is filled in correctly, click on add and then next.
  7. In step 1.2 all the datasets that are published through this URL are shown (these are called layers). Choose the first layer: archeo_monumenten. If this dataset is not in your project, an error message is given. What could be a reason that the data is not in your project?
  8. In step 2 the location of the objects in your project area is shown.
  9. In step 3 we can filter the features and in step 4 adding as new areas or updating areas. Click 2 times on next.
  10. In step 5 we name the features. Click on: Based on specific Attribute and choose for the attribute TOPONIEM. Now the features will be named after their geographic entity.
  11. In step 6 the attributes that will be imported are selected. Only numerical attributes are imported in the Engine. These are by default checked. Notice that therefore the list of attributes is much shorter than the list of attributes was in step 5. Click on next.
  12. In step 7 click on Finish. Now the Geo data wizard is finished and the data is imported.

Create an overlay

  1. Go in the Editor to Areas and notice that on the left side the areas you have imported are listed. Click on them and see that in the 3D world the corresponding area is highlighted. In the tab Attributes on the right side of the area the attributes are imported as well.

Template:Editor ribbon

  1. Since we don't want to go by these areas one by one to see the archeological value areas, we are going to create a map so we can see them in one view.

Go therefore in the editor to overlays. Template:Editor ribbon

  1. Add a new overlay by clicking in the bottom left corner on Add Areas.
  2. Notice a new overlay, named: Speciaal gebied is added.
  3. Select this overlay and notice the new menu on the right side.
  4. Give the new overlay a fitting name and check the areas belonging to the archeological value map. If there are a lot of areas, you can also click on the button in the bottom right corner on Add Areas with Attribute. Here you can select a common attribute of these areas. Select the common attribute, for example MONUMENTNR and click on Add.

Import data from a WMS

Import data from a WMS

  1. Firstly read on the Wiki what a WMS exactly is.
  2. Add an Image overlay by hovering over the overlays button and choose the add Image overlay.

Template:Editor ribbon

  1. Notice that a new overlay (named Beeldlaag) is added. Change on the right side the name and then open the Configuration Wizard.
  2. Select the second option: import from a Web Image Service
  3. Click on add a new Image Service and provide a custom name, Service Type (WMS_IMAGE) and URL of the WMS. If the data is filled in correctly, click on add and then next.

Import data from a Catalogue Service

Monumental Buildings in Delft

In this step we are going to create a map (overlay) of all the monumental buildings in Delft.

  1. Read on the Wiki what a CSW exactly is.
  2. Open the Geo Data wizard and choose for type AREAS.
  3. In step 1 of the wizard, choose for: Search for data in a Catalog Service.
  4. Click on Select Catalog Service and choose ArcGIS online.
  5. In the next screen you can type a keyword of the dataset you want to find. We are going to create a map of the monumental buildings in Delft. Think of a correct keyword to type and click on Search.

Remeber the project owner of the data should match the location of where you want to find data of.

  1. Complete the wizard. Don't forget in step 5 to choose the correct attribute to base the name on.
  2. Follow the previous steps for creating an Overlay.
  3. Now your map of monumental buildings is done.

Importing data from a single, separate file

In this section we are going to import data from a single, separate file. For example if you downloaded a file of data from the internet. To import data in the Engine, the file must be of the GeoJSON format.

In the next assignment we are going to import two datasts as 3D objects in the 3D model. One dataset contains a road, an office, parking space and park. The other dataset contains trees.

Importing data as a GeoJSON

  • Read the Section on the Wiki of what exactly a GeoJSON for file format is.
  • Mostly data is not available as a GeoJSON but for example as a Shapefile. Therefore we have to create the GeoJSON ourselves.
  1. Download these two files and follow the steps of how to create a GeoJSON file in you preferred GIS. You can skip the part of modifying the attributes.
  2. After you have created the two GeoJSON files, open the Geo Data Wizard.
  3. Select as type Buildings.
  4. Select in step 1 Import a GeoJSON file.
  5. Choose the file: Spatial plan in the next step.
  6. Click on Next in the following steps, choosing again the first option. In step 5 choose the correct column for the naming of the objects.
  • In step 7 we see a new step that we did not come across when choosing to import data as AREAS. In this step you decide what kind of 3D object the data will be.
  1. Click on One Function if your dataset only consists of data of one type, for example a dataset with only buildings or only roads. If you have a file like we do with an office, road, parking space and building, choose Function Mapping.
  2. Choose first the default function by clicking on Select. For this tutorial we choose as default function a function in the category Offices.
  3. Then make sure the drop down menu is on Name and click on Add. Now click on the button Values. Based on the data in the column Type, you can select a function. Select for example Park, click on Select (the screen closes) en click again on the button Select. Choose from the Function list a park function.
  4. Repeat the steps for the attributes Parkeerplaats and Weg. We are now creating a mapping based on an attribute value. We do not have to create a mapping for every attribute, since we have set a default function. Thus if we had another feature in our data with the attribute value of School and we did not create a mapping for it, it would become an Office, since we set that as default function.
  5. Click on Next. In step 8 we can also create a mapping for the Stakeholders. For example, we can assign the roads, park and parking space to the municipality and the office to the company stakeholder. The mapping is done in the same way as step 7. Create a mapping with at least two stakeholders.
  6. Finish the wizard.
  7. Notice the new buildings are now in the 3D model

Extra Assignment

  1. Import the other dataset (bomen) by repeating the previous steps (1,2 and 3).
  2. In step 2 view features of the wizard, notice that there are 10 points in the datset and 0 lines or polygons. In the Engine it is only possible to upload polygons. Therefore, we can buffer the points to create (round polygons) for the trees. Set the buffer size on 1, so as not to create very large trunks and follow the rest of the wizard.
  3. How would you do the mapping in step 7? As One Function or Function Mapping?
  4. After finishing the wizard, notice the new trees in the spatial plan area.