RAW to ACES GUI

Table of Contents

1. Introduction
2. Package Contents
3. Prerequisites
4. Installation
5. Usage

Introduction

The RAW to ACES Gui, is a helper tool to convert digital camera RAW files to ACES container files containing image data encoded according to the Academy Color Encoding Specification (ACES) as specified in SMPTE 2065-1. Using the underlining software package from https://github.com/AcademySoftwareFoundation/rawtoaces.git.

1. The gui allows the user to input an image, then select a few options, like convert into a sequence of files, rename the files with padding and move them into a exr subfolder. The output image complies with the ACES Container specification (SMPTE S2065-4).

The original source code for rawtoaces was forked to add support to the latest version of libraw v0.21.1, add compatibility to CR3 canon files for example. Provided here: https://github.com/mjbacurado/rawtoaces.git

Package Contents

The source code contains the following:

• bin/ - Helper shelscritp for runing the gui.
• python/ - gui python run file.
• install_rawtoaces_mac - Helper shelscritp to install rawtoaces and setup on MacOs
• install_rawtoaces_linux - Helper shelscritp to install rawtoaces and setup on Linux, tested in rocky linux.

Prerequisites

pip

https://pypi.org/project/pip/

Pyside6

https://pypi.org/project/PySide6/

pip install PySide6

Raw to Aces

https://github.com/mjbacurado/rawtoaces#installation

• Linux Using the setup script.

  git clone https://github.com/curadotd/rawtoaces_gui.git
  cd rawtoaces_gui
  ./setup

  Manually.

  Firstly install some needed dependencies.

  Arch

  sudo pacman -S --needed cmake autoconf automake libtool pkg-config boost gcc google-glog gflags openexr \
  eigen libjpeg-turbo jasper lcms2 suitesparse tbb blas-openblas pyside6 pyside6-tools
  
  yay -S --needed metis openblas-lapack

  Rocky Linux

  sudo dnf install dnf-plugins-core
  sudo dnf install epel-release
  sudo dnf update
  dnf config-manager --enable crb
  sudo dnf install cmake autoconf automake libtool pkg-config boost-devel gcc glog-devel gflags-devel \
  openexr-devel eigen3-devel g++ libjpeg-devel libjasper-devel lcms2-devel suitesparse-devel metis-devel \
  tbb-devel blas-devel lapack-devel openblas-serial

  Debian Linux

  sudo apt update
  sudo apt install cmake autoconf automake libtool pkg-config libboost-dev gcc libgoogle-glog-dev \
  libgflags-dev libopenexr-dev libeigen3-dev g++ libjpeg-dev libjasper-dev liblcms2-dev libsuitesparse-dev \
  libmetis-dev libtbb-dev libblas-dev liblapack-dev libopenblas-dev

  Get rawtoaces source, Rocky, Debian and Arch.

  git clone https://github.com/AcademySoftwareFoundation/rawtoaces.git
  cd rawtoaces

  Create build directory.

  mkdir _build && cd _build

  Build extra dependencies

  Aces Container build and install, Rocky, Debian and Arch.

  mkdir raw_to_aces_deps_aces_container && cd raw_to_aces_deps_aces_container
  git clone https://github.com/miaoqi/aces_container.git src
  cd src
  
  mkdir build && cd build
  
  cmake -DCMAKE_INSTALL_PREFIX=/usr ..
  
  make -j 4
  
  sudo make install

  LibRaw install Arch and Debian, for Rocky build it.

  Arch

  sudo pacman -S --needed libraw

  Debian

  sudo apt-get install libraw-dev

  Rocky

  mkdir raw_to_aces_deps_libraw && cd raw_to_aces_deps_libraw
  git clone https://github.com/LibRaw/LibRaw.git src
  cd src
  
  autoreconf --install
  
  ./configure
  
  make -j 4
  
  make install

  #Ceres Solver install Arch and Debian, for Rocky build it.

  Arch

  sudo pacman -S --needed ceres-solver

  Debian

  sudo apt-get install  libceres-dev

  Rocky

  mkdir raw_to_aces_deps_ceres_solver && cd raw_to_aces_deps_ceres_solver
  git clone https://github.com/ceres-solver/ceres-solver.git src
  cd src
  #Change to version 2.1.0
  git checkout 2.1.0
  
  mkdir build_ceres && cd build_ceres
  
  cmake \
  -DBUILD_SHARED_LIBS=ON -DBUILD_EXAMPLES=OFF -DBUILD_TESTING=OFF \
  ..
  
  make -j 8
  
  make install

  RawToAces build and install, Rocky, Debian and Arch.

  cd $build_path/rawtoaces/_build

  Raw to Aces build and install.

  Arch and Debian.

  cmake -DCMAKE_INSTALL_PREFIX=/usr -DAcesContainer_INCLUDE_DIRS=/usr/include/aces -DAcesContainer_LIBRARY_DIRS=/usr/lib ..
  make -j 4
  make test
  sudo make install

  Rocky

  cmake -DCMAKE_INSTALL_PREFIX=/usr \
  -DCMAKE_CXX_STANDARD=11 -DCMAKE_C_COMPILER=/usr/bin/gcc \
  -D_IlmBase_HINT_LIB=/usr/lib64 \
  -DIlmBase_INCLUDE_DIR=/usr/include/Imath \
  -D_libraw_HINT_LIB=$build_path/rawtoaces/_build/raw_to_aces_deps_ceres_solver/install/lib \
  -D_libraw_HINT_INCLUDE=$build_path/rawtoaces/_build/raw_to_aces_deps_ceres_solver/install/include/libraw \
  -DCERES_INCLUDE_DIRS=/usr/include/ceres \
  -DCERES_LIBRARY_DIRS=/usr/lib64 \
  -DAcesContainer_INCLUDE_DIRS=/usr/include/aces/ \
  -DAcesContainer_LIBRARY_DIRS=/usr/lib \
  ..
  
  make -j 4
  
  make test
  
  make install

  cd $build_path/rawtoaces/_build

  install rawtoaces_gui for Arch, Debian and Rocky linux.

  Get rawtoaces_gui source

  git clone https://github.com/mjbacurado/rawtoaces_gui.git
  cd rawtoaces_gui

  install python dependencies

  Rocky

  pip install pyside6

  Debian

  pip3 install pyside6

  Istallation rawtoaces_gui recommended path: $HOME/Software/curadotd_tools/rawtoaces_gui If your Path needs sudo, and that before the commands bellow.

  mkdir -p "$HOME/Software/curadotd_tools/rawtoaces_gui"
  cp -R python "$HOME/Software/curadotd_tools/rawtoaces_gui"

  Replace the existing RAW_TO_ACES_GUI_INSTALL_PATH value

  sed -i "s|export RAW_TO_ACES_GUI_INSTALL_PATH=\".*\"|export RAW_TO_ACES_GUI_INSTALL_PATH=\"$HOME/Software/curadotd_tools/rawtoaces_gui\"|" "bin/rawtoaces_gui"

  Copy the bin "rawtoaces_gui" file to the folder of choice, recommended: /usr/bin

  sudo cp bin/rawtoaces_gui "/usr/bin"

  If you have added it to a custom folder, you might want to add it to you $PATH

  echo "export PATH=\$PATH:$bin_path" >> ~/.bashrc

Usage

Overview

Input a Raw Camera image for example a .CR3 image file in the file path slot.

Choose if you would like to create a sequence, create a exr subfolder and or change the image name.

Then choose the conversion options for rawtoaces.

rawtoaces uses one of three methods to convert RAW image files to ACES.

1. Camera spectral sensitivities and illuminant spectral power distributions
2. Camera file metadata
3. Camera data included in the libraw software

The preferred, and most accurate, method of converting RAW image files to ACES is to use camera spectral sensitivities and illuminant spectral power distributions, if available. If spectral sensitivity data is available for the camera, rawtoaces uses the method described in Academy document P-2013-001 (.pdf download).

While preferred, camera spectral sensitivity data is not commonly known to general users. When that is the case, rawtoaces can use either the metadata embedded in the camera file or camera data included in libraw to approximate a conversion to ACES.

Help message

A help message with a description of all command line options can be obtained by typing the following command:

$ rawtoaces --help
rawtoaces - convert RAW digital camera files to ACES

Usage:
  rawtoaces file ...
  rawtoaces [options] file
  rawtoaces --help
  rawtoaces --version

IDT options:
  --help                  Show this screen
  --version               Show version
  --wb-method [0-4]       White balance factor calculation method
                            0=white balance using file metadata 
                            1=white balance using user specified illuminant [str] 
                            2=Average the whole image for white balance
                            3=Average a grey box for white balance <x y w h>
                            4=Use custom white balance  <r g b g>
                            (default = 0)
  --mat-method [0-2]      IDT matrix calculation method
                            0=Calculate matrix from camera spec sens
                            1=Use file metadata color matrix
                            2=Use adobe coeffs included in libraw
                            (default = 0)
                            (default = /usr/local/include/rawtoaces/data/camera)
  --headroom float        Set highlight headroom factor (default = 6.0)
  --cameras               Show a list of supported cameras/models by LibRaw
  --valid-illums          Show a list of illuminants
  --valid-cameras         Show a list of cameras/models with available
                          spectral sensitivity datasets

Raw conversion options:
  -c float                Set adjust maximum threshold (default = 0.75)
  -C <r b>                Correct chromatic aberration
  -P <file>               Fix the dead pixels listed in this file
  -K <file>               Subtract dark frame (16-bit raw PGM)
  -k <num>                Set the darkness level
  -S <num>                Set the saturation level
  -n <num>                Set threshold for wavelet denoising
  -H [0-9]                Highlight mode (0=clip, 1=unclip, 2=blend, 3+=rebuild) (default = 0)
  -t [0-7]                Flip image (0=none, 3=180, 5=90CCW, 6=90CW)
  -j                      Don't stretch or rotate raw pixels
  -W                      Don't automatically brighten the image
  -b <num>                Adjust brightness (default = 1.0)
  -q [0-3]                Set the interpolation quality
  -h                      Half-size color image (twice as fast as "-q 0")
  -f                      Interpolate RGGB as four colors
  -m <num>                Apply a 3x3 median filter to R-G and B-G
  -s [0..N-1]             Select one raw image from input file
  -G                      Use green_matching() filter
  -B <x y w h>            Use cropbox

Benchmarking options:
  -v                      Verbose: print progress messages (repeated -v will add verbosity)
  -F                      Use FILE I/O instead of streambuf API
  -d                      Detailed timing report
  -E                      Use mmap()-ed buffer instead of plain FILE I/O