File: couple.Rd

package info (click to toggle)
r-cran-kernlab 0.9-33-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,216 kB
  • sloc: cpp: 6,011; ansic: 935; makefile: 2
file content (62 lines) | stat: -rw-r--r-- 2,002 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
\name{couple}
\alias{couple}

\title{Probabilities Coupling function}
\description{
  \code{couple} is used to link class-probability estimates produced by
   pairwise coupling  in multi-class classification problems.
}
\usage{
couple(probin, coupler = "minpair")
}

\arguments{
  \item{probin}{ The pairwise coupled class-probability estimates}
  \item{coupler}{The type of coupler to use. Currently \code{minpar} and
    \code{pkpd} and \code{vote} are supported (see reference for more
    details).
  If \code{vote} is selected the returned value is a primitive estimate
  passed on given votes.}
  
}
\details{
  As binary classification problems are much easier to solve many
  techniques exist to decompose multi-class classification problems into
  many binary classification problems (voting, error codes,
  etc.). Pairwise coupling (one against one) constructs a rule for
  discriminating between every pair of classes and then selecting the
  class
  with the most winning two-class decisions. 
   By using Platt's probabilities output for SVM one can get a class
   probability for each of the \eqn{k(k-1)/2} models created in the pairwise 
   classification. The couple method implements various techniques to combine
   these probabilities.    
}
\value{
  A matrix with the resulting probability estimates. 
}
\references{
  Ting-Fan Wu, Chih-Jen Lin, ruby C. Weng\cr
  \emph{Probability Estimates for Multi-class Classification by Pairwise
    Coupling}\cr
  Neural Information Processing Symposium 2003 \cr
  \url{https://papers.neurips.cc/paper/2454-probability-estimates-for-multi-class-classification-by-pairwise-coupling.pdf}
  }
\author{Alexandros Karatzoglou \cr \email{alexandros.karatzoglou@ci.tuwien.ac.at} }


 

\seealso{ \code{\link{predict.ksvm}}, \code{\link{ksvm}}}
\examples{
## create artificial pairwise probabilities
pairs <- matrix(c(0.82,0.12,0.76,0.1,0.9,0.05),2)

couple(pairs)

couple(pairs, coupler="pkpd")

couple(pairs, coupler ="vote")
}
\keyword{classif}