cars


Namecars JSON
Version 0.10.0 PyPI version JSON
download
home_pagehttps://cars.readthedocs.io/
SummaryA satellite multi view stereo pipeline
upload_time2024-12-03 16:50:02
maintainerNone
docs_urlNone
authorCNES
requires_python>=3.9
licenseApache License 2.0
keywords cars 3d dem pandora photogrammetry
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            <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.9+-blue.svg)](https://www.python.org/downloads/release/python-390/)
[![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 &nbsp;&nbsp;&nbsp;  <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 &nbsp;&nbsp;&nbsp; <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 &nbsp;&nbsp;&nbsp; <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"
            }
        }
    },
    "output": {
        "directory": "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.9",
    "maintainer_email": null,
    "keywords": "cars, 3D, DEM, pandora, photogrammetry",
    "author": "CNES",
    "author_email": "cars@cnes.fr",
    "download_url": null,
    "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.9+-blue.svg)](https://www.python.org/downloads/release/python-390/)\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 &nbsp;&nbsp;&nbsp;  <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 &nbsp;&nbsp;&nbsp; <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 &nbsp;&nbsp;&nbsp; <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    \"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        }\n    },\n    \"output\": {\n        \"directory\": \"outresults\"\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.10.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": "f0086a94c2f3d27b0e76f4d261afcf2dbcc45af60d35c2f6812949350a7414b7",
                "md5": "1ad370d67a90b23d7d91a06f43043c3f",
                "sha256": "d4ca3265c3263e5dbccbae10610d5e7c07ab5fff59a30ea70eb69fd2c2d7d947"
            },
            "downloads": -1,
            "filename": "cars-0.10.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1ad370d67a90b23d7d91a06f43043c3f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 3542860,
            "upload_time": "2024-12-03T16:50:02",
            "upload_time_iso_8601": "2024-12-03T16:50:02.016377Z",
            "url": "https://files.pythonhosted.org/packages/f0/08/6a94c2f3d27b0e76f4d261afcf2dbcc45af60d35c2f6812949350a7414b7/cars-0.10.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-03 16:50:02",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "CNES",
    "github_project": "cars",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "cars"
}
        
Elapsed time: 0.67424s