TextPlot

Data types

type Function = Double -> Double

A function of one variable (x -> y).

type Range = (Double, Double)

Range of values (from, to).

class Plot a

Any kind of of plot.

Minimal complete definition

draw

Instances

Plot PolarPlot

Plot ParamXYPlot

Plot XYPlot

class Plot plot => EditPlot plot function | plot -> function where

A type class with functional dependency to allow the same editing operations across all plot types.

Methods

thenPlot

Arguments

:: plot

-> function

-> plot

add another function to the plot

xlim

Arguments

:: plot

-> Range

-> plot

set limits of the abscissa (x) axis

ylim

Arguments

:: plot

-> Range

-> plot

set limits of the ordinate (y) axis

Instances

EditPlot PolarPlot PolarFunction

EditPlot ParamXYPlot ParamFunction

EditPlot XYPlot Function

(.+) :: EditPlot p f => p -> f -> p

Shortcut to thenPlot. Mnemonics: plus to add another function.

(.-) :: EditPlot p f => p -> Range -> p

Shortcut to xlim. Mnemonics: horizontal bar followed by horizontal range.

(.|) :: EditPlot p f => p -> Range -> p

Shortcut to ylim. Mnemonics: vertical bar followed by vertical range.

Plot types

data XYPlot

Plot one or more functions (x -> y) in Cartesian coordinates.

Constructors

XYPlot

Fields

fp'xlim :: Range

limits of the abscissa (x) axis

fp'ylim :: Range

limits of the ordinate (y) axis

fp'functions :: [Function]

functions to plot

Instances

Show XYPlot

Plot XYPlot

EditPlot XYPlot Function

emptyXYPlot :: XYPlot

A default empty XYPlot with bounds of a unit square.

data ParamXYPlot

Plot one or more parametric functions in Cartesian coordiantes.

Constructors

ParamXYPlot

Fields

param'xlim :: Range

limits of the abscissa (x) axis

param'ylim :: Range

limits of the ordinate (y) axis

param'functions :: [ParamFunction]

functions to plot

Instances

Show ParamXYPlot

Plot ParamXYPlot

EditPlot ParamXYPlot ParamFunction

data ParamFunction

Constructors

ParamFunction

Fields

xfun :: Function

the first parametrized variable (t -> x)

yfun :: Function

the second parametrized variable (t -> y)

tlim :: Range

range of the free parameter t

Instances

Show ParamFunction

EditPlot ParamXYPlot ParamFunction

emptyParamXYPlot :: ParamXYPlot

A default empty ParamXYPlot

data PolarPlot

Plot one or more functions in polar coordinates.

Constructors

PolarPlot

Fields

polar'xlim :: Range

limits of the abscissa (x) axis

polar'ylim :: Range

limits of the ordinate (y) axis

polar'functions :: [PolarFunction]

functions to plot

Instances

Show PolarPlot

Plot PolarPlot

EditPlot PolarPlot PolarFunction

data PolarFunction

Constructors

PolarFunction

Fields

rfun :: Function

radius as a function of angle phi (phi -> r)

philim :: (Double, Double)

range of the angle argument phi

Instances

Show PolarFunction

EditPlot PolarPlot PolarFunction

emptyPolarPlot :: PolarPlot

A default empty PolarPlot

Screen representation

data PlotConfig

Constructors

PlotConfig

Fields

c'width :: Int

plot width in characters

c'height :: Int

plot height in characters

c'samples :: Int

samples per line

c'showAxes :: Bool

draw axes or not

Instances

Eq PlotConfig

Show PlotConfig

defaultConfig :: PlotConfig

Default plot dimensions, suitable for 80x24 terminals.

Output

plot :: Plot p => p -> String

Convert a plot to a multiline String with default configuration

plotWithConfig :: Plot p => PlotConfig -> p -> String

Convert a plot to multiline String with custom configuration

printPlot :: Plot p => p -> IO ()

Print a plot with default configuration

Example

Plot a mexican hat wavelet function:

ghci> let hat t = 0.5*(1-t**2)*exp(-0.5*t**2)/(sqrt (3*(sqrt pi)))
ghci> let plot = emptyXYPlot .+ hat .- (-5,5) .| (-0.125,0.25)
ghci> printPlot plot
       ^
  0.25 +
       |
       |                             ooo
       |                            o   o
       |
       |                           o     o
       |
       |
       |                          o       o
       |
       |                         o         o
       |
       |
       |oooooooooooo            o           o            ooooooooooo
       |            oo                                 oo
       |              oo       o             o       oo
       |                o     o               o     o
       |                 ooo o                 o ooo
       |                    o                   o
-0.125 +
        +-----------------------------------------------------------+->
        -5.0                                                      5.0

A parametric plot:

ghci> let circle = ParamFunction sin cos (0,2*pi)
ghci> let paramplot = emptyParamXYPlot `thenPlot` circle `xlim` (-1.1,1.1) `ylim` (-1.1,1.1)
ghci> printPlot paramplot
     ^
 1.1 +
     |                    ooooooooooooooooooooo
     |              ooooooo                   ooooooo
     |           oooo                               oooo
     |        ooo                                       ooo
     |      ooo                                           ooo
     |     oo                                               oo
     |    o                                                   o
     |   o                                                     o
     |   o                                                     o
     |   o                                                     o
     |   o                                                     o
     |    o                                                   o
     |     oo                                               oo
     |      oo                                             oo
     |        ooo                                       ooo
     |          ooooo                               ooooo
     |               ooooo                     ooooo
     |                    ooooooooooooooooooooo
-1.1 +
      +-----------------------------------------------------------+->
      -1.1                                                      1.1