Skip to content

Commit ace0fb6

Browse files
committed
a little bit of doc cleanup and update use case 2 in readme
1 parent 15a6de4 commit ace0fb6

File tree

2 files changed

+8
-5
lines changed

2 files changed

+8
-5
lines changed

jupyter-notebooks/analysis-ready-data/README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@
33
The tutorials in this directory cover how to use the orders api to create Analysis Ready Data. These tutorials cover two use cases:
44
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.*
55

6-
2. **NOTE: This may be outdated, update** *The second use case we will cover is: As a tropical forest monitoring analyst, I'd like to create an imagery pipeline that delivers analysis-ready imagery over a [LARGE] protected area so I can create simple change detection (ndvi_xdate - ndvi_ydate) analyses. I'd like to do minimal custom (non-Planet) data processing to get the imagery in a format that supports a change-detection analysis because my technical skills are limited.*
7-
8-
The first notebook, [ARD Best Practices and Use Case 1](ard_best_practices_and_use_case_1.ipynb), provides an introduction to Analysis Ready Data and the orders api, provides best practices for using the orders api, and runs through the first use case. The second notebook covers the second use case.
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.*
97

8+
The notebooks are meant to be worked through in sequence:
9+
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.

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

Lines changed: 3 additions & 2 deletions
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. \n",
11+
"In [Part 1](ard_1_intro_and_best_practices.ipynb) of this tutorial, we introduced ARD and covered the how and whys of using the Data and Orders APIs to create and interpret ARD.\n",
1212
"\n",
1313
"This second part of the tutorial focuses on the first of two use cases. The use case addressed in this tutorial is:\n",
1414
"\n",
@@ -41,7 +41,8 @@
4141
"1. [Download Orders](#Step-5:-Download-Orders)\n",
4242
"1. [Unzip and Verify Orders](#Step-6:-Unzip-and-Verify-Orders)\n",
4343
"\n",
44-
"Note that, due to the processing-intensiveness of visualizing the NDVI images and UDM2s, we will be covering visualization in the next notebook, [ard_2_use_case_1_visualize_images.ipynb](ard_2_use_case_1_visualize_images.ipynb)\n",
44+
"Note that, due to the processing-intensiveness of visualizing the NDVI images and UDM2s, we will be covering visualization in the next notebook, [Analysis Ready Data Tutorial Part 2: Use Case 1 - Visualization](ard_2_use_case_1_visualize_images.ipynb)\n",
45+
"\n",
4546
"#### Import Dependencies"
4647
]
4748
},

0 commit comments

Comments
 (0)