VanderSat Viewer User Guide

VanderSat Viewer

The viewer can be used by pointing a supported browser (google chrome or mozilla firefox) to 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.


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 configured area.

Home view

Reseting the view to the area allowed

Add data layers

To add a layer (different product and/or different dates) 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

While in comparison mode, a “spy” mode option is also available. In this mode the layer on the right side is fixed to the mouse cursor as a square, of a size that can be adjusted. Moving around 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 completely 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 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 once 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


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. 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 by drawing it on the map.

Region of interest

Figures showing the VanderSat viewer 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


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 to 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 the is Ready you can download the resulting 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 and permissions to view the selected propducts. Checking the Latest date option in the dialog show a map with the 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 the measurement tool is disabled, the data will be kept on the map. But enabling it again will clear them.


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

measurement tool

Measurement tool