Metadata-Version: 2.4
Name: python-env-osmose2026
Version: 1.6
Summary: Helper for installing the Python environment for the OSMOSE 2026 Training Course interactive lectures based on SEAScope
Home-page: https://pypi.org/project/python-env-osmose2026/
Author: Sylvain Herlédan
Author-email: sylvain.herledan@oceandatalab.com
Project-URL: Homepage, https://osmose26.sciencesconf.org/
Project-URL: Issues, https://forum.oceandatalab.com
Description-Content-Type: text/x-rst
License-File: COPYING
License-File: COPYING.LESSER
Requires-Dist: pySEAScope[processor]
Requires-Dist: idf-converter
Requires-Dist: gputil
Requires-Dist: scipy
Requires-Dist: matplotlib
Requires-Dist: pywinpty; sys_platform == "win32"
Requires-Dist: jupyterlab
Requires-Dist: pooch
Requires-Dist: notebook
Requires-Dist: scikit-image
Requires-Dist: pandas
Requires-Dist: geopandas
Requires-Dist: xarray
Requires-Dist: astropy
Requires-Dist: scikit-learn
Requires-Dist: rasterio
Requires-Dist: geopy
Requires-Dist: pathlib
Requires-Dist: dask[distributed]
Requires-Dist: copernicusmarine
Requires-Dist: xsarsea
Requires-Dist: cartopy
Requires-Dist: cmocean
Requires-Dist: eumdac
Requires-Dist: pyproj
Requires-Dist: earthengine-api
Requires-Dist: geemap
Dynamic: license-file

During the interactive lectures of the OSMOSE 2026 training course, you will
need to install tools and libraries for reading, processing and visualizing
data.

To make sure all students get the same environment, a bundle containing
SEAScope [1]_, Python 3.11.15 and additional material required by some lectures
has been created.


Installation
============

To install the software bundle:

1. Locate a disk/partition with the most free space on your computer (software
   itself does not take much space, but data used during the lectures will
   require several gigabytes).

   Please note that remote storage (OneDrive, Dropbox, Google Drive, etc...) is
   not suitable for installing the OSMOSE2026 environment, make sure to choose
   a storage whose hardware is actually located inside your computer (harddisk,
   SSD).

2. Create a new directory on that disk/partition, all the software and data
   used during the course will be stored in that directory.

   Note that moving the directory elsewhere or renaming it will create
   problems, so choose wisely (using a short and meaningful name such as
   ``osmose26`` is recommended).

   This directory will be referred to as the "OSMOSE directory" in the upcoming
   instructions.

3. The next steps depend on your operating system:

   **Linux**

   * Download https://ftp.odl.bzh/odl/events/osmose26/software/linux-osmose26-bundle.sh

   * Save the file in the OSMOSE directory

   * Open your file browser (or a terminal) and go to the OSMOSE directory,
     then double-click on the bundle file (or execute it from the terminal).

   +------------------------------------------------------------------------+
   | Depending on the web browser used to download the bundle, you may have |
   | to make the file executable before double-clicking on it (either using |
   | your file browser or by running the                                    |
   | ``chmod +x linux-osmose26-bundle.sh`` command in a terminal.           |
   +------------------------------------------------------------------------+

   **Windows**

   * Download https://ftp.odl.bzh/odl/events/osmose26/software/windows-osmose26-bundle.bat

   * Save the file in the OSMOSE directory

   * Open your file browser (or a terminal) and go to the OSMOSE directory,
     then double-click on the bundle file (or execute it from the
     terminal).

   +---------------------------------------------------------------+
   | Windows might issue a warning regarding the execution of the  |
   | file, click on the "More info" link so Windows will display a |
   | button allowing you execute the file anyway.                  |
   +---------------------------------------------------------------+

   **macOS**

   * Install SEAScope using the instructions available on https://seascope.oceandatalab.com/macos.html

   * Open a terminal

   * Move to the OSMOSE directory using the ``cd`` command

   * Execute the following command:

     .. code:: bash

        curl -fsSL https://ftp.odl.bzh/odl/events/osmose26/software/macos_get-osmose26.sh | sh


4. The installation of the bundle will start and will take several minutes.

   A message is displayed at the end of the installation process, explaining
   how to start SEAScope and a new terminal already set up for the training
   course.

   **Do not interrupt the installation process until you see that message!**

Verification
============

The software bundle includes a small tool to check that the environment is
correctly installed.

To perform this check:

1. Using a file browser, go to the OTC directory

2. Start SEAScope:

   **Linux**

   * Go to the ``seascope`` sub-directory

   * Double-click on the ``seascope`` file

   **Windows**

   * Go to the ``seascope`` sub-directory

   * Double-click on the ``SEAScope`` shortcut

   **macOS**

   * Click on the SEAScope application

   The SEAScope viewer will start and display a globe.

   Keep the viewer running, it will be used in the next steps.

4. In your file browser, go back to the OSMOSE directory, there should be a
   file named ``Terminal.sh`` (Linux), ``Terminal.bat`` (Windows) or
   ``Terminal`` (macOS).

   Double-click on that file (or execute it) to open a terminal.

5. In the terminal, type:

   .. code:: bash

      osmose2026-check-environment

   It might take some time depending on your computer but at the end it should
   open a Jupyter notebook in your web browser, and the "O" letter should
   appear on the globe in the SEAScope viewer.

   Please follow the instructions mentioned in the notebook to determine
   whether or not the tests were successful.

   Each notebook cell can be executed by pressing Shift+Enter or by clicking on
   the button with a "Play" symbol (▶).

6. Close the notebook in your web browser. You can also stop the SEAScope
   viewer and close your terminal.

   You're ready for the interactive lectures! :)

Additional information
======================

+-----------------------------------------------------------------------------+
| The OSMOSE environment installed with the bundle scripts are independent    |
| from your operating system and should not require any admin permissions.    |
+-----------------------------------------------------------------------------+

....

.. [1] on macOS SEAScope must be installed separately
