matplotlib.github.com/3.3.4/devel/color_changes.html at main · matplotlib/matplotlib.github.com

History

289 lines (256 loc) · 20.3 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<title>Default Color changes — Matplotlib 3.3.4 documentation</title>

title="Search within Matplotlib 3.3.4 documentation"

href="../_static/opensearch.xml"/>

</head><body>

<div id="unreleased-message"> You are reading an old version of the documentation (v3.3.4). For the latest version see <a href="https://matplotlib.org/stable/devel/color_changes.html">https://matplotlib.org/stable/devel/color_changes.html</a></div>

<!--

</div>

-->

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px">Version 3.3.4</div>

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div>

</div>

<ul>

<li><a href="../users/installing.html">Installation</a></li>

<li><a href="../contents.html">Documentation</a></li>

<li><a href="../gallery/index.html">Examples</a></li>

<li><a href="../tutorials/index.html">Tutorials</a></li>

<li><a href="index.html">Contributing</a></li>

</form>

</li>

</ul>

</nav>

<h3>Navigation</h3>

<ul>

<a href="../genindex.html" title="General Index"

accesskey="I">index</a></li>

<a href="../py-modindex.html" title="Python Module Index"

>modules</a> |</li>

<a href="../glossary/index.html" title="Glossary"

accesskey="N">next</a> |</li>

<a href="license.html" title="Licenses"

accesskey="P">previous</a> |</li>

<li><a href="../contents.html">contents</a> »</li>

<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">The Matplotlib Developers' Guide</a> »</li>

<li class="nav-item nav-item-this"><a href="">Default Color changes</a></li>

</ul>

</div>

<h3><a href="../contents.html">Table of Contents</a></h3>

<ul>

<li><a class="reference internal" href="#">Default Color changes</a><ul>

<li><a class="reference internal" href="#default-heat-map-colormap">Default Heat Map Colormap</a><ul>

<li><a class="reference internal" href="#example-script">Example script</a></li>

<li><a class="reference internal" href="#proposed-colormaps">Proposed Colormaps</a></li>

</ul>

</li>

<li><a class="reference internal" href="#default-scatter-colormap">Default Scatter Colormap</a><ul>

<li><a class="reference internal" href="#id1">Example script</a></li>

<li><a class="reference internal" href="#id2">Proposed Colormaps</a></li>

</ul>

</li>

<li><a class="reference internal" href="#color-cycle-qualitative-color-map">Color Cycle / Qualitative color map</a><ul>

<li><a class="reference internal" href="#id3">Example script</a></li>

<li><a class="reference internal" href="#proposed-color-cycle">Proposed Color cycle</a></li>

</ul>

</li>

</ul>

</li>

</ul>

<h3>Related Topics</h3>

<ul>

<li><a href="../contents.html">Documentation overview</a><ul>

<li><a href="index.html">The Matplotlib Developers' Guide</a><ul>

<li>Previous: <a href="license.html" title="previous chapter">Licenses</a></li>

<li>Next: <a href="../glossary/index.html" title="next chapter">Glossary</a></li>

</ul></li>

</ul>

</div>

<div id="sidebar-pagesource" role="note" aria-label="source link"

style="margin-top: 1.5em; padding-top: 0.1em; border-top: 1px solid #86989b">

<a href="../_sources/devel/color_changes.rst.txt"

style="color: #c0c0c0" rel="nofollow">Show Page Source</a>

</div>

<h1>Default Color changes<a class="headerlink" href="#default-color-changes" title="Permalink to this headline">¶</a></h1>

As discussed at length elsewhere [insert links], <code class="docutils literal notranslate">jet</code> is an

empirically bad color map and should not be the default color map.

Due to the position that changing the appearance of the plot breaks

backward compatibility, this change has been put off for far longer

than it should have been. In addition to changing the default color

map we plan to take the chance to change the default color-cycle on

plots and to adopt a different color map for filled plots (<code class="docutils literal notranslate">imshow</code>,

<code class="docutils literal notranslate">pcolor</code>, <code class="docutils literal notranslate">contourf</code>, etc) and for scatter like plots.

<h2>Default Heat Map Colormap<a class="headerlink" href="#default-heat-map-colormap" title="Permalink to this headline">¶</a></h2>

The choice of a new color map is fertile ground to bike-shedding ("No,

it should be _this_ color") so we have a proposed set criteria (via

Nathaniel Smith) to evaluate proposed color maps.

<li>it should be a sequential colormap, because diverging colormaps are

really misleading unless you know where the "center" of the data is,

and for a default colormap we generally won't.</li>

<li>it should be perceptually uniform, i.e., human subjective judgments

of how far apart nearby colors are should correspond as linearly as

possible to the difference between the numerical values they

represent, at least locally.</li>

<li>it should have a perceptually uniform luminance ramp, i.e. if you

convert to greyscale it should still be uniform. This is useful both

in practical terms (greyscale printers are still a thing!) and

because luminance is a very strong and natural cue to magnitude.</li>

<li>it should also have some kind of variation in hue, because hue

variation is a really helpful additional cue to perception, having

two cues is better than one, and there's no reason not to do it.</li>

<li>the hue variation should be chosen to produce reasonable results

even for viewers with the more common types of

colorblindness. (Which rules out things like red-to-green.)</li>

<li>For bonus points, it would be nice to choose a hue ramp that still

works if you throw away the luminance variation, because then we

could use the version with varying luminance for 2d plots, and the

version with just hue variation for 3d plots. (In 3d plots you

really want to reserve the luminance channel for lighting/shading,

because your brain is really good at extracting 3d shape from

luminance variation. If the 3d surface itself has massively varying

luminance then this screws up the ability to see shape.)</li>

<li>Not infringe any existing IP</li>

</ul>

<h3>Example script<a class="headerlink" href="#example-script" title="Permalink to this headline">¶</a></h3>

</div>

<h3>Proposed Colormaps<a class="headerlink" href="#proposed-colormaps" title="Permalink to this headline">¶</a></h3>

</div>

<h2>Default Scatter Colormap<a class="headerlink" href="#default-scatter-colormap" title="Permalink to this headline">¶</a></h2>

For heat-map like applications it can be desirable to cover as much of

the luminance scale as possible, however when color mapping markers,

having markers too close to white can be a problem. For that reason

we propose using a different (but maybe related) color map to the

heat map for marker-based. The design parameters are the same as

above, only with a more limited luminance variation.

<h3>Example script<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>

<div class="highlight-default notranslate"><div class="highlight"><pre>import numpy as np

import matplotlib.pyplot as plt

np.random.seed(1234)

fig, (ax1, ax2) = plt.subplots(1, 2)

N = 50

x = np.random.rand(N)

y = np.random.rand(N)

colors = np.random.rand(N)

area = np.pi * (15 * np.random.rand(N))**2 # 0 to 15 point radiuses

ax1.scatter(x, y, s=area, c=colors, alpha=0.5)

X,Y = np.meshgrid(np.arange(0, 2*np.pi, .2),

np.arange(0, 2*np.pi, .2))

U = np.cos(X)

V = np.sin(Y)

Q = ax2.quiver(X, Y, U, V, units='width')

qd = np.random.rand(np.prod(X.shape))

Q.set_array(qd)

</pre></div>

</div>

<h3>Proposed Colormaps<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>

</div>

<h2>Color Cycle / Qualitative color map<a class="headerlink" href="#color-cycle-qualitative-color-map" title="Permalink to this headline">¶</a></h2>

When plotting lines it is frequently desirable to plot multiple lines

or artists which need to be distinguishable, but there is no inherent

ordering.

<h3>Example script<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>

<div class="highlight-default notranslate"><div class="highlight"><pre>import numpy as np

import matplotlib.pyplot as plt

x = np.linspace(0, 1, 10)

for j in range(10):

ax1.plot(x, x * j)

th = np.linspace(0, 2*np.pi, 1024)

for j in np.linspace(0, np.pi, 10):

ax2.plot(th, np.sin(th + j))

ax2.set_xlim(0, 2*np.pi)

</pre></div>

</div>

<h3>Proposed Color cycle<a class="headerlink" href="#proposed-color-cycle" title="Permalink to this headline">¶</a></h3>

</div>

</div>

Last updated on Jan 28, 2021.

Created using

<a href="http://sphinx-doc.org/">Sphinx</a> 3.1.1.

Doc version v3.3.4.

</div>

</footer>

</body>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

color_changes.html

Latest commit

History

color_changes.html

File metadata and controls