Created
December 22, 2019 12:31
-
-
Save jorgepiloto/db807a7ee3a0bcfbaea38fc9cd7ac95e to your computer and use it in GitHub Desktop.
plot_sin.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# -*- coding: utf-8 -*- | |
""" | |
Introductory example - Plotting sin | |
=================================== | |
This is a general example demonstrating a Matplotlib plot output, embedded | |
rST, the use of math notation and cross-linking to other examples. It would be | |
useful to compare the :download:`source Python file <plot_0_sin.py>` with the | |
output below. | |
Source files for gallery examples should start with a triple-quoted header | |
docstring. Anything before the docstring is ignored by Sphinx-Gallery and will | |
not appear in the rendered output, nor will it be executed. This docstring | |
requires a rST header, which is used as the title of the example and | |
to correctly build cross-referencing links. | |
Code and embedded rST text blocks follow the docstring. The first block | |
immediately after the docstring is deemed a code block, by default, unless you | |
specify it to be a text block using a line of ``#``'s or ``#%%`` (see below). | |
All code blocks get executed by Sphinx-Gallery and any output, including plots | |
will be captured. Typically, code and text blocks are interspersed to provide | |
narrative explanations of what the code is doing or interpretations of code | |
output. | |
Mathematical expressions can be included as LaTeX, and will be rendered with | |
MathJax. To include displayed math notation, use the directive ``.. math::``. | |
To include inline math notation use the ``:math:`` role. For example, we are | |
about to plot the following function: | |
.. math:: | |
x \\rightarrow \\sin(x) | |
Here the function :math:`\\sin` is evaluated at each point the variable | |
:math:`x` is defined. When including LaTeX in a Python string, ensure that you | |
escape the backslashes or use a :ref:`raw docstring <python:strings>`. You do | |
not need to do this in text blocks (see below). | |
""" | |
# Code source: Óscar Nájera | |
# License: BSD 3 clause | |
import numpy as np | |
import matplotlib.pyplot as plt | |
x = np.linspace(0, 2 * np.pi, 100) | |
y = np.sin(x) | |
plt.plot(x, y) | |
plt.xlabel('$x$') | |
plt.ylabel('$\sin(x)$') | |
# To avoid matplotlib text output | |
plt.show() | |
#%% | |
# To include embedded rST, use a line of >= 20 ``#``'s or ``#%%`` between your | |
# rST and your code (see :ref:`embedding_rst`). This separates your example | |
# into distinct text and code blocks. You can continue writing code below the | |
# embedded rST text block: | |
print('This example shows a sin plot!') | |
#%% | |
# LaTeX syntax in the text blocks does not require backslashes to be escaped: | |
# | |
# .. math:: | |
# \sin | |
# | |
# Cross referencing | |
# ^^^^^^^^^^^^^^^^^ | |
# | |
# You can refer to an example from any part of the documentation, | |
# including from other examples. Sphinx-Gallery automatically creates reference | |
# labels for each example. The label consists of the ``.py`` file name, | |
# prefixed with ``sphx_glr_`` and the name of the | |
# folder(s) the example is in. In this case, the example we want to | |
# cross-reference is in ``auto_examples`` (the ``gallery_dirs``; see | |
# :ref:`configure_and_use_sphinx_gallery`), then the subdirectory ``no_output`` | |
# (since the example is within a sub-gallery). The file name of the example is | |
# ``plot_syntaxerror.py``. We can thus cross-link to the example 'SyntaxError' | |
# using: | |
# ``:ref:`sphx_glr_auto_examples_no_output_plot_syntaxerror.py```. | |
# | |
# .. seealso:: | |
# :ref:`sphx_glr_auto_examples_no_output_plot_syntaxerror.py` for a | |
# an example with an error. | |
# | |
# .. |docstring| replace:: """ |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment