Skip to content

getmdata.m

Basic Information

  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

Dependencies