Getting Started

Note

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

Quick Start

$ wget https://raw.githubusercontent.com/CNES/cars/master/docs/source/demo/quick_start.sh
  • Run this quick_start.sh script

$ ./quick_start.sh

Go to the data_samples/outcompute/ 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

dsm

clr

dsmclr

Steps by steps

  • 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/docs/source/demo/data_samples.tar.bz2
$ wget https://raw.githubusercontent.com/CNES/cars/master/docs/source/demo/data_samples.tar.bz2.md5sum
$ md5sum --status -c data_samples.tar.bz2.md5sum
$ tar xvfj data_samples.tar.bz2
$ docker run -v "$(pwd)"/data_samples:/data cnes/cars prepare -i /data/input12.json -o /data/outprepare12
$ docker run -v "$(pwd)"/data_samples:/data cnes/cars prepare -i /data/input13.json -o /data/outprepare13
$ docker run -v "$(pwd)"/data_samples:/data cnes/cars compute_dsm -i /data/outprepare12/content.json /data/outprepare13/content.json  -o /data/outcompute/
  • Clean Unix rights on Docker generated data.

$ docker run -it -v "$(pwd)"/data_samples:/data --entrypoint /bin/bash cnes/cars -c "chown -R '$(id -u):$(id -g)' /data/"
  • Show resulting output directory

$ ls -l data_samples/outcompute/

Warning

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

Advanced Quick Start

  1. Install CARS on your system.

  2. Follow now CARS Advanced Quick Start script with the same steps than previous quick start.

You need to get these command line options files to run the script: