extract.data {prevR}R Documentation

Extrait les observations d'un data.frame selon une ou plusieurs conditions.

Description

Cette fonction permet d'extraire d'un data.frame les observations dont les valeurs à une ou plusieurs variables données sont égales à des valeurs passées en paramètre de la fonction.
Typiquement, cette fonction permet de sélectionner les observations correspondant à une combinaison précise des paramètres N, R et U d'un résultat de la fonction estimate.prev appelée avec merge.result = FALSE.

Usage

extract.data(
   data,
   value = "ask",
   lang = "en",
   var.data = c("N.parameter", "R.parameter", "U.parameter"))

Arguments

data data.frame. Dont on veut extraire des observations.
value character or vector. Si value="ask", la fonction liste les différentes valeurs présentes dans le fichier et propose à l'utilisateur de choisir celles qui lui conviennent. Sinon, liste des valeurs pour lesquelles on sélectionne les observations. Doit alors être de même longueur que var.data
lang character. Permet de choisir la langue des messages utilisateur. fr pour le français, en pour l'anglais.
var.data character vector. Liste des variables sur lesquelles porte la sélection.

Details

Seules sont sélectionnées les observations dont les valeurs aux variables var.data correspondent à value. Voir le tutoriel de prevR (‘tutoriel.prevR.pdf’) pour une démonstration avec value="ask".

Value

Renvoie data avec uniquement les observations sélectionnées.

Note

Cette fonction sert typiquement à sélectionner, dans les résultats de estimate.prev avec merge.result = FALSE, les observations correspondant à une combinaison donnée des trois paramètres.

Elle peut également servir à sélectionner, par exemple, les clusters ruraux ou bien les clusters appartenant à une agglomération donnée. Voir les exemples ci-dessous.

See Also

[.data.frame.

Examples

data(alicante)

## Extraction à partir d'un résultat de estimate.prev

alicante.prev <- estimate.prev(
        alicante.clust,
        N=seq(200, 300, 50),
        R=Inf,
        U=FALSE)
str(alicante.prev)
alicante.prev.n250 <- extract.data(
        alicante.prev,
        value=c(250, Inf, 0))
str(alicante.prev.n250)

## Sélection des clusters ruraux

rur <- extract.data(
        alicante.clust,
        value='Rural',
        var.data='residence')
str(rur)

## Sélection des clusters appartenant à l'agglomération urbaine de la ville A

urb.A <- extract.data(
        alicante.clust,
        value=c('in urban area','A'),
        var.data=c('urban.area','city.name'))
str(urb.A)


[Package prevR version 1.11 Index]