Skip to content

rzrig.m

Basic Information

  USAGE:  function [model_data,cc0,vc0,dbg_objs]=rzrig( ...
        equil_data,tokamak,vac_objs,idoplots,idoncal,idxvv,iwait)

  PURPOSE: Script to calculate vertical and radial response using rigid
           current-conserving model of plasma for GENERAL systems.
        Takes basic data from EFIT g-file or external data
        input (cc, jphi; eg from Corsica) and needs environment objects of
        same names as D3D environment. cc and jphi are ASSUMED to be in
        MA when read from gfile or defined externally.

  INPUTS:
    equil_data = structure containing equilibrium information
    tokamak = device to construct model objects for (e.g. 'NSTX','KSTAR',etc)
    vac_objs = structure containing:
        mcc, mvv, mcv, mpc, mpv, resc, resv, zg, rg, ecdata
            (Note that imks and iterminal in this structure define the
         units of the data objects to be produced. imks=1 gives MKS
         units, otherwise units are MA,uH,uOhms.  iterminal=1 gives
         terminal mode, 0 gives lumped.)
    idoplots= (optional) flag to select plotting: 1=plot, 0=don't(default)
    idoncal = (optional) flag to select calc of decay index: 1=calc,
            0=don't(default)
    idxvv = (optional) indices of VV elements to use in force calculation
            (default=1:nvv)
    iwait = (optional) 1(default)=wait with error messages, 0=no wait
    iverbose = (optional) Flag to display messages, default is 0

  OUTPUTS:
    model_data = quantities describing vertical/radial force balance&couplings
                       - data objects
                       - units = units of data objects
                       - desc  = descriptions of data objects
    cc0 = equilibrium coil currents (size matching objects in vac_objs, with
       units as specified by imks and iterminal in vac_objs)
    vc0 = equilibrium vessel currents (size matching objects in vac_objs, with
          units as specified by imks and iterminal in vac_objs)

  Also displays max positive eigenvalue for various conductor modifications.

  RESTRICTIONS:
     Plasma current density must be zero within 1 grid of upper & lower walls
       (for 2-sided calculations of gradients).
     Circuits defaulted to be lumped (one-turn) elements (see ccnturn def
    below). If magnetic mapping objects (mcc, mpc, etc...) are in
    terminal mode (iterminal==1), ccnturn must correspond to turns in them.
     cc coming from read_gfile (or wherever) assumed to be lumped mode.

  METHOD:
     Described in Walker/Humphreys, Valid Coordinate Systems for Linearized
     Plasma Shape Response Models in Tokamaks, FS&T,Nov.06; GA report GA-A25042

Dependencies