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.11, 3.12, or 3.13

Dioptas runs on 64-bit Windows, macOS, and Linux.

Installation

Executables

Executable versions for Windows, macOS, and Linux can be downloaded from:

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

The executable versions are self-contained and do not need a Python installation. Under Windows and Linux the program can be started by running the executable (e.g. Dioptas.exe or Dioptas). On macOS, open the .dmg and drag Dioptas to Applications. A .tar.gz archive of the application is also available.

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

on the command line.

Dioptas is also available from conda-forge:

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:
Latest release

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.10.0.tar.gz (9.2 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.10.0-cp313-cp313-win_amd64.whl (2.1 MB view details)

Uploaded CPython 3.13Windows x86-64

dioptas-0.10.0-cp313-cp313-win32.whl (2.1 MB view details)

Uploaded CPython 3.13Windows x86

dioptas-0.10.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.2 MB view details)

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

dioptas-0.10.0-cp313-cp313-macosx_14_0_arm64.whl (2.3 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

dioptas-0.10.0-cp313-cp313-macosx_10_13_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

dioptas-0.10.0-cp312-cp312-win_amd64.whl (2.1 MB view details)

Uploaded CPython 3.12Windows x86-64

dioptas-0.10.0-cp312-cp312-win32.whl (2.1 MB view details)

Uploaded CPython 3.12Windows x86

dioptas-0.10.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.2 MB view details)

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

dioptas-0.10.0-cp312-cp312-macosx_14_0_arm64.whl (2.3 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

dioptas-0.10.0-cp312-cp312-macosx_10_13_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

dioptas-0.10.0-cp311-cp311-win_amd64.whl (2.1 MB view details)

Uploaded CPython 3.11Windows x86-64

dioptas-0.10.0-cp311-cp311-win32.whl (2.1 MB view details)

Uploaded CPython 3.11Windows x86

dioptas-0.10.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.2 MB view details)

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

dioptas-0.10.0-cp311-cp311-macosx_14_0_arm64.whl (2.3 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

dioptas-0.10.0-cp311-cp311-macosx_10_9_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

File details

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

File metadata

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

File hashes

Hashes for dioptas-0.10.0.tar.gz
Algorithm Hash digest
SHA256 a5f9e9a6a83da3bc4698ec4dd1f576c7ec5dd2c9ac9162056e936e8d73453277
MD5 49570053d1bd6f3743b7962c6572b6e1
BLAKE2b-256 e8e7e580569fc080f0e2a942c06d457d69f3e08cae9691d97084a692c2bd81ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0.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.10.0-cp313-cp313-win_amd64.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 6252126965062fd1aa0487c55a4b7a0d31d775a62598072a1cd93e8440acadbc
MD5 d9f03e8fbc73a8665e04834693efc97b
BLAKE2b-256 8cded066a28846cb0d199edb4c6848256bf69e968b1f78677cab2305b85edee6

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp313-cp313-win32.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 1c7139c7d6415817a3795dc44f10b3302d3f8007bc150bf58492f6d590bb7647
MD5 5a624c4235d2811c9515055c72de0168
BLAKE2b-256 fa44bcb73c516659bda33078dc66f38e62579283f8bbc5016ad1616e19392caa

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 11181ca25584041fcaed0b5ed5be007f2a93451b30d1a94d7ed0de473ad9f3a0
MD5 ef80ae1d8cafdd1cf6d8c61640feebeb
BLAKE2b-256 5ba7d57977536d7a73f0a7bc771793ab0d9479cd30e36d027089207dc4f345d2

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 10ca15180250ddfab518a79985edf748740c640340298244069505b5a37f9319
MD5 87d7d04f4002387b1a5b429c68e2ba68
BLAKE2b-256 d030e4d82abd6d2670921f4c5cf7959d3ad57e866e5482373d9cb29318e281a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 08ea1bfd23ea3a080a1647844b3c7ff63b5b06c7e78d24a5778beffce6aa13ad
MD5 82951f0608a4212aa57dc604f2b08731
BLAKE2b-256 0444a2d92cfc86bb5e78962ea02e707e764c2d02cac1326781cb81b3ba7a7b67

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp312-cp312-win_amd64.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 4451a97f235e33aaee603275a83ec3c71141bec3eeb1176e1913d97bce3fa34e
MD5 9050fc075797b1e9ee09e3abe3c0d9c2
BLAKE2b-256 f2ef6c63c02496c2f8699c8ccfdf4a4882535092c0fc9199707519b10d89ba13

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp312-cp312-win32.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 92452ea56cfecf9ea9ae0f331d7800cb53d5d9b9806e06dc022fb3cb8169563d
MD5 909b95204c965a5d72ca97f6111f4206
BLAKE2b-256 33193aefb8b9cdf57af04e72302230da33ce774c6a3e7b42c98c617964ac773a

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8db216b11e2f83d5c2b9198743b4d3bd96a100eb486a4c55a5a8429b54e2dd86
MD5 860442915bb9a5708d22f53153831810
BLAKE2b-256 53d89538f8a43826819ab8d3ad4a801405915a4a9e164adc8d9ae5f494b3a784

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 fbf5eddcd9130a389d31572dc68bb107b0057b4dae488c05307fda4dced2587a
MD5 42996eda8880f200ec89f291dd560329
BLAKE2b-256 3613f40793e097bf678b89dc914d8f7395cff4735e3b33b29e3ffe6d65aeadd5

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 525b8416dd0852334e8c8c9bd6457b1754dd409b6985456742921a39ab93a905
MD5 6520a75f07630d042612588350ed7d50
BLAKE2b-256 8551ba2a59eaee59816540736cf26e1537761b1b9da66c9a209b6c6a066bff15

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp311-cp311-win_amd64.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 6fdc4c33cca1350281bf46785695fc7474be5a6fd8a0ce82f13b6e3d84608108
MD5 fb503bf9f088148f7c7b34772b0320c0
BLAKE2b-256 20a9293065b2284a231d674e78e1d5c7776765da383edf3916bc3f883452275a

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp311-cp311-win32.whl.

File metadata

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

File hashes

Hashes for dioptas-0.10.0-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 13812d4c4f10c34744480fbc7f99edf0ef723131e811d4d1a9492d40055fce9c
MD5 1971c4bf6d6c037df3117ab17e006287
BLAKE2b-256 614b2cef0925bb37f7714480b59ea95557af9d761e73479e4e8c51df2523bbd0

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 87ac089c1ab767081c7136af3afc2edfa0e2f6b7cb55c49fe22087df6d76844a
MD5 e28d9cc950bfcff6aa63db75cfb83eb7
BLAKE2b-256 a5cdd3fe75fca9aa4661ea59ca5481731086135963b23f75213d19862286c779

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 6df4d9614237ecc0d993cf14527604427273f12d1a4cb057cab549f5a7f1e752
MD5 14479393b4099639882899f4acd80b96
BLAKE2b-256 d7b96e5fa94de7d053ae27acfff5e71ab2aebb17ccbbb5cc059b2b944888964e

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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.10.0-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for dioptas-0.10.0-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 e92a9bce9df877d523c69c3fe4614cfca10069dae78f6d380f2cb87a3372e7a2
MD5 405fc4e49a033a973352fb1c6ece3afe
BLAKE2b-256 5a340bdd106d26f031ee389de2947247bde7a4b71cafeaad294752131a6d3b04

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.10.0-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

This release

0.10.0 This release

16 files

0.9.0

16 files

0.8.7

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