himag - hypercomp.net
TRANSCRIPT
HIMAG HyPerComp Incompressible MHD solver for Arbitrary Geometry
Appendix I: Quick Reference Guide
HIMAG 2019 HyPerComp, Inc.
2629 Townsgate Rd, Suite
105
Westlake Village, CA 91361
http://www.hypercomp.net
(T) 805-371-7500
Release 1.0
July 2019
HIMAG – Quick Reference Guide
ii | M A I N I N D E X
QUICK REFERENCE GUIDE
Input file : *.input
If a variable isn't defined in the input data file, it uses the default value.
The code is dimensional, the unit system is SI
Length (m) Velocity (m/s)
Density (kg/m^3) Dynamic Viscosity (kg/m-s)
Pressure (Pa=kg/m-s^2) Current density (A/m^2)
Temperature (k) Therm cond (W/m-k)
B-field strength (Tesla=kg/A-s^2) Elect cond (mho/m=S/m)
Variables
A - aamn
- aamx
- ad12
- ak12
- alpha
- alphu
B - bangl
- bbmn
- bbmx
- bval
- bx0
C - c_rest
- cfl
- cpl
- cpw1
- cpw2
- cpwN
D - delbx
- deltT
- dful
- dpdx
- dratio
- dtfac
- dtime
E - ecratio
- epsln
- epsmin
F
G - gras
- grid_scale
- gx
- gy
- gz
H - hk1
- hkrat
- hkw1
- hkw2
- hkwN
I - ibf
- ibuoy
- ichan
- icoas
- idissp
- iforce
- igmax
- igravt
HIMAG – Quick Reference Guide
iii | M A I N I N D E X
- ihmax
- ilaw
- ilevels
- immax
- invel
- iortho
- ipmax
- iread
- irinit
- irmax
- iskip
- istart
- isym
- iturb
- iuvw
- iwall
J
K
L - lambda
- lambdu
- lpois
M
- mgmax
N - nbcg
- nbf
- ncase
- ngrad
- nheat
- nimp
- nmax
- nmhd
- nmomt
- nodes
- nout
- nppe
- nskp
- ntrit
- nvel
- nwrite
O - omega
- ovrelx
P
Q - qht1
R - rem
- rho1
- rhow1
- rhow2
- rhowN
S - sbkf1
- sbkw1
- sbkw2
- sgam
- sgmf1
- sgmw1
- sgmw2
- sleng
- sratio
- ssig
T - tbet
- tref
- twal
U - ubar
- uin
V - visc1
- vratio
- vsw1
W
X - xcent
- xct2
Y - ycent
- yct2
Z - zcent
- zct2
HIMAG – Quick Reference Guide
iv | M A I N I N D E X
Variable Values Description
aamn Real Inlet section [aamn,aamx] [bbmn,bbmx]
aamx Real Inlet section [aamn,aamx] [bbmn,bbmx]
ad12 Real Fluid diffusion coefficient d1/d2 (for Tritium)
ak12 Real Fluid Solubility ratio k1/k2 (for Tritium)
alpha Real <=1 Pre-conditioning factor for other equations
alphu Real <=1 Pre-conditioning factor for momentum equation For fully-developed flow solver only
bangl Real B-field angle respect to ibf direction
bbmn Real Inlet section [aamn,aamx] [bbmn,bbmx]
bbmx Real Inlet section [aamn,aamx] [bbmn,bbmx]
bval Real B-field strength < 0.0: along opposite axis of ibf
bx0 Real <= xmin: B-field all constant > xmin: B-field ramped from bx0
c_rest Real Coefficient of contact resistance
cfl Real parameter used for variable time-step
cp1 Real Fluid specific heat capacity Cp1
HIMAG – Quick Reference Guide
v | M A I N I N D E X
cpw1 Real Solid specific heat capacity (for imtype=3)
cpw2 Real Solid specific heat capacity (for imtype=4)
cpwN Real Solid specific heat capacity (imtype=5,6,7,8)
delbx Real (-delbx,delbx) is the gap for B to change nbf=20: parameter for B0 disruption with time
deltT Real Temperature difference (for Boussinesq fluid)
dfu1 Real Fluid diffusivity d1 (for Tritium)
dpdx Real 3-D problem:for initial condition (nvel=0,1,11) Fully-developed problem:(nvel=0,1,11 only) Ignored if nvel,|invel|=2,3,4,5,20
dratio Real Fluid density ratio = rho1/rho2
dtime Real > 0.0: constant dt=dtime < 0.0: variable time-step, minimum dt=|dtime|
dtfac Real dtime ratio for B-formulation
ecratio Real Fluid electrical conductivity ratio = sgmf1/sgmf2
epsln Real epsilon= 0.5*Mesh_size (default=0.1)
epsmin Integer Minimum Residual criterion (log)
gras Real Grashof number (input either gras or tbet)
HIMAG – Quick Reference Guide
vi | M A I N I N D E X
grid_scale Real > 0 scale x-y-z coordinates from UX file
gx Real Gravity x-component
gy Real Gravity y-component
gz Real Gravity z-component
hk1 Real Fluid thermal Conductivity k1
hkrat Real Heat conductivity ratio = k1/k2
hkw1 Real Solid thermal Conductivity (for imtype=3)
hkw2 Real Solid thermal Conductivity (for imtype=4)
hkwN Real Solid thermal Conductivity (imtype=5,6,7,8)
ibf Integer B-field direction index = 1-3: Along x-, y-, z-axis (default=2: y-axis)
ibuoy Integer =0: without buoyancy term =1: with buoyancy term
ichan Integer Channel type =0 : Rectangular channel without walls (Shercliff) =1 : Rectangular channel w/ conducting walls (Hunt) =2 : Half rect- channel w/ conducting walls (Hunt) =3 : 2-D channel w/ conducting walls =4 : two material testing =10: Circular duct without walls =11: Circular duct with conducting walls
HIMAG – Quick Reference Guide
vii | M A I N I N D E X
=12: Half circular duct with conducting walls =13: Annulus duct without walls =20: Material regions from mat.bin or .ugb file =21: Material regions from mat.lst (modified) =30: Modified Pb-Li concept (without mat.bin) =40: L-Shaped with conducting walls =50: Demo Case 1 (Mixed convection) =51: 3-D Lid-driven cavity =52: 3-D thin-wall rectangular enclosure =100:Others: User defined case
icoas Integer Number of iter. for coarse grid if MultiGrid
idissp Integer =0: without Viscous dissipation term =1: with Viscous dissipation term
iforce Integer =0: do not calculate force/moment =1: calculate force (Fx,Fy,Fz) on ivel=8 BC =2: calculate force and moment (Mx,My,Mz) on ivel=8 =3: calculate force and 3-D moment on ivel=8
igmax Integer Number of non-orthogonal iteration
igravt Integer =0: without Gravity term =1: with Gravity term
ihmax Integer Number of iterations for Heat equation with CG
ilaw Integer =0: Constant density and viscosity (default) =1: Sutherland's form =2: Arrhenius form =3: Linear inverse variation with temperature
ilevels Integer =0 : Single phase flow =1 : Two-phase flow, level-set equation solved =11: Special case: Broken dam =12: Special case: 2p_2d =13: Special case: jet_3d =14: Special case: Air-Water cooling
HIMAG – Quick Reference Guide
viii | M A I N I N D E X
immax Integer Number of iterations for MHD Poisson
invel Integer Inlet velocity BC option if imtype=0 = 0 : initially at rest (except inflow faces) = 1 : uniform (=ubar, default) = 2 : parabolic profile (cylindrical symmetry) = 20: 2-D parabolic profile = 3 : duct flow profile = 4 : Shercliff's flow profile = 5 : Hunt's flow profile = 10: User defined = 11: invel: inflow uniform along normal = 23: Use fully developed solution for 3-D nvel=-1: add perturbation to current solution invel<0: to calculate dpdx
iortho Integer =1: for orthogonal grid, without correction =2: Non-orthogonal correction
ipmax Integer Number of iterations for Pressure Poisson (PPE)
iread Integer Start/Restart 0: Fresh start 1: restart from qrestart.*.unf 2: restart from qrestart2.*.unf 9: restart from Tecplot file interpolation 1x: the same as x but with old qrestart* 20: restart for multi-grid -- coarse grid 21/22: restart for multi-grid -- fine grid
irinit Integer Skip steps to run reinitialization
irmax Integer Number of iterations for level-set reinitialization
iskip Integer >0 skip steps to output solution, default to nmax+1
istart Integer >=0 First step to output solution, default to iskip
HIMAG – Quick Reference Guide
ix | M A I N I N D E X
isym Integer Domain symmetric index = 0 : No symmetric (default) = 1-3: Symmetric along x-, y-, z-axis = 10 : Special use: wall U><0 for ichan=51 = 11 : Special use: center point (u,v,w) = 12 : Special use: kinetic energy (KU,Kb)
iturb Integer =0: No turbulence model =1: One-equation turbulence model =2: Two-equations (k-e model)
iuvw Integer Option for inflow/outflow direction = 1-3: Both inflow/outflow along x-, y-, z-axis
axis =11-13: Outflow along x-, inflow along x-,y-,z-
Axis =21-23: Outflow along y-, inflow along x-,y-,z-
Axis =31-33: Outflow along z-, inflow along x-,y-,z-
iwall Integer =0 : No wall function (unless defined by prep) =1 : Hartmann layer wall function only =10: wall function for insulating walls =11: wall function for insulating Hartmann walls =20: wall function for perfectly conducting
lambdu Real =1.0: No upwinding (default)
lambda <1.0: Upwing scheme parameter lambdu for Momentum, lambda for others
lpois Integer Poisson CG solver option =0: itmax=ipmax (default for nn<=3) =1: itmax=max(2*ipmax,200) if nn<=20 (default) =2: itmax=max(2*ipmax,5000) for nn=1 =3: itmax=5000 if resid>-2.0
HIMAG – Quick Reference Guide
x | M A I N I N D E X
matpf Integer
mgmax Integer Number of MultiGrid iteration cycle (default 0)
nbcg Integer >=1: Heat equation with BiCG every nbcg steps <0 : Heat equation with BiCG at n=-nbcg
nbf Integer B-field function index =-1: Constant B-field = 0: Exponent function (default) = 1: Linear function = 2: Two-sides Exponent function = 3: tanh-function for Alex = 4: tanh-function for BOB > 1x: Same function as 0 ~ 4 but decreasing = 20: plasma disruption (B0 reduced with time)
ncase Integer>=-1 =-1 : default, general purpose = 0~8: special cases for ppe or mhd benchmark >= 10: special cases for heat benchmark
ngrad Integer Best choice: ngrad=5 or 2 =1 : grad(phi) from subr. gradient =2 : grad(phi) from face values averaged (default) =3 : grad(phi) from face values & non-orth averaged =4 : grad(phi) by least-sqaure scheme =5,6: grad(phi) by conservative scheme
nheat Integer =0: Heat equation not solved =1: Heat equation: with Crank-Nicholson if mod(n,nbcg)><1 and n><-nbcg =2: Heat equation: with BiCG, w/o time & adv terms =6: Heat equation: with BiCG, w/o time term
nimp Integer =1: Crank-Nicholson for Heat equation (default) =2: Fully implicit scheme
HIMAG – Quick Reference Guide
xi | M A I N I N D E X
nmax Integer Maximum number of steps to run = 0: write initial values for check and stop < 0: iread = 0: write material region data only iread > 0: reset nstart and nmax=|nmax| re-calculate material properties
nmhd =0 :Not solve MHD Poisson equation =1 :Solve MHD equation with CG =2 :Solve MHD equation with relaxation solver =3 :Solve 2-D MHD with d/dz=0, with source term =4 :Solve MHD B-formulation equation explicitly =5 :Solve MHD equation with K-saved CG =10:Solve MHD B-formulation equation implicitly =11:Solve MHD induced magnetic b-field explicitly
nmomt Integer =0 : Momentum equation not solved =1 : Momentum equation solved >=10: Simple scheme, no Fractional-Step
nodes Integer >0 Number of CPUs
nout Integer = 0: default (no other output) = 1: output BC/internal face values (bcfac.NNN.dat) = 2: output cell center values (qcent.NNN.dat) = 3: output both BC face & cell center values = 5: energy conservation check (energy.dat) =10: output debug data (debug.NNN.dat) =11: append debug data (debug.NNN.dat) =20: output user-defined face/cell center values (debug_u.NNN.dat)
nppe Integer =0: Not solve Pressure Poisson equation =1: Solve Pressure Poisson eq with CG =2: Solve Pressure Poisson eq w/ relaxation solver =3: Solve Pressure Poisson eq with K-saved CG (iprs=2: also update qface(4) at multk) =5: Solve Pressure Poisson eq with K-saved CG
HIMAG – Quick Reference Guide
xii | M A I N I N D E X
nskp Integer skip steps for output residuals, etc.
ntrit Integer =0: Tritium transport not solved =1: Tritium transport solved
nvel Integer Initial velocity option if imtype=0
nwrite Integer skip steps to write restart files = 0: write qrestart.*.unf at n=nmax = -1: for nvel=23 only (reset to |nmax|) write fully developed solution for restart <=-2 : write extra data for future use > nmax : no restart files written <= nmax: write qrestart*.*.unf every nwrite step
omega Real >=1 Acceleration factor (default=1.00)
ovrelx Real relaxation factor for Relaxation solver For PPE/MHD:= 1.92 for serial = 1.0 for parallel/multi-grid For SIMPLE: any given
qht1 Real Fluid heat source Q (for tritium & heat equations)
rem Real Magnetic Reynolds number for B-formulation
rho1 Real Solid viscosity (Wall 2) (default=vsw1)
rhow1 Real Fluid density (phi>0 for level-set)
rhow2 Real Solid density (Wall 2) (default=rhow1)
rhowN Real Solid density (N=3,4,5,6 == imtype=5,6,7,8)
sbkf1 Real Fluid seebeck coeff
HIMAG – Quick Reference Guide
xiii | M A I N I N D E X
sbkw1 Real Solid seebeck coeff (for imtype=3)
sbkw2 Real Solid seebeck coeff (for imtype=4)
sgam Real Extra surface tension term coef.
sgmf1 Real Fluid electrical conductivity sigma1
sgmw1 Real Solid electrical conductivity (for imtype=3)
sgmw2 Real Solid electrical conductivity (for imtype=4)
sleng Real Reference length (default=grid_scale)
sratio Real Fluid seebeck ratio = sbkf1/sbkf2
ssig Real Surface tension coefficient (for level-set)
tbet Real Boussinesq volumetric expansion coef
tref Real Reference temperature (initial temperature)
twal Real > 0 Conducting wall thickness (for Cw and ymax, ymin)
ubar Real mean inflow velocity > 0.0: along axis (default=1.0) < 0.0: opposite to axis
uin Real Another mean inflow velocity value
visc1 Real Fluid dynamic viscosity v1 (kg/m-s-myu=rho*nyu)
vratio Real Fluid viscosity ratio = v1/v2
HIMAG – Quick Reference Guide
xiv | M A I N I N D E X
vsw1 Real Solid viscosity (Wall 1) (default=1.e10*v1)
xcent Real Torque center x-coordinate
xct2 Real Torque axis x2 (iforce=3)
ycent Real Torque center y-coordinate
yct2 Real Torque axis y2 (iforce=3)
zcent Real Torque center z-coordinate
zct2 Real Torque axis z2 (iforce=3)