<div align="center">
<a href="https://github.com/CNES/cars"><img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_transparent.png" alt="CARS" title="CARS" width="20%"></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)
<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="400"/> | <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif" alt="drawing" width="400"/>
**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" width="20" height="20"/></a>
- <a href="https://www.ai4geo.eu/">AI4GEO project </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": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "cars,3D,DEM,pandora,photogrammetry",
"author": "CNES",
"author_email": "cars@cnes.fr",
"download_url": "https://files.pythonhosted.org/packages/5e/21/748a18c2a49e15e73d3c3a4af5d4cb207cd1203d06ad7ecd48a9f462d876/cars-0.7.4.tar.gz",
"platform": "any",
"description": "<div align=\"center\">\n <a href=\"https://github.com/CNES/cars\"><img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_transparent.png\" alt=\"CARS\" title=\"CARS\" width=\"20%\"></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\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=\"400\"/> | <img src=\"https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif\" alt=\"drawing\" width=\"400\"/>\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\" width=\"20\" height=\"20\"/></a>\n- <a href=\"https://www.ai4geo.eu/\">AI4GEO project </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.7.4",
"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": "7e54e306445b24357e4ed936d9ba4dafbdd9b57ed29aec348057ebc8f3c5bc84",
"md5": "2eb32544ef6799227b78e3e5b8f11a61",
"sha256": "6f1cbf73f16afd0c68ce0a7e674454e3727a657fd1d0624ff682ba40b3165e45"
},
"downloads": -1,
"filename": "cars-0.7.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2eb32544ef6799227b78e3e5b8f11a61",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3504658,
"upload_time": "2023-12-06T13:45:49",
"upload_time_iso_8601": "2023-12-06T13:45:49.154311Z",
"url": "https://files.pythonhosted.org/packages/7e/54/e306445b24357e4ed936d9ba4dafbdd9b57ed29aec348057ebc8f3c5bc84/cars-0.7.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5e21748a18c2a49e15e73d3c3a4af5d4cb207cd1203d06ad7ecd48a9f462d876",
"md5": "5a630d4cb8e56385b27381e26efe1741",
"sha256": "5613ed234f1757670819749b0f823482784364a12556dbacefc5312b38a4744a"
},
"downloads": -1,
"filename": "cars-0.7.4.tar.gz",
"has_sig": false,
"md5_digest": "5a630d4cb8e56385b27381e26efe1741",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4065054,
"upload_time": "2023-12-06T13:46:01",
"upload_time_iso_8601": "2023-12-06T13:46:01.586915Z",
"url": "https://files.pythonhosted.org/packages/5e/21/748a18c2a49e15e73d3c3a4af5d4cb207cd1203d06ad7ecd48a9f462d876/cars-0.7.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-06 13:46:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CNES",
"github_project": "cars",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"lcname": "cars"
}