Metadata-Version: 2.1
Name: delira
Version: 0.4.1
Summary: UNKNOWN
Home-page: https://github.com/delira-dev/delira/
Maintainer: Justus Schock
Maintainer-email: justus.schock@rwth-aachen.de
License: BSD-2
Description: [<img src="https://img.shields.io/badge/chat-slack%20channel-75BBC4.svg">](https://join.slack.com/t/deliradev/shared_invite/enQtNjI1MjA4MjQzMzQ2LTUzNTQ0MjQyNjJjNzgyODczY2Y1YjYxNjA3ZmQ0MGFhODhkYzQ4M2RjMGM1YWM3YWU5MDM0ZjdiNTQ4MmQ0ZDk)
        [![PyPI version](https://badge.fury.io/py/delira.svg)](https://badge.fury.io/py/delira) [![Build Status](https://travis-ci.com/delira-dev/delira.svg?branch=master)](https://travis-ci.com/delira-dev/delira) [![Documentation Status](https://readthedocs.org/projects/delira/badge/?version=master)](https://delira.readthedocs.io/en/master/?badge=master) [![codecov](https://codecov.io/gh/justusschock/delira/branch/master/graph/badge.svg)](https://codecov.io/gh/delira-dev/delira)
        ![LICENSE](https://img.shields.io/github/license/delira-dev/delira.svg) [![DOI](http://joss.theoj.org/papers/10.21105/joss.01488/status.svg)](https://doi.org/10.21105/joss.01488)
        
        ![logo](docs/_static/logo/delira.svg "delira - Deep Learning in Radiology")
        
        # Delira - Deep Learning in Radiology
        Authors: [Justus Schock, Oliver Rippel, Christoph Haarburger](AUTHORS.rst)
        
        ## Introduction
        Delira was originally developed as a deep learning framework for medical images such as CT or MRI. Currently, it works on arbitrary data (based on [NumPy](http://www.numpy.org/)). 
        
        Based on [batchgenerators](https://github.com/MIC-DKFZ/batchgenerators) and [trixi](https://github.com/MIC-DKFZ/trixi) it provides a framework for
        * Dataset loading
        * Dataset sampling
        * Augmentation (multi-threaded) including 3D images with any number of channels
        * A generic trainer class that implements the training process for all [backends](#choose-backend)
        * Already implemented [models](delira/models) used in medical image processing and exemplaric implementations of most used models in general (like Resnet)
        * Web-based monitoring using [Visdom](https://github.com/facebookresearch/visdom)
        * Tensorboard monitoring
        * Model save and load functions
        
        Delira supports classification and regression problems as well as generative adversarial networks and segmentation tasks.
        
        ## Installation
        
        ### Choose Backend
        
        Currently the only available backends are [PyTorch](https://pytorch.org) and [TensorFlow](https://tensorflow.org)(or no backend at all). If you want to add another backend, please open an issue (it should not be hard at all) and we will guide you during the process of doing so.
        
        | Backend                        | Binary Installation         | Source Installation                                                                         | Notes                                                                                                                                                 |
        |---------------------------------------------|-----------------------------|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
        | None                                        | `pip install delira`        | `pip install git+https://github.com/justusschock/delira.git`                                | Training not possible if backend is not installed separately                                                                                          |
        | [`torch`](https://pytorch.org)              | `pip install delira[torch]` | `git clone https://github.com/justusschock/delira.git && cd delira && pip install .[torch]` | `delira` with `torch` backend supports mixed-precision training via [NVIDIA/apex](https://github.com/NVIDIA/apex.git) (must be installed separately). | 
        | [`tensorflow`](https://www.tensorflow.org/) | `pip install delira[tensorflow]` | `git clone https://github.com/justusschock/delira.git && cd delira && pip install .[tensorflow]` | the `tensorflow` backend is still very experimental and lacks some [features](https://github.com/delira-dev/delira/issues/47) |
        | Full                                        | `pip install delira[full]`  | `git clone https://github.com/justusschock/delira.git && cd delira && pip install .[full]`  | All backends will be installed.                                                                                                                   |
        
        ### Docker
        The easiest way to use `delira` is via docker (with the [nvidia-runtime](https://github.com/NVIDIA/nvidia-docker) for GPU-support) and using the [Dockerfile](docker/Dockerfile) or the [prebuild-images](https://cloud.docker.com/u/justusschock/repository/docker/justusschock/delira).
        
        ### Chat
        We have a [community chat on slack](https://deliradev.slack.com). If you need an invitation, just follow [this link](https://join.slack.com/t/deliradev/shared_invite/enQtNjI1MjA4MjQzMzQ2LTUzNTQ0MjQyNjJjNzgyODczY2Y1YjYxNjA3ZmQ0MGFhODhkYzQ4M2RjMGM1YWM3YWU5MDM0ZjdiNTQ4MmQ0ZDk).
        
        ## Getting Started
        The best way to learn how to use is to have a look at the [tutorial notebook](notebooks/tutorial_delira.ipynb).
        Example implementations for classification problems, segmentation approaches and GANs are also provided in the [notebooks](notebooks) folder.
        
        ## Documentation
        The docs are hosted on [ReadTheDocs/Delira](https://delira.rtfd.io).
        The documentation of the latest master branch can always be found at the project's [github page](https://delira-dev.github.io/delira/).
        
        ## Contributing
        If you find a bug or have an idea for an improvement, please have a look at our [contribution guideline](CONTRIBUTING.md).
        
Platform: UNKNOWN
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: torch
Provides-Extra: tensorflow
Provides-Extra: full
