Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tbrlpld/plotgraph

Sublime Text package to plot number columns as graphs
https://github.com/tbrlpld/plotgraph

curve graph matplotlib plot plotgraph python sublime-package sublime-text sublime-text-3

Last synced: about 1 month ago
JSON representation

Sublime Text package to plot number columns as graphs

Awesome Lists containing this project

README 

        
PlotGraph - A Sublime Text 3 Package

====================================



Plot a column of numbers as a graph, or create a quick curve comparison 

based on multiple number columns.



Installation

------------



### Requirements



 -  You need a [python](https://www.python.org/downloads/) 

    installation on your computer.

    The sublime-internal python is not sufficient.

 -  That python environment needs to have the following modules installed:

    -   [matplotlib](http://matplotlib.org/),

    -   [argparse](https://docs.python.org/3/library/argparse.html)

    -   [ast](https://docs.python.org/3/library/ast.html)  



    The latter two are part of the python standard library and are probably 

    available with a standard python installation.



 -  To test if your python installation has a module installed, 

     you can do the following:

    -   Open a terminal.

    -   Start python, e.g. by entering `python` and hit [Enter].

    -   In the started python console, enter e.g.: `import matplotlib`.

    -   If this command finished without an error message you are all set.



### Install Using Package Control (recommended)



 -  Install Package Control in Sublime Text. ([How-To](https://packagecontrol.io/installation))

 -  Once Package Control is installed successfully, hit `[ctrl+shift+p]`.

 -  In the command line type something like `pa con in pa` and select `Package Control: Install Package` from the drop down list.

 -  In the search bar type `PlotGraph` and hit `[Enter]`.

 -  Done.



### Manual Installation



 1. Download the 

     [zip archive](https://github.com/tibsel/PlotGraph/archive/master.zip).

 1. Extract the folder `PlotGraph-master` from the downloaded zip archive.

 1. Rename the folder to `PlotGraph`.

 1. Copy the renamed folder into Sublime Text's `Packages` directory.

 

    - If you are not sure where to find that directory, 

      go to Sublime Text 3 `Menu > Preferences > Browse Packages...`.

      This should open a directory in you browser. 



 1. Restart Sublime Text 3.



Setup

-----



Once PlotGraph is installed, you need to set the path to your local python 

installation (in which matplotlib and the other modules are working).



### Define Python Executable Path



 1. Open Sublime Text 3.

 1. In the menu navigate to 

     `Preferences > Package Settings > PlotGraph > Settings - User`.

     If you are accessing the PlotGraph user settings for the first time, 

     that file will be empty.

 1.    To get a template for the possible settings, open 

     `Preferences > Package Settings > PlotGraph > Settings - Default`.

 1. Copy the content of the default PlotGraph settings 

     to the empty user settings file.

 1. Replace the default value for `python_exec` with the path to your python 

     executable.

     The content of your PlotGraph user setting file should look 

    somewhat like this:  



    ```json

    {     

        "python_exec" : ""

    }

    ```



 1. Save and close the PlotGraph user settings file.



### Set Key Bindings



If your are not happy with using `[ctrl+alt+g]` as the short cut to 

generate the plot, you can change the key binding:



 1. Open Sublime Text 3.

 1. In the menu navigate to 

    `Preferences > Package Settings > PlotGraph > Key Bindings - Default`.

 1. Copy the line `{"keys": ["ctrl+alt+g"], "command": "plot_graph"}` to your 

    user key binding settings.

    You can open the user key bindings file via 

    `Preferences > Package Settings > PlotGraph > Key Bindings - User`.

 1. In the user key bindings file, replace the `ctrl+alt+g` in `["ctrl+alt+g"]` 

    with whatever short cut you prefer.

 1. Save and close the user key bindings file.



Usage

-----



Select the numbers you want to see plotted (with one selection). 

If other content is also selected, that's ok, 

because the selection will be filtered for numbers.

Once the selection is made, hit `[ctrl+alt+g]` to create a matplotlib window.

If you select one column of numbers, they will be printed over their index.



    0.0

    4.0

    3.0

    5.0

    5.0

    5.0

    4.0

    0.0 



![Selection](./doc/scrn_selection.png)  



![Plot one column](./doc/scrn_1col.png)



  

If you select two columns, the first one will be used as the values on the 

abscissa/x-axis and the second column as the values on the ordinate/y-axis.



     1.0  0.0 

     2.0  4.0 

     3.0  3.0 

     4.0  5.0 

     5.0  5.0 

     6.0  5.0 

     7.0  4.0 

    18.0  0.0 



![Plot two columns](./doc/scrn_2col.png)

    

  

If more than two columns are selected, the first one will be used as the values 

on the abscissa/x-axis. The other columns will be printed as values on the 

ordinate/y-axis for different curves.



     1.0  0.0   11.1

     2.0  4.0  -11.2

     3.0  3.0   11.3

     4.0  5.0  -11.4

     5.0  5.0   11.5

     6.0  5.0  -11.6

     7.0  4.0   11.7

    18.0  0.0  -11.8



![Plot three columns](./doc/scrn_3col.png)



Issues

------



Please report issues at [Github](https://github.com/tibsel/PlotGraph/issues).