Metadata-Version: 1.0
Name: datavision
Version: 2016.4.14.1500
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
        
        ```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
        
        ```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
        
        ```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
        
        ```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:
        
        ```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:
        
        ```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:
        
        ![](images/image_1.png)
        ![](images/image_2.png)
        ![](images/image_3.png)
        
        It can visualise histograms:
        
        ![](images/histogram_comparison_1.png)
        
        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:
        
        ![](images/variable_correlations_1.png)
        
        It can plot all parallel coordinates:
        
        ![](images/parallel_coordinates_1.png)
        
        It can perform FFT:
        
        ![](images/FFT.png)
        
        # prerequisites
        
        ## Python 2 or Python 3
        
        ```Bash
        sudo apt-get -y install python
        sudo apt-get -y install python3
        ```
        
        ## matplotlib
        
        ```Bash
        sudo apt-get -y install python-matplotlib
        sudo apt-get -y install python3-matplotlib
        ```
        
        ## shijian
        
        - <https://github.com/wdbm/shijian>
        
Platform: UNKNOWN
