-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathHowTo.html
115 lines (114 loc) · 11 KB
/
HowTo.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" >
<meta name="generator" content="pandoc" >
<meta http-equiv="X-UA-Compatible" content="IE=EDGE" >
<style>
img {
max-width: 100%;
max-height: 100%;
display: block;
margin: auto;
}
</style>
</head>
<body>
<div class="container-fluid main-container">
<div id="excellence-in-agronomy-eia-initiative---sampling-frames-for-validation" class="section level1">
<h1>Excellence in Agronomy (EiA) initiative - Sampling Frames for Validation</h1>
<p style="color: #333;">This tool provides users with a solution to select relevant areas and
locations where they can conduct the validation trials for their Minimum
Viable Products (MVP’s). The tool guides the user through a set of steps
that will allow them to make decisions on what is the most relevant set
of environmental clusters that can help reduce variance due to
environmental conditions, making the results of their trials more
representative for their target area (AOI).
</p>
<img src="https://live.staticflickr.com/65535/53788703449_12d0b1bc25_h.jpg" alt=""></img>
<div id="to-provide-a-bit-more-explanation-of-the-tool-and-links-to-additional-documentation" class="section level5">
<h5>(to provide a bit more explanation of the tool and links to additional documentation)</h5>
</div>
</div>
<div id="define-the-trial-conditions" class="section level2" >
<h2 style="color: rgb(65,45,34);">Define the trial conditions:</h2>
<p style="color: #333;">On the left-side panel of the tool, the user is initially provided
with a set of options to define the trial conditions in which they want
to run validations.</p>
<div id="define-the-target-region-or-area-of-interest-aoi" class="section level3">
<h3 style="color: rgb(65,45,34)">1. Define the target region or Area Of Interest (AOI)</h3>
<p style="color: #333;">The user will need to provide the file in .shp (as a zip file) or .geojson formats to
set the AOI where the trials will be conducted. This will define the tool for which to process the different environmental units in
the AOI.</p>
<div style=" width: 100vh;" > <img style=" width: 100vh;" src="https://media2.giphy.com/media/v1.Y2lkPTc5MGI3NjExbXYycHdmNTFkdnlpb2o3bm1sYnl4cHNiaHEyNnN5bGJpYmd3bjNkayZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/WPNDLYFlifJldorne5/source.gif" alt="" > </div>
<p style="color: #333;">Alternatively, the user could manually draw a shape on the map that
defines the region of interest. To achieve this, use map icons (polygon or rectangle) to draw a shape on the map and export using 'export' button on the right side of the map; then upload the downloaded geojson file of the AOI.</p>
<div style=" width: 100vh;"> <img style=" width: 100vh;" src="https://media1.giphy.com/media/v1.Y2lkPTc5MGI3NjExd3pmZHF1dHh2cmsxeG8wZnh4MW56emc0Ynpvd3hheHFuMHpnNW5lMSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/qdvclKThY6pvwqCBYP/giphy.gif" alt=""> </div>
<p style="color: #333;"><strong>Note</strong>: The size of the area has a limit of XXX km2.Consider this, as the tool will not work for
very large areas. In case you need to run the tool for a very large AOI, you can
contact <a href="mailto:xxxx.xxxxx@cgiar.org" class="email">xxxx.xxxxx@cgiar.org</a></p>
</div>
<div id="indicate-the-main-crop" class="section level3">
<h3 style="color: rgb(65,45,34)">2. Indicate the main crop</h3>
<p style="color: #333;">In this step, the user will define the main crop that the trials are targeting to validate.
This is done to select a set of relevant environmental variables that are considered most relevant by agronomists. </p>
<!--The crops available, together with the list of associated variables are indicated in the table below:</p>
<p style="color: #333;">[Table with crops + variables]</p>-->
</div>
<div id="define-the-seasonality" class="section level3">
<h3 style="color: rgb(65,45,34)">3. Define the seasonality</h3>
<p style="color: #333;">Seasonal conditions affect how environments might be clustered within the AOI, thus affecting the results
of the trials and how the crop performs. The tool requires that the user indicates the seasonality (start month and end month)
when the trials will be conducted.</p>
</div>
<div id="optimal-clusters-for-the-trials" class="section level2">
<h2 style="color: rgb(65,45,34);">Optimal clusters for the trials:</h2>
<p style="color: #333;">After defining the trial conditions, the user will be provided with a first result of the optimal number of
clusters in the AOI. These indicates which are the environmentally distinct areas specific for the crop the trials are targeting.</p>
<p style="color: #333;"> The output of the clustering is an interactive map with clusters mapped for the area of interest. Non-colored regions within the AOI are the non-cropland regions that have been masked out. </p>
<p style="color: #333;">Masked variables are used as inputs for the analysis. In this case the crop mask used is the Copernicus Land Cover dataset available on Google Earth Engine (GEE).<a href="https://developers.google.com/earth-engine/datasets/catalog/COPERNICUS_Landcover_100m_Proba-V-C3_Global#bands" target="_blank">Accessible here</a>.</p>
<p style="color: #333;">[<em>To be added… The user can view this clusters and also see what is the proportion of trials that should be
set-up in each cluster to get a balanced sample size that improves representativeness of the results.</em>]</p>
<p style="color: #333;">Below the map the user can see the boxplots for the different variables included for
the crops and which are the distributions (in boxplots) of the variables within each cluster.</p>
<p style="color: #333;">If the user is satisfied with the results, these can be exported to
further investigation or discussion with the team. Click the “Get Results” button to download to your computer.</p>
</div>
<div id="user-defined-number-of-clusters" class="section level2">
<h2 style="color: rgb(65,45,34);">User-defined number of clusters</h2>
<p style="color: #333;">In case the user does not agree with the results, is possible to navigate to the next step,
where the user will be able to create a more tailored set of clusters. <strong>This optional step strongly influences
the results.</strong></p>
<div id="number-of-clusters" class="section level3">
<h3 style="color: rgb(65,45,34)">4. Number of clusters</h3>
<p style="color: #333;">If for some reason the optimal number of clusters defined by the dry-run of the tool is not desirable,
the user may indicate what would be a more adequate number that fits their knowledge of the area or the logistical constraints.
Please, [select a number from the drop-down / indicate a number].</p>
</div>
<div id="relevant-environmental-variables" class="section level3">
<h3 style="color: rgb(65,45,34)">5. Relevant environmental variables</h3>
<p style="color: #333;">At this point, the user may also decide which are the most relevant environmental variables that may
influence the trials or that are of specific focus in the validation. For example, an MVP might be focusing on drought-resistant
varieties in rainfed wheat, and therefore rainfall might be the most important environmental variable to define the
different environmental clusters.</p>
<p style="color: #333;">The user should remove the variables from the box and only leave those that are relevant for the validation.</p>
<div style=" width: 100vh;"> <img style=" width: 100vh;" src="https://media2.giphy.com/media/v1.Y2lkPTc5MGI3NjExMzdteDNvY2Z2ZHhqb2VjdmYzcTZkMWc3OG0ycGd1ZDQwZnowazJ5ZSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/Uf1Gt7JZvrNtEzl1od/giphy.gif" alt=""> </div>
<p style="color: #333;">The user can test several combinations of variables and number of clusters and see the effects in the clusters
and variable distributions until an acceptable result is obtained. Once satisfied, the user can export the user-defined clusters by
clicking the “Get Results” button to download to the computer.</p>
</div>
</div>
<div id="download-output" class="section level2">
<h2 style="color: rgb(65,45,34);">Download Results:</h2>
<p style="color: #333;">The user can download the results once satisfactory output is obtained by either downloading the KML file via 'Get Results button' or they can opt to print out the page on their browser </p>
<p style="color: #333;">To print out the page or save as PDF, click on the three dots on the top right-side of the app then click print. adjust scale (in 'more settings') to 50% or 'fit to page width', with potrait layout and A4 paper size or any other printing preferences </p> </div>
<div id="Visualize-the-downloaded-output" class="section level2">
<h2 style="color: rgb(65,45,34);">Visualize the downloaded output:</h2>
<p style="color: #333;">To add and visualize a downloaded KMZ file in Google Earth, locate the downloaded KMZ file you wish to use (KMZ files are typically compressed KML (Keyhole Markup Language) files used for geographic data). </p>
<p style="color: #333;">Once you have Google Earth open on your computer—either by launching it or downloading it from the Google Earth website—simply drag and drop the KMZ file into the Google Earth window. Alternatively, you can use the menu by clicking File > Open..., navigate to where the KMZ file is saved, select it, and click Open. </p>
<p style="color: #333;">Google Earth will then import the KMZ file and display its clusters data, directly on the map. You can interact with the data by zooming in and out, panning across the map, and clicking on features to explore further details. </p>
<p style="color: #333;">If you make changes or add annotations, you can save your project by going to File > Save Place As.... If you need to move the KMZ file later, use your computer’s file management tools, ensuring Google Earth can still access it from its new location for continued use. </p>
</div>
</div>
</body>
</html>