Layer Variable Descriptions

The definitions of quantities output by Cupid by layer often depend on layer number. The layer variable EAIR, for example (code 5,5,8), gives the air vapor pressure in layers above the soil surface, and soil water potential in layers below the soil surface. Below is a summary of layer variable definition as a function of layer regime.

There are 4 major layer regimes in Cupid:

  1. Above the canopy (JZ = 1 -> NLABCY)
  2. Within the canopy (JZ = NLABCY+1 -> JZCPY)
  3. Below the canopy (JZ = JZCPY+1 -> JZSFC)
  4. Below the soil surface (JZ = JZSFC+1 -> JZBOT)

JZ=1 is the upper boundary in the model, above the canopy. JZ=JZBOT, the lowest layer in the soil, is the lower boundary.

Below are tables of variable names output at each layer for each layer variable code. Following the tables are definitions for each of these variables.



CUPID LAYER VARIABLES:


504    		height  zdh     contot  etotw   vpd     qcond   tlfav   econd   pslay 
=====================================================================================
jz=1,nlabcy 	z				vpd	qcond		econd
nlabcy+1,jzcpy	z	zdh	contot	etotw	vpd	qcond	tlfave	econd	pslay
jzcpy1,jzsfc	z				vpd	qcond		econd
jzsfc1,jzbot	z					qcond		watcon


505    		rndiv   pint    tran    evapg   heatg   tair    u       eair    rh
======================================================================================
1,nlabcy				et	q	tn	uprof	en	relout
nlabcy+1,jzcpy	rndiv	pint	trout	evapg	heatg	tair	uprof	en	relout
jzcpy1,jzsfc						tn	uprof	en	relout
jzsfc1,jzbot	z	proot	rupout			tn	wstor	pnbar	wt100

      proot=froot(jz)*100.
      rupout=rootup(jz)*dt
      wstor(jz)=wnl(ihr,jz-1)*(z(jz)-z(jz-1))*1000./2.+
     &            wnu(ihr,jz)*(z(jz+1)-z(jz))*1000./2.
      pnbar=pn(ihr,jz)/100. 
      wt100=wt(ihr,jz)*100.   
      
506    		zmid    akcpso  cpcpso  akh     cp      rsave   rhleaf  akw     cw  
======================================================================================
1,nlabcy        zmid	ak1	cp1	ak2	cp
nlabcy+1,jzcpy	zmid	ak1	cp1	ak2	cp	rsaout	rhleaf
jzcpy1,jzsfc-1	zmid	ak1	cp1	ak2	cp
jzsfc		zmid	ak1	cp1	ak2	cp			akwsfc
jzsfc1,jzbot	zmid	aksoil	cpout	akh	cp			akout	cwout

      ak1=akcpy(jz)/1.200
      ak2=akh(jz)/1200.
      rsaout = rsave(jout)      
      akwsfc=akw(jzsfc)*1.e6
      cpout=cpsoil(jz)*1.e-6
c  output akw and cw in mg s m-4 units.
      cwout=cw(jz)*1.e6
      akout=akw(jz)*1.e6   
      
507    		clai    cslay   rslay   pslay   cilay   fehist  rdlay   ecompl 
==============================================================================
2,jtot		clai	cslay	rslout	pslay	cilay	fehist	rdlay	ecompl

      rslout = rslay(jj)     
      



      
    NAME         LAYER REGIME)  DEFINITION                      (M,NN,C)   
    ____         _________________________                      ________  
         
    HEIGHT       ALL) Height of the top of the layer (m)         5,04,1  
    
    ZDH          2)   Height of top of the layer divided by      5,04,2 
                      the canopy height.  
                    
    CONTOT       2)   Total condensation for a layer             5,04,3 

    ETOTW        2)   Evapotranspiration in a canopy layer       5,04,4         
                      (mgm-2s-1)                          

    VPD          1-3) Vapor pressure deficit (mb)                5,04,5       

    QCOND        ALL) Sensible heat flux by the soil and         5,04,6        
                      canopy layer (Wm-2)

    TLFAVE       2)   Average leaf temperature in canopy (C)     5,04,7

    ECOND        1-3) Vertical water flux in each layer (Wm-2)   5,04,8
                 4)   Liquid water flux in soil (mg m-2 s-1)

    PSLAY        2)   Photosynthetic rate in each layer          5,04,9       
                      (1E-6 mol CO2 m-2 s-1)

    RNDIV        2)   Net radiation divergence in layer (Wm-2)   5,05,1  
                 4)   Depth of soil node (m)      

    PINT         2)   Precipitation intercepted by a canopy      5,05,2
                      layer (mm)
                 4)   Percentage of root system extracting
                      water at each soil node.

    TRAN         2)   Transpiration of a canopy layer (Wm-2)     5,05,3  
                 4)   Total amount of water extracted at each
                      soil node during this timestep by roots 
                      (units ?)       

    EVAPG        1)   ???                                        5,05,4 
                 2)   Evaporation/ground area by layer (Wm-2)                

    HEATG        1)   ???                                        5,05,5
                 2)   Sensible heat/ground area (Wm-2)                     

    TAIR         1-3) Air temperature (C)                        5,05,6
                 4)   Soil temperature (C)   

    U            1-3) Wind speed (ms-1)                          5,05,7
                 4)   Water stored in each soil layer
                      (units?)

    EAIR         1-3) Air vapor pressure in canopy (mb)          5,05,8
                 4)   Soil water potential (bars)

    RH           1-3) Relative humidity of air (percent)         5,05,9
                 4)   Volumetric water content of soil
                      (percent)  

    ZMID         Height of midpoint of each layer (m)          5,06,1

    AKCPSO       Thermal conductivity for soil layer           5,06,2
                 (Jm-1s-1K-1) or canopy layer (m2s-1)

    CPCPSO       Thermal capacity of soil layer (MJm-3K-1)     5,06,3
                 or the canopy layer (kJm-3K-1)

    AKH          Thermal conductivity of soil or atmosphere    5,06,4
                 in canopy div. by layer height incr. (ms-1)

    CP           Thermal capacity of soil or atmosphere in     5,06,5
                 the canopy (Jm-2s-1K-1)

    RSAVE        Average stomatal resistance of a layer of     5,06,6
                 leaves (sm-1)

    RHLEAF       Boundary layer resistance of leaves in        5,06,7
                 a layer (s/m)

    AKW          Capillary conductivity of a layer in soil     5,06,8
                 divided by a layer depth increment (kgsm-4)

    CW           Capillary water capacity of soil divided      5,06,9
                 by a layer depth increment (kgsm-4)

    CLAI         Cumulative leaf area index (from top down)    5,07,1

    CSLAY        Leaf conductivity (stomatal and bound.layer)  5,07,2
                 (mol-1 H2O m2s)

    RSLAY        Stomatal resistance (s/m)                     5,07,3

    PSLAY        Leaf photosynthetic rate (E-6 mol m-2s-1)     5,07,4

    CILAY        Leaf internal CO2 concentration (ppm)         5,07,5

    FEHIST       Light history factor for photosynthesis       5,07,6
                 model