
.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/plot_0_sin.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_examples_plot_0_sin.py>`
        to download the full example code. or to run this example in your browser via Binder

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_plot_0_sin.py:


Introductory example - Plotting sin
===================================

This is a general example demonstrating a Matplotlib plot output, embedded
reST, 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 reST header, which is used as the title of the example and
to correctly build cross-referencing links.

Code and embedded reST 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).

.. GENERATED FROM PYTHON SOURCE LINES 38-54

.. code-block:: Python


    # Code source: Óscar Nájera
    # License: BSD 3 clause

    import matplotlib.pyplot as plt
    import numpy as np

    x = np.linspace(0, 2 * np.pi, 100)
    y = np.sin(x)

    plt.plot(x, y)
    plt.xlabel(r"$x$")
    plt.ylabel(r"$\sin(x)$")
    # To avoid matplotlib text output
    plt.show()




.. image-sg:: /auto_examples/images/sphx_glr_plot_0_sin_001.png
   :alt: plot 0 sin
   :srcset: /auto_examples/images/sphx_glr_plot_0_sin_001.png, /auto_examples/images/sphx_glr_plot_0_sin_001_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 55-59

To include embedded reST, use a line of >= 20 ``#``'s or ``#%%`` between your
reST 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 reST text block:

.. GENERATED FROM PYTHON SOURCE LINES 59-62

.. code-block:: Python


    print("This example shows a sin plot!")





.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    This example shows a sin plot!




.. GENERATED FROM PYTHON SOURCE LINES 63-90

LaTeX syntax in the text blocks does not require backslashes to be escaped:

.. math::
   \sin

.. _cross_ref_example:

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. Below, 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::
    See :ref:`sphx_glr_auto_examples_no_output_plot_syntaxerror.py` for
    an example with an error.

.. |docstring| replace:: """


.. _sphx_glr_download_auto_examples_plot_0_sin.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: binder-badge

      .. image:: images/binder_badge_logo.svg
        :target: https://mybinder.org/v2/gh/sphinx-gallery/sphinx-gallery.github.io/master?urlpath=lab/tree/notebooks/auto_examples/plot_0_sin.ipynb
        :alt: Launch binder
        :width: 150 px

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: plot_0_sin.ipynb <plot_0_sin.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: plot_0_sin.py <plot_0_sin.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: plot_0_sin.zip <plot_0_sin.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_
