Getting Started

This guide will help you get started with Tomocam-lamino for magnetic field reconstruction.

What is Tomocam-lamino?

Tomocam-lamino is a specialized library for reconstructing 3D magnetic field distributions from tomographic measurements of materials exhibiting magnetic circular dichroism (MCD). It implements state-of-the-art iterative reconstruction algorithms optimized for high-performance computing.

Prerequisites

Before installing Tomocam-lamino, ensure you have:

  • C++ compiler with C++20 support (LLVM/Clang recommended)

  • CMake ≥ 3.20

  • Basic understanding of tomographic reconstruction

  • Familiarity with TOML configuration files

Key Concepts

X-ray Magnetic Circular Dichroism (XMCD)

Tomographic-XMCD is a technique that measures the difference in absorption of left and right circularly polarized light by a material in a magnetic field. This property is used to map magnetic field distributions in thin materials.

Polar Grid Geometry

Tomocam-lamino uses a polar grid system for efficient projection operations. The geometry is optimized for the specific acquisition patterns used in XMCD imaging.

Reconstruction Methods

The library implements several reconstruction approaches:

  • Filtered Back Projection: Fast analytical reconstruction

  • Conjugate Gradient (CG): Iterative least-squares reconstruction

  • Model-Based Iterative Reconstruction (MBIR): Advanced reconstruction with regularization

  • Split Bregman: Efficient algorithm for TV regularization

Vector Field Reconstruction

For complete magnetic field reconstruction, multiple datasets acquired at different gamma angles are combined to reconstruct all three components of the magnetic field vector.

First Steps

  1. Install Tomocam-lamino on your system

  2. Prepare your input data (TIFF stacks and angle files)

  3. Create a configuration file

  4. Run the reconstruction

  5. Analyze the output

Next Steps