Package: cvasi 1.5.1

Nils Kehrein

cvasi: Calibration, Validation, and Simulation of TKTD Models

Eases the use of ecotoxicological effect models. Can simulate common toxicokinetic-toxicodynamic (TK/TD) models such as General Unified Threshold models of Survival (GUTS) and Lemna. It can derive effects and effect profiles (EPx) from scenarios. It supports the use of 'tidyr' workflows employing the pipe symbol. Time-consuming tasks can be parallelized.

Authors:Nils Kehrein [aut, cre], Dirk Nickisch [aut], Peter Vermeiren [aut], Torben Wittwer [ctb], Johannes Witt [ctb], Andre Gergs [ctb]

cvasi_1.5.1.tar.gz
cvasi_1.5.1.zip(r-4.7-x86_64)cvasi_1.5.1.zip(r-4.7-arm64)cvasi_1.5.1.zip(r-4.6-x86_64)cvasi_1.5.1.zip(r-4.6-arm64)cvasi_1.5.1.zip(r-4.5-x86_64)
cvasi_1.5.1.tgz(r-4.6-x86_64)cvasi_1.5.1.tgz(r-4.6-arm64)cvasi_1.5.1.tgz(r-4.5-x86_64)cvasi_1.5.1.tgz(r-4.5-arm64)
cvasi_1.5.1.tar.gz(r-4.7-arm64)cvasi_1.5.1.tar.gz(r-4.7-x86_64)cvasi_1.5.1.tar.gz(r-4.6-arm64)cvasi_1.5.1.tar.gz(r-4.6-x86_64)
cvasi_1.5.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
cvasi/json (API)

# Install 'cvasi' in R:
install.packages('cvasi', repos = c('https://cvasi-tktd.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/cvasi-tktd/cvasi/issues

Datasets:
  • americamysis - A DEB abj scenario of Americamysis bahia
  • dmagna - A DEBtox scenario of Daphnia magna
  • focusd1 - A Lemna_SETAC scenario with variable environment
  • metsulfuron - Lemna model fitted to _metsulfuron_ effect data
  • minnow_it - A fitted GUTS-RED-IT scenario of the fathead minnow
  • minnow_sd - A fitted GUTS-RED-SD scenario of the fathead minnow
  • ringtest_c - EFSA Ringtest Dataset C
  • ringtest_it - EFSA Ringtest Dataset A SD
  • ringtest_sd - EFSA Ringtest Dataset A SD
  • rsubcapitata - A Weber scenario of algae exposed to isoproturon
  • schmitt2013 - A Lemna effect study data set with multiple treatment levels

On CRAN:

Conda:

ecotoxicologymodelingsimulation

5.65 score 5 stars 15 scripts 465 downloads 94 exports 50 dependencies

Last updated from:4f9cbd39fe. Checks:15 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK209
linux-devel-x86_64OK218
source / vignettesOK283
linux-release-arm64OK167
linux-release-x86_64OK184
macos-release-arm64OK265
macos-release-x86_64OK356
macos-oldrel-arm64OK228
macos-oldrel-x86_64OK458
windows-devel-arm64OK419
windows-devel-x86_64OK211
windows-release-arm64OK425
windows-release-x86_64OK156
windows-oldrel-x86_64OK149
wasm-releaseOK108

Exports:%>%Algae_SimpleAlgae_TKTDAlgae_Weberbatchcache_controlscalibrateCalibrationSetcalisetci_from_hessianDEB_abjDEB_DaphniaDEBtoxdiagnosticsdose_responseeffectepxepx_mtwexplore_spaceExposureSeriesfit_growthfit_tktdfxget_modelget_model_nameget_paramget_tagget_timesGUTS_RED_ITGUTS_RED_SDGUTS_SDimport_morseimport_swashimport_toxswais_debis_DEBis_gutsis_GUTSis_guts_itis_GUTS_ITis_guts_sdis_GUTS_SDis_lemnais_Lemnais_LemnaThresholdis_scenarioLemna_SchmittLemna_SchmittTholdLemna_SETAClik_profilelog_disablelog_enablelog_envirlog_liklog_msglog_scenariosMagmamorseMyrioMyrio_logno_exposurenum_infoparameter_setpll_debugplot_epxplot_lik_profileplot_param_spaceplot_ppcplot_scenarioplot_sdpull_metadataSamXsequenceset_boundsset_endpointsset_exposureset_forcingsset_initset_moaset_mode_of_actionset_noexposureset_notransferset_nowindowset_paramset_tagset_timesset_transferset_windowsimulatesimulate_batchsolversurvivaltd2cstox_data

Dependencies:clicodetoolscpp11crayondeSolvedigestdplyrfarverforcatsfurrrfuturegenericsGGallyggplot2ggstatsglobalsgluegridExtragtablehmsisobandlabelinglifecyclelistenvlubridatemagrittrparallellypatchworkpillarpkgconfigprettyunitsprogresspurrrR6RColorBrewerRcpprlangS7scalesstringistringrtibbletidyrtidyselecttimechangeunitsutf8vctrsviridisLitewithr

Modeling Howto
How to access scenario properties | Using tidyr syntax | Predictions | Moving exposure windows | Simulating biomass transfers | Fitting model parameters | Obtaining confidence intervals for parameters | Assessing parameter correlations and identifiability | Changes in parameter values over time | Decrease assessment runtime | Implementing custom models | Complete working example | Setting up a scenario | Simulating a scenario and plotting

Last update: 2025-09-11
Started: 2024-05-03

User Manual
Required skills | How to install | Modeling and assessment workflow | Overview | Setting up a scenario | Running a simulation | Deriving assessment endpoints | Data format of model inputs | How to derive model inputs | Description of model outputs | Simulation results | Effect levels | Effect profiles | References

Last update: 2025-08-21
Started: 2024-05-03

Readme and manuals

Help Manual

Help pageTopics
Simple algae model without environment (Rendal et al. 2023)AlgaeSimple-class AlgaeSimpleScenario-class Algae_Simple
Algae model variant (Weber et al. 2012) with scaled damageAlgaeTKTD-class AlgaeTKTDScenario-class Algae_TKTD
Algae model, _SAM-X_ (Weber et al. 2012)AlgaeWeber-class AlgaeWeberScenario-class Algae_Weber SAM-X SamX
Algae modelsAlgae-class Algae-models
A DEB abj scenario of Americamysis bahiaamericamysis
Batch simulation of multiple exposure levelsbatch
Cache control simulationscache_controls
Fit model parameters to experimental datacalibrate calibrate,CalibrationSet-method calibrate,EffectScenario-method calibrate,list-method calibrate,ScenarioSequence-method
Calibration setCalibrationSet CalibrationSet-class caliset
Parameter confidence intervals from fitci_from_hessian
DEB_abjDebAbj-class DEB_abj
Dynamic Energy Budget (DEB) modelsDeb-class DEB-models
DEBtox modelDebDaphnia-class DEBtox DebTox-class DEBtox2019 DEB_Daphnia
Diagnostics of solversdiagnostics diagnostics.cvasi_simulate diagnostics.default
A DEBtox scenario of Daphnia magnadmagna
Calculate a dose response curvedose_response
Effect leveleffect effect,EffectScenario-method effect,ScenarioSequence-method
Effect profiles (EPx values)epx
Calculate EPx values for a series of moving time windowepx_mtw
Explore parameter spaceexplore_space
Exposure time-seriesExposureSeries ExposureSeries-class NoExposureSeries-class
Fit growth parametersfit_growth fit_growth,ANY,ANY-method fit_growth,EffectScenario,ANY-method fit_growth,LemnaSchmitt,missing-method fit_growth,LemnaSetac,missing-method fit_growth,list,missing-method fit_growth,Magma,missing-method fit_growth,ScenarioSequence,ANY-method
Fit TK/TD parametersfit_tktd fit_tktd,ANY,ANY-method fit_tktd,CalibrationSet,ANY-method fit_tktd,CalibrationSet,missing-method fit_tktd,cvasi_fit,ANY-method fit_tktd,EffectScenario,ANY-method fit_tktd,LemnaSchmitt,missing-method fit_tktd,LemnaSetac,missing-method fit_tktd,list,missing-method fit_tktd,Magma,missing-method fit_tktd,ScenarioSequence,ANY-method
A Lemna_SETAC scenario with variable environmentfocusd1
Generic to calculate effects for a particular scenariofx fx,Algae-method fx,ANY-method fx,GutsIt-method fx,GutsRedIt-method fx,GutsRedSd-method fx,GutsSd-method fx,Lemna-method fx,Magma-method fx,ScenarioSequence-method
Get model nameget_model get_model,ANY-method get_model,EffectScenario-method get_model,list-method get_model,ParameterSet-method get_model_name
Get scenario parametersget_param get_param,ANY-method get_param,EffectScenario-method get_param,list-method get_param,ParameterSet-method get_param,ScenarioSequence-method
Get scenario tagget_tag get_tag,ANY-method get_tag,EffectScenario-method get_tag,list-method get_tag,ParameterSet-method get_tag,ScenarioSequence-method
Get output timesget_times get_times,ANY-method get_times,EffectScenario-method get_times,list-method get_times,ScenarioSequence-method
GUTS-IT scenarioGUTS-IT GutsIt-class GUTS_IT
GUTS-RED-IT scenarioGUTS-RED-IT GutsRedIt-class GUTS_RED_IT
GUTS-RED-SD scenarioGUTS-RED-SD GutsRedSd-class GUTS_RED_SD
GUTS-SD scenarioGuts-class GUTS-SD GutsSd-class GUTS_SD
GUTS-RED modelsGUTS-RED-models
Import 'morse' model parametersimport_morse morse
SWASH project exposure profile importimport_swash
Import _TOXSWA_ exposure seriesimport_toxswa
Test if argument is a DEB scenariois_DEB is_deb
Test if argument is a GUTS scenariois_GUTS is_guts is_GUTS_IT is_guts_it is_GUTS_SD is_guts_sd
Test if argument is a Lemna scenariois_Lemna is_lemna
Test if argument is a LemnaThreshold scenariois_LemnaThreshold
Test if argument is an effect scenariois_scenario
Lemna model (Schmitt et al. 2013)LemnaSchmitt-class LemnaSchmittScenario-class Lemna_Schmitt Lemna_SchmittThold
Lemna model v1.3 (Klein et al. 2021)LemnaSetac-class LemnaSetacScenario-class Lemna_SETAC
Lemna modelsLemna-class Lemna-models
Likelihood profilinglik_profile
Start and stop logginglog_disable log_enable
Log R environment propertieslog_envir
Calculate log likelihoodlog_lik
Add a log messagelog_msg
Log scenario propertieslog_scenarios
Macrophyte modelsMacrophyte-models
Magma model (Witt et al., submitted)Magma Myrio Myrio_log
Magma scenario classMagma-class
Lemna model fitted to _metsulfuron_ effect datametsulfuron
A fitted GUTS-RED-IT scenario of the fathead minnowminnow_it
A fitted GUTS-RED-SD scenario of the fathead minnowminnow_sd
Zero exposureno_exposure
Print information about numerical solver resultnum_info num_info.cvasi_fit num_info.cvasi_simulate num_info.default
Set of model parametersParameterSet-class parameter_set parameter_set-class
Disable parallelization for debuggingpll_debug
S3 plotting functionsplot plot.cvasi_drc plot.cvasi_simulate plot.lik_profile plot_lik_profile
Plot EPx valuesplot_epx
Creates a PPC plot for a single datasetplot_ppc
Create PPC plot for one or more datasetsplot_ppc_combi
Creates a prediction plot for one effect scenarioplot_scenario
Creates plot of model results (uncertainties optional)plot_sd
Plot profiled parameter spaceplot.param_space plot_param_space
Pull metadata from scenariospull_metadata
EFSA Ringtest Dataset Cringtest_c
EFSA Ringtest Dataset A SDringtest_it
EFSA Ringtest Dataset A SDringtest_sd
A Weber scenario of algae exposed to isoproturonrsubcapitata
Effect scenario classesEffectScenario-class scenario Scenarios scenarios
A Lemna effect study data set with multiple treatment levelsschmitt2013
Sequence of scenariosScenarioSequence-class sequence
Extract and replace elements of a sequencelength,ScenarioSequence-method sequence.extract [,ScenarioSequence,numeric,missing,missing-method [[,ScenarioSequence,numeric-method [[<-,ScenarioSequence,numeric,ANY,ANY-method [[<-,ScenarioSequence,numeric,missing,EffectScenario-method
Set boundaries of model parametersset_bounds set_bounds,CalibrationSet,list-method set_bounds,EffectScenario,list-method set_bounds,list,list-method set_bounds,ScenarioSequence,list-method
Set effect endpointsset_endpoints
Set exposure time-seriesset_exposure set_exposure,ANY,ANY-method set_exposure,EffectScenario,data.frame-method set_exposure,EffectScenario,ExposureSeries-method set_exposure,EffectScenario,list-method set_exposure,EffectScenario,NoExposureSeries-method set_exposure,list,ANY-method set_exposure,list,list-method set_exposure,ScenarioSequence,ANY-method
Set time-dependent parametersset_forcings set_forcings,EffectScenario-method set_forcings,list-method
Set initial stateset_init set_init,EffectScenario-method set_init,ScenarioSequence-method set_init,vector-method
Set mode of actionset_moa set_mode_of_action
Set zero exposureset_noexposure
Set scenario parametersset_param set_param,CalibrationSet,ANY-method set_param,EffectScenario,ParameterSet-method set_param,EffectScenario,vector-method set_param,list,ParameterSet-method set_param,list,vector-method set_param,ScenarioSequence,ANY-method
Set a tagset_tag
Set output timesset_times set_times,ANY-method set_times,EffectScenario-method set_times,list-method set_times,ScenarioSequence-method
Set transfer eventsset_notransfer set_transfer set_transfer,ANY-method set_transfer,Transferable-method
Set window lengthset_nowindow set_window
Simulate an effect scenariosimulate simulate,EffectScenario-method simulate,ScenarioSequence-method simulate,SimulationBatch-method simulate,Transferable-method
Batch simulation using multiple exposure seriessimulate_batch
Calls ODE solver for a particular modelsolver solver,AlgaeSimple-method solver,AlgaeTKTD-method solver,AlgaeWeber-method solver,ANY-method solver,DebAbj-method solver,DebDaphnia-method solver,DebTox-method solver,GutsIt-method solver,GutsRedIt-method solver,GutsRedSd-method solver,GutsSd-method solver,LemnaSchmitt-method solver,LemnaSetac-method solver,Magma-method
Survival ratesurvival
Create _calisets_ from _tox_data_td2cs
Prepare ecotox study data for fittingToxData-class tox_data
Biomass transfer classBiomass-transfer Transferable Transferable-class