Skip to contents

Landscape parameters

Parameter Name Unit Group Type Description
date_start Start Date N/A General Date(1) A single-value Date vector (or a convertible object). Defines the starting date of the date interval for the simulation.
date_end End Date N/A General Date(1) A single-value Date vector (or a convertible object). Defines the ending date of the date interval for the simulation.
seed Simulation random seed N/A General numeric(1) Seed for random number generation used by the simulation algorithms.
outflows_df Lake outflows and levels data frame N/A Hydrology data.frame Time-series dataset that provides the observational hydrological data on the Albufera lake, along the template of albufera_outflows (the default value).
storage_curve_slope_m2 Storage curve slope Hydrology 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 Storage curve intercept Hydrology 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 PET surface Hydrology 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.
weather_df Weather data frame N/A Meteorology data.frame A dataset that provides the relevant metereological time series, along the template of albufera_weather (the default value).
ideal_flow_rate_cm Ideal flow rate cm Environmental properties 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 of water depth per day.
height_thresh_cm Cluster Height Threshold cm Environmental properties numeric(1) A positive number. Height threshold for water levels, below which a cluster is considered to be emptied.
ditch_level_m Ditch water level m Environmental properties numeric(1) Constant water depth in ditches.
covmax Max interception potential 1 Environmental properties numeric(1) A number between 0 and 1. Maximum potential fraction of applied chemicals intercepted by foliage at crop maturation.
jgrow Maturation cycle length day Environmental properties numeric(1) A positive integer. Length (in days) of crop maturation cycle in rice paddies.
dact_m Depth of active sediment m Environmental properties 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 Suspended solid concentration ppm Environmental properties numeric(1) A positive number. Concentration of water suspended solids, expressed in parts per million.
foc_ss Fraction of organic content in suspended solid 1 Environmental properties numeric(1) A number between 0 and 1. Fraction of organic matter content within suspended solids.
foc_sed Fraction of organic content in sediment 1 Environmental properties numeric(1) A number between 0 and 1. Fraction of organic matter content within sediment.
bd_g_cm3 Bulk density of sediment g·cm⁻² Environmental properties 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 Seepage rate m·day⁻¹ Environmental properties 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 Porosity 1 Environmental properties numeric(1) A number between 0 and 1. The fraction of the total sediment volume that is occupied by pore spaces.
rfms_map Map of rice field management systems N/A Agrochemical management erahumed_rfms_map An object of class rfms_map that defines how different rice field management systems (RFMSs) are assigned to spatial clusters within the simulation. This object also encapsulates the full set of user-defined agrochemical configurations, including custom chemicals and RFMSs, and serves as the main interface for scenario customization. See rfms for an overview of RFMS definitions and customization options.

Chemical parameters

Parameter Name Unit Group Type Description
display_name Chemical display name N/A Chemical identity character(1) The common name of the chemical (e.g., “Acetamiprid”).
tmoa_id Toxic mode of action ID N/A Chemical identity character(1) Identifier for the toxic mode of action (e.g., “NicotinicAcetylcholine”).
MW Molecular weight g/mol Physicochemical properties numeric(1) Molecular weight in grams per mole.
ksetl_m_day Settling rate m/day Transport parameters numeric(1) Settling rate, representing particle-bound transfer to sediment.
sol_ppm Solubility ppm Physicochemical properties numeric(1) Water solubility.
koc_cm3_g Koc cm ³ /g Sorption numeric(1) Organic carbon-water partition coefficient (Koc).
fet_cm Foliar extraction term 1/cm Transport parameters numeric(1) Fraction of pesticide washed off from foliage per cm of rainfall.
kf_day Foliage degradation rate 1/day Degradation numeric(1) Degradation rate in foliage.
kw_day Water column degradation rate 1/day Degradation numeric(1) Degradation rate in the water column.
ks_sat_day Saturated sediment degradation rate 1/day Degradation numeric(1) Degradation rate in saturated sediment.
ks_unsat_day Unsaturated sediment degradation rate 1/day Degradation numeric(1) Degradation rate in unsaturated sediment.
kw_temp Water degradation reference temp. ° C Degradation numeric(1) Reference temperature for kw_day.
ks_sat_temp Sat. sediment degradation ref. temp. ° C Degradation numeric(1) Reference temperature for ks_sat_day.
ks_unsat_temp Unsat. sediment degradation ref. temp. ° C Degradation numeric(1) Reference temperature for ks_unsat_day.
Q10_kw Q10 for water degradation N/A Degradation numeric(1) Q10 coefficient for temperature correction of degradation in water.
Q10_ks_sat Q10 for sat. sediment degradation N/A Degradation numeric(1) Q10 coefficient for temperature correction in saturated sediment.
Q10_ks_unsat Q10 for unsat. sediment degradation N/A Degradation numeric(1) Q10 coefficient for temperature correction in unsaturated sediment.
ssd_acute_mu SSD acute mean (log10) N/A Toxicity numeric(1) Mean (log10 scale) of the acute species sensitivity distribution.
ssd_acute_sigma SSD acute std. deviation (log10) N/A Toxicity numeric(1) Standard deviation (log10 scale) of the acute species sensitivity distribution.
ssd_chronic_mu SSD chronic mean (log10) N/A Toxicity numeric(1) Mean (log10 scale) of the chronic species sensitivity distribution.
ssd_chronic_sigma SSD chronic std. deviation (log10) N/A Toxicity numeric(1) Standard deviation (log10 scale) of the chronic species sensitivity distribution.

Rice field management system parameters

Parameter Name Unit Group Type Description
sowing_yday Start of sowing season N/A Calendar integer(1) Day of the year marking the start of the sowing season (1–366, assuming a leap year).
harvesting_yday End of sowing season N/A Calendar integer(1) Day of the year marking the end of the sowing season (1–366, assuming a leap year).
perellona_start_yday Start of Perellona N/A Calendar integer(1) Day of the year marking the beginning of the Perellona flooding period (after harvest).
perellona_end_yday End of Perellona N/A Calendar integer(1) Day of the year marking the end of the Perellona flooding period (before sowing).
flow_height_cm Target water level (sowing) cm Hydrology numeric(1) Target water level (in cm) during the regular days of the sowing season, excluding emptying and transition days.
perellona_height_cm Target water level (Perellona) cm Hydrology numeric(1) Target water level (in cm) during the Perellona flooding period.
display_name Display name N/A Metadata character(1) Name of the management system to be displayed in output plots and summaries.

Surface allocation parameters

Parameter Name Unit Group Type Description
map Cluster map N/A Inputs erahumed_rfms_map A cluster map created with new_rfms_map() or default_rfms_map().
system Management system N/A Inputs erahumed_rfms A management system to assign, created with new_rfms() or helper functions such as bomba() or clearfield().
target_fraction Target allocation fraction 1 Allocation settings numeric(1) The fraction of surface area within the selected subset of clusters (filtered by ditches and field_type) to allocate to the given system. Must be a number between 0 and 1.
ditches Ditches N/A Allocation settings integer A vector of ditch IDs (e.g., 1:26) defining the subset of clusters to be considered for allocation. Defaults to all ditches.
field_type Field type N/A Allocation settings character(1) Type of field to consider when selecting clusters. Must be one of:
  • "regular" – only regular fields
  • "tancat" – only tancats
  • "both" – all field types (default).