spsurvey (version 4.1.4)

panel_summary: Summary Characteristics of a Revisit Panel Design

Description

Revisit panel design characteristics are summarized: number of panels, number of time periods, total number of sample events for the revisit design, total number of sample events for each panel, total number of sample events for each time period and cumulative number of unique units sampled by time periods.

Usage

panel_summary(paneldsgn, visitdsgn = NULL)

Arguments

paneldsgn

Two-dimensional array with dimnames specifying revisit panel design. Typically, array is output from revisit_dsgn, revisit_bibd or revisit_rand functions.

visitdsgn

Two-dimensional array with same dimensions as paneldsgn specifying the number of times a sample unit is sampled at each time period. Default is visitdsgn=NULL, where default assumes that a sample unit will be sampled only once at each time period.

Value

List of six elements.

• n.panel - number of panels in revisit design

• n.period - number of time periods in revisit design

• n.total - total number of sample events across all panels and all time periods, accounting for visitdsgn, that will be sampled in the revisit design

• n.periodunit - Vector of the number of time periods a unit will be sampled in each panel

• n.unitpnl - Vector of the number of sample units, accounting for visitdsgn, that will be sampled in each panel

• n.unitperiod - Vector of the number of sample units, accounting for visitdsgn, that will be sampled during each time period

• ncum.unit - Vector of the cumulative number of unique units that will be sampled in time periods up to and including the current time period.

Details

The revisit panel design and the visit design (if present) are summarized. Summaries can be useful to know the effort required to complete the survey design. See the values returned for the summaries that are produced.

See Also

revisit_dsgn

create a panel revisit design

revisit_bibd

create a balanced incomplete block panel revisit design

revisit_rand

create a revisit design with random assignment to panels and time periods

power.dsgn

power calculation for multiple panel designs

cov.panel.dsgn

covariance matrix for a panel design

plot_powerpaneldesign

plot power curves for panel designs

Examples

# NOT RUN {
# Serially alternating panel revisit design summary
sa.dsgn <- revisit_dsgn(20, panels=list(SA60N=list(n=60, pnl_dsgn = c(1, 4),
                        pnl_n=NA, start_option="None")), begin=1 )
panel_summary(sa.dsgn)

# Add visit design where first panel is sampled twice at every time period
sa.visit <- sa.dsgn
sa.visit [sa.visit > 0] <- 1
sa.visit [1, sa.visit[1,] > 0] <- 2
panel_summary(sa.dsgn, sa.visit)

# }