developed by OceanDataLab

Tutorials

SEAScope viewer

All platforms

You can add you own pictograms to SEAScope and use them to represent the trajectory positions that match the current time

Instructions for adding curstom pictograms

SEAScope only supports pictograms in PNG format that contain 4 channels (3 for primary colors and 1 for transparency).

The images should be square with a maximal size of 256x256 pixels.

Please note that SEAScope will rotate the images so that the bottom side faces the previous position in the trajectory and the top side faces the next position.

To add you own pictograms, you first have to locate your "custom" directory, the easiest way to achieve this is to:

  1. start SEAScope
  2. open the Settings tab in the side menu
  3. copy the value of the "Custom" field in the "Paths" section

If you inspect the content of this "custom" directory you should see that it contains a directory named "icons": simply copy your pictograms in this "icons" directory, restart SEAScope and you should now be able to choose your pictograms in the rendering configuration of trajectory collections!

Linux

You can follow these instructions to populate a vanilla SEAScope installation with these data samples

Instructions to install the data bundle
# Go to the seascope directory
  cd seascope

  # Download the bundle
  wget 'https://seascope.oceandatalab.com/data/idf_samples/light_samples_OTC2023.zip' \
       -O '/tmp/light_samples_OTC2023.zip'

  # Decompress it in the directory where you store IDF files (the "data" directory)
  unzip /tmp/light_samples_OTC2023.zip -d data

  # Regenerate the SEAScope index
  rm -f index.fb
  ./seascope

The method to use the individual samples slightly differs from the bundle one as you need to create the collection directory by yourself and put both the configuration and the IDF files in it,

Here is an example for the Sentinel-2 samples:

Instructions to install samples for a single collection (Sentinel-2)
# Go to the SEAScope directory
  cd seascope

  # Create a directory for the Sentinel-2 collection data (arbitrary choice)
  mkdir -p data/s2_collection

  # Download the configuration file for this collection
  wget 'https://seascope.oceandatalab.com/data/idf_samples/sentinel2/config.ini' \
       -O 'data/s2_collection/config.ini'

  # Download the archive containing IDF files
  wget 'https://seascope.oceandatalab.com/data/idf_samples/sentinel2/data.tar.gz' \
       -O '/tmp/s2_idf.tar.gz'

  # Extract IDF files in the data directory dedicated to this collection
  tar xzf '/tmp/s2_idf.tar.gz' -C 'data/s2_collection/'

  # Regenerate the SEAScope index
  rm -f index.fb
  ./seascope

The seascope-case-studies.sh script (available here) allows you to retrieve data for some case studies where you can see interesting phenomena and how the synergy between different data sources may be used to get a better understanding of the ocean physics.

Installing a case study using the script is a two-steps process.

  1. The first step is to get the identifier of the case study you are interested in. The script has a list command which gives you information about each availble case study, including the aforementioned identifier.

    Case studies listing
    ./seascope-case-studies.sh list

  2. Then use the get command to retrieve the data files for the case study and install them in your SEAScope "data" directory.
    In the example below the identifier of the case study is ocean_wind and the SEAScope "data" directory is seascope/data:

    Case study retrieval and installation
    ./seascope-case-studies.sh get 'ocean_wind' 'seascope/data'

Note that the script downloads file in the /tmp directory by default. If there is not enough space the command will fail. You can tell the script to use another temporary directory using the -t SOME_DIR option. This option must be set before the list or get commands!

Example of listing with an alternative temporary dir
./seascope-case-studies.sh -t ./dummy_directory get 'ocean_wind' 'seascope/data'
macOS

You can follow these simple instructions

  1. Download the data bundle
  2. Drag and drop the downloaded bundle on the SEAScope icon in Finder or the dock
  3. Wait for it to finish
  4. Restart SEAScope and choose to rebuild the index if asked

The method to use the individual samples slightly differs from the bundle one

  1. Download the collection configuration file (config.ini)
  2. Download the collection data archive (data.tar.gz)
  3. Uncompress the data archive by opening it
  4. Move the downloaded configuration file into the extracted folder
  5. Drag and drop the extracted folder on the SEAScope icon in Finder or the dock
  6. Wait for it to finish
  7. Restart SEAScope and choose to rebuild the index if asked
Windows

Python Bindings

Data loading notebooks

Training material