matplotlib.github.com/3.4.0/tutorials/introductory/pyplot.html at main · ACPMAD/matplotlib.github.com

History

683 lines (634 loc) · 103 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

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

471

472

473

474

475

476

477

478

479

480

481

482

483

484

485

486

487

488

489

490

491

492

493

494

495

496

497

498

499

500

501

502

503

504

505

506

507

508

509

510

511

512

513

514

515

516

517

518

519

520

521

522

523

524

525

526

527

528

529

530

531

532

533

534

535

536

537

538

539

540

541

542

543

544

545

546

547

548

549

550

551

552

553

554

555

556

557

558

559

560

561

562

563

564

565

566

567

568

569

570

571

572

573

574

575

576

577

578

579

580

581

582

583

584

585

586

587

588

589

590

591

592

593

594

595

596

597

598

599

600

601

602

603

604

605

606

607

608

609

610

611

612

613

614

615

616

617

618

619

620

621

622

623

624

625

626

627

628

629

630

631

632

633

634

635

636

637

638

639

640

641

642

643

644

645

646

647

648

649

650

651

652

653

654

655

656

657

658

659

660

661

662

663

664

665

666

667

668

669

670

671

672

673

674

675

676

677

678

679

680

681

682

683

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

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

<head>

<title>Pyplot tutorial — Matplotlib 3.4.0 documentation</title>

title="Search within Matplotlib 3.4.0 documentation"

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

</head><body>

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

<!--

</div>

-->

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px">Version 3.4.0</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="../index.html">Tutorials</a></li>

<li><a href="../../devel/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="sample_plots.html" title="Sample plots in Matplotlib"

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

<a href="usage.html" title="Usage Guide"

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

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

<li class="nav-item nav-item-1"><a href="../../users/index.html" >User's Guide</a> »</li>

<li class="nav-item nav-item-2"><a href="../index.html" accesskey="U">Tutorials</a> »</li>

<li class="nav-item nav-item-this"><a href="">Pyplot tutorial</a></li>

</ul>

</div>

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

<ul>

<li><a class="reference internal" href="#">Pyplot tutorial</a><ul>

<li><a class="reference internal" href="#intro-to-pyplot">Intro to pyplot</a><ul>

<li><a class="reference internal" href="#formatting-the-style-of-your-plot">Formatting the style of your plot</a></li>

</ul>

</li>

<li><a class="reference internal" href="#plotting-with-keyword-strings">Plotting with keyword strings</a></li>

<li><a class="reference internal" href="#plotting-with-categorical-variables">Plotting with categorical variables</a></li>

<li><a class="reference internal" href="#controlling-line-properties">Controlling line properties</a></li>

<li><a class="reference internal" href="#working-with-multiple-figures-and-axes">Working with multiple figures and axes</a></li>

<li><a class="reference internal" href="#working-with-text">Working with text</a><ul>

<li><a class="reference internal" href="#using-mathematical-expressions-in-text">Using mathematical expressions in text</a></li>

<li><a class="reference internal" href="#annotating-text">Annotating text</a></li>

</ul>

</li>

<li><a class="reference internal" href="#logarithmic-and-other-nonlinear-axes">Logarithmic and other nonlinear axes</a></li>

</ul>

</li>

</ul>

<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/tutorials/introductory/pyplot.rst.txt"

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

</div>

Note

Click <a class="reference internal" href="#sphx-glr-download-tutorials-introductory-pyplot-py">here</a> to download the full example code

</div>

<h1>Pyplot tutorial<a class="headerlink" href="#pyplot-tutorial" title="Permalink to this headline">¶</a></h1>

An introduction to the pyplot interface.

<h2>Intro to pyplot<a class="headerlink" href="#intro-to-pyplot" title="Permalink to this headline">¶</a></h2>

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.html#module-matplotlib.pyplot" title="matplotlib.pyplot"><code class="xref py py-mod docutils literal notranslate">matplotlib.pyplot</code></a> is a collection of functions

that make matplotlib work like MATLAB.

Each <code class="docutils literal notranslate">pyplot</code> function makes

some change to a figure: e.g., creates a figure, creates a plotting area

in a figure, plots some lines in a plotting area, decorates the plot

with labels, etc.

In <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.html#module-matplotlib.pyplot" title="matplotlib.pyplot"><code class="xref py py-mod docutils literal notranslate">matplotlib.pyplot</code></a> various states are preserved

across function calls, so that it keeps track of things like

the current figure and plotting area, and the plotting

functions are directed to the current axes (please note that "axes" here

and in most places in the documentation refers to the axes

<a class="reference internal" href="usage.html#figure-parts">part of a figure</a>

and not the strict mathematical term for more than one axis).

Note

the pyplot API is generally less-flexible than the object-oriented API.

Most of the function calls you see here can also be called as methods

from an <code class="docutils literal notranslate">Axes</code> object. We recommend browsing the tutorials and

examples to see how this works.

</div>

Generating visualizations with pyplot is very quick:

<div class="highlight-default notranslate"><div class="highlight"><pre>import matplotlib.pyplot as plt

<a href="../../api/_as_gen/matplotlib.pyplot.ylabel.html#matplotlib.pyplot.ylabel" title="matplotlib.pyplot.ylabel" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.ylabel</a>('some numbers')

<a href="../../api/_as_gen/matplotlib.pyplot.show.html#matplotlib.pyplot.show" title="matplotlib.pyplot.show" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.show</a>()

</pre></div>

</div>

You may be wondering why the x-axis ranges from 0-3 and the y-axis

from 1-4. If you provide a single list or array to

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot"><code class="xref py py-obj docutils literal notranslate">plot</code></a>, matplotlib assumes it is a

sequence of y values, and automatically generates the x values for

you. Since python ranges start with 0, the default x vector has the

same length as y but starts with 0. Hence the x data are

<code class="docutils literal notranslate">[0, 1, 2, 3]</code>.

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot"><code class="xref py py-obj docutils literal notranslate">plot</code></a> is a versatile function, and will take an arbitrary number of

arguments. For example, to plot x versus y, you can write:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>([1, 2, 3, 4], [1, 4, 9, 16])

</pre></div>

</div>

Out:

<div class="sphx-glr-script-out highlight-none notranslate"><div class="highlight"><pre>[<matplotlib.lines.Line2D object at 0x7f57e40859a0>]

</pre></div>

</div>

<h3>Formatting the style of your plot<a class="headerlink" href="#formatting-the-style-of-your-plot" title="Permalink to this headline">¶</a></h3>

For every x, y pair of arguments, there is an optional third argument

which is the format string that indicates the color and line type of

the plot. The letters and symbols of the format string are from

MATLAB, and you concatenate a color string with a line style string.

The default format string is 'b-', which is a solid blue line. For

example, to plot the above with red circles, you would issue

<a href="../../api/_as_gen/matplotlib.pyplot.axis.html#matplotlib.pyplot.axis" title="matplotlib.pyplot.axis" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.axis</a>([0, 6, 0, 20])

</pre></div>

</div>

See the <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot"><code class="xref py py-obj docutils literal notranslate">plot</code></a> documentation for a complete

list of line styles and format strings. The

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.axis.html#matplotlib.pyplot.axis" title="matplotlib.pyplot.axis"><code class="xref py py-obj docutils literal notranslate">axis</code></a> function in the example above takes a

list of <code class="docutils literal notranslate">[xmin, xmax, ymin, ymax]</code> and specifies the viewport of the

axes.

If matplotlib were limited to working with lists, it would be fairly

useless for numeric processing. Generally, you will use <a class="reference external" href="http://www.numpy.org">numpy</a> arrays. In fact, all sequences are

converted to numpy arrays internally. The example below illustrates

plotting several lines with different format styles in one function call

using arrays.

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

# evenly sampled time at 200ms intervals

# red dashes, blue squares and green triangles

<a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>, 'r--', <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>**2, 'bs', <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>**3, 'g^')

</pre></div>

</div>

</div>

<h2>Plotting with keyword strings<a class="headerlink" href="#plotting-with-keyword-strings" title="Permalink to this headline">¶</a></h2>

There are some instances where you have data in a format that lets you

access particular variables with strings. For example, with

<a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.recarray.html#numpy.recarray" title="(in NumPy v1.20)"><code class="xref py py-obj docutils literal notranslate">numpy.recarray</code></a> or <a class="reference external" href="https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.html#pandas.DataFrame" title="(in pandas v1.2.3)"><code class="xref py py-obj docutils literal notranslate">pandas.DataFrame</code></a>.

Matplotlib allows you provide such an object with

the <code class="docutils literal notranslate">data</code> keyword argument. If provided, then you may generate plots with

the strings corresponding to these variables.

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a> = {'a': <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.arange.html#numpy.arange" title="numpy.arange" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-function">np.arange</a>(50),

'c': <a href="https://docs.scipy.org/doc/numpy/reference/random/generated/numpy.random.randint.html#numpy.random.randint" title="numpy.random.randint" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function">np.random.randint</a>(0, 50, 50),

'd': <a href="https://docs.scipy.org/doc/numpy/reference/random/generated/numpy.random.randn.html#numpy.random.randn" title="numpy.random.randn" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function">np.random.randn</a>(50)}

<a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>['b'] = <a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>['a'] + 10 * <a href="https://docs.scipy.org/doc/numpy/reference/random/generated/numpy.random.randn.html#numpy.random.randn" title="numpy.random.randn" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function">np.random.randn</a>(50)

<a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>['d'] = <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.abs</a>(<a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>['d']) * 100

<a href="../../api/_as_gen/matplotlib.pyplot.scatter.html#matplotlib.pyplot.scatter" title="matplotlib.pyplot.scatter" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.scatter</a>('a', 'b', c='c', <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">s</a>='d', <a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>=<a href="https://docs.python.org/3/library/stdtypes.html#dict" title="builtins.dict" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">data</a>)

<a href="../../api/_as_gen/matplotlib.pyplot.xlabel.html#matplotlib.pyplot.xlabel" title="matplotlib.pyplot.xlabel" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.xlabel</a>('entry a')

</pre></div>

</div>

</div>

<h2>Plotting with categorical variables<a class="headerlink" href="#plotting-with-categorical-variables" title="Permalink to this headline">¶</a></h2>

It is also possible to create a plot using categorical variables.

Matplotlib allows you to pass categorical variables directly to

many plotting functions. For example:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="https://docs.python.org/3/library/stdtypes.html#list" title="builtins.list" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">names</a> = ['group_a', 'group_b', 'group_c']

<a href="https://docs.python.org/3/library/stdtypes.html#list" title="builtins.list" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">values</a> = [1, 10, 100]

<a href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.figure</a>(figsize=(9, 3))

<a href="../../api/_as_gen/matplotlib.pyplot.subplot.html#matplotlib.pyplot.subplot" title="matplotlib.pyplot.subplot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.subplot</a>(131)

<a href="../../api/_as_gen/matplotlib.pyplot.bar.html#matplotlib.pyplot.bar" title="matplotlib.pyplot.bar" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.bar</a>(<a href="https://docs.python.org/3/library/stdtypes.html#list" title="builtins.list" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">names</a>, <a href="https://docs.python.org/3/library/stdtypes.html#list" title="builtins.list" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">values</a>)

<a href="../../api/_as_gen/matplotlib.pyplot.suptitle.html#matplotlib.pyplot.suptitle" title="matplotlib.pyplot.suptitle" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.suptitle</a>('Categorical Plotting')

</pre></div>

</div>

</div>

<h2>Controlling line properties<a class="headerlink" href="#controlling-line-properties" title="Permalink to this headline">¶</a></h2>

Lines have many attributes that you can set: linewidth, dash style,

antialiased, etc; see <a class="reference internal" href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D"><code class="xref py py-obj docutils literal notranslate">matplotlib.lines.Line2D</code></a>. There are

several ways to set line properties

<ul>

<li>Use keyword args:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">x</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">y</a>, linewidth=2.0)

</pre></div>

</div>

</li>

<li>Use the setter methods of a <code class="docutils literal notranslate">Line2D</code> instance. <code class="docutils literal notranslate">plot</code> returns a list

of <code class="docutils literal notranslate">Line2D</code> objects; e.g., <code class="docutils literal notranslate">line1, line2 = plot(x1, y1, x2, y2)</code>. In the code

below we will suppose that we have only

one line so that the list returned is of length 1. We use tuple unpacking with

<code class="docutils literal notranslate">line,</code> to get the first element of that list:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D" class="sphx-glr-backref-module-matplotlib-lines sphx-glr-backref-type-py-class sphx-glr-backref-instance">line</a>, = <a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">x</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">y</a>, '-')

</pre></div>

</div>

</li>

<li>Use <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.setp.html#matplotlib.pyplot.setp" title="matplotlib.pyplot.setp"><code class="xref py py-obj docutils literal notranslate">setp</code></a>. The example below

uses a MATLAB-style function to set multiple properties

on a list of lines. <code class="docutils literal notranslate">setp</code> works transparently with a list of objects

or a single object. You can either use python keyword arguments or

MATLAB-style string/value pairs:

<div class="highlight-default notranslate"><div class="highlight"><pre>lines = <a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(x1, y1, x2, y2)

# use keyword args

plt.setp(lines, color='r', linewidth=2.0)

# or MATLAB style string value pairs

plt.setp(lines, 'color', 'r', 'linewidth', 2.0)

</pre></div>

</div>

</li>

</ul>

Here are the available <a class="reference internal" href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D"><code class="xref py py-obj docutils literal notranslate">Line2D</code></a> properties.

</colgroup>

<tr class="row-odd"><th class="head">Property</th>

<th class="head">Value Type</th>

</tr>

</thead>

<tr class="row-even"><td>alpha</td>

<td>float</td>

</tr>

<tr class="row-odd"><td>animated</td>

<td>[True | False]</td>

</tr>

<tr class="row-even"><td>antialiased or aa</td>

<td>[True | False]</td>

</tr>

<td>a matplotlib.transform.Bbox instance</td>

</tr>

<td>[True | False]</td>

</tr>

<td>a Path instance and a Transform instance, a Patch</td>

</tr>

<tr class="row-even"><td>color or c</td>

<td>any matplotlib color</td>

</tr>

<tr class="row-odd"><td>contains</td>

<td>the hit testing function</td>

</tr>

<tr class="row-even"><td>dash_capstyle</td>

<td>[<code class="docutils literal notranslate">'butt'</code> | <code class="docutils literal notranslate">'round'</code> | <code class="docutils literal notranslate">'projecting'</code>]</td>

</tr>

<tr class="row-odd"><td>dash_joinstyle</td>

<td>[<code class="docutils literal notranslate">'miter'</code> | <code class="docutils literal notranslate">'round'</code> | <code class="docutils literal notranslate">'bevel'</code>]</td>

</tr>

<tr class="row-even"><td>dashes</td>

<td>sequence of on/off ink in points</td>

</tr>

<td>(np.array xdata, np.array ydata)</td>

</tr>

<tr class="row-even"><td>figure</td>

<td>a matplotlib.figure.Figure instance</td>

</tr>

<tr class="row-odd"><td>label</td>

<td>any string</td>

</tr>

<tr class="row-even"><td>linestyle or ls</td>

<td>[ <code class="docutils literal notranslate">'-'</code> | <code class="docutils literal notranslate">'--'</code> | <code class="docutils literal notranslate">'-.'</code> | <code class="docutils literal notranslate">':'</code> | <code class="docutils literal notranslate">'steps'</code> | ...]</td>

</tr>

<tr class="row-odd"><td>linewidth or lw</td>

<td>float value in points</td>

</tr>

<tr class="row-even"><td>marker</td>

</tr>

<tr class="row-odd"><td>markeredgecolor or mec</td>

<td>any matplotlib color</td>

</tr>

<tr class="row-even"><td>markeredgewidth or mew</td>

<td>float value in points</td>

</tr>

<tr class="row-odd"><td>markerfacecolor or mfc</td>

<td>any matplotlib color</td>

</tr>

<tr class="row-even"><td>markersize or ms</td>

<td>float</td>

</tr>

<tr class="row-odd"><td>markevery</td>

<td>[ None | integer | (startind, stride) ]</td>

</tr>

<tr class="row-even"><td>picker</td>

<td>used in interactive line selection</td>

</tr>

<tr class="row-odd"><td>pickradius</td>

<td>the line pick selection radius</td>

</tr>

<tr class="row-even"><td>solid_capstyle</td>

</tr>

<tr class="row-odd"><td>solid_joinstyle</td>

</tr>

<tr class="row-even"><td>transform</td>

<td>a matplotlib.transforms.Transform instance</td>

</tr>

<tr class="row-odd"><td>visible</td>

<td>[True | False]</td>

</tr>

<tr class="row-even"><td>xdata</td>

<td>np.array</td>

</tr>

<tr class="row-odd"><td>ydata</td>

<td>np.array</td>

</tr>

<tr class="row-even"><td>zorder</td>

<td>any number</td>

</tr>

</tbody>

</table>

To get a list of settable line properties, call the

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.setp.html#matplotlib.pyplot.setp" title="matplotlib.pyplot.setp"><code class="xref py py-obj docutils literal notranslate">setp</code></a> function with a line or lines as argument

<div class="highlight-ipython notranslate"><div class="highlight"><pre>In [69]: lines = <a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>([1, 2, 3])

In [70]: plt.setp(lines)

alpha: float

animated: [True | False]

antialiased or aa: [True | False]

...snip

</pre></div>

</div>

<h2>Working with multiple figures and axes<a class="headerlink" href="#working-with-multiple-figures-and-axes" title="Permalink to this headline">¶</a></h2>

MATLAB, and <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.html#module-matplotlib.pyplot" title="matplotlib.pyplot"><code class="xref py py-mod docutils literal notranslate">pyplot</code></a>, have the concept of the current figure

and the current axes. All plotting functions apply to the current

axes. The function <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.gca.html#matplotlib.pyplot.gca" title="matplotlib.pyplot.gca"><code class="xref py py-obj docutils literal notranslate">gca</code></a> returns the current axes (a

<a class="reference internal" href="../../api/axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-obj docutils literal notranslate">matplotlib.axes.Axes</code></a> instance), and <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.gcf.html#matplotlib.pyplot.gcf" title="matplotlib.pyplot.gcf"><code class="xref py py-obj docutils literal notranslate">gcf</code></a> returns the current

figure (a <a class="reference internal" href="../../api/figure_api.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure"><code class="xref py py-obj docutils literal notranslate">matplotlib.figure.Figure</code></a> instance). Normally, you don't have to

worry about this, because it is all taken care of behind the scenes. Below

is a script to create two subplots.

<div class="highlight-default notranslate"><div class="highlight"><pre>def f(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>):

return <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.exp</a>(-<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>) * <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.cos</a>(2*<a href="https://docs.python.org/3/library/functions.html#float" title="builtins.float" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.pi</a>*<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>)

<a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t1</a>, f(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t1</a>), 'bo', <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t2</a>, f(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t2</a>), 'k')

<a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t2</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.cos</a>(2*<a href="https://docs.python.org/3/library/functions.html#float" title="builtins.float" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">np.pi</a>*<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t2</a>), 'r--')

</pre></div>

</div>

The <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure"><code class="xref py py-obj docutils literal notranslate">figure</code></a> call here is optional because a figure will be created

if none exists, just as an axes will be created (equivalent to an explicit

<code class="docutils literal notranslate">subplot()</code> call) if none exists.

The <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.subplot.html#matplotlib.pyplot.subplot" title="matplotlib.pyplot.subplot"><code class="xref py py-obj docutils literal notranslate">subplot</code></a> call specifies <code class="docutils literal notranslate">numrows,

numcols, plot_number</code> where <code class="docutils literal notranslate">plot_number</code> ranges from 1 to

<code class="docutils literal notranslate">numrows*numcols</code>. The commas in the <code class="docutils literal notranslate">subplot</code> call are

optional if <code class="docutils literal notranslate">numrows*numcols<10</code>. So <code class="docutils literal notranslate">subplot(211)</code> is identical

to <code class="docutils literal notranslate">subplot(2, 1, 1)</code>.

You can create an arbitrary number of subplots

and axes. If you want to place an axes manually, i.e., not on a

rectangular grid, use <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.axes.html#matplotlib.pyplot.axes" title="matplotlib.pyplot.axes"><code class="xref py py-obj docutils literal notranslate">axes</code></a>,

which allows you to specify the location as <code class="docutils literal notranslate">axes([left, bottom,

width, height])</code> where all values are in fractional (0 to 1)

coordinates. See <a class="reference internal" href="../../gallery/subplots_axes_and_figures/axes_demo.html">Axes Demo</a> for an example of

placing axes manually and <a class="reference internal" href="../../gallery/subplots_axes_and_figures/subplot_demo.html">Basic Subplot Demo</a> for an

example with lots of subplots.

You can create multiple figures by using multiple

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure"><code class="xref py py-obj docutils literal notranslate">figure</code></a> calls with an increasing figure

number. Of course, each figure can contain as many axes and subplots

as your heart desires:

<a href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.figure</a>(1) # the first figure

<a href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.figure</a>(2) # a second figure

<a href="../../api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.figure</a>(1) # figure 1 current; subplot(212) still current

<a href="../../api/_as_gen/matplotlib.pyplot.title.html#matplotlib.pyplot.title" title="matplotlib.pyplot.title" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.title</a>('Easy as 1, 2, 3') # subplot 211 title

</pre></div>

</div>

You can clear the current figure with <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.clf.html#matplotlib.pyplot.clf" title="matplotlib.pyplot.clf"><code class="xref py py-obj docutils literal notranslate">clf</code></a>

and the current axes with <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.cla.html#matplotlib.pyplot.cla" title="matplotlib.pyplot.cla"><code class="xref py py-obj docutils literal notranslate">cla</code></a>. If you find

it annoying that states (specifically the current image, figure and axes)

are being maintained for you behind the scenes, don't despair: this is just a thin

stateful wrapper around an object oriented API, which you can use

instead (see <a class="reference internal" href="../intermediate/artists.html">Artist tutorial</a>)

If you are making lots of figures, you need to be aware of one

more thing: the memory required for a figure is not completely

released until the figure is explicitly closed with

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.close.html#matplotlib.pyplot.close" title="matplotlib.pyplot.close"><code class="xref py py-obj docutils literal notranslate">close</code></a>. Deleting all references to the

figure, and/or using the window manager to kill the window in which

the figure appears on the screen, is not enough, because pyplot

maintains internal references until <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.close.html#matplotlib.pyplot.close" title="matplotlib.pyplot.close"><code class="xref py py-obj docutils literal notranslate">close</code></a>

is called.

</div>

<h2>Working with text<a class="headerlink" href="#working-with-text" title="Permalink to this headline">¶</a></h2>

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.text.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text"><code class="xref py py-obj docutils literal notranslate">text</code></a> can be used to add text in an arbitrary location, and

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.xlabel.html#matplotlib.pyplot.xlabel" title="matplotlib.pyplot.xlabel"><code class="xref py py-obj docutils literal notranslate">xlabel</code></a>, <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.ylabel.html#matplotlib.pyplot.ylabel" title="matplotlib.pyplot.ylabel"><code class="xref py py-obj docutils literal notranslate">ylabel</code></a> and <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.title.html#matplotlib.pyplot.title" title="matplotlib.pyplot.title"><code class="xref py py-obj docutils literal notranslate">title</code></a> are used to add

text in the indicated locations (see <a class="reference internal" href="../text/text_intro.html">Text in Matplotlib Plots</a> for a

more detailed example)

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="https://docs.python.org/3/library/functions.html#int" title="builtins.int" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">mu</a>, <a href="https://docs.python.org/3/library/functions.html#int" title="builtins.int" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance">sigma</a> = 100, 15

# the histogram of the data

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">n</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">bins</a>, <a href="../../api/container_api.html#matplotlib.container.BarContainer" title="matplotlib.container.BarContainer" class="sphx-glr-backref-module-matplotlib-container sphx-glr-backref-type-py-class sphx-glr-backref-instance">patches</a> = <a href="../../api/_as_gen/matplotlib.pyplot.hist.html#matplotlib.pyplot.hist" title="matplotlib.pyplot.hist" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.hist</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">x</a>, 50, density=1, facecolor='g', alpha=0.75)

<a href="../../api/_as_gen/matplotlib.pyplot.text.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.text</a>(60, .025, r'$\mu=100,\ \sigma=15$')

<a href="../../api/_as_gen/matplotlib.pyplot.axis.html#matplotlib.pyplot.axis" title="matplotlib.pyplot.axis" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.axis</a>([40, 160, 0, 0.03])

<a href="../../api/_as_gen/matplotlib.pyplot.grid.html#matplotlib.pyplot.grid" title="matplotlib.pyplot.grid" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.grid</a>(True)

</pre></div>

</div>

All of the <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.text.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text"><code class="xref py py-obj docutils literal notranslate">text</code></a> functions return a <a class="reference internal" href="../../api/text_api.html#matplotlib.text.Text" title="matplotlib.text.Text"><code class="xref py py-obj docutils literal notranslate">matplotlib.text.Text</code></a>

instance. Just as with lines above, you can customize the properties by

passing keyword arguments into the text functions or using <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.setp.html#matplotlib.pyplot.setp" title="matplotlib.pyplot.setp"><code class="xref py py-obj docutils literal notranslate">setp</code></a>:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a> = <a href="../../api/_as_gen/matplotlib.pyplot.xlabel.html#matplotlib.pyplot.xlabel" title="matplotlib.pyplot.xlabel" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.xlabel</a>('my data', fontsize=14, color='red')

</pre></div>

</div>

These properties are covered in more detail in <a class="reference internal" href="../text/text_props.html">Text properties and layout</a>.

<h3>Using mathematical expressions in text<a class="headerlink" href="#using-mathematical-expressions-in-text" title="Permalink to this headline">¶</a></h3>

matplotlib accepts TeX equation expressions in any text expression.

For example to write the expression $\sigma_i=15$ in the title,

you can write a TeX expression surrounded by dollar signs:

<div class="highlight-default notranslate"><div class="highlight"><pre><a href="../../api/_as_gen/matplotlib.pyplot.title.html#matplotlib.pyplot.title" title="matplotlib.pyplot.title" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.title</a>(r'$\sigma_i=15$')

</pre></div>

</div>

The <code class="docutils literal notranslate">r</code> preceding the title string is important -- it signifies

that the string is a raw string and not to treat backslashes as

python escapes. matplotlib has a built-in TeX expression parser and

layout engine, and ships its own math fonts -- for details see

<a class="reference internal" href="../text/mathtext.html">Writing mathematical expressions</a>. Thus you can use mathematical text across platforms

without requiring a TeX installation. For those who have LaTeX and

dvipng installed, you can also use LaTeX to format your text and

incorporate the output directly into your display figures or saved

postscript -- see <a class="reference internal" href="../text/usetex.html">Text rendering With LaTeX</a>.

</div>

<h3>Annotating text<a class="headerlink" href="#annotating-text" title="Permalink to this headline">¶</a></h3>

The uses of the basic <a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.text.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text"><code class="xref py py-obj docutils literal notranslate">text</code></a> function above

place text at an arbitrary position on the Axes. A common use for

text is to annotate some feature of the plot, and the

<a class="reference internal" href="../../api/_as_gen/matplotlib.pyplot.annotate.html#matplotlib.pyplot.annotate" title="matplotlib.pyplot.annotate"><code class="xref py py-obj docutils literal notranslate">annotate</code></a> method provides helper

functionality to make annotations easy. In an annotation, there are

two points to consider: the location being annotated represented by

the argument <code class="docutils literal notranslate">xy</code> and the location of the text <code class="docutils literal notranslate">xytext</code>. Both of

these arguments are <code class="docutils literal notranslate">(x, y)</code> tuples.

<div class="highlight-default notranslate"><div class="highlight"><pre>ax = <a href="../../api/_as_gen/matplotlib.pyplot.subplot.html#matplotlib.pyplot.subplot" title="matplotlib.pyplot.subplot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.subplot</a>()

<a href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D" class="sphx-glr-backref-module-matplotlib-lines sphx-glr-backref-type-py-class sphx-glr-backref-instance">line</a>, = <a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.plot</a>(<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">t</a>, <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance">s</a>, lw=2)

<a href="../../api/_as_gen/matplotlib.pyplot.annotate.html#matplotlib.pyplot.annotate" title="matplotlib.pyplot.annotate" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.annotate</a>('local max', xy=(2, 1), xytext=(3, 1.5),

arrowprops=dict(facecolor='black', shrink=0.05),

)

<a href="../../api/_as_gen/matplotlib.pyplot.ylim.html#matplotlib.pyplot.ylim" title="matplotlib.pyplot.ylim" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.ylim</a>(-2, 2)

</pre></div>

</div>

In this basic example, both the <code class="docutils literal notranslate">xy</code> (arrow tip) and <code class="docutils literal notranslate">xytext</code>

locations (text location) are in data coordinates. There are a

variety of other coordinate systems one can choose -- see

<a class="reference internal" href="../text/annotations.html#annotations-tutorial">Basic annotation</a> and <a class="reference internal" href="../text/annotations.html#plotting-guide-annotation">Advanced Annotations</a> for

details. More examples can be found in

<a class="reference internal" href="../../gallery/text_labels_and_annotations/annotation_demo.html">Annotating Plots</a>.

</div>

<h2>Logarithmic and other nonlinear axes<a class="headerlink" href="#logarithmic-and-other-nonlinear-axes" title="Permalink to this headline">¶</a></h2>

logarithmic and logit scales. This is commonly used if data spans many orders

of magnitude. Changing the scale of an axis is easy:

<div>plt.xscale('log')</div></blockquote>

An example of four plots with the same data and different scales for the y axis

is shown below.

<div class="highlight-default notranslate"><div class="highlight"><pre># Fixing random state for reproducibility

<a href="https://docs.scipy.org/doc/numpy/reference/random/generated/numpy.random.seed.html#numpy.random.seed" title="numpy.random.seed" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function">np.random.seed</a>(19680801)

# make up some data in the open interval (0, 1)

# plot with various axes scales

# linear

<a href="../../api/_as_gen/matplotlib.pyplot.yscale.html#matplotlib.pyplot.yscale" title="matplotlib.pyplot.yscale" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.yscale</a>('linear')

# log

# symmetric log

# logit

# Adjust the subplot layout, because the logit one may take more space

# than usual, due to y-tick labels like "1 - 10^{-3}"

<a href="../../api/_as_gen/matplotlib.pyplot.subplots_adjust.html#matplotlib.pyplot.subplots_adjust" title="matplotlib.pyplot.subplots_adjust" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function">plt.subplots_adjust</a>(top=0.92, bottom=0.08, left=0.10, right=0.95, hspace=0.25,

wspace=0.35)

</pre></div>

</div>

It is also possible to add your own scale, see <a class="reference internal" href="../../devel/add_new_projection.html#adding-new-scales">Developer's guide for creating scales and transformations</a> for

details.

Total running time of the script: ( 0 minutes 3.541 seconds)

<a class="reference download internal" download="" href="../../_downloads/c95c51c685ba2e2186f17d8368f80504/pyplot.py"><code class="xref download docutils literal notranslate">Download Python source code: pyplot.py</code></a></div>

<a class="reference download internal" download="" href="../../_downloads/8f46e9733d1ce7f9830abea476d2fecb/pyplot.ipynb"><code class="xref download docutils literal notranslate">Download Jupyter notebook: pyplot.ipynb</code></a></div>

</div>

Keywords: matplotlib code example, codex, python plot, pyplot

<a class="reference external" href="https://sphinx-gallery.readthedocs.io">Gallery generated by Sphinx-Gallery</a>

</div>

</div>

Last updated on Mar 26, 2021.

Created using

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

Doc version v3.4.0-2-gcb03754703.

</div>

</footer>

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){

(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),

m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)

})(window,document,'script','//www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-55954603-1', 'auto');

ga('send', 'pageview');

</script>

</body>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

pyplot.html

Latest commit

History

pyplot.html

File metadata and controls