{"id":13579951,"url":"https://github.com/OpenDroneMap/ODM","last_synced_at":"2025-04-05T23:33:04.776Z","repository":{"id":21166695,"uuid":"24470090","full_name":"OpenDroneMap/ODM","owner":"OpenDroneMap","description":"A command line toolkit to generate maps, point clouds, 3D models and DEMs from drone, balloon or kite images. 📷","archived":false,"fork":false,"pushed_at":"2024-10-21T16:32:48.000Z","size":12082,"stargazers_count":4879,"open_issues_count":42,"forks_count":1107,"subscribers_count":238,"default_branch":"master","last_synced_at":"2024-10-29T15:03:27.568Z","etag":null,"topics":["aerial-imagery","drone","photogrammetry","point-cloud","structure-from-motion","uas"],"latest_commit_sha":null,"homepage":"https://opendronemap.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenDroneMap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-09-25T18:29:10.000Z","updated_at":"2024-10-28T18:13:34.000Z","dependencies_parsed_at":"2023-10-02T17:55:30.720Z","dependency_job_id":"d7d92d91-2610-4590-b1f3-baec58277fce","html_url":"https://github.com/OpenDroneMap/ODM","commit_stats":{"total_commits":2581,"total_committers":143,"mean_commits":18.04895104895105,"dds":0.449438202247191,"last_synced_commit":"65fad52506a7c3b07dcac34430a254ccf879e49c"},"previous_names":["opendronemap/opendronemap"],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenDroneMap%2FODM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenDroneMap%2FODM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenDroneMap%2FODM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenDroneMap%2FODM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenDroneMap","download_url":"https://codeload.github.com/OpenDroneMap/ODM/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247415794,"owners_count":20935383,"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":["aerial-imagery","drone","photogrammetry","point-cloud","structure-from-motion","uas"],"created_at":"2024-08-01T15:01:45.184Z","updated_at":"2025-04-05T23:32:59.756Z","avatar_url":"https://github.com/OpenDroneMap.png","language":"Python","funding_links":[],"categories":["Python","3D视觉生成重建","Projects","Photogrammetric software"],"sub_categories":["资源传输下载","Drones \u0026 UAV"],"readme":"![ODM Logo](https://user-images.githubusercontent.com/1951843/79699889-438ce580-8260-11ea-9c79-8667834aeab2.png)\n\nAn open source command line toolkit for processing aerial drone imagery. ODM turns simple 2D images into:\n\n* Classified Point Clouds\n* 3D Textured Models\n* Georeferenced Orthorectified Imagery\n* Georeferenced Digital Elevation Models\n\n![images-diag](https://user-images.githubusercontent.com/1174901/96644651-5b205600-12f7-11eb-827b-8f4a3a6f3b21.png)\n\nThe application is available for Windows, Mac and Linux and it works from the command line, making it ideal for power users, scripts and for integration with other software.\n\nIf you would rather not type commands in a shell and are looking for a friendly user interface, check out [WebODM](https://github.com/OpenDroneMap/WebODM).\n\n## Quickstart\n\nThe easiest way to run ODM on is via docker. To install docker, see [docs.docker.com](https://docs.docker.com). Once you have docker installed and [working](https://docs.docker.com/get-started/#test-docker-installation), you can run ODM by placing some images (JPEGs or TIFFs) in a folder named “images” (for example `C:\\Users\\youruser\\datasets\\project\\images` or `/home/youruser/datasets/project/images`) and simply run from a Command Prompt / Terminal:\n\n```bash\n# Windows\ndocker run -ti --rm -v c:/Users/youruser/datasets:/datasets opendronemap/odm --project-path /datasets project\n\n# Mac/Linux\ndocker run -ti --rm -v /home/youruser/datasets:/datasets opendronemap/odm --project-path /datasets project\n```\n\nYou can pass [additional parameters](https://docs.opendronemap.org/arguments/) by appending them to the command:\n\n```bash\ndocker run -ti --rm -v /datasets:/datasets opendronemap/odm --project-path /datasets project [--additional --parameters --here]\n```\n\nFor example, to generate a DSM (`--dsm`) and increase the orthophoto resolution (`--orthophoto-resolution 2`) :\n\n```bash\ndocker run -ti --rm -v /datasets:/datasets opendronemap/odm --project-path /datasets project --dsm --orthophoto-resolution 2\n```\n\n## Viewing Results\n\nWhen the process finishes, the results will be organized as follows:\n\n    |-- images/\n        |-- img-1234.jpg\n        |-- ...\n    |-- opensfm/\n        |-- see mapillary/opensfm repository for more info\n    |-- odm_meshing/\n        |-- odm_mesh.ply                    # A 3D mesh\n    |-- odm_texturing/\n        |-- odm_textured_model.obj          # Textured mesh\n        |-- odm_textured_model_geo.obj      # Georeferenced textured mesh\n    |-- odm_georeferencing/\n        |-- odm_georeferenced_model.laz     # LAZ format point cloud\n    |-- odm_orthophoto/\n        |-- odm_orthophoto.tif              # Orthophoto GeoTiff\n\nYou can use the following free and open source software to open the files generated in ODM:\n * .tif (GeoTIFF): [QGIS](http://www.qgis.org/)\n * .laz (Compressed LAS): [CloudCompare](https://www.cloudcompare.org/)\n * .obj (Wavefront OBJ), .ply (Stanford Triangle Format): [MeshLab](http://www.meshlab.net/)\n\n**Note!** Opening the .tif files generated by ODM in programs such as Photoshop or GIMP might not work (they are GeoTIFFs, not plain TIFFs). Use [QGIS](http://www.qgis.org/) instead.\n\n## API\n\nODM can be made accessible from a network via [NodeODM](https://github.com/OpenDroneMap/NodeODM).\n\n## Documentation\n\nSee http://docs.opendronemap.org for tutorials and more guides.\n\n## Forum\n\nWe have a vibrant [community forum](https://community.opendronemap.org/). You can [search it](https://community.opendronemap.org/search?expanded=true) for issues you might be having with ODM and you can post questions there. We encourage users of ODM to participate in the forum and to engage with fellow drone mapping users.\n\n## Windows Setup\n\nODM can be installed natively on Windows. Just download the latest setup from the [releases](https://github.com/OpenDroneMap/ODM/releases) page. After opening the ODM Console you can process datasets by typing:\n\n```bash\nrun C:\\Users\\youruser\\datasets\\project  [--additional --parameters --here]\n```\n\n## GPU Acceleration\n\nODM has support for doing SIFT feature extraction on a GPU, which is about 2x faster than the CPU on a typical consumer laptop. To use this feature, you need to use the `opendronemap/odm:gpu` docker image instead of `opendronemap/odm` and you need to pass the `--gpus all` flag:\n\n```\ndocker run -ti --rm -v c:/Users/youruser/datasets:/datasets --gpus all opendronemap/odm:gpu --project-path /datasets project\n```\n\nWhen you run ODM, if the GPU is recognized, in the first few lines of output you should see:\n\n```\n[INFO]    Writing exif overrides\n[INFO]    Maximum photo dimensions: 4000px\n[INFO]    Found GPU device: Intel(R) OpenCL HD Graphics\n[INFO]    Using GPU for extracting SIFT features\n```\n\nThe SIFT GPU implementation is CUDA-based, so should work with most NVIDIA graphics cards of the GTX 9xx Generation or newer.\n\nIf you have an NVIDIA card, you can test that docker is recognizing the GPU by running:\n\n```\ndocker run --rm --gpus all nvidia/cuda:10.0-base nvidia-smi\n```\n\nIf you see an output that looks like this:\n\n```\nFri Jul 24 18:51:55 2020       \n+-----------------------------------------------------------------------------+\n| NVIDIA-SMI 440.82       Driver Version: 440.82       CUDA Version: 10.2     |\n|-------------------------------+----------------------+----------------------+\n| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |\n| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |\n```\n\nYou're in good shape!\n\nSee https://github.com/NVIDIA/nvidia-docker and https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker for information on docker/NVIDIA setup.\n\n## Native Install (Ubuntu 21.04)\n\nYou can run ODM natively on Ubuntu 21.04 (although we don't recommend it):  \n\n```bash\ngit clone https://github.com/OpenDroneMap/ODM\ncd ODM\nbash configure.sh install\n```\n\nYou can then process datasets with `./run.sh /datasets/odm_data_aukerman`\n\n## Native Install (MacOS)\n\nYou can run ODM natively on Intel/ARM MacOS.\n\nFirst install:\n\n * Xcode 13 (not 14, there's currently a bug)\n * [Homebrew](https://docs.brew.sh/Installation)\n\nThen Run:\n\n```bash\ngit clone https://github.com/OpenDroneMap/ODM\ncd ODM\nbash configure_macos.sh install\n```\n\nYou can then process datasets with `./run.sh /datasets/odm_data_aukerman`\n\nThis could be improved in the future. [Helps us create a Homebrew formula](https://github.com/OpenDroneMap/ODM/issues/1531).\n\n### Updating a native installation\n\nWhen updating to a newer version of native ODM, it is recommended that you run:\n\n`bash configure.sh reinstall`\n\nto ensure all the dependent packages and modules get updated.\n\n### Build Docker Images From Source\n\nIf you want to rebuild your own docker image (if you have changed the source code, for example), from the ODM folder you can type:\n\n```bash\ndocker build -t my_odm_image --no-cache .\n```\nWhen building your own Docker image, if image size is of importance to you, you should use the ```--squash``` flag, like so:\n\n```bash\ndocker build --squash -t my_odm_image .\n```\n\nThis will clean up intermediate steps in the Docker build process, resulting in a significantly smaller image (about half the size).\n\nExperimental flags need to be enabled in Docker to use the ```--squash``` flag. To enable this, insert the following into the file `/etc/docker/daemon.json`:\n\n```json\n{\n   \"experimental\": true\n}\n```\n\nAfter this, you must restart docker.\n\n## Video Support\n\nStarting from version 3.0.4, ODM can automatically extract images from video files (.mp4, .mov, .lrv, .ts). Just place one or more video files into the `images` folder and run the program as usual. Subtitles files (.srt) with GPS information are also supported. Place .srt files in the `images` folder, making sure that the filenames match. For example, `my_video.mp4` ==\u003e `my_video.srt` (case-sensitive).\n\n## Developers\n\nHelp improve our software! We welcome contributions from everyone, whether to add new features, improve speed, fix existing bugs or add support for more cameras. Check our [code of conduct](https://github.com/OpenDroneMap/documents/blob/master/CONDUCT.md), the [contributing guidelines](https://github.com/OpenDroneMap/documents/blob/master/CONTRIBUTING.md) and [how decisions are made](https://github.com/OpenDroneMap/documents/blob/master/GOVERNANCE.md#how-decisions-are-made).\n\n\n### Installation and first run\nFor Linux users, the easiest way to modify the software is to make sure docker is installed, clone the repository and then run from a shell:\n\n```bash\n$ DATA=/path/to/datasets ./start-dev-env.sh\n```\n\nWhere `/path/to/datasets` is a directory where you can place test datasets (it can also point to an empty directory if you don't have test datasets).\n\nRun configure to set up the required third party libraries:\n```bash\n(odmdev) [user:/code] master+* ± bash configure.sh reinstall\n```\n\nYou can now make changes to the ODM source. When you are ready to test the changes you can simply invoke:\n\n```bash\n(odmdev) [user:/code] master+* ± ./run.sh --project-path /datasets mydataset\n```\n### Stop dev container\n```bash\n docker  stop odmdev\n```\n### To come back to dev environement\nchange your_username to your username\n```bash\ndocker start odmdev\ndocker exec -ti odmdev bash\nsu your_username\n```\n\n\nIf you have questions, join the developer's chat at https://community.opendronemap.org/c/developers-chat/21\n\n1. Try to keep commits clean and simple\n2. Submit a pull request with detailed changes and test results\n3. Have fun!\n\n### Troubleshooting\nThe dev environment makes use of `opendronemap/nodeodm` by default. You may want to run \n`docker pull opendronemap/nodeodm` before running `./start-dev-env.sh` to avoid using an old cached version.\n\nIn order to make a clean build, remove `~/.odm-dev-home` and `ODM/.setupdevenv`.\n\n## Credits\n\nODM makes use of [several libraries](https://github.com/OpenDroneMap/ODM/blob/master/snap/snapcraft.yaml#L36) and other awesome open source projects to perform its tasks. Among them we'd like to highlight:\n\n - [OpenSfM](https://github.com/mapillary/OpenSfM)\n - [OpenMVS](https://github.com/cdcseacave/openMVS/)\n - [PDAL](https://github.com/PDAL/PDAL)\n - [Entwine](https://entwine.io/)\n - [MVS Texturing](https://github.com/nmoehrle/mvs-texturing)\n - [GRASS GIS](https://grass.osgeo.org/)\n - [GDAL](https://gdal.org/)\n - [PoissonRecon](https://github.com/mkazhdan/PoissonRecon)\n\n\n## Citation\n\n\u003e *OpenDroneMap Authors* ODM - A command line toolkit to generate maps, point clouds, 3D models and DEMs from drone, balloon or kite images. **OpenDroneMap/ODM GitHub Page** 2020; [https://github.com/OpenDroneMap/ODM](https://github.com/OpenDroneMap/ODM)\n\n## Trademark\n\nSee [Trademark Guidelines](https://github.com/OpenDroneMap/documents/blob/master/TRADEMARK.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenDroneMap%2FODM","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOpenDroneMap%2FODM","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenDroneMap%2FODM/lists"}