Introduction

Welcome to the SOLPS wiki, home to step-by-step guides on using the SOLPS-ITERopen_in_new transport code! Accessible documentation for beginners is our goal. As the main author, Kateřina Hromasová, says:

"I want tutorials that are so easy to understand that I'll be able to use them out of the box after I come back from a three-year maternity leave."

The SOLPS wiki webpage is compiled using MkDocsopen_in_new from its source code, hosted on the IPP Prague's GitLabopen_in_new. If you wish to contribute, read its READMEopen_in_new.

SOLPS wiki logo: a supra-luminal unicorn (why?)

Navigating the wiki

The SOLPS wiki has three basic parts:

1. My first SOLPS simulation. This includes installing SOLPS, creating a simulation, running the simulation, processing its output and adjusting its input.

2. Feature blog, or making your SOLPS simulation more complex. This includes diffusion coefficients, gas puffing and pumping, impurities, drifts, wide grids, and deep dives on magnetic equilibrium reconstructions, energy fluxes and interpretative simulations.

3. Supplementary material, which helps you use SOLPS aside from the physics. This includes SOLPS-ITER user wisdom, a library, remote access, common pitfalls, questions and answers and B2.5 switch documentation.

When contributing to the wiki, please respect this underlying structure.

First steps

To familiarise yourself with SOLPS-ITER and this wiki, you can do the following:

• To learn what SOLPS-ITER is and what it's for, read the brief introduction to SOLPS-ITER and skim the references therein (SOLPS-related theses and articles).

• To become familiar with SOLPS-ITER jargon, skim SOLPS-ITER user wisdom, particularly the Dictionary.

• If you need to run SOLPS on a remote server (like the EUROfusion Gateway), read up on the basic techniques of remote access.

• Install SOLPS-ITER. Or better yet, use the portable container installation.

• Create your first SOLPS-ITER simulation. Then continue down the list of tutorials on the left in the section My first SOLPS-ITER simulation.

• When faced with problems, try the search bar on the top right, Questions and answers or Common pitfalls.

Brief introduction to SOLPS-ITER

SOLPS-ITER is a suite of codes (B2.5, EIRENE, DivGeo, Carre...) which performs 2D (toroidally symmetric) simulations of the tokamak edge plasma. Its strength is self-consistently modelling interaction between the plasma, neutrals and the wall. It is indispensable for predicting if future fusion reactors will melt their divertors or not.

Essential SOLPS-ITER reading:

• [Wiesen 2015]open_in_new - cite this under any SOLPS-ITER results
• [Reiter 2005]open_in_new - acknowledge thisopen_in_new under any EIRENE results
• [Bonnin 2016]open_in_new - recommended to cite under any SOLPS-ITER results

Recommended SOLPS-ITER reading:

• [Schneider 2006]open_in_new - old but gentle and extensive review article
• [Braginskii 1965]open_in_new - Braginskii equations are the beating heart of SOLPS-ITER
• PhD thesisopen_in_new of Antonello Zito
• PhD thesisdownload of Kateřina Hromasová

Your documentation could be here!

Although the SOLPS wiki does not aim to substitute existing SOLPS documentation, it does aspire to become its central hub. If you have written any sort of SOLPS-related documentation, consider contributing to the SOLPS wikiopen_in_new or adding your work to the Useful links section.

Contributors

Kateřina Hromasová

"If you don't write it down, you'll forget it."

Katka was two years into her PhD on SOLPS-ITER when she got married, agreed on three kids, and realised she'd better get started. To avoid forgetting everything, she began writing down all she knew. She shared her notes with her colleagues, got help putting them up on the internet, realised people outside IPP Prague actually read them, rewrote them to pretend she was a professional... and that's how the SOLPS wiki was born.

Jan Hečko

"The smaller and easier a task is, the lower it is on my to-do list."

Honza has awesome superpowers, such as being one with the source code. He is responsible for the installation tutorials, the B2.5 switch documentation and the wiki formatting. He also wrote most of the Gas puffing and pumping and Drifts tutorials, and he got the Wide grids tutorial started.

Other major contributors to the SOLPS wiki are:

• Aleš Podolník - wrote the Energy fluxes deep dive

We would also like to thank, in alphabetic order, Xavier Bonnin, Irina Borodkina, David Coster, Michael Komm, Lukáš Kripner, Diana Naydenkova, Jakub Seidl, Oleg Shyshkin, Daniel Švorc, Matěj Tomeš, David Tskhakaya, and Sven Wiesen.