How to install spglib C-API

How to install spglib C-API#

Download#

The source code is downloaded at spglib/spglib or you can git-clone the spglib repository by

% git clone https://github.com/spglib/spglib.git

Install#

Unix-like#

After expanding source code, go into the source code directory:

% tar xvfz spglib-2.0.0.tar.gz
% cd spglib-2.0.0

Build and install in _build directory by

% mkdir _build
% cd _build
% cmake ..
% cmake --build .
% cmake --install (probably installed under /usr/local)

Or to install under the parent directory,

% mkdir _build
% cd _build
% cmake -DCMAKE_INSTALL_PREFIX=.. ..
% cmake --build .
% cmake --install . --prefix ..

Windows & Cygwin#

For windows, cmake behaves slightly differently and the following way is recommended

% cmake -DCMAKE_INSTALL_PREFIX="$(shell cygpath -w "${BUILD_DIR}")" ..
% cmake --build . --config Release
% cmake --install . --config Release

The detail of the windows installation process is discussed in issue 118.

Usage#

  1. Include spglib.h

  2. Link libsymspg.a or libsymspg.so

  3. A compilation example is shown in example/README.md.

Example#

A few examples are found in example directory.