treediversity

Notebooks to calculate tree diversity indices (Shannon and Simpson) for planners, foresters, and ecologists!

https://github.com/diversitree/treediversity

Science Score: 10.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    2 of 3 committers (66.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.0%) to scientific vocabulary

Keywords

ecology forestry urban-planning
Last synced: 6 months ago · JSON representation

Repository

Notebooks to calculate tree diversity indices (Shannon and Simpson) for planners, foresters, and ecologists!

Basic Info
  • Host: GitHub
  • Owner: DiversiTree
  • License: cc-by-4.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Homepage:
  • Size: 23 MB
Statistics
  • Stars: 15
  • Watchers: 1
  • Forks: 3
  • Open Issues: 0
  • Releases: 0
Topics
ecology forestry urban-planning
Created about 5 years ago · Last pushed almost 5 years ago
Metadata Files
Readme License

README.md

Diversitree visual abstract

DiversiTree Notebooks

About

These Python notebooks are intended to help urban foresters, planners, greeners, and ecologists in quantifying tree ecosystem diversity in cities. Our recent study (citation) explored street tree diversity contrasted between the city center and outer areas, and we made these notebooks to compute tree diversity in these areas across two major dimensions:

  1. Diversity Indices: Using two entropy indices, the Shannon Index and Simpson Index, we can measure how evenly diversity exists in your tree inventory.

  2. 10/20/30 rule: Urban foresters have long used the 10/20/30 benchmark to measure diversity. The rule suggests no more than 10% of an urban tree ecosystem should be made up of the same species, 20% of the same genus, and 30% of the same family.

These notebooks calculate these measures based on boths tree stem count (the raw number of trees) and the basal area of the tree, estimated from the diameter at breast height value.

How To Use These Notebooks

The two notebooks in this repository conduct a simple sensitivity analysis to check if the number of trees is sufficient to calculate these diversity indices, and then calculates the city center and outer area results. Simple plots along the way will be provided!

To get started, gather the data as described below and open the first notebook. You'll need to add the file path to your data and input the column names needed in the notebook, and the rest of the notebook will run as you progress through the cells.

What You'll Need

Here's the data you'll need to use these notebooks: 1. City Center geography: To specify which trees are in the city center, you'll need a geospatial data file (geopackage, geojson, shapefile) with just the geometry of your city center. If multiple districts or geometries make up your city center area, we recommend dissolving these into a single feature.

  1. Tree data: You'll need tree inventory data with the following data attached:

    • Geographic location
    • Diameter at breast height (DBH)
    • Scientific or species name
    • Genus name
    • Family name (Some ways to add this data to your tree inventory include Open Tree of Life or Encyclopedia of Life)
  2. Jupyter Notebook: You'll need a Python 3 equipped Jupyter Notebook to run these analyses! The dependency packages needed are listed in requirements.txt and listed below:

  3. pandas

  4. geopandas

  5. matplotlib

  6. descartes

  7. tqdm

  8. numpy

Sample Data

Cleaned sample data for Paris, France is provided in this repository.

Publication

Galle, N., Halpern, D., Nitoslawski, S., Duarte, F., Ratti, C., & Pilla, F. (2021). Mapping the diversity of street tree inventories across eight cities internationally using open data. Urban Forestry and Urban Greening.

Website

Want to learn more? Check out DiversiTree's Website!

DiversiTree is a project of:

University College Dublin Logo    Senseable City Lab Logo


Connecting Nature Logo

This research received partial funding from the Connecting Nature project (Grant Agreement No. 730222) under the European Community’s Framework Program Horizon 2020.

GitHub Events

Total
Last Year

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 12
  • Total Committers: 3
  • Avg Commits per committer: 4.0
  • Development Distribution Score (DDS): 0.5
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Dylan d****h@m****u 6
DiversiTree 7****e@u****m 3
Dylan d****n@u****u 3
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 3
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • DiversiTree (3)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

requirements.txt pypi
  • descartes *
  • geopandas *
  • matplotlib *
  • numpy *
  • pandas *
  • tqdm *