SYNTAX OPTIONS:
[data,tvec,ier] = getmds(shot,name,range_min,range_max,tree,server,ical)
[data,xvec,tvec,ier] = getmds(shot,name,range_min,range_max,tree,server,ical)
PURPOSE: Get mdsplus data from the MDS database.
INPUT:
shot = shot number
name = name of data - must be in single quotes
range_min = minimum value of independent variable(s) - use NaN to specify no limit:
if scalar, this is min time (s)
if vector, last entry is min time (s), other entries are minima
for other independent variables
range_max = maximum value of independent variable(s) - use NaN to specify no limit:
if scalar, this is max time (s)
if vector, last entry is max time (s), other entries are maxima
for other independent variables
tree = which tree to use (optional, default = 'EFIT01')
server = which server to use (optional). Options: 'DIII-D'(default),
'JET', 'NSTX', 'THOR'
ical = return data in units of digitizer counts (ical=0), volts into
digitizer (ical=2), or physics units (ical=1). Only used for
data from 'THOR', 'data-server3' (EAST), and 'pcs_kstar' (KSTAR)
OUTPUT:
data = data for name defined by input (dimensions correspond to dimensions
specified in range_min)
(xvec..tvec) = variable number of arguments containing vectors of independent
variables specified in range_min and range_max
ier = error code = 0 if OK, else > 0
EXAMPLES
getmds(106649,'rmaxis',1.5,5,'EFIT01','DIII-D')
getmds(57035,'MAGN/IPLA',1.0,3.0,'PPF','JET')
getmds(109070,'ip',1.0,3.0,'wf','NSTX')
getmds(999991,'PCIP',0.0,8.0,'PCS_KSTAR','THOR');
NEED 3D examples
RESTRICTIONS:
(1) Only works for range_min/max up to length 2 at the moment (make a request for more).
(2) Use the lower level routines starting with "mds" to manipulate the MDS
data directly.