maRules: Allocation rules for minimum cost arborescence problems

Description Usage Arguments Value Examples

Description

Given a graph with at least one minimum cost arborescence, the maRules function divides the cost of the arborescence among the agents according to "Bird" and "ERO" rules.

Usage

1
maRules(nodes, arcs, rule, show.data = TRUE)

Arguments

nodes

vector containing the nodes of the graph, identified by a number that goes from 1 to the order of the graph.

arcs

matrix with the list of arcs of the graph. Each row represents one arc. The first two columns contain the two endpoints of each arc and the third column contains their weights.

rule

denotes the chosen allocation rule: "Bird" or "ERO".

show.data

logical value indicating if the function displays the console output (TRUE) or not (FALSE). By default its value is TRUE.

Value

maRules returns a matrix with the agents and their costs. It also prints the result in console.

Examples

1
2
3
4
5
6
7
# Graph
nodes <- 1:4
arcs <- matrix(c(1,2,7, 1,3,6, 1,4,4, 2,3,8, 2,4,6, 3,2,6,
                 3,4,5, 4,2,5, 4,3,7), ncol = 3, byrow = TRUE)
# Allocation rules
maRules(nodes, arcs, rule = "Bird")
maRules(nodes, arcs, rule = "ERO")

Example output

Loading required package: igraph

Attaching package: 'igraph'

The following objects are masked from 'package:stats':

    decompose, spectrum

The following object is masked from 'package:base':

    union

Loading required package: optrees

 Minimum cost arborescence 
 Rule: Bird 
 ----------------
   Agent    Cost 
       2       5
       3       6
       4       4
 ----------------
      Total = 15 


 Minimum cost arborescence 
 Rule: ERO 
 ----------------
   Agent    Cost 
       2       5
       3       6
       4       4
 ----------------
      Total = 15 

cooptrees documentation built on May 2, 2019, 3:59 p.m.