ecoval.river.create {ecoval}

Creates a Value Function for Ecological River Assessment

Description

Creates a value function for ecological river assessment based on physical, chemical and biological sub-objectives.

Usage

ecoval.river.create(phys = list(msk.morphol.1998.create,
                                msk.physapp.2007.create),
                    physagg      = "utility.aggregate.addmin",
                    physpar      = numeric(0),
                    chem         = list(msk.nutrients.2010.create,
                                        val.micropoll.create,
                                        val.heavymetals.create),
                    chemagg      = "utility.aggregate.addmin",
                    chempar      = numeric(0),
                    biol         = list(msk.diatoms.2007.create,
                                        val.invertebrates.create,
                                        msk.fish.2004.create),
                    biolagg      = "utility.aggregate.addmin",
                    biolpar      = numeric(0),
                    ecolagg      = "utility.aggregate.addmin",
                    ecolpar      = numeric(0),
                    language     = "English",
                    dictionaries = NA,
                    col          = "black")

Arguments

phys

List containing either functions to create branches of the value function or already branches of value functions corresponding to physical sub-objectives. These branches (produced by the function or given directly) must be in the form of a value function definition as provided by the package utility.

physagg

Name of the function to be used for aggregating the value function branches specified in the argument phys.

physpar

Vector of parameters (often weights) provided to the aggregation function (provided by the argument physagg).

chem

List containing either functions to create branches of the value function or already branches of value functions corresponding to chemical sub-objectives. These branches (produced by the function or given directly) must be in the form of a value function definition as provided by the package utility.

chemagg

Name of the function to be used for aggregating the value function branches specified in the argument chem.

chempar

Vector of parameters (often weights) provided to the aggregation function (provided by the argument chemagg).

biol

List containing either functions to create branches of the value function or already branches of value functions corresponding to biological sub-objectives. These branches (produced by the function or given directly) must be in the form of a value function definition as provided by the package utility.

biolagg

Name of the function to be used for aggregating the value function branches specified in the argument biol.

biolpar

Vector of parameters (often weights) provided to the aggregation function (provided by the argument biolagg).

ecolagg

Name of the function to be used to aggregate the physical, chemical, and biological values.

ecolpar

Parameter vector passed to the function specified under ecolpar.

language

Language to be used to denote nodes, attributes and attribute levels. Must be a column name of the table provided by the second argument.

dictionaries

Matrix of dictionaries with the languages provided by the column names and the original words provided as the row names. If dictionary is NA, the default dictionary ecoval.dictionaries.default is loaded.

col

Color of bounding boxes in objectives hierarchy.

Value

The function returns the value function as a class utility.

References

Langhans, S.D., Lienert, J., Schuwirth, N. and Reichert, P. How to make river assessments comparable: A demonstration for hydromorphology, Ecological Indicators 32, 264-275, 2013. doi: 10.1016/j.ecolind.2013.03.027

Langhans, S.D., Reichert, P. and Schuwirth, N. The method matters: indicator aggregation in ecological river assessment. Ecological Indicators 45, 494-507, 2014. doi: 10.1016/j.ecolind.2014.05.014

Reichert, P., Schuwirth, N. and Langhans, S. Constructing, evaluating and visualizing value and utility functions for decision support, Environmental Modelling & Software 46, 283-291, 2013. doi: 10.1016/j.envsoft.2013.01.017

Reichert, P., Borsuk, M., Hostmann, M., Schweizer, S., Sporri, C., Tockner, K. and Truffer, B. Concepts of decision support for river rehabilitation, Environmental Modelling and Software 22, 188-201, 2007. doi: 10.1016/j.envsoft.2005.07.017

https://modul-stufen-konzept.ch

See Also

utility.

Examples

ecol <- ecoval.river.create()
plot(ecol)
ecol.german <- ecoval.river.create(language="Deutsch")
plot(ecol.german)