Skip to content

Commit 652d15d

Browse files
committed
move back to one use case and add ground truth data to repo
1 parent ace0fb6 commit 652d15d

File tree

3 files changed

+6
-6
lines changed

3 files changed

+6
-6
lines changed
Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
# Analysis Ready Data
22

3-
The tutorials in this directory cover how to use the orders api to create Analysis Ready Data. These tutorials cover two use cases:
4-
1. *As a software engineer at an ag-tech company, I'd like to be able to order Planet imagery programmatically in a way that enables the data scientist at my organization to create time-series algorithms (e.g. monitoring ndvi curves over time) without further data cleaning and processing.*
3+
The tutorials in this directory cover how to use the data and orders APIs to create Analysis Ready Data. These tutorials provide an introduction to concepts necessary in creating Analysis Ready Data and an introduction to the data and orders APIs, best practices for utilizing the data and orders APIs to create Analysis Ready Data, and a walkthrough of a real-world use case.
54

6-
2. *As an agriculture customer, I'd like to create an imagery pipeline that provides for trialing different fungicides by ordering Planet imagery within a single field (AOI), cutting the imagery into multiple field blocks (grid within AOI), and comparing values across blocks in two ways. First, comparison is performed by extracting median, mean, variance NDVI values for each day (using random point sampling) in each block. Second, comparison is performed by random point selection in each block.*
5+
The use case covered is:
6+
*As an agriculture customer, I'd like to create an imagery pipeline that provides for trialing different fungicides by ordering Planet imagery within a single field (AOI), cutting the imagery into multiple field blocks (grid within AOI), and comparing values across blocks in two ways. First, comparison is performed by extracting median, mean, variance NDVI values for each day (using random point sampling) in each block. Second, comparison is performed by random point selection in each block.*
77

88
The notebooks are meant to be worked through in sequence:
99
1. [Analysis Ready Data Tutorial Part 1: Introduction and Best Practices](ard_1_intro_and_best_practices.ipynb), provides an introduction to Analysis Ready Data and the Orders and Data APIs and provides best practices for using the APIs to prepare Analysis Ready Data.
10-
1. [Analysis Ready Data Tutorial Part 2: Use Case 1](ard_2_use_case_1.ipynb) runs through the first use case, preparing an NDVI time stack. This part includes a second notebook, [Analysis Ready Data Tutorial Part 2: Use Case 1 - Visualize Images](ard_2_use_case_1_visualize_images.ipynb), for visualizing the NDVI imagery.
11-
1. [Analysis Ready Data Tutorial Part 3: Use Case 2](ard_3_use_case_2.ipynb) runs through the second use case, preparing a gridded NDVI time stack of a field and performing comparisons across the grid blocks.
10+
1. [Analysis Ready Data Tutorial Part 2: Use Case 1](ard_2_use_case_1.ipynb) runs through the use case, preparing an NDVI time stack. This part includes a second notebook, [Analysis Ready Data Tutorial Part 2: Use Case 1 - Visualize Images](ard_2_use_case_1_visualize_images.ipynb), for visualizing the NDVI imagery.

jupyter-notebooks/analysis-ready-data/ard_1_intro_and_best_practices.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"\n",
99
"Time-series analysis (e.g. change detection and trend detection) is a powerful application of satellite imagery. However, a great deal of processing is required to prepare imagery for analysis. Analysis Ready Data (ARD), preprocessed time-series stacks of overhead imagery, allow for time-series analysis without any additional processing of the imagery. See [Analysis Data Defined](https://medium.com/planet-stories/analysis-ready-data-defined-5694f6f48815) for an excellent introduction and discussion on ARD.\n",
1010
"\n",
11-
"This tutorial shows how [Planet APIs](https://developers.planet.com/docs/apis/) can simplify production of ARD by demonstrating best practices and then by walking through a real world use case. This tutorial is targeted to users who have little to no geospatial knowledge but have experience working with APIs. The goal of this tutorial is to teach the user the how and whys of using the Data and Orders APIs to create and interpret ARD for both use cases. This first part of the totorial focuses on best practices. The following parts will focus on two real-world use cases.\n",
11+
"This tutorial shows how [Planet APIs](https://developers.planet.com/docs/apis/) can simplify production of ARD by demonstrating best practices and then by walking through a real world use case. This tutorial is targeted to users who have little to no geospatial knowledge but have experience working with APIs. The goal of this tutorial is to teach the user the how and whys of using the Data and Orders APIs to create and interpret ARD for both use cases. This first part of the totorial focuses on best practices. The following part will focus on a real-world use case.\n",
1212
"\n",
1313
"\n",
1414
"## APIs\n",

jupyter-notebooks/analysis-ready-data/pre-data/ground-truth-test.geojson

Lines changed: 1 addition & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)