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

.. only:: html

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

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

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

.. _sphx_glr_gallery_plot_20_create_path.py:


.. _path_exemple:

Build a path for the camera
###########################

How to use the class `Path`

.. GENERATED FROM PYTHON SOURCE LINES 10-77




.. video:: /home/docs/checkouts/readthedocs.org/user_builds/animation-maker/checkouts/latest/doc/source/gallery/images/sphx_glr_plot_20_create_path_001.mp4
    :autoplay:
    :loop:





.. code-block:: Python


    import cartopy.crs as ccrs
    import cartopy.feature as cfeature
    import matplotlib.pyplot as plt
    import numpy as np
    import xarray as xr

    from anim.path import TimePath

    ANIM_FPS = 60
    ANIM_OUTPUT_FOLDER = "animation/example_20"

    ANIM_MAX_FRAMES = ANIM_FPS * 10


    def plot(i_image, ds):
        """créée une figure"""

        extent = ds.attrs["extent"]
        tn = ds.attrs["tn"]
        speed = ds.attrs["speed"]

        fig = plt.figure(figsize=(7, 3.5), dpi=80)

        ax = fig.add_subplot(1, 1, 1, projection=ccrs.PlateCarree())
        ax.set_extent(extent, crs=ccrs.PlateCarree())

        ax.coastlines()
        ax.add_feature(cfeature.LAND)
        ax.add_feature(cfeature.OCEAN)

        gl = ax.gridlines(draw_labels=True)
        gl.top_labels = False
        gl.right_labels = False

        x0, x1, y0, y1 = extent
        x = (x0 + x1) / 2
        y = (y0 + y1) / 2

        ax.set_title(f"i={i_image:03d} date={tn} | pos=({x:6.2f}, {y:6.2f}), speed={speed:6.2f}°/day", fontsize=11)

        return fig


    def compute():
        t0 = np.datetime64("2003-06-03T00:25:00")

        # cannot have float when creating timedelta64, so use seconds
        dt = np.timedelta64(int(60 * 60 * 24 / ANIM_FPS), "s")

        path = TimePath(coords=(-5, 36), dx=20, dy=10, t0=t0)
        # move to the coordinate (9, 43) in 2 days
        path.move(np.timedelta64(2, "D"), coords=(9, 43))
        # move to the coordinate (15, 41) in 1 days
        path.move(np.timedelta64(1, "D"), coords=(15, 41))
        # move to the coordinate (26, 36) in 3 days and zoom in (=> reducing dx and dy by a half)
        path.move_and_zoom(np.timedelta64(3, "D"), zoom=2, coords=(26, 36))

        # wait a little (move to the same place in 1 day, so no move)
        path.move(np.timedelta64(1, "D"))

        # don't move, but change the zooming by dezooming until having dx=40 and dy=20
        path.move_and_focus(np.timedelta64(3, "D"), dx=40, dy=20)

        for tn, extent, speed in zip(*path.compute_path(dt)):
            ds = xr.Dataset(attrs={"tn": tn, "extent": extent, "speed": speed})
            yield ds


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

   **Total running time of the script:** (1 minutes 42.388 seconds)


.. _sphx_glr_download_gallery_plot_20_create_path.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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