DeepForest
What is DeepForest?
DeepForest is a python package for training and predicting ecological objects in airborne imagery. DeepForest currently comes with a tree crown object detection model and a bird detection model. Both are single class modules that can be extended to species classification based on new data. Users can extend these models by annotating and training custom models.
Documentation
DeepForest is documented on readthedocs
How does deepforest work?
DeepForest uses deep learning object detection networks to predict bounding boxes corresponding to individual trees in RGB imagery. DeepForest is built on the object detection module from the torchvision package and designed to make training models for detection simpler.
For more about the motivation behind DeepForest, see some recent talks we have given on computer vision for ecology and practical applications to machine learning in environmental monitoring.
Where can I get help, learn from others, and report bugs?
Given the enormous array of forest types and image acquisition environments, it is unlikely that your image will be perfectly predicted by a prebuilt model. Below are some tips and some general guidelines to improve predictions.
Get suggestions on how to improve a model by using the discussion board. Please be aware that only feature requests or bug reports should be posted on the issues page.
Developer Guidelines
If you are a new contributor to DeepForest, welcome and thank you! Here are some suggestions that we hope will make the submission process more smooth:
- Look out for good first issues. These should be accessible to less experienced developers and will help you get oriented with the code.
- Check that the functionality you are suggesting doesn't already exist. Perhaps it does, but needs improved documentation.
- Search for issues or discussions on Github already, before submitting a PR. Do check closed issues as well.
- If you are submitting a trivial improvement (like a one-line bug fix), feel free to PR directly, following the template.
- If you want to propose any non-trivial changes without an existing issue please open an issue to discuss the change prior to opening a PR. Non-trivial PR's submitted without an associated issue that includes maintainer approval to proceed with a PR will typically not be considered.
Please follow the developer's guide for more details on contribution.
License
Free software: MIT license
Why DeepForest?
Remote sensing can transform the speed, scale, and cost of biodiversity and forestry surveys. Data acquisition currently outpaces the ability to identify individual organisms in high-resolution imagery. Individual crown delineation has been a long-standing challenge in remote sensing, and available algorithms produce mixed results. DeepForest is the first open-source implementation of a deep learning model for crown detection. Deep learning has made enormous strides in a range of computer vision tasks but requires significant amounts of training data. By including a trained model, we hope to simplify the process of retraining deep learning models for a range of forests, sensors, and spatial resolutions.
Citation
Most usage of DeepForest should cite two papers.
The first is the DeepForest paper, which describes the package:
The second is the paper describing the model.
For the tree detection model cite:
For the bird detection model cite:
3 maintainers
Metadata
3 maintainers
Release files for deepforest 2.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| deepforest-2.1.0.tar.gz | 20.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| deepforest-2.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.3 MB
Release files / deepforest-2.1.0.tar.gz
| Download URL | deepforest-2.1.0.tar.gz |
|---|---|
| Size | 20.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fa224f3ae3c099876296f3b821de759a3be780162a19d49b42b313e0fc328d45
|
|
BLAKE2b-256 checksum How to use checksums |
811e3057d557a92ec20b9e1d2f86f21753614c78cb048b708ee1581b077b2e44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / deepforest-2.1.0-py3-none-any.whl
| Download URL | deepforest-2.1.0-py3-none-any.whl |
|---|---|
| Size | 20.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8c2798d8e9be7f0004b194fe207b76c1d9fff6e711b3db67b9508dcd5d00ae54
|
|
BLAKE2b-256 checksum How to use checksums |
b7a867e66685c81ec070372db546f933312c6d7401f845e200e5d900107ff51e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
