Geo Plugins tutorial - Revision history

Maxim@tygron.com at 06:48, 9 July 2026

2026-07-09T06:48:43Z

← Older revision		Revision as of 06:48, 9 July 2026
Line 431:		Line 431:
	The way the [[Geo Link]] is set up now it will load in the features it finds as trees. However, trees have a couple of special properties in the {{software}} which the original dataset may not take into account. A [[Geo Link]] can be configured to bridge that difference.		The way the [[Geo Link]] is set up now it will load in the features it finds as trees. However, trees have a couple of special properties in the {{software}} which the original dataset may not take into account. A [[Geo Link]] can be configured to bridge that difference.

	Set the "Geometry" option of the [[Geo Link]] to ~~[[radius centerpoint (Geo Link)\|~~RADIUS_CENTERPOINT]].		Set the "Geometry" option of the [[Geo Link]] to RADIUS_CENTERPOINT.

	[[File:GeoPluginTutorial-geolink-trees-general.jpg\|650px\|thumb\|center\|.]]		[[File:GeoPluginTutorial-geolink-trees-general.jpg\|650px\|thumb\|center\|.]]

Maxim@tygron.com at 08:05, 8 July 2026

2026-07-08T08:05:53Z

← Older revision		Revision as of 08:05, 8 July 2026
Line 310:		Line 310:
	[[File:GeoPluginTutorial-geoshare-viewer-wfs.jpg\|350px\|thumb\|center\|The WFS Link of the viewer.]]		[[File:GeoPluginTutorial-geoshare-viewer-wfs.jpg\|350px\|thumb\|center\|The WFS Link of the viewer.]]

	A web browser (or new tab in the web browser) will open for the WFS which related to the viewer and its contents (and thus also the ~~geojson~~ file). Copy the address of the page which is open in the web browser.		A web browser (or new tab in the web browser) will open for the WFS which related to the viewer and its contents (and thus also the GeoJSON file). Copy the address of the page which is open in the web browser.

	[[File:GeoPluginTutorial-geoshare-wfs-url.jpg\|350px\|thumb\|center\|In the web browser the url of the WFS can be selected and copied.]]		[[File:GeoPluginTutorial-geoshare-wfs-url.jpg\|350px\|thumb\|center\|In the web browser the url of the WFS can be selected and copied.]]

Maxim@tygron.com at 08:38, 2 July 2026

2026-07-02T08:38:41Z

← Older revision		Revision as of 08:38, 2 July 2026
Line 403:		Line 403:
	Add a new [[Geo Plugin]] for BUILDINGS.		Add a new [[Geo Plugin]] for BUILDINGS.

	Set the name of the [[Geo Plugin]] "Trees".		Set the name of the [[Geo Plugin]] to "Trees".

	[[File:GeoPluginTutorial-geoplugin-trees-name.jpg\|350px\|thumb\|center\|.]]		[[File:GeoPluginTutorial-geoplugin-trees-name.jpg\|350px\|thumb\|center\|.]]
Line 492:		Line 492:
	[[File:GeoPluginTutorial-trees-shape.jpg\|650px\|thumb\|center\|The polygons of the trees, highlighted by blue indication lines.]]		[[File:GeoPluginTutorial-trees-shape.jpg\|650px\|thumb\|center\|The polygons of the trees, highlighted by blue indication lines.]]

	In the right panel, switch to the "Details" tab to see the [[Building]]'s [[Function Value]]s, en select the "CONSTRUCTION" filter. Notice the [[Floor height m (Function Value)\|Floor Height M Function Value]] value is red (indicating it has a non-default value) matching the value which was set in the data these trees were based on.		In the right panel, switch to the "Details" tab to see the [[Building]]'s [[Function Value]]s, and select the "CONSTRUCTION" filter. Notice the [[Floor height m (Function Value)\|Floor Height M Function Value]] value is red (indicating it has a non-default value) matching the value which was set in the data these trees were based on.

	[[File:GeoPluginTutorial-trees-details.jpg\|650px\|thumb\|center\|The [[Floor height m (Function Value)\|Floor Height M Function Value]] is set to a specific value.]]		[[File:GeoPluginTutorial-trees-details.jpg\|650px\|thumb\|center\|The [[Floor height m (Function Value)\|Floor Height M Function Value]] is set to a specific value.]]

Maxim@tygron.com at 08:37, 2 July 2026

2026-07-02T08:37:18Z

Maxim@tygron.com at 07:31, 2 July 2026

2026-07-02T07:31:52Z

← Older revision		Revision as of 07:31, 2 July 2026
Line 40:		Line 40:

	{{page break}}		{{page break}}
	Opt to export the created [[Area]]s as a [[GeoJSON]] to the [[~~Geo Share~~]]. This will create a small file in your [[Domain]]'s [[~~Geo Share~~]] space, which can be used as a source for geo data.		Opt to export the created [[Area]]s as a [[GeoJSON]] to the [[GeoShare]]. This will create a small file in your [[Domain]]'s [[GeoShare]] space, which can be used as a source for geo data.
	[[File:GeoPluginTutorial-prep-geoshare.jpg\|650px\|thumb\|center\|The [[~~Geo Share~~]] now has a file for the [[Area]]s exported from this [[Project]].]]		[[File:GeoPluginTutorial-prep-geoshare.jpg\|650px\|thumb\|center\|The [[GeoShare]] now has a file for the [[Area]]s exported from this [[Project]].]]

	The file on the [[~~Geo Share~~]] now exists separately from the [[Project]] and [[Session]] it originated from. This file will be used a few times further in the tutorial.		The file on the [[GeoShare]] now exists separately from the [[Project]] and [[Session]] it originated from. This file will be used a few times further in the tutorial.
	}}		}}

Line 54:		Line 54:
	One of the most important benefits of [[Geo Plugin]]s is the ability to define a mapping between data in a data source, and the various [[Function]]s available in the {{software}}. The benefit of this is that the details of how such an import is to be configured is reproducibly prepared.		One of the most important benefits of [[Geo Plugin]]s is the ability to define a mapping between data in a data source, and the various [[Function]]s available in the {{software}}. The benefit of this is that the details of how such an import is to be configured is reproducibly prepared.

	Such a Geo Plugin can then be used while importing mapped data ([[Building]]s and/or [[Measure]]s), such as the dataset created earlier, and saved to the [[~~Geo Share~~]].		Such a Geo Plugin can then be used while importing mapped data ([[Building]]s and/or [[Measure]]s), such as the dataset created earlier, and saved to the [[GeoShare]].

	===Geo Plugin for Buildings===		===Geo Plugin for Buildings===
Line 130:		Line 130:

	{{page break}}		{{page break}}
	Select the file which was created earlier and stored on the [[~~Geo Share~~]]. It should be easily parsed and recognize 3 features.		Select the file which was created earlier and stored on the [[GeoShare]]. It should be easily parsed and recognize 3 features.

	[[File:GeoPluginTutorial-import-file-selected.jpg\|650px\|thumb\|center\|Select the file on the [[GeoShare]] which was prepared for the tutorial.]]		[[File:GeoPluginTutorial-import-file-selected.jpg\|650px\|thumb\|center\|Select the file on the [[GeoShare]] which was prepared for the tutorial.]]
Line 266:		Line 266:

	===Template with a Geo Plugin for GeoShare===		===Template with a Geo Plugin for GeoShare===
	Data on the [[GeoShare]] can be automatically added to a [[Project]] at [[Project generation]] as well. To do this, the [[Geo Plugin]] requires a configuration of a related [[Project Source]], in a similar fashion as a [[WFS]]. A new [[Project Source]] definition must be created for the dataset which is currently present on the [[~~Geo Share~~]], and that [[Project Source]] can then be referenced by the [[Geo Plugin]].		Data on the [[GeoShare]] can be automatically added to a [[Project]] at [[Project generation]] as well. To do this, the [[Geo Plugin]] requires a configuration of a related [[Project Source]], in a similar fashion as a [[WFS]]. A new [[Project Source]] definition must be created for the dataset which is currently present on the [[GeoShare]], and that [[Project Source]] can then be referenced by the [[Geo Plugin]].

	First, the file on the [[GeoShare]] must be made available as a [[WFS]] . This can be done by creating a [[GeoShare Viewer]] for the file.		First, the file on the [[GeoShare]] must be made available as a [[WFS]] . This can be done by creating a [[GeoShare Viewer]] for the file.
Line 278:		Line 278:
	[[File:GeoPluginTutorial-geoshare-file.jpg\|350px\|thumb\|center\|The GeoShare with the previously created file already uploaded.]]		[[File:GeoPluginTutorial-geoshare-file.jpg\|350px\|thumb\|center\|The GeoShare with the previously created file already uploaded.]]

	In the bottom of the [[~~Geo Share~~]] window, click on "Add Viewer".		In the bottom of the [[GeoShare]] window, click on "Add Viewer".

	[[File:GeoPluginTutorial-geoshare-viewer-add.jpg\|350px\|thumb\|center\|Add a viewer to the GeoShare.]]		[[File:GeoPluginTutorial-geoshare-viewer-add.jpg\|350px\|thumb\|center\|Add a viewer to the GeoShare.]]
Line 293:		Line 293:
	Select the file created earlier, and confirm. Then, opt to not add any additional layers to the [[GeoShare Viewer]].		Select the file created earlier, and confirm. Then, opt to not add any additional layers to the [[GeoShare Viewer]].

	A new viewer is now added to the [[~~Geo Share~~]], named "geoplugin tutorial viewer".		A new viewer is now added to the [[GeoShare]], named "geoplugin tutorial viewer".

	[[File:GeoPluginTutorial-geoshare-viewer-added.jpg\|350px\|thumb\|center\|There is now a viewer in the GeoShare.]]		[[File:GeoPluginTutorial-geoshare-viewer-added.jpg\|350px\|thumb\|center\|There is now a viewer in the GeoShare.]]

Maxim@tygron.com at 15:53, 9 June 2026

2026-06-09T15:53:42Z

← Older revision		Revision as of 15:53, 9 June 2026
Line 8:		Line 8:
	Any [[Project]] may contain any number of [[Geo Plugin]]s. However, for the purpose of this tutorial a [[Project]] in a specific location is required, due to some of the steps relying on a data source which has data only in a specific region.		Any [[Project]] may contain any number of [[Geo Plugin]]s. However, for the purpose of this tutorial a [[Project]] in a specific location is required, due to some of the steps relying on a data source which has data only in a specific region.

	Find an open spot in the [[project ~~area~~]] using the [[3D Visualization]].		Find an open spot in the [[project map]] using the [[3D Visualization]].
	[[File:GeoPluginTutorial-prep-open-spot.jpg\|650px\|thumb\|center\|An open spot.]]		[[File:GeoPluginTutorial-prep-open-spot.jpg\|650px\|thumb\|center\|An open spot.]]

Frank@tygron.nl at 14:07, 6 March 2026

2026-03-06T14:07:11Z

← Older revision		Revision as of 14:07, 6 March 2026
Line 291:		Line 291:
	[[File:GeoPluginTutorial-geoshare-viewer-file.jpg\|350px\|thumb\|center\|select the desired file to include in the viewer.]]		[[File:GeoPluginTutorial-geoshare-viewer-file.jpg\|350px\|thumb\|center\|select the desired file to include in the viewer.]]

	Select the file created earlier, and confirm. Then, opt to not add any additional layers to the [[~~Geoshare~~ Viewer]].		Select the file created earlier, and confirm. Then, opt to not add any additional layers to the [[GeoShare Viewer]].

	A new viewer is now added to the [[Geo Share]], named "geoplugin tutorial viewer".		A new viewer is now added to the [[Geo Share]], named "geoplugin tutorial viewer".

Frank@tygron.nl: /* Template with a Geo Plugin for GeoShare */

2026-03-06T14:06:39Z

Template with a Geo Plugin for GeoShare

← Older revision		Revision as of 14:06, 6 March 2026
Line 287:		Line 287:
	[[File:GeoPluginTutorial-geoshare-viewer-name.jpg\|350px\|thumb\|center\|Enter a name for the viewer.]]		[[File:GeoPluginTutorial-geoshare-viewer-name.jpg\|350px\|thumb\|center\|Enter a name for the viewer.]]

	A prompt will appear allowing the selection of a file to be included in the [[~~Geoshare~~ Viewer]].		A prompt will appear allowing the selection of a file to be included in the [[GeoShare Viewer]].

	[[File:GeoPluginTutorial-geoshare-viewer-file.jpg\|350px\|thumb\|center\|select the desired file to include in the viewer.]]		[[File:GeoPluginTutorial-geoshare-viewer-file.jpg\|350px\|thumb\|center\|select the desired file to include in the viewer.]]

Rudolf@tygron.nl: /* Using a Template with multiple Geo Plugins */

2023-10-31T15:06:17Z

Using a Template with multiple Geo Plugins

← Older revision		Revision as of 15:06, 31 October 2023
Line 492:		Line 492:
	[[File:GeoPluginTutorial-trees-shape.jpg\|650px\|thumb\|center\|The polygons of the trees, highlighted by blue indication lines.]]		[[File:GeoPluginTutorial-trees-shape.jpg\|650px\|thumb\|center\|The polygons of the trees, highlighted by blue indication lines.]]

	~~{{page break}}~~
	In the right panel, switch to the "Details" tab to see the [[Building]]'s [[Function Value]]s, en select the "CONSTRUCTION" filter. Notice the [[Floor height m (Function Value)\|Floor Height M Function Value]] value is red (indicating it has a non-default value) matching the value which was set in the data these trees were based on.		In the right panel, switch to the "Details" tab to see the [[Building]]'s [[Function Value]]s, en select the "CONSTRUCTION" filter. Notice the [[Floor height m (Function Value)\|Floor Height M Function Value]] value is red (indicating it has a non-default value) matching the value which was set in the data these trees were based on.

Rudolf@tygron.nl at 15:03, 31 October 2023

2023-10-31T15:03:32Z

← Older revision		Revision as of 15:03, 31 October 2023
Line 454:		Line 454:

	: ''Note that you may have to set the editing rights to "WRITE" before you can save the changes. If this is the case, set the editing rights to "WRITE", then save the [[Project]], and then set the editing rights back to "READ".''		: ''Note that you may have to set the editing rights to "WRITE" before you can save the changes. If this is the case, set the editing rights to "WRITE", then save the [[Project]], and then set the editing rights back to "READ".''

			[[File:GeoPluginTutorial-permissions.jpg\|650px\|thumb\|center\|If all rights are set to READ, set the rights for the owner to WRITE, then save, then set the rights back to READ again.]]

	Exit the [[Project]]. As the [[Project]] has just been explicitly saved, the [[Project]] does not need to be saved on close again.		Exit the [[Project]]. As the [[Project]] has just been explicitly saved, the [[Project]] does not need to be saved on close again.
Line 459:		Line 461:
	Restart the {{software}} application.		Restart the {{software}} application.

	~~{{page break}}~~
	In the main menu, opt to create a new [[Project]] and select the [[Template Project]] created so far.		In the main menu, opt to create a new [[Project]] and select the [[Template Project]] created so far.

	[[File:GeoPluginTutorial-newproject-template.jpg\|650px\|thumb\|center\|.]]		[[File:GeoPluginTutorial-newproject-template.jpg\|650px\|thumb\|center\|.]]

			{{page break}}
	In the location selection screen, place the location selection on approximately the same location as the [[Template Project]] is on. Of importance is to have it at least cover the area where the dataset was created earlier.		In the location selection screen, place the location selection on approximately the same location as the [[Template Project]] is on. Of importance is to have it at least cover the area where the dataset was created earlier.

	[[File:GeoPluginTutorial-location3.jpg\|650px\|thumb\|center\|.]]		[[File:GeoPluginTutorial-location3.jpg\|650px\|thumb\|center\|.]]

	~~{{page break}}~~
	Open the "Advanced Options" panel.		Open the "Advanced Options" panel.

Line 475:		Line 476:
	[[File:GeoPluginTutorial-advanced-option-geoplugin-trees.jpg\|650px\|thumb\|center\|.]]		[[File:GeoPluginTutorial-advanced-option-geoplugin-trees.jpg\|650px\|thumb\|center\|.]]

			{{page break}}
	Start the map creation process.		Start the map creation process.

← Older revision		Revision as of 08:37, 2 July 2026
Line 47:		Line 47:

	==Introduction to Geo Plugins==		==Introduction to Geo Plugins==
	The {{software}} allows for the importing of geo data to enrich a [[Project]]. This can serve to ~~both~~ amend data which the {{software}} already supplies, but also to add types of data which are unique to the use-case at hand. When importing data, almost all of the related operations are to determine precisely how the imported data relates to the potential data types and subtypes available in a {{software}} [[Project]].		The {{software}} allows for the importing of geo data to enrich a [[Project]]. This can serve not only to amend data which the {{software}} already supplies, but also to add types of data which are unique to the use-case at hand. When importing data, almost all of the related operations are to determine precisely how the imported data relates to the potential data types and subtypes available in a {{software}} [[Project]].

	[[Geo Plugin]]s offer a way to store such a mapping, so that import operations can be easily repeated. In them, information is stored about which data can be found in the relevant data source, and how that data should be interpreted or modified when it is imported. They can then be used when manually importing data, but can also be called upon when a new Project is created to automatically obtain data relevant for the use-case and models the [[Template Project]] entails.		[[Geo Plugin]]s offer a way to store such a mapping, so that import operations can be easily repeated. In them, information is stored about which data can be found in the relevant data source, and how that data should be interpreted or modified when it is imported. They can then be used when manually importing data, but can also be called upon when a new Project is created to automatically obtain data relevant for the use-case and models the [[Template Project]] entails.

	==Using the Geo Import Wizard with a Geo Plugin==		==Using the Geo Import Wizard with a Geo Plugin==
	One of the most important benefits of [[Geo Plugin]]s is the ability to define a mapping between data in a data source, and the various [[Function]]s available in the {{software}}. The benefit of this is that the details of how such an import is to be configured is reproducibly prepared.		One of the most important benefits of [[Geo Plugin]]s is the ability to define a mapping between data in a data source, and the various [[Function]]s available in the {{software}}. The benefit of this is that the details of how such an import is to be configured are reproducibly prepared.

	Such a Geo Plugin can then be used while importing mapped data ([[Building]]s and/or [[Measure]]s), such as the dataset created earlier, and saved to the [[GeoShare]].		Such a Geo Plugin can then be used while importing mapped data ([[Building]]s and/or [[Measure]]s), such as the dataset created earlier, and saved to the [[GeoShare]].
Line 70:		Line 70:
	[[File:GeoPluginTutorial-geoplugin-name-buildings.jpg\|350px\|thumb\|center\|Name for the [[Geo Plugin]].]]		[[File:GeoPluginTutorial-geoplugin-name-buildings.jpg\|350px\|thumb\|center\|Name for the [[Geo Plugin]].]]

	In the right panel, select the GeoLinks tab		In the right panel, select the GeoLinks tab.

	[[File:GeoPluginTutorial-geoplugin-geolinks-tab.jpg\|350px\|thumb\|center\|The GeoLinks tab. A [[Geo Plugin]] starts without any specific [[Geo Link]]s.]]		[[File:GeoPluginTutorial-geoplugin-geolinks-tab.jpg\|350px\|thumb\|center\|The GeoLinks tab. A [[Geo Plugin]] starts without any specific [[Geo Link]]s.]]

	At the bottom of the right panel click on "Add" to create a [[Geo Link]].		At the bottom of the right panel, click on "Add" to create a [[Geo Link]].

	[[File:GeoPluginTutorial-geolink-add.jpg\|350px\|thumb\|center\|Add a Geo Link.]]		[[File:GeoPluginTutorial-geolink-add.jpg\|350px\|thumb\|center\|Add a Geo Link.]]
Line 147:		Line 147:
	[[File:GeoPluginTutorial-buildings-imported.jpg\|650px\|thumb\|center\|The buildings are now imported into the [[3D Visualization]].]]		[[File:GeoPluginTutorial-buildings-imported.jpg\|650px\|thumb\|center\|The buildings are now imported into the [[3D Visualization]].]]

	Notice that although there are 3 features in the dataset, only 2 features are loaded in. This is because the [[Geo Plugin]] has a few [[Geo Link]] which the features can match with, and 1 of the features is not matched by any of the [[Geo Link]]s. Contrary to how the [[Geo Data Wizard]]'s manual mapping options structurally defines a default [[Function]] for any unmatched features, an import with a [[Geo Plugin]] will ignore features which are not matched by any of the [[Geo Link]]s.		Notice that although there are 3 features in the dataset, only 2 features are loaded in. This is because the [[Geo Plugin]] has a few [[Geo Link]]s which the features can match with, and 1 of the features is not matched by any of the [[Geo Link]]s. Contrary to how the [[Geo Data Wizard]]'s manual mapping options structurally defines a default [[Function]] for any unmatched features, an import with a [[Geo Plugin]] will ignore features which are not matched by any of the [[Geo Link]]s.

	{{page break}}		{{page break}}