developed by OceanDataLab

Tutorials

SEAScope Viewer (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.tar.gz' \
     -O '/tmp/light_samples.tar.gz'

# Decompress it in the directory where you store IDF files (the "data" directory)
tar xzf /tmp/light_samples.tar.gz -C 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 signle 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'

SEAScope Viewer (macOS)

You can follow these simple instructions

  1. Download the data bundle
  2. Drag and drop the downloaded bundle on the Import to SEAScope droplet
  3. Wait for it to finish
  4. Launch 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 Import to SEAScope droplet
  6. Wait for it to finish
  7. Launch SEAScope and choose to rebuild the index if asked

SEAScope Viewer (Windows)

Python Bindings