foo Welcome to nxtomomill’s documentation!

nxtomomill provide a set of applications to convert tomography acquisition made by BLISS from their original file format (.edf, .h5) to a Nexus compliant file format (using NXtomo)

It also embed a nexus module allowing users to easily edit Nxtomo


The simplest way to install nxtomomill is to use the pypi wheel provided ()

pip install nxtomomill

You can also install it from source:

git clone
cd nxtomomill
pip install .

Building doc

In order to build documentation you should insure sphinx is install. You can for example install it from pip:

pip install sphinx

Then you can build the documentation using sphinx:

python build build_sphinx


nxtomomill needs to get several information in order to complete translation from EDF or (bliss) HDF5 to nexus-compliant HDF5 file.

This information
  • is a set of key values for EDF

  • is a set of dataset location and name for (bliss) HDF5

All are stored in file. For tomoh52nx you can generally overwrite from calling the appropriate command option (see h52nx tutorial).

But for scripting are when used from a dependency (like tomwer) it can be convenient to modify some of them. For example if you cannot retrieve rotation angle because this information is stored at a different location than the ‘default’ one knows by nxtomomill you can change H5_Y_ROT_KEY parameter.



The more it goes the more use cases the hdf5 converter has to handle. Today it handles “classical” tomography acquisition, zseries and pcotomo. In the future it is expected to handle XRD-CT, XFD-CT and dual energy - CT.

Behavior of the HDF5Converter

The HDF5 is applying sequentially the following taks:

  1. preprocess raw data (During converter creation)

    browse raw data and collect information on Bliss scan sequence.

    During this step it will determine for each entry if the frame type are dark, flats, projections or alignment.

    Create an instance of Acquistion for each ‘init’ Bliss scan.

  2. HDF5Converter.convert function

    2.1 create for Acquisition instance one or several instances of NXtomo.

    2.2 Optional split of NXtomo (use case of pcotomo) in order to obtain the final NXtomo.

    2.3 save data to disk.

Acquistion classes

To manage all the use cases it has evolved. Each acquisition has now it’s own acquisition class. All based on the nxtomomill.converter.hdf5.acquisition.baseacquisition.BaseAcquisition


The regular conversion sequence is:


Actually we also have two configuration handler classes. Both inherit from

The configuration handler is used to make the connection between applications options and configuration (

The configuration is used to make the conversion (defines input file, output file, entry titles, urls to be converted, source format…)

Actually there is also two configuration classes.

  • TomoHDF5Config: define the configuration to generate a usual “NXTomo”

  • XRD3DHDF5Config: define the configuration for 3D-XRD acquisition (close to a standard acquisition including two motors: rocking and base-tilt)

Indices and tables