xpcsutilities 1.0.4

Installation

System requirements

XPCSUtilities works only with python version >= 3.6. Pip will take care of all dependencies. Dependency list can be showed in setup.py file.

It is strongly recommended to install XPCSUtilities in a dedicated virtual environment (virtualenv) to prevent any library version mismatch issue.

Stable version:

pip install xpcsutilities

Development version:

pip install https://gitlab.esrf.fr/id02/xpcsutilities/-/archive/main/xpcsutilities-main.zip

python package

This package can be used in your own analysis script to read data directly from the hdf5/NxXPCS format.

from xpcsutilities.tools.result_file import XPCSResultFile

with XPCSResultFile('my_filename.h5') as fd: # Always use into a with statement!

    print(fd.analysis_keys)

    lag, cf, std = fd.get_correlations('full') # Use here the right analysis key

    cf, lag, age = fd.get_ttcf('full', 3) # Return the TTCF of ROI#3 in the 'full' analysis

GUI

To launch the program:

XPCSUtilities

If installed in an virtual environement, load the environement first.

On the left panel, you’ll find the files of current working folder. You can select any files that you want to display on the right panel. Current working folder is set by the “Set working folder” button. Files are filtered according to the wildcard filter below the button. Multiple filters can be set by using a comma-separated list if wildcards. New files are automatically displayed on the list.

The plot button below display the selected file(s) in current tab.