cars


Namecars JSON
Version 0.9.0 PyPI version JSON
download
home_pagehttps://cars.readthedocs.io/
SummaryA satellite multi view stereo pipeline
upload_time2024-10-02 07:32:37
maintainerNone
docs_urlNone
authorCNES
requires_python>=3.8
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.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 &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"
                },
                "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 &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\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"
}
        
Elapsed time: 0.72316s