Skip to main content

Tools for pixel partitioning, intensity-based segmentation, and visualization.

Project description

docs build-unix-mac-win

Pixel Partitioner: Tools for pixel partitioning, intensity-based segmentation, and visualization.

Pixel Partitioner is a computational tool designed to facilitate the analysis of single-layer TIFF images by quantifying the presence of specific markers within these images. The primary objective of this package is to discern and quantify signal within images, returning the percentage of pixels that are positive for a designated marker.

Input Specification: The package processes single-layer TIFF images, catering to the requirements of image analysis in fields such as cancer biology, where accurate identification of markers is crucial for understanding disease initiation and progression.

Methodological Approach: Pixel Partitioner employs a multi-class Otsu thresholding method as its core algorithm. This technique is pivotal for its ability to differentiate between pixels positive for the marker of interest and the background. Initially, the package applies a two-class Otsu thresholding to segregate positive pixels. Recognizing the challenge of high background noise, which may result in overclassification, the package implements an innovative strategy to refine its analysis. It operates under the assumption that the expression of a given marker should not exceed a certain threshold - by default, set at 5% of the total pixels in any given image. If the percentage of positive pixels surpasses this threshold, indicating potential overclassification due to background noise, the software automatically escalates to a three-class Otsu thresholding. This process is iteratively conducted until the positive pixel percentage falls below the set threshold, ensuring robustness in signal identification.

Adaptive Features: An essential aspect of Pixel Partitioner is its adaptability. It records detailed information regarding the thresholding process and the resultant pixel classification in a dataframe, which is subsequently saved as a CSV file in a user-specified output directory. Moreover, to enhance user confidence in the results, the package generates modified copies of the original images, overlaying the classified positive pixels. This visual output allows users to verify the accuracy of the segmentation. In instances where the output does not meet the user's expectations, options are available to adjust the percentPositiveThreshold parameter or exclude particularly challenging images from the dataset, thereby offering flexibility in handling diverse image sets.

In summary, Pixel Partitioner stands as a tool that streamlines the quantification of specific markers in single-layer TIFF images through advanced thresholding techniques. Its capability to adaptively refine its approach based on the background noise and the specific requirements of the analysis makes it a valuable resource for scientists and researchers engaged in image analysis, particularly within the realms of cancer biology and other fields where precise marker quantification is imperative.

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

pixelpartitioner-1.0.2.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

pixelpartitioner-1.0.2-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file pixelpartitioner-1.0.2.tar.gz.

File metadata

  • Download URL: pixelpartitioner-1.0.2.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.2 CPython/3.10.9 Darwin/23.1.0

File hashes

Hashes for pixelpartitioner-1.0.2.tar.gz
Algorithm Hash digest
SHA256 a14f91bdab4ee0e0e1c410005ea1cf0e007a918e801d3d192d737667a7fb29d0
MD5 d028b45b514852f994cac2f4705452ad
BLAKE2b-256 55865243016194648efb3fe7f7ad902ffa25805cf79a1d85c79be93e7d2ced05

See more details on using hashes here.

File details

Details for the file pixelpartitioner-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for pixelpartitioner-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9be6e270febed3ba97c78d4b27a970bd5107b9d50a64e41b9ea712684c255035
MD5 ea70ee6cb47a8d9386ef2c1ba3e2d2f6
BLAKE2b-256 62b9d34ecd9350d645c90bd6c3822548945315358dd4ff3db94e2a6f4ae58c38

See more details on using hashes here.

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