==============================
Sea-surface Salinity animation
==============================

This example animates the sea-surface salinity (SSS) from the ACCESS-OM2 global ocean-sea ice model. 
The files loaded for these animations are located at:

.. code-block:: bash

    /g/data/cj50/access-om2/raw-output/access-om2-01/01deg_jra55v140_iaf/output2*/ocean/ocean-2d-surface_salt-1-daily-mean-ym_20*.nc

the variable:

.. code-block:: bash

    surface_salt

.. note::
    The path contains the wildcard ``*``  which allows the load of all the files contained in the repositories ``output2*`` and the netCDF files named ``ocean-2d-surface_salt-1-daily-mean-ym_20*.nc```

The animation consists of the sea-surface salinity on a sphere with the continents displaced to their given elevation and the texture displayed over the continents corresponds to the `natural earth  <https://www.naturalearthdata.com/>`_ dataset. Here's a snapshot of the animation:

.. figure:: salinity_test.png
    :alt: Sea Surface Salinity.


Download
--------
    
The provided animation can be found in `YouTube <https://youtu.be/4mUfd7A_SDw>`_. Otherwise, you can directly donwload the `mov file <https://github.com/COSIMA/3D_animations/raw/main/SSS/SSS_final0001-2000.mov>`_ or the `mp4 file <https://github.com/COSIMA/3D_animations/raw/main/SSS/SSS_final0001-2000.mp4>`_.

.. raw:: html

    <iframe width="560" height="315" src="https://www.youtube.com/embed/4mUfd7A_SDw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

.. note:: The provided animation has been edited to replace the date format from a string to a clock-like calendar. 

Reproduce Animation
-------------------

To reproduce the animation, make sure to install ``Blender`` and  ``BlenderNC`` by following the instructions at :ref:`installation`, and download this animation ``access_sss.blend`` file by `clicking here <https://github.com/COSIMA/3D_animations/raw/main/SSS/access_salinity.blend>`_.

After downloading the blender file and opening it in VDI or your rendering computer of preference, make sure to reconnect the BlenderNC nodes by following the instruction below:

1. Navigate to the BlenderNC nodetree:
   
2. Disconnect the output of the input node to update the nodetree:

3. Select the ``surface_salt`` variable:

4. Connect all the nodes in order:
   
5. Render image:

Now you can modify anything in the animation, from the lighting, the material, colorbar, to the dataset used for the animation.