Skip to main content

Image quality assessment with Gaussian Mixture Models

Project description

This is a tool that fits Gaussian Mixture Models to grey value distributions from X-ray micro-computed tomography images. This tool was developed as part of a PhD project at the University of Southampton in the 3-D X-ray histology team.


How it works

GaussQuality fits a 1-D Gaussian Mixture Model (GMM) to the grey value distribution of a 2D X-ray micro-computed tomography (μCT) image. The GMM fits a specified number of Gaussian components to the grey value distribution, where each component represents the distribution of grey values for a single material in the specimen. The mean (μ), standard deviation (σ), and weight (φ) of each Gaussian component are estimated.

  • μ is the location of the Gaussian along the grey value axis, dependent on X-ray interactions with the material
  • σ is its spread which is dependent on heterogeneity of the material and image noise
  • φ is the proportion of the image taken up by this material

μ and σ can be used to calculate signal-to-noise ratio (SNR) and contrast-to-noise ratio (CNR).

μ, σ, and φ can be estimated for several 2D images in a 3D stack, showing how the image varies in 3D. Only one 2D image is held in memory at once, so images larger than memory can be processed. 3D images must be saved as sequences of 2D images.


Installation

GUI

Download the .exe for Windows or .app for MacOS.

Simply double click the executable and the GUI should start. If you have any trouble, try opening the executable in a terminal to debug any errors.

GaussQuality GUI

Python library

GaussQuality is available on conda. In the terminal:

conda activate <myenv>
conda install gaussquality

Example usage

See GaussQuality_Example.ipynb for a demo, and explanation of what each parameter controls.


Citation


API Docs

The API docs are available here.

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

gaussquality-0.0.2.tar.gz (27.2 kB view details)

Uploaded Source

Built Distribution

gaussquality-0.0.2-py3-none-any.whl (26.9 kB view details)

Uploaded Python 3

File details

Details for the file gaussquality-0.0.2.tar.gz.

File metadata

  • Download URL: gaussquality-0.0.2.tar.gz
  • Upload date:
  • Size: 27.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.5

File hashes

Hashes for gaussquality-0.0.2.tar.gz
Algorithm Hash digest
SHA256 25014e56f761252858c540c72a290b0bc0d5a95b19bdd92404c5415806999e56
MD5 623845719b12fd4e9f562785cb2c013e
BLAKE2b-256 54839f4df4b8263231c78704022a23bc87c7cf8621d05446af18a20cad0f7bf9

See more details on using hashes here.

Provenance

File details

Details for the file gaussquality-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: gaussquality-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 26.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.5

File hashes

Hashes for gaussquality-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9e192446cb888058f6e29c17f41260b61a19ff6b6a93b579afc0fb45f4766292
MD5 fbe2684b31b100e663bfc82c67ff7a57
BLAKE2b-256 de6ddb3ad33a76e3efc2de5f66ea171f2ba053cdacb32bbae2c65664a21db68d

See more details on using hashes here.

Provenance

Supported by

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