Dioptas

A GUI program for fast analysis of powder X-ray diffraction Images. It provides the capability of calibrating, creating masks, having pattern overlays and showing phase lines.

Documentation

The full user manual is hosted on Read the Docs:

https://dioptas.readthedocs.io/

Maintainer

Clemens Prescher (clemens.prescher@gmail.com)

Requirements

* python 3.9+

It is known to run on Windows, Mac and Linux. For optimal usage on a Windows machine it should be run with 64 bit python.

Installation

Executables

Executable versions for Windows, Mac OsX and Linux (all 64bit) can be downloaded from:

https://github.com/Dioptas/Dioptas/releases

The executable versions are self-contained folders, which do not need any python installation. Under Windows and Linux the program can be started by running the executable (e.g. Dioptas.exe or Dioptas). Under MacOS X the download will contain a .tar.gz archive. Extract it first, then right-click the .app folder and select "Open" to start the program.

If macOS shows a warning that the app "cannot be verified", you need to remove the quarantine attribute by running the following command in the Terminal:

find Dioptas_*.app -exec xattr -c {} \;

Python Package

The easiest way to install the dioptas python package is using pip.

pip install dioptas

and then run Dioptas by typing:

dioptas

in the commandline.

We also maintain a conda-forge version of dioptas. You can add the conda-forge channel to your conda distribution and then install dioptas via conda should be working correctly.

conda config --add channels conda-forge
conda install dioptas

Running the Program from source

In order to run the program from source, the easiest way is to use the uv package manager. Clone the repository from github and navigate to the repository:

git clone https://github.com/Dioptas/Dioptas.git
cd Dioptas

Note: This will clone the develop branch by default, which contains the latest development version. If you want to use the latest stable release instead, switch to the main branch after cloning:

git checkout main

Install uv and the dependencies by running:

python -m pip install uv
uv sync

This will create a new environment with all the required python packages in .venv.

Afterward the program can be started by running:

uv run dioptas

In order to run the program without uv, you need to install the required packages yourself. The packages are listed in the file pyproject.toml. The program can then be started by running:

python run.py

Scripting API

Dioptas can also be used as a Python library for headless integration from scripts and Jupyter notebooks. Set up your experiment in the GUI, save a .dio project file, then use it in code:

from dioptas.pipeline import Pipeline

# Load full setup (calibration, mask, corrections, etc.) from a project file
p = Pipeline.from_project("experiment.dio")

# Override the mask if needed
p.load_mask("new_beamstop.mask")

# Integrate a single image
pattern = p.integrate("sample_001.tiff")
pattern.save("sample_001.xy")

# Batch integrate with a glob pattern
patterns = p.integrate_batch("data/sample_*.tif")

See the scripting API documentation for the full reference.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.10.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for CPrescher from gravatar.com CPrescher

Credits

Author: Clemens Prescher

License

MIT License (MIT)

Requires

Python <3.14, >=3.11

Provides Extra

test

Classifiers

Report project as malware

Download files

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

Source Distribution

dioptas-0.8.7.tar.gz (8.4 MB view details)

Uploaded Source

Built Distributions

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

dioptas-0.8.7-cp313-cp313-win_amd64.whl (1.6 MB view details)

Uploaded CPython 3.13Windows x86-64

dioptas-0.8.7-cp313-cp313-win32.whl (1.6 MB view details)

Uploaded CPython 3.13Windows x86

dioptas-0.8.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.7 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

dioptas-0.8.7-cp313-cp313-macosx_14_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

dioptas-0.8.7-cp313-cp313-macosx_10_13_x86_64.whl (1.5 MB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

dioptas-0.8.7-cp312-cp312-win_amd64.whl (1.6 MB view details)

Uploaded CPython 3.12Windows x86-64

dioptas-0.8.7-cp312-cp312-win32.whl (1.6 MB view details)

Uploaded CPython 3.12Windows x86

dioptas-0.8.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.7 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

dioptas-0.8.7-cp312-cp312-macosx_14_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

dioptas-0.8.7-cp312-cp312-macosx_10_13_x86_64.whl (1.5 MB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

dioptas-0.8.7-cp311-cp311-win_amd64.whl (1.6 MB view details)

Uploaded CPython 3.11Windows x86-64

dioptas-0.8.7-cp311-cp311-win32.whl (1.6 MB view details)

Uploaded CPython 3.11Windows x86

dioptas-0.8.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.7 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

dioptas-0.8.7-cp311-cp311-macosx_14_0_arm64.whl (1.8 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

dioptas-0.8.7-cp311-cp311-macosx_10_9_x86_64.whl (1.5 MB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

File details

Details for the file dioptas-0.8.7.tar.gz.

File metadata

  • Download URL: dioptas-0.8.7.tar.gz
  • Upload date:
  • Size: 8.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7.tar.gz
Algorithm Hash digest
SHA256 4cd5f6d66f249a8570f59216fee300bb8307a8a06e206a18548f99e3e643ee7b
MD5 c8f114a5a6fbeb30a7300e3748313077
BLAKE2b-256 1a3ad4211d2a4be546e6ef38a80a776b8102d6432e1422f66efed44add951d3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7.tar.gz:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 3162e09e50d92128aa5c458ee6d1f6427c3fa4f200849c7d7a8ab39299af2010
MD5 3771282c80ada834ef86568e690bfaa7
BLAKE2b-256 2707a73eb61117c556a54c4cb72ee07c810d43fb8df64c7a4f727c06dca8cce8

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp313-cp313-win_amd64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp313-cp313-win32.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp313-cp313-win32.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.13, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 0bbf7a98700ab07f2f643d3e3cf654c96993d0f66af1e4eb827f60e980e977d4
MD5 c9e802f7b4a424ae3fec92b9311b61fa
BLAKE2b-256 995a26ccca809c1815c6551e02568f18ae19b996128531f6e4a19617d019c36b

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp313-cp313-win32.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 73e4e615ec0adeeca1e842e249038d3763aef5fc6c6f70dc171e089f4db4b078
MD5 c9c55bed2a7ed3d0cdb4ae1c0a051402
BLAKE2b-256 48975e2c645f27e5c6e105733d07913c53e351a6c6befb2b72a8433f5a880588

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 2c53e769f156ba0b26bad61e21b87d6118e32a29b804a24492892fe92abc344b
MD5 259b328d854ad907533408fd055be275
BLAKE2b-256 957063b53f0ae7b316967a7516b25d32d345acbacf5407714d5c50b4044b57ab

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp313-cp313-macosx_14_0_arm64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 a5c4113a21eaa29174997ff077e115e30fcf42ad8330798c70e27d9248f5af15
MD5 ccb9b804cd7c7e4704d109936ccfdb25
BLAKE2b-256 cdd91065dc659b986caf8ad3e13bc2c9100b204e896caa80bfec528654d154f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp313-cp313-macosx_10_13_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b44462f3d253312e7e97c663b5541bf4211332570a6371f6166daafe98b8cace
MD5 c3a5b9af5f15e0233c588a3467fba282
BLAKE2b-256 fcf123710e4377b3c03741bac8d3a98263629c1429085cffa86b7d5b31028f80

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp312-cp312-win_amd64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp312-cp312-win32.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp312-cp312-win32.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.12, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 b61325273826514a2453fd51bb4bf5a898a0706dc790b1be78047d5f8795e7b7
MD5 cd83a79a74a7fc86491a0c82dc7b24bd
BLAKE2b-256 499588fc871f5e01f0ac1cce7dd220e9687eb7150ab818e53f2f9ebd27f83080

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp312-cp312-win32.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4a1aed5f80b06a368420f3fd69f6ec4f4fa1697909bf6dbebc6dc1098005be96
MD5 aa23ed0c2a5089a67af49606b8fc0ba5
BLAKE2b-256 2583b95ed9aeb43757d65ad4060111f68b2e26b036abb4b8d368c82352ee5af8

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 221396f9e1d01a61add0da802845e46c455281b4941e6cae167d8e2f77a5b9f9
MD5 cfa698dc34d5009398a1866839f747a7
BLAKE2b-256 0d84831d40f8e192127bac64043a89e78239a2ee02a6cf1de8ea54bfa8cc8808

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp312-cp312-macosx_14_0_arm64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 483121628fbaa42a45a4a05e5ad84cd3b61fb1187640fc5a32d09f78490b034c
MD5 a039d41f95b28660d63232b938119655
BLAKE2b-256 ba9c8afd26344b7e1f37bcc237540d310c0445de52c1d1aca0a45a93c4d0f1a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp312-cp312-macosx_10_13_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 e65f6a5c3f2b5a811f7484114048ae1914743a3e537504829fe6874bec0219e9
MD5 8f79b35efeb5c3423d62f76cb8c08563
BLAKE2b-256 1ade5c9ac86c9002463e3ae55b1bf722c19fd9527bc831f6b3476adf9fe929e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp311-cp311-win_amd64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp311-cp311-win32.whl.

File metadata

  • Download URL: dioptas-0.8.7-cp311-cp311-win32.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.11, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dioptas-0.8.7-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 29aac1befb5f49818b218459d5457abaf4b495651814fa7f1989ff7fb8314112
MD5 60e93d1a63c6c5525f881b468dfaddd3
BLAKE2b-256 95a7acf3978ed227e834545252958b077d4315cd5a3b73ff82ca8b0a0280084a

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp311-cp311-win32.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8ce0fc4dd9f3d04d2ee3fc283bd5502f3665df67235abab36dc103a34b0be5ba
MD5 dfb314eddd7eab3c1938953bf72b7bc3
BLAKE2b-256 d92433c9173234302878ad9e8c450c419d24b8456495279d5448cfe84fa8342e

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 5ff7b2ce24a5dee7d06c22a6942e962aa0d69baf7b514ffd216fc01754233c24
MD5 94d2bf2adddb86908992d862854cbaed
BLAKE2b-256 c26b6d736aaeeed644bbaa3d510441fbca911975a9d2f32c6e20a08dfef65d44

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp311-cp311-macosx_14_0_arm64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

File details

Details for the file dioptas-0.8.7-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.8.7-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 5362eeeea7177b273c54da6788404b0b3589933d8061ccbf521c75fb30b09891
MD5 fb7ef0f108587c40813720ac0914ffce
BLAKE2b-256 0408ed2a88de987ab0f699b550cc1a313243c68270183eb39b7097670493d0ab

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.8.7-cp311-cp311-macosx_10_9_x86_64.whl:

Publisher: release.yml on Dioptas/Dioptas

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

Release history Release notifications | RSS feed

0.10.0

16 files

0.9.0

16 files

This release

0.8.7 This release

16 files

0.8.5

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.9

16 files

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