| Name | 3DFin JSON |
| Version |
0.4.1
JSON |
| download |
| home_page | None |
| Summary | Automatic dendrometry and forest inventory for terrestrial point clouds, application package |
| upload_time | 2024-06-28 13:50:26 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
forestry
lidar
tls
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<img width="892" alt="3dfin_logo" src="https://user-images.githubusercontent.com/68945855/233049674-8d2c96a7-8abc-4a7c-8e83-4a329ba6dd0c.png">
Welcome to 3DFin: 3D Forest inventory's official repository!
3DFin is a free software for automatic computation of tree parameters in terrestrial point clouds. It offers the users a quick, ease-of-use interface to load their forest plots and generate tree metrics with just a few clicks.
# Getting Started
Be sure to check the [Documentation](https://github.com/3DFin/3DFin/blob/main/src/three_d_fin/documentation/documentation.pdf), which features detailed explanations on how the program works and an User Manual.
Also, the [Tutorial](https://github.com/3DFin/3DFin_Tutorial) covers the basics of 3DFin and is a great tool to get started.
# Download
3DFin is freely available in 4 ways:
1. As a CloudCompare plugin (**Windows and Linux**)
2. As a QGIS plugin
3. As a standalone program (**Only in Windows**)
4. As a Python package (**In Windows, Linux and macOS**)
## 1. CloudCompare plugin
3DFin is available in Windows as a **plugin in CloudCompare (2.13)** thanks to CloudCompare PythonRuntime (see [References](#references)). You can download the latest version CloudCompare (Windows installer version) including the 3DFin plugin here:
[CloudCompare](https://www.danielgm.net/cc/release/)
Simply install the latest version of CloudCompare and tick Python and 3DFin's checkbox during the installation:
**To install 3DFin plugin, tick the 'Python plugin support' checkbox during CloudCompare installation.**
For Linux, the plugin is embedded into the CloudCompare [flatpak](https://flathub.org/fr/apps/org.cloudcompare.CloudCompare).
**3DFin plugin in CloudCompare.**
Running the plugin will open 3DFin's graphical user interface (GUI).
**3DFin GUI. It is common to any version of 3DFin.**
## 2. QGIS plugin
3DFin is also available as a plugin in [QGIS](https://www.qgis.org/en/site/). Please follow the instructions available [here](https://github.com/3DFin/3DFin-QGIS) in order to test it.
Note that for now this does not provide much added value in comparison with CloudCompare and Standalone version of 3DFin.
## 3. Standalone program
3DFin is also available in Windows and macOS as a standalone program, which can be downloaded from here:
[Standalone](https://github.com/3DFin/3DFin/releases).
`3DFin.exe` file is the Windows version while `3DFin` is the macOS version.
These binaries are built into Github servers and are thus unsigned and unverified. As consequences, while executing theses binaries your system may warn from security issues and should ask you to grant some permissions.
If you have a complete Python environment on your system, please consider installing 3DFin standalone via [`pip` package manager](#4-python-package-3dfin).
Older versions of 3DFin standalone may also be downloaded from [Releases](https://github.com/3DFin/3DFin/releases/). From there, simply navigate to the desired version and click on __3DFin[.exe]__.
## 4. Python package (3DFin)
3DFin and its dependencies may be installed and launched **in any OS (Windows, Linux and macOS)** as a Python package:
```console
pip install 3DFin
python -m three_d_fin
```
*If you are a macOS or Linux user and you may want to try 3DFin, this is the way you should proceed.*
`pip` will also install a script entry point in your Python installation's bin|script directory, so alternatively you can launch 3DFin from the command line with:
```console
3DFin[.exe]
```
# Usage
CloudCompare plugin is the reccomended way of using 3DFin, as it provides enhanced features for visualisation of the results and exporting of the outputs (it allows to export the results as a CloudCompare native BIN file).
By default, running 3DFin (either the CloudCompare plugin or any version of 3DFin) will open a GUI window.
For batch processing you can use the CLI capabilities of 3DFin and running the following command:
```console
3DFin[.exe] cli --help
```
will give you an overview of the available parameters.
# Citing 3DFin
If you use 3DFin in your research, please cite the following paper:
Laino, D., Cabo, C., Prendes, C., Janvier, R., Ordonez, C., Nikonovas, T., Doerr, S., & Santin, C. (2024). 3DFin: a software for automated 3D forest inventories from terrestrial point clouds. Forestry: An International Journal of Forest Research. https://doi.org/10.1093/forestry/cpae020
Thank you for citing 3DFin in your work! Your citations help to support the continued development and maintenance of this software.
# References
CloudCompare-PythonRuntime, by Thomas Montaigu: [CloudCompare-PythonRuntime](https://github.com/tmontaigu/CloudCompare-PythonRuntime)
# Acknowledgement
3DFin has been developed at the Centre of Wildfire Research of Swansea University (UK) in collaboration with the Research Institute of Biodiversity (CSIC, Spain) and the Department of Mining Exploitation of the University of Oviedo (Spain).
Funding provided by the UK NERC project (NE/T001194/1):
'_Advancing 3D Fuel Mapping for Wildfire Behaviour and Risk Mitigation Modelling_'
and by the Spanish Knowledge Generation project (PID2021-126790NB-I00):
‘_Advancing carbon emission estimations from wildfires applying artificial intelligence to 3D terrestrial point clouds_’.
Raw data
{
"_id": null,
"home_page": null,
"name": "3DFin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "forestry, lidar, tls",
"author": null,
"author_email": "Carlos Cabo <carloscabo@uniovi.es>, Diego Laino <diegolainor@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b6/93/2a2657cd9bb2a8490e9b2161474034157a4c3597b96c9a58c6f0ae4acce6/3dfin-0.4.1.tar.gz",
"platform": null,
"description": "\n<img width=\"892\" alt=\"3dfin_logo\" src=\"https://user-images.githubusercontent.com/68945855/233049674-8d2c96a7-8abc-4a7c-8e83-4a329ba6dd0c.png\">\n\nWelcome to 3DFin: 3D Forest inventory's official repository!\n\n3DFin is a free software for automatic computation of tree parameters in terrestrial point clouds. It offers the users a quick, ease-of-use interface to load their forest plots and generate tree metrics with just a few clicks.\n\n\n# Getting Started \n\nBe sure to check the [Documentation](https://github.com/3DFin/3DFin/blob/main/src/three_d_fin/documentation/documentation.pdf), which features detailed explanations on how the program works and an User Manual.\n\nAlso, the [Tutorial](https://github.com/3DFin/3DFin_Tutorial) covers the basics of 3DFin and is a great tool to get started.\n\n\n# Download \n\n3DFin is freely available in 4 ways:\n1. As a CloudCompare plugin (**Windows and Linux**)\n2. As a QGIS plugin\n3. As a standalone program (**Only in Windows**)\n4. As a Python package (**In Windows, Linux and macOS**)\n\n## 1. CloudCompare plugin \n\n3DFin is available in Windows as a **plugin in CloudCompare (2.13)** thanks to CloudCompare PythonRuntime (see [References](#references)). You can download the latest version CloudCompare (Windows installer version) including the 3DFin plugin here:\n\n[CloudCompare](https://www.danielgm.net/cc/release/)\n\nSimply install the latest version of CloudCompare and tick Python and 3DFin's checkbox during the installation:\n\n**To install 3DFin plugin, tick the 'Python plugin support' checkbox during CloudCompare installation.** \n\n\nFor Linux, the plugin is embedded into the CloudCompare [flatpak](https://flathub.org/fr/apps/org.cloudcompare.CloudCompare). \n\n**3DFin plugin in CloudCompare.**\n\n\nRunning the plugin will open 3DFin's graphical user interface (GUI). \n**3DFin GUI. It is common to any version of 3DFin.**\n\n\n\n## 2. QGIS plugin \n\n3DFin is also available as a plugin in [QGIS](https://www.qgis.org/en/site/). Please follow the instructions available [here](https://github.com/3DFin/3DFin-QGIS) in order to test it. \nNote that for now this does not provide much added value in comparison with CloudCompare and Standalone version of 3DFin.\n\n## 3. Standalone program\n\n3DFin is also available in Windows and macOS as a standalone program, which can be downloaded from here: \n\n[Standalone](https://github.com/3DFin/3DFin/releases). \n\n`3DFin.exe` file is the Windows version while `3DFin` is the macOS version.\nThese binaries are built into Github servers and are thus unsigned and unverified. As consequences, while executing theses binaries your system may warn from security issues and should ask you to grant some permissions. \nIf you have a complete Python environment on your system, please consider installing 3DFin standalone via [`pip` package manager](#4-python-package-3dfin).\n\nOlder versions of 3DFin standalone may also be downloaded from [Releases](https://github.com/3DFin/3DFin/releases/). From there, simply navigate to the desired version and click on __3DFin[.exe]__.\n\n\n## 4. Python package (3DFin)\n\n3DFin and its dependencies may be installed and launched **in any OS (Windows, Linux and macOS)** as a Python package: \n\n```console\npip install 3DFin\npython -m three_d_fin\n```\n\n*If you are a macOS or Linux user and you may want to try 3DFin, this is the way you should proceed.*\n\n`pip` will also install a script entry point in your Python installation's bin|script directory, so alternatively you can launch 3DFin from the command line with: \n\n```console\n3DFin[.exe]\n```\n\n# Usage\n\nCloudCompare plugin is the reccomended way of using 3DFin, as it provides enhanced features for visualisation of the results and exporting of the outputs (it allows to export the results as a CloudCompare native BIN file). \n\nBy default, running 3DFin (either the CloudCompare plugin or any version of 3DFin) will open a GUI window.\n\nFor batch processing you can use the CLI capabilities of 3DFin and running the following command:\n```console\n3DFin[.exe] cli --help\n```\nwill give you an overview of the available parameters. \n\n\n# Citing 3DFin\n\nIf you use 3DFin in your research, please cite the following paper:\n\nLaino, D., Cabo, C., Prendes, C., Janvier, R., Ordonez, C., Nikonovas, T., Doerr, S., & Santin, C. (2024). 3DFin: a software for automated 3D forest inventories from terrestrial point clouds. Forestry: An International Journal of Forest Research. https://doi.org/10.1093/forestry/cpae020\n\nThank you for citing 3DFin in your work! Your citations help to support the continued development and maintenance of this software.\n\n# References \n\nCloudCompare-PythonRuntime, by Thomas Montaigu: [CloudCompare-PythonRuntime](https://github.com/tmontaigu/CloudCompare-PythonRuntime)\n\n# Acknowledgement\n\n3DFin has been developed at the Centre of Wildfire Research of Swansea University (UK) in collaboration with the Research Institute of Biodiversity (CSIC, Spain) and the Department of Mining Exploitation of the University of Oviedo (Spain). \n\nFunding provided by the UK NERC project (NE/T001194/1): \n\n'_Advancing 3D Fuel Mapping for Wildfire Behaviour and Risk Mitigation Modelling_' \n\nand by the Spanish Knowledge Generation project (PID2021-126790NB-I00): \n\n\u2018_Advancing carbon emission estimations from wildfires applying artificial intelligence to 3D terrestrial point clouds_\u2019.\n",
"bugtrack_url": null,
"license": null,
"summary": "Automatic dendrometry and forest inventory for terrestrial point clouds, application package",
"version": "0.4.1",
"project_urls": {
"Documentation": "https://github.com/3DFin/3DFin#README.md",
"Issues": "https://github.com/3DFin/3DFin/issues",
"Source": "https://github.com/3DFin/3DFin"
},
"split_keywords": [
"forestry",
" lidar",
" tls"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f081702e8c808a69244b9720342300bfa3918832cda94a7691c81f1669040ecb",
"md5": "b4eb07c44a62a68242bffe72b3ab78fd",
"sha256": "e48f1b9b46cec7f5ef5af35c35db0a138a8a932bf042f417110b29e32e50329c"
},
"downloads": -1,
"filename": "3dfin-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b4eb07c44a62a68242bffe72b3ab78fd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 4655887,
"upload_time": "2024-06-28T13:50:24",
"upload_time_iso_8601": "2024-06-28T13:50:24.224338Z",
"url": "https://files.pythonhosted.org/packages/f0/81/702e8c808a69244b9720342300bfa3918832cda94a7691c81f1669040ecb/3dfin-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b6932a2657cd9bb2a8490e9b2161474034157a4c3597b96c9a58c6f0ae4acce6",
"md5": "3b528c88a9b1855209fbf3d096bf8a66",
"sha256": "1608abe258f64cdf76100f266f8244959c8f0d805f65ffe45c7648df65ba5f3f"
},
"downloads": -1,
"filename": "3dfin-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "3b528c88a9b1855209fbf3d096bf8a66",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 4698084,
"upload_time": "2024-06-28T13:50:26",
"upload_time_iso_8601": "2024-06-28T13:50:26.737840Z",
"url": "https://files.pythonhosted.org/packages/b6/93/2a2657cd9bb2a8490e9b2161474034157a4c3597b96c9a58c6f0ae4acce6/3dfin-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-28 13:50:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "3DFin",
"github_project": "3DFin#README.md",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "3dfin"
}
