# Introduction

## Case studied

This test case corresponds to a DIII-D discharge (\#158103) during ELM-suppressed phase
(3050ms) due to externally applied Resonant Magnetic Perturbations (RMPs). 

GTC is interfaced with an MHD code -- M3D-C1 -- to incorporate the RMP induced magnetic
island structures. In this specific case, the n=2, m=(6,7,8,9) islands are relevant,
especially the n=2,m=8 islands.

## Physics included

This is currently an adiabatic electron, electro-static simulation with static RMP islands 
treated as perturbations.

Possible future upgrades are:

- [ ] drift-kinetic electrons
- [ ] electro-magnetic simulations
- [ ] island equilibrium used as $f_0$

# GTC version requirement

GTC v4.0.3 or higher

# GTC Run Preparation

1. build the source code with 

        $ make ICONFIG=TOKAMAK

2. prepare the input files and job submission files as follows. 

# Datafiles needed for M3DC1-RMP run

## general data file

* maxwell.dat: data lookup table for collision process in Maxwellian

## specific data files

* profile.dat: 1D equilibrium profiles, specific to a shot number and time,
  the same as other GTC runs. See [DataFileFormat.md](../input/DataFileFormat.md) for details.

* m3dc1.nc: M3DC1 equilibrium file, specific to a shot number and time.
  See [DataFileFormat.md](../input/DataFileFormat.md) for details.

* m3dc1XX.nc: M3DC1 RMP perturbation file(s), specific to a shot number and time.
  See [DataFileFormat.md](../input/DataFileFormat.md) for details.

# Example data files

Example data files can be found in `input/DataFiles/DIIID/158103-3050ms/`, and 
`input/DataFiles/DIIID/158103-3796ms/`.

symbolic links to the 3050ms files has been provided in the current folder.

Same data files can also be found on UCI phoenix server:
/home/lshi/Public_Files/DataFiles/M3DC1/DIIID-RMP-158103-3050/