2. The Mosaic Hub¶
The Mosaic Hub front-end is the main tool for S2GM users. It allows to specify S2GM products in terms of the spatial extent as well as the compositing period and the format of the output products. The front-end guides the user through the process of this product specification. A registration is required before requesting and downloading mosaics.
For the registration process, guide your browser to the Subscription Page. After you have filled out the form (see Fig. 2.1), you will receive an e-mail to confirm your mail address. Click on the verification button and you will receive the confirmation that your account has been created.
2.2. Mosaic Ordering¶
This section describes the process of ordering mosaics, from defining the request to the download of the processed product. The ordering of Time Series information is described further below.
2.2.1. Mosaic Hub¶
The Mosaic Hub is located here, here you can define your processing request and get time series information. However, in order to download the processed products, you will have to install the “Mosaic Downloader” App. In fact, this App has the same functionality like the browser instance but also the data can be downloaded. In order to avoid switching between browser and Mosaic Downloader, it might be more convenient to work with the app from the beginning.
2.2.2. Mosaic Downloader¶
In the Mosaic Hub, click on the drop-down menu item “Mosaic Downloader” like in Fig. 2.2.
From there, you are able to download the App for your specific OS, or even launch the App from the browser menu. When you launch the App, you will see a window like in Fig. 2.3.
The menu of the App on the top will bring up the following functionality after clicking:
|Home||S2GM Project Homepage|
|Mosaic Hub||Configuration of Mosaics|
|Time Series||Configuration of Time Series|
|User Area||Status of Orders|
|Mosaic Downloader||Configuration and Execution of Downloads|
|User Manual||This document|
|About S2GM||S2GM Project About Page|
The App Window is split with the dynamic map on the right and the temporal and spatial configuration options on the left. Users can scroll and zoom into the map to focus on an area of interest.
126.96.36.199. Area Selection¶
As depicted in Fig. 2.4: Area Selection, several options exist to define the area for which the mosaic product will be generated (Note: Your product might be split into several tiles if it spans a large area - see also the warning displayed on Fig. 2.14):
- Drawing a rectangular or a polygon of arbitrary geometry on the map after selecting the corresponding icon in the menu on the upper right of the map (see Fig. 2.5)
- Uploading a Google KML/KMZ file or an ESRI shapefile (coordinates must be in WGS84); the upload button is located on the second tab in the area selection menu of the configuration menu
- Selection of a pre-defined area, i.e. a country or a continent, in the dropdown menus of the configuration menu
- Entering the area boundaries in WKT format (see Fig. 2.6: WKT Example; note that in WKT the first and last co-ordinates must be identical to close the polygon
188.8.131.52. Compositing Periods¶
The definition of the compositing period is done in the temporal period section of the configuration menu. Five different compositing periods can be selected: year, season, month, 10-day, day. For each of these compositing periods, pre-defined periods can be selected by choosing the desired option in the corresponding tabs. Unavailable periods are disabled and marked in grey colour. In the 10-day and the day tabs, one can select months and years from drop-down lists. The forward and backward scrolling can be done by clicking on the arrow symbol.
As it can be seen in Fig. 2.7, one can select a complete year as compositing period by clicking on it.
Select a three-month period by clicking on the buttons Q1-Q4 (Fig. 2.8).
The selection of the desired month as compositing period is straightforward (Fig. 2.9).
The definition of a ten-day-period is bound to pre-defined, fixed intervals. The latter are displayed on the specific tab. Start and end days are marked in dark green, the intermediate values in light green (see Fig. 2.10). Clicking on either day in the interval yields the same result.
The selection of the desired day as compositing period is straightforward (Fig. 2.11).
Once the area of interest and compositing period have been selected, users must define further properties in the Order Panel dialogue. Click on “PREPARE DOWNLOAD” to enter the Order Panel.
184.108.40.206. Order Panel¶
You will have to walk through four tabs and make your choices. On the last tab, you will be able to resume your selections. In the first tab the data format has to be defined (see Fig. 2.12).
Make your choice and click on “Next”. This brings you to the next tab of the Order Panel. Here you can select the bands that shall be included in the product (see also Product Guide). Apart from the surface reflectance bands, additional bands can be selected under “Advanced Settings” (see Fig. 2.13).
Click on “Next”. The next page is used to assign a name to your specific order (Fig. 2.14). Assign the name in such a way that it is as meaningful as possible. This way you will be able to distinguish your processings better later on.
Note that large orders might be split into several tiles. The Sentinel tile names will appear as subfolders in the product when downloaded.
Click on “Next”. You will get to the last page (see Fig. 2.15). As mentioned before, you are now able to review your decisions and make changes if necessary.
If everything is correct, click on “Generate”. The processing starts and after a while (depending on the size of the order) you will be able to download your products in the User Area (Download).
In case the bounding box of the order area includes more than 1 million m², product size will be very large and processing time may be considerable. In this case, we will get in touch with you in order identify the best way of production scheduling and product distribution.
2.3. Time Series¶
The definition of a time series is very similar to the definition of a mosaic. A click on the button “Time Series” brings up the following page (see Fig. 2.16):
Fill out all sections of the dialog and select the target pixel(s) on the map. Klicking on the lower symbol toggles between single pixel and 3x3 pixels in the particular resolution (Fig. 2.17). When done, click on “Generate”.
Successful processing changes the “Generate” button into the following message (Fig. 2.18):
Additionally, the pixels marked in Fig. 2.17 get a green border. Hovering over pixels will quickly display their values and metadata; clicking on pixels will display the values on a page with the option to export data to a CSV file (Fig. 2.20).
2.4. User Area (Download)¶
Clicking on the button “User Area” in the Mosaic Hub App brings up the following dialog window (Fig. 2.21):
The User Area is the place where you can download your products after completion of the production. The user area also allows you to monitor and cancel your orders during production or get in touch with the S2GM team in case of issues. After completion of a production, your products will be available for a period of 2 weeks for download. The User Area displays all current mosaic orders. You are able to filter for a production name to narrow your search. If something went wrong, you can inform the S2GM team by clicking on the envelope icon. Orders can be cancelled by clicking on the red cross icon. If the status of an order is finished, the download icon changes to green. When you click on it, the download dialog will be displayed (Fig. 2.22). You first have to select a download directory that you can change later if needed. Hovering the list will turn the entries from grey to black. A click on the black icon will start the download.
As already mentioned above: if you selected a large area, the orders might be split into several tiles that appear in the download list after you clicked on the download button. To avoid unnecessary processing in the Mosaic Hub, processings and thus the downloads will proceed only after user involvement. Also, you will be notified that more tiles might be available (Fig. 2.23). The red check mark signifies that the download is not yet complete.
The following image shows an example download directory for a multi-tile product: