{ "cells": [ { "cell_type": "markdown", "id": "0436f001-b483-4047-9bc2-9c8e246d228c", "metadata": {}, "source": [ "## 5. Domains and coordinate reference systems" ] }, { "cell_type": "markdown", "id": "e5bb637d-e026-4276-bc96-49b2027cb415", "metadata": {}, "source": [ "**earthkit-plots** makes it simple and convenient to produce maps over any geospatial extent, using whichever map projection works best for your data.\n", "\n", "This section covers some of the convenience features provided by **earthkit-plots** for quickly plotting maps over specific domains, including:\n", "- Built-in named domains\n", "- Combining multiple domains\n", "- Automatic projection selection based on domain extents\n", "- Creating new, custom, named domains." ] }, { "cell_type": "markdown", "id": "45a5ff9e-9c09-445e-8b11-732400272943", "metadata": {}, "source": [ "### Named domains" ] }, { "cell_type": "markdown", "id": "929fff29-08cd-4c0b-9ac7-3569f9bf04ed", "metadata": {}, "source": [ "The most strightforward way of specifying a map domain is through passing a named domain via the `domain` argument to the `Map` class, or to the `Figure.add_map()` method. The valid named domains that can be used with earthkit-plots include:\n", "- Named countries which exist in [Natural Earth's Admin 0 countries dataset](https://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-0-countries/), e.g. `\"France\"`\n", "- Continents, e.g. `\"Africa\"`\n", "- A named domain packaged up with your style library of choice (see builtin domain for a list of named domains included in the default earthkit-plots distribution)\n", "- `None` (default), which will make your map use the domain and projection of the **first** data that you plot on it (or global equirectangular if no data is plotted)." ] }, { "cell_type": "markdown", "id": "c41b7a3d-99a2-47cb-b6b0-be55be9482df", "metadata": { "jp-MarkdownHeadingCollapsed": true }, "source": [ "
domain argument is also a valid argument to all quickmap functions, so you can still specify domains in exactly the same way as in these examples if you are using the quickmap module - e.g. qmap.plot(data, domain=\"Europe\").\n",
"| \n", " | variable | \n", "level | \n", "valid_datetime | \n", "units | \n", "
|---|---|---|---|---|
| 0 | \n", "dis06 | \n", "None | \n", "2022-10-08T18:00:00 | \n", "m**3 s**-1 | \n", "
| 1 | \n", "land_binary_mask | \n", "None | \n", "2022-10-08T18:00:00 | \n", "1 | \n", "
| 2 | \n", "upArea | \n", "None | \n", "2022-10-08T18:00:00 | \n", "M2 | \n", "