Clip time series#
This article should explain every step to execute the module. However, if you encounter a problem, please report it.
This module allows users to download an automatically generated time series from customizable dates as a
Each mosaic will be represented as a custom square around the point of interest using the band combination selected by the user (ranging in size from 500 m x 500 m to 1000 km x 10000 km).
First the user needs to select a file, which will be the main input of the module; each page of the final
Table file (
.txt), containing at least coordinates and ID columns
.geopackage), with at least geometry and ID columns
Select the point radio button.
The table file can be a
.txt file. It needs to have at least three columns, including the latitude coordinates, the longitude coordinates, and an ID. There are no restrictions for column names.
The table coordinates need to remain unprojected (i.e. in EPSG:4326)
Select Table file. Only the matching file type will be displayed. Navigate through your SEPAL folders to find the appropriate table.
Once a file is selected, the widget will try to autopopulate the ID, latitude, and longitude columns. If columns are incorrectly set or if data are missing, select one of the file columns to completely describe the points (x, y, ID).
Select load your pts file to load the points as a geodataframe in the app model and display them on a map.
The points will be represented as marker clusters and the map will automatically zoom in on them; click on any cluster to zoom in.
Select :guilabel:` download test dataset` to automatically download and validate a set of points in the app, which can be used to discover module functionalities.
Select the shape radio button.
The table file can be any file type digested by the
fiona library; the file needs to have at least one column to describe the ID.
The ID column will be used to name the points in the final .pdf. Select it in the updated dropdown menu, ID column.
If you use names for IDs, make sure they are unique.
Select load your pts file to load the shapes as a geodataframe in the app model and display them on a map. The map will be updated with the selected shapes and zoom in on the AOI.
Select time series parameters#
In this second step, you will select the parameters of your time series.
Two drivers are available in this module. You can select either:
a GEE-based computation (images will be retreived from GEE), or
Planet (images will be retrieved from Planet servers using the user API key).
If the user selects gee, the panel will ask you to select the satellites to use for thumbnails. Select any satellite imagery from the Landsat family and Sentinel programme.
The best available image is then selected using the following hierarchical order:
If the user selects planet, the panel will ask for the Planet API key.
The number of points a user wants to display can vary. If the user selects all, then all available points in the provided file will be used. It’s also possible to select a subset of them using their ID names.
Multiple band combinations can be selected:
Red, Green, Blue
Nir, Red, Green
Nir, Swir1, Red
Swir2, Nir, Red
Swir2, Swir1, Red
Swir2, Nir, Green
Each selected mosaic will be represented by a thumbnail in the final
Users can select as many mosaics as they want, but please note:
The page will remain in A4 format, so thumbnails will become smaller and smaller, proportional to the number of mosaics.
Each image needs to be downloaded to SEPAL, so many images result in a longer computation time.
gee driver, mosaics are yearly cloudless mosaics built on the best satellites, as described in the previous section.
planet driver, three types of mosaics can be selected (and mixed together):
NICFI bianual mosaics
NICFI monthly mosaics
Other (any other mosaics associated with the user API key)
Select a thumbnail size, which will be the minimal size of the thumbnail used. If the shape defined in the first panel is bigger, the software will try to find the smallest square around the shape, centred on its centroid.
If the final outer square of a shape is larger than 10000 km x 10000 km, GEE and Planet will refuse to export your data. Remember that this module is not meant to export national time series but thumbnails.
In the middle of the final image, the software will display a small square to visually represent the point. Users can select the size of this square depending on the size of their thumbnails.
If the used dataset is a shapefile, the square will be replaced by shape geometry.
When selecting the validation button, the module provides a summary of the download, which is a warning step to avoid downloading massive numbers of points on incorrectly defined parameters.
Select the only available button to send your images to GEE or Planet.
The build of the
To save space, the images will be removed from your Google Drive after the creation of the .pdf file.
Then, the module will present an active link in the green button to a preview of the first page of the