A python-based interactive visualization tool to view XPCS dataset.

To cite pyXPCSViewer:

Chu et al., “pyXPCSviewer: an open-source interactive tool for X-ray photon correlation spectroscopy visualization and analysis”, Journal of Synchrotron Radiation, (2022) 29, 1122–1129.

Supported Format

This tools supports the customized nexus fileformat developed at APS-8IDI’s XPCS data format for both multi-tau and two-time correlation.

Install and Uninstall

Updated 03/11/2025

It is highly recommended to set up a new virtual environment to isolate pyXPCSViewer, so it does not interfere with dependencies of your existing applications.

  1. Install conda following the instructions at link.

  2. Create a brand-new environment with conda:

    conda create -n your_env_name python==3.10.16

    Replace your_env_name with your preferred environment name.

  3. Activate the new environment:

    conda activate your_env_name

  4. Install pyXPCSViewer:

    pip install xpcs-viewer

    Note: Running conda and pip commands together is generally not recommended. pyXPCSViewer will only use pip or conda once compatibility issues are resolved.

  5. Launch pyXPCSViewer:

    1. Activate your environment if you have not already.

    2. Run:

      pyxpcsviewer path_to_hdf_directory   # Run the viewer from the hdf directory
pyxpcsviewer                         # Run in the current directory

    run_viewer, an alias to pyxpcsviewer, can also be used to luanch the viewer.

  6. To upgrade:

    1. Activate your environment if you have not already.

    2. Run:

      pip install -U xpcs-viewer

  7. To uninstall:

    1. Activate your environment if you have not already.

    2. Run:

      pip uninstall xpcs-viewer

    3. If you want to remove the environment altogether, first deactivate it:

      conda deactivate

      Then remove it:

      conda remove -n your_env_name --all

Gallery

  1. The integrated scattering pattern over the whole time series.

    docs/images/saxs2d.png

  2. The reduced one-dimensional small-angle scattering data.

    docs/images/saxs1d.png

  3. The sample’s stability against X-ray beam damage. The time series is divided into 10 sections. The SAXS-1D curve is plotted for each section.

    docs/images/stability.png

  4. Intensity fluctuation vs. Time.

    docs/images/intt.png

  5. Average Tool box.

    docs/images/average.png

  6. g2 plot for multitau analysis. Users can fit the time scale using a single exponential function, with options to specify the fitting range and fitting flags (fix or fit).

    docs/images/g2mod.png

  7. Diffusion analysis. g2 fitting in the previous panel is required to plot \(\tau \mbox{vs.} q\).

    docs/images/diffusion.png

  8. Two-time correlation. Users can select two q indexes either on the q-map or on the SAXS-2D image.

    docs/images/twotime.png

  9. Experiment condition viewer. It reads the file structure and string entries of the selected HDF file.

    docs/images/hdf_info.png

License

Copyright © 2026 UChicago Argonne, LLC. Licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mqichu from gravatar.com mqichu

Credits

Author/Maintainer: Miaoqi Chu

License

Apache Software License (Apache-2.0)

Provides Extra

dev docs pyinstaller

Tags

XPCS X-ray photon correlation spectroscopy synchrotron visualization science

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xpcs_viewer-1.2.2.tar.gz (10.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xpcs_viewer-1.2.2-py3-none-any.whl (207.9 kB view details)

Uploaded Python 3

File details

Details for the file xpcs_viewer-1.2.2.tar.gz.

File metadata

  • Download URL: xpcs_viewer-1.2.2.tar.gz
  • Upload date:
  • Size: 10.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for xpcs_viewer-1.2.2.tar.gz
Algorithm Hash digest
SHA256 4478038f7320c94c300516722b05483da509d5f566e84112747e68a26ffeb9cc
MD5 5d5e82c711b90a6f37202112a7cb12b2
BLAKE2b-256 897f3306989f796c2649250c94763a7aaa05d11b0cb857e061c710b42ff40a6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for xpcs_viewer-1.2.2.tar.gz:

Publisher: publish-pypi.yml on AdvancedPhotonSource/pyXpcsViewer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file xpcs_viewer-1.2.2-py3-none-any.whl.

File metadata

  • Download URL: xpcs_viewer-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 207.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for xpcs_viewer-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 edc1a1cb94f25d123a4934eaa6d14e9fb41875c8ec0db31c49b9eba4ef142983
MD5 d49e541e971201d50a3bf697f03e02b3
BLAKE2b-256 d81791d68888a7c70aa5942d790e3ab61f4bd3706433aeec1d55faf8a054df3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for xpcs_viewer-1.2.2-py3-none-any.whl:

Publisher: publish-pypi.yml on AdvancedPhotonSource/pyXpcsViewer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.2.2 This release

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.0

2 files

0.260

2 files

0.259

2 files

0.258

2 files

0.257

2 files

0.256

2 files

0.255

2 files

0.253

2 files

0.251

2 files

0.250

2 files

0.249

2 files

0.248

2 files

0.247

2 files

0.246

2 files

0.244

2 files

0.243

2 files

0.242

2 files

0.241

2 files

0.240

2 files

0.239

2 files

0.238

2 files

0.237

2 files

0.236

2 files

0.235

2 files

0.234

2 files

0.233

2 files

0.232

2 files

0.231

2 files

0.230

2 files

0.229

2 files

0.228

2 files

0.227

2 files

0.226

2 files

0.225

2 files

0.224

2 files

0.223

2 files

0.222

2 files

0.221

2 files

0.219

2 files

0.218

2 files

0.217

2 files

0.215

2 files

0.214

2 files

0.213

2 files

0.212

2 files

0.211

2 files

0.209

2 files

0.207

2 files

0.206

2 files

0.205

2 files

0.204

2 files

0.203

2 files

0.202

2 files

0.201

2 files

0.2

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page