Web and desktop editions

Both editions share the tabs, fit engine, model library, parameter plots, and configuration-sharing protocol. The differences come from where the data and the command-line tools live.

Linux runs native tools locally; Windows runs its bundled tools in WSL2; the browser sends work to the CGI server.

Standard execution paths. Windows can also use explicitly configured native binaries instead of the bundled WSL runtime.

Concern

Desktop (Electron)

Web (browser)

Where the tools run

Locally using configured or detected tools; through WSL2 on Windows.

On the server behind the CGI endpoint.

Data access

Local data plus optional downloads of missing selected runs.

What the server data tree exposes.

Preferences

Per-user, through File / Preferences.

Fixed by server configuration; no dialog.

Opening / saving MSR files

Native File menu and editor Save button.

Server-side artifacts; no local file dialog.

Spectra display

musrview in its own native window.

ROOT canvas produced by musrview on the server, drawn with JSROOT in the page.

Quick Start help

Independent auxiliary window.

Modeless dialog beside the main window.

Configuration links

Share webpage links; Restore configuration link to paste one.

Share button copies a link; opening it restores the settings.

Bundled ROOT and musrfit

On Linux, the application and scientific runtime are separate. Use an existing ROOT + musrfit installation, install an offline runtime bundle in Preferences, or install the system runtime RPM/AppImage. An explicitly selected binaries directory takes precedence over automatic detection. See Linux installation for installation and tool checks.

On Windows, the application installer includes the runtime. It runs inside a WSL2 distribution named muSRFlow-runtime. Tools are invoked through wsl.exe, with paths translated so inputs and outputs stay on the Windows side. The separate Linux runtime installer does not apply to Windows. See Windows installation for WSL setup, installation, updates, and fixes.

The workflow chapters of this manual apply to both editions. Where a step is specific to one edition (handling files, Preferences), the text says so explicitly.

Downloading missing runs

Fit and Plot check selected main runs and ADDRUN members before preparing MSR files. If files are missing, the desktop offers to download them over HTTPS from musruser.psi.ch and continue. Independent series fits request data only for entries that need fitting; reused results and explicit skips do not trigger downloads. Runs absent from the server are still reported as missing.

The writable Data directory is preferred. When it is read-only, a persistent folder under the user’s application data directory is used instead. Exact filenames and formats are remembered across sessions, and incomplete downloads are never published as run files. Expert MSRs with manually specified RUN paths continue to use their existing file-resolution rules.

Generated download RUN paths are relative to the stored data tree. muSRFlow passes the matching search roots to its tools through MUSRFULLDATAPATH, including translated paths for Windows/WSL2. To run such an MSR from a terminal outside muSRFlow, set that variable to the download root or add the root to your own musrfit startup XML.