Basics
======

This is a basic introduction to using pyarts

It will take you through the following concepts:

.. contents::
   :depth: 1
   :local:
   :backlinks: none

Create a workspace
------------------

This example shows how to create a Workspace, the common entry point for
all pyarts simulations.

.. plot:: ../../../examples/1-basics/1-create-a-workspace.py
    :include-source:

Setting workspace variable
--------------------------

This example shows how to set a workspace variable.  The way
workspace variables are set depends on the constructors or __init__
methods available for the respective ARTS classes.  We hope that most
of our constructors make pythonic sense

.. plot:: ../../../examples/1-basics/2-setting-workspace-variables.py
    :include-source:

Loading data from file
----------------------

This example shows how to load data from a file into a workspace variable.


.. plot:: ../../../examples/1-basics/3-loading-data-from-file.py
    :include-source:

Running a workspace method
--------------------------

This example demonstrates how to run a workspace method.
We have shown this in previous examples, but here we will
explain some details.

.. plot:: ../../../examples/1-basics/4-running-a-workspace-method.py
    :include-source:

Create an agenda
----------------

This will explain how to create an agenda and set it on the workspace.


.. plot:: ../../../examples/1-basics/5-create-an-agenda.py
    :include-source:

Atmospheric field from netcdf
-----------------------------

This demonstrates how to set your atmospheric field using netcdf.

An atmospheric field is created using standard workspace method
flow.  The atmospheric field is then gridded to a uniform grid
before being written to a netcdf file via the :class:`xarray.Dataset`
format.

An helper method

.. plot:: ../../../examples/1-basics/6-atmospheric-field-from-netcdf.py
    :include-source:

.. |atmosphere.nc| replace::
   :download:`atmosphere.nc <../../../examples/1-basics/atmosphere.nc>`