Digital Volume Correlation

The Digital Volume Correlation is based on Brian Bay's code from:

• Bay, B.K., Smith, T.S., Fyhrie, D.P., Saad, M., 1999. Digital volume correlation: Three-dimensional strain mapping using x-ray tomography. Experimental Mechanics 39, 217–226.

Please cite the article and the repository if you use this code in your research.

Master	Development	Anaconda binaries

Build

The package comes as a CMake project so you will need CMake (v.>=3) to configure it. Additionally you will need a C compiler, make (on linux). The toolkit comes with an executable dvc which may be used directly. We provide wrappers for Python.

1. Clone this repository to a directory, i.e. DigitalVolumeCorrelation,
2. create a build directory.
3. Issue cmake to configure (or cmake-gui, or ccmake, or cmake3). Use additional flags to fine tune the configuration.

CMake flags

Flags used during configuration

CMake flag	type	meaning	default
CMAKE_CXX_STANDARD	string	CXX standard	C++11
CMAKE_INSTALL_PREFIX	path	your favourite install directory	CMake standard location, OS dependent
BUILD_TEST	bool	ON|OFF whether to build the test mode	ON
ENABLE_COVERAGE	bool	ON|OFF whether to run the basic test coverage	OFF

Here an example of build on Linux:

git clone https://github.com/TomographicImaging/DigitalVolumeCorrelation
mkdir build
cd build
cmake ../DigitalVolumeCorrelation -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<your favourite install directory>
cmake --build . --target install -j

Open MP

Setting the Number of Threads Using an OpenMP Environment Variable

You can set the number of threads using the environment variable OMP_NUM_THREADS. If this is higher than the number of processors it will instead use the number of processors available.