How to configure a default legend for GeoTIFFs on the Geoshare

From Tygron Support wiki
Jump to navigation Jump to search

GeoTIFF data on the Geoshare can easily be imported into Projects, and made available through a GeoTiff Overlay. To then properly interpret the data, the GeoTiff Overlay should have an appropriately configured Legend. Rather than relying on the manual configuration of a Legend in the individual Projects where the data is included, it is possible to add the definition of a Legend to the metadata of GeoTiff, so that the Tygron Platform can automatically configure an appropriate Legend directly when importing the data.

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → The Overlay to edit (Left panel) → Legend tab (Right panel)
How to configure a default legend for a GeoTIFF:
  1. Ensure the full GeoTIFF file is available as a local file on your computer.
  2. Import the GeoTIFF file into a Project, displaying the data in a GeoTiff Overlay.
  3. Configure the Legend of the GeoTiff Overlay until it matches the desired Legend which should be associated with the full GeoTIFF file.
  4. Use "Export Grid Data" on the GeoTiff Overlay.
  5. Find the file downloaded in windows explorer. Right-click it, and open its properties (if "properties" is not directly available, it may be behind the "Show more options" menu item).
  6. Switch to the "details" tab.
  7. Copy the entry found in "Title" (in the "Description" section)
  8. Close the properties of the downloaded file.
  9. Find the full GeoTIFF file which is to be made available on the Geoshare. Right-click it, and open its properties (if "properties" is not directly available, it may be behind the "Show more options" menu item).
  10. Switch to the "details" tab".
  11. Paste the copied legend definition into the "Title" field (in the "Description" section)
  12. Apply the changes and close.
  13. Open the Geoshare and upload the GeoTIFF file.
  14. Confirm the process was successful by importing the GeoTIFF file from the Geoshare into the Project and displaying it using a GeoTiff Overlay. The Legend should immediately be configured correctly.

Notes

  • The actual metadata adjusted is the TIFFTAG_IMAGEDESCRIPTION.
  • The definition of the Legend can also be obtained by using the "copy" option in the legend tab of the right panel of the editor. However, the definition of the legends to be applied to the file may not include linebreaks, and as such will need to be removed from the defintion before applying it. This can be done in a simple text editor, such as notepad, but is an extra step to be aware of.
  • The definition of the Legend can also be obtained directly from the API page of the GeoTiff Overlay. On the general tab in the right panel of the editor, open the API page by clicking on the Overlay's ID in the top right. This will open a web page with the Overlay's configuration. The legend definition can be found under "legend".