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.
- Python 3.7 <br> 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 installingjq
andgit
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: