Skip to content

FrankFeng-23/GreenLens

 
 

Repository files navigation


Logo

An Intuitive App for Accelerating Forest Inventory Mapping 🌲


Download the APK » 📱

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
  • Species Identification
  • 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 APKPure and install it on your Android phone. 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 refer to the following guidelines to run the app. However, before doing so, we still recommend that you review our paper to understand the app's architecture, image processing pipeline, and diameter estimation methodology.

Prerequisites 🔑

TODO

Installation ⚒

TODO

  1. Clone the repo
    git clone https://github.com/FrankFeng-23/GreenLens.git

(back to top)

Roadmap ✈

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

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{feng2023trunk,
  title={A Trunk Diameter Estimation Mobile App for the Masses},
  author={Feng, Zhengpeng and Xie, Mingyue and Holcomb, Amelia and Keshav, Srinivasan},
  booktitle={Cambridge Open Engage. doi:10.33774/coe-2023-6z4wb-v2}
  year={2023}
}

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 68.5%
  • Python 13.7%
  • C++ 6.9%
  • CMake 5.3%
  • Kotlin 3.1%
  • Ruby 0.8%
  • Other 1.7%