Metadata-Version: 2.1
Name: cars
Version: 0.12.1
Summary: A satellite multi view stereo pipeline
Keywords: cars,3D,DEM,pandora,photogrammetry
Author-Email: CNES <cars@cnes.fr>
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Science/Research
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.9
Project-URL: Documentation, https://cars.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/CNES/cars
Requires-Python: >=3.9
Requires-Dist: numpy>=1.17.0
Requires-Dist: scipy!=1.10.0,>=1.7.1
Requires-Dist: matplotlib
Requires-Dist: affine
Requires-Dist: rasterio>=1.3.0
Requires-Dist: dask>=2021.10.0
Requires-Dist: distributed>=2021.10.0
Requires-Dist: dask-jobqueue>=0.7.3
Requires-Dist: json-checker
Requires-Dist: xarray
Requires-Dist: tqdm
Requires-Dist: netCDF4>=1.5.3
Requires-Dist: Shapely
Requires-Dist: Fiona
Requires-Dist: pyproj
Requires-Dist: utm
Requires-Dist: pandas
Requires-Dist: urllib3<2.0,>=1.21.1
Requires-Dist: laspy[laszip]
Requires-Dist: tbb==2020.3.254
Requires-Dist: numba
Requires-Dist: pandora[sgm]==1.7.0
Requires-Dist: cars-rasterize==0.2.*
Requires-Dist: cars-resample==0.1.*
Requires-Dist: cars-filter==0.2.*
Requires-Dist: vlsift==0.1.*
Requires-Dist: shareloc==0.2.8
Requires-Dist: bulldozer-dtm==1.1.*
Requires-Dist: xdem==0.1.*
Requires-Dist: geopandas<=1.0.1
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: isort>=5.8.0; extra == "dev"
Requires-Dist: black>=24.1a1; extra == "dev"
Requires-Dist: flake8>=3.9.1; extra == "dev"
Requires-Dist: flake8-pyproject; extra == "dev"
Requires-Dist: flake8-comprehensions>=3.4.0; extra == "dev"
Requires-Dist: flake8-bugbear<24.0.0,>=21.4.3; extra == "dev"
Requires-Dist: jupyter_contrib_nbextensions; extra == "dev"
Requires-Dist: pylint<3.0.0,>=2.8.12; extra == "dev"
Requires-Dist: setuptools_scm; extra == "dev"
Requires-Dist: virtualenv; extra == "dev"
Requires-Dist: configupdater; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: notebook<7.0.0; extra == "dev"
Requires-Dist: bokeh==2.4.3; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Requires-Dist: sphinx-rtd-theme; extra == "dev"
Requires-Dist: graphviz; extra == "dev"
Requires-Dist: memory_profiler; extra == "dev"
Requires-Dist: memray; extra == "dev"
Requires-Dist: dash; extra == "dev"
Requires-Dist: plotly; extra == "dev"
Requires-Dist: build; extra == "dev"
Provides-Extra: docs
Requires-Dist: astroid<3.0.0; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-rtd-theme; extra == "docs"
Requires-Dist: sphinx_autoapi; extra == "docs"
Requires-Dist: graphviz; extra == "docs"
Requires-Dist: sphinx_tabs==3.4.0; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Provides-Extra: notebook
Requires-Dist: notebook; extra == "notebook"
Requires-Dist: bokeh; extra == "notebook"
Requires-Dist: rise; extra == "notebook"
Provides-Extra: pandora-mccnn
Requires-Dist: pandora_plugin_mccnn==1.3.4; extra == "pandora-mccnn"
Provides-Extra: bundleadjustment
Requires-Dist: rpcfit; extra == "bundleadjustment"
Description-Content-Type: text/markdown

CARS, a satellite multi view stereo framework 

[![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)

  Overview •
  Quick Start •
  Documentation •
  Contribution •
  References

## Overview

From stereo images  |  CARS produces a Digital Surface Model (DSM)
:-------------------------:|:-------------------------:
drawing |  drawing

**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.

**CARS** is currently under active development and integrated into various projects & missions:

- CO3D project       (https://co3d.cnes.fr/en/co3d-0)
- AI4GEO project       (https://www.ai4geo.eu)
- Evoland project       (https://www.evo-land.eu)

Its roadmap and implemented functionalities are evolving regularly depending on specific project requirements.

## 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/)
