Skip to content

MingyueX/GreenLens

Repository files navigation


Logo

An Intuitive App for Accelerating Forest Inventory Mapping 🌲


Download the APK » 📱

App Manual 📔 · View Our Paper 📑 · Report Bug 🛠️ · Request Feature 🙋

Table of Contents
  1. About The Project
  2. Getting Started
  3. Roadmap
  4. Contributing
  5. License
  6. Contact
  7. Citation

About The Project ℹ

Forest inventories serve as a foundation for forest planning and management, are key to understanding carbon sequestration dynamics, and are an essential basis for forest ecology research. Such an inventory is, essentially, the recording of certain parameters for each tree in a forest plot; these include location, height, and trunk diameter, typically at breast height (DBH).

An ideal approach to forest inventory should be available worldwide for mass adoption, require minimal capital expenditure and training, rapidly acquire data, and have a low error rate even in challenging field conditions. We believe we have achieved the above goals. Our solution uses ARCore, which is available on a wide variety of low-end smartphones, making it suitable for worldwide mass adoption. The user experience has been carefully designed to require minimal training and allow rapid data acquisition.

(back to top)

Built With 🔨

  • Flutter
  • arcore
  • Pytorch
  • OpenCV
  • Firebase

(back to top)

Current Functionality ⚙

  • User Registration/Login
  • Create/Edit/Manage the Plots
  • Create/Edit/Manage Trees in Each Plot
  • Record Collection Locations
  • Export Data (Tree ID, DBH, Species, Lat, Lon, RGB, Depth, Boundary...)

Getting Started 🔰

If you would like to try our app, please download our APK from Google Drive and install it on your Android phone (see Installation Tutorial). Before using the app, we strongly recommend checking Support Device to ensure device compatibility.

If you are a developer or an ecological researcher interested in understanding how the app operates in depth, you can clone this repository and open it in a IDE like Android Studio. This also allows you to customize some functionalities. However, before doing so, we recommend that you review our paper to understand the app's implementation details, image processing pipeline, and diameter estimation methodology.

Prerequisites 🔑

We recommend ARCore version >1.18.

Quick Installation ⚒

  • Download the APK and install it on your Android device
  • Open the app and wait patiently, the app will automatically download some dependencies, so this may take a while.
  • Complete the registration and you're ready to start!

(back to top)

Roadmap ✈

  • Add map service
  • Add boundary adjustment
  • Add user profile
  • Add IOS support
  • Multi-language Support
    • English
    • Chinese

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing 💪

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License 📖

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact 📞

Our Group Link: Energy and Environment Group

(back to top)

Citation 📚

@article{FENG2024102774,
title = {An app for tree trunk diameter estimation from coarse optical depth maps},
journal = {Ecological Informatics},
volume = {82},
pages = {102774},
year = {2024},
issn = {1574-9541},
doi = {https://doi.org/10.1016/j.ecoinf.2024.102774},
author = {Zhengpeng Feng and Mingyue Xie and Amelia Holcomb and Srinivasan Keshav}
}

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published