ET.Penpan: Penpan Formulation

Description

Implementing the Penpan formulation for Class-A pan evaporation.

Usage

## S3 method for class 'Penpan':
ET(data, constants, solar, alpha, overest, \dots)

Arguments

data

A list of data in class "Penpan" which contains the following items (climate variables) required by Penpan formulation: "Tmax", "Tmin", "RHmax", "RHmin", "Rs", "n" or "Cd", "u2" or "uz"

constants

A list named "constants" consists of constants required for the calculation of Penpan formulation which must contain the following items: "Elev" - ground elevation above mean sea level in m, "lambda" - latent heat of vaporisation = 2.45 MJ.kg^-1,

solar

Must be either "data", "sunshine hours", "cloud" or "monthly precipitation". "data" indicates that solar radiation data is to be used directly for calculating evapotranspiration; "sunshine hours" indicates that solar radiation is to be calculated using th

alpha

Any numeric value between 0 and 1 (dimensionless), albedo of evaporative surface (or surrounding surface for Penpan formulation) representing the portion of the incident radiation that is reflected back at the surface.

overest

Must be TRUE or FALSE, indicating if adjustment for the overestimation (i.e. divided by 1.078) of Class-A pan evaporation for Australian data is applied in Penpan formulation.

...

Dummy for generic function, no need to define.

Value

This function returns a object of class Penpan. Such objects are list with components:
ET.DailyA zoo object containing daily aggregated estimations of Penpan Class-A pan evaporation.
ET.MonthlyA zoo object containing monthly aggregated estimations of Penpan Class-A pan evaporation.
ET.AnnualA zoo object containing annually aggregated estimations of Penpan Class-A pan evaporation.
ET.MonthlyAveA zoo object containing monthly averaged estimations of daily Penpan Class-A pan evaporation.
ET.AnnualAveA zoo object containing annually averaged estimations of daily Penpan Class-A pan evaporation.
ET_formulationA character string containing the name of the formulation used which equals to "Penpan".
ET_typeA character string containing the type of the estimation obtained which is "Class-A Pan Evaporation".
message1A message to inform the users about how solar radiation has been calculated by using which data.

Details

The alternative calculation options can be selected through argument solar, please see "Arguments" for details. User-defined evaporative surface is allowed through argument alpha, please see "Arguments" for details. Adjustment for overestimation on the estimations are available through argument height, please see "Arguments" for details.

References

MCMAHON, T., PEEL, M., LOWE, L., SRIKANTHAN, R. & MCVICAR, T. 2012. Estimating actual, potential, reference crop and pan evaporation using standard meteorological data: a pragmatic synthesis. Hydrology and Earth System Sciences Discussions, 9, 11829-11910. ROTSTAYN, L. D., RODERICK, M. L. & FARQUHAR, G. D. 2006. A simple pan-evaporation model for analysis of climate simulations: Evaluation over Australia. Geophysical Research Letters, 33.

Examples

Run this code

# Use processed existing data set from kent Town, Adelaide
data("processeddata")
data("constants")

# Set data class to be "Penpan" to call function
funname <- "Penpan"
class(data) <- funname

# Call generic function ET(data, ...) with class "Penpan"
results <- ET(data, constants, solar="sunshine hours", alpha = 0.23, overest = TRUE)

Run the code above in your browser using DataLab