aes

Documentation

Overview

Package aes provides aesthetic mapping constructors for the Grammar of Graphics. Aesthetics define how data variables map to visual properties like position, color, size, and shape.

Usage:

p := ggplot.New(ds,
    aes.X("col_x"),       // map column "col_x" to x-axis
    aes.Y("col_y"),       // map column "col_y" to y-axis
    aes.Color("group"),   // map column "group" to color
)

Index

• type Mapping
  • func Alpha(col string) Mapping
  • func AriaLabel(col string) Mapping
  • func Color(col string) Mapping
  • func Fill(col string) Mapping
  • func Group(col string) Mapping
  • func Href(col string) Mapping
  • func Label(col string) Mapping
  • func Linetype(col string) Mapping
  • func Shape(col string) Mapping
  • func Size(col string) Mapping
  • func Title(col string) Mapping
  • func Weight(col string) Mapping
  • func X(col string) Mapping
  • func XEnd(col string) Mapping
  • func XMax(col string) Mapping
  • func XMin(col string) Mapping
  • func Y(col string) Mapping
  • func YEnd(col string) Mapping
  • func YMax(col string) Mapping
  • func YMin(col string) Mapping

Types

type Mapping

type Mapping struct {
	Channel string // aesthetic name: "x", "y", "color", "fill", "size", "shape", "alpha", "group", "label", "linetype"
	Column  string // column name in the dataset
}

Mapping binds an aesthetic channel to a data source.

func Alpha

func Alpha(col string) Mapping

Alpha maps a column to the opacity aesthetic.

func AriaLabel

func AriaLabel(col string) Mapping

AriaLabel maps a column to the ARIA accessibility label aesthetic. In SVG output, primitives get an aria-label attribute for screen readers.

func Color

func Color(col string) Mapping

Color maps a column to the color aesthetic.

func Fill

func Fill(col string) Mapping

Fill maps a column to the fill color aesthetic.

func Group

func Group(col string) Mapping

Group maps a column to the grouping aesthetic (for line connections, etc.).

func Href

func Href(col string) Mapping

Href maps a column to the hyperlink aesthetic. In SVG output, primitives are wrapped in <a href="...">. PDF may emit link annotations. PNG output ignores this aesthetic.

func Label

func Label(col string) Mapping

Label maps a column to the text label aesthetic.

func Linetype

func Linetype(col string) Mapping

Linetype maps a column to the line dash pattern aesthetic.

func Shape

func Shape(col string) Mapping

Shape maps a column to the point shape aesthetic.

func Size

func Size(col string) Mapping

Size maps a column to the size aesthetic.

func Title

func Title(col string) Mapping

Title maps a column to the SVG <title> tooltip aesthetic. In SVG output, each primitive gets a <title> child element for hover tooltips. PNG and PDF output ignore this aesthetic.

func Weight

func Weight(col string) Mapping

Weight maps a column to a statistical weight aesthetic.

func X

func X(col string) Mapping

X maps a column to the x-axis position aesthetic.

func XEnd

func XEnd(col string) Mapping

XEnd maps a column to the end x-position of a segment.

func XMax

func XMax(col string) Mapping

XMax maps a column to the right bound of a range aesthetic.

func XMin

func XMin(col string) Mapping

XMin maps a column to the left bound of a range aesthetic.

func Y

func Y(col string) Mapping

Y maps a column to the y-axis position aesthetic.

func YEnd

func YEnd(col string) Mapping

YEnd maps a column to the end y-position of a segment.

func YMax

func YMax(col string) Mapping

YMax maps a column to the upper bound of a range aesthetic.

func YMin

func YMin(col string) Mapping

YMin maps a column to the lower bound of a range aesthetic (e.g., error bars).