Welcome · Main window

Main window

guisaxs-liveview is a three-column desktop app that watches a working directory for new .tif / .tiff detector frames, queues them, and runs them through calibration, integration, optional buffer subtraction, and optional analysis. The middle column is the live stage (queue, 2D drop target, 1D / subtraction plots, session history). The left column holds setup wizards (calibration and buffer). The right column opens analysis windows and shows the live log.

For how the pieces fit together (working directory, queue, auto vs manual, TIFF revision), see Concepts.

Typical session workflow:

Calibrate (once per geometry) — see Calibration.
Optionally integrate a buffer TIFF, then set buffer (subtraction settings for the session).
Integrate sample TIFFs (automatic as they arrive, or via Process on history).
With buffer configured, each sample is subtracted automatically; adjust scaling in the Subtraction wizard if needed.
Optionally open Monodisperse or Polydisperse analysis so new files run those chains while the window stays open.

Main window overview

Layout

Menu — File (working directory, Advanced flat/tree, Exit), Update, Help.
Working dir line — contracted path; tooltip shows the full path.
Left — Set calibration / Reset; Set buffer / Reset; previews.
Middle — queue status, 2D (Drop .tif), 1D or S + buffer / Sub, history < > Process.
Right — Analysis icons (monodisperse / polydisperse), Logs (Full / App).

Recipes

To calibrate

Set calibration (left) → wizard opens → set calibrant / mask / options → Run → wait for Idle → Close. Details: Calibration (mask editing: Mask).

Highlight Set calibration

To feed images

Drop .tif / .tiff onto the middle 2D panel (Drop .tif), or copy files into the working directory after the app has started. See also Concepts (feeding / queue / revision).

Highlight Drop .tif

To set buffer (subtraction settings)

Integrate a buffer frame first (drop a buffer TIFF and wait for averaged/int_<stem>.dat). Then:

Set buffer (left) → wizard opens → choose buffer_1d .dat → set q min / q max (matching window for auto-scale) → Apply subtraction settings → Close.

Settings stay in the session and apply to new samples. Outputs go under subtracted/.

Highlight Set buffer

Buffer wizard Apply subtraction settings

To adjust subtraction for the current file

After buffer is configured and a sample has been subtracted (middle shows S + buffer / Sub): click the S + buffer plot → Subtraction wizard opens → change Scaling factor → Apply (rewrites the subtracted curve and may re-run analysis) → close the wizard.

Highlight S + buffer plot

Subtraction wizard

To revisit a processed file

Use history < / > to step through session files. Process re-enqueues the selected file through the live pipeline (same as a new upload).

History and Process

To arm analysis

Right column → click the monodisperse or polydisperse icon → window opens and that chain is armed for new TIFFs while it stays open. Closing the window disarms that chain.

Analysis icons

Calibration → · Monodisperse → · Polydisperse →