Skip to content

get_mds_tree.m

Basic Information

  SYNTAX:
         data= get_mds_tree(shot, tree, server, toupper,verbose);  full call
         data= get_mds_tree(shot);                         defaults to DIII-D
         data= get_mds_tree(shot, 'EFIT01', 'NSTX');       for NSTX
         data= get_mds_tree(shot, 'NB', 'DIII-D');         example other tree

  PURPOSE: Get entire selected mds tree from mdsplus database.

  INPUT: <default>
    shot    = shot number
    tree    = tree to use <'EFIT01'>
    server  = MDS+ database to use: 'DIII-D'(default),'NSTX','EAST',
        'THOR', 'OPEN'(assumes mdsconnect already called).  Other
        inputs invoke mdsconnect(server) to connect to server.
    toupper = 1= all variables made upper case, =-1 all var. made lower case
              [0]= no change, variables made depending on mds case (typical UC)
    verbose = set to 1 to get diagnostic prints during execution
              <1> server= 'NSTX' or 'EAST'; (since can take some time to get)
              <0> server= 'DIII-D' & all others;

  OUTPUT:
    data  = structure containing all data in MDS+ tree, with same tree
         structure except that 'TOP' replaced by 'tree'
            See: data.allnames for list of all variables in full structure
    Some Extra items added to structure (all lower case)
      data.id    =   sting array of important data identifyer enf
      data.shot  =   shot number
      data.server=   MDS+ server
      data.allnames= list of variables in structure with path relative to "TOP"
      data.mdsnames= list of variables in structure with full mds path
    ier = error code

  WRITTEN BY:  Jim Leuer    ON      3/1/05 (original name get_mds_tree)
  taken from get_mds_tree.m uses sub-structure to store

  USES:   eq_mod
  To see MDS structure on HYDRA run traverser
  tested on DIII-D and NSTX data and should work for JET data but not tested

  CHANGE LOG:  SMF 20140923 - Changed getnci call to use nid_numbers due to
                              fullpath not accepting wildcards.

 ==========================================================================

Dependencies