Metadata-Version: 1.0
Name: datavision
Version: 2016.2.11.1235
Summary: Python data visualisation
Home-page: https://github.com/wdbm/datavision
Author: Will Breaden Madden
Author-email: w.bm@cern.ch
License: GPLv3
Description: datavision
        ==========
        
        Python data visualisation
        
        quick start
        ===========
        
        .. code:: bash
        
            sudo apt-get -y install python
            sudo apt-get -y install python-matplotlib
            sudo pip install shijian
            sudo pip install pyprel
            sudo pip install datavision
        
            git clone https://github.com/wdbm/datavision.git
            cd datavision/
            python examples_1.py
            python examples_2.py
            python example_data_1.py
        
        setup
        -----
        
        Ubuntu
        ~~~~~~
        
        .. code:: bash
        
            sudo apt-get -y install python
            sudo apt-get -y install python3
            sudo apt-get -y install python-matplotlib
            sudo apt-get -y install python3-matplotlib
            sudo pip install shijian
            sudo pip install pyprel
            sudo pip install datavision
        
        OS X
        ~~~~
        
        .. code:: bash
        
            ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
            brew install python3
            pip3 install matplotlib
            pip install shijian
            pip install pyprel
            pip install datavision
        
        run
        ---
        
        .. code:: bash
        
            git clone https://github.com/wdbm/datavision.git
            cd datavision/
            python examples_1.py
            python examples_2.py
        
        introduction
        ============
        
        qunti and zus lists
        -------------------
        
        Qunti (群体, groups) are lists that act
        
        -  as dictionaries that can contain duplicate keys and
        -  as sets for the purposes of enabling set-like operations for qunti
           objects, such as symmetric difference, intersection and update
           operations.
        
        Qunti are composed of multiple zu (组, group) objects.
        
        qunti operations
        ~~~~~~~~~~~~~~~~
        
        In an update operation, one qunti is used to update another. Any zus in
        the updating qunti that are not in the updated qunti are appended to the
        updated qunti. Any zus that are in the updating qunti and the updated
        qunti replace the corresponding zus in the updated qunti.
        
        The following example illustrates a qunti update operation in which an
        ``alpha`` zus is replaced and a ``delta`` zus is appended:
        
        .. code:: python
        
            # example qunti update:
            a = [['alpha', '10'], ['beta', '20'], ['gamma', '30'], ['gamma', '15']]
            b = [['delta', '40'], ['alpha', '50']]
            # update of a with b:
            a = [['beta', '20'], ['gamma', '30'], ['gamma', '15'], ['delta', '40'], ['alpha', '50']]
        
        The following example illustrates qunti symmetric difference,
        intersection and update operations. In the update operation, two old
        ``gamma`` zus are replaced by a single new ``gamma`` zu:
        
        .. code:: python
        
            # example qunti symmetric difference, intersection and update:
            a = [['alpha', '10'], ['beta', '20'], ['gamma', '30'], ['gamma', '15']]
            b = [['delta', '40'], ['alpha', '50'], ['gamma', '25']]
            # symmetric difference of a and b:
            [['beta', '20'], ['delta', '40']]
            # intersection of a and b:
            [['alpha', '10'], ['gamma', '30'], ['gamma', '15'], ['alpha', '50'], ['gamma', '25']]
            # update of a with b:
            a = [['beta', '20'], ['delta', '40'], ['alpha', '50'], ['gamma', '25']]
        
        data visualisation
        ------------------
        
        Datavision provides utilities for data visualisation. It can visualise
        matrices as colormaps:
        
        |image0| |image1| |image2|
        
        It can visualise histograms:
        
        .. figure:: images/histogram_comparison_1.png
           :alt: 
        
        It can visualise graphs and histograms in a terminal:
        
        ::
        
               │                                                                            
               ┼+79.548                                                                 ○   
               │                                                                            
               │                                                                ○           
               │                                                                            
               │                                                        ○                   
               │                                                                            
               │                                                ○                           
               ◽       ◽       ◽                       ○                                    
               │                       ◽       ○                                            
               │                       ○       ◽                                            
            ───○┼──────○───────○───────────────────────◽────────────────────────────────┼───
               │ +0.046                                         ◽               +8.97638    
               │                                                                            
               │                                                        ◽                   
               │                                                                            
               │                                                                ◽           
               ┼-48.228                                                                     
               │                                                                        ◽   
               │                                                                            
        
        ::
        
                                     │                        
                                     ┼+75503.2                
                                   ∘∘|∘                       
                                  ∘||||∘                      
                                  ||||||∘                     
                                 ∘|||||||                     
                                 ||||||||∘                    
                                ∘|||||||||                    
                                ||||||||||∘                   
                               ∘|||||||||||                   
                               |||||||||||∘                   
                              ∘||||||||||||                   
                              |||||||||||||∘                  
                              ||||||||||||||∘                 
                             ∘|||||||||||||||∘                
                            ∘|||||||||||||||||∘               
                           ∘|||||||||||||||||||∘              
                        ∘∘∘||||||||||┼+1603.2|||∘∘∘           
            ──┼--------------------------------------------┼──
               -4.69099              │              +4.6147   
        
        It can plot all combinations of variables:
        
        .. figure:: images/variable_correlations_1.png
           :alt: 
        
        It can plot all parallel coordinates:
        
        .. figure:: images/parallel_coordinates_1.png
           :alt: 
        
        prerequisites
        =============
        
        Python 2 or Python 3
        --------------------
        
        .. code:: bash
        
            sudo apt-get -y install python
            sudo apt-get -y install python3
        
        matplotlib
        ----------
        
        .. code:: bash
        
            sudo apt-get -y install python-matplotlib
            sudo apt-get -y install python3-matplotlib
        
        shijian
        -------
        
        -  https://github.com/wdbm/shijian
        
        .. |image0| image:: images/image_1.png
        .. |image1| image:: images/image_2.png
        .. |image2| image:: images/image_3.png
        
Platform: UNKNOWN
