Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Simple analysis tool for NeXus data files

Project description

xrd-viewer

Simple analysis tool for NeXus data files measured at the SIXS beamline at synchrotron Soleil.
Written in Python with Qt5 Gui

Installation

Please install the python3-pyqt5 package of your distribution and then run
pip install xrd-viewer

then start the program by running xrd-viewer

Usage

Once you opened the program, you will be greeted by the default interface with an logo on the top plot and an empty plot on the bottom.

The (optional) first step is to load a mask file via File > Load Mask... After file selection a preview of the mask file is presented on the upper plot. The program adds an automatic correction of the borders of the detector chips to the mask (hard coded factor of 0.4 will change in the future). The mask can not be unloaded. So please restart the program for a empty mask.

Then File > Open... the folder of the measurements. It will list all measurement files in the list on the left. There you can select one or multiple files to analyse. If you select mutiple, only one can be visualized on the top plot. The name of this file is visible in the window title bar of the program.

After selection of the measurement file the analysis plot on the bottom gets updated. You can select which attributes to assign to each axis. The possible attributes are exctracted from the measurement file. There are two special attributes added: xpad_image and slices. The xpad_image corresponds to the region of interest (see below) and slices corresponds to the scan frame in the measurement (slider on the top of the upper plot). The typical setting is omega vs xpad_image.

The region of interest (ROI) can be selected in the upper plot window. Click the Edit regions... button to open the extended region editor. By default it has two regions. The first region is the background region and all regions afterwards are ROIs. By default the second region (= the first ROI) is the active region. The active region is displayed as red rectangle and can be manipulated by moving the edges to the desired positions. The region editor can also be used to refine the region (values are in pixels). A new ROI can be added by New Region button.

Tips for analysis of measurements

  • If the background region should not be applied. You can move it to the upper left corner with an width and length of 1. (In this corner is typically a shadow in the measurements, so zero counts.)
  • You can move the cursor in the bottom plot my draging the mouse. The upper plot gets updated. This also sets the focus on the frame slider, so you can move the cursor by pressing left and right.
  • Typically the first frames of a measurement are corrupted, you can set an value in the bottom input box to ignore them.
  • After selecting a measurement File > Save Graph... becomes enabled. You can save the current analysis plot as image in *.JPG,*.PNG or *.PDF format (the cursor and indicator will be removed) or as plain text *.TXT for further analysis. The plain text file will have some metadata about the measurement file, the mask file and the selected regions.

Project details


Release history Release notifications

This version

1.0.0

Download files

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

Files for xrd-viewer, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size XRD_Viewer-1.0.0-py3-none-any.whl (29.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size XRD-Viewer-1.0.0.tar.gz (30.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page