Metadata-Version: 2.0
Name: dataArtist
Version: 0.1.14
Summary: 
Requires-Dist: appbase
Requires-Dist: cssselect
Requires-Dist: enum34
Requires-Dist: exifread
Requires-Dist: fancytools
Requires-Dist: fancywidgets
Requires-Dist: hachoir-core
Requires-Dist: hachoir-metadata
Requires-Dist: hachoir-parser
Requires-Dist: imgProcessor
Requires-Dist: lxml
Requires-Dist: numpy
Requires-Dist: puka
Requires-Dist: pygments
Requires-Dist: pyqtgraph-karl
Requires-Dist: scikit-image
Requires-Dist: scipy
Requires-Dist: tifffile
Requires-Dist: transforms3d

Interactive scientific data and image processing

Home-page: https://github.com/radjkarl/dataArtist
Author: Karl Bedrich
Author-email: karl@bedrich.de
License: GPLv3
Description: **dataArtist** - *…scientific data processing made easy.*
        
        .. image:: https://img.shields.io/badge/License-GPLv3-red.svg
        .. image:: https://img.shields.io/badge/python-2.6%7C2.7-yellow.svg
        
        `Download for Windows 7-10`_
        
        |screenshot|
        
        About
        -----
        
        | *dataArtist* is a graphical program for interactive data analysis and
          processing. It is currently specialized image processing tasks in
          combination with electroluminescence imaging of photovoltaic devices.
        | It is written in Python (2.7) and is released under open source.
        | *dataArtist* is written to be platform independent. It is known to run
          under Windows 7-10 and Ubuntu Linux 14.10 (soon).
        
        **Please cite *dataArtist* as follows:**
        
            K.G. Bedrich et al., “Electroluminescence Imaging of PV Devices:
            Camera Calibration and Image Correction”, Proc. 43rd IEEE Photovoltaic Specialists Conference, Portland, 2016.
        
        
        Manuals
        -------
        
        `USER manual`_
        
        `DEVELOPERS manual`_
        
        Online Tutorials
        ----------------
        
        | General usage, camera calibration and image correction are explained
          in youtube screencast sessions, see
        | |youtube|
        
        Supported file types
        --------------------
        
        Data is imported through drag n’drop.
        
        #. Images
        
        -  Common used (TIF, BMP, PNG, JPG, CSV, TXT, MAT)
        -  RAW, if data type and image shape are known
        -  Numpy arrays
        
        #. Plots
        
        -  CSV, TXT, numpy arrays
        
        Installation
        ------------
        
        a) Portable version
        ~~~~~~~~~~~~~~~~~~~
        
        -  *dataArtist* runs out of the box. No installation needed (currently
           Windows only). See section `Releases`_.
        
        
        b) Installation into existing Python installation using pip
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        - After installing Python2.7 and ensuring that 'pip' is a recognised command in the command shell (Windows: CMD.exe).
          you need to install the following packages BEFORE installing dataArtist:
          
            - PyQt4 
            - OpenCV2.4
            - OPTIONAL: RabbitMQ (for inter-program communication)
          
           Please refer to the `USER manual`_ for more information.
        -  Once these packages are installed, open a command shell and type:
        
        ``pip install dataArtist``
        
        - Now start dataArtist from the command shell:
        
        ``dataArtist``
        
        - To launch dataArtist into the system tray type:
        
        ``dataArtist -s``
        
        - To open a dataArtist session directly type:
        
        ``dataArtist -o /path/to/my/session.da``
        
        
        Scripting, Automation, Modding
        ------------------------------
        
        | *dataArtist* comes with a built-in python shell. Data can be examplary
          accessed though ``d1.l3`` (display 1, data layer 3) and tools
          e.g. through ``d.tools['Axes'].click()`` (in current display execute
          tool ‘Axes’).
        | *dataArtist* allows adding own tools, displays and importers, for
          examples, see dataArtist/modding.
        
        Main dependencies
        -----------------
        
        +----------------------+----------------------------------------------------------+
        | Package              | Description                                              |
        +======================+==========================================================+
        | `pyqtgraph\_karl`_   | Scientific Graphics and GUI Library based on Qt (Fork)   |
        +----------------------+----------------------------------------------------------+
        | `imgProcessor`_      | General propose image processing libary                  |
        +----------------------+----------------------------------------------------------+
        | `appBase`_           | Base packages for apps, based on Qt                      |
        +----------------------+----------------------------------------------------------+
        | `fancyWidgets`_      | A collection of fancy widgets, based on Qt               |
        +----------------------+----------------------------------------------------------+
        | `fancyTools`_        | A collection of useful not-GUI tools                     |
        +----------------------+----------------------------------------------------------+
        
        Example: Electroluminescence imaging
        ------------------------------------
        
        Camera calibration
        ~~~~~~~~~~~~~~~~~~
        
        For camera calibration all needed images are dropped into *dataArtist*
        and the matching tool is executed. The calibration results are
        hereinafter saved to a calibration file. The determination of the
        point spread function is exemplary shown in the following figure:
        
        |screenshotpsf|
        
            dataArtist screenshot - toolbar ‘calibration’. **a**: Best focus
            determination; **b**: noise-level-function measurement; **c**: Dark
            current mapping; **d**: Flat field mapping; **e**: PSF estimation
            (selected): **f**: lens distortion measurement
        
        Image correction
        ~~~~~~~~~~~~~~~~
        
        The correction of EL image is shown in the following figure.
        Perspective correction (red box) can be done either using the outline
        of the PV device (automatically detected or manually defined) or using
        a reference image.
        
        |screenshotcorrection|
        
            | dataArtist screenshot - **a**: tool ‘CalibrationFile’; **b**: tool
              ‘CorrectCamera’; **c**: tool ‘PerspectiveCorrection’
            | **green line**: Camera correction; **red line**: Perspective
              correction
        
        
        
        
        
        .. |screenshot| image:: https://cloud.githubusercontent.com/assets/350050/15406631/806a7a8a-1dc4-11e6-9e76-709cd482857f.png
        .. |screenshotpsf| image:: https://cloud.githubusercontent.com/assets/350050/15404653/bd2e51b6-1dbb-11e6-8282-2ea539f0286d.png
        .. |screenshotcorrection| image:: https://cloud.githubusercontent.com/assets/350050/15404785/53d4c992-1dbc-11e6-93b7-c6108ab9a2b0.png
        .. _Download for Windows 7-10: https://github.com/radjkarl/dataArtist/releases/tag/v0.1-alpha
        .. _USER manual: https://github.com/radjkarl/dataArtist/raw/master/dataArtist/media/USER_MANUAL.pdf
        .. _DEVELOPERS manual: http://radjkarl.github.io/dataArtist/
        .. _Releases: https://github.com/radjkarl/dataArtist/releases
        .. _pyqtgraph\_karl: https://github.com/radjkarl/pyqtgraph_karl
        .. _imgProcessor: https://github.com/radjkarl/imgProcessor
        .. _appBase: https://github.com/radjkarl/appBase
        .. _fancyWidgets: https://github.com/radjkarl/fancyWidgets
        .. _fancyTools: https://github.com/radjkarl/fancyTools
        
        .. |youtube| image:: https://i.ytimg.com/vi/vAcpuLvEwTA/hqdefault.jpg
           :target: https://www.youtube.com/channel/UCjjngrC3jPdx1HL8zJ8yqLQ
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
