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
- User's Guide: doc/UsersGuide-0_4_8.pdf
- Migration Plan: MIGRATION_PLAN.md
Related Projects
- molass-library — SEC-SAXS analysis library
- molass-legacy — Legacy MOLASS application
License
GNU General Public License v3.0
Copyright
Copyright (c) 2015-2026, SAXS Team, KEK-PF
Acknowledgements
The migration of this project from the legacy codebase to the current Python package structure was performed with the assistance of GitHub Copilot (Claude Sonnet 4.6), 2026.
1 maintainer
Metadata
1 maintainer
Release files for pilatus-synthesizer 0.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pilatus_synthesizer-0.5.1.tar.gz | 2.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pilatus_synthesizer-0.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.6 MB
Release files / pilatus_synthesizer-0.5.1.tar.gz
| Download URL | pilatus_synthesizer-0.5.1.tar.gz |
|---|---|
| Size | 2.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
843c2704b26cc9c6b928cd60c74536a0b5fed97c8b89f9fc2908d7d817676602
|
|
BLAKE2b-256 checksum How to use checksums |
8f48c6d6f0d1254f9695c939b7f50e35acb68bc6256deaf217bc9c355400247f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 6, 2026.
Transparency logRelease files / pilatus_synthesizer-0.5.1-py3-none-any.whl
| Download URL | pilatus_synthesizer-0.5.1-py3-none-any.whl |
|---|---|
| Size | 88.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b687448e88d8e30e57cbdec839e42b0e326ecc31249bbc1f7d4056218bf0af8
|
|
BLAKE2b-256 checksum How to use checksums |
5678f672806ffa03dc56fefadcb9257becbb9abc4c4b0847fda13d763d3caca3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 6, 2026.
Transparency log
