Template Project tutorial

From Tygron Support wiki
Revision as of 15:37, 3 November 2022 by Rudolf@tygron.nl (talk | contribs) (Rudolf@tygron.nl moved page Template Project Tutorial to Template Project tutorial without leaving a redirect: Consistency in capitalization)
Jump to navigation Jump to search

Prerequisites

The following prerequisites should be met before starting this tutorial:

  • This tutorial can be started based on any arbitrary Project in the Netherlands, however it is assumed that a new Project is created to start off with. Note that multiple new Projects will be created during this tutorial.
  • To work with Project templating functionality fully (specifically, to assign Template status to a Project), either Domain Admin access rights are required, or the assistance of a Domain Admin for your organisation is required. 

Preparations

Take the following steps as preparation for following this tutorial:

  • Start the Tygron Platform application, and if necessary log in so you are in the main menu.

Introduction to Templates

The Tygron Platform allows for the creation of multiple Projects, each intended to fulfill some use-case for the end-user. Any Project is generally composed of two types of content:

  • Data pertaining to the relevant location
  • Calculation models for analyzing such data and presenting results.

Generally, organisations have certain specialized knowledge of specific fields which they apply in repeated (and sometimes tailored) fashion to multiple situations, plans, or locations. In terms of the Tygron Platform, this would mean that the data may change, but the calculations models stay the same.

This is the functionality which Template Projects offer. For any given Project, it is possible to apply it as a Template to a new location. This will apply the calculation models as they were configured to the (new) data of the newly selected location, allowed for quicker, repeated, reproducible and comparable analyses of different project sites.

In common vernacular related to the Tygron Platform, the term Template is commonly used to mean Template Project.

Creating a Template Project

A Template Project is always a Project which has been assigned the status of a Template Project. To create one, the first step is always to have a Project upon which to base one. A common approach is to select a Project in which calculation models are already available, to copy it, and to modify it to be generically applicable. Instead, for the purpose of this tutorial, it is recommended to create a new Project based on which a Template Project can be created.

Setting up a Project

First, a Project must be created which can be turned into an applicable Template Project.

In the Main Menu, select the option to create a new Project.

Create a new Project.

Enter a name for your Template, as well as project details such as language and currency. Note that the project details selected here will be an immutable part of your Template Project.

Enter data for a new Project.

Continue to the location selection screen.

In the location selection screen, rather than selecting a specific location, set the size to the smallest option available, and select the option for generating an empty map.

"Location" settings for a new Project to create a Template with.

Click on the button to start the creation process. The data-importing loading screen will be skipped, and the application will immediately begin loading the editor interface.

When the editor has loaded, notice the following about the data in this Project (by virtue of having opted for an empty Project):

As a Project for calculations, this Project contains nothing of particular use. But because it is so empty it serves as a clean base for a Template Project.

Add an Overlay to the Project, specifically an Average Overlay:

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → Distance Group, then Average Overlay (Dropdown)
  • Name the Average Overlay "Green Locations".
  • Set the Cell Averaging Distance of the Average Overlay to 25.
  • Set the targeted Attribute of the Average Overlay to GREEN_M2.
  • Recalculate the Overlay by clicking "Update now".
Settings for a simple Green Overlay.

Save the Project and exit the Editor. This will close the application.

Creating and using a Template Project

Restart the application, and log in if applicable so that the main menu is presented.

Proceed to "Options", and then to "Projects". Note that this option is only available to Domain Admins.

The Projects overview option in the Options menu.

Find the Project previously created in the list of Projects, and check the "Template" option. This has the following effects:

When this checkbox is checked, the Project is marked as available for use as a Template Project.

Return to the main menu, and again select the option to create a new Project.

Enter a name for your Project, and select the option to use an existing Template.

In the dropdown for the Template, find the Project you created earlier and marked as a template, and select it.

Setting for a new Project based on a Template.

Continue to the location selection screen.

Select any location in the Netherlands, which features some amount of land. Any urban environment is sufficient. Keep the size of the project area small, as it is not necessary to have a large project area for the demonstration of the functionality.

Location settings for the new Project, which will be based on a Template Project.

Click on the button to start the creation process. The data for the location will be collected which will take a few moments. Afterwards, the editor proper will be loaded.

In the now created Project, notice the following about the data in the Project:

Select the "Green Locations" Overlay. Notice the Overlay matches the configuration that was set up earlier, and that it immediately functions to highlight the presence of green locations through the GREEN_M2 attribute.

Computed Green Overlay in the new Project.

From these observations, the following can be concluded:

Emptying a Project to create Template Project

Although geographical data is automatically removed when a Template Project is used to create a new Project, the less data exists in a Template Project, the better. When applying a Template Project, it is started as a Project in full, duplicated, and emptied. This means all data which is part of the Template Project, even if it does not carry over to the new Project, must be processed before the new Project is created. For this reason, building a Template Project from the ground up is best done starting with an empty Project. However, a Project can also be emptied explicitly so that it is lighter and more performant as a Template Project.

In the editor, still in the Project with real world data, go to:

Editor → Tools (Ribbon tab) → Template (Ribbon bar)
The ribbon option where the Template Settings can be found.

The Template Settings window will open.

The Template Settings, which allows configuring the default "Advanced Options".

In this window, it is possible to change the Advanced Options which are selected by default in the New Project Wizard. Any settings changed during the New Project Wizard are reflected here, and any settings changed here are reflected in the New Project Wizard. For example, setting the DEM resolution higher in this overview means that, by default, when this Project is used as a Template Project to create a new Project, the DEM resolution is set to that higher level, unless the user explicitly changes that setting in the Advanced Options of the New Project Wizard.

Find the "Clear Map" option at the bottom of the window. Click it, and read and approve all the resulting confirmation prompts.

The clear map option removes geographical data.

Notice that the 3D World is cleared of all geographical data, making the Project more closely resemble the empty Project setup.

Because this was only for the sake of demonstration, close the Project without saving.

Editing a Template Project

Restart the application, and log in if applicable so that the main menu is presented.

Select the option to edit an existing Project.

Select the Project created at the start of the tutorial, which was set to function as a Template Project.

When the editor proper has loaded, open the "File" menu, and take note of the permissions. As stated earlier, when the Project was set to function as a Template the permissions were automatically capped at "READ". This means the Project can be started, but cannot be saved. In order to edit the Project and allow the saving of any changes, the applicable rights must be set to "WRITE".

Permission for the Project after setting it as a Template.

Change the rights for the owner to "WRITE".

Changed permissions so the Project can be edited and saved.

The Project can now be saved again. However, it is recommended to set the rights of the Project back to "READ" again after all desired changes have been made and saved. Normally, when a Project is opened in the Editor, it is not possible to start a second Editing Session for the same Project at the same time, which means it also cannot be used to create a new Project with until the running Editing Session is closed. A Project which is set entirely to be read-only can have multiple Editing Sessions running in parallel, thus allowing it to be used as a Template Project for the creation of a new Project while the Editing Session is still running.

Assignments

These assignments serve as small experiments to get a better sense of the data which carries over from a Template Project to a new Project.

  1. Make the following changes to the Project:
  2. Now save the Project and close it.
  3. Create a new Project based on the Template Project with read data, and check all the Items listed above.
  4. In this new Project, make the following changes:
  5. Create a new Project, based on the new Template Project with real data, and check all Items listed above again.

Tutorial completed

Congratulations. You have now completed this tutorial. In it, you have learned how to create and configure Template Projects. The next tutorial in this series is Geo Plugins, which will provide more knowledge about Geo Plugins, and how to automatically add additional data to a Project created via a Template Project..