extract.data {prevR} | R Documentation |
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
.
extract.data( data, value = "ask", lang = "en", var.data = c("N.parameter", "R.parameter", "U.parameter"))
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. |
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"
.
Renvoie data
avec uniquement les observations sélectionnées.
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.
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)