Photogrammetry/Regard3D/Installation

From Wikiversity
Jump to navigation Jump to search

Download Regard3D and Camera Sensor Database[edit]

Cameras have different optical properties, that are relevant for the reconstruction of the 3D model from set of images. The main property Regard3D needs is the "Camera Sensor Width". The property can be searched on the internet, if you camera is not available in Camera Sensor Database. According to this requirement you need two downloads to perform the photogrammetry example:

  • Regard3D OpenSource Software
  • Camera Sensor Database The camera sensor database is not shipped with the Regard3D, so you have to download it with the link above and store your camera model (if not found) in the Sensor Database. Open the file called "sensor_database.csv" and add an appropriate line for you camera.

Camera Sensor Database[edit]

The file is located in Windows in the path

C:\Users\[User name]\AppData\Local\Regard3D,

on OS X in the installation directory of Regard3D

(usually /Applications/Regard3D.app/Contents/Resources).

This contains the openMVG sensor size database. When new pictures are loaded in Regard3D, first the user-defined database is consulted, then "sensor_database.csv". This way, it is possible to override manually the entries in "sensor_database.csv" or add new cameras to the database. In Regard3D screenshot (4) on right you can see the camera properties that are stored in the set of images. You see the camera name "Panasonic Lumix DMC-TZ41". If that camera is missing in the camera sensor database, you will find the camera sensor with 6.08mm. Add the following line to the sensor database (e.g. approx. line 2406 in "sensor_database.csv"):

Panasonic;Panasonic Lumix DMC-TZ41;6.08

and save the file "sensor_database.csv".

Installation Regard3D[edit]

Windows and MacOSX[edit]

Install Regard3D on you operating system with the installer downloaded above for Windows or MacOSX.

Linux Ubuntu 14.04[edit]

Install on Linux Ubuntu 14.04 see Compiling Regard3D on Linux

Linux Linux Mint 18.2[edit]

Install on Linux Mint 18.2 (2017)

sudo apt-get install build-essential cmake libboost-all-dev libeigen3-dev libwxgtk3.0-dev libopencv-dev libopenscenegraph-dev libpcl1 libpcl1-dev libpcl-msgs-dev libpcl-conversion-dev pcl-tools libsuitesparse-dev meshlab

Ceres Solver Installation[edit]

The Ceres Solver is necessary for solver. The linear equation solver is necessary e.g. for calculation of the matching points and the point cloud. First the system must be prepared for installation of Ceres Solver:

 
# CMake
sudo apt-get install cmake
# google-glog + gflags
sudo apt-get install libgoogle-glog-dev
# BLAS & LAPACK
sudo apt-get install libatlas-base-dev
# Eigen3
sudo apt-get install libeigen3-dev
# SuiteSparse and CXSparse (optional)
# - If you want to build Ceres as a *static* library (the default)
#   you can use the SuiteSparse package in the main Ubuntu package
#   repository:
sudo apt-get install libsuitesparse-dev
# - However, if you want to build Ceres as a *shared* library, you must
#   add the following PPA:
sudo add-apt-repository ppa:bzindovic/suitesparse-bugfix-1319687
sudo apt-get update
sudo apt-get install libsuitesparse-dev

Download Ceres Solver with wget and unzip the solver:

wget http://ceres-solver.org/ceres-solver-1.13.0.tar.gz
tar zxf ceres-solver-1.13.0.tar.gz
mkdir ceres-bin
cd ceres-bin
cmake ../ceres-solver-1.13.0
make -j3
make test
# Optionally install Ceres, it can also be exported using CMake which
# allows Ceres to be used without requiring installation, see the documentation
# for the EXPORT_BUILD_DIR option for more information.
make install