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/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 |
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
Run CARS Prepare pipeline for first pair (img1 and img2)
$ docker run -v "$(pwd)"/data_samples:/data cnes/cars prepare -i /data/input12.json -o /data/outprepare12
Run CARS Prepare pipeline pipeline for second pair (img1 and img3)
$ docker run -v "$(pwd)"/data_samples:/data cnes/cars prepare -i /data/input13.json -o /data/outprepare13
Run CARS DSM compute pipeline
$ 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
Install CARS on your system.
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: