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.9.0.tar.gz (8.6 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.9.0-cp313-cp313-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.13Windows x86-64

dioptas-0.9.0-cp313-cp313-win32.whl (1.5 MB view details)

Uploaded CPython 3.13Windows x86

dioptas-0.9.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.6 MB view details)

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

dioptas-0.9.0-cp313-cp313-macosx_14_0_arm64.whl (1.7 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

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

Uploaded CPython 3.13macOS 10.13+ x86-64

dioptas-0.9.0-cp312-cp312-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.12Windows x86-64

dioptas-0.9.0-cp312-cp312-win32.whl (1.5 MB view details)

Uploaded CPython 3.12Windows x86

dioptas-0.9.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.6 MB view details)

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

dioptas-0.9.0-cp312-cp312-macosx_14_0_arm64.whl (1.7 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

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

Uploaded CPython 3.12macOS 10.13+ x86-64

dioptas-0.9.0-cp311-cp311-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.11Windows x86-64

dioptas-0.9.0-cp311-cp311-win32.whl (1.5 MB view details)

Uploaded CPython 3.11Windows x86

dioptas-0.9.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.6 MB view details)

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

dioptas-0.9.0-cp311-cp311-macosx_14_0_arm64.whl (1.7 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

dioptas-0.9.0-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.9.0.tar.gz.

File metadata

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

File hashes

Hashes for dioptas-0.9.0.tar.gz
Algorithm Hash digest
SHA256 6747b6e004f00317b970e8dea17a0a2d97128f588700bcb2f003abd46f1c206c
MD5 683027107618032d9d4b44636cb85447
BLAKE2b-256 a36083a635dbd8b4b7172f0f492c786125ae76121d58ffc7beaa8e665b931f04

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 01fe90ea4b3bdd4067abed29766872e805ea6a2994a9f6100e4d337b5ad93585
MD5 1bd9b07d4a8edaa562280927a6ce41af
BLAKE2b-256 8ce511131a70d384f0dfb2b724ee8b9f1c0f7971970888da6d3f7307d5a6df8a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp313-cp313-win32.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 38e023b7b507f37d4c6b502636119ad3e6e99e0f16e2d1bb63d6328001139bb4
MD5 236ac42ebd1ac035e0e14c41d5d0b7c5
BLAKE2b-256 9e697cfce9ded7e57dc79c9e6565ce96f1a8309ccc3df52d1f1c44d96af9e471

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.9.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.9.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.9.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 93fdd1c3c8494b2061d4f6be662ab16666714d97accbc0a0ed7af55487fa40c2
MD5 8e5dcff2c99c938e640f6bf45edd82b7
BLAKE2b-256 bbadaa6f44b0d8e87854bfb3aa4ff7b21c728010ee04ad238cbf2c343c1643b1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 096f1d2d325ce5a2f8c94cbde3852757d87294cc5e88fc4dc8ac0401a5b7d65d
MD5 7041984d5acb6aa8b051398408ba4a8f
BLAKE2b-256 1d0ce70f01af5431e08e1bc9d11c91d5da54ebb3e3c26a2c3398651db0e7f4e1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 2cf24767f89d3306de8f145796c085a557a0f81cf6c3f1eb31104ed985bc156b
MD5 e5c35f5df5727282f99b2567975f1da1
BLAKE2b-256 95fc15fdecb12aa501bfa9c523991c5127db243099c37b40e440cd831e458c8a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 fbafb36e89d6fed517eeef9988c4b95a25803e09679737bf82d77813600383f0
MD5 94467f5d057a81d6bce2ec9c3b2ac78b
BLAKE2b-256 979de353827b1fe7d028ead3b272f862ee7ecf7b2679bb6a2e0a094935f5fdb3

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp312-cp312-win32.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 83cb2fdaf701910a9a95abf6dbab2e95fa76e3d6ed1f3217b53c2425bbf44e8e
MD5 0a903cce25e9cdf04e4adbd2073cc469
BLAKE2b-256 09aa11388f18f263347cae2d656a30c72a1ae59453d3cc5d159c14b0b2a617d4

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.9.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.9.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.9.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 525ca83cdfb242a13285094796b88a7ab74b0e536b15c02290e37bbd8b86bcc7
MD5 10353cba8351387a6a4172f75e2d9da0
BLAKE2b-256 916833c8a16c89e8ff2b1d153d135eaf09e7c232fb3057a9ead3c6b6b6e3af03

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 b10995985a6f8b23f543750c3491588ace5aac48eb290f280ddc66b246255658
MD5 b6dd748f769ff3eea6ec54ec3766519b
BLAKE2b-256 ff43e104fd9b075e620077443b8f2500d48cb2835a777f14074b3cde2157069a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 8e2f06796830e33dccfadb3994c3b6f5ef7a86e763dfa171b337eb5940d07d8e
MD5 25f6b1d6d293286855cda0b48ef149fa
BLAKE2b-256 905bcc803df090a1b107094d0ba0b1c6c96c7f66cfbacd6135fd24db5e57e83a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 6cd11955b9fba6f0cdb895d27ffbf89c23884a59adaa88edf9a653bbe03f0963
MD5 748f5a627389962ac56ffce212e6c241
BLAKE2b-256 8f8c4386f9f16910edcc18996fd7f217a37379163f02c8849cf1c0b92e68f089

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dioptas-0.9.0-cp311-cp311-win32.whl
  • Upload date:
  • Size: 1.5 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.9.0-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 b2896711542bd4e7823d0ffa7502d869e8a708a563452f614e22f86ad3851ba7
MD5 0591f0fb67d8887eff15406d8a118de2
BLAKE2b-256 10dd0b1592b8bca97d4b9becafc317df90216af7d9926603e02c79593055929f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dioptas-0.9.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.9.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.9.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a02357402f14ffa0c8bf378c1aa4a125a87d6327e483a6cdf7c3ca542f2cb7cd
MD5 f7972279f3a17ab3614f439dc85f5d2b
BLAKE2b-256 d32434d7b222d4801938559b33a3a94c1e271a7740bc651964583da1a0d8d68e

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 9ef2e891d890dc6559d310eae9fb23019e089729332627cb4cf58ea7c0b5ddfe
MD5 dce511c3b081f31bbddf1448cd37ee18
BLAKE2b-256 202463fa65fd7b92ca585e329bd47bdc264660956f63ca8b93c7e7785d7f45f7

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for dioptas-0.9.0-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 333a38a81ef7400c0cf21a7bfa84e5f6902aaddf97807a689080d833ba30c1cf
MD5 92c1a344880eaa96eb51048ca0381bb4
BLAKE2b-256 2e6917637bbe11a82005fba372a4a2e150b293b9ec4cb7cc9471905d9ab4ab44

See more details on using hashes here.

Provenance

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

0.10.0

16 files

This release

0.9.0 This release

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