.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/plot_line_styles.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_line_styles.py>`
        to download the full example code.

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

.. _sphx_glr_auto_examples_plot_line_styles.py:


1D Line Styles
==============

Demonstrates the line-style, opacity, and per-point marker parameters
available on :meth:`~anyplotlib.figure_plots.Axes.plot` and
:meth:`~anyplotlib.figure_plots.Plot1D.add_line`.

Four separate figures are shown:

1. **Linestyles** – all four dash patterns on one panel with a legend.
2. **Alpha (transparency)** – two overlapping sine waves, each at 40 % opacity.
3. **Marker symbols** – all seven supported symbols, each on its own offset
   curve.
4. **Combined** – dashed + semi-transparent + circle-marker overlay on a solid
   primary line; demonstrates post-construction setters.

.. GENERATED FROM PYTHON SOURCE LINES 18-38

.. code-block:: Python

    import numpy as np
    import anyplotlib as vw

    t256 = np.linspace(0.0, 2.0 * np.pi, 256)   # dense — good for dashes / alpha
    t24  = np.linspace(0.0, 2.0 * np.pi,  24)   # sparse — makes markers visible

    # ── 1. Linestyles ─────────────────────────────────────────────────────────────
    fig1, ax1 = vw.subplots(1, 1, figsize=(580, 300))

    plot1 = ax1.plot(np.sin(t256),         color="#4fc3f7", linewidth=2,
                     linestyle="solid",    label="solid")
    plot1.add_line(np.sin(t256) + 0.6,    color="#ff7043", linewidth=2,
                   linestyle="dashed",    label="dashed  (\"--\")")
    plot1.add_line(np.sin(t256) + 1.2,    color="#aed581", linewidth=2,
                   linestyle="dotted",    label="dotted  (\":\")")
    plot1.add_line(np.sin(t256) + 1.8,    color="#ce93d8", linewidth=2,
                   linestyle="dashdot",   label="dashdot (\"-.\")")

    fig1





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="fb52f6792" style="display:inline-block;overflow:hidden;position:relative;width:596px;height:316px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_001.html" frameborder="0" scrolling="no" style="width:596px;height:316px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('fb52f6792'),ifr=wrap.querySelector('iframe'),nw=596,nh=316;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 39-51

The ``ls`` shorthand
--------------------
Each linestyle has a single-character (or two-character) shorthand that
matches the matplotlib convention:

* ``"-"``  → ``"solid"``
* ``"--"`` → ``"dashed"``
* ``":"``  → ``"dotted"``
* ``"-."`` → ``"dashdot"``

The shorthands work on both :meth:`~anyplotlib.figure_plots.Axes.plot`
and :meth:`~anyplotlib.figure_plots.Plot1D.add_line`:

.. GENERATED FROM PYTHON SOURCE LINES 51-58

.. code-block:: Python


    fig2a, ax2a = vw.subplots(1, 1, figsize=(440, 220))
    p = ax2a.plot(np.sin(t256), ls="-",  color="#4fc3f7", label='ls="-"')
    p.add_line(np.sin(t256) + 0.8, ls="--", color="#ff7043", label='ls="--"')
    p.add_line(np.sin(t256) + 1.6, ls=":",  color="#aed581", label='ls=":"')
    fig2a





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="f58a66b86" style="display:inline-block;overflow:hidden;position:relative;width:456px;height:236px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_002.html" frameborder="0" scrolling="no" style="width:456px;height:236px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('f58a66b86'),ifr=wrap.querySelector('iframe'),nw=456,nh=236;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 59-64

Alpha (opacity)
---------------
``alpha`` controls line opacity on a 0–1 scale.  Values below 1 let
overlapping curves show through each other — useful for comparing signals
that share the same amplitude range.

.. GENERATED FROM PYTHON SOURCE LINES 64-74

.. code-block:: Python


    fig2, ax2 = vw.subplots(1, 1, figsize=(580, 300))

    plot2 = ax2.plot(np.sin(t256), color="#4fc3f7", alpha=0.4, linewidth=3,
                     label="sin  α=0.4")
    plot2.add_line(np.cos(t256),   color="#ff7043", alpha=0.4, linewidth=3,
                   label="cos  α=0.4")

    fig2





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="fe1c11cdd" style="display:inline-block;overflow:hidden;position:relative;width:596px;height:316px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_003.html" frameborder="0" scrolling="no" style="width:596px;height:316px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('fe1c11cdd'),ifr=wrap.querySelector('iframe'),nw=596,nh=316;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 75-92

Marker symbols
--------------
Set ``marker`` to place a symbol at every data point.  Use a **sparse**
x-axis (few points) so the individual markers are legible.
``markersize`` is the radius (circles / diamonds) or half-side-length
(squares, triangles) in canvas pixels.

Supported symbols:

* ``"o"``  — circle
* ``"s"``  — square
* ``"^"``  — triangle-up
* ``"v"``  — triangle-down
* ``"D"``  — diamond
* ``"+"``  — plus (stroke-only)
* ``"x"``  — cross (stroke-only)
* ``"none"`` — no marker (default)

.. GENERATED FROM PYTHON SOURCE LINES 92-121

.. code-block:: Python


    SYMBOLS = [
        ("o", "#4fc3f7"),
        ("s", "#ff7043"),
        ("^", "#aed581"),
        ("v", "#ce93d8"),
        ("D", "#ffcc02"),
        ("+", "#80cbc4"),
        ("x", "#ef9a9a"),
    ]

    fig3, ax3 = vw.subplots(1, 1, figsize=(580, 380))

    plot3 = ax3.plot(
        np.sin(t24) + (0 - 3) * 0.9,
        color=SYMBOLS[0][1], linewidth=1.5,
        marker=SYMBOLS[0][0], markersize=5,
        label=f'marker="{SYMBOLS[0][0]}"',
    )
    for i, (sym, col) in enumerate(SYMBOLS[1:], 1):
        plot3.add_line(
            np.sin(t24) + (i - 3) * 0.9,
            color=col, linewidth=1.5,
            marker=sym, markersize=5,
            label=f'marker="{sym}"',
        )

    fig3





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="f2de2071b" style="display:inline-block;overflow:hidden;position:relative;width:596px;height:396px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_004.html" frameborder="0" scrolling="no" style="width:596px;height:396px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('f2de2071b'),ifr=wrap.querySelector('iframe'),nw=596,nh=396;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 122-126

Combined — linestyle + alpha + marker
--------------------------------------
All three style parameters can be combined freely on the same line or on
separate overlay lines.

.. GENERATED FROM PYTHON SOURCE LINES 126-141

.. code-block:: Python


    fig4, ax4 = vw.subplots(1, 1, figsize=(580, 300))

    # Dense solid primary line
    plot4 = ax4.plot(np.sin(t256), color="#4fc3f7", linewidth=2,
                     label="sin (solid)")

    # Sparse dashed overlay with circle markers and reduced opacity
    plot4.add_line(np.cos(t24), color="#ff7043", linewidth=2,
                   linestyle="dashed", alpha=0.75,
                   marker="o", markersize=5,
                   label="cos (dashed, α=0.75, marker='o')")

    fig4





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="fdb7457b8" style="display:inline-block;overflow:hidden;position:relative;width:596px;height:316px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_005.html" frameborder="0" scrolling="no" style="width:596px;height:316px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('fdb7457b8'),ifr=wrap.querySelector('iframe'),nw=596,nh=316;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 142-147

Post-construction setters
-------------------------
Every primary-line style property has a matching setter method.  These
mutate ``_state`` and push the change to the canvas immediately — no
need to recreate the panel.

.. GENERATED FROM PYTHON SOURCE LINES 147-160

.. code-block:: Python


    fig5, ax5 = vw.subplots(1, 1, figsize=(440, 220))
    plot5 = ax5.plot(np.sin(t256), color="#4fc3f7", linewidth=1.5)

    # Change style via setters
    plot5.set_color("#ff7043")
    plot5.set_linewidth(2.5)
    plot5.set_linestyle("dashdot")   # equivalent: plot5.set_linestyle("-.")
    plot5.set_alpha(0.8)
    plot5.set_marker("o", markersize=5)

    fig5





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="fe4c3ab43" style="display:inline-block;overflow:hidden;position:relative;width:456px;height:236px;"><iframe src="../_static/viewer_widgets/sphx_glr_plot_line_styles_006.html" frameborder="0" scrolling="no" style="width:456px;height:236px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('fe4c3ab43'),ifr=wrap.querySelector('iframe'),nw=456,nh=236;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>







.. rst-class:: sphx-glr-timing

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


.. _sphx_glr_download_auto_examples_plot_line_styles.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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