{"id":14958167,"url":"https://github.com/franioli/icepy4d","last_synced_at":"2025-10-24T14:31:14.842Z","repository":{"id":40637353,"uuid":"497973665","full_name":"franioli/icepy4d","owner":"franioli","description":"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","archived":false,"fork":false,"pushed_at":"2024-03-07T16:18:28.000Z","size":216639,"stargazers_count":15,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-06T21:39:54.534Z","etag":null,"topics":["3d-reconstruction","4d","deep-learning","feature-matching","feature-tracking","glaciers","photogrammetry","pytorch","sfm"],"latest_commit_sha":null,"homepage":"https://franioli.github.io/icepy4d/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/franioli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-05-30T14:18:19.000Z","updated_at":"2025-02-03T22:50:37.000Z","dependencies_parsed_at":"2024-04-22T08:53:10.106Z","dependency_job_id":null,"html_url":"https://github.com/franioli/icepy4d","commit_stats":{"total_commits":657,"total_committers":2,"mean_commits":328.5,"dds":0.0182648401826484,"last_synced_commit":"518c9ee61925a19a00947da77799041716b2ea5a"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franioli%2Ficepy4d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franioli%2Ficepy4d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franioli%2Ficepy4d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franioli%2Ficepy4d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/franioli","download_url":"https://codeload.github.com/franioli/icepy4d/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237982289,"owners_count":19397236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-reconstruction","4d","deep-learning","feature-matching","feature-tracking","glaciers","photogrammetry","pytorch","sfm"],"created_at":"2024-09-24T13:16:24.347Z","updated_at":"2025-10-24T14:31:09.791Z","avatar_url":"https://github.com/franioli.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Welcome to ICEpy4D\n\n4D Image-based Continuos monitoring of glaciers' Evolution with low-cost stereo-cameras and Deep Learning photogrammetry.\n\n`ICEpy4D` is a under active development.\n## Gettin Started\n\nTo get started with `ICEpy4D` you can refer documentation at [https://franioli.github.io/icepy4d/](https://franioli.github.io/icepy4d/) (please, note the documentation is currently under development).  \nYou can find some Jupyter Notebooks with examples in the `notebooks` folder.\n\n## Requirements\n\n- 64-bit Python `\u003e= 3.8` but `\u003c 3.10`\n- a NVIDIA graphic card with CUDA capability is strongly reccomended.\n\n## Installation guide\n\nCreate a new Anaconda environment\n\n```bash\nconda create -n icepy4d python=3.9\nconda activate icepy4d\n```\n\nInstall Icepy4D from PyPi repository\n\n```bash\npip install icepy4d\n```\n\nor install it from source by cloning the repository and installing it with `pip`\n\n```bash\ngit clone https://github.com/franioli/icepy4d.git\ncd icepy4d\npip install -e .\n```\n\nIn case of any error when installing `ICEpy4D` from PyPi, try to install it from source.\n\nInstall Metashape Python API for Bundle Adjustment and Dense reconstruction.\nMetashape Python API can be downloaded from [https://www.agisoft.com/downloads/installer/](https://www.agisoft.com/downloads/installer/) or use `wget` (under Linux).\n\n```bash\nwget https://s3-eu-west-1.amazonaws.com/download.agisoft.com/Metashape-1.8.5-cp35.cp36.cp37.cp38-abi3-linux_x86_64.whl\npip install Metashape-1.8.5-cp35.cp36.cp37.cp38-abi3-linux_x86_64.whl\n```\n\nYou need to have a valid Metashape license to use the API and you need to activate it (see [https://github.com/franioli/metashape](https://github.com/franioli/metashape) for how to do it)\n\nTry to import ICEpy4D package\n\n```bash\nconda activate icepy4d\npython -c \"import icepy4d\"\n```\n\nIf no error is given, ICEpy4D is successfully installed and it can be imported within your script with `import icepy4d`\n\n## Cite ICEpy4D\nIf you use `ICEpy4D` in your research, please cite it as:\n\n```bibtex\n@article{ioli2024,\n  title={Deep Learning Low-cost Photogrammetry for 4D Short-term Glacier Dynamics Monitoring},\n  author={Ioli, Francesco and Dematteis, Nicolò and Giordan, Daniele and Nex, Francesco and Pinto Livio},\n  journal={PFG – Journal of Photogrammetry, Remote Sensing and Geoinformation Science},\n  year={2024},\n  DOI = {10.1007/s41064-023-00272-w}\n}\n```\n\n```bibtex\n@article{ioli2023replicable,\n  title={A Replicable Open-Source Multi-Camera System for Low-Cost 4d Glacier Monitoring},\n  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},\n  journal={The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences},\n  doi={10.5194/isprs-archives-XLVIII-M-1-2023-137-2023},\n  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)},\n  volume={XLVIII-M-1-2023},\n  pages={137--144},\n  year={2023},\n  publisher={Copernicus GmbH}\n}\n```\n\n### For contributing\n\nInstall additional requirements for development:\n\n```bash\npip install -e .[dev]\npre-commit install\n```\n\n## Permissions and acknowledgements\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffranioli%2Ficepy4d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffranioli%2Ficepy4d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffranioli%2Ficepy4d/lists"}