Skip to contents

Get follow-up surveys from a rotating panel

Source: R/PanelSurvey.R
get_follow_up.Rd

Extracts one or more follow-up surveys (waves after the implantation) from a RotativePanelSurvey object. Follow-up surveys represent subsequent data collections and are essential for longitudinal and temporal change analysis.

Usage

get_follow_up(
  RotativePanelSurvey,
  index = seq_along(RotativePanelSurvey$follow_up)
)

Arguments

RotativePanelSurvey

A RotativePanelSurvey object from which to extract the follow-up surveys

index

Integer vector specifying which follow-up surveys to extract. Defaults to all available (1:length(follow_up)). Can be a single index or a vector of indices

Value

A list of Survey objects corresponding to the specified follow-up surveys. If a single index is specified, returns a list with one element

Details

Follow-up surveys are fundamental in rotating panels because:

  • Enable longitudinal analysis: Track the same units over time

  • Capture temporal changes: Evolution of economic, social, and demographic variables

  • Maintain representativeness: Each wave preserves population representativeness through controlled rotation

  • Optimize resources: Reuse information from previous waves to reduce collection costs

  • Facilitate comparisons: Consistent temporal structure for trend analysis

In rotating panels like ECH:

  • Each follow-up wave covers a specific period (monthly/quarterly)

  • Units rotate gradually maintaining temporal overlap

  • Indices correspond to the chronological collection order

  • Each follow-up maintains methodological consistency with implantation

See also

get_implantation for obtaining the implantation survey extract_surveys for extracting surveys by temporal criteria load_panel_survey for loading rotating panels workflow for analysis with follow-up surveys

Other panel-surveys: PoolSurvey, RotativePanelSurvey, extract_surveys(), get_implantation()

Examples

impl <- Survey$new(
  data = data.table::data.table(id = 1:5, w = 1),
  edition = "2023", type = "test", psu = NULL,
  engine = "data.table", weight = add_weight(annual = "w")
)
fu1 <- Survey$new(
  data = data.table::data.table(id = 1:5, w = 1),
  edition = "2023_01", type = "test", psu = NULL,
  engine = "data.table", weight = add_weight(annual = "w")
)
fu2 <- Survey$new(
  data = data.table::data.table(id = 1:5, w = 1),
  edition = "2023_02", type = "test", psu = NULL,
  engine = "data.table", weight = add_weight(annual = "w")
)
panel <- RotativePanelSurvey$new(
  implantation = impl, follow_up = list(fu1, fu2),
  type = "test", default_engine = "data.table",
  steps = list(), recipes = list(), workflows = list(), design = NULL
)
get_follow_up(panel, index = 1)
#> [[1]]
#> Type: TEST
#> Edition: 2023-01
#> Periodicity: Monthly
#> Engine: data.table
#> Design: 
#>   Design: Not initialized (lazy initialization - will be created when needed)
#> 
#> Steps: None
#> Recipes: None 
#> 
get_follow_up(panel)
#> [[1]]
#> Type: TEST
#> Edition: 2023-01
#> Periodicity: Monthly
#> Engine: data.table
#> Design: 
#>   Design: Not initialized (lazy initialization - will be created when needed)
#> 
#> Steps: None
#> Recipes: None 
#> 
#> [[2]]
#> Type: TEST
#> Edition: 2023-02
#> Periodicity: Monthly
#> Engine: data.table
#> Design: 
#>   Design: Not initialized (lazy initialization - will be created when needed)
#> 
#> Steps: None
#> Recipes: None 
#>