Skip to content

getmds.m

Basic Information

  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.