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 .......................................................................................