Skip to main content

viewer4a1

A viewer and analysis tool for the scan data of beamline 4A1 and for ARPES spectra from several instruments, built on the ImageTool of erlab.

It reads

Format From
.h5 with its .jsonl 4A1 scans
.ibw, .pxt, .pxp Igor Pro
.itx Igor text, from the 4A1 ARPES program
.zip Scienta analyser scans
.krx MB Scientific analyser
.fits ALS beamline 7.0.2 (MAESTRO)

and shows them in a browser of a folder and in ImageTool. An Analysis menu holds Fermi edge fitting, normalisation and background subtraction, peak fitting, cuts along a line, momentum and kz conversion, MAESTRO's detector pixels to angle and the removal of spikes; a session keeps a piece of work, its data, fits and windows, in one file; figures are copied or saved as vector artwork.

Install

uv installs the viewer and the Python it runs on, without administrator rights, apart from any other Python on the computer.

  1. Install uv, once. On Windows, in PowerShell:

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    

    On macOS or Linux, in Terminal:

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

    Then close the window and open a new one.

  2. Install the viewer:

    uv tool install --python 3.12 "viewer4a1[tested]"
    

    [tested] installs every package the viewer needs at the version it was tested with. If uv says the folder it put the viewer in is not on your PATH, run uv tool update-shell and open a new window.

  3. Start it:

    viewer4a1 gui
    

    opens the folder you are in; viewer4a1 gui FOLDER opens another. viewer4a1 --help lists the other commands.

To update: uv tool upgrade viewer4a1. To see which version you have: uv tool list. To remove it: uv tool uninstall viewer4a1.

Computers

The viewer is developed and tested on Linux and used on Windows and macOS. Every package it needs is published for

  • Windows 10 and 11 on Intel or AMD processors,
  • macOS 12 or newer on Apple silicon,
  • Linux with glibc 2.34 or newer on Intel or AMD processors (Ubuntu 22.04, Debian 12, RHEL 9 and later), and with glibc 2.39 or newer on ARM (Ubuntu 24.04 and later).

On an Intel Mac, [tested] installs numba 0.62 and numpy 2.3, the newest published for it, and that combination has not been tested. On Windows on an ARM processor it does not install: hdf5plugin, which erlab needs, has no build for it.

If the install says that no version of a package fits the computer,

uv tool install --python 3.12 "viewer4a1[gui]"

takes the newest versions that do fit, which have not been tested with the viewer.

Licence

GPL-3.0-only; see LICENSE. The viewer uses erlab and PyQt6, which are GPL as well.

Metadata

Release files for viewer4a1 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for viewer4a1 0.3.0
File Interpreter ABI Platform
viewer4a1-0.3.0-py3-none-any.whl Python 3 none any Details

Release files / viewer4a1-0.3.0-py3-none-any.whl

Download URL viewer4a1-0.3.0-py3-none-any.whl
Size 366.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8c2d0c2cb016bd78b9ef897add4149c6479278ca20214918bb7bf059be549882
BLAKE2b-256 checksum
How to use checksums
52175e256f43e8cf8545ed4197d4ecfb3961805aedc25be41be2017dcae14383
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Rocky Linux","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for viewer4a1 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.3.0 This release

1 release file No provenance

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