iceMelt: Function: Ice melt model

In glacierSMBM: Glacier Surface Mass Balance Model

Description

A simple model to calculate ice melt based on empirical melting factors.

Usage

iceMelt(airT, netRad, glacierMask, iceMask,  tUnit = "K",
    iceTMF = 67*10^-4, disIceTMF = stack(), iceRMF = 0.79*10^-4,
    disIceRMF = stack(), tuningFacAirT = 1,
    disTuningFacAirT = stack(), decimalPlaces = 4,
    outType = "mean", writeOutput = FALSE, outputName = "iceMelt",
    tmpCreate = FALSE, tmpDir = "", outDir = "", ... )

Arguments

airT	An object of class 'RasterStack'. Distributed air temperature (Kelvin or degree Celsius). For every time step.
netRad	An object of class 'RasterStack'. Distributed net radiation (W m-2). For every time step.
glacierMask	An object of class 'RasterStack'. Glacier area (1 = glacier, 0 = no glacier). Stationary or for every time step.
iceMask	An object of class RasterStack. Area of bare glacier ice (1 = bare ice, 0 = no bare ice). Stationary or for every time step.
tUnit	An object of class 'character'. Unit ("K" = Kelvin, "C" = degree Celsius) of air temperature (default = "K").
iceTMF	An object of class numeric. Temperature melting factor (m K-1 timestep-1) of ice (default = 67*10^-4).
disIceTMF	An object of class RasterStack. Distributed temperature melting factor (m K-1 timestep-1) of ice. Stationary or for every time step.
iceRMF	An object of class numeric. Radiative melting factor (m K-1 timestep-1) of ice (default = 0.79*10^-4).
disIceRMF	An object of class RasterStack. Distributed radiative temperature melting factor (m K-1 timestep-1) of ice. Stationary or for every time step.
tuningFacAirT	An object of class 'numeric'. General air temperature tuning factor (<1 = temperature decrease, 1 = default, >1 = temperature increase).
disTuningFacAirT	An object of class 'RasterStack'. Distributed air temperature tuning factor (tuningFacAirT). Stationary or for every time step.
decimalPlaces	An object of class 'numeric'. Number of decimal places (default = 4).
outType	An object of class 'character'. Type of output to be returned by the function: "mean" (default) ice melt or "sum".
writeOutput	An object of class 'logical'. Determines whether the ouput shall be exported as RasterLayer (TRUE) or not (FALSE, default).
outputName	An object of class 'character'. File name for the output RasterLayer(s) (default = "iceMelt").
tmpCreate	An object of class 'logical'. Determines whether a temporary directory should be used (TRUE) or not (FALSE, default). Recommendend if large datasets are processed.
tmpDir	An object of class 'character'. Directory where processing files can be temporarily stored if 'tmpCreate' = TRUE.
outDir	An object of class 'character'. Directory for the output files if 'writeOutput' = TRUE.
...	Further arguments.

Details

An enhanced degree-day model (e.g. Hock, 2003, 2005; Pellicciotti & alii, 2005) is applied to quantify glacier mass loss ascribed to melted ("bare") ice using empirical temperature (TMF) and radiative melting factors (RMF). Fore more information please refer to the examples below or the original publication (Groos et al., submitted, Equation 10)

Value

An object of class 'RasterLayer' returning the calculated spatial distribution of ice melt (e.g. in m d-1, depending on 'tmpRes').

Note

The following input variables are the requested minimum to run the model:

• 'airT' (for every time step)

• 'netRad' (for every time step)

• 'glacierMask' (stationary or for every time step)

• 'iceMask' (stationary or for every time step)

A default value (constant in space and time) is given for each additional argument like 'iceTMF' or 'iceRMF'. If desired, the default parameters can be modified. Furthermore, there is the option to pass distributed values (stationary or for every time step) instead of general values using the related 'dis*'-arguments like 'disIceTMF' or 'disIceRMF'. In this case, the general parameter is ignored.

File format of written ouput: GeoTIFF.

Author(s)

Alexander R. Groos ([e-mail])

References

Groos, A.R., Mayer, C., Smiraglia, C., Diolaiuti, G., and Lambrecht A. (submitted). A first attempt to model region-wide glacier surface mass balances in the Karakoram: findings and future challenges. Geografia Fisica e Dinamica Quaternaria.

Hock, R. (2003). Temperature index melt modelling in mountain areas. Journal of Hydrology 282, 104-115.

Hock, R. (2005). Glacier melt: a review of processes and their modelling. Progress in Physical Geography 29, 362-391.

Pellicciotti F., Brock B., Strasser U., Burlando P., Funk M. and Corripio J. (2005). An enhanced temperature-index glacier melt model including the shortwave radiation balance: development and testing for Haut Glacier d'Arolla, Switzerland. Journal of Glaciology, 51, 573-587.

See Also

glacialMelt, snowMelt, debrisCoveredIceMelt

Examples

# Load the provided RasterLayer objects as exemplary
# input for the function
data(airTemperature_30m_daily, netRad_30m_hourly,
    glacierMask_30m, iceMask_30m, package = "glacierSMBM")
# Individual RasterLayer objects should be loaded or
# created using the function raster()

# Include RasterLayer in RasterStack
AirTemperature_30m_daily <- stack(airTemperature_30m_daily)
NetRad_30m_hourly <- stack(netRad_30m_hourly)
GlacierMask_30m <- stack(glacierMask_30m)
IceMask_30m <- stack(iceMask_30m)

# Calculate ice melt using standard settings
output <- iceMelt(airT = AirTemperature_30m_daily,
    netRad = NetRad_30m_hourly, glacierMask = GlacierMask_30m,
    iceMask = IceMask_30m)

# Plot output
plot(output, main = "ice melt",
    legend.args=list(text='Ice melt (m d-1)', side=3, line=1.5))

# Calculate ice melt using modified setting (e.g. air temperature
# in degree Celsius instead of Kelvin; changes melting factors)
# Therefore exemplarily convert temperature from kelvin to celsius
airTcelsius <- subset(AirTemperature_30m_daily, 1) - 273.15

# Include RasterLayer in RasterStack
airTcelsius <- stack(airTcelsius)

output <- iceMelt(airT = airTcelsius, netRad = NetRad_30m_hourly,
    glacierMask = GlacierMask_30m, tUnit = "C",
    iceMask = IceMask_30m, iceTMF = 75*10^-4, iceRMF = 1.2*10^-4)

# Plot output
plot(output, main = "ice melt",
    legend.args=list(text='Ice melt (m d-1)', side=3, line=1.5))

glacierSMBM documentation built on May 2, 2019, 3:42 a.m.