Installation

Instructions

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install rawtoaces

   $ (coming soon ...)

• From Source

  From the root source directory:

   $ git clone https://github.com/ampas/rawtoaces
   $ mkdir build && cd build
   $ cmake ..
   $ make
   $ sudo make install

The default process will install librawtoacesIDT.dylib to /usr/local/lib, a few header files to /usr/local/include/rawtoaces and a number of data files into /usr/local/include/rawtoaces/data.

Prerequisites

CMake

CMake can be downloaded directly from https://cmake.org/ and/or installed using one of the commands below.

• Ubuntu

   $ sudo apt-get install cmake

• Redhat

   $ yum install cmake

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install cmake

   $ brew install cmake

IlmBase

The rawtoaces tool depends on an essential part of the IlmBase software package, which can be downloaded from http://www.openexr.com and/or installed using one of the commands below.

• Ubuntu

   $ sudo apt-get install libilmbase-dev

• Redhat

   $ yum install ilmbase-devel

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install ilmBase

   $ brew install ilmBase

ACES Container

ACES Container is the reference implementation for a file writer intended to be used with the Academy Color Encoding System (ACES). rawtoaces relies on it to produce images that comply with the ACES container specification (SMPTE S2065-4). ACES Container can be downloaded from https://github.com/ampas/aces_container or installed using one of the commands below.

• Ubuntu / Redhat / OS X

  NOTE : During the beta period please use the build of ACES Container specified below

  Install aces_container

   git clone https://github.com/miaoqi/aces_container.git
   cd aces_container
   git checkout windowBuildSupport
   
   mkdir build && cd build
   cmake ..
   make
   sudo make install	

LibRaw

LibRaw is a library that processes RAW files from digital cameras. It handles image pre-processing for rawtoaces. LibRaw can be downloaded from http://www.libraw.org/download or installed using one of the commands below.

• Ubuntu

   $ sudo apt-get install libraw-dev

• Redhat

   $ yum install libraw1394-devel

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install libraw

   $ brew install libraw

Boost

Boost has multiple C++ libraries that support tasks related to linear algebra, multithreading, image processing, unit testing, etc. It handles data loading and unit testing for rawtoaces. Boost can be downloaded from http://www.boost.org/ or installed using one of the commands below.

• Ubuntu

   $ sudo apt-get install libboost-all-dev

• Redhat

   $ yum install boost-devel

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install boost

   $ brew install boost

Ceres Solver

Ceres Solver is an open source library for solving Non-linear Least Squares problems with bounds constraints and unconstrained optimization problems. It processes non-linear regression for rawtoaces. Ceres Solver can be downloaded from http://ceres-solver.org/ or installed using one of the commands below.

• Linux (e.g. Ubuntu)

  Install google-glog + gflags

   sudo apt-get install libgoogle-glog-dev

  Install BLAS & LAPACK

   sudo apt-get install libatlas-base-dev

  Install Eigen3

   sudo apt-get install libeigen3-dev

  Install SuiteSparse and CXSparse (optional)

   sudo apt-get install libsuitesparse-dev
   sudo add-apt-repository ppa:bzindovic/suitesparse-bugfix-1319687
   sudo apt-get update
   sudo apt-get install libsuitesparse-dev

  Build, Test and Install Ceres

   tar zxf ceres-solver-version#.tar.gz
   mkdir ceres-bin
   cd ceres-bin
   cmake ../ceres-solver-version#
   make -j3
   make test
   sudo make install

• OS X

  Install homebrew if not already installed

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  Install ceres-solver

   $ brew tap homebrew/homebrew-science
   $ brew install ceres-solver --HEAD

  If there are errors with regard to a version mis-match of the Eigen library, please consider brew-installing required libraries first and then buiding Ceres from source (see above).

  In case of any linking errors you should take ownership of CMAKE then run linker:

   sudo chown -R $USER:admin /usr/local/lib/cmake
   $ brew link ceres-solver

  In case of any GFlag errors AFTER running the next step (rawtoaces installation) you should repeat the install of ceres and follow the instructions shown in terminal to switch the version.

   $ brew install ceres-solver --HEAD

  This should present something like:

  homebrew/science/ceres-solver-HEAD-97cefd4_4 already installed, however linked version is 1.12.0_4 You can use brew switch ceres-solver HEAD-97cefd4_4 to link to this version.

  Therefore you would enter:

   $ brew switch ceres-solver HEAD-97cefd4_4

  And then repeat installation of rawtoaces.

  If you have a previous installation of ceres-solver and receive the following error after installing and running rawtoaces:

   dyld: Library not loaded: /usr/local/opt/suite-sparse/lib/libsuitesparseconfig.4.5.5.dylib
   Referenced from: /usr/local/opt/ceres-solver/lib/libceres.1.dylib
   Reason: image not found
   Trace/BPT trap: 5

  You should update your brew install of ceres-solver using the following command:

   $ brew reinstall --HEAD ceres-solver

  And then repeat installation of rawtoaces.