From 1d788aa367e71671164b587f0b5ef9d5d66d323e Mon Sep 17 00:00:00 2001 From: Christian Ledermann Date: Sun, 17 Nov 2024 20:59:10 +0000 Subject: [PATCH] enhance documentation for KML file creation examples with additional images and improved formatting --- docs/create_kml_files.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/create_kml_files.rst b/docs/create_kml_files.rst index 7902a48f..14ad014e 100644 --- a/docs/create_kml_files.rst +++ b/docs/create_kml_files.rst @@ -6,6 +6,12 @@ Read a shapefile and build a 3D KML visualization. This example shows how to read a shapefile and build a 3D KML visualization from it. +.. image:: co2-per-capita-2020.jpg + :alt: CO2 emissions per capita in 2020 + :align: center + :width: 800px + :target: https://ion.cesium.com/stories/viewer/?id=a3cf93bb-bbb8-488b-8643-09c037ec12b8 + You will need to install `pyshp `_ (``pip install pyshp``). For this example we will use the @@ -108,12 +114,6 @@ Finally, we create the KML object and write it to a file: The resulting KML file can be opened in Google Earth or any other KML viewer. -.. image:: co2-per-capita-2020.jpg - :alt: CO2 emissions per capita in 2020 - :align: center - :width: 800px - :target: https://ion.cesium.com/stories/viewer/?id=a3cf93bb-bbb8-488b-8643-09c037ec12b8 - Build an animated over time KML visualization ---------------------------------------------- @@ -122,6 +122,12 @@ This example shows how to build an animated KML visualization over time. We will use the same data as in the previous example, but this time we will create a KML file that shows the CO2 emissions accumulating from 1995 to 2022. +.. image:: co2growth.gif + :alt: CO2 emissions per capita growth + :align: center + :width: 800px + :target: https://ion.cesium.com/stories/viewer/?id=602c8c64-72aa-4c57-8a01-752b6fbc62d0 + First we import the necessary modules: .. code-block:: pycon @@ -233,9 +239,3 @@ see the CO2 emissions per capita grow over time, Google Earth Web does not suppo time animations, but `Cesium Ion `_ can display the time animation. - -.. image:: co2growth.gif - :alt: CO2 emissions per capita growth - :align: center - :width: 800px - :target: https://ion.cesium.com/stories/viewer/?id=602c8c64-72aa-4c57-8a01-752b6fbc62d0