icepy4d
ICEpy4D is a multi-purpose Python package for 4D Image-based Continuos monitoring of glaciers' Evolution with deep learning SfM and low-cost stereo-cameras
Science Score: 39.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 6 DOI reference(s) in README -
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (14.9%) to scientific vocabulary
Keywords
Repository
ICEpy4D is a multi-purpose Python package for 4D Image-based Continuos monitoring of glaciers' Evolution with deep learning SfM and low-cost stereo-cameras
Basic Info
- Host: GitHub
- Owner: franioli
- License: bsd-3-clause
- Language: Jupyter Notebook
- Default Branch: main
- Homepage: https://franioli.github.io/icepy4d/
- Size: 207 MB
Statistics
- Stars: 22
- Watchers: 1
- Forks: 4
- Open Issues: 1
- Releases: 1
Topics
Metadata Files
README.md
Welcome to ICEpy4D
4D Image-based Continuos monitoring of glaciers' Evolution with low-cost stereo-cameras and Deep Learning photogrammetry.
ICEpy4D is a under active development.
Gettin Started
To get started with ICEpy4D you can refer documentation at https://franioli.github.io/icepy4d/ (please, note the documentation is currently under development).
You can find some Jupyter Notebooks with examples in the notebooks folder.
Requirements
- 64-bit Python
>= 3.8but< 3.10 - a NVIDIA graphic card with CUDA capability is strongly reccomended.
Installation guide
Create a new Anaconda environment
bash
conda create -n icepy4d python=3.9
conda activate icepy4d
Install Icepy4D from PyPi repository
bash
pip install icepy4d
or install it from source by cloning the repository and installing it with pip
bash
git clone https://github.com/franioli/icepy4d.git
cd icepy4d
pip install -e .
In case of any error when installing ICEpy4D from PyPi, try to install it from source.
Install Metashape Python API for Bundle Adjustment and Dense reconstruction.
Metashape Python API can be downloaded from https://www.agisoft.com/downloads/installer/ or use wget (under Linux).
bash
wget https://s3-eu-west-1.amazonaws.com/download.agisoft.com/Metashape-1.8.5-cp35.cp36.cp37.cp38-abi3-linux_x86_64.whl
pip install Metashape-1.8.5-cp35.cp36.cp37.cp38-abi3-linux_x86_64.whl
You need to have a valid Metashape license to use the API and you need to activate it (see https://github.com/franioli/metashape for how to do it)
Try to import ICEpy4D package
bash
conda activate icepy4d
python -c "import icepy4d"
If no error is given, ICEpy4D is successfully installed and it can be imported within your script with import icepy4d
Cite ICEpy4D
If you use ICEpy4D in your research, please cite it as:
bibtex
@article{ioli2024,
title={Deep Learning Low-cost Photogrammetry for 4D Short-term Glacier Dynamics Monitoring},
author={Ioli, Francesco and Dematteis, Nicol and Giordan, Daniele and Nex, Francesco and Pinto Livio},
journal={PFG Journal of Photogrammetry, Remote Sensing and Geoinformation Science},
year={2024},
DOI = {10.1007/s41064-023-00272-w}
}
bibtex
@article{ioli2023replicable,
title={A Replicable Open-Source Multi-Camera System for Low-Cost 4d Glacier Monitoring},
author={Ioli, F and Bruno, E and Calzolari, D and Galbiati, M and Mannocchi, A and Manzoni, P and Martini, M and Bianchi, A and Cina, A and De Michele, C and others},
journal={The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences},
doi={10.5194/isprs-archives-XLVIII-M-1-2023-137-2023},
url={[https://doi.org/10.5194/isprs-archives-XLVIII-M-1-2023-137-2023](https://doi.org/10.5194/isprs-archives-XLVIII-M-1-2023-137-2023)},
volume={XLVIII-M-1-2023},
pages={137--144},
year={2023},
publisher={Copernicus GmbH}
}
For contributing
Install additional requirements for development:
bash
pip install -e .[dev]
pre-commit install
Permissions and acknowledgements
Owner
- Name: Francesco Ioli
- Login: franioli
- Kind: user
- Location: Zurich
- Company: University of Zurich
- Website: https://www.geo.uzh.ch/en/units/rse.html
- Twitter: francescoioli
- Repositories: 52
- Profile: https://github.com/franioli
Post-Doc in the RSE - Remote Sensing of Environmental Changes @ UZH. Previously PhD in geoinformatics at @labmgf-polimi, Politecnico di Milano
GitHub Events
Total
- Watch event: 7
- Fork event: 1
Last Year
- Watch event: 7
- Fork event: 1
Committers
Last synced: over 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Francesco Ioli | f****i@p****t | 647 |
| Francesco Ioli | 5****i | 14 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: over 1 year ago
All Time
- Total issues: 7
- Total pull requests: 79
- Average time to close issues: 3 months
- Average time to close pull requests: 26 minutes
- Total issue authors: 1
- Total pull request authors: 1
- Average comments per issue: 0.43
- Average comments per pull request: 0.03
- Merged pull requests: 68
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 2
- Average time to close issues: N/A
- Average time to close pull requests: less than a minute
- Issue authors: 1
- Pull request authors: 1
- Average comments per issue: 0.0
- Average comments per pull request: 0.0
- Merged pull requests: 2
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- franioli (7)
Pull Request Authors
- franioli (80)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 12 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 4
- Total maintainers: 1
pypi.org: icepy4d
4D Image-based Continuos monitoring of glaciers Evolution with low-cost stereo-cameras and Deep Learning photogrammetry.
- Homepage: https://github.com/franioli/icepy4d
- Documentation: https://icepy4d.readthedocs.io/
- License: BSD 3-Clause License Copyright (c) 2018, the respective contributors, as shown by the AUTHORS file. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
Latest release: 1.7.0
published over 2 years ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v3 composite
- actions/setup-python v3 composite
- actions/cache v3 composite
- actions/checkout v3 composite
- actions/configure-pages v2 composite
- actions/deploy-pages v1 composite
- actions/setup-python v4 composite
- actions/upload-pages-artifact v1 composite
- easydict *
- exifread *
- h5py *
- kornia *
- laspy *
- lmfit *
- matplotlib *
- numpy *
- open3d *
- opencv-python *
- pandas *
- pydegensac *
- pyyaml *
- scipy *
- torch *
- tqdm *