Merge branch 'main' into zedwick/parallelize_dual

Author: erogluorhan

.pre-commit-config.yaml

@@ -14,7 +14,7 @@ repos:
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
   # Ruff version.
-  rev: v0.11.13
+  rev: v0.12.2
   hooks:
     - id: ruff
       name: lint with ruff
@@ -27,7 +27,7 @@ repos:
       types_or: [ python, pyi, jupyter ]
 
 - repo: https://github.com/keewis/blackdoc
-  rev: v0.3.9
+  rev: v0.4.1
   hooks:
     - id: blackdoc
       additional_dependencies: [ "black==24.10.0" ]

docs/api.rst

@@ -25,30 +25,21 @@ Top Level Functions
 Grid
 ----
 
-Constructor
-~~~~~~~~~~~
+Constructors
+~~~~~~~~~~~~
 
 .. autosummary::
    :toctree: generated/
 
    Grid
-
-I/O & Conversion
-~~~~~~~~~~~~~~~~
-
-.. autosummary::
-   :toctree: generated/
-
    Grid.from_dataset
    Grid.from_file
    Grid.from_topology
    Grid.from_structured
    Grid.from_points
    Grid.from_healpix
-   Grid.to_xarray
-   Grid.to_geodataframe
-   Grid.to_polycollection
-   Grid.to_linecollection
+
+
 
 Indexing
 ~~~~~~~~
@@ -175,13 +166,15 @@ and functionality, please refer to Xarray's `documentation <https://docs.xarray.
 UxDataArray
 -----------
 
-Constructor
-~~~~~~~~~~~
+Constructors
+~~~~~~~~~~~~
 
 .. autosummary::
    :toctree: generated/
 
    UxDataArray
+   UxDataArray.from_xarray
+   UxDataArray.from_healpix
 
 Grid Accessor
 ~~~~~~~~~~~
@@ -191,29 +184,20 @@ Grid Accessor
 
    UxDataArray.uxgrid
 
-I/O & Conversion
-~~~~~~~~~~~~~~~~
-
-.. autosummary::
-   :toctree: generated/
-
-   UxDataArray.to_geodataframe
-   UxDataArray.to_polycollection
-   UxDataArray.to_dataset
-   UxDataArray.from_xarray
-   UxDataArray.from_healpix
-
 
 UxDataset
 -----------
 
-Constructor
-~~~~~~~~~~~
+Constructors
+~~~~~~~~~~~~
 
 .. autosummary::
    :toctree: generated/
 
    UxDataset
+   UxDataset.from_structured
+   UxDataset.from_xarray
+   UxDataset.from_healpix
 
 Grid Accessor
 ~~~~~~~~~~~
@@ -223,25 +207,58 @@ Grid Accessor
 
    UxDataset.uxgrid
 
-I/O & Conversion
-~~~~~~~~~~~~~~~~
+
+Conversion Methods
+------------------
+
+UXarray provides functionality to convert its unstructured grids representation to other data structures that can be ingested by existing, widely used tools, such as Matplotlib and Cartopy. This allows users to keep using their workflows with such tools.
+
+
+
+Grid
+~~~~
 
 .. autosummary::
    :toctree: generated/
 
-   UxDataset.from_structured
-   UxDataset.from_xarray
-   UxDataset.from_healpix
+   Grid.to_geodataframe
+   Grid.to_polycollection
+   Grid.to_linecollection
+   Grid.to_xarray
+
+UxDataArray
+~~~~~~~~~~~
+
+.. autosummary::
+   :toctree: generated/
+
+   UxDataArray.to_geodataframe
+   UxDataArray.to_polycollection
+   UxDataArray.to_raster
+   UxDataArray.to_dataset
+   UxDataArray.to_xarray
+
+UxDataset
+~~~~~~~~~
+
+.. autosummary::
+   :toctree: generated/
+
+   UxDataset.to_xarray
+   UxDataset.to_array
+
 
 Plotting
 --------
 
 
-UXarray's plotting API is written using `hvPlot <https://hvplot.holoviz.org/>`_.
+UXarray's plotting API is written using `hvPlot <https://hvplot.holoviz.org/>`_. We also support standalone functions
+for pure Matplotlib and Cartopy workflows.
 
 .. seealso::
 
     `Plotting User Guide Section <https://uxarray.readthedocs.io/en/latest/user-guide/plotting.html>`_
+    `Plotting with Matplotlib User Guide Section <https://uxarray.readthedocs.io/en/latest/user-guide/mpl.html>`_
 
 Grid
 ~~~~
@@ -276,14 +293,8 @@ UxDataArray
    UxDataArray.plot.line
    UxDataArray.plot.scatter
 
-UxDataset
-~~~~~~~~~
 
-.. autosummary::
-   :toctree: generated/
-   :template: autosummary/accessor_method.rst
 
-   UxDataset.plot