eval_match() evaluates how desirable a matching result is for a specified player.

eval_match(x, name, group = NULL, preference)

Arguments

x

An object of the "matching" class obtained by matching or matching_df().

name

A character string of the name of a player to be evaluated.

group

This argument determines whether the specified player belongs to the proposers or the proposed. If a proposing player and a proposed player have the same name, this argument must be either "proposer" or "proposed" in order to uniquely identify the player. If all players have a unique name, this can be set to NULL. Default is NULL.

preference

A vector representing the preference of the player. The first, second, third, ... element of the vector is the players' first, second, third, ... choice. For example, If the player preferes A to B to C, this argument should be c("A", "B", "C").

Value

An integer value indicating the rank of the match given their true preference. NA will be returned if there is no match.

Author

Yoshio Kamijo and Yuki Yanai yanai.yuki@kochi-tech.ac.jp