• Stars
    star
    131
  • Rank 275,867 (Top 6 %)
  • Language
    Python
  • License
    Creative Commons ...
  • Created about 6 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Benchmark dataset for tree detection for airborne RGB, Hyperspectral and LIDAR imagery

A multi-sensor benchmark dataset for detecting individual trees in airborne RGB, Hyperspectral and LIDAR point clouds

Individual tree detection is a central task in forestry and ecology. Few papers analyze proposed methods across a wide geographic area. The NeonTreeEvaluation dataset is a set of bounding boxes drawn on RGB imagery for 22 sites in the National Ecological Observation Network (NEON). Each site covers a different forest type(e.g. TEAK). This dataset is the first to have consistant annotations across a variety of ecosystems for co-registered RGB, LiDAR and hyperspectral imagery. In total this repo holds 30975 Tree annotations.

A static version of this benchmark can be downloaded from zenodo. https://zenodo.org/record/5914554#.YfRhcPXMKHE

Evaluation images are included in this repo under /evaluation folder. Annotation files (.xml) are included in this repo under /annotations/

Note: Not all plots in the evaluation folder contain annotations, many are unannotated to support future growth of the benchmark.

Mantainer: Ben Weinstein - University of Florida.

How do I evaluate against the benchmark?

We have built an R package for easy evaluation and interacting with the benchmark evaluation data.

https://github.com/weecology/NeonTreeEvaluation_package

How were images annotated?

Each visible tree was annotated to create a bounding box that encompassed all portions of the vertical object. Fallen trees were not annotated. Visible standing stags were annotated.

For the point cloud annotations, the two dimensional bounding boxes were draped over the point cloud, and all non-ground points (height < 2m) were excluded. Minor cosmetic cleanup was performed to include missing points. In general, the point cloud annotations should be seen as less thoroughly cleaned, given the tens of thousands of potential points in each image.

RGB

library(raster)
library(NeonTreeEvaluation)

#Read RGB image as projected raster
rgb_path<-get_data(plot_name = "SJER_059_2018",type="rgb")
rgb<-stack(rgb_path)

#Path to annotations dataset
annotation_path <- get_data("SJER_059_2018",type="annotations")
annotations <- xml_parse(annotation_path)

#View one plot's annotations as polygons, project into UTM
#copy project utm zone (epsg), xml has no native projection metadata
boxes<-boxes_to_spatial_polygons(annotations, rgb)

plotRGB(rgb)
plot(boxes,add=T, col=NA, border="red")

Lidar

To access the draped lidar hand annotations, use the "label" column. Each tree has a unique integer.

library(lidR)
path<-get_data("TEAK_052_2018",type="lidar")
r<-readLAS(path)
trees<-lasfilter(r,!label==0)
plot(trees,color="label")

The same is true for the training tiles (see below)

We elected to keep all points, regardless of whether they correspond to tree annotation. Non-tree points have value 0. We recommend removing these points before evaluating the point cloud. Since the annotations were made in the RGB and then draped on to the point cloud, there will be some erroneous points at the borders of trees.

Hyperspectral

Hyperspectral surface reflectance (NEON ID: DP1.30006.001) is a 426 band raster covering visible and near infared spectrum.

path<-get_data("MLBS_071_2018",type="hyperspectral")
g<-stack(path)
nlayers(g)
[1] 426
#Grab a three band combination to view as false color
g<-g[[c(17,55,113)]]
nlayers(g)
[1] 3
plotRGB(g,stretch="lin")

And in the training data:

Training Tiles

We have uploaded the large training tiles to Zenodo for download.

https://zenodo.org/record/5914554#.YfRhcPXMKHE

The annotations are alongside the evaluation annotations in this repo. Not every training tile has all three data types. There are several known omissions.

  • 2019_DSNY_5_452000_3113000_image_crop.tif does not have a LiDAR point cloud.
  • 2019_YELL_2_541000_4977000_image_crop.tif is unprojected and does not have CHM, LIDAR or HSI data
  • 2019_YELL_2_528000_4978000_image_crop2.tif is unprojected and does not have CHM, LIDAR or HSI data
  • 2019_ONAQ_2_367000_4449000_image_crop.tif is projected, but NEON did not have any LiDAR data at the site

These tiles represent a small portion of the annotations and can be removed if HSI and LiDAR data are used.

Performance

See the R package for current data and scores. This repo is just to hold the annotations in version control.

https://github.com/weecology/NeonTreeEvaluation_package

Cited

1 Weinstein, Ben G., et al. "Individual tree-crown detection in RGB imagery using semi-supervised deep learning neural networks." Remote Sensing 11.11 (2019): 1309. https://www.mdpi.com/2072-4292/11/11/1309 Thanks to the lidR R package for making algorithms accessible for comparison.

More Repositories

1

DeepForest

Python Package for Airborne RGB machine learning
Python
512
star
2

retriever

Quickly download, clean up, and install public datasets into a database management system
Python
307
star
3

ogrants

Open grants list
R
129
star
4

DeepTreeAttention

Implementation of Hang et al. 2020 "Hyperspectral Image Classification with Attention Aided CNNs" for tree species prediction
Python
118
star
5

DeepLidar

LIDAR and RGB Deep Learning Model for Individual Tree Segmentation
Python
58
star
6

data-sharing-paper

Paper on data sharing in ecology for IEE special issue
Shell
46
star
7

PortalData

Official Repo of the Portal Project Data
R
46
star
8

LDATS

Latent Dirichlet Allocation coupled with Bayesian Time Series analyses
R
25
star
9

NeonTreeEvaluation_package

R package for evaluating individual tree crown predictions against a diverse benchmark dataset
R
22
star
10

forecasting-course

Morgan Ernest & Ethan White's Ecological Forecasting & Dynamics Course
HTML
20
star
11

DeepForest-pytorch

Pytorch implementation of the deepforest model for tree crown RGB detection.
JavaScript
17
star
12

livedat

Template for living data workflow
R
15
star
13

portal-teachingdb

A simplified version of the Portal Project database designed for teaching
Python
14
star
14

MATSS

R Package for Macroecological Analysis of Time Series Structure (MATSS)
R
14
star
15

white-etal-2012-ecology

Code for replicating "Characterizing species-abundance distributions across taxa and ecosystems using a simple maximum entropy model" by Ethan P. White, Katherine M. Thibault, and Xiao Xiao
Python
13
star
16

portalr

A collection of functions to summarize the Portal Data
R
11
star
17

BirdDetector

A global bird detector model for the DeepForest-pytorch package
Jupyter Notebook
10
star
18

METE

Software for fitting and testing John Harte and colleagues' Maximum Entropy Theory of Ecology.
Python
10
star
19

deepforestr

TeX
10
star
20

macroecotools

Tools for Macroecological Analyses Using Python
Python
9
star
21

pydataweaver

The Pydata Weaver: A data Integration platform
Python
9
star
22

portalPredictions

Using various models to forecast abundances at Portal
9
star
23

portalcasting

Model development, deployment, and evaluation for forecasting Portal ecosystem dynamics
R
8
star
24

TreeSegmentation

Reproducible analysis of tree segmentation methods in R.
HTML
8
star
25

sad-comparison

Elita Baldridge's dissertation repository
Python
8
star
26

forecasting-dynamics-course

Morgan Ernest and Ethan White's course on Ecological Dynamics and Forecasting
HTML
8
star
27

MillionTrees

The MillionTreesBenchmark
Python
8
star
28

abundance

zero-inflated negative binomial neural network with variational approximation to site-level & observer-level random effects
Jupyter Notebook
7
star
29

bibliometrics

Bibliometric research
Python
7
star
30

bbs-forecasting

Research on forecasting using Breeding Bird Survey data
Jupyter Notebook
7
star
31

retrieverdash

Dashboard for retriever dataset status
Python
6
star
32

MATSS-forecasting

Forecasting Analysis Comparison for Ecological Time Series
R
5
star
33

Retriever.jl

Julia wrapper for the Data Retriever software
Julia
5
star
34

mete-spatial

Research on the spatial predictions of METE
R
5
star
35

retriever-recipes

Python
5
star
36

website

Lab website
TeX
4
star
37

livedat-github-actions

R
4
star
38

experimental-rads

R
3
star
39

MATSS-LDATS

Macroecological LDA analysis of time series
R
3
star
40

NeonTreeEvaluation_python

python benchmark for individual tree crown methods
Python
3
star
41

DeepForest_demos

DEPRECATED DeepForest demos
Jupyter Notebook
3
star
42

ratdat

R package version of Portal Project Teaching Database
R
3
star
43

branch-arch

HTML
3
star
44

neonwranglerpy

Python
3
star
45

EvergladesWadingBird

Data from the Everglades breeding bird monitoring project
R
3
star
46

ecology-data-cache

2
star
47

lab-manual

Shell
2
star
48

mvgamportal

R
2
star
49

DeepForest_Model

Companion repo to DeepForest for training large models from DeepForest python package.
Python
2
star
50

MATSSdemo

Automated build of a MATSS compendium
HTML
2
star
51

forecast_evaluation

Methods and tools for evaluating probabilistic forecasts
R
2
star
52

feasiblesets

Research code for understanding distributions of wealth in the context of all possible distributions
C
2
star
53

DoubleCounting

A repo for visualizing airborne imagery, making a prediction with a deepforest model and remove double counting among overlapping images.
Python
2
star
54

mete-geog

Research on making geographic predictions for macroecological patterns using the Maximum Entropy Theory of Ecology
R
2
star
55

mcdb

Mammal community database updates
1
star
56

diversity-conservation

Python
1
star
57

datawiki

Efforts related to http://ecologicaldata.org
PHP
1
star
58

portal-tools

Code for working with the Portal Project data
Python
1
star
59

NEON_crown_maps

Generating tree crown maps for NEON sites
HTML
1
star
60

retriever-website

Website for the EcoData Retriever
CSS
1
star
61

retriever-site

http://www.data-retriever.org
CSS
1
star
62

portal-exploration

Exploration of the Portal data, using portalr
R
1
star
63

EvergladesSpeciesModel

A deepforest model for wading bird species prediction.
Python
1
star
64

DeepTreeScape

Joint RGB and Deep Learning for individual tree detection
Makefile
1
star
65

mete-energy

Research on the energetic predictions of METE
Python
1
star
66

ESA_workshop_2022

lessons taught at the ESA workshop 2022 titled
HTML
1
star
67

NeonTreeEvaluation_analysis

This is the companion repo that presents analysis for methods tested on the NeonTreeEvaluation benchmark repo
Python
1
star
68

NeonSpeciesBenchmark

A tree species classification benchmark for the National Ecological Observatory Network
Python
1
star
69

NDVIning

sifting and comparing multiple NDVI sources and ensembles
R
1
star
70

forecasts

Archived forecasts for future analysis
1
star
71

portal-explorer

Shiny App for exploratory data analysis of the Portal Project
R
1
star
72

portal-experimental-macroeco

Code for reproducing the results from "An experimental test of the response of macroecological patterns to altered species interactions" by Sarah Supp et al. 2013 publishe in Ecology
1
star
73

bbc-data-rescue

Extracting data from Breeding Bird Census publications
Python
1
star
74

portal-rodent-dispersal

Research on rodent dispersal patterns near Portal AZ
R
1
star
75

MATSS-startup

Macroecological Analysis of Time Series Structure
R
1
star
76

TreeDemo

Shiny app for tree detection in RGB imagery
Python
1
star
77

wader

A collection of functions to retrieve and summarize the EvergladesWadingBird Data
R
1
star
78

AirborneBirds

The Airborne Birds benchmark
1
star
79

wiki

Weecology's Wiki - how to navigate life in the lab from choosing and pursuing a career path to using the printer
HTML
1
star