R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Word-Count based methods Analysis (WordCountAna)

WordCountAna

R Documentation

Word-Count based methods Analysis (WordCountAna)

Description

Sensory methods as labelled sorting task, check-all-that-apply (CATA), ultra-flash profiling (UFP) and open-ended questions can be used to collect free-text descriptions of products through word-count based methods. A data frame with rows-products and columns-panellists is considered for the analysis. WordCountAna performs a multiple factor analysis for contingency tables keeping all the information in the comparison of the products. The identification of the consensual words which have the same meaning for most of the panellists eases the interpretation of the word-count based methods and solves the problems arising from the large diversity of vocabulary as the different meanings possibly associated to a same word. A test, based on resampling techniques, allows for assessing the significance of the consensus.

Usage

WordCountAna (base, sep.word = NULL, ncp = Inf, nb.panel = 3, nb.simul = 500, 
    proba = 0.05, graph = TRUE, axes = c(1,2))

Arguments

`base`	a data frame with n rows (products) and p columns (panellists). Each cell corresponds to a free-text description used to describe a product by a panellist
`sep.word`	a string with all the characters which correspond to separator of words (by default, NULL and is considered equal to "; (),?./:'!$=+;<>[]@-")
`ncp`	number of dimensions kept in the results and to compute the within-inertia
`nb.panel`	minimum number of panellists who used the same word in order to define consensual words (by default 3)
`nb.simul`	number of bootstrap simulations (by default 500)
`proba`	significance threshold considered to define consensual words (by default 0.05)
`graph`	boolean, if TRUE a graph is displayed
`axes`	a length 2 vector specifying the components to plot

Value

`mfact`	a list of matrices containing all the results for multiple factor analysis for contingency tables
`dist.words`	a matrix containing the results for distinct words (number of times that used and number of panellists that pronounced)
`centroids`	a matrix containing the coordinates of the centroids of distinct-words
`cons`	a matrix containing the results of bootstrap resampling for distinct-words pronounced by at least "nb.panel" panellists (number of times that used, number of panellists that pronounced and the significance of the consensus)
`cons.words`	a vector of consensual words assessed by bootstrap resampling

Returns the products factor map, panellists factor map, distinct-words factor map and consensual words factor map.

Author(s)

Belchin Kostov badriyan@clinic.ub.es, Francois Husson husson@agrocampus-ouest.fr, Monica Becue-Bertaut

References

Becue-Bertaut, M. and Pages, J. (2008). Multiple factor analysis and clustering of a mixture of quantitative, categorical and frequency data. Computational Statistice and Data Analysis, 52, 3255-3268. Kostov, B., Becue-Bertaut, M. and Husson, F. (2012). Multiple Factor Analysis for Contingency Tables in FactoMineR Package. The R journal Kostov, B., Becue-Bertaut, M., Husson, F., Pages, J., Cadoret, M., Torrens, J. and Urpi, P. (2012). A tool for detecting words with consensual meaning in verbalization tasks. 11th Sensometrics Conference, July 10-13, 2012, Rennes, France.

Examples

data(perfume)
res<-WordCountAna(base=perfume,sep.word=";")

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(SensoMineR)
Loading required package: FactoMineR
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/SensoMineR/WordCountAna.Rd_%03d_medium.png", width=480, height=480)
> ### Name: WordCountAna
> ### Title: Word-Count based methods Analysis (WordCountAna)
> ### Aliases: WordCountAna
> ### Keywords: multivariate
> 
> ### ** Examples
> 
> data(perfume)
> res<-WordCountAna(base=perfume,sep.word=";")
Error in dev.new() : no suitable unused file name for pdf()
Calls: WordCountAna -> plot.WordCountAna -> dev.new
Execution halted