.. only:: html

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

        Click :ref:`here <sphx_glr_download_auto_examples_01_plotting_plot_multiscale_parcellations.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_01_plotting_plot_multiscale_parcellations.py:


Visualizing multiscale functional brain parcellations
=====================================================

This example shows how to download and fetch brain parcellations of
multiple networks using :func:`nilearn.datasets.fetch_atlas_basc_multiscale_2015`
and visualize them using plotting function :func:`nilearn.plotting.plot_roi`.

We show here only three different networks of 'symmetric' version. For more
details about different versions and different networks, please refer to its
documentation.

Retrieving multiscale group brain parcellations
-----------------------------------------------


.. code-block:: default


    # import datasets module and use `fetch_atlas_basc_multiscale_2015` function
    from nilearn import datasets

    parcellations = datasets.fetch_atlas_basc_multiscale_2015(version='sym')

    # We show here networks of 64, 197, 444
    networks_64 = parcellations['scale064']
    networks_197 = parcellations['scale197']
    networks_444 = parcellations['scale444']





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

 Out:

 .. code-block:: none


    Dataset created in /home/varoquau/nilearn_data/basc_multiscale_2015

    Downloading data from https://ndownloader.figshare.com/files/1861819 ...
     ...done. (0 seconds, 0 min)
    Extracting data from /home/varoquau/nilearn_data/basc_multiscale_2015/53337d5c408465aa257d35f81c13413b/1861819..... done.




Visualizing brain parcellations
-------------------------------


.. code-block:: default


    # import plotting module and use `plot_roi` function, since the maps are in 3D
    from nilearn import plotting

    # The coordinates of all plots are selected automatically by itself
    # We manually change the colormap of our choice
    plotting.plot_roi(networks_64, cmap=plotting.cm.bwr,
                      title='64 regions of brain clusters')

    plotting.plot_roi(networks_197, cmap=plotting.cm.bwr,
                      title='197 regions of brain clusters')

    plotting.plot_roi(networks_444, cmap=plotting.cm.bwr_r,
                      title='444 regions of brain clusters')

    plotting.show()



.. rst-class:: sphx-glr-horizontal


    *

      .. image:: /auto_examples/01_plotting/images/sphx_glr_plot_multiscale_parcellations_001.png
          :alt: plot multiscale parcellations
          :class: sphx-glr-multi-img

    *

      .. image:: /auto_examples/01_plotting/images/sphx_glr_plot_multiscale_parcellations_002.png
          :alt: plot multiscale parcellations
          :class: sphx-glr-multi-img

    *

      .. image:: /auto_examples/01_plotting/images/sphx_glr_plot_multiscale_parcellations_003.png
          :alt: plot multiscale parcellations
          :class: sphx-glr-multi-img






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

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


.. _sphx_glr_download_auto_examples_01_plotting_plot_multiscale_parcellations.py:


.. only :: html

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


  .. container:: binder-badge

    .. image:: https://mybinder.org/badge_logo.svg
      :target: https://mybinder.org/v2/gh/nilearn/nilearn.github.io/master?filepath=examples/auto_examples/01_plotting/plot_multiscale_parcellations.ipynb
      :width: 150 px


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

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



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

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


.. only:: html

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

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