VanderSat Viewer User Guide

VanderSat Viewer

The viewer can be used by pointing a supporter browser (google chrome or mozilla firefox) to https://maps.vandersat.com and logging in using your login and password.

VanderSat viewer login

Image showing the VanderSat data viewer login screen

At the first login a world map centered over the configured default region of interest with the latest date of your default product is shown. An example screen with the main controls is shown below:

VanderSat viewer

Image showing the VanderSat data viewer after logging in with the main controls indicated.

Once logged in the following tasks can be performed:

Searching on the map

The panel on the top left of the screen can be used to search for a specific location on the maps using the google search engine. If found the screen will be centered on that location.

Searching

Search the maps for known Points of Interest

Reset the view to area allowed

The home button on the top left controls resets the view on the map to your area allowed

Home view

Reseting the view to the area allowed

Add data layers

To add a layer (different product and/or different date) click on the “+” button located on top of the currently displayed layers. Please note that the current selected layer is highlighted with a blue bar on its right border.

Adding a data layer

Adding a data layer to the map

Change the appearance of a data layer

In the layer information box you can manipulate the layer in a number of ways:

  • You can use the opacity slider to change the opacity of the layer
  • The visibility toggle (the eye) can be used to make a layer visible or invisible
  • The shackle toggle can be used to connect a layer to another layer so that if you change the display time this is done for all the connected layers at the same time
  • The trashcan icon can be used to delete a layer
  • The legend slider can be used to scale the data legend to the desired range
Layer information box

Image showing the layer information box

Moving around in time

To load a different date for the selected product, you can either use the time slider on the bottom and click on the desired date (please note that you can zoom in and out of the time slider to change the displayed range by using the wheel of your mouse) or on manually specify the date on the calendar on the right of the slider.

Time bar

Time bar and date selection

Comparing data in split-screen mode

When adding multiple layers you can drag one layer to the right part of the screen to enter split screen mode to compare different times of one product or different products for the same time. The figure/animation below shows the result.

Split screen in the viewer

Image showing the VanderSat data viewer split screen mode

There is also available, while in comparison mode, a “spy” mode option. Where the layer on the right side is fixed to the mouse cursor as a square, of a size that can be adjusted. | Moving arround this square will show the info for the layer on the map within it.

Spy mode in the viewer

Image showing the VanderSat data viewer spy mode

Creating single point time-series graphs on the fly

When clicking on a valid data point on the map, the exact longitude, latitude and value is displayed. It is then possible to create as time series for this point After selecting to draw the time series, the drawing starts between the selected start and end date, and percentage of completion as well as the estimated time remaining is displayed.

Time series

After the time series is completing drawn, a moving average line is added in a different color. Furthermore, by using the Year mode button individual years can be plotted on top of each other.

Time series

Time series graph of a single pixels in the VanderSat viewer with the graph switched to year mode

Displaying a time-series for a region of interest

If you click on a point in the maps that is contained within a region of interest (ROI) you can also select to show the timeseries (an average of the ROI) in the dashboard. Timeseries for an ROI are not generated on-the-fly but updated one a day in the background.

Region of interest

Clicking on a point in a region of interest

Displaying Key performance indicators

After selecting to show the dashboard, KPIs are shown for the selected date. Moreover, the time series corresponding to the ROI is also drawn.

The time series for the ROI is drawn as well as the centered moving average +/- 20 days for this ROI (smoothed signal) available until the last 20 days, and the climatology built from the same +/-20 days smoothed signal.

The following KPI’s are currently shown for the selected date: Data quality (%) represents the percentage of data usable for the ROI; Observation Volumetric (m3/m3) represents the current daily observation; Relative to Climatology (m3/m3) represents the difference between the selected date value and the climatology value at the same day of the year; Relative Change (m3/m3) represents the variation compared to the last observation.

Key performance indicator

Figure showing the key performance indicators in a region of interest

Manage api requests

Specific time series request can be made clicking on the “New request” button in the time series window.

A popup to set the parameters of the request will show up. | Afterwards you can check the status of the request and retrieve the information through the API Access menu on the right, shown when clicking the API access button.

Api requests

“New request” button location

Api requests

Api request creation and checking it on the API access sidenav afterwards

A list with all the API requests can also be found on the API access menu, after clicking the “API request management” button.
The list can be filtered, the current status of the processing for the request can be seen and refreshed from the list.
And if there’s a file related with a request you can download it.
Api requests

Accessing the API requests list

Managing regions of interest

The Region of interest (ROI) menu can be found on the top right of the screen, just below the settings menu (where you can change the base layer from satellite to terrain, openstreetmap, etc.).

Region of interest

Figure showing the main components of the VanderSat viewer including the ROI menu at the top right

All defined ROI’s are displayed in this menu. You have the option to show a specific one, or hide/show all of them. | To create a new ROI, you can either draw one manually or upload a shapefile (GeoJSON format or zip archive containing the required files).

Region of interest

Figures showing the VanderSat ROI menu. Regions can be switched on or off, new regions can be defined (uploaded or drawn) and edited.

Using the controls on the left a new region can be created on the go. Drawing it on the map.

Region of interest

Figures showing the VanderSat new ROI drawing

Once uploaded, the new ROI can be customised with a name and a description. Please note that for multipolygon shapefiles (ie multiple shapes in a file), you have the option to select a subset of them and / or to consider them as different ROI or a single one as the union of those multiple shapes.

Region of interest

Figure showing the edit/upload menu for ROI’s in the VanderSat viewer

Once a new ROI is created, the map is centered over this ROI and the current selected layer is shown.

Region of interest

Figure showing the creation of a new region

Note

Please note that when a new ROI is for the first time added (drawn or uploaded), it takes a few hours to initialize the complete historical dataset corresponding to this ROI and update the dashboard time series and KPI values.

Change the background layer

You can change the background map from the default satellite view to another layer using the “base layer” option from the settings menu.

Changing background

Changing the background map in the viewer

Change the grid

You can add a grid to the map using the grid option from the user settings menu.

Changing the grid

Changing the grid in the viewer

Download data

You can download part of the current data layer as a GeoTiff to your local computer. | To do so go to the api access meu and choose the “Download map” button under the Exports heading. | A rectangle will appear that can be changed in size the select an area. Press save once the required area is selected.

Downloading data

Downloading a data layer as a GeoTiff in the viewer

This will create an Api request that, when is in status “Ready”, you can download the GeoTiff for that request. Accessing it from the API access menu, in the “Recent API requests” list, or in the list shown after clicking the “API Request management” button.

Downloading data

Downloading a data layer as a GeoTiff in the viewer

Share a view via a url

Using the share button you can generate a URL that can be used by others (or yourself later on) to see the exact same view. You will need a login to the viewer in order to use the URL. Checking the “Latest date” option in the dialog will make to show the map with latest info available whenever the share link is used.

share url

Share the current view with others as a URL

Measure distances on the map

Clicking the arrow control on the left enables the measurement-tool controls.

  • Adding points: single click. (to measure the distance between them. The total distance accumulated is shown in the last point).
  • Stop measuring: double click, escape key, or click again the arrow control on the left.
  • Clear current measurements shown: click the [x] right under the arrow control on the left.
  • Change measure unit: click the third control with a letter under the arrow control on the left. Units available: meters (m), miles (mi), nautical miles (nm).
A point can be moved once its placed via drag and drop or “picking it up” with a single click, then place it again with a another single click.
A point can be removed via clicking on it while pressing the shift key.
A measurement can be continued via clicking on the last point while pressing the ctrl key.

Once disabled the measurement tool, the measures will be kept on the map. But enabling it again will clear them.

Note: The measurement tool will always take the shortest line from one point to the next.

measurement tool

Measurement tool