Build DFTracer¶

This section describes how to build DFTracer.

There are three build options:

build DFTracer with pip (recommended),
build DFTracer with Spack, and
build DFTracer with cmake

Build DFTracer with pip (Recommended)¶

Users can easily install DFTracer using pip. This is the way most python packages are installed. This method would work for both native python environments and conda environments.

From source¶

git clone git@github.com:hariharan-devarajan/dftracer.git
cd dftracer
# You can skip this for installing the dev branch.
# for latest stable version use master branch.
git checkout tags/<Release> -b <Release>
pip install .

From Github¶

DFT_VERSION=v1.0.4
pip install git+https://github.com/hariharan-devarajan/dftracer.git@${DFT_VERSION}

Attention

For pip installations, all libraries will be present within the site-packages/dftracer/lib. This enables clean management of pip installation and uninstallations.

Build DFTracer with Spack¶

One may install DFTracer with Spack. If you already have Spack, make sure you have the latest release. If you use a clone of the Spack develop branch, be sure to pull the latest changes.

Install Spack¶

$ git clone https://github.com/spack/spack
$ # create a packages.yaml specific to your machine
$ . spack/share/spack/setup-env.sh

Use Spack’s shell support to add Spack to your PATH and enable use of the spack command.

Build and Install DFTracer¶

$ spack install py-dftracer-py
$ spack load py-dftracer-py

If the most recent changes on the development branch (‘dev’) of DFTracer are desired, then do spack install py-dftracer-py@develop.

Attention

The initial install could take a while as Spack will install build dependencies (autoconf, automake, m4, libtool, and pkg-config) as well as any dependencies of dependencies (cmake, perl, etc.) if you don’t already have these dependencies installed through Spack or haven’t told Spack where they are locally installed on your system (i.e., through a custom packages.yaml). Run spack spec -I py-dftracer-py before installing to see what Spack is going to do.

Build DFTracer with CMake¶

Download the latest DFTracer release from the Releases page or clone the develop branch (‘develop’) from the DFTracer repository https://github.com/hariharan-devarajan/dftracer.

Build ENV Variables¶

For pip based installations we can enable HWLOC using .. code-block:: Bash

export DFTRACER_DISABLE_HWLOC=Off

Build CMAKE Variables¶

For Cmake based build, we can enable HWLOC using .. code-block:: Bash

cmake -DDISABLE_HWLOC=Off <source dir>

Build DFTracer Dependencies¶

The main dependencies DFTracer are 1. cpp-logger : https://github.com/hariharan-devarajan/cpp-logger.git version: 0.0.1 2. gotcha: https://github.com/LLNL/GOTCHA.git version: develop 3. brahma: https://github.com/hariharan-devarajan/brahma.git version: 0.0.1

These dependencies can be either installed using spack or through cmake from respective respositories.

cmake . -B build -DCMAKE_INSTALL_PREFIX=<where you want to install DFTracer>
cmake --build build
cmake --install build