@spec layer_data(Giggly.Plot.t(), integer()) :: Giggly.DataFrame.t()

The table the layer at index computes, counting from 0 in the order the layers were added; the first layer when no index is given.

Its columns are named by aesthetic, plus the :panel each row is drawn in and its :group, the series it belongs to; the data's own column names do not appear. Its x and y columns hold positions on the panel's scales: a discrete value is its level's position, counting from 1. Every aesthetic the layer draws with is a column: one the layer neither maps nor sets holds its default under the plot's theme, a point's size the theme's points' size, nil where the default is none, as a point's fill. Raises ArgumentError when the plot has no layer at index; a negative index is refused too, not counted from the end.

iex> plot =
...>   %{"cyl" => ["6", "4", "6"], "mpg" => [21.0, 22.8, 21.4]}
...>   |> Giggly.Plot.new(%{x: :cyl, y: :mpg})
...>   |> Giggly.Plot.geom_point()
iex> frame = Giggly.layer_data(plot)
iex> Giggly.DataFrame.names(frame)
[:x, :y, :panel, :group, :shape, :color, :fill, :size, :alpha, :stroke]
iex> Giggly.DataFrame.pull(frame, :x)
[2, 1, 2]
iex> Giggly.DataFrame.pull(frame, :panel)
[1, 1, 1]
iex> Giggly.DataFrame.pull(frame, :group)
[2, 1, 2]

@spec panel_scales(Giggly.Plot.t(), integer()) :: %{
  x: panel_scale(),
  y: panel_scale()
}

The trained x and y scales of the panel with id panel, counting from 1 as panel ids do; the first panel when no id is given. Raises ArgumentError when the plot has no such panel.

iex> plot =
...>   %{"cyl" => ["6", "4", "6"], "mpg" => [21.0, 22.8, 21.4]}
...>   |> Giggly.Plot.new(%{x: :cyl, y: :mpg})
...>   |> Giggly.Plot.geom_point()
iex> Giggly.panel_scales(plot)
%{
  x: %Giggly.Scale.Discrete{
    levels: ["4", "6"],
    factor: false,
    continuous_range: {1, 2},
    palette: :identity,
    na_value: nil,
    guide: :axis
  },
  y: %Giggly.Scale.Continuous{
    range: {21.0, 22.8},
    transform: :identity,
    palette: :identity,
    na_value: nil,
    guide: :axis
  }
}

@spec to_svg(Giggly.Plot.t(), keyword()) :: iodata()

The plot drawn as an SVG document, as iodata.

The drawing's size is given in pixels and written in the document in points, at 96 pixels to the inch. Text, points and lines keep their sizes in points whatever the drawing's size, so a smaller drawing gives them more of it.

Options

• :width (pos_integer/0) - The drawing's width, in pixels. The default value is 700.

• :height (pos_integer/0) - The drawing's height, in pixels. The default value is 433.

• :text - How a label in a font Pica holds is written: :outlines draws it as the font's own shapes, keeping its words as unseen text; :text writes it as text naming its font. Every other label is written as text. The trade: the fonts guide. The default value is :outlines.

• :installed_fonts (boolean/0) - In a project that lists Pica, whether a family no font is registered under with Pica is looked for among the machine's installed fonts too, by its exact name. false draws with the registered fonts alone. What the search costs, and which names it skips: the fonts guide. The default value is true.

Raises NimbleOptions.ValidationError for an option it does not take or a size that is not a positive whole number of pixels.