Computer Setup Instructions

Introduction

The “Earth Observation Data Processing Tutorial”, provided in the next four sections, uses the Python programming language and the European Space Agency’s Sentinel Application Platform (ESA SNAP) software. The data that will be used for the practical session can be downloaded here. The suggested installation guide for both Python and ESA SNAP will be provided for Windows, MacOS and Linux in the following section, although users are free to follow their own method.

Note If you receive any errors during installation, please contact the facility for help, at fsf@ed.ac.uk

Windows

Python

  1. Download the Anaconda Data Science Platform for Windows
  2. Install, following the instructions provided
  3. Open “Anaconda Navigator”, and select “Environments” on the left hand column.
  4. Select “Create”.
  5. In the window that appears, name your environment field_spectroscopy
  6. Select Python version 3.11 or over.
  7. Once the environment is installed, click the Play icon next to the field_spectroscopy environment name
  8. Select Open Terminal
  9. In the command prompt window that appears, copy and paste the following:
    conda install -c conda-forge jupyterlab git
    
  10. Once installed, copy and paste the following in the command prompt:
    pip install git+https://github.com/NERC-FSF/SpecDAL.git
    
  11. Once installed, copy and paste the following in the command prompt:
    pip install git+https://github.com/NERC-FSF/FieldSpecUtils.git
    
  12. Close the command prompt window, and return to Anaconda Navigator.
  13. With the field_spectroscopy environment still activate, navigate to Home.
  14. Launch Jupyter Lab from the GUI.
  15. In Jupyter-Lab, navigate to the folder extracted from the .zip download.

SNAP

  1. Navigate to the ESA SNAP Download Page.
  2. For Windows, select the Windows 64-Bit, Sentinel Toolbox, Main Download.
  3. Run the .exe file downloaded, and follow the installation instructions.

MacOS

Python

  1. Download the Anaconda Data Science Platform for MacOS X
  2. Install, following the instructions provided
  3. Open “Anaconda Navigator”, and select “Environments” on the left hand column.
  4. Select “Create”.
  5. In the window that appears, name your environment field_spectroscopy
  6. Select Python version 3.11 or over.
  7. Once the environment is installed, click the Play icon next to the field_spectroscopy environment name
  8. Select Open Terminal
  9. In the Terminal that appears, copy and paste the following:
    conda install -c conda-forge jupyterlab git
    
  10. Once installed, copy and paste the following in the Terminal:
    pip install git+https://github.com/NERC-FSF/SpecDAL.git
    
  11. Once installed, copy and paste the following in the command prompt:
    pip install git+https://github.com/NERC-FSF/FieldSpecUtils.git
    
  12. Close the Terminal, and return to Anaconda Navigator.
  13. With the field_spectroscopy environment still activate, navigate to Home.
  14. Launch Jupyter Lab from the GUI.
  15. In Jupyter-Lab, navigate to the folder extracted from the .zip download.

SNAP

  1. Navigate to the ESA SNAP Download Page.
  2. For Windows, select the MacOS X, Sentinel Toolbox, Main Download.
  3. Right click the .dmg file downloaded, select Open, and follow the installation instructions.

Linux

Python

  1. Ensure that you have the correct pre-requisite packages installed
  2. Install, following the instructions provided
  3. Open “Anaconda Navigator”, and select “Environments” on the left hand column.
  4. Select “Create”.
  5. In the window that appears, name your environment field_spectroscopy
  6. Select Python version 3.11 or over.
  7. Once the environment is installed, click the Play icon next to the field_spectroscopy environment name
  8. Select Open Terminal
  9. In the Terminal that appears, copy and paste the following:
    conda install -c conda-forge jupyterlab git
    
  10. Once installed, copy and paste the following in the Terminal:
    pip install git+https://github.com/NERC-FSF/SpecDAL.git
    
  11. Once installed, copy and paste the following in the command prompt:
    pip install git+https://github.com/NERC-FSF/FieldSpecUtils.git
    
  12. Close the Terminal, and return to Anaconda Navigator.
  13. With the field_spectroscopy environment still activate, navigate to Home.
  14. Launch Jupyter Lab from the GUI.
  15. In Jupyter-Lab, navigate to the folder extracted from the .zip download.

SNAP

  1. Navigate to the ESA SNAP Download Page.
  2. For Linux, select the Linux 64-bit, Sentinel Toolbox, Main Download.
  3. In a Terminal, copy and paste the following, replacing /path/to/your/ with the correct path file:
    bash bash /path/to/your/esa-snap_sentinel_linux-10.0.0.sh
    
  4. Follow the installation instructions.