Post on 08-Feb-2018
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 1 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
Sentinel-2 Agriculture
Software User Manual
Milestone Milestone 4 - Acceptance Review
Authors
Cosmin UDROIU, Alex GROSU, Ramona POPESCU, Laurentiu
NICOLA, Ramona MANDA, Mickael SAVINAUD, Nicolas
BELLEMANS, Sophie BONTEMPS
Distribution ESA - Benjamin KOETZ
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 2 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
This page is intentionally blank
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 3 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
Table of recorded changes
Issue/Rev. Date Reason
1.0 25/10/2015 Document creation
1.1 26/02/2016 Changed the parameters for the processors, and added steps for installation and configuration of the missing system components (like website, database, etc.)
1.2 01/03/2016 Changed parameter list for MACCS, added MACCS configurator page
2.0 21/08/2016 Major revision of the document, with changes in the structure to better match the user point of view, and with changes in the content to reflect the system v1.3
2.1 10/10/2016 Corrections.
2.2 23/12/2015 Update to reflect the system 1.4
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 4 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
Table of contents
1. Introduction 10
1.1 Purpose and scope 10
1.2 Structure of the document 10
1.3 References 10
1.3.1 Applicable documents 10
1.3.2 Reference documents 11
1.3.3 Acronyms and abbreviations 12
2. System Overview 14
2.1 General overview 14
2.2 Processors 16
2.2.1 Cloud-free temporal syntheses (L3A) processor 17
2.2.2 Biophysical vegetation (L3B) processor 19
2.2.3 Cropland mask (L4A) processor 22
2.2.4 Crop type map (L4B) processor 25
2.3 S2-Toolbox integration 28
2.4 System implementation 28
2.5 The Sen2-Agri Orchestrator 29
3. System deployment 30
3.1 Prerequisites for automatic usage 30
3.2 Installation and configuration for automatic usage 32
3.2.1 Installation package content 32
3.2.2 Installation procedure 32
3.2.3 Additional configurations 33
3.2.4 First interaction with the Sen2-Agri system 34
3.3 Prerequisites for manual usage 35
3.4 Installation and configuration for manual usage 35
3.4.1 Installing Sen2-Agri core components 35
3.4.2 Configuring and using SNAP 36
4. How to Use the Sen2-Agri System 42
4.1 General 42
4.2 First steps for the automated usage 43
4.2.1 Configure a new site 43
4.2.2 Optionally adapt the main processor parameters 44
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 5 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
4.2.3 Activate or change the site parameters 44
4.2.4 Monitor the processing 45
4.2.5 Where to find output products 47
4.2.6 Provide in situ data during monitoring period 48
4.3 Perform manual operations 49
4.3.1 L1C Product download 49
4.3.2 Atmospheric Correction (L2A) 51
4.3.3 Creating a composite (L3A) product 53
4.3.4 Creating an LAI vegetation status (L3B) product 57
4.3.5 Creating an NDVI vegetation status (L3B) product 61
4.3.6 Creating a crop mask (L4A) product 64
4.3.7 Creating a crop type (L4B) product 73
4.4 In-situ data information 77
5. Maintenance of the system 81
5.1 Uninstall procedure 81
5.2 Update procedure 82
5.3 How to submit an issue 83
5.4 FAQ 83
How can I check if a service has crashed? 83
How can I check the system logs? 83
How can I check if the web site is running? 84
What are the default web site credentials? 84
Do I need to add the host name to /etc/hosts? 84
What does SLURM do? 84
What are the two databases used for? 84
What are the PostgreSQL database credentials? 84
Why are upgrades unsupported? Error! Bookmark not defined.
Appendix A - Additional tools available in the system 85
Appendix A.1 Sen2-Agri Archiver parameters 85
Appendix A.2 Sen2-Agri HTTP Listener parameters 86
Appendix A.3 Sen2-Agri Executor parameters 87
Appendix A.4 Sen2-Agri Monitor Agent parameters 88
Appendix A.5 Sen2-Agri Persistance Manager parameters 89
Appendix A.6 Sen2-Agri Downloader parameters 90
Appendix B - Sen2-Agri database tables for manual configuration 92
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 6 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
Appendix C - System performance example 95
Appendix D - Building from source 97
Appendix E How to add new users 98
Appendix F Advanced system configuration items 99
Ref Sen2-Agri_SUM
Issue Page Date
/2012 2.rev.3 7 18/01/2017
UCL-Geomatics 2016
This document is the property of the Sen2-Agri partnership, no part of it shall be reproduced or
transmitted without the express prior written authorisation of UCL-Geomatics (Belgium).
List of figures
Figure 2-1. Suite of the four validated Sentinel-2 derived agricultural products generated
by the Sen2-Agri system ................................................................................................ 14
Figure 2-2. Logical data flow of the Sen2-Agri system .................................................. 15
Figure 2-3. Logical data flow of the L3A processor ....................................................... 18
Figure 2-4. Sequence for an automatic production of a monthly cloud-free composite ... 18
Figure 2-5. 50 days composite centered on May 1st, 2016 based on S2 images ............... 19
Figure 2-6. Logical data flow of the L3B processor for generating LAI products ........... 21
Figure 2-7. Logical data flow of the L3B processor for generating NDVI products ........ 21
Figure 2-8. Sequence for an automatic production of a LAI product .............................. 22
Figure 2-9. Mono-date LAI product over Sudan (White Nile state) based on a S2 image
(L2A product visible on top left) from 20160702 ........................................................... 22
Figure 2-10. Logical data flow of the L4A processor ..................................................... 24
Figure 2-11. Sequence for an automatic production of a series of monthly crop masks ... 24
Figure 2-12. Crop masks over the French (left) and Malian (right) JECAM sites, based on
Spot 5 Take 5 imagery acquired between April and September 2015 ............................. 25
Figure 2-13. Logical data flow of the L4B processor and its articulation with the L4A
processor ....................................................................................................................... 26
Figure 2-14. Sequence for an automatic production of crop type maps over the season .. 27
Figure 2-15. Crop type maps over the French (left) and Malian (right) JECAM sites, based
on Spot 5 Take 5 imagery acquired between April and September 2015 and on the crop
masks generated in a previous step by the system .......................................................... 27
Figure 2-16. Software System Architecture ................................................................... 29
Figure 3-1. Main page of the Sen2-Agri web interface ................................................... 34
Figure 4-1. Site creation through the Sen2-Agri system interface ................................... 43
Figure 4-2. Site page of the Sen2-Agri interface, to activate the sites ............................. 44
Figure 4-3. Edit size window allowing users modifying site parameters and/or activating it
...................................................................................................................................... 45
Figure 4-4. Sen2-Agri Execution Dashboard System Overview .................................. 46
Figure 4-5. Sen2-Agri Execution Dashboard Product Availability .............................. 48
Figure 4-6. MACCS Processor in SNAP Execution parameters .................................. 53
Figure 4-7. L3A Composite Processor in SNAP Execution parameters ....................... 55
Figure 4-8. Manual execution of L3A processor from Web