:orphan:

Example gallery
===============

Complete maps built with the ``mappyng`` object API. Each example is a
standalone script: source code, real open data and the rendered map.
Click a thumbnail to see the code.


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A minimal map: European countries as background, France lifted by a drop shadow, department boundaries on top, plus the chrome (title, scale bar, source). Mainland France is framed in Lambert-93 and the overseas departments are drawn as cartouches.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_01_basemap_thumb.png
    :alt:

  :doc:`/gallery/plot_01_basemap`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Basemap and chrome</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A choropleth maps a relative quantity (here a standardised mortality rate) to colour value. Data: mortality from heart failure, rate per 100,000 inhabitants, 2020-2022 average (Sante publique France, ODISSE).">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_02_choropleth_thumb.png
    :alt:

  :doc:`/gallery/plot_02_choropleth`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Choropleth</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This is the plot_02_choropleth example rebuilt from a single YAML document instead of Python. Every parameter -- the framing bbox, the overseas cartouche_params, the drop shadow lifting France, the layers, the legend and the chrome -- lives in the document. The data is fetched declaratively too: each data: block names a built-in dataset (reprojected with crs) and the choropleth layer join\s its values from a CSV. No glue code runs.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_02b_choropleth_yaml_thumb.png
    :alt:

  :doc:`/gallery/plot_02b_choropleth_yaml`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">The same choropleth, from YAML</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="For an absolute quantity (a count), symbol size preserves the magnitude that colour value would flatten. Data: excess deaths among people over 75 during the 2025 heatwaves, by department (Sante publique France, ODISSE).">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_03_proportional_thumb.png
    :alt:

  :doc:`/gallery/plot_03_proportional`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Proportional symbols</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Located qualitative points, differentiated by category, with a zoom window on the dense Paris region. Data: hospital helipads in mainland France, distinguished by night-flight capability (data.gouv.fr, CC-BY).">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_04_situation_thumb.png
    :alt:

  :doc:`/gallery/plot_04_situation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Situation map (qualitative symbols)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="LabelLayer places place names by simulated annealing to limit overlaps. Here the mainland region names, over a European background.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_05_labels_thumb.png
    :alt:

  :doc:`/gallery/plot_05_labels`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Automatic labels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="GraticuleLayer draws meridians and parallels at a step given in degrees. The map is framed on continental Europe via bbox.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_06_graticule_thumb.png
    :alt:

  :doc:`/gallery/plot_06_graticule`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Graticule</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The style parameter accepts a preset (``&quot;classic&quot;``, &quot;modern&quot;) or a dict of overrides. Below, the same basemap rendered with two styles; both maps appear in the gallery.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_07_styles_thumb.png
    :alt:

  :doc:`/gallery/plot_07_styles`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Styles</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A zoom window magnifies a dense area (the Paris region), the overseas departments are drawn as cartouches and box_shadow lifts the main map off the European background. All layers redraw automatically in the zoom window and the cartouches.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_08_layout_thumb.png
    :alt:

  :doc:`/gallery/plot_08_layout`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Zoom, cartouches and drop shadow</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="box_shadow and glow apply to the main map, either with the default settings (``True``) or through a dict (``dx``, dy, blur, color, opacity). Here an outer glow on a dark background, over a European basemap.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_09_effects_thumb.png
    :alt:

  :doc:`/gallery/plot_09_effects`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Drop shadow and glow</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A tiled basemap drawn from XYZ web tiles. OpenTopoMap renders SRTM elevation as shaded relief with contour lines, here over the northern French Alps. The tiles are fetched in Web Mercator, warped into the Lambert-93 map CRS and embedded as a single image, with the department boundaries drawn on top.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_10_tiles_thumb.png
    :alt:

  :doc:`/gallery/plot_10_tiles`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Topographic tiles (SRTM relief)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Metropolitan France alone, with no chrome around the map: no ocean panel, no frame and no drop shadow. Leaving facecolor unset and border_radius=0 places the choropleth directly on the page background, for a clean figure to drop into a document.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_11_choropleth_borderless_thumb.png
    :alt:

  :doc:`/gallery/plot_11_choropleth_borderless`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Borderless choropleth</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A choropleth of population density across the contiguous United States, drawn in the Albers Equal-Area projection (EPSG:5070). Neighbouring countries fill the background, while Alaska and Hawaii, far from the lower 48, are drawn as enlarged cartouches in their own projections (Alaska Albers and Web Mercator) so each keeps a faithful shape. The choropleth classes are shared across the main map and both insets.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_12_usa_thumb.png
    :alt:

  :doc:`/gallery/plot_12_usa`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">United States with Alaska and Hawaii insets</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An orthographic projection turns the flat world into a sphere seen from space. The trick is to clip the data to the visible hemisphere before projecting (distant points would otherwise fold onto invalid coordinates), then draw on a dark background:">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_13_globe_thumb.png
    :alt:

  :doc:`/gallery/plot_13_globe`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">The world as a globe</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A choropleth of the first factor of a principal component analysis on 42 African countries (demographic, social and economic indicators). The axis is diverging and centred on zero. FactorLegend adds what such a map needs: the factor and its share of variance, an interpretation text at each pole, a no-data entry and a methodology note.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_14_acp_thumb.png
    :alt:

  :doc:`/gallery/plot_14_acp`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Factor maps of a principal component analysis</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The StdMean method places its class breaks at standard-deviation steps either side of the mean, with a central class straddling it. It is a diverging classification, so it pairs with a double gamme (diverging) palette: one colour ramp below the mean and one above, meeting at a neutral centre. Only odd class counts make that symmetry work, so StdMean accepts 5 or 7 classes; any other count snaps to the nearest valid one with a warning.">

.. only:: html

  .. image:: /gallery/images/thumb/sphx_glr_plot_15_stdmean_thumb.png
    :alt:

  :doc:`/gallery/plot_15_stdmean`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Standard-deviation choropleth (double gamme)</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /gallery/plot_01_basemap
   /gallery/plot_02_choropleth
   /gallery/plot_02b_choropleth_yaml
   /gallery/plot_03_proportional
   /gallery/plot_04_situation
   /gallery/plot_05_labels
   /gallery/plot_06_graticule
   /gallery/plot_07_styles
   /gallery/plot_08_layout
   /gallery/plot_09_effects
   /gallery/plot_10_tiles
   /gallery/plot_11_choropleth_borderless
   /gallery/plot_12_usa
   /gallery/plot_13_globe
   /gallery/plot_14_acp
   /gallery/plot_15_stdmean



.. only:: html

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

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