.. -*- mode: rst -*-

.. DO NOT EDIT. This file was generated using list_diagnostics.py.


.. _sec-extra_vars:

Spatially-variable fields
-------------------------

#. ``air_temp_mean_july``

   :Units: Kelvin
   :Description: mean July near-surface air temperature used in the cosine yearly cycle

#. ``air_temp_sd``

   :Units: Kelvin
   :Description: standard deviation of near-surface air temperature

#. ``air_temp_snapshot``

   :Units: Kelvin
   :Description: instantaneous value of the near-surface air temperature

#. ``basal_mass_flux_floating``

   :Units: kg m-2 year-1
   :Description: average basal mass flux over the reporting interval (floating areas)
   :Comment: positive flux corresponds to ice gain

#. ``basal_mass_flux_grounded``

   :Units: kg m-2 year-1
   :Description: average basal mass flux over the reporting interval (grounded areas)
   :Comment: positive flux corresponds to ice gain

#. ``basal_melt_rate_grounded``

   :Units: m year-1
   :Description: ice basal melt rate from energy conservation, in ice thickness per time (valid in grounded areas)
   :Comment: positive basal melt rate corresponds to ice loss

#. ``bedtoptemp``

   :Units: Kelvin
   :Description: temperature at the top surface of the bedrock thermal layer

#. ``beta``

   :Units: Pa s / m
   :Description: basal drag coefficient

#. ``bfrict``

   :Units: W m-2
   :Description: basal frictional heating

#. ``bheatflx``

   :Units: mW m-2
   :Description: upward geothermal flux at the bottom bedrock surface
   :Comment: positive values correspond to an upward flux

#. ``bmelt``

   :Units: m year-1
   :Description: ice basal melt rate from energy conservation and subshelf melt, in ice thickness per time
   :Standard name: ``land_ice_basal_melt_rate``
   :Comment: positive basal melt rate corresponds to ice loss

#. ``bwat``

   :Units: m
   :Description: thickness of transportable water in subglacial layer

#. ``bwatvel``

   - ``bwatvel[0]``

     :Units: m year-1
     :Description: velocity of water in subglacial layer, i-offset

   - ``bwatvel[1]``

     :Units: m year-1
     :Description: velocity of water in subglacial layer, j-offset

#. ``bwp``

   :Units: Pa
   :Description: pressure of transportable water in subglacial layer

#. ``bwprel``

   :Units: ---
   :Description: pressure of transportable water in subglacial layer as fraction of the overburden pressure

#. ``calving_threshold``

   :Units: m
   :Description: threshold used by the 'calving at threshold' calving method

#. ``cell_area``

   :Units: km2
   :Description: cell areas
   :Comment: values are equal to dx*dy if projection parameters are not available; otherwise WGS84 ellipsoid is used

#. ``cell_grounded_fraction``

   :Units: ---
   :Description: fractional grounded/floating mask (floating=0, grounded=1)

#. ``climatic_mass_balance``

   :Units: kg m-2 year-1
   :Description: surface mass balance (accumulation/ablation) rate
   :Standard name: ``land_ice_surface_specific_mass_balance_flux``

#. ``cts``

   :Units: ---
   :Description: cts = E/E_s(p), so cold-temperate transition surface is at cts = 1

#. ``dHdt``

   :Units: m year-1
   :Description: ice thickness rate of change
   :Standard name: ``tendency_of_land_ice_thickness``

#. ``dbdt``

   :Units: mm year-1
   :Description: bedrock uplift rate
   :Standard name: ``tendency_of_bedrock_altitude``

#. ``deviatoric_stresses``

   - ``sigma_xx``

     :Units: Pa
     :Description: deviatoric stress in X direction

   - ``sigma_yy``

     :Units: Pa
     :Description: deviatoric stress in Y direction

   - ``sigma_xy``

     :Units: Pa
     :Description: deviatoric shear stress

#. ``diffusivity``

   :Units: m2 s-1
   :Description: diffusivity of SIA mass continuity equation

#. ``diffusivity_staggered``

   - ``diffusivity_i``

     :Units: m2 s-1
     :Description: diffusivity of SIA mass continuity equation on the staggered grid (i-offset)

   - ``diffusivity_j``

     :Units: m2 s-1
     :Description: diffusivity of SIA mass continuity equation on the staggered grid (j-offset)

#. ``effbwp``

   :Units: Pa
   :Description: effective pressure of transportable water in subglacial layer (overburden pressure minus water pressure)

#. ``effective_air_temp``

   :Units: Kelvin
   :Description: effective mean-annual near-surface air temperature

#. ``effective_precipitation``

   :Units: kg m-2 year-1
   :Description: effective precipitation rate

#. ``effective_viscosity``

   :Units: kPascal second
   :Description: effective viscosity of ice

#. ``eigen_calving_rate``

   :Units: m year-1
   :Description: horizontal calving rate due to eigen-calving

#. ``enthalpy``

   :Units: J kg-1
   :Description: ice enthalpy (includes sensible heat, latent heat, pressure)

#. ``enthalpybase``

   :Units: J kg-1
   :Description: ice enthalpy at the base of ice

#. ``enthalpysurf``

   :Units: J kg-1
   :Description: ice enthalpy at 1m below the ice surface

#. ``firn_depth``

   :Units: m
   :Description: firn cover depth

#. ``flux``

   - ``uflux``

     :Units: m2 year-1
     :Description: Vertically integrated horizontal flux of ice in the X direction

   - ``vflux``

     :Units: m2 year-1
     :Description: Vertically integrated horizontal flux of ice in the Y direction

#. ``flux_divergence``

   :Units: m year-1
   :Description: flux divergence

#. ``flux_mag``

   :Units: m2 year-1
   :Description: magnitude of vertically-integrated horizontal flux of ice

#. ``flux_staggered``

   :Units: m2 year-1
   :Description: fluxes through cell interfaces (sides) on the staggered grid

#. ``frontal_melt_rate``

   :Units: m year-1
   :Description: horizontal front retreat rate due to melt

#. ``h_x``

   - ``h_x_i``

     :Units: ---
     :Description: the x-component of the surface gradient, i-offset

   - ``h_x_j``

     :Units: ---
     :Description: the x-component of the surface gradient, j-offset

#. ``h_y``

   - ``h_y_i``

     :Units: ---
     :Description: the y-component of the surface gradient, i-offset

   - ``h_y_j``

     :Units: ---
     :Description: the y-component of the surface gradient, j-offset

#. ``hardav``

   :Units: Pa s0.333333
   :Description: vertical average of ice hardness

#. ``hardness``

   :Units: Pa s0.333333
   :Description: ice hardness computed using the SIA flow law

#. ``height_above_flotation``

   :Units: m
   :Description: ice thickness in excess of the maximum floating ice thickness
   :Comment: shows how close to floatation the ice is at a given location

#. ``hfgeoubed``

   :Units: mW m-2
   :Description: upward geothermal flux at the top bedrock surface
   :Standard name: ``upward_geothermal_heat_flux_at_ground_level``
   :Comment: positive values correspond to an upward flux

#. ``hydrobmelt``

   :Units: m year-1
   :Description: the version of bmelt seen by the hydrology model

#. ``hydroinput``

   :Units: m year-1
   :Description: total water input into subglacial hydrology layer

#. ``ice_area_specific_volume``

   :Units: m3/m2
   :Description: ice-volume-per-area in partially-filled grid cells
   :Comment: this variable represents the amount of ice in a partially-filled cell and not the corresponding geometry, so thinking about it as 'thickness' is not helpful

#. ``ice_mass``

   :Units: kg
   :Description: mass per cell

#. ``ice_surface_liquid_water_fraction``

   :Units: 1
   :Description: ice liquid water fraction at the ice surface

#. ``ice_surface_temp``

   :Units: Kelvin
   :Description: ice temperature at the ice surface

#. ``lat``

   :Units: degree_north
   :Description: latitude
   :Standard name: ``latitude``

#. ``liqfrac``

   :Units: 1
   :Description: liquid water fraction in ice (between 0 and 1)

#. ``lon``

   :Units: degree_east
   :Description: longitude
   :Standard name: ``longitude``

#. ``mask``

   :Units: ---
   :Description: ice-type (ice-free/grounded/floating/ocean) integer mask

#. ``melange_back_pressure_fraction``

   :Units: 1
   :Description: dimensionless pressure fraction at calving fronts due to presence of melange 

#. ``nuH``

   - ``nuH[0]``

     :Units: kPa s m
     :Description: ice thickness times effective viscosity, i-offset

   - ``nuH[1]``

     :Units: kPa s m
     :Description: ice thickness times effective viscosity, j-offset

#. ``ocean_kill_mask``

   :Units: ---
   :Description: mask specifying fixed calving front locations

#. ``ocean_pressure_difference``

   :Units: ---
   :Description: ocean pressure difference at calving fronts

#. ``pressure``

   :Units: Pa
   :Description: pressure in ice (hydrostatic)

#. ``rank``

   :Units: 1
   :Description: processor rank

#. ``saccum``

   :Units: kg m-2 year-1
   :Description: accumulation (precipitation minus rain), averaged over the reporting interval

#. ``schoofs_theta``

   :Units: 1
   :Description: multiplier 'theta' in Schoof's (2003) theory of bed roughness in SIA

#. ``sea_level``

   :Units: meters
   :Description: sea level elevation, relative to the geoid

#. ``sftflf``

   :Units: 1
   :Description: fraction of a grid cell covered by floating ice
   :Standard name: ``floating_ice_sheet_area_fraction``

#. ``sftgif``

   :Units: 1
   :Description: fraction of a grid cell covered by ice (grounded or floating)
   :Standard name: ``land_ice_area_fraction``

#. ``sftgrf``

   :Units: 1
   :Description: fraction of a grid cell covered by grounded ice
   :Standard name: ``grounded_ice_sheet_area_fraction``

#. ``shelfbmassflux``

   :Units: kg m-2 s-1
   :Description: mass flux at the basal surface of ice shelves

#. ``shelfbtemp``

   :Units: Kelvin
   :Description: ice temperature at the basal surface of ice shelves

#. ``smelt``

   :Units: kg m-2 year-1
   :Description: surface melt, averaged over the reporting interval

#. ``snow_depth``

   :Units: m
   :Description: snow cover depth (set to zero once a year)

#. ``srunoff``

   :Units: kg m-2 year-1
   :Description: surface runoff, averaged over the reporting interval

#. ``ssa_bc_mask``

   :Units: ---
   :Description: Dirichlet boundary mask

#. ``ssa_bc_vel``

   - ``u_ssa_bc``

     :Units: m year-1
     :Description: X-component of the SSA velocity boundary conditions

   - ``v_ssa_bc``

     :Units: m year-1
     :Description: Y-component of the SSA velocity boundary conditions

#. ``strain_rates``

   - ``eigen1``

     :Units: s-1
     :Description: first eigenvalue of the horizontal, vertically-integrated strain rate tensor

   - ``eigen2``

     :Units: s-1
     :Description: second eigenvalue of the horizontal, vertically-integrated strain rate tensor

#. ``strainheat``

   :Units: mW m-3
   :Description: rate of strain heating in ice (dissipation heating)

#. ``surface_layer_mass``

   :Units: kg
   :Description: mass of the surface layer (snow and firn)

#. ``surface_layer_thickness``

   :Units: meters
   :Description: thickness of the surface layer (snow and firn)

#. ``taub``

   - ``taub_x``

     :Units: Pa
     :Description: X-component of the shear stress at the base of ice
     :Comment: this field is purely diagnostic (not used by the model)

   - ``taub_y``

     :Units: Pa
     :Description: Y-component of the shear stress at the base of ice
     :Comment: this field is purely diagnostic (not used by the model)

#. ``taub_mag``

   :Units: Pa
   :Description: magnitude of the basal shear stress at the base of ice
   :Standard name: ``magnitude_of_land_ice_basal_drag``
   :Comment: this field is purely diagnostic (not used by the model)

#. ``tauc``

   :Units: Pa
   :Description: yield stress for basal till (plastic or pseudo-plastic model)

#. ``taud``

   - ``taud_x``

     :Units: Pa
     :Description: X-component of the driving shear stress at the base of ice
     :Comment: this is the driving stress used by the SSA solver

   - ``taud_y``

     :Units: Pa
     :Description: Y-component of the driving shear stress at the base of ice
     :Comment: this is the driving stress used by the SSA solver

#. ``taud_mag``

   :Units: Pa
   :Description: magnitude of the driving shear stress at the base of ice
   :Comment: this is the magnitude of the driving stress used by the SSA solver

#. ``tauxz``

   :Units: Pa
   :Description: shear stress xz component (in shallow ice approximation SIA)

#. ``tauyz``

   :Units: Pa
   :Description: shear stress yz component (in shallow ice approximation SIA)

#. ``temp``

   :Units: K
   :Description: ice temperature
   :Standard name: ``land_ice_temperature``

#. ``temp_pa``

   :Units: deg_C
   :Description: pressure-adjusted ice temperature (degrees above pressure-melting point)

#. ``tempbase``

   :Units: K
   :Description: ice temperature at the base of ice
   :Standard name: ``land_ice_basal_temperature``

#. ``tempicethk``

   :Units: m
   :Description: temperate ice thickness (total column content)

#. ``tempicethk_basal``

   :Units: m
   :Description: thickness of the basal layer of temperate ice

#. ``temppabase``

   :Units: Celsius
   :Description: pressure-adjusted ice temperature at the base of ice

#. ``tempsurf``

   :Units: K
   :Description: ice temperature at 1m below the ice surface
   :Standard name: ``temperature_at_ground_level_in_snow_or_firn``

#. ``tendency_of_ice_amount``

   :Units: kg m-2 year-1
   :Description: rate of change of the ice amount

#. ``tendency_of_ice_amount_due_to_basal_mass_flux``

   :Units: kg m-2 year-1
   :Description: average basal mass flux over reporting interval
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_amount_due_to_conservation_error``

   :Units: kg m-2 year-1
   :Description: average mass conservation error flux over reporting interval
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_amount_due_to_discharge``

   :Units: kg m-2 year-1
   :Description: discharge (calving and frontal melt) flux
   :Standard name: ``land_ice_specific_mass_flux_due_to_calving_and_ice_front_melting``
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_amount_due_to_flow``

   :Units: kg m-2 year-1
   :Description: rate of change of ice amount due to flow
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_amount_due_to_surface_mass_flux``

   :Units: kg m-2 year-1
   :Description: average surface mass flux over reporting interval
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_mass``

   :Units: Gt year-1
   :Description: rate of change of the ice mass

#. ``tendency_of_ice_mass_due_to_basal_mass_flux``

   :Units: Gt year-1
   :Description: average basal mass flux over reporting interval
   :Standard name: ``tendency_of_land_ice_mass_due_to_basal_mass_balance``
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_mass_due_to_conservation_error``

   :Units: Gt year-1
   :Description: average mass conservation error flux over reporting interval
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_mass_due_to_discharge``

   :Units: Gt year-1
   :Description: discharge (calving and frontal melt) flux
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_mass_due_to_flow``

   :Units: Gt year-1
   :Description: rate of change of ice mass due to flow
   :Comment: positive flux corresponds to ice gain

#. ``tendency_of_ice_mass_due_to_surface_mass_flux``

   :Units: Gt year-1
   :Description: average surface mass flux over reporting interval
   :Comment: positive flux corresponds to ice gain

#. ``thk``

   :Units: m
   :Description: land ice thickness
   :Standard name: ``land_ice_thickness``

#. ``thksmooth``

   :Units: m
   :Description: thickness relative to smoothed bed elevation in Schoof's (2003) theory of bed roughness in SIA

#. ``tillphi``

   :Units: degrees
   :Description: friction angle for till under grounded ice sheet

#. ``tillwat``

   :Units: m
   :Description: effective thickness of subglacial water stored in till

#. ``topg``

   :Units: m
   :Description: bedrock surface elevation
   :Standard name: ``bedrock_altitude``

#. ``topg_sl_adjusted``

   :Units: meters
   :Description: sea-level adjusted bed topography (zero is at sea level)

#. ``topgsmooth``

   :Units: m
   :Description: smoothed bed elevation in Schoof's (2003) theory of bed roughness in SIA

#. ``usurf``

   :Units: m
   :Description: ice upper surface elevation
   :Standard name: ``surface_altitude``

#. ``uvel``

   :Units: m year-1
   :Description: horizontal velocity of ice in the X direction
   :Standard name: ``land_ice_x_velocity``

#. ``velbar``

   - ``ubar``

     :Units: m year-1
     :Description: vertical mean of horizontal ice velocity in the X direction
     :Standard name: ``land_ice_vertical_mean_x_velocity``

   - ``vbar``

     :Units: m year-1
     :Description: vertical mean of horizontal ice velocity in the Y direction
     :Standard name: ``land_ice_vertical_mean_y_velocity``

#. ``velbar_mag``

   :Units: m year-1
   :Description: magnitude of vertically-integrated horizontal velocity of ice

#. ``velbase``

   - ``uvelbase``

     :Units: m year-1
     :Description: x-component of the horizontal velocity of ice at the base of ice
     :Standard name: ``land_ice_basal_x_velocity``

   - ``vvelbase``

     :Units: m year-1
     :Description: y-component of the horizontal velocity of ice at the base of ice
     :Standard name: ``land_ice_basal_y_velocity``

#. ``velbase_mag``

   :Units: m year-1
   :Description: magnitude of horizontal velocity of ice at base of ice

#. ``velsurf``

   - ``uvelsurf``

     :Units: m year-1
     :Description: x-component of the horizontal velocity of ice at ice surface
     :Standard name: ``land_ice_surface_x_velocity``

   - ``vvelsurf``

     :Units: m year-1
     :Description: y-component of the horizontal velocity of ice at ice surface
     :Standard name: ``land_ice_surface_y_velocity``

#. ``velsurf_mag``

   :Units: m year-1
   :Description: magnitude of horizontal velocity of ice at ice surface

#. ``vonmises_calving_rate``

   :Units: m year-1
   :Description: horizontal calving rate due to von Mises calving

#. ``vonmises_stress``

   :Units: Pascal
   :Description: tensile von Mises stress

#. ``vvel``

   :Units: m year-1
   :Description: horizontal velocity of ice in the Y direction
   :Standard name: ``land_ice_y_velocity``

#. ``wallmelt``

   :Units: m year-1
   :Description: wall melt into subglacial hydrology layer from (turbulent) dissipation of energy in transportable water

#. ``wvel``

   :Units: m year-1
   :Description: vertical velocity of ice, relative to geoid

#. ``wvel_rel``

   :Units: m year-1
   :Description: vertical velocity of ice, relative to base of ice directly below

#. ``wvelbase``

   :Units: m year-1
   :Description: vertical velocity of ice at the base of ice, relative to the geoid
   :Standard name: ``land_ice_basal_upward_velocity``

#. ``wvelsurf``

   :Units: m year-1
   :Description: vertical velocity of ice at ice surface, relative to the geoid
   :Standard name: ``land_ice_surface_upward_velocity``

.. _sec-ts_vars:

Scalar time-series
------------------

#. ``basal_mass_flux_floating``

   :Units: Gt year-1
   :Description: total sub-shelf ice flux
   :Comment: positive means ice gain

#. ``basal_mass_flux_grounded``

   :Units: Gt year-1
   :Description: total over grounded ice domain of basal mass flux
   :Comment: positive means ice gain

#. ``dt``

   :Units: year
   :Description: mass continuity time step

#. ``hydro_ice_free_land_loss``

   :Units: kg s-1
   :Description: rate of liquid water loss from subglacial hydrology into cells with mask as ice free land

#. ``hydro_negative_thickness_gain``

   :Units: kg s-1
   :Description: rate of non-conserving liquid water gain from subglacial hydrology transportable water thickness coming out negative during time step, and being projected up to zero

#. ``hydro_null_strip_loss``

   :Units: kg s-1
   :Description: rate of liquid water loss from subglacial hydrology into cells inside the null strip

#. ``hydro_ocean_loss``

   :Units: kg s-1
   :Description: rate of liquid water loss from subglacial hydrology into cells with mask as ocean

#. ``ice_area_glacierized``

   :Units: m2
   :Description: glacierized area

#. ``ice_area_glacierized_cold_base``

   :Units: m2
   :Description: glacierized area where basal ice is cold

#. ``ice_area_glacierized_floating``

   :Units: m2
   :Description: area of ice shelves in glacierized areas

#. ``ice_area_glacierized_grounded``

   :Units: m2
   :Description: area of grounded ice in glacierized areas

#. ``ice_area_glacierized_temperate_base``

   :Units: m2
   :Description: glacierized area where basal ice is temperate

#. ``ice_enthalpy``

   :Units: J
   :Description: enthalpy of the ice, including seasonal cover

#. ``ice_enthalpy_glacierized``

   :Units: J
   :Description: enthalpy of the ice in glacierized areas

#. ``ice_mass``

   :Units: kg
   :Description: mass of the ice, including seasonal cover

#. ``ice_mass_glacierized``

   :Units: kg
   :Description: mass of the ice in glacierized areas

#. ``ice_volume``

   :Units: m3
   :Description: volume of the ice, including seasonal cover

#. ``ice_volume_cold``

   :Units: m3
   :Description: volume of cold ice, including seasonal cover

#. ``ice_volume_glacierized``

   :Units: m3
   :Description: volume of the ice in glacierized areas

#. ``ice_volume_glacierized_cold``

   :Units: m3
   :Description: volume of cold ice in glacierized areas

#. ``ice_volume_glacierized_floating``

   :Units: m3
   :Description: volume of ice shelves in glacierized areas

#. ``ice_volume_glacierized_grounded``

   :Units: m3
   :Description: volume of grounded ice in glacierized areas

#. ``ice_volume_glacierized_temperate``

   :Units: m3
   :Description: volume of temperate ice in glacierized areas

#. ``ice_volume_temperate``

   :Units: m3
   :Description: volume of temperate ice, including seasonal cover

#. ``limnsw``

   :Units: kg
   :Description: mass of the ice not displacing sea water

#. ``liquified_ice_flux``

   :Units: m3 / year
   :Description: rate of ice loss due to liquefaction, averaged over the reporting interval
   :Comment: positive means ice loss

#. ``max_diffusivity``

   :Units: m2 s-1
   :Description: maximum diffusivity

#. ``max_hor_vel``

   :Units: m year-1
   :Description: maximum abs component of horizontal ice velocity over grid in last time step during time-series reporting interval

#. ``slvol``

   :Units: m
   :Description: total sea-level relevant ice IN SEA-LEVEL EQUIVALENT

#. ``tendency_of_ice_mass``

   :Units: Gt year-1
   :Description: rate of change of the mass of ice, including seasonal cover

#. ``tendency_of_ice_mass_due_to_basal_mass_flux``

   :Units: Gt year-1
   :Description: total over ice domain of bottom surface ice mass flux
   :Comment: positive means ice gain

#. ``tendency_of_ice_mass_due_to_conservation_error``

   :Units: Gt year-1
   :Description: total numerical flux needed to preserve non-negativity of ice thickness
   :Comment: positive means ice gain

#. ``tendency_of_ice_mass_due_to_discharge``

   :Units: Gt year-1
   :Description: discharge (calving & icebergs) flux
   :Comment: positive means ice gain

#. ``tendency_of_ice_mass_due_to_flow``

   :Units: Gt year-1
   :Description: rate of change of the mass of ice due to flow (i.e. prescribed ice thickness)

#. ``tendency_of_ice_mass_due_to_surface_mass_flux``

   :Units: Gt year-1
   :Description: total over ice domain of top surface ice mass flux
   :Comment: positive means ice gain

#. ``tendency_of_ice_mass_glacierized``

   :Units: Gt year-1
   :Description: rate of change of the ice mass in glacierized areas

#. ``tendency_of_ice_volume``

   :Units: m3 year-1
   :Description: rate of change of the ice volume, including seasonal cover

#. ``tendency_of_ice_volume_glacierized``

   :Units: m3 year-1
   :Description: rate of change of the ice volume in glacierized areas
