Detecting deforestation from satellite images: a full stack deep learning project
A deep learning approach to detecting deforestation risk, using satellite images and a deep learning model. We relied on Planet imagery from two Kaggle datasets (one from the Amazon rainforest and another on oil palm plantations in Borneo) and trained a ResNet model using FastAI. For more details, check the following links:
This is the result of a group project, made by André Ferreira and Karthik Bhaskar, for the Full Stack Deep Learning - Spring 2021 online course.
- Initialize
gitinside your repo:
git init- If you don't have
Poetryinstalled run:
make download-poetry- Initialize poetry and install
pre-commithooks:
make install- Upload initial code to GitHub (ensure you've run
make installto usepre-commit):
git add .
git commit -m ":tada: Initial commit"
git branch -M main
git remote add origin https://github.com/karthikraja95/fsdl_deforestation_detection.git
git push -u origin main- Set up Dependabot to ensure you have the latest dependencies.
- Set up Stale bot for automatic issue closing.
All manipulations with dependencies are executed through Poetry. If you're new to it, look through the documentation.
Notes about Poetry
Poetry's commands are very intuitive and easy to learn, like:
poetry add numpypoetry run pytestpoetry build- etc
Makefile contains many functions for fast assembling and convenient work.
1. Download Poetry
make download-poetry2. Install all dependencies and pre-commit hooks
make installIf you do not want to install pre-commit hooks, run the command with the NO_PRE_COMMIT flag:
make install NO_PRE_COMMIT=13. Check the security of your code
make check-safetyThis command launches a Poetry and Pip integrity check as well as identifies security issues with Safety and Bandit. By default, the build will not crash if any of the items fail. But you can set STRICT=1 for the entire build, or you can configure strictness for each item separately.
make check-safety STRICT=1or only for safety:
make check-safety SAFETY_STRICT=1multiple
make check-safety PIP_STRICT=1 SAFETY_STRICT=1List of flags for
check-safety(can be set to1or0):STRICT,POETRY_STRICT,PIP_STRICT,SAFETY_STRICT,BANDIT_STRICT.
4. Check the codestyle
The command is similar to check-safety but to check the code style, obviously. It uses Black, Darglint, Isort, and Mypy inside.
make check-styleIt may also contain the STRICT flag.
make check-style STRICT=1List of flags for
check-style(can be set to1or0):STRICT,BLACK_STRICT,DARGLINT_STRICT,ISORT_STRICT,MYPY_STRICT.
5. Run all the codestyle formaters
Codestyle uses pre-commit hooks, so ensure you've run make install before.
make codestyle6. Run tests
make test7. Run all the linters
make lintthe same as:
make test && make check-safety && make check-styleList of flags for
lint(can be set to1or0):STRICT,POETRY_STRICT,PIP_STRICT,SAFETY_STRICT,BANDIT_STRICT,BLACK_STRICT,DARGLINT_STRICT,ISORT_STRICT,MYPY_STRICT.
8. Build docker
make dockerwhich is equivalent to:
make docker VERSION=latestMore information here.
This project is licensed under the terms of the MIT license. See LICENSE for more details.
@misc{fsdl_deforestation_detection,
author = {Karthik Bhaskar, Andre Ferreira},
title = {Predicting deforestation from Satellite Images},
year = {2021},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/karthikraja95/fsdl_deforestation_detection}}
}