TUvalues (version 1.1.1)

myerson_unions: Myerson value with a priori unions

Description

Calculate the Myerson value in a communication game with a priori unions.

Usage

myerson_unions(
  characteristic_func,
  n_players = 0,
  unions,
  graph_edges,
  method = "exact",
  n_rep = 10000,
  echo = TRUE
)

Value

The Myerson value for each player.

Arguments

characteristic_func

The valued function defined on the subsets of the number of players. It can be provided as a vector or as a function.

n_players

Only used if characteristic_func is a function. The number of players in the game.

unions

List of vectors indicating the a priori unions between the players.

graph_edges

Edges of the communication graph of the game. It must be a list of pairs indicating the connected players.

method

Method used to calculate the Myerson value. Valid methods are: exact for the exact calculation or appro for approximated polynomial calculation based on sampling proposed.

n_rep

Only used if method is appro. The number of iterations to perform in the approximated calculation.

echo

Only used if method is appro. Show progress of the approximated calculation.

Examples

v <- c(
  0, 0, 0, 0,
  1, 1, 1, 0, 0, 0,
  1, 1, 1, 1,
  1
)
graph_edges <- list(c(2,3),c(3,1),c(1,4))
unions <- list(c(2,3),c(1),c(4))
myerson_unions(v, unions = unions, graph_edges = graph_edges, method = "exact")
myerson_unions(v, unions = unions, graph_edges = graph_edges, method = "appro", n_rep = 2000)