[{"_1":2,"_163":-5,"_164":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_141":142},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_130":-5,"_131":11,"_132":21,"_133":11,"_134":-5,"_135":11,"_136":-5,"_137":138,"_139":91,"_140":-7},"canonicalUrl","https://hub.docker.com/r/yarroudh/optim3d/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","yarroudh","reponame","optim3d","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2023-04-04T12:04:24.049265Z","description","CLI application for efficient and optimized reconstruction of large-scale 3D building models.","is_private","last_updated","2023-04-13T18:01:42.932103Z","last_modified","2026-08-26T22:58:07.694601Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",1782,"repository_type","star_count",0,"status",6,"status_description","archived","source","collaborator_count","full_description"," $\"logo\"$ \n\n# Optimized reconstruction of large-scale 3D building models\n\n[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://github.com/Yarroudh/ZRect3D/blob/main/LICENSE)\n[![Geomatics Unit of ULiege - Development](https://img.shields.io/badge/Geomatics_Unit_of_ULiege-Development-2ea44f)](http://geomatics.ulg.ac.be/)\n\n*Command-Line Interface (CLI) application for efficient and optimized reconstruction of large-scale 3D building models.*\n\nOptim3D is a powerful tool for optimized automatic reconstruction of highly detailed and large-scale 3D building models. Our tool is based on the [GeoFlow](https://github.com/geoflow3d/geoflow-bundle) software and makes use of it to perform the 3D reconstruction of buildings. The process is inspired by the 3D BAG project and optimized for large-scale projects through indexing and tiling of the input data, which significantly reduces the processing time and resources required to generate large-scale 3D building models.\n\n $\"Workflow$ \n\n## Documentation\n\nIf you are using Optim3D, we highly recommend that you take the time to read the [documentation](https://optim3d.readthedocs.io/en/latest/). The documentation is an essential resource that will help you understand the features and functionality of our software, as well as provide guidance on how to use it effectively.\n\n## Installation\n\nYou can pull the image using the docker pull command:\n\n```bash\ndocker pull yarroudh/optim3d\n```\n\n## Usage of the CLI\n\nThese are the steps to run Optim3D as a Docker container:\n\n1. First, run the Docker container and mount your data inside it. Use the docker run command with the -v option to specify the path to the host directory and the path to the container directory where you want to mount the data folder. For example:\n\n```bash\ndocker run -d -v ABSOLUTE_PATH_TO_HOST_DATA:/home/user/data yarroudh/optim3d\n```\n\nThis command will start a Docker container in detached mode, mount the **ABSOLUTE_PATH_TO_HOST_DATA** directory on the host machine to the **/home/user/data** directory inside the container, and run the yarroudh/optim3d image. Do not change the path of the directory inside the container.\n\n3. Find the container ID and copy it. You can use the docker ps command to list all running containers and their IDs.\n4. Launch a command inside the container using docker exec, use the container ID or name and the command you want to run. For example:\n\n```bash\ndocker exec CONTAINER_ID optim3d index2d data/FILE_NAME\ndocker exec CONTAINER_ID optim3d index3d data/FILE_NAME\ndocker exec CONTAINER_ID optim3d tiler3d\ndocker exec CONTAINER_ID optim3d reconstruct\ndocker exec CONTAINER_ID optim3d post\n```\n\n5. To copy the output of the command from the container to a local path, use the docker cp command with the container ID or name, the path to the file inside the container, and the path to the destination on the host machine. For example:\n\n- To copy the output of one command:\n```bash\ndocker cp CONTAINER_ID:/home/user/output/footprint_tiles PATH_ON_HOST_MACHINE\n```\nThis will copy the output of footprints tiling. Please check the results section for the output structure.\n\n- To copy the output of all the commands:\n```bash\ndocker cp CONTAINER_ID:/home/user/output PATH_ON_HOST_MACHINE\n```\n\n6. Finally, after executing all the commands and copying the results to your local machine, you can stop the Docker container using the docker stop command followed by the container ID or name:\n\n```bash\ndocker stop CONTAINER_ID\n```\n\n## Results\n\nThe results of each command are saved in the output folder with the following structure:\n\n```bash\n├── output\n│ ├── flowcharts\n│ │ ├── *.json\n│ ├── footprint_tiles\n│ │ ├── *.cpg\n│ │ ├── *.dbf\n│ │ ├── *.prj\n│ │ ├── *.shp\n│ │ ├── *.shx\n│ ├── indexed_pointcloud\n│ │ ├── ept-data\n│ │ │ ├── *.laz\n│ │ ├── ept-hierarchy\n│ │ │ ├── 0-0-0-0.json\n│ │ ├── ept-sources\n│ │ │ ├── *.json\n│ │ ├── ept.json\n│ │ ├── ept-build.json\n│ ├── model\n│ │ ├── cityjson\n│ │ ├── *.city.json\n│ │ ├── obj\n│ │ ├── *.obj\n│ │ ├── *.obj.mtl\n│ ├── pointcloud_tiles\n│ │ ├── *.las\n│ ├── processing_areas.gpkg\n│ └── quadtree.gpkg\n```\n\nThe 3D building models can be inspected using [Ninja](https://github.com/cityjson/ninja), the official web viewer for CityJSON files.\n\n![image](https://user-images.githubusercontent.com/72500344/216613188-82d54c75-7e03-4ee7-8c1c-d081e0c1d4ac.png)\n\n## See also\n\n[Automatic correction of buildings ground floor elevation in 3D City Models](https://github.com/Yarroudh/ZRect3D)\n\nGeoFlow requires that the point cloud includes some ground points around the building so that it can determine the ground floor elevation. However, for aerial point clouds, buildings surrounded by others may not meet this condition which may result in inaccurate height estimation above the ground. This can be resolved using [ZRect3D](https://github.com/Yarroudh/zrect3d), a tool for automatic correction of buildings ground-floor elevation in CityJSON files using ground points from LiDAR data.\n\n## License\n\nThis software is under the BSD 3-Clause \"New\" or \"Revised\" license which is a permissive license that allows you almost unlimited freedom with the software so long as you include the BSD copyright and license notice in it. Please read the [LICENSE](https://github.com/Yarroudh/Optim3D/blob/main/LICENSE) and the [COPYING](https://github.com/Yarroudh/Optim3D/blob/main/COPYING) files in the GitHub repository for more details.\n\n## Citation\n\nThe use of open-source software repositories has become increasingly prevalent in scientific research. If you use this repository for your research, please make sure to cite it appropriately in your work. The recommended citation format for this repository is provided in the accompanying [BibTeX citation](https://github.com/Yarroudh/Optim3D/blob/main/CITATION.bib). Additionally, please make sure to comply with any licensing terms and conditions associated with the use of this repository.\n\n```bibtex\n@misc{yarroudh:2023:optim3d,\n author = {Yarroudh, Anass},\n title = {Optim3D: Optimized reconstruction of large-scale 3D building models},\n year = {2023},\n howpublished = {GitHub Repository},\n url = {https://github.com/Yarroudh/Optim3D}\n}\n```\n\nYarroudh, A. (2023). Optim3D: Optimized reconstruction of large-scale 3D building models [GitHub repository]. Retrieved from https://github.com/Yarroudh/Optim3D\n\n## About Optim3D\n\nThis software was developped by [Anass Yarroudh](https://www.linkedin.com/in/anass-yarroudh/), a Research Engineer in the [Geomatics Unit of the University of Liege](http://geomatics.ulg.ac.be/fr/home.php).\nFor more detailed information please contact us via , we are pleased to send you the necessary information.\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",5456246684,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":119,"_120":94,"_121":33,"_122":56,"_57":123,"_124":125,"_126":109,"_127":119,"_128":117,"_129":21},"content_type","creator",20351703,"digest","sha256:521322e0954bd77fd8693357931adab292d985840309567fbc6a71f99ede0297","full_size",4246553396,"id",416424265,"images",[103],{"_104":105,"_95":96,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":98,"_63":117,"_118":-5},"architecture","amd64","features","","last_pulled","2026-09-27T13:31:46.500638373Z","last_pushed","2023-04-13T18:01:43Z","os","linux","os_features","os_version","size","active","variant","2023-04-13T18:01:42.787356Z","last_updater","last_updater_username","media_type","latest","repository",19669700,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":143,"_150":151,"_137":161,"_162":11},{"_40":144,"_42":145,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":146,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":147,"_79":11,"_80":149,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":148},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_152":153,"_154":-5,"_155":-5,"_156":157},"count",1,"next","previous","results",[158],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":159,"_50":119,"_120":94,"_121":33,"_122":56,"_57":123,"_124":125,"_126":109,"_127":119,"_128":117,"_129":21},[160],{"_104":105,"_95":96,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":98,"_63":117,"_118":-5},[],"canDeleteTags","actionData","errors"]

yarroudh/optim3d

Tags for yarroudh/optim3d