...

Package vgtex

import "gonum.org/v1/plot/vg/vgtex"
Overview
Index
Examples

Overview ▾

Package vgtex provides a vg.Canvas implementation for LaTeX, targeted at the TikZ/PGF LaTeX package: https://sourceforge.net/projects/pgf

vgtex generates PGF instructions that will be interpreted and rendered by LaTeX. vgtex allows to put any valid LaTeX notation inside plot's strings.

Example

An example of making a LaTeX plot.

Code:

p := plot.New()
// p.HideAxes()
p.Title.Text = `A scatter plot: $\sqrt{\frac{e^{3i\pi}}{2\cos 3\pi}}$`
p.Title.TextStyle.Font.Size = 16
p.X.Label.Text = `$x = \eta$`
p.Y.Label.Text = `$y$ is some $\Phi$`

scatter1, err := plotter.NewScatter(plotter.XYs{{X: 1, Y: 1}, {X: 0, Y: 1}, {X: 0, Y: 0}})
if err != nil {
    log.Fatal(err)
}
scatter1.Color = color.RGBA{R: 255, A: 200}

scatter2, err := plotter.NewScatter(plotter.XYs{{X: 1, Y: 0}, {X: 1, Y: 0.5}})
if err != nil {
    log.Fatal(err)
}
scatter2.GlyphStyle.Shape = draw.PyramidGlyph{}
scatter2.GlyphStyle.Radius = 2
scatter2.Color = color.RGBA{B: 255, A: 200}

p.Add(scatter1, scatter2)

txtFont := p.TextHandler.Cache().Lookup(
    p.X.Label.TextStyle.Font,
    p.X.Label.TextStyle.Font.Size,
)

c := vgtex.NewDocument(5*vg.Centimeter, 5*vg.Centimeter)
p.Draw(draw.New(c))

c.SetColor(color.Black)
c.FillString(txtFont, vg.Point{X: 2.5 * vg.Centimeter, Y: 2.5 * vg.Centimeter}, "x")

f, err := os.Create("testdata/scatter.tex")
if err != nil {
    log.Fatal(err)
}
defer f.Close()

if _, err = c.WriteTo(f); err != nil {
    log.Fatal(err)
}
err = f.Close()
if err != nil {
    log.Fatal(err)
}

type Canvas

Canvas implements the vg.Canvas interface, translating drawing primitives from gonum/plot to PGF.

type Canvas struct {
    // contains filtered or unexported fields
}

func New

func New(w, h vg.Length) *Canvas

New returns a new LaTeX canvas.

func NewDocument

func NewDocument(w, h vg.Length) *Canvas

NewDocument returns a new LaTeX canvas that can be readily compiled into a standalone document.

func (*Canvas) DrawImage

func (c *Canvas) DrawImage(rect vg.Rectangle, img image.Image)

DrawImage implements the vg.Canvas.DrawImage method. DrawImage will first save the image inside a PNG file and have the generated LaTeX reference that file. The file name will be "gonum-pgf-image-<canvas-id>-<time.Now()>.png

func (*Canvas) Fill

func (c *Canvas) Fill(p vg.Path)

Fill implements the vg.Canvas.Fill method.

func (*Canvas) FillString

func (c *Canvas) FillString(f font.Face, pt vg.Point, text string)

FillString implements the vg.Canvas.FillString method.

func (*Canvas) Pop

func (c *Canvas) Pop()

Pop implements the vg.Canvas.Pop method.

func (*Canvas) Push

func (c *Canvas) Push()

Push implements the vg.Canvas.Push method.

func (*Canvas) Rotate

func (c *Canvas) Rotate(rad float64)

Rotate implements the vg.Canvas.Rotate method.

func (*Canvas) Scale

func (c *Canvas) Scale(x, y float64)

Scale implements the vg.Canvas.Scale method.

func (*Canvas) SetColor

func (c *Canvas) SetColor(clr color.Color)

SetColor implements the vg.Canvas.SetColor method.

func (*Canvas) SetLineDash

func (c *Canvas) SetLineDash(pattern []vg.Length, offset vg.Length)

SetLineDash implements the vg.Canvas.SetLineDash method.

func (*Canvas) SetLineWidth

func (c *Canvas) SetLineWidth(w vg.Length)

SetLineWidth implements the vg.Canvas.SetLineWidth method.

func (*Canvas) Size

func (c *Canvas) Size() (w, h vg.Length)

Size returns the width and height of the canvas.

func (*Canvas) Stroke

func (c *Canvas) Stroke(p vg.Path)

Stroke implements the vg.Canvas.Stroke method.

func (*Canvas) Translate

func (c *Canvas) Translate(pt vg.Point)

Translate implements the vg.Canvas.Translate method.

func (*Canvas) WriteTo

func (c *Canvas) WriteTo(w io.Writer) (int64, error)

WriteTo implements the io.WriterTo interface, writing a LaTeX/pgf plot.