VanderSat Viewer User Guide¶
The viewer can be used by pointing a supported browser (google chrome or mozilla firefox) to https://maps.vandersat.com and logging in using your login and password.
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:
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 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 maps 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 area configured area.
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.
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
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.
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.
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.
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.
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.
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.
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|
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 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).
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.
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.
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.
The measurement tool will always take the shortest line from one point to the next.