.. include:: common_links.inc
.. _iris_docs:


Iris
====

**A powerful, format-agnostic, community-driven Python package for analysing
and visualising Earth science data.**

Iris implements a data model based on the `CF conventions <http://cfconventions.org>`_
giving you a powerful, format-agnostic interface for working with your data.
It excels when working with multi-dimensional Earth Science data, where tabular
representations become unwieldy and inefficient.

For more information see :ref:`why_iris`.

.. panels::
    :container: container-lg pb-3
    :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2 text-center
    :img-top-cls: w-50 m-auto px-1 py-2

    ---
    :img-top: _static/icon_shuttle.svg

    Information on Iris, how to install and a gallery of examples that
    create plots.
    +++
    .. link-button:: getting_started
        :type: ref
        :text: Getting Started
        :classes: btn-outline-info btn-block


    ---
    :img-top: _static/icon_instructions.svg

    Learn how to use Iris, including loading, navigating, saving,
    plotting and more.
    +++
    .. link-button:: user_guide_index
        :type: ref
        :text: User Guide
        :classes: btn-outline-info btn-block

    ---
    :img-top: _static/icon_development.svg

    As a developer you can contribute to Iris.
    +++
    .. link-button:: development_where_to_start
        :type: ref
        :text: Developers Guide
        :classes: btn-outline-info btn-block

    ---
    :img-top: _static/icon_api.svg

    Browse full Iris functionality by module.
    +++
    .. link-button:: Iris
        :type: ref
        :text: Iris API
        :classes: btn-outline-info btn-block

    ---
    :img-top: _static/icon_new_product.svg

    Find out what has recently changed in Iris.
    +++
    .. link-button:: iris_whatsnew
        :type: ref
        :text: What's New
        :classes: btn-outline-info btn-block

    ---
    :img-top: _static/icon_thumb.png

    Raise the profile of issues by voting on them.
    +++
    .. link-button:: voted_issues_top
        :type: ref
        :text: Voted Issues
        :classes: btn-outline-info btn-block


Icons made by `FreePik <https://www.freepik.com>`_ from
`Flaticon <https://www.flaticon.com/>`_


.. _iris_support:

Support
~~~~~~~

We, the Iris developers have adopted `GitHub Discussions`_ to capture any
discussions or support questions related to Iris.

See also `StackOverflow for "How Do I? <https://stackoverflow.com/questions/tagged/python-iris>`_
that may be useful but we do not actively monitor this.

The legacy support resources:

* `Users Google Group <https://groups.google.com/forum/#!forum/scitools-iris>`_
* `Developers Google Group <https://groups.google.com/forum/#!forum/scitools-iris-dev>`_
* `Legacy Documentation`_ (Iris 2.4 or earlier).  This is an archive of zip
  files of past documentation.  You can download, unzip and view the
  documentation locally (index.html).  There may be some incorrect rendering
  and older javascvript (.js) files may show a warning when uncompressing, in
  which case we suggest you use a different unzip tool.


.. toctree::
   :caption: Getting Started
   :maxdepth: 1
   :hidden:

   getting_started


.. toctree::
   :caption: User Guide
   :maxdepth: 1
   :name: userguide_index
   :hidden:

   userguide/index


.. toctree::
   :caption: Developers Guide
   :maxdepth: 1
   :name: developers_index
   :hidden:

   developers_guide/contributing_getting_involved


.. toctree::
   :caption: Community
   :maxdepth: 1
   :name: community_index
   :hidden:

   Community <community/index>


.. toctree::
   :caption: Iris API
   :maxdepth: 1
   :hidden:

   generated/api/iris


.. toctree::
   :caption: What's New in Iris
   :maxdepth: 1
   :name: whats_new_index
   :hidden:

   whatsnew/index

.. todolist::