```@meta
Author = "Daniel C. Jones"
```

# Geom.point

The point geometry is used to draw various types of scatterplots.

## Aesthetics

  * `x`: X-axis position.
  * `y`: Y-axis position.
  * `color` (optional): Point color (categorial or continuous).

## Examples

```@setup 1
using RDatasets
using Gadfly
Gadfly.set_default_plot_size(14cm, 8cm)
```

```@example 1
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth", Geom.point)
```

```@example 1
# Binding categorial data to the color aesthetic
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth",
     color="Species", Geom.point)
```

```@example 1
# Binding continuous data to the color aesthetic
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth",
     color="PetalLength", Geom.point)
```

```@example 1
# Binding categorial data to x
plot(dataset("lattice", "singer"), x="VoicePart", y="Height", Geom.point)
```

<!-- TODO: shape aesthetic -->

<!-- TODO: size aesthetic -->

```@meta
Author = "Daniel C. Jones"
```

# Geom.point

The point geometry is used to draw various types of scatterplots.

## Aesthetics

  * `x`: X-axis position.
  * `y`: Y-axis position.
  * `color` (optional): Point color (categorial or continuous).

## Examples

```@setup 1
using RDatasets
using Gadfly
Gadfly.set_default_plot_size(14cm, 8cm)
```

```@example 1
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth", Geom.point)
```

```@example 1
# Binding categorial data to the color aesthetic
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth",
     color="Species", Geom.point)
```

```@example 1
# Binding continuous data to the color aesthetic
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth",
     color="PetalLength", Geom.point)
```

```@example 1
# Binding categorial data to x
plot(dataset("lattice", "singer"), x="VoicePart", y="Height", Geom.point)
```

```@example 1
# Binding categorical data to the shape aesthetic
plot(dataset("datasets", "iris"), x="SepalLength", y="SepalWidth", shape="Species", color="Species", Geom.point)
```

<!-- TODO: size aesthetic -->

Update Docs to show use of the shape aesthetic
Update Docs to show use of the shape aesthetic

The latest version of the docs had a todo here.  Since I was using the shape functionality in a plot I'm working on
tonight, I thought I'd go ahead and update the docs too.  Hope this helps.  Use of the shape aesthetic works on
my Julia v0.5.0.