Template Project tutorial
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 Project 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 Project Templates 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 {[software}}, the term Template is commonly used to mean Project Template.
Creating a Project Template
A Project Template is always a Project which has been assigned the status of a Project Template. 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 Project Template can be created.
In the Main Menu, select the option to 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 Project Template. 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.
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):
- There is no background satellite map.
- There are no buildings in the map.
- There is only one Stakeholder.
- There is only one Neighborhood, named generically.
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 Project Template.
Add an Overlay to the Project, specifically an Average Overlay:
- 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.
Save the Project and exit the Editor. This will close the application.
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.
Find the Project previously created in the list of Projects, and check the "Template" option. This has the following effects:
- The Project can now be selected as a Project Template for the creation of new Projects at the start of the New Project Wizard.
- The access rights for the Project are capped at READ. Any rights set to WRITE are set to READ instead. Any rights set to READ or NONE remain unchanged.
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.
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.
Click on the button to start the creation process. The data for the location will be loaded in 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:
- There are Buildings, more Stakeholders, and a satellite image in this Project.
- There are one or more Neighborhood(s) in this Project.
- There is an Overlay named "Green Locations".
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.
From these observations, the following can be concluded:
- Geographical data, such as Neighborhoods, are not carried over from a Project Template to the new Project.
- Non-geographical data, such as the definitions of Overlays, are carried over from the Project Template to the new Project.
- When creating a new Project based on a Project Template, geographical data of the new location is loaded in as expected.
Creating a Project Template based on existing Projects
Tutorial completed
Congratulations. You have now completed this tutorial. In it, you have learned how to create and configure Project Templates.