iramuteq.org Git - iramuteq/blob - Rlib/textometrieR/man/specificites.Rd

   1 \name{specificites}
   2 \alias{specificites}
   3
   4 \title{ Compute specificites association score }
   5 \description{
   6
   7  Compute specifities association score, i.e. an indicator of the association
   8  between tokens and sub-corpus, given a lexical table
   9
  10 }
  11 \usage{
  12 specificites(lexicaltable, types=NULL, parts=NULL)
  13 }
  14
  15 \arguments{
  16
  17   \item{lexicaltable}{ a complete lexical table, i.e. a numeric matrix where
  18   each line is a token and each column a part of a corpus. Each cell give the
  19   frequency of the given token in the corresponding part of the corpus. }
  20
  21   \item{types}{ Indicate for which rows the specificity index must be computed.
  22   If \code{NULL}, the specificity index is computed for every form. If
  23   \code{types} is a character vector, it indicates the name of the row of
  24   \code{lexicaltable} to be used (an error is thrown if \code{clt} has no row
  25   names). If it is an integer vector, it indicates the index of the row to be
  26   used.}
  27
  28   \item{parts}{ Indicate for which columns the specificity index must be computed.
  29   If \code{NULL}, the specificity index is computed for every part. If
  30   \code{parts} is a character vector, it indicates the name of the columns of
  31   \code{lexicaltable} to be used (an error is thrown if \code{clt} has no
  32   column names). If it is an integer vector, it indicates the index of the
  33   column to be used.}
  34
  35 }
  36
  37 \value{
  38
  39 The fonction return a matrix of \code{nrow(clt) * ncol(clt)} (the number of
  40 rows and columns may be reduced using \code{types} or \code{parts}), each cell
  41 giving the frequency index.
  42
  43 }
  44
  45 \references{
  46   Lafon P. (1980) Sur la variabilit \' e de la fr \' e quence des formes dans un corpus,
  47   Mots, 1, pp. 127--165.
  48 }
  49
  50 \author{Sylvain Loiseau}
  51
  52 \seealso{ \code{\link{specificites.probabilities}}, \code{\link{specificites.lexicon}} }
  53
  54 \examples{
  55 data(robespierre);
  56 specificites(robespierre);
  57 specificites(robespierre, types="peuple", parts=c("D9", "D10"));
  58 }