cars


Namecars JSON
Version 0.7.4 PyPI version JSON
download
home_pagehttps://cars.readthedocs.io/
SummaryA satellite multi view stereo pipeline
upload_time2023-12-06 13:46:01
maintainer
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 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 &nbsp;&nbsp;&nbsp;  <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 &nbsp;&nbsp;&nbsp;  </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 &nbsp;&nbsp;&nbsp;  <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 &nbsp;&nbsp;&nbsp;  </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"
}
        
Elapsed time: 0.14757s