Metadata-Version: 2.1
Name: simple-slice-viewer
Version: 0.14
Summary: Simple slice viewer for Simple ITK images
Author: M. Segbers
Author-email: m.segbers@gmail.com
License: MIT
Keywords: ImageViewer DICOM,SimpleITK
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Requires-Python: >=3.6, <3.10
Description-Content-Type: text/markdown

# README #

## Overview

A viewer to scroll through slices of 3D medical data set (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 ct.nii
    simple-slice-viewer ct.nii --fusion pet.nii
    simple-slice-viewer --image ct.nii --fusion pet.nii

or use ssv as shorthand:

    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


image = sitk.GetImageFromArray(np_array)
    ssv.display(image)





