MDSplus Tree Structure for Profile Database.

• First open the tree for the discharge.

To do this it is necessary to specify the MDSplus server, tree, and shot. For public data the server is 'tokamak-profiledb.ccfe.ac.uk' and the tree name contains the tokamak name. (Prefixing the tokamak name by 'pr98_' gives access to publicly available trees from the Public Release in 1998.) Once these have been specified 'mdsconnect' and 'mdsopen' can be called to gain read access to this data. IDL> server='tokamak-profiledb.ccfe.ac.uk' IDL> tree='i_d3d' # NB this is an INaccessible tree, which includes the EQUIL branch (new Dec 2005) IDL> shot='100' # If you want to try this, use an accessible tree: tree= 'pr98_tftr' shot='102257' IDL> mdsconnect,server IDL> mdsopen,tree,shot
• Each original ASCII file is stored as a node under the top node.

Currently there are up to five branches per discharge. These are for the comments, equil, 1D, 2D, and 0D data. IDL> mdstcl,'dir \top.*' \I_D3D::TOP COMMENTS EQUIL ONED TWOD ZEROD Total of 5 nodes.
• Main Branches
1. Comments Signals.

There are currently 13 nodes current nodes per discharge, all are strings with new lines separated by ASCII newline characters. We have TRIED to fill these from the comments files, but this has NOT always been possible. Any lines in comments files which DID NOT FIT the standard comments file prescription are stored in 'ADDITIONAL'. The 'ALL' field contains the WHOLE comments file, to avoid data loss from parsing problems. Note that these field names do not exactly match the fields in the original file. IDL> mdstcl,'dir \top.comments:*' \I_D3D::TOP.COMMENTS :ADDITIONAL :ALL :ANAL_CODES :ANAL_DATES :ASSUMPTION :CONTACT :DESCRIPTION :INSTITUTION :PUBLICATION :RUN_NUMBER :SHOT :SHOT_DATE :TOKAMAK Total of 13 nodes. It will be possible to specify new comment nodes in the future. All of these must be agreed with the database managers first though.
2. EQUIL Signals.

The equilibrium branch is new (December 2005) and conforms to the tree structure that was first proposed by the ITPA Pedestal Group in April 2004. IDL> mdstcl,'dir \top.equil:*' \I_D3D::EQUIL :FFPRIMPSI :FPOLPSI :PPRIMEPSI :PRESPSI :PSIBDRY :PSIMAG :PSIRZ :QPSI :RBDRY :RCONTR :RMAXIS :RXPT :ZBDRY :ZCONTR :ZMAXIS :ZXPT Total of 16 nodes.
3. 1D data.

The 1D branch contains 1D signals (and thus have a corresponding time dimension) and dimensional quantities are all built with units. Where units were not given the standard units for the signal were used. IDL> mdstcl,'dir \top.oned:*' \I_D3D::ONED :AMIN :BT :DELTA :DELTAL :DELTAU :HYDA :IBOOT :INDENT :IP :KAPPA :LI :ND :NE0 :NEL :NH :NHE4 :NMAIN0 :NT :PECH :PFLOSS :PFUSION :PHIA :PIBW :PICRH :PLH :PNBI :POHM :PRAD :Q95 :RGEO :TE0 :THNT :TI0 :VLOOP :VSURF :WTH :WTOT :ZEFF Total of 38 nodes.
4. 2D data.

The 2D branche contains 2D signals (with corresponding time and radial dimensions) and dimensional quantities are all built with units. Again standard units were substituted for missing units and all 2D data is stored. IDL> mdstcl,'dir \top.twod:*' \I_D3D::TWOD :BPOL :CHIE :CHII :CURBS :CURECH :CURICRH :CURLH :CURNBI :CURTOT :CURTOTEB :DELTAR :DELTARL :DELTARU :DNER :DWER :DWIR :GRHO1 :GRHO2 :INDENTR :IOTAVAC :KAPPAR :NE :NEEB :NEXP :NEXPEB :NFAST :NFAST1 :NFAST2 :NFAST3 :NHYA :NIMP :NIMPEB :NIMPXP :NIMPXPEB :NM1 :NM1EB :NM1XP :NM1XPEB :NM2 :NM2EB :NM2XP :NM2XPEB :NM3 :NM3EB :NM3XP :NM3XPEB :NM4 :NM4EB :NM4XP :NM4XPEB :NM5 :NM5EB :NM5XP :NM5XPEB :NM6 :NM6EB :NM6XP :NM6XPEB :NM7 :NM7EB :NM7XP :NM7XPEB :NM8 :NM8EB :NM8XP :NM8XPEB :NM9 :NM9EB :NM9XP :NM9XPEB :PRES :Q :QEB :QECHE :QECHI :QEI :QFUSE :QFUSI :QIBWE :QIBWI :QICRHE :QICRHI :QLHE :QLHI :QNBIE :QNBII :QOHM :QRAD :QWALLE :QWALLI :RHONEXP :RHONEXPEB :RHONM1XP :RHONM1XPEB :RHONM2XP :RHONM2XPEB :RHONM3XP :RHONM3XPEB :RHONM4XP :RHONM4XPEB :RHONM5XP :RHONM5XPEB :RHONM6XP :RHONM6XPEB :RHONM7XP :RHONM7XPEB :RHONM8XP :RHONM8XPEB :RHONM9XP :RHONM9XPEB :RHOTEXP :RHOTEXPEB :RHOTIXP :RHOTIXPEB :RHOVROTXP :RHOVRTXPEB :RMAJOR :RMINOR :SBE :SBOI :SBOX :SNBIE :SNBII :SURF :SWALL :TE :TEEB :TEXP :TEXPEB :TI :TIEB :TIXP :TIXPEB :TORQ :UBPAR :UBPRP :VOLUME :VROT :VROTEB :VROTXP :VROTXPEB :ZEFFR :ZEFFREB Total of 143 nodes.
5. 0D data.

These are the 0D variables which are specified in the profile database manual (Dec 2005), but this format can easily be extended to include more variables as required in future. If you would like to add a variable then contact the database managers for more information. Some quantities are numeric, others are text, and there can be >1 time point. Dimensional quantities are all built with units. When a variable in the original file contained missing values at every time point it was not added to the MDSplus tree. When a variable only had missing values at some time points then all the data for this variable is saved. IDL> mdstcl,'dir \top.zerod:*' \I_D3D::ZEROD :AMIN :AREA :AUXHEAT :BEPDIA :BEPMHD :BETMHD :BETNMHD :BGASA :BGASA2 :BGASZ :BGASZ2 :BPFOOT :BSOURCE :BSOURCE2 :BT :COCTR :CONFIG :DATE :DELTA :DELTA95 :DELTAL :DELTAL95 :DELTAU :DELTAU95 :DIPDT :DIVMAT :DNELDT :DNEVDT :DWDIA :DWMHD :DWTOT :ECHFREQ :ECHLOC :ECHMODE :ECHRLOC :ENBI :ENBI1 :ENBI2 :EVAP :FPERP :GRADTE :GRADTI :H89P :IBOOT :IBWFREQ :ICANTEN :ICFREQ :ICSCHEME :IGRADB :INDENT :IP :ISEQ :ITB :ITBTIME :ITBTYPE :KAPPA :KAPPA95 :LHFREQ :LHNPAR :LI :LIMMAT :MEFF :NE0 :NE95 :NEFOOT :NEL :NESHOULD :NEV :NFAST1A :NFAST1Z :NFAST2A :NFAST2Z :NFAST3A :NFAST3Z :NM1A :NM1Z :NM2A :NM2Z :NM3A :NM3Z :NM4A :NM4Z :NM5A :NM5Z :NM6A :NM6Z :NM7A :NM7Z :NM8A :NM8Z :NM9A :NM9Z :PECH :PELLET :PERFDUR :PGASA :PGASZ :PHASE :PIBW :PICRH :PIMPA :PIMPZ :PINJ :PINJ2 :PL :PLH :PLTH :PNBI :POHM :PRAD :PUMP :Q95 :QAXIS :QFOOT :QMIN :RFOOT :RGEO :RICRES :RLHDEP :RMAG :RQMIN :RSHOULD :RSMIN :SELDB :SEPLIM :SFOOT :SHEAR :SHOT :SPLASMA :STATE :TAUDIA :TAUP :TAUTH :TAUTOT :TE0 :TE95 :TEFOOT :TESHOULD :TEV :TI0 :TI95 :TIFOOT :TIME :TISHOULD :TIV :TOK :TRTIME :UPDATE :VOL :VSURF :VTO95 :VTOAXIS :VTOFOOT :WALMAT :WDIA :WFANI :WFICRH :WKIN :WMHD :WTH :WTOT :XPLIM :ZEFF :ZMAG Total of 164 nodes.