MDSplus Tree Structure for Profile Database.
All of the ASCII have been converted into MDSplus trees. There is one tree per
discharge in the usual manner. The tree structure is described below along with
the IDL MDSplus commands required for interrogate the tree structure. The EQUIL branch
of the MDSplus tree has NO ASCII representation, and is only available in MDSplus.
- 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> 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'
- 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.*'
COMMENTS EQUIL ONED TWOD ZEROD
Total of 5 nodes.
- Main Branches
- 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:*'
: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.
- 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:*'
:FFPRIMPSI :FPOLPSI :PPRIMEPSI :PRESPSI :PSIBDRY
:PSIMAG :PSIRZ :QPSI :RBDRY :RCONTR
:RMAXIS :RXPT :ZBDRY :ZCONTR :ZMAXIS
Total of 16 nodes.
- 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:*'
: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.
- 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
IDL> mdstcl,'dir \top.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.
- 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:*'
: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.