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

.. only:: html

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

        :ref:`Go to the end <sphx_glr_download_tutorials_configuration.py>`
        to download the full example code.

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

.. _sphx_glr_tutorials_configuration.py:


.. _tutorials-configuration:

======================
Configuration Instance
======================

This example shows how to use igraph's :class:`configuration instance <igraph.Configuration>` to set default igraph settings. This is useful for setting global settings so that they don't need to be explicitly stated at the beginning of every igraph project you work on.

.. GENERATED FROM PYTHON SOURCE LINES 10-14

.. code-block:: Python

    import igraph as ig
    import matplotlib.pyplot as plt
    import random








.. GENERATED FROM PYTHON SOURCE LINES 15-16

First we define the default plotting backend, layout, and color palette.

.. GENERATED FROM PYTHON SOURCE LINES 16-20

.. code-block:: Python

    ig.config["plotting.backend"] = "matplotlib"
    ig.config["plotting.layout"] = "fruchterman_reingold"
    ig.config["plotting.palette"] = "rainbow"








.. GENERATED FROM PYTHON SOURCE LINES 21-24

Then, we save them. By default, ``ig.config.save()`` will save files to
``~/.igraphrc`` on Linux and Max OS X systems, or in
``%USERPROFILE%\.igraphrc`` for Windows systems:

.. GENERATED FROM PYTHON SOURCE LINES 24-26

.. code-block:: Python

    ig.config.save()








.. GENERATED FROM PYTHON SOURCE LINES 27-31

The code above only needs to be run once (to store the new config options
into the ``.igraphrc`` file). Whenever you use igraph and this file exists,
igraph will read its content and use those options as defaults. For
example, let's create and plot a new graph to demonstrate:

.. GENERATED FROM PYTHON SOURCE LINES 31-34

.. code-block:: Python

    random.seed(1)
    g = ig.Graph.Barabasi(n=100, m=1)








.. GENERATED FROM PYTHON SOURCE LINES 35-37

We now calculate a color value between 0-200 for all nodes, for instance by
computing the vertex betweenness:

.. GENERATED FROM PYTHON SOURCE LINES 37-40

.. code-block:: Python

    betweenness = g.betweenness()
    colors = [int(i * 200 / max(betweenness)) for i in betweenness]








.. GENERATED FROM PYTHON SOURCE LINES 41-43

Finally, we can plot the graph. You will notice that even though we did not
create a dedicated figure and axes, matplotlib is now used by default:

.. GENERATED FROM PYTHON SOURCE LINES 43-46

.. code-block:: Python

    ig.plot(g, vertex_color=colors, vertex_size=15, edge_width=0.3)
    plt.show()




.. image-sg:: /tutorials/images/sphx_glr_configuration_001.png
   :alt: configuration
   :srcset: /tutorials/images/sphx_glr_configuration_001.png
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 47-61

The full list of config settings can be found at
:class:`igraph.Configuration`.

.. note::

   You can have multiple config files: specify each location via
   ``ig.config.save("./path/to/config/file")``. To load a specific config,
   import igraph and then call ``ig.config.load("./path/to/config/file")``


.. note::

    To use a consistent style between individual plots (e.g. vertex sizes,
    colors, layout etc.) check out :ref:`tutorials-visual-style`.


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

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


.. _sphx_glr_download_tutorials_configuration.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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