software user manual - esa- · pdf filecosmin udroiu, alex grosu, ramona popescu, laurentiu...
TRANSCRIPT
Ref Sen2-Agri_SUM
Issue Page Date
2.rev.5 1 03/10/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
2.rev.5 2 03/10/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
2.rev.5 3 03/10/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
2.3 20/02/2017 Update to reflect the system 1.5
2.4 13/06/2017 Updates to reflect the system 1.6
2.5 03/10/2017 Updates to reflect the system 1.7 Added local store mode for the Sentinel 2 Downloader
Ref Sen2-Agri_SUM
Issue Page Date
2.rev.5 4 03/10/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
Sentinel-2 Agriculture 1
Software User Manual 1
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 16
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 Installation package content 30
3.2 Prerequisites for automatic usage 30
3.3 Installation and configuration for automatic usage 32
3.3.1 Installation procedure 32
3.3.2 Additional configurations 33
3.3.3 First interaction with the Sen2-Agri system 34
3.4 Prerequisites for manual usage 35
3.5 Installation and configuration for manual usage 36
3.5.1 Installing Sen2-Agri core components 36
3.5.2 Configuring and using SNAP 37
4. How to Use the Sen2-Agri System 42
4.1 General 42
4.2 First steps for the automated usage of the system 43
4.2.1 Configure a new site 43
Ref Sen2-Agri_SUM
Issue Page Date
2.rev.5 5 03/10/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.2 Editing the sites to define season and processors to execute 44
4.2.3 Optionally adapt the main processor parameters 46
4.2.4 Activate or change the site parameters 46
4.2.5 Monitor the processing 47
4.2.6 Where to find output products 49
4.2.7 Provide in situ data during monitoring period 50
4.3 Perform manual operations 50
4.3.1 L1C Product download 51
4.3.2 Atmospheric Correction (L2A processor) 52
4.3.3 Creating a composite (L3A) product 54
4.3.4 Creating an LAI vegetation status (L3B) product 58
4.3.5 Creating an NDVI vegetation status (L3B) product 62
4.3.6 Creating a crop mask (L4A) product 65
4.3.7 Creating a crop type (L4B) product 75
4.4 In-situ data information 80
4.5 Single-tile vs multi-tile processing 83
5. Maintenance of the system 84
5.1 Uninstall procedure 84
5.2 Update procedure 85
5.3 How to submit an issue 86
5.4 FAQ 86
Appendix A - Additional tools available in the system 88
Appendix A.1 Sen2-Agri Archiver parameters 88
Appendix A.2 Sen2-Agri HTTP Listener parameters 89
Appendix A.3 Sen2-Agri Executor parameters 90
Appendix A.4 Sen2-Agri Monitor Agent parameters 91
Appendix A.5 Sen2-Agri Persistance Manager parameters 92
Appendix A.6 Sen2-Agri Downloader parameters 93
Appendix A.7 Using Sentinel2 Downloader With Local L1C Store 95
Appendix B - Sen2-Agri database tables for manual configuration 96
Appendix C - System performance example 98
Appendix D - Building from source 100
Appendix E How to add new users 101
Appendix F Advanced system configuration items 102
Appendix G ESA CCI LC legend 116
Ref Sen2-Agri_SUM
Issue Page Date
2.rev.5 6 03/10/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).
Ref Sen2-Agri_SUM
Issue Page Date
2.rev.5 7 03/10/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 S2 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 April 1st, 2016 based on S2 and L8 images over
Occitanie Region, France ........................................................................................................ 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 ...................................... 21
Figure 2-9. Mono-date LAI product over South-Africa (Kwazulu-Natal) based on a S2 orbit
from 19-01-2017 ...................................................................................................................... 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. Ukraine 10-meter national cropland mask for the 2016 growing season generated
using 7 months of S2 and L8 data ........................................................................................... 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 map over the Western Cape region, South Africa, based on S2 and L8
imagery acquired between May and December 2016.............................................................. 27
Figure 2-16. Software System Architecture ............................................................................ 29
Figure 3-1. Main page of the Sen2-Agri web interface ........................................................... 35
Figure 4-1. Dialog box for site creation through the Sen2-Agri system interface ................... 43
Figure 4-2. Site page of the Sen2-Agri interface, to edit site or seasons ................................. 44
Figure 4-3. Dialog box for sites edition (including season dates) through the Sen2-Agri
system interface ....................................................................................................................... 45
Figure 4-4. Dialog box when a season is defined and the possibility to activate processors is
visible .......................................................................................