# seaborn.jointplot
> 译者:[Stuming](https://github.com/Stuming)
```py
seaborn.jointplot(x, y, data=None, kind='scatter', stat_func=None, color=None, height=6, ratio=5, space=0.2, dropna=True, xlim=None, ylim=None, joint_kws=None, marginal_kws=None, annot_kws=None, **kwargs)
```
绘制两个变量的双变量及单变量图。
这个函数提供调用[`JointGrid`](seaborn.JointGrid.html#seaborn.JointGrid "seaborn.JointGrid")类的便捷接口,以及一些封装好的绘图类型。这是一个轻量级的封装,如果需要更多的灵活性,应当直接使用[`JointGrid`](seaborn.JointGrid.html#seaborn.JointGrid "seaborn.JointGrid").
参数:`x, y`:strings 或者 vectors
> `data`中的数据或者变量名。
`data`:DataFrame, 可选
> 当`x`和`y`为变量名时的 DataFrame.
`kind`:{ “scatter” | “reg” | “resid” | “kde” | “hex” }, 可选
> 绘制图像的类型。
`stat_func`:可调用的,或者 None, 可选
> 已过时
`color`:matplotlib 颜色, 可选
> 用于绘制元素的颜色。
`height`:numeric, 可选
> 图像的尺寸(方形)。
`ratio`:numeric, 可选
> 中心轴的高度与侧边轴高度的比例
`space`:numeric, 可选
> 中心和侧边轴的间隔大小
`dropna`:bool, 可选
> 如果为 True, 移除`x`和`y`中的缺失值。
`{x, y}lim`:two-tuples, 可选
> 绘制前设置轴的范围。
`{joint, marginal, annot}_kws`:dicts, 可选
> 额外的关键字参数。
`kwargs`:键值对
> 额外的关键字参数会被传给绘制中心轴图像的函数,取代`joint_kws`字典中的项。
返回值:`grid`:[`JointGrid`](seaborn.JointGrid.html#seaborn.JointGrid "seaborn.JointGrid")
> [`JointGrid`](seaborn.JointGrid.html#seaborn.JointGrid "seaborn.JointGrid")对象.
参考
绘制图像的 Grid 类。如果需要更多的灵活性,可以直接使用 Grid 类。
示例
绘制带有侧边直方图的散点图:
```py
>>> import numpy as np, pandas as pd; np.random.seed(0)
>>> import seaborn as sns; sns.set(style="white", color_codes=True)
>>> tips = sns.load_dataset("tips")
>>> g = sns.jointplot(x="total_bill", y="tip", data=tips)
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-1.png](https://img.kancloud.cn/3d/87/3d8795ee4da0c2e491832847fe0232e3_540x540.jpg)
添加回归线及核密度拟合:
```py
>>> g = sns.jointplot("total_bill", "tip", data=tips, kind="reg")
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-2.png](https://img.kancloud.cn/9c/b8/9cb84b605325b06e104630c7af30dc8d_540x540.jpg)
将散点图替换为六角形箱体图:
```py
>>> g = sns.jointplot("total_bill", "tip", data=tips, kind="hex")
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-3.png](https://img.kancloud.cn/17/7c/177cf5c7451da4701e3e86f88eac752a_540x540.jpg)
将散点图和直方图替换为密度估计,并且将侧边轴与中心轴对齐:
```py
>>> iris = sns.load_dataset("iris")
>>> g = sns.jointplot("sepal_width", "petal_length", data=iris,
... kind="kde", space=0, color="g")
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-4.png](https://img.kancloud.cn/0b/23/0b23c35e4cefb6d30d190d92b5bd6ef0_540x540.jpg)
绘制散点图,添加中心密度估计:
```py
>>> g = (sns.jointplot("sepal_length", "sepal_width",
... data=iris, color="k")
... .plot_joint(sns.kdeplot, zorder=0, n_levels=6))
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-5.png](https://img.kancloud.cn/ac/65/ac651ee342d99c5ec15b07b500594fb3_540x540.jpg)
不适用 Pandas, 直接传输向量,随后给轴命名:
```py
>>> x, y = np.random.randn(2, 300)
>>> g = (sns.jointplot(x, y, kind="hex")
... .set_axis_labels("x", "y"))
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-6.png](https://img.kancloud.cn/1d/75/1d7588b09ff312a29d860ffe4698c373_540x540.jpg)
绘制侧边图空间更大的图像:
```py
>>> g = sns.jointplot("total_bill", "tip", data=tips,
... height=5, ratio=3, color="g")
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-7.png](https://img.kancloud.cn/40/eb/40ebbd26b1d4d563688a9d283690dd39_450x450.jpg)
传递关键字参数给后续绘制函数:
```py
>>> g = sns.jointplot("petal_length", "sepal_length", data=iris,
... marginal_kws=dict(bins=15, rug=True),
... annot_kws=dict(stat="r"),
... s=40, edgecolor="w", linewidth=1)
```
![http://seaborn.pydata.org/_images/seaborn-jointplot-8.png](https://img.kancloud.cn/59/9f/599f8a9851ad1330be6b241a2c8035b9_540x540.jpg)
- seaborn 0.9 中文文档
- Seaborn 简介
- 安装和入门
- 可视化统计关系
- 可视化分类数据
- 可视化数据集的分布
- 线性关系可视化
- 构建结构化多图网格
- 控制图像的美学样式
- 选择调色板
- seaborn.relplot
- seaborn.scatterplot
- seaborn.lineplot
- seaborn.catplot
- seaborn.stripplot
- seaborn.swarmplot
- seaborn.boxplot
- seaborn.violinplot
- seaborn.boxenplot
- seaborn.pointplot
- seaborn.barplot
- seaborn.countplot
- seaborn.jointplot
- seaborn.pairplot
- seaborn.distplot
- seaborn.kdeplot
- seaborn.rugplot
- seaborn.lmplot
- seaborn.regplot
- seaborn.residplot
- seaborn.heatmap
- seaborn.clustermap
- seaborn.FacetGrid
- seaborn.FacetGrid.map
- seaborn.FacetGrid.map_dataframe
- seaborn.PairGrid
- seaborn.PairGrid.map
- seaborn.PairGrid.map_diag
- seaborn.PairGrid.map_offdiag
- seaborn.PairGrid.map_lower
- seaborn.PairGrid.map_upper
- seaborn.JointGrid
- seaborn.JointGrid.plot
- seaborn.JointGrid.plot_joint
- seaborn.JointGrid.plot_marginals
- seaborn.set
- seaborn.axes_style
- seaborn.set_style
- seaborn.plotting_context
- seaborn.set_context
- seaborn.set_color_codes
- seaborn.reset_defaults
- seaborn.reset_orig
- seaborn.set_palette
- seaborn.color_palette
- seaborn.husl_palette
- seaborn.hls_palette
- seaborn.cubehelix_palette
- seaborn.dark_palette
- seaborn.light_palette
- seaborn.diverging_palette
- seaborn.blend_palette
- seaborn.xkcd_palette
- seaborn.crayon_palette
- seaborn.mpl_palette
- seaborn.choose_colorbrewer_palette
- seaborn.choose_cubehelix_palette
- seaborn.choose_light_palette
- seaborn.choose_dark_palette
- seaborn.choose_diverging_palette
- seaborn.load_dataset
- seaborn.despine
- seaborn.desaturate
- seaborn.saturate
- seaborn.set_hls_values