https://github.com/carlos-alberto-silva/tlstools
Collate and visualise treeseg, optqsm and nallom outputs
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
1 of 1 committers (100.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.6%) to scientific vocabulary
Repository
Collate and visualise treeseg, optqsm and nallom outputs
Basic Info
- Host: GitHub
- Owner: carlos-alberto-silva
- License: mit
- Default Branch: master
- Size: 6.84 KB
Statistics
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
tlstools
- Combine treeseg, optqsm and nlallom results for analysis.
- Plot tree-level points clouds and quantitative structural models.
Overview
The Python script sortResults.py formats the results from treeseg, optqsm and nlallom into an accessible format for analysis.
That is, this script amalgamates the outputs of runallom.m and runopt.m into two NumPy files describing tree- and plot-scale volume- and allometric-derived above-ground biomass, alongside other structural parameters.
The variables comprising these NumPy files are described in VARIABLES.
This repository also contains a number of scripts for plotting tree-level point clouds and quantitative structural models.
Prerequisites
Python (v3.6.5 or later)
Python packages: * numpy * matplotlib
Installation
On macOS 10.13, dependencies were installed using Homebrew (https://brew.sh), as:
brew install python
pip3 install –upgrade pip setuptools wheel
pip3 install numpy
pip3 install scipy
pip3 install matplotlib
tlstools can then be installed as:
cd [INSTALLATION_DIR];
git clone https://github.com/apburt/nlallom.git;
Usage
sortResults.py is called as:
sortResults.py -at [PLOT_ID]_tree.txt -ap [PLOT_ID]_plot.txt -m [PLOT_ID]_models.dat
Where [PLOTID]tree.txt and [PLOTID]plot.txt are the results files from runallom.m, and [PLOTID]models.dat the results file from runopt.m. The combined results will be written in the current working directory as [PLOTID]tree.npy and [PLOTID]plot.npy.
The plotting scripts can be called, such as in the example of plotModels.py, as:
plotModels.py -m [QSM].mat
Where [QSM].mat is any quantitative structural models generated from TreeQSM or optqsm. The optional flags -a, -e, -o, -q, -ax, define azimuth/elevation angles, output image file name, high quality cylinder rendering and axes display respectively. Further optional flags are defined in the parser section of each script.
By default, these plots are written as vector images in PDF format. These can be rasterised via ImageMagick, e.g.,:
convert -trim +repage -density 600 -units pixelsperinch OUTFILE.pdf OUTFILE.png
Authors
- Andrew Burt
License
This project is licensed under the MIT License - see the LICENSE file for details
Owner
- Name: Carlos Alberto Silva
- Login: carlos-alberto-silva
- Kind: user
- Company: University of Florida
- Website: https://carlos-alberto-silva.github.io/silvalab/home.html
- Twitter: Web_LiDAR
- Repositories: 100
- Profile: https://github.com/carlos-alberto-silva
GitHub Events
Total
Last Year
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| apburt | a****t@u****k | 2 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: over 2 years ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total 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
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