Skip to main content

Pilatus detector image synthesizer for SAXS beamlines

Project description

Pilatus Synthesizer

Pilatus Synthesizer combines multiple Pilatus X-ray detector images taken at different detector positions into a single synthesized image. Used at KEK Photon Factory and SPring-8 beamlines for SAXS experiments.

Features

  • Sub-pixel alignment: Bilinear interpolation for accurate image registration
  • Mask handling: SAngler mask file support for excluding bad pixels
  • Intensity normalization: Beam monitor counter-based intensity correction
  • Multiple synthesis methods: Cover (gap-filling) and average modes
  • GUI and CLI: Interactive Tkinter interface or batch command-line processing
  • Auto-run: Folder polling for automated synthesis during measurements
  • Facility support: Photon Factory (left direction) and SPring-8 (right direction)

Tested Platforms

  • Python 3.13 on Windows 11
  • Python 3.12 on Windows 11

Installation

pip install -U pilatus-synthesizer

Usage

GUI mode (default)

pilatus-synthesizer

Command-line mode

pilatus-synthesizer -c -i INPUT_FOLDER [-o OUTPUT_FOLDER]

Options

Flag Description
-c Run in command mode (no GUI)
-i FOLDER Input image folder (required for command mode)
-o FOLDER Output folder (default: INPUT/Synthesized)
-n Auto-number output folders if default exists
-j FOLDER Adjusted image folder
-m Write intermediate results
-v Show version info

Documentation

Related Projects

License

GNU General Public License v3.0

Copyright

Copyright (c) 2015-2026, SAXS Team, KEK-PF

Project details


Download files

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

Source Distribution

pilatus_synthesizer-0.5.0.tar.gz (2.6 MB view details)

Uploaded Source

Built Distribution

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

pilatus_synthesizer-0.5.0-py3-none-any.whl (165.5 kB view details)

Uploaded Python 3

File details

Details for the file pilatus_synthesizer-0.5.0.tar.gz.

File metadata

  • Download URL: pilatus_synthesizer-0.5.0.tar.gz
  • Upload date:
  • Size: 2.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pilatus_synthesizer-0.5.0.tar.gz
Algorithm Hash digest
SHA256 8540b09ae439a938a88e087ad6ad3bd057e65cf20b1c97ab16006147f9700ff5
MD5 64ac5746921c26e0869709041fdcdabf
BLAKE2b-256 7dcb80a9ccf681c771358d42cfc80dccb7fa2a2099bf6fd3b5caa1a437ee544f

See more details on using hashes here.

Provenance

The following attestation bundles were made for pilatus_synthesizer-0.5.0.tar.gz:

Publisher: upload_to_pypi.yml on biosaxs-dev/pilatus-synthesizer

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

File details

Details for the file pilatus_synthesizer-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pilatus_synthesizer-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 35aee94b630c3a416c35ba9982b23dfad005db4ddb1639e9c4fd45e3068eb456
MD5 cbf00e69325ae181e3c6f26a2beca0c9
BLAKE2b-256 6e55d55bcffb47cd29ad77a3739d755a9d998c7cd7b1411be01494171a1c4ec9

See more details on using hashes here.

Provenance

The following attestation bundles were made for pilatus_synthesizer-0.5.0-py3-none-any.whl:

Publisher: upload_to_pypi.yml on biosaxs-dev/pilatus-synthesizer

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page