Overview of the MDSplus Structure for the Disruption Database
Data loaded to the disruption database is stored in the MDSplus database on the server iddb.gat.com:9000.
The MDSplus disruption data is stored in several trees. The tree names are based on which machine's data has been loaded and has the form :
DDB_<tokamak> for example: DDB_D3D or DDB_JET
The tree structure, node names, and tag names are identical for each of the DDB_tokamak trees. Below is a list of the available data.
ALL submissions to the IDDB must include, at a minimum, the required Base variables from Table 1. If submitting disruption mitigation data, the highlighted variables from Table 2 must also be included. If submitting halo current data, the highlighted variables from Table 3 must also be included. Please do not submit data without meeting these minimum requirements. All users are encouraged to submit as many of the variables as possible.
Figure 1 shows a sketch of the halo current and plasma current waveforms. Both TAG NAME and traditional data nomenclature are used. It provides a reference for the various times (e.g. TIMED) use in the tables.
| Tag Name | Units | Data Type | Comment |
|---|---|---|---|
| \AMIND | m | float | minor radius |
| \AREAD | m^2 | float | poloidal crossectional area |
| \BEPMHD_D | (unitless) | float | poloidal beta |
| \BETAND | %-m-T/MA | float | Normalized toroidal beta |
| \BETANMAX | %-m-T/MA | float | Maximum betan measured at TIME |
| \BETMHD_D | % | float | toroidal beta |
| \BOUNDRD | m | float | Radial dimensions of plasma boundary at TIMED |
| \BOUNDZD | m | float | Vertical dimensions of plasma boundary at TIMED |
| \BPOLD | T | float | average poloidal field around plasma crossectional surface |
| \BTD | T | float | vacuum toroidal field at RGEOD |
| \CAUSED | (unitless) | string | Proximate cause (Internal, External) |
| \CHISQD | (unitless) | float | chi-sq equilibrium fitting parameter |
| \COMMENT | (unitless) | string | |
| \CONFIGD | (unitless) | string p | lasma configuration: LIM, SNB,DN, etc. |
| \DATE | (unitless) | integer | yyyymmdd |
| \DELTALD | (unitless) | float | lower triangularity |
| \DELTAUD | (unitless) | float | upper triangularity |
| \DIDTMAX | A/s | float | smoothed dI/dt measured at TIMEDIDTMAX |
| \DIVNAME | (unitless) | string | ADP, RDP, etc - divertor configuration |
| \DRSEPD | m | float | outer midplane radial distance between surfaces defined by upper and lower x-points |
| \ELM_E | (unitless) | string | ELMing at TIMEQD: Y or N |
| \EVIDRAE_E | (unitless) | string | evidence of runaways seen? Y or N |
| \INDENTD | (unitless) | float | beanlike indentation |
| \INTLID | (unitless) | float | internal inductance |
| \IPD | A | float | plasma current at TIMED |
| \IPEQD | A | float | plasma current at TIMEQD |
| \IPPHASED | (unitless) | string | plasma current mode at TIMED: FLATTOP, RAMPUP, ETC. |
| \IPSPK | A | float | max spike current measured at TIMESPK |
| \IPSPK_E | (unitless) | string | Discernable current spike? Y or N |
| \IPT | A, s | signal | Plasma current through disruption |
| \KAPPAD | (unitless) | float | elongation at TIMEQD (closest eq to TIMED) |
| \NINDXD | (unitless) | float | vert. Stab critical index |
| \PHASED | (unitless) | string | performance mode at TIMEQD: O(hmic), H, L, Hyb, etc. |
| \Q95D | (unitless) | float | safety factor at 95% flux |
| \QMIND | (unitless) | float | minimum safety factor in plasma |
| \RGEOD | m | float | plasma geometric center major radius |
| \RMAGD | m | float | plasma magnetic center major radius |
| \SHOT | (unitless) | integer | Shot Number |
| \SQUOD | (unitless) | float | Plasma upper, outer squareness at TIMED |
| \SQUID | (unitless) | float | Plasma upper, inner squareness at TIMED |
| \SQLOD | (unitless) | float | Plasma lower, outer squareness at TIMED |
| \SQLID | (unitless) | float | Plasma lower, inner squareness at TIMED |
| \TIME | s | float | Time of maximum performance in shot |
| \TIME1 | s | float | time Ip falls to 10% of IPD |
| \TIME2 | s | float | time Ip falls to 20% of IPD |
| \TIME3 | s | float | time Ip falls to 30% of IPD |
| \TIME4 | s | float | time Ip falls to 40% of IPD |
| \TIME5 | s | float | time Ip falls to 50% of IPD |
| \TIME6 | s | float | time Ip falls to 60% of IPD |
| \TIME7 | s | float | time Ip falls to 70% of IPD |
| \TIME8 | s | float | time Ip falls to 80% of IPD |
| \TIME9 | s | float | time Ip falls to 90% of IPD |
| \TIME95MAX | s | float | Time betan reaches 95% of BETANMAX |
| \TIMED | s | float | typically 2 ms before current spike max dI/dt |
| \TIMEDIDTMAX | s | float | time of max increasing dI/dt |
| \TIMEQD | s | float | time of acceptable chisq EFIT closest to TIMED |
| \TIMERMAX | s | float | time of maximum radiated power |
| \TIMESPK | s | float | time of current max after TIMEDIDTMAX |
| \TOK | (unitless) | string | D3D,"JET", etc... |
| \TQ_E | (unitless) | string | Thermal quench data exist? Y or N |
| \VDE_E | (unitless) | string | Significant vertical motion before or during disruption? Y or N |
| \VDEDRIFT | (unitless) | string | Direction of drift: UP, DN, NO[NE] |
| \VOLD | m^3 | float | plasma volume |
| \WDIAD | J | float | diamagnetic derived energy |
| \WTOTD | J | float | total kinetic energy |
| \ZMAGD | m | float | plasma magnetic center height above midplane |
| Tag Name | Units | Data Type | Comment |
|---|---|---|---|
| VVESSEL | m^3 | float | volume of the vacuum vessel |
| AVESSEL | m^2 | float | Surface area of first wall (Including port holes) |
| INJTYPE[1,2] | (unitless) | string | type of injector (VALVE: electromagnetic, piezo, guiding tube, etc.) or (PELLET: solid, shell, SPI,etc..) |
| INJDIST[1,2] | m^3 | float | distance valve to separatrix |
| INJANGPOL[1,2] | deg | float | Poloidal angle of injector location (counter-clockwise from outer midplane) |
| INJANGTOR[1,2] | deg | float | Toroidal angle of injector location |
| NPARTMAX[1,2] | 1 | float | maximum possible number of particles that can be injected with this valve |
| PRESSMAX[1,2] | Pa | float | maximum possible pressure [N/A for pellets] |
| PRESS[1,2] | Pa | float | pressure in valve [N/A for pellets] |
| NPART[1,2] | 1 | float | total number of injected particles |
| SPECIESMAJ[1,2] | (unitless) | string | Injected gas species (majority) |
| SPECIESMIN[1,2] | (unitless) | string | injected gas species (minority) |
| SPECIESRAT[1,2] | (unitless) | float | ratio majority / minority (particles) |
| NPARTSPK[1,2] | (unitless) | float | number of particles injected at time \TIMESPK |
| MNPARTSPK[1,2] | (unitless) | string | method to determine \NPARTICLE_SPK (gas flow modelling, lab calibration, etc) |
| TINJTRIG[1,2] | s | float | time of valve trigger |
| TIMPARRIV | s | float | time of impurity arrival at plasma edge (from visible, bolometry, edge temperature, other) |
| MIMPARRIV | (unitless) | string | method to determine \TIMPARRIV |
| DIDTMIN | A/s | float | minimum negative dI/dt during current quench (max current drop) |
| TDIDTMIN | s | float | time of minimum negative dI/dt |
| IPDIDTMIN | A | float | plasma current at \TIMEDIDTMIN |
| PRAD_MAX | W | float | maximum radiated power at time \TIMERMAX |
| WRAD | J | float | total radiated energy during disruption (from \TIMPARRIV to \TIME1) |
| WRAD_SPK | J | float | radiated energy until \TIMESPK |
| PRADASYM | (unitless) | float | Radiation asymmetry (max/min) at time \TIMERMAX |
| PRADASYMANG[1,2] | Deg | float | Toroidal angle of radiated power measurement |
| DENS | m^-3 | float | central line-averaged density at \TIMPARRIV |
| DENSSPK5 | m^-3 | float | Time-averaged line-averaged density from \TIMESPK to \TIME5 |
| DENSMAXCQ | m^-3 | float | maximum central line-averaged density during current quench |
| TE | eV | float | maximum electron temperature at \TIMPARRIV |
| TI | eV | float | maximum ion temperature at \TIMPARRIV |
| TEPED | eV | float | pedestal or LCFS electron temperature at \TIMPARRIV |
| WDIAPED | J | float | pedestal energy at \TIMPARRIV |
| WTH_Q2 | J | float | thermal energy inside q = 2 at time \TIMPARRIV |
| CONTROLSHOT | (uniteless) | float | Control shot # without mitigation for comparison |
| Tag Name | Units | Data Type | Comment |
|---|---|---|---|
| IHMAX | A | float | Maximum total in-vessel halo current (poloidal/vertical) |
| TIMEIHM | s | float | Time of IHMAX |
| TPFATMAX | (unitless) | float | Maximum localized halo current (A/rad)/toroidally-averaged halo current |
| IPATMAX | A | float | Total plasma current (core + halo) at time of IHMAX |
| RATMAX | m | float | Major radius at time of IHMAX |
| ZATMAX | m | float | Height (Z-Z0) at time of IHMAX |
| KATMAX | (unitless) | float | Vertical elongation (b/a) at time of IHMAX |
| TIME | N | float | Peak vertical force on VV |
| TIMEFZM | s | float | Time of peak FZVV |
| IZVV | N*s | float | Total VV Z impulse (integral Fz dt) |
| AUTOMATICALLY CALCUALTED VALUES (do not require submission) | |||
| HALOFRAC | (unitless) | Float | IHMAX / IPD |
Figure 2 shows a sketch illustrating the definition of TPF. How TPF is derived from a given machine's experimental data, with finite toroidal halo current data samples and finite toroidal coverage, is up to the contributing machine to determine.
Experimental halo current data is usually 'noisy' (reflecting actual Ih fluctuations + EM and other noise). Data averaging or filtering and fitting versus toroidal angle to derive 'meaningful' data for IHMAX, IPATMAX and TPFATMAX is up to you.
Figure 1: Cartoon illustrating Ip and Ih waveforms and key data
Figure 2: Definition of TPF (conceptual)