planetlabs / training-workshop

Planet training workshop

This repo contains all materials used on Planet's training workshop by Professional Services. A lot of the notebooks in here are expanded and customized versions of Planet's official developer resources, which you can find in here. Below you will find environment set up instructions, decks and other learning resources to have you started on using Planet's APIs and tools.

Development Environment Setup

The Very Basics

Let's make sure you are set up with all the tools that we need to follow along on the excercises to be covered in this training.

• Python 3.7
  You will need to download the installer for your specific OS (32 or 64 bits). When installing, make sure the box "Add Python to Path" is checked.
• Git

We recommend to download the very complete but heavier Python distribution Anaconda, instead. With Anaconda, it is a lot easier to install some of the required geospatial libraries than when using the pure Python distribution.

Let's test if our basic set up is working.

• Check Python env with

python --version

If you are on a Windows machine, you will need to install.

• Powershell - A more powerful shell than the normal MSDOS in Windows

• Chocolatey - Windows package manager

• Check that choco is installed by installing jq and git

choco install jq

With jq we will be able to handle JSON data, check that it is installed with

jq --version

Getting the repo

This is a public Planet repository so you don't have to SSH authenticate to clone to your local environment. You can simply use

git clone [e-mail]:planetlabs/training-workshop.git

In case you do have to authenticate, you'll have to make sure your SSH keys are added to your Github profile. Only in case you don't have SSH keys already, generate them using

ssh-keygen -t rsa

Press enter when asked if you want to save the keys to id_rsa and, if you want, enter a passphrase when asked to.

Print out your keys, copy them and add them to your Github's saved keys.

cat .ssh/id_rsa.pub

Useful libraries

The following tools are regularly used in Planet School's guides:

• cURL
• GDAL
• requests
• retrying
• jq
• geojsonio-cli
• Rasterio
• Fiona
• NumPy
• MatPlotLib

If you choose to follow along with code here, you may find it useful to install these libraries in your development environment. You can do this by yourself simply using

pip install -r requirements.txt

or when using the Anaconda distribution

conda install --file requirements.txt

Important notes specifically for Windows users:
In Windows, it is a lot easier to install the core geospatial software libraries (GDAL, Rasterio, Fiona, among others) using Anaconda's package manager Conda than the standard Pip. Here is a detailed guide on how to set up your Python environment for geospatial programming using Anaconda. If you do chose to use the base installation of Python instead, we recommend to install these geospatial software packages directly using wheel installing files. You can grab the version needed for your OS easily in here.

Testing the set up

Now, let's make sure our Python env and dependencies are set up. First, let's check that the Planet tool is installed, do

planet --help

If you get an extensive help message about our CLI, we are good to go!
But remember, we can always install new packages simply using:

pip install PACKAGE_NAME

or when using Anaconda

conda install PACKAGE_NAME

Learning resources

Visit our learning hub: Planet's Developer Center. Explore Planet's API docs, references, tutorials, and developer tools: everything you need to start building with Planet today.

All tailored training decks will be available here once the workhops kick off. Below you can find some links to already publicly available resources

Some useful links:

• Data API docs
• Orders API docs
• Analytics API docs
• Tasking API docs
• Public APIs changelog
• Planet Python Client
• Planet integrations (QGIS plug-in)
• Quickstart guides
• Planet school
• Jupyter notebooks
• Imagery specs