The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.
chemdose_toc() gains reuse-water models from Wilder
& Korak (2025) for aluminum coagulants.biofilter_toc() gains reuse and ATP-based models from
Peterson & Summers (2021) and Terry et al. (2024).chemdose_ph() now supports polyaluminum chloride and
citric acid. chemdose_toc() now supports ACH and PACl.define_water() gains no2 (nitrite, mg/L as
N) and tot_citric (citric acid) arguments.water class gains a co2 slot
(dissolved CO2, H2CO3*, in mg/L as CO2). It is calculated from
h2co3.convert_units() supports mg/L as P and mg/L as Cl2.
Start and end units and formulas allow for “close enough” spellings (eg;
case insensitive, with or without spaces and slashes, etc).
formula is optional when converting within the same unit
type (e.g. mg/L to g/L).scavenge_oh() calculates the background OH radical
scavenging term for UV/AOP.chemdose_inorgdemand() calculates the free chlorine
residual after the inorganic chlorine demand of Mn, Fe, and
ammonia.check_water() contains many of the warnings that were
previously included in define_water(). The warnings were
cumbersome and often ignored, so this function provides a way to
deliberately evaluate how a water quality is defined.convert_flow() for unit conversions involving flow
rates.define_chemical() function and new
chemical class are the starting point for better units
handling of chemicals, but are not yet incorporated into other
functions.chemdose_ph_df() and the other
chemdose_*_df() functions gain keep_dose_cols
(default FALSE), which drops the dose columns from the
output to prevent double dosing downstream.solvemass_solids() has been revamped - both inputs and
outputs have changed and the underlying calculation is now based
directly on stoichiometry.regulate_toc() has been revamped - both inputs and
outputs have changed.convert_units() now correctly converts through moles of
the formula, which changes some results: mg/L as CaCO3 to or from M or
eq/L now uses the formula’s charge. Monovalent ions were previously off
by a factor of 2 (e.g. 50 mg/L as CaCO3 of HCO3 is now 1 mM, not 0.5
mM). Divalent conversions like hardness and alkalinity are unchanged.
mg/L as N counts N atoms per formula, so (NH4)2SO4 is 2 N.define_water() now warns and sets carbonate species to
0 when alk is less than the non-carbonate alkalinity
(e.g. hydroxide at high pH). Previously, negative carbonate alkalinity
could be carried through. Argument tot_bo3 is now
tot_bo4, and the bo3 and tot_bo3
slots are replaced by h3bo3, h4bo4, and
tot_bo4.K_temp_adjust()
using the van ’t Hoff equation, assuming a constant enthalpy of 55,830
J/mol for H2O -> H+ + OH-. It previously used a rounded empirical
formula; pH results change slightly at temperatures other than 25
C.chemdose_chloramine() previously stored free ammonia in
the tot_nh3 slot. The slot now correctly holds total
ammonia.chemdose_chlordecay() with
use_chlorine_slot = TRUE now reads the chlorine slot as
Cl2, not Cl, so the slot counts at its full value. The free chlorine
residual is also clamped at 0 and no longer goes negative.solvect_chlorine() now correctly converts the
free_chlorine slot from mol/L to mg/L as Cl2 when
free_cl_slot = "slot_only" or
"sum_with_residual". CT was previously about 5 orders of
magnitude too low.dissolve_cu() now correctly uses orthophosphate in mg/L
as PO4; it previously used mol/L, so orthophosphate had almost no
effect. Results with orthophosphate are now lower (e.g. 2 mg/L PO4
lowers copper by about 33%).gacbv_toc() now correctly looks up bed volume at C/C0 =
target_doc / doc.balance_ions() now includes Fe, Al, Mn, F, and Br.chemdose_ph() now accounts for borate and
silicate.solveresid_o3() returns 0 instead of a negative
residual when ozone demand exceeds the dose, so
solvect_o3() no longer returns negative CT.gacrun_toc(), gac_toc(), and
gacbv_toc() now use influent DOC, not TOC. Both the Zachman
and WTP models are written in terms of TOC, but GAC influent is normally
coagulated and filtered water, where TOC = DOC.pac_toc() corrections at low DOC and UV254.convert_watermg() returns tot_sio4 in mg/L
as SiO2, matching define_water() input.modify_water() now converts TOC, DOC, and BDOC entered
in ug/L and DBPs entered in mg/L correctly. Both conversions were
inverted. It also accepts tbaa and no longer lists the
nonexistent baa slot.modify_water_df() now applies slot,
value, and units passed as constants. Before,
they were silently ignored and the water was returned unchanged. It now
errors when a column it needs is missing.opensys_ph() widens its CO2 search when more than 100
mg/L of CO2 has to be removed or added, instead of failing with a
uniroot() error. If no equilibrium dose is found, it gives
a clear error.solvedose_alk() no longer lists or accepts
chemical = "co2", since CO2 doesn’t change alkalinity. It
now errors with “Selected chemical addition is not supported” instead of
a uniroot() error.define_water_df() now maps columns to
define_water() arguments by name._df functions are reported once with the number of rows
affected._df replace chain and
once functions. Use pluck_cols = TRUE to mimic
once behavior, although it will always return a water
column as well.solvect_chlorine based on
the EPA Guidance Manual Table E-7 (1991)modify_water can now modify multiple water slots at
once. Note that in order to modify multiple slots using
modify_water_df, all input arguments must be included as a
list.chemdose_ph. In
addition to changing pH, dosing acetic acid will also update TOC and DOC
of the input water.regulate_toc now available for calculating TOC removal
compliancegacrun_toc, gac_toc, and
gacbv_toc added to predict TOC removal from GAC treatment
using either the EPA WTP model (2001) or the Zachman and Summers (2018)
model. Different functions provide different output types: a data frame
of the TOC breakthrough curve, a new water with updated TOC, DOC, and
UV254 water slots, or the necessary bed volumes to stay below the target
effluent TOC. See individual functions for documentation.pluck_water and _df helpers sped up by
relying on base R instead of purrrchemdose_toc can now account for doc removal due to
lime softening from the WTP Model (2001). To implement, use the
caoh2 argument.opensys_ph added to predict pH and alkalinity
of an input water in an open carbonate system at equilibriumplot_lead added to graph the pH vs DIC
contour plot for lead solubilityalk and
alk_eq represent the total alkalinity, and individual
alkalinities due to carbonate, phosphate, ammonium, borate, silicate,
and hypochlorite have been added as individual slots (eg.
carbonate_alk_eq)._chain and _once functions have been
deprecated. Replace with _df functions. Code should be
similar, but has slightly different outputs.output_water = "defined",
old default output_water = "defined_water". See function
documentation for new defaults.alk) now accounts for phosphate,
silicate, borate, hypochlorite, and ammonia. Could have a minor impact
on final pH and alkalinity calculations in waters with those
compounds.|>chemdose_ph chemicals: CaOCl2, CaSO4, HNO3, KMnO4,
NaF, and Na3PO4dissolve_cu predicts the concentration of
copper given pH, DIC, and phosphate based on the empirical model
described in Lytle et al. (2018). dissolve_cu_once can also
predict copper for waters in a data frame.chemdose_dbp can now input custom fitting coefficients
as a data framechemdose_ph_once and chemdose_toc_once are
back and only return relevant waters slots in its output.decarbonate_ph: function to remove CO2 (H2CO3) from a
water and determine the new pH (and division of ions)modify_water: function to modify individual slots in a
water that handles unit conversionsapplied_treatment slot removed from water. Was not
providing any benefit and added complexity. Should be the responsibility
of the user to track.h2co3 slot added to water class calculated
based on {H} and total carbonate.chemdose_ph warns when ion water slots aren’t updated
due to NA slots.solvedose_ph updated search range to allow for more
water qualities without erroring. Updated search process results in
slightly different outputs._toc functions are DOC-based and previously assumed no
particulate TOC removal. In reality, virtually all particulate TOC is
removed with other particulates, so models have been updated to return
TOC = DOCchemdose_toc custom coeff now accepts a data frame
instead of a named listwater class.calculate_corrosion now outputs a data frame with the
corrosion indices as columns. calculate_corrosion_chain
removed because the base function has a numeric output.calculate_corrosion updated CCPP search range to allow
for more water qualities without erroring.solvect_o3 and solveresid_o3 now return
zero instead of NaN when the input dose is zerochemdose_chloramine warnings.calculate_corrosion expanded CCPP search range (fewer
errors)_chain and _once)
behavior change: can now specify column name unquoted (eg, alum =
AlumDose)_once) helper functions because the
desired output is almost never all water slots as columns. Refer to
pluck_water(parameter = "all") for same behavior.pac_toc now constrained to accept a smaller range of
doses and times. The form of the equation was allowing negative TOC
outputs.define_water, chemdose_ph,
blend_waters, and other pH related functions slightly
impacted by a fix in concentration vs activity. Previous code assumed pH
= 10^-[H+], code has been corrected to pH = 10^-{H+}define_waterconvert_unitschemdose_chloramine: chloramine formation model given
chlorine, ammonia, timechemdose_chlordecay now has argument,
use_chlorine_slot. Function can now use chlorine dose
and/or free_chlorine or combined_chlorine slots.chemdose_chlordecaycombined_chlorine, nh2cl, nhcl2,
ncl3solvemass_solids separates functionality from
solvecost_solids to solve lb/daybiofilter_toc, chemdose_chlordecay,
ozonate_bromate, and solvect helpers now
available.chemdose_ct renamed solvect_chlorineozonate_ct renamed solvect_o3tot_ocl slot in water renamed
free_chlorinedefine_water argument changes: tot_ocl
changed to free_chlorine, added
combined_chlorine_chain and _once)
behavior change: if multiple values are specified for multiple
arguments, all combinations are used.plandefine_water now has arguments for “ca” and “mg” and no
longer has “ca_hard”.summarize_dbp and summarize_corrosion
removed. summarize_wq now takes arguments to summarize
general, ions, dbps, or corrosionchemdose_toc and
matching _chain and _once helper
functions.chemdose_dbp. No helper
functions yet except summarise_dbpcalculate_corrosion
and summarise_corrosion with helper functions.dissolve_pb with helper
functions.pluck_water to pull one slot from a
water column in a data frame.water class and define_water
to handle more water quality parameters.balance_ions and
chemdose_ph_chain and _once for
applying models to data frames.These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.