.. _working_with_xarray_and_windkit:

Working With Xarray and WindKit
===============================

PyWAsP uses WindKit's data structures built on :doc:`xarray <xarray:index>`. Before diving into
PyWAsP workflows, we recommend familiarizing yourself with these foundations.

**Key concepts:**

- Data is stored in :py:class:`xarray.Dataset` and :py:class:`xarray.DataArray` objects
- Labeled dimensions enable selection by name rather than index
- Coordinates automatically align and broadcast
- Attributes attach metadata directly to data

.. seealso::

    :doc:`windkit:user_guide/index`
        Complete introduction to WindKit capabilities and I/O formats.

    :doc:`windkit:user_guide/spatial/index`
        Spatial structures (point, raster, cuboid) and coordinate reference systems.

    :doc:`windkit:user_guide/wind_climates/index`
        Working with wind climate data (TSWC, BWC, WWC, GWC).

    :doc:`windkit:user_guide/topography/index`
        Working with elevation, roughness, and land cover data.

    :doc:`xarray:getting-started-guide/quick-overview`
        Xarray's official quick overview for new users.