Skip to main content

PartSeg is python GUI for bio imaging analysis especially nucleus analysis,

Project description

PartSeg

Tests PyPI version Documentation Status Azure Pipelines Build Status DOI Total alerts Language grade: Python Codacy Badge Requirements Status Code Style codecov

PartSeg is a GUI and a library for segmentation algorithms.

This application is designed to help biologist with segmentation based on threshold and connected components.

interface

Tutorials

  • Tutorial: Chromosome 1 (as gui) link
  • Data for chromosome 1 tutorial link
  • Tutorial: Different neuron types (as library) link

Installing

  • From binaries:

    • Windows (build on Windows 10)
    • Linux (build on Ubuntu 18.04)
    • MacOS (build on MacOS Mojave)
  • With pip:

    • From pypi: pip install PartSeg[pyqt]
    • From repository: pip install git+https://github.com/4DNucleome/PartSeg.git

Running

If you downloaded binaries, run the PartSeg (or PartSeg.exe for Windows) file inside the PartSeg folder

If you installed from repository or from pip, you can run it with PartSeg command or python -m PartSeg. First option does not work on Windows.

PartSeg export few commandline options:

  • --no_report - disable error reporting
  • --no_dialog - disable error reporting and error dialog. Use only when running from terminal.
  • segmentation_analysis - skip launcher and start analysis gui
  • segmentation - skip launcher and start segmentation gui

napari plugin

PartSeg provides napari plugins for io to allow reading projects format in napari viewer.

Save Format

Saved projects are tar files compressed with gzip or bz2.

Metadata is saved in data.json file (in json format). Images/masks are saved as *.npy (numpy array format).

Interface

Launcher. Choose the program that you will launch:

launcher

Main window of Segmentation Analysis:

interface

Main window of Segmentation Analysis with view on measurement result:

interface

Window for creating a set of measurements:

statistics

Main window of Mask Segmentation:

mask interface

Laboratory

Laboratory of Functional and Structural Genomics http://4dnucleome.cent.uw.edu.pl/

Cite as

Bokota, G., Sroka, J., Basu, S. et al. PartSeg: a tool for quantitative feature extraction from 3D microscopy images for dummies. BMC Bioinformatics 22, 72 (2021). https://doi.org/10.1186/s12859-021-03984-1

Changelog

0.13.3

  • Fix saving roi_info in multiple files and history

0.13.2

  • Fix showing label in select label tab

0.13.1

  • Add Haralick measurements
  • Add obsep file support

0.13.0

  • Add possibility of custom input widgets for algorithms
  • Switch to napari Colormaps instead of custom one
  • Add points visualization
  • Synchronization widget for builtin (View menu) napari viewer
  • Drop Python 3.6

0.12.7

  • Fixes for napari 0.4.6

0.12.6

  • Fix prev_mask_get
  • Fix cache mechanism on mask change
  • Update PyInstaller build

0.12.5

  • Fix bug in pipeline execute

0.12.4

  • Fix ROI Mask windows related build (signal not properly connected)

0.12.3

  • Fix ROI Mask

0.12.2

  • Fix windows bundle

0.12.1

  • History of last opened files
  • Add ROI annotation and ROI alternatives
  • Minor bugfix

0.12.0

  • Toggle multiple files widget in View menu
  • Toggle Left panel in ROI Analysis in View Menu
  • Rename Mask Segmentation to ROI Mask
  • Add documentation for interface
  • Add Batch processing tutorial
  • Add information about errors to batch processing output file
  • Load image from the batch prepare window
  • Add search option in part of list and combo boxes
  • Add drag and drop mechanism to load list of files to batch window.

0.11.5

  • add side view to viewer
  • fix horizontal view for Measurements result table

0.11.4

  • bump to napari 0.3.8 in bundle
  • fix bug with not presented segmentation loaded from project
  • add frame (1 pix) to image cat from base one based on segmentation
  • pin to Qt version to 5.14

0.11.3

  • prepare for napari 0.3.7
  • split napari io plugin on multiple part
  • better reporting for numpy array via sentry
  • fix setting color for mask marking

0.11.2

  • Speedup image set in viewer using async calls
  • Fix bug in long name of sheet with parameters

0.11.1

  • Add screenshot option in View menu
  • Add Voxels measurements

0.11.0

  • Make sprawl algorithm name shorter
  • Unify capitalisation of measurement names
  • Add simple measurements to mask segmentation
  • Use napari as viewer
  • Add possibility to preview additional output of algorithms (In View menu)
  • Update names of available Algorithm and Measurement to be more descriptive.

0.10.8

  • fix synchronisation between viewers in Segmentation Analysis
  • fix batch crash on error during batch run, add information about file on which calculation fails
  • add changelog preview in Help > About

0.10.7

  • in measurements, on empty list of components mean will return 0

0.10.6

  • fix border rim preview
  • fix problem with size of image preview
  • zoom with scroll and moving if rectangle zoom is not marked

0.10.5

  • make PartSeg PEP517 compatible.
  • fix multiple files widget on Windows (path normalisation)

0.10.4

  • fix slow zoom

0.10.3

  • deterministic order of elements in batch processing.

0.10.2

  • bugfixes

0.10.1

  • bugfixes

0.10.0

  • Add creating custom label coloring.
  • Change execs interpreter to python 3.7.
  • Add masking operation in Segmentation Mask.
  • Change license to BSD.
  • Allow select root type in batch processing.
  • Add median filter in preview.

0.9.7

  • fix bug in compare mask

0.9.6

  • fix bug in loading project with mask
  • upgrade PyInstaller version (bug GHSA-7fcj-pq9j-wh2r)

0.9.5

  • fix bug in loading project in "Segmentation analysis"

0.9.4

  • read mask segmentation projects
  • choose source type in batch
  • add initial support to OIF and CZI file format
  • extract utils to PartSegCore module
  • add automated tests of example notebook
  • reversed mask
  • load segmentation parameters in mask segmentation
  • allow use sprawl in segmentation tool
  • add radial split of mask for measurement
  • add all measurement results in batch, per component sheet

0.9.3

  • start automated build documentation
  • change color map backend and allow for user to create custom color map.
  • segmentation compare
  • update test engines
  • support of PySide2

0.9.2.3

  • refactor code to make easier create plugin for mask segmentation
  • create class base updater for update outdated algorithm description
  • fix save functions
  • fix different bugs

0.9.2.2

  • extract static data to separated package
  • update marker of fix range and add mark of gauss in channel control

0.9.2.1

  • add VoteSmooth and add choosing of smooth algorithm

0.9.2

  • add pypi base check for update

  • remove resetting image state when change state in same image

  • in stack segmentation add options to picking components from segmentation's

  • in mask segmentation add:

    • preview of segmentation parameters per component,
    • save segmentation parameters in save file
    • new implementation of batch mode.

0.9.1

  • Add multiple files widget

  • Add Calculating distances between segmented object and mask

  • Batch processing plan fixes:

    • Fix adding pipelines to plan
    • Redesign mask widget
  • modify measurement backend to allow calculate multi channel measurements.

0.9

Begin of changelog

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

PartSeg-0.13.3.tar.gz (309.4 kB view details)

Uploaded Source

Built Distribution

PartSeg-0.13.3-py3-none-any.whl (297.6 kB view details)

Uploaded Python 3

File details

Details for the file PartSeg-0.13.3.tar.gz.

File metadata

  • Download URL: PartSeg-0.13.3.tar.gz
  • Upload date:
  • Size: 309.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for PartSeg-0.13.3.tar.gz
Algorithm Hash digest
SHA256 8a84a705aa5dbaee9310223ebeb2fede71c110d07e81352129a36161cd75a376
MD5 1a7464eccd47724555d6b82ed90b4ecb
BLAKE2b-256 985323a26f0a170aec33522cbd4dc060695d40d0d5de1f0acd05f285ac4f9010

See more details on using hashes here.

File details

Details for the file PartSeg-0.13.3-py3-none-any.whl.

File metadata

  • Download URL: PartSeg-0.13.3-py3-none-any.whl
  • Upload date:
  • Size: 297.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for PartSeg-0.13.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5a3681bca521af50973d7f46aa3c2695c4290e562876b82cccf643ae243da406
MD5 290688016d550bbd50caa380a0349af1
BLAKE2b-256 7ef62540d42bd2d63636431a0e1f579707d841278b8581055e914976c903c66a

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