graph LR
Programmatic_User_Interface_GeoAxes_["Programmatic User Interface (GeoAxes)"]
Matplotlib_Axes["Matplotlib Axes"]
FeatureArtist["FeatureArtist"]
Gridliner["Gridliner"]
CRS_Coordinate_Reference_System_["CRS (Coordinate Reference System)"]
SlippyImageArtist["SlippyImageArtist"]
Feature["Feature"]
IO["IO"]
Programmatic_User_Interface_GeoAxes_ -- "extends" --> Matplotlib_Axes
Programmatic_User_Interface_GeoAxes_ -- "orchestrates" --> FeatureArtist
Programmatic_User_Interface_GeoAxes_ -- "interacts with" --> Gridliner
Programmatic_User_Interface_GeoAxes_ -- "relies on" --> CRS_Coordinate_Reference_System_
Programmatic_User_Interface_GeoAxes_ -- "interacts with" --> SlippyImageArtist
Programmatic_User_Interface_GeoAxes_ -- "utilizes" --> IO
FeatureArtist -- "renders" --> Feature
Gridliner -- "utilizes" --> CRS_Coordinate_Reference_System_
SlippyImageArtist -- "retrieves tiles from" --> IO
The Cartopy library's geospatial visualization subsystem is built around a core set of components that extend Matplotlib's capabilities to handle geographical data.
The primary user-facing component, extending Matplotlib's Axes to provide a geographical context. It allows users to define map projections, set extents, and add geospatial data layers. It orchestrates the rendering of features, gridlines, and background imagery.
Related Classes/Methods:
The fundamental Matplotlib class that GeoAxes extends. It provides the base functionality for plotting and rendering graphical elements, serving as the underlying canvas for all visualizations.
Related Classes/Methods:
Responsible for rendering abstract geographical features (defined by Feature) onto the GeoAxes instance, translating high-level feature definitions into visual elements like polygons and lines.
Related Classes/Methods:
Manages the drawing of latitude and longitude gridlines and their corresponding labels on the map, enhancing readability and providing geographical context.
Related Classes/Methods:
Handles all coordinate transformations for geospatial plotting, ensuring that geographical data is correctly projected and displayed according to the chosen map projection. This is a core module providing projection definitions and transformation utilities.
Related Classes/Methods:
Facilitates fetching and display of background imagery from online tile services (e.g., OpenStreetMap, Stamen), providing contextual base maps for the geospatial data.
Related Classes/Methods:
Represents abstract geographical features (e.g., land, ocean, borders) that can be added to a map. These are typically high-level definitions that FeatureArtist then renders. This is a core module providing access to common geographical features.
Related Classes/Methods:
Handles general data fetching for Cartopy, including various geospatial data formats and online sources. It provides the raw data that other components then process and visualize. This is a core module for input/output operations.
Related Classes/Methods: