SERPENTINE User Workshop 2022 Materials

Python Requirements Installation

This guide helps you to install the required software to run the Python/Jupyter Notebook examples of the workshop.

1. Make sure you have a recent version of Anaconda installed.
2. Open your terminal/command line/Anaconda prompt and run the following:

   $ conda create --name serpentine python=3.9
   $ conda activate serpentine

3. Download this file that contains a list of the required Python packages to a folder of your choice.
4. In your terminal/command line/Anaconda prompt, navigate to the folder with the downloaded file requirements.txt, and run the following (first command is just to verify that you are in the correct conda environment):

   $ conda activate serpentine
   $ pip install -r requirements.txt

Registering at Joint Science Operations Center (JSOC)

Note that for running the PFSS functionality of the Solar-MACH tool, a registered user account is needed for obtaining HMI maps through JSOC! For this, please register your email at http://jsoc.stanford.edu/ajax/register_email.html

Instructions for Hands on Sessions (on site)

Tuesday

• WP7: Introduction to the server
  • SERPENTINE project data center: https://data.serpentine-h2020.eu
  • EPD-EPT level3 data demo
• WP6: Analysis & Visualization tools
  • Propagation Tool instructions are available at the website: http://propagationtool.cdpp.eu
  • Linux users: installation of Java Runtime Environment (JRE) is necessary to run the tool (more info)
  • Hands-on session infos:
    • Propagation Tool tutorial
    • AMDA (Solar Orbiter/HET plotting example)
    • Magnetic Connectivity Tool tutorial

Wednesday

• WP2: Multi-spacecraft SEP event analysis
  1. Download this file and extract to a folder of your choice (or clone the repository https://github.com/serpentine-h2020/serpentine if you know how to use git).
  2. Open your terminal/command line/Anaconda prompt.
  3. In the terminal, navigate to the downloaded (extracted) folder notebooks.
  4. Make sure the corresponding conda environment is activated by running conda activate serpentine in the terminal.
  5. Run jupyter notebook
  6. Your standard web-browser should now open the Jupyter interface, where you can double click on the the corresponding folders and .ipynb files to launch them.
• WP3: Solar wind & solar eruption analysis
  1. Open your terminal/command line/Anaconda prompt.
  2. Make sure the corresponding conda environment is activated by running conda activate serpentine in the terminal.
  3. Run pip install PyThea==0.7.0 (Note that for Windows users, this unfortunately most probably will crash at the moment.)

Thursday

• WP4: In-situ shock parameter analysis
  1. Download this file and extract to a folder of your choice (or clone the repository https://github.com/serpentine-h2020/user-workshop-2022 if you know how to use git).
  2. Open your terminal/command line/Anaconda prompt.
  3. In the terminal, navigate to the downloaded (extracted) folder shock_analysis.
  4. Make sure the corresponding conda environment is activated by running conda activate serpentine in the terminal.
  5. Run jupyter notebook
  6. Your standard web-browser should now open the Jupyter interface, where you can double click on the the corresponding folders and .ipynb files to launch them.