programmer's documentation
Variables, properties and fields (deprecated propce)
Remarks
Note that indexes in C begin at 0, while indexes in Fortran begin at 1. Thus, Fortran and C loop counters are related in the following as:
cell_id = iel-1.

Cross-reference tables are available for the variables and properties of the standard solver and the specific physics features:

Variables

The Fortran variables indexes are defined in the files numvar.f90 (with the exception of ihm and iscal, which are respectively defined in ppincl.f90 and optcal.f90) and the C variables names are defined in cs_field_pointer.h.
Note that dt is just an allocatable array in Fortran while it is mapped as a field in C.

V3.0 and older Fortran code Current Fortran code C code Description
rtp(iel,ipr) call field_get_val_s(ivarfl(ipr), cvar_pr) CS_F_(p)->val[cell_id] Pressure
(WARNING: removed)
rtp(iel,iu)
rtp(iel,iv)
rtp(iel,iw)
call field_get_val_v(ivarfl(iu), cvar_vel)
cvar_vel(1, iel)
cvar_vel(2, iel)
cvar_vel(3, iel)

CS_F_(u)->val[cell_id][0]
CS_F_(u)->val[cell_id][1]
CS_F_(u)->val[cell_id][2]
Velocity
rtp(iel,ivoidf) call field_get_val_s(ivarfl(ivoidf), cvar_voidf) CS_F_(void_f)->val[cell_id] Void fraction for cavitation modelling
rtp(iel,ik) call field_get_val_s(ivarfl(ik ), cvar_k ) CS_F_(k)->val[cell_id] Turbulent kinetic energy $ k $
rtp(iel,iep) call field_get_val_s(ivarfl(iep ), cvar_eps) CS_F_(eps)->val[cell_id] Turbulent dissipation $ \varepsilon $
rtp(iel,ir11) call field_get_val_s(ivarfl(ir11), cvar_r11) CS_F_(r11)->val[cell_id] Reynolds stress component $ R_{xx} $
rtp(iel,ir22) call field_get_val_s(ivarfl(ir22), cvar_r22) CS_F_(r22)->val[cell_id] Reynolds stress component $ R_{yy} $
rtp(iel,ir33) call field_get_val_s(ivarfl(ir33), cvar_r33) CS_F_(r33)->val[cell_id] Reynolds stress component $ R_{zz} $
rtp(iel,ir12) call field_get_val_s(ivarfl(ir12), cvar_r12) CS_F_(r12)->val[cell_id] Reynolds stress component $ R_{xy} $
rtp(iel,ir23) call field_get_val_s(ivarfl(ir23), cvar_r23) CS_F_(r23)->val[cell_id] Reynolds stress component $ R_{yz} $
rtp(iel,ir13) call field_get_val_s(ivarfl(ir13), cvar_r13) CS_F_(r13)->val[cell_id] Reynolds stress component $ R_{xz} $
rtp(iel,iphi) call field_get_val_s(ivarfl(iphi), cvar_phi) CS_F_(phi)->val[cell_id] $ \phi $ for $ \phi-f_b $ model
rtp(iel,ifb) call field_get_val_s(ivarfl(ifb ), cvar_fb ) CS_F_(f_bar)->val[cell_id] $ f_b $ for $ \phi-f_b $ model
rtp(iel,ial) call field_get_val_s(ivarfl(ial ), cvar_al ) CS_F_(alpha)->val[cell_id] $ \alpha $ for $ Bl-v^2-k $
or EBRSM model
rtp(iel,iomg) call field_get_val_s(ivarfl(iomg), cvar_omg) CS_F_(omg)->val[cell_id] $ \omega $ for $ k-\omega $ SST model
rtp(iel,inusa) call field_get_val_s(ivarfl(inusa), cvar_nusa) CS_F_(nusa)->val[cell_id] $ \widetilde{\nu}_T $ for Spalart-Allmaras
rtp(iel,iuma)
rtp(iel,ivma)
rtp(iel,iwma)
call field_get_val_v(ivarfl(iuma), cvar_mesh_v) CS_F_(mesh_u)->val[3*cell_id]
CS_F_(mesh_u)->val[3*cell_id+1]
CS_F_(mesh_u)->val[3*cell_id+2]
Mesh velocity
rtp(iel,ihm) call field_get_val_s(ivarfl(isca(ihm)), cvar_hm) CS_F_(h)->val[cell_id] Enthalpy
rtp(iel,isca(iscalt)) call field_get_val_s(ivarfl(isca(iscalt)), cvar_scalt) CS_F_(t)->val[cell_id] Temperature

Properties

These properties are defined in the files numvar.f90 and cs_field_pointer.h.

Deprecated Fortran code Current Fortran code C code Description
dt dt CS_F_(dt)->val[cell_id] Local time step
propce(iel,irom) call field_get_val_s(iprpfl(irom), cpro_rho ) CS_F_(rho)->val[cell_id] Density at the current time step
propce(iel,irom) call field_get_val_s(iprpfl(iroma), cpro_rhoa ) CS_F_(rho)->val_pre[cell_id] Density at the previous time step
propce(iel,iromaa) call field_get_val_s(iprpfl(iromaa), cpro_rhoaa) cs_field_by_name("density_old") Density at the second previous time
propce(iel,iviscl) call field_get_val_s(iprpfl(iviscl), cpro_viscl) CS_F_(mu)->val[cell_id] Molecular viscosity
propce(iel,ivisct) call field_get_val_s(iprpfl(ivisct), cpro_visct) CS_F_(mu_t)->val[cell_id] Turbulent dynamic viscosity
propce(iel,ivisla) call field_get_val_s(iprpfl(ivisla), cpro_romaa) CS_F_(mu)->val_pre[cell_id] Dynamic molecular viscosity (in kg/(m.s))
at the previous time-step
propce(iel,ivista) call field_get_val_s(iprpfl(ivista), cpro_viscta) CS_F_(mu_t)->val_pre[cell_id] Dynamic turbulent viscosity
at the previous time-step
propce(iel,icp) call field_get_val_s(iprpfl(icp), cpro_cp) CS_F_(cp)->val[cell_id] Specific heat
propce(iel,icpa) call field_get_val_s(iprpfl(icpa), cpro_cpa) CS_F_(cp)->val_pre[cell_id] specific heat at the previous time-step
propce(iel,icrom) call field_get_val_s(iprpfl(icrom), cpro_crom) CS_F_(rho)->val[cell_id] Density (at cells)
propce(iel,ibrom) call field_get_val_s(iprpfl(ibrom), bpro_rho) CS_F_(rho_b)->val[cell_id] Density (at boundary faces)
propce(iel,ismago) call field_get_val_s(iprpfl(ismago), cpro_smago) cs_field_by_name("smagorinsky_constant^2") Field id of the anisotropic turbulent viscosity
propce(iel,icour) call field_get_val_s(iprpfl(icour), cpro_cour) cs_field_by_name("courant_number") Courant number
propce(iel,ifour) call field_get_val_s(iprpfl(ifour), cpro_four) cs_field_by_name("fourier_number") Fourier number
propce(iel,iprtot) call field_get_val_s(iprpfl(iprtot), cpro_prtot) cs_field_by_name("total_pressure") Total pressure at cell centers
propce(iel,ivisma(1))
propce(iel,ivisma(2))
propce(iel,ivisma(3))
call field_get_val_s(iprpfl(ivisma(1)), cpro_vism1)
call field_get_val_s(iprpfl(ivisma(2)), cpro_vism2)
call field_get_val_s(iprpfl(ivisma(3)), cpro_vism3)
cs_field_by_name("mesh_viscosity_1")
cs_field_by_name("mesh_viscosity_2")
cs_field_by_name("mesh_viscosity_3")
Mesh velocity viscosity for the ALE module
propce(iel,itsrho) call field_get_val_s(iprpfl(itsrho), cpro_tsrho ) cs_field_by_name("dila_st") Global dilatation source terms
propce(iel,ibeta) call field_get_val_s(iprpfl(ibeta), cpro_beta ) cs_field_by_name("thermal_expansion") Thermal expansion coefficient
- call field_get_val_s(ipori, cpro_ipori) CS_F_(poro)->val[cell_id] Porosity
- call field_get_val_v(iporf, cpro_iporf) CS_F_(t_poro)->val[cell_id][ii] Tensorial porosity
- call field_get_val_v(iforbr, bpro_forbr) cs_field_by_name("boundary_forces") Field id of the stresses at boundary
- call field_get_val_s(iyplbr, bpro_yplus) cs_field_by_name("yplus") Field id of $y^+$ at boundary
- call field_get_val_v(idtten, dttens) cs_field_by_name("dttens") Field id for the dttens tensor
- call field_get_val_s(itempb, t_b) CS_F_(t_b)->val[b_face_id] Boundary temperature

Specific physics

Atmospheric

Defined in optcal.f90, atincl.f90, atvarp.f90 and cs_field_pointer.h.

Fortran code C code Description
call field_get_val_s(ivarfl(isca(iscalt)), cvar_scalt) CS_F_(pot_t)->val[cell_id] Potential temperature
call field_get_val_s(ivarfl(isca(itotwt)), cvar_totwt) CS_F_(totwt)->val[cell_id] Total water content
call field_get_val_s(ivarfl(isca(intdrp)), cvar_intdrp) CS_F_(ntdrp)->val[cell_id] Total number of droplets
call field_get_val_s(ivarfl(isca(isca_chem(iesp))), cvar_sc) CS_FI_(chemistry,iesp-1)->val[cell_id] Chemistry species (indexed)

Coal combustion

Defined in ppincl.f90, ppcpfu.f90 and cs_field_pointer.h.

Fortran code C code Description
call field_get_val_s(isca(inp(iesp)), cvar_inpcl) CS_FI_(np,iesp-1)->val[cell_id] Particles per kg for coal class
call field_get_val_s(isca(ixch(iesp)), cvar_xchcl) CS_FI_(xch,iesp-1)->val[cell_id] Reactive coal mass fraction for coal class
call field_get_val_s(isca(ixck(iesp)), cvar_xckcl) CS_FI_(xck,iesp-1)->val[cell_id] Coke mass fraction for coal class
call field_get_val_s(isca(ixwt(iesp)), cvar_xwtcl) CS_FI_(xwt,iesp-1)->val[cell_id] Water mass fraction for coal class
call field_get_val_s(isca(ih2(iesp)), cvar_h2cl) CS_FI_(h2,iesp-1)->val[cell_id] Mass enthalpy for coal class (permeatic case)
call field_get_val_s(isca(if1m(iesp)), cvar_f1mcl) CS_FI_(f1m,iesp-1)->val[cell_id] Mean value light volatiles for coal class
call field_get_val_s(isca(if2m(iesp)), cvar_f2mcl) CS_FI_(f2m,iesp-1)->val[cell_id] Mean value heavy volatiles for coal class
call field_get_val_s(isca(if4m), cvar_f4m) CS_F_(f4m)->val[cell_id] Oxydant 2 mass fraction
call field_get_val_s(isca(if5m), cvar_f5m)) CS_F_(f5m)->val[cell_id] Oxydant 3 mass fraction
call field_get_val_s(isca(if6m), cvar_f6m)) CS_F_(f6m)->val[cell_id] Water from coal drying mass fraction
call field_get_val_s(isca(if7m), cvar_f7m)) CS_F_(f7m)->val[cell_id] Carbon from coal oxidyzed by O2 mass fraction
call field_get_val_s(isca(if8m), cvar_f8m)) CS_F_(f8m)->val[cell_id] Carbon from coal gasified by CO2 mass fraction
call field_get_val_s(isca(if9m), cvar_f9m)) CS_F_(f9m)->val[cell_id] Carbon from coal gasified by H2O mass fraction
call field_get_val_s(isca(ifvp2m), cvar_fvp2m) CS_F_(fvp2m)->val[cell_id] f1f2 variance
call field_get_val_s(isca(iyco2), cvar_yco2) CS_F_(yco2)->val[cell_id] CO2 fraction
call field_get_val_s(isca(iyhcn), cvar_yhnc) CS_F_(yhcn)->val[cell_id] HCN fraction
call field_get_val_s(isca(iyno), cvar, yno) CS_F_(yno)->val[cell_id] NO fraction
call field_get_val_s(isca(iynh3), cvar_ynh3) CS_F_(ynh3)->val[cell_id] NH3 enthalpy
call field_get_val_s(isca(ihox), cvar_hox) CS_F_(hox)->val[cell_id] Ox enthalpy

Compressible

Defined in ppincl.f90 and cs_field_pointer.h.

Fortran code C code Description
call field_get_val_s(isca(ienerg), cvar_energ) CS_F_(energy)->val[cell_id] Total energy
call field_get_val_s(isca(itempk), cvar_tempk) CS_F_(t_kelvin)->val[cell_id] Temperature, in Kelvin

Electric arcs

Defined in ppincl.f90 and cs_field_pointer.h.

Fortran code C code Description
call field_get_val_s(isca(ipotr), cvar_potr) CS_F_(potr)->val[cell_id] Electric potential, real part
call field_get_val_s(isca(ipoti), cvar_poti) CS_F_(poti)->val[cell_id] Electric potential, imaginary part
call field_get_val_s(isca(ipotva(1)), cvar_potva1)
call field_get_val_s(isca(ipotva(2)), cvar_potva2)
call field_get_val_s(isca(ipotva(3)), cvar_potva3)
CS_F_(potva)->val[cell_id][0]
CS_F_(potva)->val[cell_id][1]
CS_F_(potva)->val[cell_id][2]
Vector potential
call field_get_val_s(isca(iycoel(iesp)), cvar_ycoel(iesp)) CS_FI_(ycoel,iesp-1)->val[cell_id] Constituent mass fraction

Gas combustion

Defined in ppincl.f90 and cs_field_pointer.h.

Fortran code C code Description
call field_get_val_s(isca(ppincl::ifm), cvar_fm) CS_F_(fm)->val[cell_id] Mixture fraction
call field_get_val_s(isca(ifp2m), cvar_fp2m) CS_F_(fp2m)->val[cell_id] Mixture fraction variance
call field_get_val_s(isca(ifsm), cvar_fsm) CS_F_(fsm)->val[cell_id] Soot mass fraction
call field_get_val_s(isca(inpm), cvar_npm) CS_F_(npm)->val[cell_id] Soot precursor number
call field_get_val_s(isca(iygfm), cvar_ygfm) CS_F_(ygfm)->val[cell_id] Fresh gas fraction
call field_get_val_s(isca(iyfm), cvar_yfm) CS_F_(yfm)->val[cell_id] Mass fraction
call field_get_val_s(isca(iyfp2m), cvar_yfp2m) CS_F_(yfp2m)->val[cell_id] Mass fraction variance
call field_get_val_s(isca(icoyfp), cvar_coyfp) CS_F_(coyfp)->val[cell_id] Mass fraction covariance

Radiative transfer

Defined in radiat.f90 and cs_field_pointer.h.

Fortran code C code Description
propce(iel,ilumin) CS_F_(rad_lumin)->val[cell_id] Radiative luminance
propce(iel,iqx)
propce(iel,iqy)
propce(iel,iqz)
CS_F_(rad_q)->val[cell_id][0]
CS_F_(rad_q)->val[cell_id][1]
CS_F_(rad_q)->val[cell_id][2]
Radiative flux
propce(iel,itsre(iesp)) CS_FI_(rad_ets,iesp-1)->val[cell_id] Radiative flux explicit source term
propce(iel,itsri(iesp)) CS_FI_(rad_its,iesp-1)->val[cell_id] Radiative flux implicit source term
propce(iel,iabso(iesp)) CS_FI_(rad_abs,iesp-1)->val[cell_id] Radiative absorption
propce(iel,iemi(iesp)) CS_FI_(rad_emi,iesp-1)->val[cell_id] Radiative emission
propce(iel,icak(iesp)) CS_FI_(rad_cak,iesp-1)->val[cell_id] Radiative absorption coefficient
call field_get_val_s(iqinci, bqinci)
bqinci(iel)
CS_F_(qinci)->val[cell_id] Radiative incident radiative flux density
call field_get_val_s(ixlam, bxlam)
bxlam(iel)
CS_F_(xlam)->val[cell_id] Wall thermal conductivity
call field_get_val_s(iepa, bepa)
bepa(iel)
CS_F_(epa)->val[cell_id] Wall thickness
call field_get_val_s(ieps, beps)
beps(iel)
CS_F_(emissivity)->val[cell_id] Wall emissivity
call field_get_val_s(ifnet, bfnet)
bfnet(iel)
CS_F_(fnet)->val[cell_id] Boundary radiative flux
call field_get_val_s(ifconv, bfconv)
bfconv(iel)
CS_F_(fconv)->val[cell_id] Boundary radiative convective flux
call field_get_val_s(ihconv, bhconv)
bhconv(iel)
CS_F_(hconv)->val[cell_id] Radiative exchange coefficient