Add scatterplot function

doc/api.rst

@@ -30,6 +30,7 @@ Basic plots
 .. autosummary::
     :toctree: generated
 
+    scatterplot
     lineplot
 
 .. _categorical_api:

doc/releases/v0.9.0.txt

@@ -2,7 +2,9 @@
 v0.9.0 (Unreleased)
 -------------------
 
-- Added the :func:`lineplot` function for representing relationships between numeric ``x`` and ``y`` variables with lines, potentially after conditioning on up to three other variables and semantically mapping those conditions with the color, size, or style of the lines. This function replaces :func:`tsplot`, but with an API that is more consistent with other modern seaborn functions and has both more flexibility (more dimensions of semantic mapping, better handling of dates) and less flexibility (fewer options for visual representing uncertainty). There is considerable new API documentation and there should also be a new tutorial.
+- Added the :func:`scatterplot` function for representing the relationship between ``x`` and ``y``, potentially after conditioning on up to three other variables and semantically mapping those conditions with the color, size, or style of the points.
+
+- Added the :func:`lineplot` function for representing relationships between``x`` and ``y`` variables with lines, potentially after conditioning on up to three other variables and semantically mapping those conditions with the color, size, or style of the lines. This function replaces :func:`tsplot`, but with an API that is more consistent with other modern seaborn functions and has both more flexibility (more dimensions of semantic mapping, better handling of dates) and less flexibility (fewer options for visual representing uncertainty). There is considerable new API documentation and a few gallery examples.
 
 - Final removal of the previously-deprecated ``coefplot`` and ``interactplot`` functions.
 

examples/different_scatter_variables.py

@@ -0,0 +1,22 @@
+"""
+Scatterplot with categorical and continuous semantics
+=====================================================
+
+_thumb: .55, .5
+
+"""
+import seaborn as sns
+import matplotlib.pyplot as plt
+sns.set(style="white")
+
+# Load the example iris dataset
+iris = sns.load_dataset("iris")
+
+# Draw a scatter plot while assigning point colors and sizes
+# to different variables in the dataset
+f, ax = plt.subplots(figsize=(6.5, 6.5))
+ax = sns.scatterplot(x="sepal_length", y="sepal_width",
+                     hue="species", size="petal_width",
+                     sizes=(50, 200), alpha=.75,
+                     palette="tab10",
+                     data=iris)

examples/scatterplot_sizes.py

@@ -0,0 +1,19 @@
+"""
+Scatterplot with continuous hues and sizes
+==========================================
+
+_thumb: .45, .45
+
+"""
+
+import seaborn as sns
+sns.set()
+
+# Load the example iris dataset
+planets = sns.load_dataset("planets")
+
+cmap = sns.cubehelix_palette(rot=-.2, as_cmap=True)
+ax = sns.scatterplot(x="distance", y="orbital_period",
+                     hue="year", size="mass",
+                     palette=cmap, sizes=(10, 200),
+                     data=planets)