stemgraphic 0.7.5

Graphic and text stem-and-leaf plots

# stemgraphic


# Overview

John Tukey’s stem-and-leaf plot first appeared in 1970. Although very useful back then, it cannot handle
more than 300 data points and is completely text-based. Stemgraphic is a very easy to use python package
providing a solution to these limitations (no size limit, graphical tool). It also supports **categorical**
and **text** as input.

A typical stem_graphic output:

[stem_graphic example](https://github.com/fdion/stemgraphic/raw/master/png/test_rosetta.png)

For an in depth look at the algorithms and the design of stemgraphic, see

[Stemgraphic: A Stem-and-Leaf Plot for the Age of Big Data](https://github.com/fdion/stemgraphic/raw/master/doc/stemgraphic%20A%20Stem-and-Leaf%20Plot%20for%20the%20Age%20of%20Big%20Data.pdf)

Documentation is available as pdf [stemgraphic.pdf](http://stemgraphic.org/doc/stemgraphic.pdf)
and [online](http://stemgraphic.org/doc/) html.

The official website of stemgraphic is: http://stemgraphic.org

See also:
[Are you smarter than a fifth grader?](https://www.linkedin.com/pulse/you-smarter-than-fifth-grader-francois-dion/)


# Installation

Stemgraphic requires docopt, matplotlib and pandas. Optionally, having Scipy installed will give you secondary plots
and Dask (see requirements_dev.txt for all needed to run all the functional tests) will allow for out of core, big data
visualization.

Installation is simple:

pip3 install -U stemgraphic

or from this cloned repository, in the package root:

python3 setup.py install


# Latest changes

## Version 0.7.5

- Bugfix for issue 12, -0 stem not showing in certain cases

## Version 0.7.4

- Bugfix for stem_text with plain list (df and numpy are ok)

## Version 0.7.2

- Bugfix for secondary plot calculation

## Version 0.7.0

- Made Levenshtein module optional
- Small Multiples support

## Version 0.6.2

- Bugfix for VERSION

## Version 0.6.1

- back-to-back stem-and-leaf plots can use predefined axes (secondary ax added)
- added quantize function (basically a round trip number->stem-and-leaf->number))
- density_plot added for numerical values with stem-and-leaf quantization and sampling
- density_plot also support multiple secondary plots like box, violin, rug, strip
- notebook demoing density_plot
- notebook demoing comparison of violin, box and stem-and-leaf for certain distributions

## Version 0.6.0

Version bump to 0.6 due to order of params changing. Shouldn't affect using named args

Major code change and expansion for num.stem_graphic including:
- back-to-back stem-and-leaf plots
- allows comparison of very skewed data
- bug fix (rounding issue) due to python precision
- better stem handling
- alpha down to 10% for bars
- median alpha can be specified
- stems can be hidden
- added title option, besides the legend

Other changes:
- More notebook examples
- added leaf_skip, stem_skip to a few functions missing them
- heatmap_grid bugfix
- added reverse to a few functions missing it
- improved documentation
- matrix_difference ord param added added
- ngram_data now properly defaults to case insensitive
- switched magenta to 'C4' - compatible with mpl styles now
- functions to read/write .npy and .pkl files
- more unicode typographical glyphs added to the list of non alpha


## Version 0.5.3

- scatter 3d support
- added 3rd source to compare (in 3d) with scatter plots
- more scatter plot fixes
- some warnings added to deal with 3d and log scale issues
- added fig_xy to scatter - useful to quickly adjust figsize in a notebook
- added normalize, percentage and whole (integer) to scatter
- added alpha to scatter

## Version 0.5.2

- added documentation for scatter plots
- added jitter to scatter plots
- added log scale to scatter plots
- more notebooks

## Version 0.5.1

- stem_text legend fix
- missed adding the code for scatter plots
- more notebooks

## Version 0.5.0

Major new release.

- All 0.4.0 private changes were merged
- new module stemgraphic.alpha:
- n-gram support
- stem_graphic supporting categorical
- stem_graphic supporting text
- stem_text supporting categorical
- stem_text supporting text
- stem command line supporting categorical when column specified
- heatmap for n-grams
- heatmap grid to compare multiple text sources
- Frobenius norm on diff matrices
- radar plot with Levenshtein distance
- frequency plot (bar, barh, hist, area, pie)
- sunburst char
- interactive charts with cufflinks
- new module stemgraphic.num to match .alpha
- stop word dictionaries for English, Spanish and French
- Massively improved documentation of modules and functions
- Improved HTML documentation
- Improved PDF documentation

## Version 0.4.0

Internal release for customer.

- Added Heatmap

- Basic PDF documentation

- Quickstart notebook

## Version 0.3.7

Matploblib 2.0 compatibility

## Version 0.3.6

- Persist sample from command line tool (-k filename.pkl or -k filename.csv).

- Windows compatible bat file wrapper (stem.bat).

- Added full command line access to dask distributed server (-d, -s, use file in '' when using glob / wildcard).

- For operations with dask, performance has been increased by 25% in this latest release, by doing a compute
once of min, max and count all at once. Count replaces len(x).


Added the companion PDF as it will be presented at PyData Carolinas 2016.


# TODO

- multivariate support
- provide support for secondary plots with dask
- automatic dense layout
- add a way to provide an alternate function to the sampling
- support for spark rdds and/or sparkling pandas
- create a bokeh version. Ideally rbokeh too.
- add unit tests
- add feather, hdf5 etc support, particularly on sample persistence
- more charts
- more examples