simple-slice-viewer


Namesimple-slice-viewer JSON
Version 0.97 PyPI version JSON
download
home_page
SummarySimple slice viewer for Simple ITK images
upload_time2023-05-08 08:54:50
maintainer
docs_urlNone
authorM. Segbers
requires_python
licenseMIT
keywords imageviewer dicom simpleitk
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # README #

## Overview

A viewer to scroll through slices of 2D, 3D and 4D medical data sets 
(CT, PET, MRI...)

Supports files than can be read by SimpleITK:

* Nifti: .nii .nii.gz .nia .img .img.gz .hdr
* Nrrd:  .nrrd .nhdr
* Meta Image: .mhd .mha 

And probably some more types as long as they are supported by the SimpleITK
file reader.

In addition there is support for reading folders with dicom data. 
Sorting dicom data into 3D volume is tricky and may depend on modality, vendor
and model of the imaging device. Basic support is offered that works well with
CT, PET and MRI. For Siemens PET the PET data is read in SUV.

A second image can be loaded and is displayed as fusion on top of the first.
Works well with PET/CT and PET/MRI data.



##Usage

pip install simple-slice-viewer

### Command Line
    simple-slice-viewer
    simple-slice-viewer ct.nii
    simple-slice-viewer ct.nii --fusion pet.nii
    

or use ssv as shorthand:
    ssv
    ssv ct.nii
    ssv ct.nii --fusion pet.nii
    ssv --image ct.nii --fusion pet.nii

### Inside Python

In Python images should be read to SimpleITK Image objects first.

    import simple_slice_viewer as ssv
    import SimpleITK as sikt

    image = sitk.ReadImage('ct.nii')
    fusion = sitk.ReadImage('pet.nii')

    ssv.display(image=image, fusion=fusion)
    

To display a numpy array convert it to SimpleITK first

    import SimpleITK as sitk
    import simple_slice_viewer as ssv
    image = sitk.GetImageFromArray(np_array)
    ssv.display(image)




            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "simple-slice-viewer",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "ImageViewer DICOM,SimpleITK",
    "author": "M. Segbers",
    "author_email": "m.segbers@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/1c/7d/0a377593a87f33e4cd54ecc7edd2e7db0e48e64191c164324a9e7f4904b1/simple-slice-viewer-0.97.tar.gz",
    "platform": null,
    "description": "# README #\r\n\r\n## Overview\r\n\r\nA viewer to scroll through slices of 2D, 3D and 4D medical data sets \r\n(CT, PET, MRI...)\r\n\r\nSupports files than can be read by SimpleITK:\r\n\r\n* Nifti: .nii .nii.gz .nia .img .img.gz .hdr\r\n* Nrrd:  .nrrd .nhdr\r\n* Meta Image: .mhd .mha \r\n\r\nAnd probably some more types as long as they are supported by the SimpleITK\r\nfile reader.\r\n\r\nIn addition there is support for reading folders with dicom data. \r\nSorting dicom data into 3D volume is tricky and may depend on modality, vendor\r\nand model of the imaging device. Basic support is offered that works well with\r\nCT, PET and MRI. For Siemens PET the PET data is read in SUV.\r\n\r\nA second image can be loaded and is displayed as fusion on top of the first.\r\nWorks well with PET/CT and PET/MRI data.\r\n\r\n\r\n\r\n##Usage\r\n\r\npip install simple-slice-viewer\r\n\r\n### Command Line\r\n    simple-slice-viewer\r\n    simple-slice-viewer ct.nii\r\n    simple-slice-viewer ct.nii --fusion pet.nii\r\n    \r\n\r\nor use ssv as shorthand:\r\n    ssv\r\n    ssv ct.nii\r\n    ssv ct.nii --fusion pet.nii\r\n    ssv --image ct.nii --fusion pet.nii\r\n\r\n### Inside Python\r\n\r\nIn Python images should be read to SimpleITK Image objects first.\r\n\r\n    import simple_slice_viewer as ssv\r\n    import SimpleITK as sikt\r\n\r\n    image = sitk.ReadImage('ct.nii')\r\n    fusion = sitk.ReadImage('pet.nii')\r\n\r\n    ssv.display(image=image, fusion=fusion)\r\n    \r\n\r\nTo display a numpy array convert it to SimpleITK first\r\n\r\n    import SimpleITK as sitk\r\n    import simple_slice_viewer as ssv\r\n    image = sitk.GetImageFromArray(np_array)\r\n    ssv.display(image)\r\n\r\n\r\n\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Simple slice viewer for Simple ITK images",
    "version": "0.97",
    "project_urls": null,
    "split_keywords": [
        "imageviewer dicom",
        "simpleitk"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1c7d0a377593a87f33e4cd54ecc7edd2e7db0e48e64191c164324a9e7f4904b1",
                "md5": "5bc272c6029021eed440a69a8e0fb67d",
                "sha256": "f7ecee22d14fa61845a71d7fc139e02aa1ddab0147a3b2df486be6127d14146c"
            },
            "downloads": -1,
            "filename": "simple-slice-viewer-0.97.tar.gz",
            "has_sig": false,
            "md5_digest": "5bc272c6029021eed440a69a8e0fb67d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 44535,
            "upload_time": "2023-05-08T08:54:50",
            "upload_time_iso_8601": "2023-05-08T08:54:50.847556Z",
            "url": "https://files.pythonhosted.org/packages/1c/7d/0a377593a87f33e4cd54ecc7edd2e7db0e48e64191c164324a9e7f4904b1/simple-slice-viewer-0.97.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-05-08 08:54:50",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "simple-slice-viewer"
}
        
Elapsed time: 0.12889s