A product type consisting of a Style, which is the stylistic manifestation of chart data, and ChartData representing where data is located on the chart canvas (an xy-plane).

A simple example is:

>>> Chart defaultRectStyle (RectData [one])
Chart {chartStyle = Style {size = 6.0e-2, borderSize = 1.0e-2, color = Colour 0.02 0.73 0.80 0.10, borderColor = Colour 0.02 0.29 0.48 1.00, scaleP = NoScaleP, textAnchor = AnchorMiddle, rotation = Nothing, translate = Nothing, escapeText = EscapeText, frame = Nothing, lineCap = Nothing, lineJoin = Nothing, dasharray = Nothing, dashoffset = Nothing, hsize = 0.6, vsize = 1.1, vshift = -0.25, glyphShape = SquareGlyph}, chartData = RectData [Rect (-0.5) 0.5 (-0.5) 0.5]}

Using the defaults, this chart is rendered as:

writeChartOptions "other/unit.hs" $ mempty & #hudOptions .~ defaultHudOptions & #chartTree .~ unnamed [r]

Data of a Chart

A sum type representing the data behind six different types of chart:

• RectData: a list of rectangles in the XY-domain. For example, a Rect 0 1 0 1 is the set of points on the XY Plane bounded by (0,0), (0,1), (1,0) & (1,1). Much of the library is built on Rect Doubles.
• LineData: a list of (list of points) which represent connected straight lines. [Point 0 0, Point 1 1, Point 2 2, Point 3 3] is an example; three lines connected up to form a line from (0,0) to (3,3).
• GlyphData: a list of points to draw a GlyphShape.
• TextData: A list of Text,Point tuples representing text centered at a Point in XY space.
• ChartData: specification of curvilinear paths using the SVG standards.
• BlankData: a rectangular space that has no visual representation.

RectData partial lens

LineData partial lens

GlyphData partial lens

TextData partial lens

PathData partial lens

BlankData partial lens

pattern of a Chart with RectData

pattern of a Chart with LineData

pattern of a Chart with GlyphData

pattern of a Chart with TextData

pattern of a Chart with PathData

pattern of a Chart with BlankData

pattern of a Chart with a singleton LineData

Create a blank Chart with a single Rect

A group of charts represented by a Tree of chart lists with labelled branches. The labelling is particularly useful downstream, when groupings become grouped SVG elements with classes or ids.

Lens between ChartTree and the underlying Tree representation

A traversal of each chart in a tree.

A traversal of each chart list in a tree.

Convert a chart list to a tree, adding a specific text label.

Convert a chart list to a tree, with no text label.

Rename a ChartTree, removing descendent names

Rename a top-level label in a tree.

A tree with no charts and no label.

Group a list of trees into a new tree.

Apply a filter to a ChartTree

Verticle or Horizontal

Whether to stack chart data

The basis for the x-y ratio of a chart

Default style features tend towards assuming that the usual height of the overall svg image is around 1, and ChartAspect is based on this assumption, so that a ChartAspect of FixedAspect 1.5, say, means a height of 1 and a width of 1.5.

The Rect which encloses the data elements of the chart. Bounding box is a synonym.

>>> box (chartData r)
Just Rect (-0.5) 0.5 (-0.5) 0.5

The bounding box for a chart including both data and style elements.

>>> sbox r
Just Rect (-0.505) 0.505 (-0.505) 0.505

In the above example, the border of the rectangle adds an extra 0.1 to the height and width of the bounding box enclosing the chart.

projects a Chart to a new space from an old rectangular space, preserving linear metric structure.

>>> projectWith (fmap (2*) one) one r
Chart {chartStyle = Style {size = 6.0e-2, borderSize = 1.0e-2, color = Colour 0.02 0.73 0.80 0.10, borderColor = Colour 0.02 0.29 0.48 1.00, scaleP = NoScaleP, textAnchor = AnchorMiddle, rotation = Nothing, translate = Nothing, escapeText = EscapeText, frame = Nothing, lineCap = Nothing, lineJoin = Nothing, dasharray = Nothing, dashoffset = Nothing, hsize = 0.6, vsize = 1.1, vshift = -0.25, glyphShape = SquareGlyph}, chartData = RectData [Rect (-1.0) 1.0 (-1.0) 1.0]}

Projects ChartData from an old space to a new space.

Move ChartData by a Point

Move a chart.

Scale a chart (effecting both the chart data and the style, if #style % #scaleP is a scaling value).

Scale ChartData

Modify chart colors, applying to both border and main colors.

Project a chart tree to a new bounding box, guarding against singleton bounds.

Compute the bounding box of a list of charts, not including style allowances.

Lens between a ChartTree and its bounding box.

Compute the bounding box of the data and style elements contained in a list of charts.

Lens between a style bounding box and a ChartTree tree.

Note that a round trip may be only approximately isomorphic ie

forall c r. \c -> view styleBox' . set styleBox' r c ~= r

Getter of a ChartTree bounding box, excluding style, with singleton dimension guards, defaulting to one:

Getter of a ChartTree bounding box, including style, with singleton dimension guards, defaulting to one:

Vertically stack a list of trees (proceeding upwards), at the supplied Align and with the supplied gap intercalated.

Horizontally stack a list of trees (proceeding to the right), at the supplied Align and with the supplied gap intercalated.

Stack a list of tree charts horizontally, then vertically (proceeding downwards which is opposite to the usual coordinate reference system but intuitively the way people read charts)

Place a ChartTree beside a Rect.

Create a frame over some charts with (additive) padding.

>>> frameChart defaultRectStyle 0.1 (unnamed [BlankChart defaultStyle []])
ChartTree {tree = Node {rootLabel = (Just "frame",[Chart {chartStyle = Style {size = 6.0e-2, borderSize = 1.0e-2, color = Colour 0.02 0.73 0.80 0.10, borderColor = Colour 0.02 0.29 0.48 1.00, scaleP = NoScaleP, textAnchor = AnchorMiddle, rotation = Nothing, translate = Nothing, escapeText = EscapeText, frame = Nothing, lineCap = Nothing, lineJoin = Nothing, dasharray = Nothing, dashoffset = Nothing, hsize = 0.6, vsize = 1.1, vshift = -0.25, glyphShape = SquareGlyph}, chartData = RectData []}]), subForest = []}}

Whether a chart is empty of data to be represented.

Additive padding, framing or buffering for a chart list.

Make a new chart tree out of the bounding boxes of a chart tree.

This includes any extra space for style elements.

Make a new chart tree out of the data points of a chart tree, using the supplied style (for glyphs).

Aligning stacked things.

Rectangular placement

Flip Place to the opposite side, or negate if PlaceAbsolute.

>>> flipPlace PlaceLeft
PlaceRight

Point that moves a Rect in relation to another Rect

above and centered >>> beside PlaceTop 0 0.01 one half Point 0.0 0.76

above and right-aligned >>> beside PlaceTop 0.5 0.01 one half Point 0.25 0.76

left and with tops inline >>> beside PlaceLeft (-0.5) 0 one half Point (-0.75) 0.25

left and with bottoms aligned >>> beside PlaceLeft 0.5 0 one half Point (-0.75) (-0.25)