added better error for Winston output_surface

winston log10 scale
qwt log10 scale
2015-10-04 09:41:42 -05:00 · 2015-10-03 17:18:58 -05:00 · 2015-10-03 17:03:13 -05:00 · 2015-10-03 09:46:02 -05:00 · 2015-10-01 12:55:05 -05:00 · 2015-09-30 10:36:00 -04:00
183 changed files with 6716 additions and 976 deletions
@@ -1,3 +1,5 @@
 *.jl.cov
 *.jl.*.cov
 *.jl.mem
+.DS_Store
+examples/.ipynb_checkpoints/*
@@ -2,223 +2,333 @@

 [![Build Status](https://travis-ci.org/tbreloff/Plots.jl.svg?branch=master)](https://travis-ci.org/tbreloff/Plots.jl)

-Plotting interface and wrapper for several plotting packages.
+#### Author: Thomas Breloff (@tbreloff)
+
+Plots is a plotting interface and wrapper for several plotting packages.  My goals with the package are:
+
+- Simple.  The interface should be intuitive enough that someone coming from Matlab, Python, etc can immediately start generating complex plots without reading volumes of documentation.
+- Automatic (if you want).  There should be smart defaults for the most common functionality, and simple, high-level ways to override complex functionality.
+- Flexible.  You should be able to produce your favorite plot in your favorite package, but quicker and simpler.
+- Consistent.  Don't commit to one graphics package.  One command will switch your backend, and the exact same plotting commands will work with a very different underlying backend.

 Please add wishlist items, bugs, or any other comments/questions to the issues list.

-## Examples
+Check out the [summary graphs](img/supported/supported.md) for the features that each backend supports.
+
+## Examples for each implemented backend:

 - [Qwt.jl](docs/qwt_examples.md)
 - [Gadfly.jl](docs/gadfly_examples.md)
+- [UnicodePlots.jl](docs/unicodeplots_examples.md)
+- [PyPlot.jl](docs/pyplot_examples.md)
+- [Immerse.jl](docs/immerse_examples.md)
+- [Winston.jl](docs/winston_examples.md)

 ## Installation

-First, clone the package, and get any plotting packages you need:
+First, add the package

+```julia
+Pkg.add("Plots")
 ```
-Pkg.clone("https://github.com/tbreloff/Plots.jl.git")
-Pkg.add("Gadfly")                                     # [optional]
-Pkg.clone("https://github.com/tbreloff/Qwt.jl.git")   # [optional] requires pyqt and pyqwt
+
+then get any plotting packages you need (obviously, you should get at least one backend):
+
+```julia
+Pkg.add("Gadfly")
+Pkg.add("Immerse")
+Pkg.add("UnicodePlots")
+Pkg.add("PyPlot")                                    # requires python and matplotlib
+Pkg.clone("https://github.com/tbreloff/Qwt.jl.git")  # requires pyqt and pyqwt
+Pkg.add("Winston")
 ```

 ## Use

-Load it in.  The underlying plotting backends are not imported until `plotter()` is called (which happens
-on your first call to `plot`).  This means that you don't need any backends to be installed when you call `using Plots`.
-For now, the default backend is Gadfly.
+Load it in.  The underlying plotting backends are not imported until `backend()` is called (which happens
+on your first call to `plot` or `subplot`).  This means that you don't need any backends to be installed when you call `using Plots`.
+Plots will try to figure out a good default backend for you automatically based on what backends are installed.

-```
+```julia
 using Plots
 ```

-Do a plot in Gadfly, then save a png:
+Do a plot in Gadfly (inspired by [this example](http://gadflyjl.org/geom_point.html)), then save a png:

-```
-plot(rand(10,2); marker = :rect)
-savepng(Plots.IMG_DIR * "gadfly1.png")
-```
+```julia
+gadfly()        # switch to Gadfly as a backend
+dataframes()    # turn on support for DataFrames inputs

-which saves:
+# load some data
+using RDatasets
+iris = dataset("datasets", "iris");
+
+# This will bring up a browser window with the plot. Add a semicolon at the end to skip display. 
+scatter(iris, :SepalLength, :SepalWidth, group=:Species, ms=12, m=[:+,:d,:s])
+
+# save a png (equivalent to png("gadfly1.png") and savefig("gadfly1.png"))
+png("gadfly1")
+```

 ![gadfly_plt](img/gadfly1.png)

+See the examples pages for lots of examples of plots, and what those commands produce for each supported backend.  
+Also check out the [IJulia notebooks](examples) and see how it works interactively.

-Do a plot in Qwt, then save a png:
+## API

-```
-plotter!(:qwt)  # switches the backend to Qwt
-plot(rand(10,2); marker = :rect)
-savepng(Plots.IMG_DIR * "qwt1.png")
-```
+Call `backend(backend::Symbol)` or the shorthands (`gadfly()`, `qwt()`, `unicodeplots()`, etc) to set the current plotting backend.
+Subsequent commands are converted into the relevant plotting commands for that package:

-which saves:
-
-![qwt_plt](img/qwt1.png)
-
-
-
-## plot and plotter! interface (WIP)
-
-The main plot command.  Call `plotter!(:module)` to set the current plotting backend.
-Commands are converted into the relevant plotting commands for that package:
-
-```
-  plotter!(:gadfly)
-  plot(1:10)    # this effectively calls `y = 1:10; Gadfly.plot(x=1:length(y), y=y)`
-  plotter!(:qwt)
-  plot(1:10)    # this effectively calls `Qwt.plot(1:10)`
+```julia
+gadfly()
+plot(1:10)    # this effectively calls `y = 1:10; Gadfly.plot(x=1:length(y), y=y)`
+qwt()
+plot(1:10)    # this effectively calls `Qwt.plot(1:10)`
 ```

 Use `plot` to create a new plot object, and `plot!` to add to an existing one:

-```
-  plot(args...; kw...)                  # creates a new plot window, and sets it to be the `currentPlot`
-  plot!(args...; kw...)                 # adds to the `currentPlot`
-  plot!(plotobj, args...; kw...)        # adds to the plot `plotobj`
+```julia
+plot(args...; kw...)                  # creates a new plot window, and sets it to be the `current`
+plot!(args...; kw...)                 # adds to the `current`
+plot!(plotobj, args...; kw...)        # adds to the plot `plotobj`
 ```

 Now that you know which plot object you're updating (new, current, or other), I'll leave it off for simplicity.
-Here are some various args to supply, and the implicit mapping (AVec == AbstractVector and AMat == AbstractMatrix):
+There are many ways to pass in data to the plot functions... some examples:

-```
-  plot(y::AVec; kw...)                       # one line... x = 1:length(y)
-  plot(x::AVec, y::AVec; kw...)              # one line (will assert length(x) == length(y))
-  plot(y::AMat; kw...)                       # multiple lines (one per column of x), all sharing x = 1:size(y,1)
-  plot(x::AVec, y::AMat; kw...)              # multiple lines (one per column of x), all sharing x (will assert length(x) == size(y,1))
-  plot(x::AMat, y::AMat; kw...)              # multiple lines (one per column of x/y... will assert size(x) == size(y))
-  plot(x::AVec, f::Function; kw...)          # one line, y = f(x)
-  plot(x::AMat, f::Function; kw...)          # multiple lines, yᵢⱼ = f(xᵢⱼ)
-  plot(x::AVec, fs::AVec{Function}; kw...)   # multiple lines, yᵢⱼ = fⱼ(xᵢ)
-  plot(y::AVec{AVec}; kw...)                 # multiple lines, each with x = 1:length(y[i])
-  plot(x::AVec, y::AVec{AVec}; kw...)        # multiple lines, will assert length(x) == length(y[i])
-  plot(x::AVec{AVec}, y::AVec{AVec}; kw...)  # multiple lines, will assert length(x[i]) == length(y[i])
-  plot(n::Integer; kw...)                    # n lines, all empty (for updating plots)
+- Vector-like (subtypes of AbstractArray{T,1})
+- Matrix-like (subtypes of AbstractArray{T,2})
+- Vectors of Vectors
+- Functions
+- Vectors of Functions
+- DataFrames with column symbols (initialize with `dataframes()`)

-  # TODO: how do we handle NA values in dataframes?
-  plot(df::DataFrame; kw...)                 # one line per DataFrame column, labels == names(df)
-  plot(df::DataFrame, columns; kw...)        # one line per column, but on a subset of column names
+In general, you can pass in a `y` only, or an `x` and `y`, both of whatever type(s) you want, and Plots will slice up the data as needed.
+For matrices, data is split by columns.  For functions, data is mapped.  For DataFrames, a Symbol/Symbols in place of x/y will map to
+the relevant column(s).
+
+Here are some example usages... remember you can always use `plot!` to update an existing plot, and that, unless specified, you will update the `current()`.
+
+```julia
+plot()                                    # empty plot object
+plot(4)                                   # initialize with 4 empty series
+plot(rand(10))                            # plot 1 series... x = 1:10
+plot(rand(10,5))                          # plot 5 series... x = 1:10
+plot(rand(10), rand(10))                  # plot 1 series
+plot(rand(10,5), rand(10))                # plot 5 series... y is the same for all
+plot(sin, rand(10))                       # y = sin(x)
+plot(rand(10), sin)                       # same... y = sin(x)
+plot([sin,cos], 0:0.1:π)                  # plot 2 series, sin(x) and cos(x)
+plot([sin,cos], 0, π)                     # plot sin and cos on the range [0, π]
+plot(1:10, Any[rand(10), sin])            # plot 2 series, y = rand(10) for the first, y = sin(x) for the second... x = 1:10 for both
+plot(dataset("Ecdat", "Airline"), :Cost)  # plot from a DataFrame (call `dataframes()` first to import DataFrames and initialize)
 ```

-[TODO] You can swap out `plot` for `subplot`.  Each line will go into a separate plot.  Use the layout keyword:
+You can update certain plot settings after plot creation (not supported on all backends):

+```julia
+plot!(title = "New Title", xlabel = "New xlabel", ylabel = "New ylabel")
+plot!(xlims = (0, 5.5), ylims = (-2.2, 6), xticks = 0:0.5:10, yticks = [0,1,5,10])
 ```
-  y = rand(100,3)
-  subplot(y; layout=(2,2), kw...)           # creates 3 lines going into 3 separate plots, laid out on a 2x2 grid (last row is filled with plot #3)
-  subplot(y; layout=(1,3), kw...)           # again 3 plots, all in the same row
-  subplot(y; layout=[1,[2,3]])              # pass a nested Array to fully specify the layout.  here the first plot will take up the first row, 
-                                            # and the others will share the second row
+
+With `subplot`, create multiple plots at once, with flexible layout options:
+
+```julia
+y = rand(100,3)
+subplot(y; n = 3)             # create an automatic grid, and let it figure out the shape
+subplot(y; n = 3, nr = 1)     # create an automatic grid, but fix the number of rows
+subplot(y; n = 3, nc = 1)     # create an automatic grid, but fix the number of columns
+subplot(y; layout = [1, 2])   # explicit layout.  Lists the number of plots in each row
 ```

+__Tip__: You can call `subplot!(args...; kw...)` to add to an existing subplot.
+
+__Tip__: Calling `subplot!` on a `Plot` object, or `plot!` on a `Subplot` object will throw an error.
+
 Shorthands:

-```
-  scatter(args...; kw...)    = plot(args...; kw...,  linetype = :none, marker = :hexagon)
-  scatter!(args...; kw...)   = plot!(args...; kw..., linetype = :none, marker = :hexagon)
-  bar(args...; kw...)        = plot(args...; kw...,  linetype = :bar)
-  bar!(args...; kw...)       = plot!(args...; kw..., linetype = :bar)
-  histogram(args...; kw...)  = plot(args...; kw...,  linetype = :hist)
-  histogram!(args...; kw...) = plot!(args...; kw..., linetype = :hist)
-  heatmap(args...; kw...)    = plot(args...; kw...,  linetype = :heatmap)
-  heatmap!(args...; kw...)   = plot!(args...; kw..., linetype = :heatmap)
+```julia
+scatter(args...; kw...)    = plot(args...; kw...,  linetype = :scatter)
+scatter!(args...; kw...)   = plot!(args...; kw..., linetype = :scatter)
+bar(args...; kw...)        = plot(args...; kw...,  linetype = :bar)
+bar!(args...; kw...)       = plot!(args...; kw..., linetype = :bar)
+histogram(args...; kw...)  = plot(args...; kw...,  linetype = :hist)
+histogram!(args...; kw...) = plot!(args...; kw..., linetype = :hist)
+heatmap(args...; kw...)    = plot(args...; kw...,  linetype = :heatmap)
+heatmap!(args...; kw...)   = plot!(args...; kw..., linetype = :heatmap)
+sticks(args...; kw...)     = plot(args...; kw...,  linetype = :sticks, marker = :ellipse)
+sticks!(args...; kw...)    = plot!(args...; kw..., linetype = :sticks, marker = :ellipse)
+hline(args...; kw...)      = plot(args...; kw...,  linetype = :hline)
+hline!(args...; kw...)     = plot!(args...; kw..., linetype = :hline)
+vline(args...; kw...)      = plot(args...; kw...,  linetype = :vline)
+vline!(args...; kw...)     = plot!(args...; kw..., linetype = :vline)
+ohlc(args...; kw...)       = plot(args...; kw...,  linetype = :ohlc)
+ohlc!(args...; kw...)      = plot!(args...; kw..., linetype = :ohlc)
+
+title!(s::AbstractString)                 = plot!(title = s)
+xlabel!(s::AbstractString)                = plot!(xlabel = s)
+ylabel!(s::AbstractString)                = plot!(ylabel = s)
+xlims!{T<:Real,S<:Real}(lims::Tuple{T,S}) = plot!(xlims = lims)
+ylims!{T<:Real,S<:Real}(lims::Tuple{T,S}) = plot!(ylims = lims)
+xticks!{T<:Real}(v::AVec{T})              = plot!(xticks = v)
+yticks!{T<:Real}(v::AVec{T})              = plot!(yticks = v)
+annotate!(anns)                           = plot!(annotation = anns)
 ```

 Some keyword arguments you can set:

-```
-  axis            # :left or :right
-  color           # can be a string ("red") or a symbol (:red) or a ColorsTypes.jl Colorant (RGB(1,0,0)) or :auto (which lets the package pick)
-  label           # string or symbol, applies to that line, may go in a legend
-  width           # width of a line
-  linetype        # :line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar
-  linestyle       # :solid, :dash, :dot, :dashdot, :dashdotdot
-  marker          # :none, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon
-  markercolor     # same choices as `color`, or :match will set the color to be the same as `color`
-  markersize      # size of the marker
-  nbins           # number of bins for heatmap/hexbin and histograms
-  heatmap_c       # color cutoffs for Qwt heatmaps
-  fillto          # fillto value for area plots
-  title           # string or symbol, title of the plot
-  xlabel          # string or symbol, label on the bottom (x) axis
-  ylabel          # string or symbol, label on the left (y) axis
-  yrightlabel     # string or symbol, label on the right (y) axis
-  reg             # true or false, add a regression line for each line
-  size            # (Int,Int), resize the enclosing window
-  pos             # (Int,Int), move the enclosing window to this position
-  windowtitle     # string or symbol, set the title of the enclosing windowtitle
-  screen          # Integer, move enclosing window to this screen number (for multiscreen desktops)
-  show            # true or false, show the plot (in case you don't want the window to pop up right away)
+Keyword | Default | Type | Aliases 
+---- | ---- | ---- | ----
+`:annotation` | `nothing` | Series | `:ann`, `:annotate`, `:annotations`, `:anns`  
+`:axis` | `left` | Series | `:axiss`  
+`:color` | `auto` | Series | `:c`, `:colors`  
+`:fillto` | `nothing` | Series | `:area`, `:fill`, `:filltos`  
+`:group` | `nothing` | Series | `:g`, `:groups`  
+`:heatmap_c` | `(0.15,0.5)` | Series | `:heatmap_cs`  
+`:label` | `AUTO` | Series | `:lab`, `:labels`  
+`:linestyle` | `solid` | Series | `:linestyles`, `:ls`, `:s`, `:style`  
+`:linetype` | `path` | Series | `:linetypes`, `:lt`, `:t`, `:type`  
+`:marker` | `none` | Series | `:m`, `:markers`, `:shape`  
+`:markercolor` | `match` | Series | `:markercolors`, `:mc`, `:mcolor`  
+`:markersize` | `6` | Series | `:markersizes`, `:ms`, `:msize`  
+`:nbins` | `100` | Series | `:nb`, `:nbin`, `:nbinss`  
+`:reg` | `false` | Series | `:regression`, `:regs`  
+`:ribbon` | `nothing` | Series | `:rib`, `:ribbons`  
+`:width` | `1` | Series | `:linewidth`, `:w`, `:widths`  
+`:background_color` | `RGB{U8}(1.0,1.0,1.0)` | Plot | `:background`, `:bg`, `:bg_color`, `:bgcolor`  
+`:foreground_color` | `auto` | Plot | `:fg`, `:fg_color`, `:fgcolor`, `:foreground`  
+`:layout` | `nothing` | Plot |   
+`:legend` | `true` | Plot | `:leg`  
+`:n` | `-1` | Plot |   
+`:nc` | `-1` | Plot |   
+`:nr` | `-1` | Plot |   
+`:pos` | `(0,0)` | Plot |   
+`:show` | `false` | Plot | `:display`, `:gui`  
+`:size` | `(800,600)` | Plot | `:windowsize`, `:wsize`  
+`:title` | `` | Plot |   
+`:windowtitle` | `Plots.jl` | Plot | `:wtitle`  
+`:xlabel` | `` | Plot | `:xlab`  
+`:xlims` | `auto` | Plot | `:xlim`, `:xlimit`, `:xlimits`  
+`:xscale` | `identity` | Plot |   
+`:xticks` | `auto` | Plot | `:xtick`  
+`:ylabel` | `` | Plot | `:ylab`  
+`:ylims` | `auto` | Plot | `:ylim`, `:ylimit`, `:ylimits`  
+`:yrightlabel` | `` | Plot | `:y2lab`, `:y2label`, `:ylab2`, `:ylabel2`, `:ylabelright`, `:ylabr`, `:yrlab`  
+`:yscale` | `identity` | Plot |   
+`:yticks` | `auto` | Plot | `:ytick`  
+
+
+Plot types:
+
+Type | Desc | Aliases
+---- | ---- | ----
+`:none` | No line | `:n`, `:no`  
+`:line` | Lines with sorted x-axis | `:l`  
+`:path` | Lines | `:p`  
+`:steppre` | Step plot (vertical then horizontal) | `:stepinv`, `:stepinverted`, `:stepsinv`, `:stepsinverted`  
+`:steppost` | Step plot (horizontal then vertical) | `:stair`, `:stairs`, `:step`, `:steps`  
+`:sticks` | Vertical lines | `:stem`, `:stems`  
+`:scatter` | Points, no lines | `:dots`  
+`:heatmap` | Colored regions by density |   
+`:hexbin` | Similar to heatmap |   
+`:hist` | Histogram (doesn't use x) | `:histogram`  
+`:bar` | Bar plot (centered on x values) |   
+`:hline` | Horizontal line (doesn't use x) |   
+`:vline` | Vertical line (doesn't use x) |   
+`:ohlc` | Open/High/Low/Close chart (expects y is AbstractVector{Plots.OHLC}) |   
+
+
+Line styles:
+
+Type | Aliases
+---- | ----
+`:auto` | `:a`  
+`:solid` | `:s`  
+`:dash` | `:d`  
+`:dot` |   
+`:dashdot` | `:dd`  
+`:dashdotdot` | `:ddd`  
+
+
+Markers:
+
+Type | Aliases
+---- | ----
+`:none` | `:n`, `:no`  
+`:auto` | `:a`  
+`:ellipse` | `:c`, `:circle`  
+`:rect` | `:r`, `:sq`, `:square`  
+`:diamond` | `:d`  
+`:utriangle` | `:^`, `:uptri`, `:uptriangle`, `:ut`, `:utri`  
+`:dtriangle` | `:V`, `:downtri`, `:downtriangle`, `:dt`, `:dtri`, `:v`  
+`:cross` | `:+`, `:plus`  
+`:xcross` | `:X`, `:x`  
+`:star1` | `:s`, `:star`  
+`:star2` | `:s2`  
+`:hexagon` | `:h`, `:hex`  
+`:octagon` | `:o`, `:oct`  
+
+
+
+__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)` or `default(; kw...)`.  For example set the default window size and whether we should show a legend with `default(size=(600,400), leg=false)`.
+
+__Tip__: When plotting multiple lines, you can set all series to use the same value, or pass in an array to cycle through values.  Example:
+
+```julia
+plot(rand(100,4); color = [:red, RGB(0,0,1)],    # lines 1 and 3 are red, lines 2 and 4 are blue
+                  axis = :auto,                  # lines 1 and 3 are on the left axis, lines 2 and 4 are on the right
+                  width = 5)                     # all lines have a width of 5
 ```

-If you don't include a keyword argument, these are the defaults:
-  
-```
-  axis = :left
-  color = :auto
-  label = automatically generated (y1, y2, ...., or y1 (R), y2 (R) for the right axis)
-  width = 1
-  linetype = :line
-  linestype = :solid
-  marker = :none
-  markercolor = :match
-  markersize = 3
-  nbins = 100
-  heatmap_c = (0.15, 0.5)
-  fillto = nothing
-  title = ""
-  xlabel = ""
-  ylabel = ""
-  yrightlabel = ""
-  reg = false
-  size = (800,600)
-  pos = (0,0)
-  windowtitle = ""
-  screen = 1
-  show = true
-```
+__Tip__: Not all features are supported for each backend, but you can see what's supported by calling the functions: `supportedArgs()`, `supportedAxes()`, `supportedTypes()`, `supportedStyles()`, `supportedMarkers()`, `subplotSupported()`

-When plotting multiple lines, you can give every line the same trait by using the singular, or add an "s" to pluralize.
-  (yes I know it's not gramatically correct, but it's easy to use and implement)
+__Tip__: Call `gui()` to display the plot in a window.  Interactivity depends on backend.  Plotting at the REPL (without semicolon) implicitly calls `gui()`.

-```
-  plot(rand(100,2); colors = [:red, RGB(.5,.5,0)], axiss = [:left, :right], width = 5)  # note the width=5 is applied to both lines
-```
-
-# TODO
+## TODO features:

 - [x] Plot vectors/matrices/functions
- [ ] Plot DataFrames
- [ ] Subplots
- [ ] Histograms
+- [x] Plot DataFrames
+- [x] Grouping
+- [ ] Annotations
+- [ ] Scales
+- [ ] Categorical Inputs (strings, etc... for hist, bar? or can split one series into multiple?)
+- [ ] Custom markers
+- [ ] Special plots (boxplot, ohlc?)
+- [x] Subplots
+- [x] Histograms
 - [ ] 3D plotting
 - [ ] Scenes/Drawing
 - [ ] Graphs
 - [ ] Interactivity (GUIs)
+
+## TODO backends:
+
 - [x] Gadfly.jl
- [ ] PyPlot.jl
- [ ] Winston.jl
- [ ] Gaston.jl
- [ ] GLPlot.jl
+- [x] Immerse.jl
+- [x] PyPlot.jl
+- [x] UnicodePlots.jl
 - [x] Qwt.jl
+- [x] Winston.jl
+- [ ] GLPlot.jl
 - [ ] Bokeh.jl
+- [ ] Vega.jl
+- [ ] Gaston.jl
 - [ ] Plotly.jl
 - [ ] GoogleCharts.jl
- [ ] Vega.jl
 - [ ] PLplot.jl
 - [ ] TextPlots.jl
 - [ ] ASCIIPlots.jl
 - [ ] Sparklines.jl
- [ ] UnicodePlots.jl
 - [ ] Hinton.jl
 - [ ] ImageTerm.jl
 - [ ] GraphViz.jl
 - [ ] TikzGraphs.jl
 - [ ] GraphLayout.jl

-# Backends
+## More information on backends (both supported and unsupported)

 See the wiki at: https://github.com/JuliaPlot/juliaplot_docs/wiki

-# Author
-
-Thomas Breloff (@tbreloff)

@@ -1,4 +1,4 @@
 julia 0.4-

 Colors
-FactCheck
+Reexport
@@ -11,8 +11,8 @@ doc"""
 Holds all data needed for a documentation example... header, description, and plotting expression (Expr)
 """
 type PlotExample
-  header::String
-  desc::String
+  header::AbstractString
+  desc::AbstractString
  exprs::Vector{Expr}
 end

@@ -20,83 +20,133 @@ end
 # the examples we'll run for each
 const examples = PlotExample[
  PlotExample("Lines",
-              "A simple line plot of the 3 columns.",
-              [:(plot(rand(100,3)))]),
+              "A simple line plot of the columns.",
+              [:(plot(rand(50,5), w=3))]),
  PlotExample("Functions",
-              "Plot multiple functions",
+              "Plot multiple functions.  You can also put the function first.",
              [:(plot(0:0.01:4π, [sin,cos]))]),
+  PlotExample("",
+              "You can also call it with plot(f, xmin, xmax).",
+              [:(plot([sin,cos], 0, 4π))]),
+  PlotExample("",
+              "Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).",
+              [:(plot(sin, x->sin(2x), 0, 2π, legend=false, fillto=0))]),
  PlotExample("Global",
-              "Change the guides/background without a separate call.",
-              [:(plot(rand(10); title="TITLE", xlabel="XLABEL", ylabel="YLABEL", background_color = RGB(0.5,0.5,0.5)))]),
+              "Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`",
+              [:(plot(rand(10), title="TITLE", xlabel="XLABEL", ylabel="YLABEL", background_color = RGB(0.2,0.2,0.2), xlim=(-3,13), yticks=0:0.1:1))]),
  PlotExample("Two-axis",
-              "Use the `axis` or `axiss` arguments.\n\nNote: This is only supported with Qwt right now",
-              [:(plot(Vector[randn(100), randn(100)*100]; axiss = [:left,:right]))]),
+              "Use the `axis` arguments.\n\nNote: Currently only supported with Qwt and PyPlot",
+              [:(plot(Vector[randn(100), randn(100)*100]; axis = [:l,:r], ylabel="LEFT", yrightlabel="RIGHT"))]),
  PlotExample("Vectors w/ pluralized args",
-              "Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).",
-              [:(plot(Vector[rand(10), rand(20)]; marker=:ellipse, markersize=8, colors=[:red,:blue]))]),
+              "Plot multiple series with different numbers of points.  Mix arguments that apply to all series (marker/markersize) with arguments unique to each series (colors).",
+              [:(plot(Vector[rand(10), rand(20)]; marker=:ellipse, markersize=8, c=[:red,:blue]))]),
  PlotExample("Build plot in pieces",
              "Start with a base plot...",
-              [:(plot(rand(100)/3; reg=true, fillto=0))]),
+              [:(plot(rand(100)/3, reg=true, fillto=0))]),
  PlotExample("",
              "and add to it later.",
-              [:(scatter!(rand(100); markersize=6, color=:blue))]),
+              [:(scatter!(rand(100), markersize=6, c=:blue))]),
  PlotExample("Heatmaps",
              "",
-              [:(heatmap(randn(10000),randn(10000); nbins=200))]),
-  PlotExample("Lots of line types",
-              "Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  \nNote: some may not work with all backends",
-              [:(plot(rand(20,4); linetypes=[:line, :step, :sticks, :dots]))]),
+              [:(heatmap(randn(10000),randn(10000), nbins=100))]),
+  PlotExample("Line types",
+              "",
+              [:(types = intersect(supportedTypes(), [:line, :path, :steppre, :steppost, :sticks, :scatter])),
+                  :(n = length(types)),
+                  :(x = Vector[sort(rand(20)) for i in 1:n]),
+                  :(y = rand(20,n)),
+                  :(plot(x, y, t=types, lab=map(string,types)))]),
+  PlotExample("Line styles",
+              "",
+              [:(styles = setdiff(supportedStyles(), [:auto])), :(plot(cumsum(randn(20,length(styles)),1); style=:auto, label=map(string,styles), w=5))]),
+  PlotExample("Marker types",
+              "",
+              [:(markers = setdiff(supportedMarkers(), [:none,:auto])), :(scatter(0.5:9.5, [fill(i-0.5,10) for i=length(markers):-1:1]; marker=:auto, label=map(string,markers), ms=10))]),
  PlotExample("Bar",
              "x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)",
              [:(bar(randn(1000)))]),
  PlotExample("Histogram",
-              "note: fillto isn't supported on all backends",
-              [:(histogram(randn(1000); nbins=50, fillto=20))]),
+              "",
+              [:(histogram(randn(1000), nbins=50))]),
  PlotExample("Subplots",
              """
                subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
                You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
-                number of columns `nc`), or you can set the layout directly with `layout`.  
-
-                Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
+                number of columns `nc`), or you can set the layout directly with `layout`.
              """,
-              [:(subplot(randn(100,5); layout=[1,1,3], linetypes=[:line,:hist,:dots,:step,:bar], nbins=10, legend=false))]),
+              [:(subplot(randn(100,5), layout=[1,1,3], t=[:line,:hist,:scatter,:step,:bar], nbins=10, leg=false))]),
  PlotExample("Adding to subplots",
              "Note here the automatic grid layout, as well as the order in which new series are added to the plots.",
-              [:(subplot(randn(100,5); n=4))]),
+              [:(subplot(randn(100,5), n=4))]),
  PlotExample("",
              "",
              [:(subplot!(randn(100,3)))]),
-
+  PlotExample("Open/High/Low/Close",
+              "Create an OHLC chart.  Pass in a vector of OHLC objects as your `y` argument.  Adjust the tick width with arg `markersize`.",
+              [:(n=20), :(hgt=rand(n)+1), :(bot=randn(n)), :(openpct=rand(n)), :(closepct=rand(n)), :(y = [OHLC(openpct[i]*hgt[i]+bot[i], bot[i]+hgt[i], bot[i], closepct[i]*hgt[i]+bot[i]) for i in 1:n]), :(ohlc(y; markersize=8))]),
+  PlotExample("Annotations",
+              "Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`",
+              [
+                :(y = rand(10)),
+                :(plot(y, ann=(3,y[3],"this is #3"))),
+                :(annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")]))
+              ]),
  
 ]


+function createStringOfMarkDownCodeValues(arr, prefix = "")
+  string("`", prefix, join(arr, "`, `$prefix"), "`")
+end
+createStringOfMarkDownSymbols(arr) = isempty(arr) ? "" : createStringOfMarkDownCodeValues(arr, ":")
+
+
 function generate_markdown(pkgname::Symbol)

-  # set up the plotter, and don't show the plots by default
-  plotter!(pkgname)
-  plotDefault!(:show, false)
+  # set up the backend, and don't show the plots by default
+  pkg = backend(pkgname)
+  # default(:show, false)
+
+  # mkdir if necessary
+  try
+    mkdir("$IMGDIR/$pkgname")
+  end

  # open the markdown file
  md = open("$DOCDIR/$(pkgname)_examples.md", "w")

+  write(md, "# Examples for backend: $pkgname\n\n")
+  write(md, "- Supported arguments: $(createStringOfMarkDownCodeValues(supportedArgs(pkg)))\n")
+  write(md, "- Supported values for axis: $(createStringOfMarkDownSymbols(supportedAxes(pkg)))\n")
+  write(md, "- Supported values for linetype: $(createStringOfMarkDownSymbols(supportedTypes(pkg)))\n")
+  write(md, "- Supported values for linestyle: $(createStringOfMarkDownSymbols(supportedStyles(pkg)))\n")
+  write(md, "- Supported values for marker: $(createStringOfMarkDownSymbols(supportedMarkers(pkg)))\n")
+  write(md, "- Is `subplot`/`subplot!` supported? $(subplotSupported(pkg) ? "Yes" : "No")\n\n")
+
+  write(md, "### Initialize\n\n```julia\nusing Plots\n$(pkgname)()\n```\n\n")
+
+
  for (i,example) in enumerate(examples)

    try

+      # we want to always produce consistent results
+      srand(1234)
+
      # run the code
      map(eval, example.exprs)

      # save the png
      imgname = "$(pkgname)_example_$i.png"
-      savepng("$IMGDIR/$imgname")
+
+      # NOTE: uncomment this to overwrite the images as well
+      png("$IMGDIR/$pkgname/$imgname")

      # write out the header, description, code block, and image link
      write(md, "### $(example.header)\n\n")
      write(md, "$(example.desc)\n\n")
      write(md, "```julia\n$(join(map(string, example.exprs), "\n"))\n```\n\n")
-      write(md, "![](../img/$imgname)\n\n")
+      write(md, "![](../img/$pkgname/$imgname)\n\n")

    catch ex
      # TODO: put error info into markdown?
@@ -110,8 +160,134 @@ function generate_markdown(pkgname::Symbol)

 end

+
+# make and display one plot
+function test_example(pkgname::Symbol, idx::Int)
+  println("Testing plot: $pkgname:$idx:$(examples[idx].header)")
+  backend(pkgname)
+  backend()
+  map(eval, examples[idx].exprs)
+  plt = current()
+  gui(plt)
+  plt
+end
+
+# generate all plots and create a dict mapping idx --> plt
+function test_all_examples(pkgname::Symbol)
+  plts = Dict()
+  for i in 1:length(examples)
+    # if examples[i].header == "Subplots" && !subplotSupported()
+    #   break
+    # end
+
+    try
+      plt = test_example(pkgname, i)
+      plts[i] = plt
+    catch ex
+      # TODO: put error info into markdown?
+      warn("Example $pkgname:$i:$(examples[i].header) failed with: $ex")
+    end
+  end
+  plts
+end
+
+# axis            # :left or :right
+# color           # can be a string ("red") or a symbol (:red) or a ColorsTypes.jl 
+#                 #   Colorant (RGB(1,0,0)) or :auto (which lets the package pick)
+# label           # string or symbol, applies to that line, may go in a legend
+# width           # width of a line
+# linetype        # :line, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar
+# linestyle       # :solid, :dash, :dot, :dashdot, :dashdotdot
+# marker          # :none, :ellipse, :rect, :diamond, :utriangle, :dtriangle,
+#                 #   :cross, :xcross, :star1, :star2, :hexagon
+# markercolor     # same choices as `color`, or :match will set the color to be the same as `color`
+# markersize      # size of the marker
+# nbins           # number of bins for heatmap/hexbin and histograms
+# heatmap_c       # color cutoffs for Qwt heatmaps
+# fillto          # fillto value for area plots
+# title           # string or symbol, title of the plot
+# xlabel          # string or symbol, label on the bottom (x) axis
+# ylabel          # string or symbol, label on the left (y) axis
+# yrightlabel     # string or symbol, label on the right (y) axis
+# reg             # true or false, add a regression line for each line
+# size            # (Int,Int), resize the enclosing window
+# pos             # (Int,Int), move the enclosing window to this position
+# windowtitle     # string or symbol, set the title of the enclosing windowtitle
+# screen          # Integer, move enclosing window to this screen number (for multiscreen desktops)
+
+
+
+const _ltdesc = Dict(
+    :none => "No line",
+    :line => "Lines with sorted x-axis",
+    :path => "Lines",
+    :steppre => "Step plot (vertical then horizontal)",
+    :steppost => "Step plot (horizontal then vertical)",
+    :sticks => "Vertical lines",
+    :scatter => "Points, no lines",
+    :heatmap => "Colored regions by density",
+    :hexbin => "Similar to heatmap",
+    :hist => "Histogram (doesn't use x)",
+    :bar => "Bar plot (centered on x values)",
+    :hline => "Horizontal line (doesn't use x)",
+    :vline => "Vertical line (doesn't use x)",
+    :ohlc => "Open/High/Low/Close chart (expects y is AbstractVector{Plots.OHLC})",
+  )
+
+function buildReadme()
+  readme = readall("$DOCDIR/readme_template.md")
+
+  # build keyword arg table
+  table = "Keyword | Default | Type | Aliases \n---- | ---- | ---- | ----\n"
+  for d in (Plots._seriesDefaults, Plots._plotDefaults)
+    for k in Plots.sortedkeys(d)
+      aliasstr = createStringOfMarkDownSymbols(aliases(Plots._keyAliases, k))
+      table = string(table, "`:$k` | `$(d[k])` | $(d==Plots._seriesDefaults ? "Series" : "Plot") | $aliasstr  \n")
+    end
+  end
+  readme = replace(readme, "[[KEYWORD_ARGS_TABLE]]", table)
+
+  # build linetypes table
+  table = "Type | Desc | Aliases\n---- | ---- | ----\n"
+  for lt in Plots._allTypes
+    aliasstr = createStringOfMarkDownSymbols(aliases(Plots._typeAliases, lt))
+    table = string(table, "`:$lt` | $(_ltdesc[lt]) | $aliasstr  \n")
+  end
+  readme = replace(readme, "[[LINETYPES_TABLE]]", table)
+
+  # build linestyles table
+  table = "Type | Aliases\n---- | ----\n"
+  for s in Plots._allStyles
+    aliasstr = createStringOfMarkDownSymbols(aliases(Plots._styleAliases, s))
+    table = string(table, "`:$s` | $aliasstr  \n")
+  end
+  readme = replace(readme, "[[LINESTYLES_TABLE]]", table)
+
+  # build markers table
+  table = "Type | Aliases\n---- | ----\n"
+  for s in Plots._allMarkers
+    aliasstr = createStringOfMarkDownSymbols(aliases(Plots._markerAliases, s))
+    table = string(table, "`:$s` | $aliasstr  \n")
+  end
+  readme = replace(readme, "[[MARKERS_TABLE]]", table)
+
+  readme_fn = Pkg.dir("Plots") * "/README.md"
+  f = open(readme_fn, "w")
+  write(f, readme)
+  close(f)
+
+  gadfly()
+  Plots.dumpSupportGraphs()
+end
+
 # run it!
-map(generate_markdown, (:qwt, :gadfly))
+# note: generate separately so it's easy to comment out
+# @osx_only generate_markdown(:unicodeplots)
+# generate_markdown(:qwt)
+# generate_markdown(:gadfly)
+# generate_markdown(:pyplot)
+# generate_markdown(:immerse)
+# generate_markdown(:winston)


 end # module
@@ -1,95 +1,158 @@
-### Lines
+# Examples for backend: gadfly

-A simple line plot of the 3 columns.
+- Supported arguments: `annotation`, `args`, `background_color`, `color`, `fillto`, `group`, `kwargs`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `n`, `nbins`, `nc`, `nr`, `reg`, `show`, `size`, `title`, `width`, `windowtitle`, `x`, `xlabel`, `xlims`, `xticks`, `y`, `ylabel`, `ylims`, `yticks`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:path`, `:steppost`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`, `:hline`, `:vline`, `:ohlc`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:star2`, `:hexagon`, `:octagon`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize

 ```julia
-plot(rand(100,3))
+using Plots
+gadfly()
 ```

-![](../img/gadfly_example_1.png)
+### Lines
+
+A simple line plot of the columns.
+
+```julia
+plot(rand(50,5),w=3)
+```
+
+![](../img/gadfly/gadfly_example_1.png)

 ### Functions

-Plot multiple functions
+Plot multiple functions.  You can also put the function first.

 ```julia
 plot(0:0.01:4π,[sin,cos])
 ```

-![](../img/gadfly_example_2.png)
+![](../img/gadfly/gadfly_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/gadfly/gadfly_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π,legend=false,fillto=0)
+```
+
+![](../img/gadfly/gadfly_example_4.png)

 ### Global

-Change the guides/background without a separate call.
+Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`

 ```julia
-plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+plot(rand(10),title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.2,0.2,0.2),xlim=(-3,13),yticks=0:0.1:1)
 ```

-![](../img/gadfly_example_3.png)
+![](../img/gadfly/gadfly_example_5.png)

 ### Two-axis

-Use the `axis` or `axiss` arguments.
+Use the `axis` arguments.

-Note: This is only supported with Qwt right now
+Note: Currently only supported with Qwt and PyPlot

 ```julia
-plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right])
+plot(Vector[randn(100),randn(100) * 100]; axis=[:l,:r],ylabel="LEFT",yrightlabel="RIGHT")
 ```

-![](../img/gadfly_example_4.png)
+![](../img/gadfly/gadfly_example_6.png)

 ### Vectors w/ pluralized args

 Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).

 ```julia
-plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,c=[:red,:blue])
 ```

-![](../img/gadfly_example_5.png)
+![](../img/gadfly/gadfly_example_7.png)

 ### Build plot in pieces

 Start with a base plot...

 ```julia
-plot(rand(100) / 3; reg=true,fillto=0)
+plot(rand(100) / 3,reg=true,fillto=0)
 ```

-![](../img/gadfly_example_6.png)
+![](../img/gadfly/gadfly_example_8.png)

 ### 

 and add to it later.

 ```julia
-scatter!(rand(100); markersize=6,color=:blue)
+scatter!(rand(100),markersize=6,c=:blue)
 ```

-![](../img/gadfly_example_7.png)
+![](../img/gadfly/gadfly_example_9.png)

 ### Heatmaps



 ```julia
-heatmap(randn(10000),randn(10000); nbins=200)
+heatmap(randn(10000),randn(10000),nbins=100)
 ```

-![](../img/gadfly_example_8.png)
+![](../img/gadfly/gadfly_example_10.png)
+
+### Line types

-### Lots of line types

-Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  
-Note: some may not work with all backends

 ```julia
-plot(rand(20,4); linetypes=[:line,:step,:sticks,:dots])
+types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y,t=types,lab=map(string,types))
 ```

-![](../img/gadfly_example_9.png)
+![](../img/gadfly/gadfly_example_11.png)
+
+### Line styles
+
+
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(cumsum(randn(20,length(styles)),1); style=:auto,label=map(string,styles),w=5)
+```
+
+![](../img/gadfly/gadfly_example_12.png)
+
+### Marker types
+
+
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+scatter(0.5:9.5,[fill(i - 0.5,10) for i = length(markers):-1:1]; marker=:auto,label=map(string,markers),ms=10)
+```
+
+![](../img/gadfly/gadfly_example_13.png)

 ### Bar

@@ -99,42 +162,40 @@ x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints
 bar(randn(1000))
 ```

-![](../img/gadfly_example_10.png)
+![](../img/gadfly/gadfly_example_14.png)

 ### Histogram

-note: fillto isn't supported on all backends
+

 ```julia
-histogram(randn(1000); nbins=50,fillto=20)
+histogram(randn(1000),nbins=50)
 ```

-![](../img/gadfly_example_11.png)
+![](../img/gadfly/gadfly_example_15.png)

 ### Subplots

  subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
  You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
-  number of columns `nc`), or you can set the layout directly with `layout`.  
-
-  Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
+  number of columns `nc`), or you can set the layout directly with `layout`.


 ```julia
-subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:dots,:step,:bar],nbins=10,legend=false)
+subplot(randn(100,5),layout=[1,1,3],t=[:line,:hist,:scatter,:step,:bar],nbins=10,leg=false)
 ```

-![](../img/gadfly_example_12.png)
+![](../img/gadfly/gadfly_example_16.png)

 ### Adding to subplots

 Note here the automatic grid layout, as well as the order in which new series are added to the plots.

 ```julia
-subplot(randn(100,5); n=4)
+subplot(randn(100,5),n=4)
 ```

-![](../img/gadfly_example_13.png)
+![](../img/gadfly/gadfly_example_17.png)

 ### 

@@ -144,5 +205,33 @@ subplot(randn(100,5); n=4)
 subplot!(randn(100,3))
 ```

-![](../img/gadfly_example_14.png)
+![](../img/gadfly/gadfly_example_18.png)
+
+### Open/High/Low/Close
+
+Create an OHLC chart.  Pass in a vector of OHLC objects as your `y` argument.  Adjust the tick width with arg `markersize`.
+
+```julia
+n = 20
+hgt = rand(n) + 1
+bot = randn(n)
+openpct = rand(n)
+closepct = rand(n)
+y = [OHLC(openpct[i] * hgt[i] + bot[i],bot[i] + hgt[i],bot[i],closepct[i] * hgt[i] + bot[i]) for i = 1:n]
+ohlc(y; markersize=8)
+```
+
+![](../img/gadfly/gadfly_example_19.png)
+
+### Annotations
+
+Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`
+
+```julia
+y = rand(10)
+plot(y,ann=(3,y[3],"this is #3"))
+annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")])
+```
+
+![](../img/gadfly/gadfly_example_20.png)

@@ -0,0 +1,237 @@
+# Examples for backend: immerse
+
+- Supported arguments: `annotation`, `args`, `background_color`, `color`, `fillto`, `group`, `kwargs`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `n`, `nbins`, `nc`, `nr`, `reg`, `show`, `size`, `title`, `width`, `windowtitle`, `x`, `xlabel`, `xlims`, `xticks`, `y`, `ylabel`, `ylims`, `yticks`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:path`, `:steppost`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`, `:hline`, `:vline`, `:ohlc`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:star2`, `:hexagon`, `:octagon`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+immerse()
+```
+
+### Lines
+
+A simple line plot of the columns.
+
+```julia
+plot(rand(50,5),w=3)
+```
+
+![](../img/immerse/immerse_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/immerse/immerse_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/immerse/immerse_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π,legend=false,fillto=0)
+```
+
+![](../img/immerse/immerse_example_4.png)
+
+### Global
+
+Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`
+
+```julia
+plot(rand(10),title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.2,0.2,0.2),xlim=(-3,13),yticks=0:0.1:1)
+```
+
+![](../img/immerse/immerse_example_5.png)
+
+### Two-axis
+
+Use the `axis` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axis=[:l,:r],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/immerse/immerse_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,c=[:red,:blue])
+```
+
+![](../img/immerse/immerse_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3,reg=true,fillto=0)
+```
+
+![](../img/immerse/immerse_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100),markersize=6,c=:blue)
+```
+
+![](../img/immerse/immerse_example_9.png)
+
+### Heatmaps
+
+
+
+```julia
+heatmap(randn(10000),randn(10000),nbins=100)
+```
+
+![](../img/immerse/immerse_example_10.png)
+
+### Line types
+
+
+
+```julia
+types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y,t=types,lab=map(string,types))
+```
+
+![](../img/immerse/immerse_example_11.png)
+
+### Line styles
+
+
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(cumsum(randn(20,length(styles)),1); style=:auto,label=map(string,styles),w=5)
+```
+
+![](../img/immerse/immerse_example_12.png)
+
+### Marker types
+
+
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+scatter(0.5:9.5,[fill(i - 0.5,10) for i = length(markers):-1:1]; marker=:auto,label=map(string,markers),ms=10)
+```
+
+![](../img/immerse/immerse_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/immerse/immerse_example_14.png)
+
+### Histogram
+
+
+
+```julia
+histogram(randn(1000),nbins=50)
+```
+
+![](../img/immerse/immerse_example_15.png)
+
+### Subplots
+
+  subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
+  You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
+  number of columns `nc`), or you can set the layout directly with `layout`.
+
+
+```julia
+subplot(randn(100,5),layout=[1,1,3],t=[:line,:hist,:scatter,:step,:bar],nbins=10,leg=false)
+```
+
+![](../img/immerse/immerse_example_16.png)
+
+### Adding to subplots
+
+Note here the automatic grid layout, as well as the order in which new series are added to the plots.
+
+```julia
+subplot(randn(100,5),n=4)
+```
+
+![](../img/immerse/immerse_example_17.png)
+
+### 
+
+
+
+```julia
+subplot!(randn(100,3))
+```
+
+![](../img/immerse/immerse_example_18.png)
+
+### Open/High/Low/Close
+
+Create an OHLC chart.  Pass in a vector of OHLC objects as your `y` argument.  Adjust the tick width with arg `markersize`.
+
+```julia
+n = 20
+hgt = rand(n) + 1
+bot = randn(n)
+openpct = rand(n)
+closepct = rand(n)
+y = [OHLC(openpct[i] * hgt[i] + bot[i],bot[i] + hgt[i],bot[i],closepct[i] * hgt[i] + bot[i]) for i = 1:n]
+ohlc(y; markersize=8)
+```
+
+![](../img/immerse/immerse_example_19.png)
+
+### Annotations
+
+Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`
+
+```julia
+y = rand(10)
+plot(y,ann=(3,y[3],"this is #3"))
+annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")])
+```
+
+![](../img/immerse/immerse_example_20.png)
+
@@ -0,0 +1,188 @@
+# Examples for backend: pyplot
+
+- Supported arguments: `annotation`, `args`, `axis`, `background_color`, `color`, `foreground_color`, `group`, `kwargs`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `n`, `nbins`, `nc`, `nr`, `show`, `size`, `title`, `width`, `windowtitle`, `x`, `xlabel`, `y`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`, `:right`
+- Supported values for linetype: `:none`, `:line`, `:path`, `:step`, `:stepinverted`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:hexagon`
+- Is `subplot`/`subplot!` supported? No
+
+### Initialize
+
+```julia
+using Plots
+pyplot()
+```
+
+### Lines
+
+A simple line plot of the columns.
+
+```julia
+plot(rand(50,5),w=3)
+```
+
+![](../img/pyplot/pyplot_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/pyplot/pyplot_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/pyplot/pyplot_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π,legend=false,fillto=0)
+```
+
+![](../img/pyplot/pyplot_example_4.png)
+
+### Global
+
+Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`
+
+```julia
+plot(rand(10),title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.2,0.2,0.2),xlim=(-3,13),yticks=0:0.1:1)
+```
+
+![](../img/pyplot/pyplot_example_5.png)
+
+### Two-axis
+
+Use the `axis` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axis=[:l,:r],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/pyplot/pyplot_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,c=[:red,:blue])
+```
+
+![](../img/pyplot/pyplot_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3,reg=true,fillto=0)
+```
+
+![](../img/pyplot/pyplot_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100),markersize=6,c=:blue)
+```
+
+![](../img/pyplot/pyplot_example_9.png)
+
+### Heatmaps
+
+
+
+```julia
+heatmap(randn(10000),randn(10000),nbins=100)
+```
+
+![](../img/pyplot/pyplot_example_10.png)
+
+### Line types
+
+
+
+```julia
+types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y,t=types,lab=map(string,types))
+```
+
+![](../img/pyplot/pyplot_example_11.png)
+
+### Line styles
+
+
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(cumsum(randn(20,length(styles)),1); style=:auto,label=map(string,styles),w=5)
+```
+
+![](../img/pyplot/pyplot_example_12.png)
+
+### Marker types
+
+
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+scatter(0.5:9.5,[fill(i - 0.5,10) for i = length(markers):-1:1]; marker=:auto,label=map(string,markers),ms=10)
+```
+
+![](../img/pyplot/pyplot_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/pyplot/pyplot_example_14.png)
+
+### Histogram
+
+
+
+```julia
+histogram(randn(1000),nbins=50)
+```
+
+![](../img/pyplot/pyplot_example_15.png)
+
+### Annotations
+
+Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`
+
+```julia
+y = rand(10)
+plot(y,ann=(3,y[3],"this is #3"))
+annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")])
+```
+
+![](../img/pyplot/pyplot_example_20.png)
+
@@ -1,95 +1,158 @@
-### Lines
+# Examples for backend: qwt

-A simple line plot of the 3 columns.
+- Supported arguments: `annotation`, `args`, `axis`, `background_color`, `color`, `fillto`, `foreground_color`, `group`, `heatmap_c`, `kwargs`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `n`, `nbins`, `nc`, `nr`, `pos`, `reg`, `show`, `size`, `title`, `width`, `windowtitle`, `x`, `xlabel`, `y`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`, `:right`
+- Supported values for linetype: `:none`, `:line`, `:path`, `:steppre`, `:steppost`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot`
+- Supported values for marker: `:none`, `:auto`, `:rect`, `:ellipse`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`, `:star2`, `:hexagon`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize

 ```julia
-plot(rand(100,3))
+using Plots
+qwt()
 ```

-![](../img/qwt_example_1.png)
+### Lines
+
+A simple line plot of the columns.
+
+```julia
+plot(rand(50,5),w=3)
+```
+
+![](../img/qwt/qwt_example_1.png)

 ### Functions

-Plot multiple functions
+Plot multiple functions.  You can also put the function first.

 ```julia
 plot(0:0.01:4π,[sin,cos])
 ```

-![](../img/qwt_example_2.png)
+![](../img/qwt/qwt_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/qwt/qwt_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π,legend=false,fillto=0)
+```
+
+![](../img/qwt/qwt_example_4.png)

 ### Global

-Change the guides/background without a separate call.
+Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`

 ```julia
-plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+plot(rand(10),title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.2,0.2,0.2),xlim=(-3,13),yticks=0:0.1:1)
 ```

-![](../img/qwt_example_3.png)
+![](../img/qwt/qwt_example_5.png)

 ### Two-axis

-Use the `axis` or `axiss` arguments.
+Use the `axis` arguments.

-Note: This is only supported with Qwt right now
+Note: Currently only supported with Qwt and PyPlot

 ```julia
-plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right])
+plot(Vector[randn(100),randn(100) * 100]; axis=[:l,:r],ylabel="LEFT",yrightlabel="RIGHT")
 ```

-![](../img/qwt_example_4.png)
+![](../img/qwt/qwt_example_6.png)

 ### Vectors w/ pluralized args

-Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (marker/markersize) with arguments unique to each series (colors).

 ```julia
-plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,c=[:red,:blue])
 ```

-![](../img/qwt_example_5.png)
+![](../img/qwt/qwt_example_7.png)

 ### Build plot in pieces

 Start with a base plot...

 ```julia
-plot(rand(100) / 3; reg=true,fillto=0)
+plot(rand(100) / 3,reg=true,fillto=0)
 ```

-![](../img/qwt_example_6.png)
+![](../img/qwt/qwt_example_8.png)

 ### 

 and add to it later.

 ```julia
-scatter!(rand(100); markersize=6,color=:blue)
+scatter!(rand(100),markersize=6,c=:blue)
 ```

-![](../img/qwt_example_7.png)
+![](../img/qwt/qwt_example_9.png)

 ### Heatmaps



 ```julia
-heatmap(randn(10000),randn(10000); nbins=200)
+heatmap(randn(10000),randn(10000),nbins=100)
 ```

-![](../img/qwt_example_8.png)
+![](../img/qwt/qwt_example_10.png)
+
+### Line types

-### Lots of line types

-Options: (:line, :step, :stepinverted, :sticks, :dots, :none, :heatmap, :hexbin, :hist, :bar)  
-Note: some may not work with all backends

 ```julia
-plot(rand(20,4); linetypes=[:line,:step,:sticks,:dots])
+types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y,t=types,lab=map(string,types))
 ```

-![](../img/qwt_example_9.png)
+![](../img/qwt/qwt_example_11.png)
+
+### Line styles
+
+
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(cumsum(randn(20,length(styles)),1); style=:auto,label=map(string,styles),w=5)
+```
+
+![](../img/qwt/qwt_example_12.png)
+
+### Marker types
+
+
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+scatter(0.5:9.5,[fill(i - 0.5,10) for i = length(markers):-1:1]; marker=:auto,label=map(string,markers),ms=10)
+```
+
+![](../img/qwt/qwt_example_13.png)

 ### Bar

@@ -99,42 +162,40 @@ x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints
 bar(randn(1000))
 ```

-![](../img/qwt_example_10.png)
+![](../img/qwt/qwt_example_14.png)

 ### Histogram

-note: fillto isn't supported on all backends
+

 ```julia
-histogram(randn(1000); nbins=50,fillto=20)
+histogram(randn(1000),nbins=50)
 ```

-![](../img/qwt_example_11.png)
+![](../img/qwt/qwt_example_15.png)

 ### Subplots

  subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
  You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
-  number of columns `nc`), or you can set the layout directly with `layout`.  
-
-  Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
+  number of columns `nc`), or you can set the layout directly with `layout`.


 ```julia
-subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:dots,:step,:bar],nbins=10,legend=false)
+subplot(randn(100,5),layout=[1,1,3],t=[:line,:hist,:scatter,:step,:bar],nbins=10,leg=false)
 ```

-![](../img/qwt_example_12.png)
+![](../img/qwt/qwt_example_16.png)

 ### Adding to subplots

 Note here the automatic grid layout, as well as the order in which new series are added to the plots.

 ```julia
-subplot(randn(100,5); n=4)
+subplot(randn(100,5),n=4)
 ```

-![](../img/qwt_example_13.png)
+![](../img/qwt/qwt_example_17.png)

 ### 

@@ -144,5 +205,17 @@ subplot(randn(100,5); n=4)
 subplot!(randn(100,3))
 ```

-![](../img/qwt_example_14.png)
+![](../img/qwt/qwt_example_18.png)
+
+### Annotations
+
+Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`
+
+```julia
+y = rand(10)
+plot(y,ann=(3,y[3],"this is #3"))
+annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")])
+```
+
+![](../img/qwt/qwt_example_20.png)

@@ -0,0 +1,256 @@
+# Plots
+
+[![Build Status](https://travis-ci.org/tbreloff/Plots.jl.svg?branch=master)](https://travis-ci.org/tbreloff/Plots.jl)
+
+#### Author: Thomas Breloff (@tbreloff)
+
+Plots is a plotting interface and wrapper for several plotting packages.  My goals with the package are:
+
+- Simple.  The interface should be intuitive enough that someone coming from Matlab, Python, etc can immediately start generating complex plots without reading volumes of documentation.
+- Automatic (if you want).  There should be smart defaults for the most common functionality, and simple, high-level ways to override complex functionality.
+- Flexible.  You should be able to produce your favorite plot in your favorite package, but quicker and simpler.
+- Consistent.  Don't commit to one graphics package.  One command will switch your backend, and the exact same plotting commands will work with a very different underlying backend.
+
+Please add wishlist items, bugs, or any other comments/questions to the issues list.
+
+Check out the [summary graphs](img/supported/supported.md) for the features that each backend supports.
+
+## Examples for each implemented backend:
+
+- [Qwt.jl](docs/qwt_examples.md)
+- [Gadfly.jl](docs/gadfly_examples.md)
+- [UnicodePlots.jl](docs/unicodeplots_examples.md)
+- [PyPlot.jl](docs/pyplot_examples.md)
+- [Immerse.jl](docs/immerse_examples.md)
+- [Winston.jl](docs/winston_examples.md)
+
+## Installation
+
+First, add the package
+
+```julia
+Pkg.add("Plots")
+```
+
+then get any plotting packages you need (obviously, you should get at least one backend):
+
+```julia
+Pkg.add("Gadfly")
+Pkg.add("Immerse")
+Pkg.add("UnicodePlots")
+Pkg.add("PyPlot")                                    # requires python and matplotlib
+Pkg.clone("https://github.com/tbreloff/Qwt.jl.git")  # requires pyqt and pyqwt
+Pkg.add("Winston")
+```
+
+## Use
+
+Load it in.  The underlying plotting backends are not imported until `backend()` is called (which happens
+on your first call to `plot` or `subplot`).  This means that you don't need any backends to be installed when you call `using Plots`.
+Plots will try to figure out a good default backend for you automatically based on what backends are installed.
+
+```julia
+using Plots
+```
+
+Do a plot in Gadfly (inspired by [this example](http://gadflyjl.org/geom_point.html)), then save a png:
+
+```julia
+gadfly()        # switch to Gadfly as a backend
+dataframes()    # turn on support for DataFrames inputs
+
+# load some data
+using RDatasets
+iris = dataset("datasets", "iris");
+
+# This will bring up a browser window with the plot. Add a semicolon at the end to skip display. 
+scatter(iris, :SepalLength, :SepalWidth, group=:Species, ms=12, m=[:+,:d,:s])
+
+# save a png (equivalent to png("gadfly1.png") and savefig("gadfly1.png"))
+png("gadfly1")
+```
+
+![gadfly_plt](img/gadfly1.png)
+
+See the examples pages for lots of examples of plots, and what those commands produce for each supported backend.  
+Also check out the [IJulia notebooks](examples) and see how it works interactively.
+
+## API
+
+Call `backend(backend::Symbol)` or the shorthands (`gadfly()`, `qwt()`, `unicodeplots()`, etc) to set the current plotting backend.
+Subsequent commands are converted into the relevant plotting commands for that package:
+
+```julia
+gadfly()
+plot(1:10)    # this effectively calls `y = 1:10; Gadfly.plot(x=1:length(y), y=y)`
+qwt()
+plot(1:10)    # this effectively calls `Qwt.plot(1:10)`
+```
+
+Use `plot` to create a new plot object, and `plot!` to add to an existing one:
+
+```julia
+plot(args...; kw...)                  # creates a new plot window, and sets it to be the `current`
+plot!(args...; kw...)                 # adds to the `current`
+plot!(plotobj, args...; kw...)        # adds to the plot `plotobj`
+```
+
+Now that you know which plot object you're updating (new, current, or other), I'll leave it off for simplicity.
+There are many ways to pass in data to the plot functions... some examples:
+
+- Vector-like (subtypes of AbstractArray{T,1})
+- Matrix-like (subtypes of AbstractArray{T,2})
+- Vectors of Vectors
+- Functions
+- Vectors of Functions
+- DataFrames with column symbols (initialize with `dataframes()`)
+
+In general, you can pass in a `y` only, or an `x` and `y`, both of whatever type(s) you want, and Plots will slice up the data as needed.
+For matrices, data is split by columns.  For functions, data is mapped.  For DataFrames, a Symbol/Symbols in place of x/y will map to
+the relevant column(s).
+
+Here are some example usages... remember you can always use `plot!` to update an existing plot, and that, unless specified, you will update the `current()`.
+
+```julia
+plot()                                    # empty plot object
+plot(4)                                   # initialize with 4 empty series
+plot(rand(10))                            # plot 1 series... x = 1:10
+plot(rand(10,5))                          # plot 5 series... x = 1:10
+plot(rand(10), rand(10))                  # plot 1 series
+plot(rand(10,5), rand(10))                # plot 5 series... y is the same for all
+plot(sin, rand(10))                       # y = sin(x)
+plot(rand(10), sin)                       # same... y = sin(x)
+plot([sin,cos], 0:0.1:π)                  # plot 2 series, sin(x) and cos(x)
+plot([sin,cos], 0, π)                     # plot sin and cos on the range [0, π]
+plot(1:10, Any[rand(10), sin])            # plot 2 series, y = rand(10) for the first, y = sin(x) for the second... x = 1:10 for both
+plot(dataset("Ecdat", "Airline"), :Cost)  # plot from a DataFrame (call `dataframes()` first to import DataFrames and initialize)
+```
+
+You can update certain plot settings after plot creation (not supported on all backends):
+
+```julia
+plot!(title = "New Title", xlabel = "New xlabel", ylabel = "New ylabel")
+plot!(xlims = (0, 5.5), ylims = (-2.2, 6), xticks = 0:0.5:10, yticks = [0,1,5,10])
+```
+
+With `subplot`, create multiple plots at once, with flexible layout options:
+
+```julia
+y = rand(100,3)
+subplot(y; n = 3)             # create an automatic grid, and let it figure out the shape
+subplot(y; n = 3, nr = 1)     # create an automatic grid, but fix the number of rows
+subplot(y; n = 3, nc = 1)     # create an automatic grid, but fix the number of columns
+subplot(y; layout = [1, 2])   # explicit layout.  Lists the number of plots in each row
+```
+
+__Tip__: You can call `subplot!(args...; kw...)` to add to an existing subplot.
+
+__Tip__: Calling `subplot!` on a `Plot` object, or `plot!` on a `Subplot` object will throw an error.
+
+Shorthands:
+
+```julia
+scatter(args...; kw...)    = plot(args...; kw...,  linetype = :scatter)
+scatter!(args...; kw...)   = plot!(args...; kw..., linetype = :scatter)
+bar(args...; kw...)        = plot(args...; kw...,  linetype = :bar)
+bar!(args...; kw...)       = plot!(args...; kw..., linetype = :bar)
+histogram(args...; kw...)  = plot(args...; kw...,  linetype = :hist)
+histogram!(args...; kw...) = plot!(args...; kw..., linetype = :hist)
+heatmap(args...; kw...)    = plot(args...; kw...,  linetype = :heatmap)
+heatmap!(args...; kw...)   = plot!(args...; kw..., linetype = :heatmap)
+sticks(args...; kw...)     = plot(args...; kw...,  linetype = :sticks, marker = :ellipse)
+sticks!(args...; kw...)    = plot!(args...; kw..., linetype = :sticks, marker = :ellipse)
+hline(args...; kw...)      = plot(args...; kw...,  linetype = :hline)
+hline!(args...; kw...)     = plot!(args...; kw..., linetype = :hline)
+vline(args...; kw...)      = plot(args...; kw...,  linetype = :vline)
+vline!(args...; kw...)     = plot!(args...; kw..., linetype = :vline)
+ohlc(args...; kw...)       = plot(args...; kw...,  linetype = :ohlc)
+ohlc!(args...; kw...)      = plot!(args...; kw..., linetype = :ohlc)
+
+title!(s::AbstractString)                 = plot!(title = s)
+xlabel!(s::AbstractString)                = plot!(xlabel = s)
+ylabel!(s::AbstractString)                = plot!(ylabel = s)
+xlims!{T<:Real,S<:Real}(lims::Tuple{T,S}) = plot!(xlims = lims)
+ylims!{T<:Real,S<:Real}(lims::Tuple{T,S}) = plot!(ylims = lims)
+xticks!{T<:Real}(v::AVec{T})              = plot!(xticks = v)
+yticks!{T<:Real}(v::AVec{T})              = plot!(yticks = v)
+annotate!(anns)                           = plot!(annotation = anns)
+```
+
+Some keyword arguments you can set:
+
+[[KEYWORD_ARGS_TABLE]]
+
+Plot types:
+
+[[LINETYPES_TABLE]]
+
+Line styles:
+
+[[LINESTYLES_TABLE]]
+
+Markers:
+
+[[MARKERS_TABLE]]
+
+
+__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)` or `default(; kw...)`.  For example set the default window size and whether we should show a legend with `default(size=(600,400), leg=false)`.
+
+__Tip__: When plotting multiple lines, you can set all series to use the same value, or pass in an array to cycle through values.  Example:
+
+```julia
+plot(rand(100,4); color = [:red, RGB(0,0,1)],    # lines 1 and 3 are red, lines 2 and 4 are blue
+                  axis = :auto,                  # lines 1 and 3 are on the left axis, lines 2 and 4 are on the right
+                  width = 5)                     # all lines have a width of 5
+```
+
+__Tip__: Not all features are supported for each backend, but you can see what's supported by calling the functions: `supportedArgs()`, `supportedAxes()`, `supportedTypes()`, `supportedStyles()`, `supportedMarkers()`, `subplotSupported()`
+
+__Tip__: Call `gui()` to display the plot in a window.  Interactivity depends on backend.  Plotting at the REPL (without semicolon) implicitly calls `gui()`.
+
+## TODO features:
+
+- [x] Plot vectors/matrices/functions
+- [x] Plot DataFrames
+- [x] Grouping
+- [ ] Annotations
+- [ ] Scales
+- [ ] Categorical Inputs (strings, etc... for hist, bar? or can split one series into multiple?)
+- [ ] Custom markers
+- [ ] Special plots (boxplot, ohlc?)
+- [x] Subplots
+- [x] Histograms
+- [ ] 3D plotting
+- [ ] Scenes/Drawing
+- [ ] Graphs
+- [ ] Interactivity (GUIs)
+
+## TODO backends:
+
+- [x] Gadfly.jl
+- [x] Immerse.jl
+- [x] PyPlot.jl
+- [x] UnicodePlots.jl
+- [x] Qwt.jl
+- [x] Winston.jl
+- [ ] GLPlot.jl
+- [ ] Bokeh.jl
+- [ ] Vega.jl
+- [ ] Gaston.jl
+- [ ] Plotly.jl
+- [ ] GoogleCharts.jl
+- [ ] PLplot.jl
+- [ ] TextPlots.jl
+- [ ] ASCIIPlots.jl
+- [ ] Sparklines.jl
+- [ ] Hinton.jl
+- [ ] ImageTerm.jl
+- [ ] GraphViz.jl
+- [ ] TikzGraphs.jl
+- [ ] GraphLayout.jl
+
+## More information on backends (both supported and unsupported)
+
+See the wiki at: https://github.com/JuliaPlot/juliaplot_docs/wiki
+
+
@@ -0,0 +1,211 @@
+# Examples for backend: unicodeplots
+
+- Supported arguments: `args`, `axis`, `color`, `kwargs`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `size`, `title`, `width`, `windowtitle`, `xlabel`, `ylabel`, `yrightlabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:step`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`
+- Supported values for linestyle: `:auto`, `:solid`
+- Supported values for marker: `:none`, `:auto`, `:ellipse`
+- Is `subplot`/`subplot!` supported? Yes
+
+### Initialize
+
+```julia
+using Plots
+unicodeplots()
+```
+
+### Lines
+
+A simple line plot of the 3 columns.
+
+```julia
+plot(rand(100,3))
+```
+
+![](../img/unicodeplots/unicodeplots_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/unicodeplots/unicodeplots_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/unicodeplots/unicodeplots_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π)
+```
+
+![](../img/unicodeplots/unicodeplots_example_4.png)
+
+### Global
+
+Change the guides/background without a separate call.
+
+```julia
+plot(rand(10); title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.5,0.5,0.5))
+```
+
+![](../img/unicodeplots/unicodeplots_example_5.png)
+
+### Two-axis
+
+Use the `axis` or `axiss` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axiss=[:left,:right],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/unicodeplots/unicodeplots_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,colors=[:red,:blue])
+```
+
+![](../img/unicodeplots/unicodeplots_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3; reg=true,fillto=0)
+```
+
+![](../img/unicodeplots/unicodeplots_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100); markersize=6,color=:blue)
+```
+
+![](../img/unicodeplots/unicodeplots_example_9.png)
+
+### Heatmaps
+
+
+
+```julia
+heatmap(randn(10000),randn(10000); nbins=100)
+```
+
+![](../img/unicodeplots/unicodeplots_example_10.png)
+
+### Suported line types
+
+All options: (:line, :orderedline, :step, :stepinverted, :sticks, :scatter, :none, :heatmap, :hexbin, :hist, :bar)
+
+```julia
+types = intersect(supportedTypes(),[:line,:step,:stepinverted,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y; linetypes=types,labels=map(string,types))
+```
+
+![](../img/unicodeplots/unicodeplots_example_11.png)
+
+### Supported line styles
+
+All options: (:solid, :dash, :dot, :dashdot, :dashdotdot)
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(rand(20,length(styles)); linestyle=:auto,labels=map(string,styles))
+```
+
+![](../img/unicodeplots/unicodeplots_example_12.png)
+
+### Supported marker types
+
+All options: (:none, :auto, :ellipse, :rect, :diamond, :utriangle, :dtriangle, :cross, :xcross, :star1, :star2, :hexagon)
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+plot([fill(i,10) for i = 1:length(markers)]; marker=:auto,labels=map(string,markers),markersize=10)
+```
+
+![](../img/unicodeplots/unicodeplots_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/unicodeplots/unicodeplots_example_14.png)
+
+### Histogram
+
+note: fillto isn't supported on all backends
+
+```julia
+histogram(randn(1000); nbins=50,fillto=20)
+```
+
+![](../img/unicodeplots/unicodeplots_example_15.png)
+
+### Subplots
+
+  subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion.
+  You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or 
+  number of columns `nc`), or you can set the layout directly with `layout`.  
+
+  Note: Gadfly is not very friendly here, and although you can create a plot and save a PNG, I haven't been able to actually display it.
+
+
+```julia
+subplot(randn(100,5); layout=[1,1,3],linetypes=[:line,:hist,:scatter,:step,:bar],nbins=10,legend=false)
+```
+
+![](../img/unicodeplots/unicodeplots_example_16.png)
+
+### Adding to subplots
+
+Note here the automatic grid layout, as well as the order in which new series are added to the plots.
+
+```julia
+subplot(randn(100,5); n=4)
+```
+
+![](../img/unicodeplots/unicodeplots_example_17.png)
+
+### 
+
+
+
+```julia
+subplot!(randn(100,3))
+```
+
+![](../img/unicodeplots/unicodeplots_example_18.png)
+
@@ -0,0 +1,178 @@
+# Examples for backend: winston
+
+- Supported arguments: `annotation`, `color`, `fillto`, `group`, `label`, `legend`, `linestyle`, `linetype`, `marker`, `markercolor`, `markersize`, `nbins`, `reg`, `show`, `size`, `title`, `width`, `windowtitle`, `x`, `xlabel`, `y`, `ylabel`
+- Supported values for axis: `:auto`, `:left`
+- Supported values for linetype: `:none`, `:line`, `:path`, `:sticks`, `:scatter`, `:hist`, `:bar`
+- Supported values for linestyle: `:solid`, `:dash`, `:dot`, `:dashdot`
+- Supported values for marker: `:none`, `:ellipse`, `:rect`, `:diamond`, `:utriangle`, `:dtriangle`, `:cross`, `:xcross`, `:star1`
+- Is `subplot`/`subplot!` supported? No
+
+### Initialize
+
+```julia
+using Plots
+winston()
+```
+
+### Lines
+
+A simple line plot of the columns.
+
+```julia
+plot(rand(50,5),w=3)
+```
+
+![](../img/winston/winston_example_1.png)
+
+### Functions
+
+Plot multiple functions.  You can also put the function first.
+
+```julia
+plot(0:0.01:4π,[sin,cos])
+```
+
+![](../img/winston/winston_example_2.png)
+
+### 
+
+You can also call it with plot(f, xmin, xmax).
+
+```julia
+plot([sin,cos],0,4π)
+```
+
+![](../img/winston/winston_example_3.png)
+
+### 
+
+Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax).
+
+```julia
+plot(sin,(x->begin  # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 33:
+            sin(2x)
+        end),0,2π,legend=false,fillto=0)
+```
+
+![](../img/winston/winston_example_4.png)
+
+### Global
+
+Change the guides/background/limits/ticks.  You can also use shorthand functions: `title!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!`
+
+```julia
+plot(rand(10),title="TITLE",xlabel="XLABEL",ylabel="YLABEL",background_color=RGB(0.2,0.2,0.2),xlim=(-3,13),yticks=0:0.1:1)
+```
+
+![](../img/winston/winston_example_5.png)
+
+### Two-axis
+
+Use the `axis` arguments.
+
+Note: Currently only supported with Qwt and PyPlot
+
+```julia
+plot(Vector[randn(100),randn(100) * 100]; axis=[:l,:r],ylabel="LEFT",yrightlabel="RIGHT")
+```
+
+![](../img/winston/winston_example_6.png)
+
+### Vectors w/ pluralized args
+
+Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).
+
+```julia
+plot(Vector[rand(10),rand(20)]; marker=:ellipse,markersize=8,c=[:red,:blue])
+```
+
+![](../img/winston/winston_example_7.png)
+
+### Build plot in pieces
+
+Start with a base plot...
+
+```julia
+plot(rand(100) / 3,reg=true,fillto=0)
+```
+
+![](../img/winston/winston_example_8.png)
+
+### 
+
+and add to it later.
+
+```julia
+scatter!(rand(100),markersize=6,c=:blue)
+```
+
+![](../img/winston/winston_example_9.png)
+
+### Line types
+
+
+
+```julia
+types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])
+n = length(types)
+x = Vector[sort(rand(20)) for i = 1:n]
+y = rand(20,n)
+plot(x,y,t=types,lab=map(string,types))
+```
+
+![](../img/winston/winston_example_11.png)
+
+### Line styles
+
+
+
+```julia
+styles = setdiff(supportedStyles(),[:auto])
+plot(cumsum(randn(20,length(styles)),1); style=:auto,label=map(string,styles),w=5)
+```
+
+![](../img/winston/winston_example_12.png)
+
+### Marker types
+
+
+
+```julia
+markers = setdiff(supportedMarkers(),[:none,:auto])
+scatter(0.5:9.5,[fill(i - 0.5,10) for i = length(markers):-1:1]; marker=:auto,label=map(string,markers),ms=10)
+```
+
+![](../img/winston/winston_example_13.png)
+
+### Bar
+
+x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints)
+
+```julia
+bar(randn(1000))
+```
+
+![](../img/winston/winston_example_14.png)
+
+### Histogram
+
+
+
+```julia
+histogram(randn(1000),nbins=50)
+```
+
+![](../img/winston/winston_example_15.png)
+
+### Annotations
+
+Currently only text annotations are supported.  Pass in a tuple or vector-of-tuples: (x,y,text).  `annotate!(ann)` is shorthand for `plot!(; annotation=ann)`
+
+```julia
+y = rand(10)
+plot(y,ann=(3,y[3],"this is #3"))
+annotate!([(5,y[5],"this is #5"),(9,y[10],"this is #10")])
+```
+
+![](../img/winston/winston_example_20.png)
+
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Thomas Breloff	3fc5f87388	added better error for Winston output_surface	2015-10-04 09:41:42 -05:00
Thomas Breloff	623ca1effc	winston log10 scale	2015-10-03 17:18:58 -05:00
Thomas Breloff	da05e7fe5e	qwt log10 scale	2015-10-03 17:03:13 -05:00
Thomas Breloff	f3734d4c64	added pyplot scales	2015-10-03 09:46:02 -05:00
Thomas Breloff	9ab458e109	switched gadfly heatmap to Geom.histogram2d	2015-10-01 12:55:05 -05:00
Thomas Breloff	d4c72e6f78	gadfly ribbon	2015-09-30 10:36:00 -04:00
Thomas Breloff	1f58ef5140	don't error on savefig without an ext, use default; closes #32	2015-09-30 09:55:07 -04:00
Thomas Breloff	69d574c587	added scales globally and to gadfly/immerse	2015-09-30 09:18:16 -04:00
Thomas Breloff	a027fdded7	autoload dataframes	2015-09-29 14:40:11 -04:00
Thomas Breloff	443df0501d	supported graphs	2015-09-29 14:27:18 -04:00
Thomas Breloff	d68fe5f80d	supported readme	2015-09-29 14:14:13 -04:00
Thomas Breloff	ebf868bae3	supported readme	2015-09-29 14:13:46 -04:00
Thomas Breloff	8a9b3286e9	supportedGraphs utils and pngs; removed args/kwargs from defaults	2015-09-29 14:05:24 -04:00
Thomas Breloff	a0455561b6	unicode hline/vline; supportGraph utils	2015-09-29 13:46:31 -04:00
Thomas Breloff	518ccf5a74	pyplot hline/vline	2015-09-29 12:20:58 -04:00
Thomas Breloff	54f09c58cb	unicodeplots lims	2015-09-29 12:00:48 -04:00
Thomas Breloff	029ad1045a	qwt lims/ticks	2015-09-29 11:50:02 -04:00
Thomas Breloff	2f55fb4d84	winston lims	2015-09-29 10:40:46 -04:00
Thomas Breloff	add724eee9	working on gadfly ticks	2015-09-29 09:50:53 -04:00
Thomas Breloff	07324ae892	working on gadfly ticks	2015-09-29 09:49:58 -04:00
Thomas Breloff	ffc05e971f	working on ticks	2015-09-28 23:49:03 -04:00
Thomas Breloff	30f42fd1d4	added lims/ticks for pyplot	2015-09-28 22:49:46 -04:00
Thomas Breloff	f284857438	added qwt hline/vline; working on setTicksFromStringVector	2015-09-28 17:56:32 -04:00
Thomas Breloff	06ab514472	qwt annotations and examples	2015-09-28 17:11:43 -04:00
Thomas Breloff	85b65acbe0	readme	2015-09-28 16:48:32 -04:00
Thomas Breloff	4d1d9de22f	gitignore	2015-09-28 16:43:04 -04:00
Thomas Breloff	a68ec9b191	savefig and png	2015-09-28 16:42:02 -04:00
Thomas Breloff	e386636d66	readme	2015-09-28 16:01:48 -04:00
Thomas Breloff	cc3311b8eb	examples	2015-09-28 15:49:46 -04:00
Thomas Breloff	d3d1181769	examples and readme	2015-09-28 15:44:50 -04:00
Thomas Breloff	001abf684c	examples	2015-09-28 15:35:45 -04:00
Thomas Breloff	92a65296b5	redid supportedArgs	2015-09-28 15:21:45 -04:00
Thomas Breloff	3a7887d003	working on massive naming overhaul and fixes	2015-09-28 14:58:56 -04:00
Thomas Breloff	3334c4a87a	winston annotations	2015-09-28 12:52:44 -04:00
Thomas Breloff	228ce768e0	pyplot annotations and ioff fix	2015-09-28 12:09:52 -04:00
Thomas Breloff	eafc1a784c	working on annotations	2015-09-28 11:09:45 -04:00
Thomas Breloff	fd3a4d0a0e	working on annotations	2015-09-28 10:46:53 -04:00
Thomas Breloff	77d679b63b	working on handling string input data	2015-09-27 23:46:42 -04:00
Thomas Breloff	730d764c6e	gadfly color group	2015-09-25 17:03:57 -04:00
Thomas Breloff	6f1ef82e89	gadfly color groups for line segments	2015-09-25 16:47:17 -04:00
Thomas Breloff	d4da910f19	call Gadfly.get_stroke_vector; added getindex/setindex to qwt	2015-09-25 13:33:06 -04:00
Thomas Breloff	a0a0773bd2	fix push warning	2015-09-25 09:42:16 -04:00
Thomas Breloff	9ce8d138d5	working on data updating and notebooks	2015-09-25 01:00:22 -04:00
Thomas Breloff	0041b034e0	working on various things	2015-09-24 16:47:30 -04:00
Thomas Breloff	d781c437de	started real time updates; fixes #29 (pyplot ijulia display)	2015-09-24 13:01:31 -04:00
Thomas Breloff	2fe21b8547	fixes, gadfly star shape, readme example	2015-09-24 00:35:18 -04:00
Thomas Breloff	dbc90c9417	working on groups and iris notebook	2015-09-23 23:34:54 -04:00
Thomas Breloff	431d60a58a	working on groups and iris notebook	2015-09-23 23:15:15 -04:00
Thomas Breloff	fcfcc9a94a	working on groups and iris notebook	2015-09-23 17:13:20 -04:00
Thomas Breloff	870fb4e2df	working on groups and iris notebook	2015-09-23 17:12:26 -04:00
Thomas Breloff	e3612b973f	working on groups and iris notebook	2015-09-23 16:48:49 -04:00
Thomas Breloff	75f4ca928f	working on auto-labels from dataframes meta info, and started group arg	2015-09-23 15:34:42 -04:00
Thomas Breloff	22fd25b30f	readme	2015-09-23 13:36:51 -04:00
Thomas Breloff	610ddb09ff	readme and cleanup	2015-09-23 13:33:12 -04:00
Thomas Breloff	33602aca11	fixed tests	2015-09-23 13:03:37 -04:00
Thomas Breloff	a207856e99	lims/ticks for gadfly/immerse	2015-09-23 12:45:24 -04:00
Thomas Breloff	80e8b5b5e4	fixes	2015-09-23 11:35:08 -04:00
Thomas Breloff	273996aa91	working on ticks/lims	2015-09-23 00:14:32 -04:00
Thomas Breloff	646b88c5be	working on ticks	2015-09-22 23:30:20 -04:00
Thomas Breloff	88cfd82a25	unicodeplots fixes	2015-09-22 17:19:37 -04:00
Thomas Breloff	2f8436be87	winston examples	2015-09-22 17:04:51 -04:00
Thomas Breloff	a6237cdda3	qwt examples	2015-09-22 17:02:19 -04:00
Thomas Breloff	eb93a767fc	pyplot fixes and examples	2015-09-22 16:57:23 -04:00
Thomas Breloff	41852412ca	gadfly/immerse fixes and examples	2015-09-22 16:46:54 -04:00
Thomas Breloff	224b2b7323	various fixes; readme	2015-09-22 16:30:40 -04:00
Thomas Breloff	ec939f9f9a	more display fun	2015-09-22 14:56:37 -04:00
Thomas Breloff	eced15b712	working on display/writemime overhaul	2015-09-22 12:54:55 -04:00
Thomas Breloff	f8fb473981	reexport Colors; move default backend choice into __init__; fixed pickDefaultBackend	2015-09-22 08:10:30 -04:00
Thomas Breloff	f2bcb77cfb	trying fgcolor gadfly	2015-09-22 00:04:35 -04:00
Thomas Breloff	dc5da28176	initial dataframes support	2015-09-21 23:36:07 -04:00
Thomas Breloff	be43e64743	foreground_color fixes and added support in pyplot	2015-09-21 23:04:37 -04:00
Thomas Breloff	454630dace	qwt fixes	2015-09-21 22:14:59 -04:00
Thomas Breloff	c9df244333	qwt fixes	2015-09-21 17:38:27 -04:00
Thomas Breloff	2649d97d69	readme	2015-09-21 17:31:36 -04:00
Thomas Breloff	bcb9ac5501	readme	2015-09-21 17:29:51 -04:00
Thomas Breloff	76d1e26f7d	readme	2015-09-21 17:04:20 -04:00
Thomas Breloff	ba13ab9926	readme	2015-09-21 16:59:15 -04:00
Thomas Breloff	c43b34b67f	auto-generated readme	2015-09-21 16:49:45 -04:00
Thomas Breloff	3739c2881b	fixed linetype aliases; for qwt as well	2015-09-21 16:18:58 -04:00
Thomas Breloff	bc13b81351	working on readme_template; added path linetype and sorting logic for line	2015-09-21 16:03:59 -04:00
Thomas Breloff	86a56e487a	working on aliases	2015-09-21 14:38:03 -04:00
Thomas Breloff	031058cd0c	cleanup and renaming constants	2015-09-21 12:15:40 -04:00
Thomas Breloff	85040d6104	fix creating empty plot with plot()	2015-09-21 12:05:17 -04:00
Thomas Breloff	efbf74b44c	working on auto generated color palette	2015-09-21 11:45:37 -04:00
Thomas Breloff	774fc42e8e	replaced creation of kw args	2015-09-20 23:48:45 -04:00
Thomas Breloff	692cfe4f52	added srand calls to tests and examples	2015-09-20 22:59:25 -04:00
Thomas Breloff	8b34d4417b	gadfly display size and fix: check for line_style	2015-09-20 21:12:56 -04:00
Thomas Breloff	c20a7b3c69	added fillto for gadfly/immerse	2015-09-19 17:23:18 -04:00
Thomas Breloff	ff6e83c55e	working on new plot logic	2015-09-19 14:39:25 -04:00
Thomas Breloff	6aa56fd30f	fixed subplot bug	2015-09-19 00:38:50 -04:00
Thomas Breloff	f5a6f129dd	foreground_color	2015-09-19 00:05:24 -04:00
Thomas Breloff	5405c1d240	working on colors	2015-09-18 17:20:35 -04:00
Thomas Breloff	455f85e230	working on colors, args	2015-09-18 16:53:43 -04:00
Thomas Breloff	fa899a67a7	added support for gadfly linestyles... depends on gadfly PR 695	2015-09-18 12:26:18 -04:00
Thomas Breloff	56cf25eebf	gadfly shapes	2015-09-18 01:55:16 -04:00
Thomas Breloff	1a490551e6	working on arg aliases and reorg	2015-09-18 01:48:00 -04:00
Thomas Breloff	4514802e35	replacing String with AbstractString	2015-09-17 21:32:27 -04:00
Thomas Breloff	a9062b0611	examples	2015-09-17 17:11:25 -04:00
Thomas Breloff	eb6b30aab1	markers, fixes, and rerun examples	2015-09-17 17:05:08 -04:00
Thomas Breloff	922abd7ad3	examples	2015-09-17 16:21:13 -04:00
Thomas Breloff	c4596dda75	more shape fun... completed gadfly's set	2015-09-17 16:18:48 -04:00
Thomas Breloff	168b77326b	fixing markers	2015-09-17 15:44:01 -04:00
Thomas Breloff	f674bba861	added gadfly shapes utriangle, dtriangle, and xcross	2015-09-17 15:28:54 -04:00
Thomas Breloff	6b2e65e738	ohlc example	2015-09-17 14:49:37 -04:00
Thomas Breloff	51021c799d	accept vectors of tuples; implement ohlc for gadfly with an example	2015-09-17 14:44:29 -04:00
Thomas Breloff	01cb036976	added fillto support for winston	2015-09-17 11:26:26 -04:00
Thomas Breloff	ea7867429f	added hline/vline support in gadfly	2015-09-17 10:14:13 -04:00
Thomas Breloff	c5300cd7be	notes	2015-09-17 08:32:32 -04:00
Thomas Breloff	ea34c7d226	working on winston and examples	2015-09-16 17:17:05 -04:00
Thomas Breloff	537e04989f	working on winston	2015-09-16 16:34:40 -04:00
Thomas Breloff	d447c5dc25	moved exports into backend files	2015-09-16 15:11:44 -04:00
Thomas Breloff	73944fc9bf	first draft winston	2015-09-16 15:08:50 -04:00
Thomas Breloff	01e994e0f1	regenerate markdown	2015-09-16 14:32:36 -04:00
Thomas Breloff	af3f3f436c	improving markdown	2015-09-16 14:24:58 -04:00
Thomas Breloff	56e90a266a	examples	2015-09-16 14:16:58 -04:00
Thomas Breloff	1fc59ed522	fix ALL_ARGS; unicodeplots examples	2015-09-16 14:01:53 -04:00
Thomas Breloff	3a3b1a6c17	examples	2015-09-16 13:40:23 -04:00
Thomas Breloff	242ce807df	examples	2015-09-16 13:32:43 -04:00
Thomas Breloff	734967152c	fixed suppported typo	2015-09-16 13:29:51 -04:00
Thomas Breloff	8023e15bb9	examples	2015-09-16 13:17:06 -04:00
Thomas Breloff	ceb58a6fe1	supported functions; renamed a few things package to backend	2015-09-16 13:03:37 -04:00
Thomas Breloff	ae48bd1abb	working on big set of fixes/reorg; better example code, supportedArgs and subplotSupported, change dots to scatter and handle better	2015-09-16 12:07:08 -04:00
Thomas Breloff	d27fe2fbad	examples	2015-09-16 01:47:17 -04:00
Thomas Breloff	970686efaf	supported functions and gadfly shapes	2015-09-16 01:42:47 -04:00
Thomas Breloff	8df46ec0e9	gadfly_shapes.jl	2015-09-16 00:25:51 -04:00
Thomas Breloff	864057a6ed	unicode examples	2015-09-16 00:12:14 -04:00
Thomas Breloff	92ca4cb1d1	examples	2015-09-16 00:01:38 -04:00
Thomas Breloff	aabf811fe7	working on Immerse subplot support	2015-09-15 23:27:00 -04:00
Thomas Breloff	9b0a645a05	working on immerse subplot window	2015-09-15 17:54:40 -04:00
Thomas Breloff	24b5e7ff09	pushtomaster	2015-09-15 17:11:36 -04:00
Thomas Breloff	48969ecee3	added sticks and sticksHack for Gadfly	2015-09-15 16:49:56 -04:00
Thomas Breloff	6ae0912e0e	readme	2015-09-15 13:24:14 -04:00
Thomas Breloff	e8062d544d	readme	2015-09-15 13:18:49 -04:00
Thomas Breloff	07332aa4ac	readme	2015-09-15 13:16:19 -04:00
Thomas Breloff	1e2b3559f2	gadfly marker fixes and examples	2015-09-15 13:08:04 -04:00
Thomas Breloff	8bfaa14edb	added backend template	2015-09-15 10:03:56 -04:00
Thomas Breloff	d4e87d3fe8	working on gadfly and immerse	2015-09-14 23:44:28 -04:00
Thomas Breloff	460348c0b6	working on gadfly and immerse	2015-09-14 23:28:47 -04:00
Thomas Breloff	264e8c735e	working on gadfly markers	2015-09-14 17:27:37 -04:00
Thomas Breloff	c4b04e2327	immerse final fixes and examples	2015-09-14 15:30:09 -04:00
Thomas Breloff	dc1389bd1a	working on immerse	2015-09-14 15:24:18 -04:00
Thomas Breloff	51e38c80d8	working on immerse	2015-09-14 15:08:25 -04:00
Thomas Breloff	a33f5fabd1	working on immerse	2015-09-14 14:41:13 -04:00
Thomas Breloff	e6c8344970	working on immerse	2015-09-14 13:44:58 -04:00
Thomas Breloff	2207ae6617	working on immerse	2015-09-14 12:35:24 -04:00
Thomas Breloff	cdc6707ad3	pyplot bg color	2015-09-14 10:46:33 -04:00
Thomas Breloff	448fdaecbd	readme	2015-09-14 00:45:55 -04:00
Thomas Breloff	4aa79aed6f	readme	2015-09-14 00:45:00 -04:00
Thomas Breloff	c8fcc373f8	examples and readme	2015-09-14 00:28:08 -04:00
Thomas Breloff	1410141b46	examples	2015-09-14 00:16:24 -04:00
Thomas Breloff	76efabb5f3	heatmaps, fixes	2015-09-14 00:15:51 -04:00
Thomas Breloff	36effc6dc4	working on pyplot	2015-09-13 22:20:15 -04:00
Thomas Breloff	8d5412a38f	working on pyplot	2015-09-13 21:34:28 -04:00
Thomas Breloff	465b5d20b4	working on pyplot	2015-09-13 18:39:56 -04:00
Thomas Breloff	60a22b1897	working on pyplot	2015-09-13 17:02:03 -04:00
Thomas Breloff	09a685e977	gitignore	2015-09-13 16:36:32 -04:00
Thomas Breloff	31da90865c	added args and kwargs to PLOT_DEFAULTS	2015-09-13 14:06:33 -04:00
Thomas Breloff	9ea98bcb56	readme	2015-09-12 22:54:16 -04:00
Thomas Breloff	4f9804d24e	readme	2015-09-12 22:48:07 -04:00
Thomas Breloff	0a88518188	readme	2015-09-12 22:38:56 -04:00
Thomas Breloff	ccae6373be	readme	2015-09-12 22:31:05 -04:00
Thomas Breloff	31e5d07a45	readme	2015-09-12 22:24:44 -04:00
Thomas Breloff	056fee4b28	added parametric plot with example	2015-09-12 22:02:17 -04:00
Thomas Breloff	5a47864d73	readme	2015-09-12 21:46:30 -04:00
Thomas Breloff	1c7da432f1	readme	2015-09-12 21:40:25 -04:00
Thomas Breloff	3d3ceacaab	pickDefaultBackend with warning; readme improvements	2015-09-12 21:33:38 -04:00
Thomas Breloff	35df39a44b	readme and shorthands for switching plotters	2015-09-12 21:12:18 -04:00
Thomas Breloff	c23d6d62e7	examples, fixes, and reorg img dir	2015-09-12 20:47:09 -04:00
Thomas Breloff	243d4a7ac3	working on unicodeplots savepng and examples	2015-09-12 20:28:40 -04:00
Thomas Breloff	50254d06d7	working on unicodeplots savepng and examples	2015-09-12 20:23:36 -04:00
Thomas Breloff	475b46f516	working on unicodeplots	2015-09-12 16:49:02 -04:00
Thomas Breloff	f4573f7e87	added unicodeplots to examples	2015-09-12 16:37:34 -04:00
Thomas Breloff	7fb1a4ec0f	better error when importing a package that is not installed; xmin/xmax functions example	2015-09-12 16:10:42 -04:00
Thomas Breloff	4299aa0ff8	more ways to plot Funtions	2015-09-12 15:59:45 -04:00
Thomas Breloff	4eb7e3810e	unicodeplots	2015-09-12 14:58:15 -04:00
Thomas Breloff	3e7e7e9ac0	working on unicodeplots	2015-09-12 00:57:58 -04:00
Thomas Breloff	9e1058ec0a	working on unicodeplots	2015-09-12 00:54:41 -04:00
Thomas Breloff	426a9eb6d3	working on unicodeplots	2015-09-12 00:31:48 -04:00
Thomas Breloff	f322b9ac1c	working on unicodeplots; added args to Plot; some reorg	2015-09-12 00:24:35 -04:00
Thomas Breloff	e13fec08ca	readme	2015-09-11 22:12:33 -04:00