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

.. only:: html

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

        :ref:`Go to the end <sphx_glr_download_user-guide_usage_visualization_plot_1_basic.py>`
        to download the full example code.

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

.. _sphx_glr_user-guide_usage_visualization_plot_1_basic.py:


*************
Basic objects
*************

This page explains plotting of basic geometric objects with :py:class:`wulfric.PlotlyEngine`.

.. GENERATED FROM PYTHON SOURCE LINES 28-31

.. code-block:: Python


    import wulfric








.. GENERATED FROM PYTHON SOURCE LINES 32-34

Points
======

.. GENERATED FROM PYTHON SOURCE LINES 34-47

.. code-block:: Python


    import numpy as np

    pe = wulfric.PlotlyEngine(_sphinx_gallery_fix=True)

    colors = np.random.randint(0, 255, (42, 3))

    colors = [f"rgb({r},{g},{b})" for r, g, b in colors]

    pe.plot_points(points=np.random.random((42, 3)), colors=colors, scale=3)

    pe.show()






.. raw:: html

    <div class="output_subarea output_html rendered_html output_result">
    <div>            <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-AMS-MML_SVG"></script><script>if (window.MathJax && window.MathJax.Hub && window.MathJax.Hub.Config) {window.MathJax.Hub.Config({SVG: {font: "STIX-Web"}});}</script>                <script>window.PlotlyConfig = {MathJaxConfig: 'local'};</script>
            <script charset="utf-8" src="https://cdn.plot.ly/plotly-3.5.0.min.js" integrity="sha256-fHbNLP+GlIXN+efbQec78UkemUz3NJp7UmfGxC1tNxs=" crossorigin="anonymous"></script>                <div id="a0b8a09b-8fc3-4704-8355-1486f0a0148c" class="plotly-graph-div" style="height:525px; width:100%;"></div>            <script>                window.PLOTLYENV=window.PLOTLYENV || {};                                if (document.getElementById("a0b8a09b-8fc3-4704-8355-1486f0a0148c")) {                    Plotly.newPlot(                        "a0b8a09b-8fc3-4704-8355-1486f0a0148c",                        [{"hoverinfo":"none","legendgroup":"rvrdgyaiwv","marker":{"color":["rgb(164,127,187)","rgb(129,239,136)","rgb(10,81,135)","rgb(26,25,213)","rgb(182,234,67)","rgb(21,149,86)","rgb(231,17,170)","rgb(154,36,70)","rgb(210,229,99)","rgb(155,38,187)","rgb(202,82,153)","rgb(111,237,157)","rgb(232,199,128)","rgb(227,32,31)","rgb(164,215,215)","rgb(212,51,158)","rgb(185,60,97)","rgb(229,113,249)","rgb(148,12,18)","rgb(164,215,186)","rgb(181,183,130)","rgb(89,9,147)","rgb(112,201,81)","rgb(213,100,196)","rgb(147,207,138)","rgb(42,115,139)","rgb(62,74,215)","rgb(48,95,88)","rgb(52,192,184)","rgb(235,251,0)","rgb(238,119,72)","rgb(222,75,83)","rgb(37,182,86)","rgb(73,227,217)","rgb(169,83,4)","rgb(243,81,26)","rgb(122,12,156)","rgb(124,152,134)","rgb(68,121,82)","rgb(116,104,91)","rgb(75,176,234)","rgb(7,39,4)"],"size":6},"mode":"markers","showlegend":false,"x":{"dtype":"f8","bdata":"QAYu0mOmkT\u002fbtKPBOEnvP930AinKOO8\u002fAGb2zZ8A1z940F78dfDsP0AUiyCkLo0\u002fnfjUTQd07D+UUDYCoznrP\u002fyK\u002fVoG1+s\u002fD4cJqXv15z8WrsVfSWDuP9SiaoFUDNY\u002fc6EDrBNu5T9gbt\u002fiuefXP2hSE2\u002fdiOg\u002fCPx4INvM4j8uG4q2GoLhP2huBapzpr0\u002fV6UiNJKO5T\u002fg\u002fkAImeTnP4i4poOXL70\u002fkCql8XJfzz\u002fIB533+m\u002fQP0BuMG3YFao\u002fVNjNzy+tzD8o21AuN+\u002ffP8YK7MSN5uw\u002fnKYcP2Fp1z\u002fgks5Y\u002f6K4PzWCH9g4POY\u002fjjoHNM2H7D+IzG3ZsL\u002fdP0T8ylDPh8U\u002f8DJtYABe1T\u002fljgJxSoXiP1y5Czl108Y\u002fNuBUzlBi3j8A7dcKlR7DPyar7VhTSuY\u002fOC02\u002fu2l4j8AmGPqyLLHP1PW6dd1KuQ\u002f"},"y":{"dtype":"f8","bdata":"mIPLnra5sz9I9TzluIDDP1GVef7CG+Q\u002fPr20ihWz0j+ILj8P6zLYP5BFrHu4KNg\u002feE6TDNJtyD9uqgD6WqHaP\u002fwuyISPk90\u002fVdmjjxDd4z+F9S+5z3DvP7odUDK5S+8\u002fHJ8sAP2K1T8KmkH8t5LdP0T3dPqjnMw\u002fnk4aPvuK3j+YWSDykObGP8TxJjuGqNA\u002fdM567nLk7j+E6l7NT9zaP91EuVkTmeU\u002feZJjOqkH5z9aFlN+GcDpP8kawEnyGew\u002f1v3K3mKB4D8ZjWKHjaHtP4C2e8JfLNY\u002fsnKnAL5K7j9mYcoaVjfoP9SVrhpYi8w\u002fMOVttzTiqz+ccM6e9Q3vP+ieJy3Aaug\u002fwG5uOi59oD9QIkt+tZWoP27990kHSd0\u002f07KwD2u16j+6qF+W9HvkP651bFzfD9o\u002fGkz2P+KD7T857GPlpjTmP3oJLuQ6kNk\u002f"},"z":{"dtype":"f8","bdata":"BW3AePcN4T+KrrrTILzfP5y2+aGLCso\u002fCKti27zG5j+nRwNK4JDkPzDzderDqO0\u002fJOQRXXoQxD+wTgCup1\u002fgPwCWq\u002fuCXdU\u002f5wtYI5XB5T\u002fpMyw3TcTsPyKvD6d07us\u002fEEkTV+bE5D8dgwM7hIHoP1HYlPVBH+0\u002fBJlQWyhD0D+3ZDtCp1HkP60ElyUePek\u002fAPhDPfGCsj9YgXsTyqzvP3BKaJkzz88\u002f3k9X\u002fh4g3z9M\u002f0E\u002fplTIP05ZyiQ2sO4\u002fUGiVe1Z3sz8kJfivcTfpP5ApCCtEpus\u002feHXursct7j\u002fGmVb7QJDWP+yLpp4+e+I\u002fkayZwBtz4T\u002fUUK\u002fibMbrP9Qbe7kXEeM\u002f6BQGGywO1z8JJESp98flP3gfL9kWn+M\u002fbjmtF5N17j9S2oiLjsvvP38\u002f47PnrOM\u002fyLg3ZFQJ7T+z2My5GGTrP\u002faOeocMGeE\u002f"},"type":"scatter3d","scene":"scene"}],                        {"template":{"data":{"scatter":[{"type":"scatter"}]}},"scene":{"domain":{"x":[0.0,1.0],"y":[0.0,1.0]},"xaxis":{"range":[0.014961572985934375,1.0265726061937444]},"yaxis":{"range":[0.03381530462682088,1.0316469714915513]},"zaxis":{"range":[0.07592604764010247,1.0432781564282447]},"aspectratio":{"x":1.0457526520256553,"y":1.0315082355221943,"z":1},"aspectmode":"manual"},"legend":{"yanchor":"bottom","y":1.0,"xanchor":"center","x":0.5}},                        {"responsive": true}                    )                };            </script>        </div>
    </div>
    <br />
    <br />

.. GENERATED FROM PYTHON SOURCE LINES 48-52

Vector
======

Vector is defined by its start and end points

.. GENERATED FROM PYTHON SOURCE LINES 52-80

.. code-block:: Python


    pe = wulfric.PlotlyEngine(_sphinx_gallery_fix=True)

    pe.plot_vector(start_point=(0, 0, 0), end_point=(1, 1, 1))

    pe.plot_vector(
        start_point=(0, 0, 0),
        end_point=(1, 0, 0),
        color="red",
        vector_label="x",
    )
    pe.plot_vector(
        start_point=(0, 0, 0),
        end_point=(0, 1, 0),
        color="green",
        vector_label="y",
    )
    pe.plot_vector(
        start_point=(0, 0, 0),
        end_point=(0, 0, 1),
        color="blue",
        vector_label="z",
    )


    pe.show(axes_visible=False)







.. raw:: html

    <div class="output_subarea output_html rendered_html output_result">
    <div>            <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-AMS-MML_SVG"></script><script>if (window.MathJax && window.MathJax.Hub && window.MathJax.Hub.Config) {window.MathJax.Hub.Config({SVG: {font: "STIX-Web"}});}</script>                <script>window.PlotlyConfig = {MathJaxConfig: 'local'};</script>
            <script charset="utf-8" src="https://cdn.plot.ly/plotly-3.5.0.min.js" integrity="sha256-fHbNLP+GlIXN+efbQec78UkemUz3NJp7UmfGxC1tNxs=" crossorigin="anonymous"></script>                <div id="e4d0183e-48ed-45e8-84f7-dca34dfd5330" class="plotly-graph-div" style="height:525px; width:100%;"></div>            <script>                window.PLOTLYENV=window.PLOTLYENV || {};                                if (document.getElementById("e4d0183e-48ed-45e8-84f7-dca34dfd5330")) {                    Plotly.newPlot(                        "e4d0183e-48ed-45e8-84f7-dca34dfd5330",                        [{"hoverinfo":"none","legendgroup":"qyakhiokcu","line":{"color":"#000000","width":3},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AAE="},"y":{"dtype":"i1","bdata":"AAE="},"z":{"dtype":"i1","bdata":"AAE="},"type":"scatter3d","scene":"scene"},{"anchor":"tip","colorscale":[[0,"#000000"],[1,"#000000"]],"hoverinfo":"none","legendgroup":"qyakhiokcu","showlegend":false,"showscale":false,"u":[0.4],"v":[0.4],"w":[0.4],"x":[1],"y":[1],"z":[1],"type":"cone","scene":"scene"},{"hoverinfo":"none","legendgroup":"shbmpjnmkk","line":{"color":"red","width":3},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AAE="},"y":{"dtype":"i1","bdata":"AAA="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"anchor":"tip","colorscale":[[0,"red"],[1,"red"]],"hoverinfo":"none","legendgroup":"shbmpjnmkk","showlegend":false,"showscale":false,"u":[0.4],"v":[0.0],"w":[0.0],"x":[1],"y":[0],"z":[0],"type":"cone","scene":"scene"},{"hoverinfo":"none","legendgroup":"shbmpjnmkk","marker":{"size":0},"mode":"text","showlegend":false,"text":"x","textfont":{"color":"red","size":12},"textposition":"top center","x":[1.2],"y":[0.0],"z":[0.0],"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"vusisoupqh","line":{"color":"green","width":3},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AAA="},"y":{"dtype":"i1","bdata":"AAE="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"anchor":"tip","colorscale":[[0,"green"],[1,"green"]],"hoverinfo":"none","legendgroup":"vusisoupqh","showlegend":false,"showscale":false,"u":[0.0],"v":[0.4],"w":[0.0],"x":[0],"y":[1],"z":[0],"type":"cone","scene":"scene"},{"hoverinfo":"none","legendgroup":"vusisoupqh","marker":{"size":0},"mode":"text","showlegend":false,"text":"y","textfont":{"color":"green","size":12},"textposition":"top center","x":[0.0],"y":[1.2],"z":[0.0],"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"ciwlumdnum","line":{"color":"blue","width":3},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AAA="},"y":{"dtype":"i1","bdata":"AAA="},"z":{"dtype":"i1","bdata":"AAE="},"type":"scatter3d","scene":"scene"},{"anchor":"tip","colorscale":[[0,"blue"],[1,"blue"]],"hoverinfo":"none","legendgroup":"ciwlumdnum","showlegend":false,"showscale":false,"u":[0.0],"v":[0.0],"w":[0.4],"x":[0],"y":[0],"z":[1],"type":"cone","scene":"scene"},{"hoverinfo":"none","legendgroup":"ciwlumdnum","marker":{"size":0},"mode":"text","showlegend":false,"text":"z","textfont":{"color":"blue","size":12},"textposition":"top center","x":[0.0],"y":[0.0],"z":[1.2],"type":"scatter3d","scene":"scene"}],                        {"template":{"data":{"scatter":[{"type":"scatter"}]}},"scene":{"domain":{"x":[0.0,1.0],"y":[0.0,1.0]},"xaxis":{"visible":false,"range":[0.0,1.26]},"yaxis":{"visible":false,"range":[0.0,1.26]},"zaxis":{"visible":false,"range":[0.0,1.26]},"aspectratio":{"x":1.0,"y":1.0,"z":1},"aspectmode":"manual"},"legend":{"yanchor":"bottom","y":1.0,"xanchor":"center","x":0.5}},                        {"responsive": true}                    )                };            </script>        </div>
    </div>
    <br />
    <br />

.. GENERATED FROM PYTHON SOURCE LINES 81-84

Line
====
Line is defined by two points

.. GENERATED FROM PYTHON SOURCE LINES 84-100

.. code-block:: Python


    pe = wulfric.PlotlyEngine(_sphinx_gallery_fix=True)
    pe.plot_line(
        start_point=(0, 0, 0),
        end_point=(1, 0, 0),
        legend_group="square",
        legend_label="square",
    )
    pe.plot_line(start_point=(1, 0, 0), end_point=(1, 1, 0), legend_group="square")
    pe.plot_line(start_point=(1, 1, 0), end_point=(0, 1, 0), legend_group="square")
    pe.plot_line(start_point=(0, 1, 0), end_point=(0, 0, 0), legend_group="square")

    pe.plot_line(start_point=(0.3, 1, 0.1), end_point=(3, 1, 2), legend_label="single line")

    pe.show()






.. raw:: html

    <div class="output_subarea output_html rendered_html output_result">
    <div>            <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-AMS-MML_SVG"></script><script>if (window.MathJax && window.MathJax.Hub && window.MathJax.Hub.Config) {window.MathJax.Hub.Config({SVG: {font: "STIX-Web"}});}</script>                <script>window.PlotlyConfig = {MathJaxConfig: 'local'};</script>
            <script charset="utf-8" src="https://cdn.plot.ly/plotly-3.5.0.min.js" integrity="sha256-fHbNLP+GlIXN+efbQec78UkemUz3NJp7UmfGxC1tNxs=" crossorigin="anonymous"></script>                <div id="167ade27-5662-4315-aba5-b7a6e485a6f8" class="plotly-graph-div" style="height:525px; width:100%;"></div>            <script>                window.PLOTLYENV=window.PLOTLYENV || {};                                if (document.getElementById("167ade27-5662-4315-aba5-b7a6e485a6f8")) {                    Plotly.newPlot(                        "167ade27-5662-4315-aba5-b7a6e485a6f8",                        [{"hoverinfo":"none","legendgroup":"square","line":{"color":"#000000"},"mode":"lines","name":"square","showlegend":true,"x":{"dtype":"i1","bdata":"AAE="},"y":{"dtype":"i1","bdata":"AAA="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"square","line":{"color":"#000000"},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AQE="},"y":{"dtype":"i1","bdata":"AAE="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"square","line":{"color":"#000000"},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AQA="},"y":{"dtype":"i1","bdata":"AQE="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"square","line":{"color":"#000000"},"mode":"lines","showlegend":false,"x":{"dtype":"i1","bdata":"AAA="},"y":{"dtype":"i1","bdata":"AQA="},"z":{"dtype":"i1","bdata":"AAA="},"type":"scatter3d","scene":"scene"},{"hoverinfo":"none","legendgroup":"ucdvemvjdc","line":{"color":"#000000"},"mode":"lines","name":"single line","showlegend":true,"x":{"dtype":"f8","bdata":"MzMzMzMz0z8AAAAAAAAIQA=="},"y":{"dtype":"f8","bdata":"AAAAAAAA8D8AAAAAAADwPw=="},"z":{"dtype":"f8","bdata":"mpmZmZmZuT8AAAAAAAAAQA=="},"type":"scatter3d","scene":"scene"}],                        {"template":{"data":{"scatter":[{"type":"scatter"}]}},"scene":{"domain":{"x":[0.0,1.0],"y":[0.0,1.0]},"xaxis":{"range":[0.0,3.1500000000000004]},"yaxis":{"range":[0.0,1.05]},"zaxis":{"range":[0.0,2.1]},"aspectratio":{"x":1.5,"y":0.5,"z":1},"aspectmode":"manual"},"legend":{"yanchor":"bottom","y":1.0,"xanchor":"center","x":0.5}},                        {"responsive": true}                    )                };            </script>        </div>
    </div>
    <br />
    <br />


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

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


.. _sphx_glr_download_user-guide_usage_visualization_plot_1_basic.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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