matplotlib-------matplotlibrc

转自：https://my.oschina.net/swuly302/blog/94805

自定义matplotlib

Created Saturday 08 December 2012

5.1 matplotlibrc文件

matplotlib使用matplotlibrc [matplotlib resource configurations]配置文件来自定义各种属性，我们称之为rc配置或者rc参数。在matplotlib中你可以控制几乎所有的默认属性：视图窗口大小以及每英寸点数[dpi]，线条宽度，颜色和样式，坐标轴，坐标和网格属性，文本，字体等属性。matplotlib从下面的3个地方按顺序查找matplotlibrc文件：

1. 当前工作目录下的matplotlibrc，通常用在你不想被其它地方使用的特定自定义[customizations] 

2. 用户默认的自定义在.matplotlib/matplotlibrc里。查看  .matplotlib目录存放位置 

3. python安装目录/matplotlib/mpl-data/matplotlibrc.如果是linux,那么python安装目录像这样：/usr/lib/python2.5/site-packages。如果在windows，可能是c:\pytho2.5\lib\site-packages。每次你安装matplotlib,这个文件就会被覆盖。如果你想要你的自定义配置保存下来，请把这个文件放到你的.matplotlib目录下。 

想查看当前工作的matplotlibrc文件是哪个，你可以使用下面的方式查看：

>>> import matplotlib>>> matplotlib.matplotlib_fname()'/home/foo/.matplotlib/matplotlibrc'

请看下面matplotlibrc文件例子

5.2 rc动态配置

你可以在python脚本或者python交互式环境里动态的改变默认rc配置。所有的rc配置变量称为matplotlib.rcParams 使用字典格式存储，它在matplotlib中是全局可见的。rcParams可以直接修改，如：

import matplotlib as mplmpl.rcParams['lines.linewidth'] = 2mpl.rcParams['lines.color'] = 'r'

Matplotlib还提供了一些便利函数来修改rc配置。matplotlib.rc()命令利用关键字参数来一次性修改一个属性的多个设置：

import matplotlib as mplmpl.rc('lines', linewidth=2, color='r')

这里matplotlib.rcdefaults()命令可以恢复为matplotlib标准默认配置。 
还有可以验证设置rcParams的值，详情查看matplotlib.rcsetup。

5.2.1 一个matplotlibrc文件示例

### MATPLOTLIBRC 格式

# 这是一个matplotlib简单配置文件-你可以从你的系统下的site-packages/matplotlib/mpl-data/matplotlibrc找到。
# 如果你要修改你，请注意它会在你下次安装时覆盖。如果你想要长久保持不被覆盖，
# 请把它放在HOME/.matplotlib/matplotlibrc(unix/linux)
# C:\Documents and Settings\yourname\.matplotlib (win32 systems).
#
# 这个文件最好在支持python语法高亮模式的文本编辑器下查看。
# 空行或者注释符开头的行或者尾部追加的注释都会被忽略。其它行都遵循下面格式：
# 关键字 ： 值 # 可选注释
#
# 颜色：下面是颜色值，你可以使用一个matplotlib颜色字符串如：r, k或者b等，
# 也可以使用rgb元组，如：（1.0, 0.5, 0.0），
# 也可以使用16进制字符串，如ff00ff或者#ff00ff。
# 也可以使用灰度值，如：0.75
# 还可以使用合法的html颜色值：如： red, blue, darkslategray

#### 开始配置

# 默认后端： 从GTK, GTKAgg, GTKCairo, CocoaAgg, FltkAgg, MacOSX, QtAgg, 
# Qt4Agg, TkAgg, WX, WXAgg, Agg, Cairo, GDK, PS, PDF, SVG, Template中选择一个。
# 当然你也可以自己在matplotlib外,通过'module://my_backend'引用模块名(必须在python安装目录下),
# 来发布一个后端。
backend : Agg

# 如果你使用Qt4Agg后端，你可以选择在这里使用PyQt4或者新的PySide绑定到Qt4工具集。
#backend.qt4 : PyQt4 # PyQt4 | PySide

# 注意这个会重载被加强工具集(ETS)使用的QT_API环境变量;有效值为"pyqt"和"pyside".
# "pyqt"设置会强制QString和QVariant使用版本2API的副作用

# 如果你在GUI里使用pyplot和你选的后端冲突，
# 当你把backend_fallback设置为True我们会自动为你选择一个兼容后端。
#backend_fallback: True

#interactive : False
#toolbar : toolbar2 # None | classic | toolbar2
#timezone : UTC # a pytz timezone string, eg US/Central or Europe/Paris

# 如果你的matplotlib数据存放在非默认安装的地方，像matplotlib字体，位图等等
#datapath : /home/jdhunter/mpldata

### 线条
# 更多线条属性详情请查看
# http://matplotlib.sourceforge.net/api/artist_api.html#module-matplotlib.lines 
#lines.linewidth ： 1.0 # 线宽
#lines.linwstyle : - # 实线
#lines.color : blue
#lines.marker : None # 默认标记
#lines.markeredgewidth : 0.5 # 在标记附近的线宽
#lines.markersize : 6 # 标记大小
#lines.dash_joinstyle : miter # miter|round|bevel
#lines.dash_capstyle : butt # butt|round|projecting
#lines.solid_joinstyle : miter # miter|round|bevel
#lines.solid_capstyle : projecting # butt|round|projecting
#lines.antialiased : True # 使用抗锯齿渲染(没有缺口)

### 斑纹[PATCHES]
# 斑纹是图形对象，用来填充2D空间，如多边形或者圆
# 更多详情请查看 http://matplotlib.sourceforge.net/api/artist_api.html#module-matplotlib.patches
#patch.linewidth : 1.0 # edge width in points
#patch.facecolor : blue
#patch.edgecolor : black
#patch.antialiased : True # 使用抗锯齿渲染(没有缺口)

### 字体
# 
# 字体属性被text.Text所使用。更多详情请查看http://matplotlib.sourceforge.net/api/font_manager_api.html
# 下面给出6种带默认值的字体属性
# font.family属性有五个值： "serif"(如：Times),
# "sans-serif"(如：Helvetical), "cursive"(如：Zapf-Chancery)
# "fantasy"(如:Western)和"monospace"(如: Courier).
# 每个字体家族都有默认一些列以优先级下降的顺序排列的字体
#
# font.style属性有三个值： normal(或者roman), italic,或者oblique. 
# oblique风格如果没有出现，它会在italic中使用。
#
# font.variant属性有2个值： normal或者small-caps.对于TrueType类型的字体，
# 可缩放字形，大写字母的小写形式(如：_ABCDE)和使用‘smaller’字体大小或者当前字体大小的83%左右是等价的
#
# font.weight属性有13个有效值：normal, bold, bolder, lighter, 100, 200, 300, ..., 900.
# Normal和400,bold和700是一样的，而bolder和lighter是针对当前高度的相对大小
#
# font.stretch属性有11个值： ultra-condensed,
# extra-condensed, condensed, semi-condensed, normal, semi-expanded,
# expanded, extra-expanded, ultra-expanded, wider, and narrower.
# 这个属性迄今还没有实现。
#
# font.size属性是为文本设置默认字体大小，以磅为单位，12pt是标准值。
#
#font.family : sans-serif
#font.style : normal
#font.variant : normal
#font.weight : medium
#font.stretch : normal
# 注意font.size控制着默认字体大小。如果想要配置指定文本的大小如tick标签，坐标轴，标签，标题等等。
# 请看坐标轴和ticks的rc配置。指定文本大小可以使用下面的值：xx-small, x-small,small, medium, 
# large, x-large, xx-large, larger,或者smaller来相对font.size大小定义
#font.size : 12.0
#font.serif : Bitstream Vera Serif, New Century Schoolbook, Century Schoolbook L, Utopia, ITC Bookman, Bookman, Nimbus Roman No9 L, Times New Roman, Times, Palatino, Charter, serif
#font.sans-serif : Bitstream Vera Sans, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif
#font.cursive : Apple Chancery, Textile, Zapf Chancery, Sand, cursive
#font.fantasy : Comic Sans MS, Chicago, Charcoal, Impact, Western, fantasy
#font.monospace : Bitstream Vera Sans Mono, Andale Mono, Nimbus Mono L, Courier New, Courier, Fixed, Terminal, monospace

### 文本
#
# 文本属性被text.Text使用。更多详情请查看
# http://matplotlib.sourceforge.net/api/artist_api.html#module-matplotlib.text 
#text.color : black

### LaTex自定义
# 查看http://www.scipy.org/Wiki/Cookbook/Matplotlib/UsingTex
#text.usetex : False # 所有文本都用latex来处理。可以通过rc参数设置来设置下面支持的字体：
# new century schoolbook, bookman, times, palatino,
# zapf chancery, charter, serif, sans-serif, helvetica,
# avant garde, courier, monospace, 

# computer modern roman, 

# computer modern sans serif, computer modern typewriter 

# 如果LaTeX的\userpackage命令需要其它的字 
# 体，请在matplotlib邮件列表里查询  

#text.latex.unicode : False # 使用"ucs"和"inputenc" LaTeX包来处理unicode字符串

#text.latex.preamble : # 不正确的使用这个特性会导致LaTeX错误和不支持。

# 如果这个特性不能按你期望的工作，请不要求救 
# preamble是逗号分隔的列表的LaTeX语句，它包含在LaTeX的preamble文档 
# 如： 

# text.latex.preamble : \usepackage{bm},\usepackage{euler}

# 这个包总是会随这usetex而载入。所以请小心包冲突：color, geometry,  
# graphicx, type1cm, textcomp. 根据你的字体设置Adobe的Postscript  
# font可能会载入。  

#text.dvipnghack : None # dvipng的一些版本不能正确的处理alpha通道。 

# 请在测试之前设置为True来检测和刷新 

#  ~/.matplotlib/tex.cache。设置为False来关闭检测。 

# 设置为None会根据你dvipng版本检测和猜测  

#text.hinting : True # 如果为True，文本就会是提示文本，否则，就不是提示文本。它只对Agg后端其作用

#text.antialiased : True # 如果为True(默认值)，文本就会抗锯齿。它只对Agg后端其作用

# 下面的设置允许你选择数学模式的字体
# 它们从TeX字体映射到字体配置模式。这些设置只有在mathtext.fontset设置为'custom'时才会被使用。
# 注意的是这个'custom'模式现在并不被支持，可能在不久会被遗弃。
#mathtext.cal : cursive
#mathtext.rm : serif
#mathtext.tt : monospace
#mathtext.it : serif:italic
#mathtext.bf : serif:bold
#mathtext.sf : sans
#mathtext.fontset : cm # 应该为 'cm' (Computer Modern), 'stix',
# 'stixsans' or 'custom'
#mathtext.fallback_to_cm : True # When True, use symbols from the Computer Modern
# fonts when a symbol can not be found in one of
# the custom math fonts.

#mathtext.default : it # 数学默认字体。可以是任何LaTeX字体名包括一些专门的合法字体

### 坐标轴
# 默认面和边颜色以及tick大小
# tick标签的默认字体大小等等。
# 请查看：
# http://matplotlib.sourceforge.net/api/axes_api.html#module-matplotlib.axes
#axes.hold : True # 是否清除坐标轴，默认是开启的
#axes.facecolor : white # 坐标轴的背景颜色
#axes.edgecolor : black # 坐标轴边的颜色
#axes.linewidth : 1.0 # 边的宽
#axes.grid : False # 是否显示网格
#axes.titlesize : large # 坐标轴标题字体的大小
#axes.labelsize : medium # x轴和y轴的字体大小
#axes.labelweight : normal # x轴和y轴的字体高度
#axes.labelcolor : black
#axes.axisbelow : False # 坐标轴网格线以及ticks是否在坐标轴的线条或者文本等元素下面显示
#axes.formatter.limits : -7, 7 # use scientific notation if log10
# of the axis range is smaller than the
# first or larger than the second
#axes.formatter.use_locale : False # 当为真时，会根据用户的本地环境格式化tick标签。

# 例如：当使用','分隔时，在法国会当作小数分割号 

#axes.unicode_minus : True # 减号使用unicode编码而不是连字符号，请查看
# http://en.wikipedia.org/wiki/Plus_and_minus_signs#Character_codes
#axes.color_cycle : b, g, r, c, m, y, k # 绘制线条的颜色循环，颜色列表：单个字母或者全名，或者web风格的十六进制。

#polaraxes.grid : True # 极坐标轴显示网格
#axes3d.grid : True # 3d坐标轴显示网格

### 刻度/记号[TICKS]
# 查看 http://matplotlib.sourceforge.net/api/axis_api.html#matplotlib.axis.Tick
#xtick.major.size : 4 # 最大刻度大小
#xtick.minor.size : 2 # 最小刻度大小
#xtick.major.width : 0.5 # 最大刻度宽度
#xtick.minor.width : 0.5 # 最小刻度宽度
#xtick.major.pad : 4 # 最大刻度标签距离
#xtick.minor.pad : 4 # 最小刻度标签距离
#xtick.color : k # 刻度标签颜色
#xtick.labelsize : medium # 刻度标签字体大小
#xtick.direction : in # 指向: in or out

#ytick.major.size : 4 # 最大刻度大小
#ytick.minor.size : 2 # 最小刻度大小
#ytick.major.width : 0.5 # 最大刻度宽度
#ytick.minor.width : 0.5 # 最小刻度宽度
#ytick.major.pad : 4 # 最大刻度标签距离
#ytick.minor.pad : 4 # 最小刻度标签距离
#ytick.color : k # 刻度标签颜色
#ytick.labelsize : medium # 刻度标签字体大小
#ytick.direction : in # 指向: in or out

### 网格[GRIDS]
#grid.color : black # 网格颜色
#grid.linestyle : : # 点
#grid.linewidth : 0.5 # pt

### 图例[Legend]
#legend.fancybox : False # 为True时使用圆角方框，否则使用直角方框
#legend.isaxes : True
#legend.numpoints : 2 # the number of points in the legend line
#legend.fontsize : large
#legend.pad : 0.0 # 已弃用了
#legend.borderpad : 0.5 # 字体大小单元的边缘的空白
#legend.markerscale : 1.0 # the relative size of legend markers vs. original

# the following dimensions are in axes coords 

#legend.labelsep : 0.010 # 已弃用了 
#legend.labelspacing : 0.5 # 图例之间的竖直距离,使用字体大小的几分之几表示 
#legend.handlelen : 0.05 # 已弃用了 
#legend.handlelength : 2. # 图例之间的长度,使用字体大小的几分之几表示 
#legend.handleheight : 0.7 # 图例之间的高度,使用字体大小的几分之几表示 
#legend.handletextsep : 0.02 # 已弃用了 
#legend.handletextpad : 0.8 # 图例的图例线和图例文本之间的距离,使用字体大小的几分之几表示 
#legend.axespad : 0.02 # 已弃用了 
#legend.borderaxespad : 0.5 # 图例边缘和坐标轴之间的空隙距离,使用字体大小的几分之几表示 
#legend.columnspacing : 2. #  
#legend.shadow : False 
#legend.frameon : True # 是否在图例外显示外框 

### 视图窗口[FIGURE]
# 请查看 http://matplotlib.sourceforge.net/api/figure_api.html#matplotlib.figure.Figure
#figure.figsize : 8, 6 # 视图窗口大小，英寸表示
#figure.dpi : 80 # 视图窗口 每英寸点数
#figure.facecolor : 0.75 # 视图窗口颜色; 0.75是使用灰度值
#figure.edgecolor : white # 视图窗口边的颜色

# 视图窗口的子视图参数. 所有的大小都是视图窗口大小的几分之几
#figure.subplot.left : 0.125 # 左部子视图
#figure.subplot.right : 0.9 # 右部子视图
#figure.subplot.bottom : 0.1 # 下部子视图
#figure.subplot.top : 0.9 # 上部子视图
#figure.subplot.wspace : 0.2 # 子视图之间的横向空白间距
#figure.subplot.hspace : 0.2 # 子视图之间的纵向空白间距

### 图像[IMAGES]
#image.aspect : equal # equal | auto | a number
#image.interpolation : bilinear # 使用help(imshow)获得更多
#image.cmap : jet # gray | jet etc...
#image.lut : 256 # 色彩对照表查找大小
#image.origin : upper # lower | upper
#image.resample : False

### 轮廓图[CONTOUR PLOTS]
#contour.negative_linestyle : dashed # dashed | solid

### Agg 渲染
### 警告: 还在实验中, 2008/10/10
#agg.path.chunksize : 0 # 0为禁用;取值在10000到100000可以约微提高速度和减少Agg渲染失败当绘制很大数据时。

# 尽管它可能会产生假象。20000是一个很好初始点。 

### 保存视图窗口
#path.simplify : True # 当为True时，通过删除不可见的点来减少文件的大小和提供渲染速度来简单化
#path.simplify_threshold : 0.1 # 在简单化过程中，在相似度的阙值下面的至高点将会删除
#path.snap : True # When True, rectilinear axis-aligned paths will be snapped to
# the nearest pixel when certain criteria are met. When False,
# paths will never be snapped.

# 默认的保存视图窗口的参数会因为显示参数的不同而不同。如：你想高分辨率，会使视图窗口的背景为白色。
#savefig.dpi : 100 # 视图窗口 每英寸点数
#savefig.facecolor : white # 视图窗口保存时颜色
#savefig.edgecolor : white # 视图窗口边在保存时的颜色
#savefig.extension : auto # 使用什么文件后缀

#cairo.format : png # png, ps, pdf, svg

# tk 后端参数
#tk.window_focus : False # Maintain shell focus for TkAgg

# ps 后端参数
#ps.papersize : letter # auto, letter, legal, ledger, A0-A10, B0-B10
#ps.useafm : False # use of afm fonts, results in small files
#ps.usedistiller : False # can be: None, ghostscript or xpdf
# Experimental: may produce smaller files.
# xpdf intended for production of publication quality files,
# but requires ghostscript, xpdf and ps2eps
#ps.distiller.res : 6000 # dpi
#ps.fonttype : 3 # Output Type 3 (Type3) or Type 42 (TrueType)

# pdf 后端参数
#pdf.compression : 6 # integer from 0 to 9
# 0 disables compression (good for debugging)
#pdf.fonttype : 3 # Output Type 3 (Type3) or Type 42 (TrueType)

# svg 后端参数
#svg.image_inline : True # 直接将光栅图数据写入到svg文件中
#svg.image_noscale : False # 在svg中不缩放光栅数据比例
#svg.fonttype : 'path' # 怎么处理svg的字体
# 'none': 假设字体已经安装了，svg可以正常查看
# 'path': 在路径中植入字符--支持大多数的SVG渲染器
# 'svgfont': 植入字符作为SVG的字体--被Chrome，Opera和Safari支持

# docstring 参数
#docstring.hardcopy = False # 如果你想生成硬拷贝的文档就设置它

# 设置冗长信息标志。 它会控制在matplotlib在运行时可以给你多少信息。
# 冗长信息的等级可以是： silent, helpful, debug, debug-annoying.任何等级都会包含它前面的等级。
# 如你设置的等级为debug,那么你会获得所有debug和helpful等级的信息。
# 如果使用邮件列表提交问题时，请设置为helpful或者debug，并且将输出附加到你的报告中。
#
# fileo告诉冗余信息报告输出的目的地。可以是一个文件名，或者一个文件句柄像sys.stdout.
# 你可以重载rc默认冗余信息，在命令行中使用标志--vervbose-LEVEL，LEVEL是合法的等级如：--verbose-helpful
#
# 你可以在你的代码中访问冗余信息的实例。
# from matplotlib import verbose.
#verbose.level : silent # one of silent, helpful, debug, debug-annoying
#verbose.fileo : sys.stdout # a log filename, sys.stdout or sys.stderr

# 通过键盘和视图窗口交互的事件键
# 根据你的要求，自定义这些设置
# 如果你不需要键对照表，请空着（如： fullscreen : ''）

#keymap.fullscreen : f # 全屏
#keymap.home : h, r, home # 主页或者重置助记符
#keymap.back : left, c, backspace # 启用前进或者后退键
#keymap.forward : right, v # 左手快速导航
#keymap.pan : p # 移动助记符
#keymap.zoom : o # 缩放助记符
#keymap.save : s # 保存当前视图窗口
#keymap.grid : g # 当前坐标轴的网格开关
#keymap.yscale : l # y轴缩放(对数/线性)
#keymap.xscale : L, k # x轴缩放(对数/线性)
#keymap.all_axes : a # 启动所有的坐标轴

# 控制下载示例数据。很多的示例可以从matplotlib的git仓库里下载，剔除很多发行时的额外文件。
# 在这种情况下，可以将examples.download设置为False以及
# 将examples.directory设置为你想下载的地方： https://github.com/matplotlib/sample_data 

#examples.download : True # False会忽略下载机制
#examples.directory : '' # 如果download设置为False时的查找目录