Geo Data Wizard: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
Line 16: Line 16:


Each of these wizards contain comparable steps which are described below.
Each of these wizards contain comparable steps which are described below.
==When to use your own data==
You need the Data Wizard when you want to import data in the {{software}}. This may be for a number of reasons:
* The project takes place in a location for which there are no data sources available to create the project
* The default data sources are not accurate or up-to-date enough
* The default datasets are not detailed enough
* To do a more extendend analysis in the {{software}}
* To use in combination with an Excel Indicator or Panel
* For creating more overview in your project, for example by highlighting areas
In these situations, data in the {{software}} can be overwritten or supplemented by the user.
==Which data can be uploaded to the {{software}}==
Almost all data can be imported in the {{software}}, as long as the data is about a specific location and has a geometry. Thus basically when the data is geo data.
This means that also [[Spatial plans|spatial plans]] can be imported in the {{software}}.
==Requirements on Geo Data==
There are several requirements for loading in [[GEO_Data|Geo data]]. The Data Wizard helps you to transform your data to the proper format for importing.
# Geo Data in the {{software}} are always polygons. Line and point features are not allowed by the {{software}}. The wizards helps you by buffering the line and point features to polygons.
# All desired attributes must be numerical, so that they can be loaded as valid [[attribute]] values. Non-numeric attributes are ignored when attempting to load them as attributes.


==How to import Geo Data==
==How to import Geo Data==
Line 45: Line 26:
If you have an URL on where dats is published according to the WFS standard, choose the second option: [[WFS]].
If you have an URL on where dats is published according to the WFS standard, choose the second option: [[WFS]].
If you do not have data available but want to browse through an online catalogue in search for datasets or you have a Catalogue service URL, choose the third option: [[CSW]].
If you do not have data available but want to browse through an online catalogue in search for datasets or you have a Catalogue service URL, choose the third option: [[CSW]].
It is also possible to import a [[WMS|Web Map Service (WMS)]]. Read the section how to import data from a WMS.


==Steps in the Geo Data Wizard==
==Steps in the Geo Data Wizard==

Revision as of 15:09, 29 April 2019

Please note: This page is currently being updated.

Template:Learned

The Geo Data Wizard

The Geo Data Wizard or in short Data Wizard is a series of steps to guide you through the process of importing Geo data in the Tygron Platform. Start the Geo Data Wizard by clicking in the Editor on Geo import. Template:Editor ribbon

There are several different Data Wizards which each guide you through different processes for importing Geo data in the Tygron Platform. The different wizards are for importing data as:

  • Buildings - Importing Constructions (3D-objects) into the model and for updating attributes of Constructions based on the attributes in the data
  • Terrain - Importing shapes to define the terrain
  • Neighborhoods - Importing shapes to define the neighborhoods
  • Zoning - Importing Zones in the Zoning plan (Bestemmingsplan)
  • Areas - Importing areas to create a 2D Overlay
  • Measures - Importing a group of 3D-objects as a measure to perform as an action

Each of these wizards contain comparable steps which are described below.

How to import Geo Data

There are three methods for importing Geo Data in the data wizard. These methods can be divided into two: uploading data from a file to the Tygron Platform and the other is downloading data through an URL to the Tygron Platform.

  1. Through a GeoJSON file
  2. Through a Web Feature Service (WFS)
  3. Through a Catalogue Service for the Web (CSW)

The method to choose is based on how you have your data available. If you have a file with data, choose the first option. Make sure you create the GeoJSON file first, if your data is in another format. If you have an URL on where dats is published according to the WFS standard, choose the second option: WFS. If you do not have data available but want to browse through an online catalogue in search for datasets or you have a Catalogue service URL, choose the third option: CSW.

Steps in the Geo Data Wizard

The Geo Data Wizard is designed to minimalise the use of a GIS. In the data wizards there are several steps to guide you in transforming your dataset in order for only loading in the relevant features in the data in the Tygron Platform.

View

In step 2, the data that is currently in your project in the Tygron Platform is visible. The amount of points, lines or polygons in the dataset are visible. Since only polygons are allowed in the Tygron Platform, the points and lines need to be buffered. By buffering these features, the points and lines become polygons. The buffer size is adjustable. Based on the data, choose a realistic buffer size. If your dataset contains of lines which represent roads, choose a buffer size that is realistic for the width of these roads. if your dataset consists of only polygons, the buffer size is not used.

Filter

In the next step you can filter the features. For example, if you have a dataset containing all sorts of roads, you can filter only the highways in this dataset. The filtering is based on Attribute name ( attribute textual value) or on Attribute value(a numerical condition). For example, if the roads have an attribute max. speed in km/h. You can filter the roads that have a max. speed of 80 or more km/h to get only the highways.

Add or update

In this step you are asked whether you want to add new data or update the data already present in your project. This is based on the type of data and how you are adding the data, as either constructions or areas. If you want to import the roads dataset as functions while there are already roads present in the project, updating would be the way to go.

Select attributes

As mentioned in the requirements for importing geo data in the Tygron Platform, only numerical attributes can be imported. In this screen all the attributes in the dataset are listed. The attributes that are numerical, are already checked. In the TQL Name column, you are given the option to rename your attribute.

Name the features

If you choose to add new features, the Naming step will be visible. This step is necessary to keep track of the data you imported in the Tygron Platform. With a clever chosen name, it is easy to distinguish features from each other. There are three options for naming your features:

  1. By their file name
  2. Based on an attribute
  3. A word with a number

Assign functions

If you choose the Geo Data wizard for:

  • Buildings
  • Measures

you will be asked to choose a function for the features in your dataset. You can choose one function or choose multiple, based on an attribute name or an attribute value. The latter option is necessary when you have multiple different functions in your file, such as trees and roads.

Assign stakeholders

Choose the owner of the features you want to import. Also, multiple owners can be chosen, based on a mapping of attribute names or attribute values.

Error messages in the Geo Data Wizard

Errors when importing data most of the time have to do with no CRS (Coordinate Reference System) or the wrong CRS definition.

  • No CRS defined
"Invalid detected CRS name: null" 

Error: This error message means that the dataset you are trying to import does not have a CRS (Coordinate Reference System) and therefore the Tygron Platform can't place the data on the right location. This error occurs mostly when having a GeoJSON file without a CRS property defined.
Solution: Open the GeoJSON file in a GIS and save it with the correct CRS, so the property is added.

  • The imported data does not have a location anywhere in your project
"Detected CRS: urn:ogc:def:crs:EPSG:3857 Numer of Features in this project map: 0" (or something similar)

Error: Geo data always has a location in the real world. This error message means that the dataset you are trying to import does not have a location in your project. For example if you have a project of an area in Amsterdam and you are trying to import data of neighborhoods in the Hague, you will get this error message. If you are sure that the data you are trying to import is in the same location (for example data of neighborhoods in Amsterdam into a Tygron Platform project in one of these neighborhoods in Amsterdam), the error message could also mean that the defined CRS is not correct for the data.
Solution: Import data that has a location in your project or if you are sure that the data you are trying to import is in the same location, open the GeoJSON file in a GIS and save it with the correct CRS.

  • Longitude and Latitude error
"Invalid:um:ogc:def:crs:OGC:1.3:CRS84 Coordinates: Latitude 393 44.4'N is too close to a pole" (or something similar)

Error: This can happen when importing a dataset in the WGS84 Coordinate Reference System (CRS) and means that the data can not be correctly imported by the Tygron Platform.
Solution: Try transforming the data in a GIS to a different CRS.