Module SlideIO =================================== .. image:: images/slideio.png If you have any question about the library or want to report a bug, visit our new `forum `_ . What is new ------------------- - Support of DICOM files - New functionality for retriving of auxiliary images of scene and slide objects such as thumbnails and labels. - Bug fixing and small improvements Overview ------------------ Slideio is a python module for the reading of medical images. It allows reading whole slides as well as any region of a slide. Large slides can be effectively scaled to a smaller size. The module uses internal zoom pyramids of images to make the scaling process as fast as possible. Slideio supports 2D slides as well as 3D data sets and time series. The module delivers a raster as a numpy array and compatible with the popular computer vision library `OpenCV `_. The module builds accesses images through a system of image drivers that implement specifics of different image formats. Currently following drivers are implemented: - CZI - driver for the reading of `Zeiss CZI `_ images. - SVS - driver for the reading of `Aperio SVS `_ images. - AFI - driver for the reading of Aperio fluorescent images. - SCN - driver for the reading of `Leica SCN images `_. - GDAL - driver for the reading of generic formats like jpeg, png, tiff, etc. It uses a popular c++ image library `GDAL `_. - ZVI - driver for reading of images produced by Carl Zeiss `AxioVision microscope `_. - DCM - driver for reading of DICOM images, including whole slide images (WSI). - NDPI - driver for reading of Hamamatsu NDPI images. - VSI - driver for reading of `Olympus VSI images `_. The module provides 2 python classes: *Slide* and *Scene*. *Slide* is a container object returned by the module function *open_slide*. In the simplest case, a *Slide* object contains a single *Scene* object. Some slides can contain multiple scenes. For example, a czi file can contain several scanned regions, each of them is represented as a *Scene* object. *Scene* class provides methods to access image pixel values and metadata. Contents ---------- .. toctree:: :maxdepth: 2 :caption: Table of contents: functions slide scene drivers tutorial license software Installation ------------------ Installation of the modile available through pip. .. code-block:: pip install slideio Quick Start ----------------- Here is an example of a reading of a czi file: .. code-block:: python import slideio slide = slideio.open_slidei(file_path="/data/a.czi",driver_id="CZI") scene = slide.get_scene(0) block = scene.read_block() Source code ------------ Souce code is located in the `gitlab repository `_ and mirror `github repository `_. Indices and tables ------------------ * :ref:`genindex` * :ref:`modindex` * :ref:`search`