BIFIEsurvey (version 3.5-19)

BIFIE.hist: Histogram

Description

Computes a histogram with same output as in graphics::hist. Statistical inference is not conducted for this method.

Usage

BIFIE.hist( BIFIEobj, vars, breaks=NULL, group=NULL, group_values=NULL  )
# S3 method for BIFIE.hist
summary(object,...)
# S3 method for BIFIE.hist
plot(x,ask=TRUE,...)

Value

A list with following entries

histobj

List with objects of class histogram

output

More extensive output

...

More values

Arguments

BIFIEobj

Object of class BIFIEdata

vars

Vector of variables for which statistics should be computed.

breaks

Optional vector of breaks. Otherwise, it will be automatically defined.

group

Optional grouping variable(s)

group_values

Optional vector of grouping values. This can be omitted and grouping values will be determined automatically.

object

Object of class BIFIE.hist

x

Object of class BIFIE.hist

ask

Optional logical whether it should be asked for new plots.

...

Further arguments to be passed

See Also

graphics::hist

Examples

#############################################################################
# EXAMPLE 1: Imputed TIMSS dataset
#############################################################################

data(data.timss1)
data(data.timssrep)

# create BIFIE.dat object
bifieobj <- BIFIEsurvey::BIFIE.data( data.list=data.timss1, wgt=data.timss1[[1]]$TOTWGT,
           wgtrep=data.timssrep[, -1 ] )

# histogram
res1 <- BIFIEsurvey::BIFIE.hist( bifieobj, vars="ASMMAT", group="female" )
# plot histogram for first group (female=0)
plot( res1$histobj$ASMMAT_female0, col="lightblue")
# plot both histograms after each other
plot( res1 )

# user-defined vector of breaks
res2 <- BIFIEsurvey::BIFIE.hist( bifieobj, vars="ASMMAT",
              breaks=seq(0,900,10), group="female" )
plot( res2, col="orange")