Home

Awesome

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.

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.

python --version

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

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 git@github.com: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:

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

<u>Important notes specifically for Windows users:</u> <br> 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! <br> 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: