# AsyPlots.jl

## Introduction

*AsyPlots* is a Julia package for creating figures in Asymptote. Asymptote is
a mature language for technical drawing in two and three dimensions.
This package provides access to

- Vector graphics with LaTeX-rendered labels in 2D and 3D
- An OpenGL renderer for interacting with 3D figures
- Easily customizable colors and arrows
- Convenience functions for line graphs and surface plots, with less of a time-to-first-plot penalty than some other packages
- An environment designed for working directly with graphics primitives (points, paths, polygons, circles, parametric surfaces) in natural coordinates
- in-line plotting in IJulia and Juno's plot pane
- Options to save output as asy, eps, pdf, svg, or png
- An alternative Cairo backend, for speed

## Installation

### Install Asymptote

*AsyPlots* requires Asymptote, which you might already have as a part
of your TeX installation (run `asy --version`

from the command line to
check). Alternatively, you can download and install it here. Version 2.44 is recommended. Linux and Windows binaries are available, and to install on macOS, download asymptote-2.44.src.tgz, unzip it, `cd`

into that directory, and run

```
wget http://hboehm.info/gc/gc_source/gc-7.6.0.tar.gz
wget http://www.ivmaisoft.com/_bin/atomic_ops/libatomic_ops-7.6.0.tar.gz
./configure
make all
sudo make install
```

### Optionally Install Cairo

Asymptote can optionally use an alternative backend that relies on `Cairo.jl`

, though
this package is currently not installing cleanly.
Try

```
using Homebrew
Homebrew.brew(`unlink glib`)
Homebrew.brew(`install --verbose --build-from-source https://raw.githubusercontent.com/Homebrew/homebrew-core/05871cb0394f78ef25a5c1c071456d0f1e4be4fe/Formula/glib.rb`)
Pkg.build("Cairo")
```

See this thread for more details.

If you want to use the Cairo features of Asymptote, you should load Cairo first:

```
using Cairo
using AsyPlots
```

### Install AsyPlots

From the Julia `pkg`

prompt, run `add AsyPlots`

, or from the Julia prompt, run `Pkg.add("AsyPlots")`

.

## Examples

```
using AsyPlots
n = 250; using Random; Random.seed!(1)
A = [(x,y) == (0,0) ? 0 : 1/(x^2+y^2) for x=0:n-1,y=0:n-1]
B = randn(n,n)
save("fgf.png",plot(real(fft(A.*B));width=150)) # hide
plot(real(fft(A.*B)))
```

```
using AsyPlots # hide
n = 100000; using Random; Random.seed!(2) # hide
x = cumsum(rand(-1:1,n))
y = cumsum(rand(-1:1,n))
save("rw.svg",Plot(Path(x,y;color="White"), # hide
bgcolor="Black", width=512, # hide
axispen="Red",axes=true,axisarrow=Arrow())) # hide
Plot(Path(x,y;color="White"),
bgcolor="Black",
axispen="Red",
axes=true,
axisarrow=Arrow())
```