SYNTAX OPTIONS:
[data_vals,time_vals,ier,units] = getmdata(shotnum, ptname, treename, connOrTokamak, getxdata)
PURPOSE: Get mdsplus or ptdata data with reusable connections through mdsPlus library.
INPUT:
shotnum = shot number
ptname = name of data - must be in single quotes
treename = which tree to use for mdsplus data, or 'ptdata' (optional)
Default Options depend on the server:
Server: Default treename:
'D3D' -> 'ptdata'
'JET' -> 'PPF'
'NSTX' -> 'wf'
'KSTAR' -> 'pcs_kstar'
'EAST' -> 'pcs_east'
'EAST@GA' -> 'pcs_east'
connOrTokamak = tokamak name, server, or reusable mdsplus library connection object.
(optional, default = 'd3d')
-mdsplus library objects can be made with getmdsconn
-Server address can be input as a string
-Tokamak name will lookup default server addresses:
Options: (default = 'd3d')
'D3D' -> 'atlas.gat.com'
'JET' -> 'mdsplus.jet.efda.org'
'NSTX' -> 'birch.pppl.gov:8501'
'KSTAR' -> '203.230.126.212:8005'
'EAST' -> '202.127.204.12:8000'
'EAST@GA' -> 'eastdata.gat.com'
OUTPUT:
data_vals = Data for ptname defined by input (complete data record)
time_vals = Time values
ier = error code = 0 if OK, else > 0
units = Units string for ptname if defined in the MDSplus DB.
EXAMPLES
getmdata(176991, 'ip', 'ptdata', 'd3d')
getmdata(57035, 'MAGN/IPLA', 'PPF', 'jet')
getmdata(57035,'MAGN/IPLA','PPF','JET')
getmdata(109070,'ip','wf','NSTX')
getmdata(999991,'PCIP','PCS_KSTAR','kstar')
getmdata(73502,'pcrl01','pcs_east','east')
getmdata(73502,'pcrl01','pcs_east','east')
EXAMPLE re-using MDSplus connection:
[connObj, ier] = getmdsconn('d3d');
[ data_vals, time_vals, ier, units ] = getmdata(176991, 'ip', 'ptdata', connObj)
[ data_vals, time_vals, ier, units ] = getmdata(176991, 'ipmeas', 'efit01', connObj)
[ data_vals, time_vals, ier, units ] = getmdata(176991, 'li', 'efitrt1', connObj)
or:
[ data_vals, time_vals, ier, units, connObj ] = getmdata(176991, 'ip', 'ptdata', 'd3d')
[ data_vals, time_vals, ier, units ] = getmdata(176991, 'ipmeas', 'efit01', connObj)
[ data_vals, time_vals, ier, units ] = getmdata(176991, 'li', 'efitrt1', connObj)
RESTRICTIONS:
(1) Only works for 1-D and 2-D data right now
WRITTEN BY: Jayson Barr ON 8/16/18