<div align="center">
<a target="_blank" href="https://github.com/CNES/cars">
<picture>
<source
srcset="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_dark.png"
media="(prefers-color-scheme: dark)"
/>
<img
src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_light.png"
alt="CARS"
width="40%"
/>
</picture>
</a>
<h4>CARS, a satellite multi view stereo framework </h4>
[![Python](https://img.shields.io/badge/python-v3.8+-blue.svg)](https://www.python.org/downloads/release/python-380/)
[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/)
[![Documentation](https://readthedocs.org/projects/cars/badge/?version=latest)](https://cars.readthedocs.io/?badge=latest)
[![Github Action](https://github.com/CNES/cars/actions/workflows/cars-ci.yml/badge.svg?branch=master)](https://github.com/CNES/cars/actions)
<p>
<a href="#overview">Overview</a> •
<a href="#quick-start">Quick Start</a> •
<a href="#documentation">Documentation</a> •
<a href="#contribution">Contribution</a> •
<a href="#references">References</a>
</p>
</div>
## Overview
From stereo images | CARS produces a Digital Surface Model (DSM)
:-------------------------:|:-------------------------:
<img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif" alt="drawing" width="100%"/> | <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif" alt="drawing" width="100%"/>
**CARS** is an open source 3D tool dedicated to produce **Digital Surface Models** from satellite imaging by photogrammetry.
This Multiview Stereo framework is intended for massive DSM production with a robust, performant and modular design.
Be aware that the project is new and is evolving to maturity with CNES usage roadmaps and projects such as:
- <a href="https://co3d.cnes.fr/en/co3d-0">CO3D project <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.jpg" height="20"/></a>
- <a href="https://www.ai4geo.eu">AI4GEO project <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png" height="20"/> </a>
- <a href="https://www.evo-land.eu">Evoland project <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png" height="20"/> </a>
## Quick start
### CARS Docker Image
[![Docker Status](http://dockeri.co/image/cnes/cars)](https://hub.docker.com/r/cnes/cars)
CARS is available on Docker Hub and can be downloaded by:
``` bash
docker pull cnes/cars
```
### One main pipeline to generate DSM
You only need to launch one command:
```
docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.json
```
with one configuration input file ("configfile.json") located in a "data" folder to be consistent with the previous command lines:
```
{
"inputs": {
"sensors" : {
"one": {
"image": "img1.tif",
"geomodel": "img1.geom"
},
"two": {
"image": "img2.tif",
"geomodel": "img2.geom"
},
"three": {
"image": "img3.tif",
"geomodel": "img3.geom"
}
},
"pairing": [["one", "two"],["one", "three"]],
"initial_elevation": "srtm_dir/N29E031_KHEOPS.tif"
},
"output": {
"out_dir": "outresults"
}
}
```
### On the way to the Pyramids...
You want to build the pyramids by yourself? Download our [open licence](https://www.etalab.gouv.fr/licence-ouverte-open-licence) Pleiades [data sample](https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2) to give CARS a try!
## Documentation
Go to [CARS Main Documentation](https://cars.readthedocs.io/?badge=latest).
## Contribution
To do a bug report or a contribution, see the [**Contribution Guide**](https://github.com/CNES/cars/blob/master/CONTRIBUTING.md).
For project evolution, see [**Changelog**](https://github.com/CNES/cars/blob/master/CHANGELOG.md).
## Credits
See [Authors file](https://github.com/CNES/cars/blob/master/AUTHORS.md)
## References
- [Youssefi D., Michel, J., Sarrazin, E., Buffe, F., Cournet, M., Delvit, J., L’Helguen, C., Melet, O., Emilien, A., Bosman, J., 2020. Cars: A photogrammetry pipeline using dask graphs to construct a global 3d model. IGARSS - IEEE International Geoscience and Remote Sensing Symposium.](https://ieeexplore.ieee.org/document/9324020)
- [Michel, J., Sarrazin, E., Youssefi, D., Cournet, M., Buffe, F., Delvit, J., Emilien, A., Bosman, J., Melet, O., L’Helguen, C., 2020. A new satellite imagery stereo pipeline designed for scalability, robustness and performance. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.](https://www.isprs-ann-photogramm-remote-sens-spatial-inf-sci.net/V-2-2020/171/2020/)
Raw data
{
"_id": null,
"home_page": "https://cars.readthedocs.io/",
"name": "cars",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cars, 3D, DEM, pandora, photogrammetry",
"author": "CNES",
"author_email": "cars@cnes.fr",
"download_url": "https://files.pythonhosted.org/packages/5e/2d/1fbbbd1c0a103fb3c68a4af17bbb2dd0be3763d528128722583e16aee779/cars-0.9.0.tar.gz",
"platform": "any",
"description": "<div align=\"center\">\n<a target=\"_blank\" href=\"https://github.com/CNES/cars\">\n<picture>\n <source\n srcset=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_dark.png\"\n media=\"(prefers-color-scheme: dark)\"\n />\n <img\n src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_light.png\"\n alt=\"CARS\"\n width=\"40%\"\n />\n</picture>\n</a>\n\n<h4>CARS, a satellite multi view stereo framework </h4>\n\n[![Python](https://img.shields.io/badge/python-v3.8+-blue.svg)](https://www.python.org/downloads/release/python-380/)\n[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/)\n[![Documentation](https://readthedocs.org/projects/cars/badge/?version=latest)](https://cars.readthedocs.io/?badge=latest)\n[![Github Action](https://github.com/CNES/cars/actions/workflows/cars-ci.yml/badge.svg?branch=master)](https://github.com/CNES/cars/actions)\n\n<p>\n <a href=\"#overview\">Overview</a> \u2022\n <a href=\"#quick-start\">Quick Start</a> \u2022\n <a href=\"#documentation\">Documentation</a> \u2022\n <a href=\"#contribution\">Contribution</a> \u2022\n <a href=\"#references\">References</a>\n</p>\n</div>\n\n## Overview\n\nFrom stereo images | CARS produces a Digital Surface Model (DSM)\n:-------------------------:|:-------------------------:\n<img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif\" alt=\"drawing\" width=\"100%\"/> | <img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif\" alt=\"drawing\" width=\"100%\"/>\n\n\n**CARS** is an open source 3D tool dedicated to produce **Digital Surface Models** from satellite imaging by photogrammetry.\nThis Multiview Stereo framework is intended for massive DSM production with a robust, performant and modular design.\n\nBe aware that the project is new and is evolving to maturity with CNES usage roadmaps and projects such as:\n- <a href=\"https://co3d.cnes.fr/en/co3d-0\">CO3D project <img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.jpg\" height=\"20\"/></a>\n- <a href=\"https://www.ai4geo.eu\">AI4GEO project <img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png\" height=\"20\"/> </a>\n- <a href=\"https://www.evo-land.eu\">Evoland project <img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png\" height=\"20\"/> </a>\n\n## Quick start\n\n### CARS Docker Image\n\n[![Docker Status](http://dockeri.co/image/cnes/cars)](https://hub.docker.com/r/cnes/cars)\n\nCARS is available on Docker Hub and can be downloaded by:\n``` bash\ndocker pull cnes/cars\n```\n\n### One main pipeline to generate DSM\n\nYou only need to launch one command:\n\n```\ndocker run -w /data -v \"$(pwd)\"/data_gizeh:/data cnes/cars /data/configfile.json\n```\n\nwith one configuration input file (\"configfile.json\") located in a \"data\" folder to be consistent with the previous command lines:\n```\n{\n\n \"inputs\": {\n \"sensors\" : {\n \"one\": {\n \"image\": \"img1.tif\",\n \"geomodel\": \"img1.geom\"\n },\n \"two\": {\n \"image\": \"img2.tif\",\n \"geomodel\": \"img2.geom\"\n },\n \"three\": {\n \"image\": \"img3.tif\",\n \"geomodel\": \"img3.geom\"\n }\n },\n \"pairing\": [[\"one\", \"two\"],[\"one\", \"three\"]],\n \"initial_elevation\": \"srtm_dir/N29E031_KHEOPS.tif\"\n },\n\n \"output\": {\n \"out_dir\": \"outresults\"\n }\n\n}\n\n```\n\n### On the way to the Pyramids...\n\nYou want to build the pyramids by yourself? Download our [open licence](https://www.etalab.gouv.fr/licence-ouverte-open-licence) Pleiades [data sample](https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2) to give CARS a try!\n\n## Documentation\n\nGo to [CARS Main Documentation](https://cars.readthedocs.io/?badge=latest).\n\n\n## Contribution\n\nTo do a bug report or a contribution, see the [**Contribution Guide**](https://github.com/CNES/cars/blob/master/CONTRIBUTING.md).\n\nFor project evolution, see [**Changelog**](https://github.com/CNES/cars/blob/master/CHANGELOG.md).\n\n## Credits\n\nSee [Authors file](https://github.com/CNES/cars/blob/master/AUTHORS.md)\n\n\n## References\n\n- [Youssefi D., Michel, J., Sarrazin, E., Buffe, F., Cournet, M., Delvit, J., L\u2019Helguen, C., Melet, O., Emilien, A., Bosman, J., 2020. Cars: A photogrammetry pipeline using dask graphs to construct a global 3d model. IGARSS - IEEE International Geoscience and Remote Sensing Symposium.](https://ieeexplore.ieee.org/document/9324020)\n- [Michel, J., Sarrazin, E., Youssefi, D., Cournet, M., Buffe, F., Delvit, J., Emilien, A., Bosman, J., Melet, O., L\u2019Helguen, C., 2020. A new satellite imagery stereo pipeline designed for scalability, robustness and performance. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.](https://www.isprs-ann-photogramm-remote-sens-spatial-inf-sci.net/V-2-2020/171/2020/)\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "A satellite multi view stereo pipeline",
"version": "0.9.0",
"project_urls": {
"Documentation": "https://cars.readthedocs.io/en/latest/",
"Homepage": "https://cars.readthedocs.io/",
"Source": "https://github.com/CNES/cars"
},
"split_keywords": [
"cars",
" 3d",
" dem",
" pandora",
" photogrammetry"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bf513a7e2c450457316aaf80eef8e393f76e30e5806a8d335f9692572b151bbf",
"md5": "62d6fa4a43162fa1b67a9c704ae62c51",
"sha256": "1df1773cc83c314692bb42db5027ba691915e9c6521a75d292be897f57e1ddb6"
},
"downloads": -1,
"filename": "cars-0.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62d6fa4a43162fa1b67a9c704ae62c51",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3537817,
"upload_time": "2024-10-02T07:32:31",
"upload_time_iso_8601": "2024-10-02T07:32:31.802475Z",
"url": "https://files.pythonhosted.org/packages/bf/51/3a7e2c450457316aaf80eef8e393f76e30e5806a8d335f9692572b151bbf/cars-0.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5e2d1fbbbd1c0a103fb3c68a4af17bbb2dd0be3763d528128722583e16aee779",
"md5": "da16ecd43a7c942365ba7e2c3d3cf967",
"sha256": "c0d2796dd9a684c6da21a0fea255d6cb3b5167713791ecc0287c1e22712a3cba"
},
"downloads": -1,
"filename": "cars-0.9.0.tar.gz",
"has_sig": false,
"md5_digest": "da16ecd43a7c942365ba7e2c3d3cf967",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3458871,
"upload_time": "2024-10-02T07:32:37",
"upload_time_iso_8601": "2024-10-02T07:32:37.606992Z",
"url": "https://files.pythonhosted.org/packages/5e/2d/1fbbbd1c0a103fb3c68a4af17bbb2dd0be3763d528128722583e16aee779/cars-0.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 07:32:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CNES",
"github_project": "cars",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "cars"
}