Merge pull request #206 from WorldCereal/user-guidance-edit

added figures on data availability

notebooks/worldcereal_v1_demo_custom_cropland.ipynb

@@ -83,10 +83,27 @@
    "source": [
     "### 2. Extract public reference data\n",
     "\n",
-    "Here we query existing reference data that have already been processed by WorldCereal and are ready to use.\n",
+    "Here we query existing public reference data that have already been processed by WorldCereal and are ready to use.\n",
     "To increase the number of hits, we expand the search area by 250 km in all directions.\n",
     "\n",
-    "We print the number of training samples retrieved per year."
+    "We print the number of training samples retrieved per year.\n",
+    "\n",
+    "To give you an idea on the regions where public land cover training data is available, consult the figure below:\n",
+    "\n",
+    "<p align=\"center\">\n",
+    "<img src=\"./resources/cropland_data_Ph1.png\" alt=\"crop-data\" width=\"400\"/>\n",
+    "</p>\n",
+    "\n",
+    "\n",
+    "<div class=\"alert alert-block alert-warning\">\n",
+    "<b>What to do in case no samples were found?</b><br> \n",
+    "\n",
+    "1. **Increase the buffer size**: Try increasing the buffer size by passing the `buffer` parameter to the `query_public_extractions` function (to a reasonable extent).\n",
+    "    *Current setting is: 250000 m².*\n",
+    "2. **Pick another area**\n",
+    "3. **Contribute data**: Collect some data and contribute to our global database! 🌍🌾 [Learn how to contribute here.](https://worldcereal.github.io/worldcereal-documentation/rdm/upload.html)\n",
+    "\n",
+    "</div>"
    ]
   },
   {

notebooks/worldcereal_v1_demo_custom_croptype.ipynb

@@ -125,10 +125,26 @@
    "source": [
     "### 3. Extract public reference data\n",
     "\n",
-    "Here we query existing reference data that have already been processed by WorldCereal and are ready to use.\n",
+    "Here we query existing public reference data that have already been processed by WorldCereal and are ready to use.\n",
     "To increase the number of hits, we expand the search area by 250 km in all directions.\n",
     "\n",
-    "We print the number of training samples retrieved per year."
+    "We print the number of training samples retrieved per year.\n",
+    "\n",
+    "To give you an idea on the regions where public crop type training data is available, consult the figure below:\n",
+    "\n",
+    "<p align=\"center\">\n",
+    "<img src=\"./resources/croptype_data_Ph1.png\" alt=\"crop-data\" width=\"400\"/>\n",
+    "</p>\n",
+    "\n",
+    "<div class=\"alert alert-block alert-warning\">\n",
+    "<b>What to do in case no samples were found?</b><br> \n",
+    "\n",
+    "1. **Increase the buffer size**: Try increasing the buffer size by passing the `buffer` parameter to the `query_public_extractions` function (to a reasonable extent).\n",
+    "    *Current setting is: 250000 m².*\n",
+    "2. **Pick another area**\n",
+    "3. **Contribute data**: Collect some data and contribute to our global database! 🌍🌾 [Learn how to contribute here.](https://worldcereal.github.io/worldcereal-documentation/rdm/upload.html)\n",
+    "\n",
+    "</div>"
    ]
   },
   {

notebooks/worldcereal_v1_demo_custom_croptype_extended.ipynb

@@ -138,10 +138,26 @@
    "source": [
     "### 3. Extract public reference data\n",
     "\n",
-    "Here we query existing reference data that have already been processed by WorldCereal and are ready to use.\n",
+    "Here we query existing public reference data that have already been processed by WorldCereal and are ready to use.\n",
     "To increase the number of hits, we expand the search area by 250 km in all directions.\n",
     "\n",
-    "We print the number of training samples retrieved per year."
+    "We print the number of training samples retrieved per year.\n",
+    "\n",
+    "To give you an idea on the regions where public crop type training data is available, consult the figure below:\n",
+    "\n",
+    "<p align=\"center\">\n",
+    "<img src=\"./resources/croptype_data_Ph1.png\" alt=\"crop-data\" width=\"400\"/>\n",
+    "</p>\n",
+    "\n",
+    "<div class=\"alert alert-block alert-warning\">\n",
+    "<b>What to do in case no samples were found?</b><br> \n",
+    "\n",
+    "1. **Increase the buffer size**: Try increasing the buffer size by passing the `buffer` parameter to the `query_public_extractions` function (to a reasonable extent).\n",
+    "    *Current setting is: 250000 m².*\n",
+    "2. **Pick another area**\n",
+    "3. **Contribute data**: Collect some data and contribute to our global database! 🌍🌾 [Learn how to contribute here.](https://worldcereal.github.io/worldcereal-documentation/rdm/upload.html)\n",
+    "\n",
+    "</div>"
    ]
   },
   {