Getting Started

Note

Data samples from this tutorial can be used under open licence.

Quick Start

Install Docker
Download CARS Quick Start

$ wget https://raw.githubusercontent.com/CNES/cars/master/tutorials/quick_start.sh

Run this quick_start.sh script

$ ./quick_start.sh

Go to the data_gizeh/outresults/ output directory to get a DSM and color image associated.

Open the dsm.tif DSM and clr.tif color image in QGIS software.

dsm.tif	clr.tif	QGIS Mix

Step by step

Check Docker install

$ docker -v

Get CARS dockerfile image

$ docker pull cnes/cars

Get and extract data samples from CARS repository:

$ wget https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2
$ wget https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2.md5sum
$ md5sum --status -c data_gizeh.tar.bz2.md5sum
$ tar xvfj data_gizeh.tar.bz2

Launch CARS for img1+img2 and img1+img3 pairs:

$ docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.json

Configuration example for quick_start data_gizeh:

{
        "inputs": {
            "sensors" : {
                "one": {
                    "image": "img1.tif",
                    "geomodel": "img1.geom",
                    "color": "color1.tif",
                    "no_data": 0
                },
                "two": {
                    "image": "img2.tif",
                    "geomodel": "img2.geom",
                    "no_data": 0

                },
                "three": {
                    "image": "img3.tif",
                    "geomodel": "img3.geom",
                    "no_data": 0
                }
            },
            "pairing": [["one", "two"],["one", "three"]],
             "initial_elevation": "srtm_dir"
        },

        "output": {
              "out_dir": "outresults"
        }
}

Clean Unix rights on Docker generated data.

$ docker run -it -v "$(pwd)"/data_gizeh:/data --entrypoint /bin/bash cnes/cars -c "chown -R '$(id -u):$(id -g)' /data/"

Show resulting output directory

$ ls -l data_gizeh/outresults/

Warning

This first tutorial uses Docker to avoid CARS installation. To go further, follow Install and User guide.

Advanced Quick Start

Install CARS on your system directly.
Follow now CARS Advanced Quick Start script with the same steps than previous quick start.

The main steps are:

Download inputs and extract them

$ wget https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2
$ wget https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2.md5sum
$ md5sum --status -c data_gizeh.tar.bz2.md5sum
$ tar xvfj data_gizeh.tar.bz2

Launch CARS

$ cars data_gizeh/configfile.json

Tutorials and notebooks

CARS provides a full python API which can be used to compute DSM step by step and gives access to intermediate data.

If you want to learn how to use it, go to the available notebooks tutorials

Tutorials can be found within the Docker guide.