Viewer User Guide
Note
Not all products are supported by the viewer, and not all accounts have its full functionality enabled. In general, for new accounts only data subscriptions will be available.
Planetary Variables Viewer
Access the Viewer by going to https://maps.vandersat.com in a supported browser (Google Chrome or Mozilla Firefox). Log in with your username and password.
After you log in for the first time, 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:
Once logged in, the following tasks can be performed:
Searching on the map: Use the top left search bar to search for places (cities, POI etc)
Reset the view to area allowed: Use the home button to reset the view
Add data layers: Use the bottom left panel to add, or remove data layers
Change the appearance of a data layer: Set the legend, visibility and link layers in time
Moving around in time: Move around in time: use the time bar at the bottom to select a time
Comparing data in split screen or spy mode: View two data layers ot two dates of a single data layer side by side
Creating single point time-series graphs on the fly: Click on a data layer to draw a time series graph
Displaying a time-series for a region of interest: Click on a data layer to draw a time series graph for a region
Displaying Key performance indicators: View performance indicators for a ROI
Manage API requests: Manage the API access
Managing regions of interest: Upload, draw, delete or adjust regions of interest
Using labels to tag and filter ROIs: Labels can be used to tag ROIs, and to filter ROIs in the list and on the map
Change the background layer: Select OpenStreetmap, satellite, grayscale map, terrain map or hybrid
Change the grid: Select a grid to be shown over the map
Download data: Download (part of) the selected lays as GeoTIFF to your local computer
Share a view via a url: Share a URL of a pre-build view (with layers and settings) with others
Measure distances on the map: Tool for measuring distances on the viewer
Searching on the map
The panel on the top left of the screen can be used to search for a specific location on the map using the Google search engine. If found, the screen will be centered on that location.
Reset the view to area allowed
The home button on the top left controls resets the view on the map to your default region of interest.
Add data layers
To add a layer (different product and/or dates), click on the
+
button located on top of the currently displayed layers. Please note
that the currently selected layer is highlighted with a blue bar on its
right border.
Change the appearance of a data layer
In the layer information box you can manipulate the layer in a number of ways:
Change the opacity of the layer with the opacity slider
Make the layer visible or invisible with the “eye” toggle
Connect a layer to another layer with the “shackle” toggle. This allows you to change the displayed time for all connected layers at once.
Delete a layer with the “trash can” button
Change the data legend to the desired range by sliding the legend endpoints
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 manually specify the date in the calendar on the right of the slider.
Comparing data in split screen or spy mode
Use split screen mode to compare multiple product layers. For example, you can compare different times of one product or different products for the same time. To enter split screen mode, drag one of the layers to the right part of the screen.
While in split screen mode, enter “spy” mode by clicking on the button above the right layer. In this mode, the layer on the right side is only shown within a size-adjustable square that you can drag around with the mouse.
Creating single point time-series graphs on the fly
Click on a valid data point on the map to get the exact longitude, latitude, and product value. It is then possible to create a 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.
After the time series is completely drawn, a line of the moving average is
added. Click on the Year
button to plot individual years on top of each other.
Displaying a time-series for a region of interest
If you click on a point within a region of interest (ROI), you can also choose to view an ROI Information a time series of the average value of the ROI. ROI timeseries are not generated on-the-fly but updated once a day in the background.
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.
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.
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.
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.).
All defined ROIs 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).
Using the controls on the left a new region can be created on the by drawing it on the map.
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.
Once a new ROI is created, the map is centered over this ROI and the current selected layer is shown.
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.
Using labels to tag and filter ROIs
The regions of interest can be tagged using labels which you can create and customize. Those labels can then be used with the ROI search for filtering purposes.
The “Label management” button below the ROIs list opens a dialog which allows to create, edit and delete the labels.
Whenever you have a filter applied, the ROI list is reduced to the matching results. Those resultant ROIs can be shown/hidden in the map by clicking the “Show/Hide filtered ROIs” button below the list.
This action won’t affect to visibility of the ROIs not present in the filtered ROI list.
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.
Change the grid
You can add a grid to the map using the grid option from the user settings menu.
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.
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.
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.
Note
The measurement tool will always take the shortest line from one point to the next.