Metadata-Version: 2.1
Name: dclab
Version: 0.27.2
Summary: Library for real-time deformability cytometry (RT-DC)
Home-page: https://github.com/ZELLMECHANIK-DRESDEN/dclab
Author: Paul Müller
Author-email: dev@craban.de
License: GPL v2
Keywords: RT-DC,deformation,cytometry,zellmechanik
Platform: ALL
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Intended Audience :: Science/Research
Requires-Dist: h5py (>=2.10.0)
Requires-Dist: numpy (>=1.16.0)
Requires-Dist: scipy (>=0.14.0)
Requires-Dist: backports.functools-lru-cache ; python_version < "3.3"
Requires-Dist: pathlib ; python_version <= "3.4"
Provides-Extra: all
Requires-Dist: fcswrite (>=0.5.0) ; extra == 'all'
Requires-Dist: nptdms (>=0.23.0) ; extra == 'all'
Requires-Dist: requests ; extra == 'all'
Requires-Dist: imageio (<2.5.0,>=2.3.0) ; (python_version < "3.4") and extra == 'all'
Requires-Dist: imageio[ffmpeg] (>=2.8.0) ; (python_version >= "3.4") and extra == 'all'
Provides-Extra: dcor
Requires-Dist: requests ; extra == 'dcor'
Provides-Extra: export
Requires-Dist: fcswrite (>=0.5.0) ; extra == 'export'
Requires-Dist: imageio (<2.5.0,>=2.3.0) ; (python_version < "3.4") and extra == 'export'
Requires-Dist: imageio[ffmpeg] (>=2.8.0) ; (python_version >= "3.4") and extra == 'export'
Provides-Extra: tdms
Requires-Dist: nptdms (>=0.23.0) ; extra == 'tdms'
Requires-Dist: imageio (<2.5.0,>=2.3.0) ; (python_version < "3.4") and extra == 'tdms'
Requires-Dist: imageio[ffmpeg] (>=2.8.0) ; (python_version >= "3.4") and extra == 'tdms'

dclab
=====

|PyPI Version| |Build Status Unix| |Build Status Win| |Coverage Status| |Docs Status|


This is a Python library for the post-measurement analysis of
real-time deformability cytometry (RT-DC) datasets; an essential part of
`Shape-Out <https://github.com/ZELLMECHANIK-DRESDEN/ShapeOut2>`__.

Documentation
-------------

The documentation, including the code reference and examples, is available at
`dclab.readthedocs.io <https://dclab.readthedocs.io/en/stable/>`__.


Installation
------------
To install the latest release, simply run

::

    pip install dclab  # for a minimal install
    pip install dclab[tdms]  # if you are also working with tdms files
    pip install dclab[export]  # if you need avi and fcs export
    pip install dclab[all]  # for all of the above


Information for developers
--------------------------


Contributing
~~~~~~~~~~~~
The main branch for developing dclab is master.
If you want to make small changes like one-liners,
documentation, or default values in the configuration,
you may work on the master branch. If you want to change
more, please (fork dclab and) create a separate branch,
e.g. ``my_new_feature_dev``, and create a pull-request
once you are done making your changes.
Please make sure to edit the 
`Changelog <https://github.com/ZELLMECHANIK-DRESDEN/dclab/blob/master/CHANGELOG>`__. 

**Very important:** Please always try to use 

::

	git pull --rebase

instead of

::

	git pull

to prevent confusions in the commit history.

Tests
~~~~~
dclab is tested using pytest. If you have the time, please write test
methods for your code and put them in the ``tests`` directory.


Incrementing version
~~~~~~~~~~~~~~~~~~~~
Dclab currently gets its version from the latest git tag.
If you think that a new version should be published,
create a tag on the master branch (if you have the necessary
permissions to do so):

::

	git tag -a "0.1.3"
	git push --tags origin

Appveyor and TravisCI will then automatically build source package and wheels 
and publish them on PyPI.


.. |PyPI Version| image:: https://img.shields.io/pypi/v/dclab.svg
   :target: https://pypi.python.org/pypi/dclab
.. |Build Status Unix| image:: https://img.shields.io/travis/ZELLMECHANIK-DRESDEN/dclab.svg?label=build_linux_osx
   :target: https://travis-ci.org/ZELLMECHANIK-DRESDEN/dclab
.. |Build Status Win| image:: https://img.shields.io/appveyor/ci/paulmueller/dclab/master.svg?label=build_win
   :target: https://ci.appveyor.com/project/paulmueller/dclab
.. |Coverage Status| image:: https://img.shields.io/codecov/c/github/ZELLMECHANIK-DRESDEN/dclab/master.svg
   :target: https://codecov.io/gh/ZELLMECHANIK-DRESDEN/dclab
.. |Docs Status| image:: https://readthedocs.org/projects/dclab/badge/?version=latest
   :target: https://readthedocs.org/projects/dclab/builds/


