Initialize an ERAHUMED simulation — erahumed

Initializes an ERAHUMED simulation. Check the main package vignette for a detailed description of the simulation workflow.

Usage

erahumed_simulation(
  date_start = "2020-01-01",
  date_end = "2020-12-31",
  outflows_df = erahumed::albufera_outflows,
  weather_df = erahumed::albufera_weather,
  variety_prop = c(J.Sendra = 0.8, Bomba = 0.1, Clearfield = 0.1),
  storage_curve_slope_m2 = 23.66 * 1e+06,
  storage_curve_intercept_m3 = 16.75 * 1e+06,
  petp_surface_m2 = 53.9 * 1e+06,
  management_df = erahumed::albufera_management,
  ideal_flow_rate_cm = 5,
  height_thresh_cm = 0.5,
  ditch_level_m = 1,
  ca_schedules_df = erahumed::albufera_ca_schedules,
  drift = 0,
  covmax = 0.5,
  jgrow = 152,
  dact_m = 0.1,
  css_ppm = 50,
  foc = 0.17,
  bd_g_cm3 = 1.5,
  qseep_m_day = 0,
  porosity = 0.11,
  seed = 840
)

Arguments

date_start: [Date(1)]
A single-value Date vector (or a convertible object). Defines the starting date of the date interval for the simulation.
date_end: [Date(1)]
A single-value Date vector (or a convertible object). Defines the ending date of the date interval for the simulation.
outflows_df: [data.frame]
Time-series dataset that provides the observational hydrological data on the Albufera lake, along the template of albufera_outflows (the default value).
weather_df: [data.frame]
A dataset that provides the relevant metereological time series, along the template of albufera_weather (the default value).
variety_prop: [numeric(3)]
Vector of 3 positive values. Controls the relative proportions of field surface allocated to the cultivation of the J. Sendra, Bomba, and Clearfield varieties, respectively.
storage_curve_slope_m2: [numeric(1)]
Slope of the (linear) storage curve of the Albufera Lake, in square meters. Multiplying this value by the change in the lake's water level gives the corresponding change in water volume. The default numeric values are derived from the CHJ report Modelo de seguimiento de l’Albufera de Valencia con AQUATOOLDMA.
storage_curve_intercept_m3: [numeric(1)]
Intercept of the linear storage curve for the Albufera Lake, expressed in cubic meters. This value represents the lake's water volume when the water level is at sea level. The default numeric values are derived from the CHJ report Modelo de seguimiento de l’Albufera de Valencia con AQUATOOLDMA.
petp_surface_m2: [numeric(1)]
The surface area (in square meters) used to convert precipitation and evapotranspiration per unit area into volume changes for the Albufera Lake. The default numeric value was computed by the package authors and corresponds to the average flooded surface of the Albufera lake and its irrigation ditches.
management_df: [data.frame]
Dataset that provides the yearly schedule for irrigation and draining, along the template of albufera_management (the default value).
ideal_flow_rate_cm: [numeric(1)]
Ideal inflow/outflow of a cluster, for days in which the cluster is scheduled to be in flux (i.e. when being simultaneously irrigated and drained). Expressed in centimeters per day.
height_thresh_cm: [numeric(1)]
A positive number. Height threshold for water levels, below which a cluster is considered to be emptied.
ditch_level_m: [numeric(1)]
Constant water depth in ditches.
ca_schedules_df: [data.frame]
A dataset that provides the list of scheduled chemical applications, along the template of albufera_ca_schedules.
drift: [numeric(1)]
A number between 0 and 1. Fraction of applied chemical lost to drift during application.
covmax: [numeric(1)]
A number between 0 and 1. Maximum potential fraction of applied chemicals intercepted by foliage at crop maturation.
jgrow: [numeric(1)]
A positive integer. Length (in days) of crop maturation cycle in rice paddies.
dact_m: [numeric(1)]
A positive number. Active sediment layer depth, where "active"" refers to the portion of the sediment that is actually involved in chemical exchange or transport processes. Expressed in meters.
css_ppm: [numeric(1)]
A positive number. Concentration of suspended solid, expressed in parts per million.
foc: [numeric(1)]
A number between 0 and 1. Fraction of organic content within suspended solids and sediments.
bd_g_cm3: [numeric(1)]
A positive number. Bulk density of the sediment (including both the solid material and the pore spaces). Expressed in grams per cubic centimeter.
qseep_m_day: [numeric(1)]
A positive number. Seepage rate, i.e. the rate at which water seeps through the sediment or soil. Expressed in meters per day.
porosity: [numeric(1)]
A number between 0 and 1. The fraction of the total sediment volume that is occupied by pore spaces.
seed: [numeric(1)]
Seed for random number generation used by the simulation algorithms.

Value

An object of class erahumed_simulation.

Examples

erahumed_simulation()
#> A ERAHUMED simulation.
#> 
#> Start date: 2020-01-01 
#> End date: 2020-12-31 
#> 
#> Need help extracting simulation outputs? Check `?get_results`.