.. _insula_access:

Insula Code
===========

`Insula Code <https://code.insula.destine.eu/>`_ is a browser-based
Jupyter environment hosted within the DestinE Platform with Polytope pre-configured,
requiring no local installation.

For the data request syntax, see :ref:`data_structure`.

Getting started
---------------

`Open the Climate DT polytope-lab directly in Insula Code
<https://code.insula.destine.eu/hub/user-redirect/lab/tree/polytope-lab>`_.
If you are not already logged in, you will be prompted to do so.

Once in polytope-lab, navigate to the ``climate-dt`` folder and open
an example notebook. As a starting point, open
``climate-dt-earthkit-fe-story-nudging.ipynb`` and select the
``Polytope`` kernel from the upper right corner.

Creating a new environment
---------------------------

If you require a fully custom Python environment, you can create one by
following the setup instructions described
`here <https://platform.destine.eu/docs/insula/doc/lab/python_api.html#create-a-new-environment>`_.
This will create a new environment and register it as a Jupyter kernel, which will then be
available for selection within Insula Code.

Updating an existing environment
---------------------------------

Additional packages can be installed by running ``pip install`` in one
of the first cells and restarting the kernel. For example:

.. code-block::

   pip install --upgrade --user earthkit
   pip install --user kaleido