hipread_long | R Documentation |
Analogous to readr::read_fwf()
but allowing for
hierarchical fixed width data files (where the data file has rows of
different record types, each with their own variables and column
specifications). hipread_long()
reads hierarchical data into "long"
format, meaning that there is one row per observation, and variables
that don't apply to the current observation receive missing values.
Alternatively, hipread_list()
reads hierarchical data into "list"
format, which returns a list that has one data.frame per record type.
hipread_long( file, var_info, rt_info = hip_rt(1, 0), compression = NULL, skip = 0, n_max = -1, encoding = "UTF-8", progress = show_progress() ) hipread_list( file, var_info, rt_info = hip_rt(1, 0), compression = NULL, skip = 0, n_max = -1, encoding = "UTF-8", progress = show_progress() )
file |
A filename |
var_info |
Variable information, specified by either |
rt_info |
A record type information object, created by |
compression |
If |
skip |
Number of lines to skip at the start of the data (defaults to 0). |
n_max |
Maximum number of lines to read. Negative numbers (the default) reads all lines. |
encoding |
(Defaults to UTF-8) A string indicating what encoding to use when reading the data, but like readr, the data will always be converted to UTF-8 once it is imported. Note that UTF-16 and UTF-32 are not supported for non-character columns. |
progress |
A logical indicating whether progress should be
displayed on the screen, defaults to showing progress unless
the current context is non-interactive or in a knitr document or
if the user has turned off readr's progress by default using
the option |
A tbl_df
data frame
# Read an example hierarchical data.frame into long format data <- hipread_long( hipread_example("test-basic.dat"), list( H = hip_fwf_positions( c(1, 2, 5, 8), c(1, 4, 7, 10), c("rt", "hhnum", "hh_char", "hh_dbl"), c("c", "i", "c", "d") ), P = hip_fwf_widths( c(1, 3, 1, 3, 1), c("rt", "hhnum", "pernum", "per_dbl", "per_mix"), c("c", "i", "i", "d", "c") ) ), hip_rt(1, 1) ) # Read an example hierarchical data.frame into list format data <- hipread_list( hipread_example("test-basic.dat"), list( H = hip_fwf_positions( c(1, 2, 5, 8), c(1, 4, 7, 10), c("rt", "hhnum", "hh_char", "hh_dbl"), c("c", "i", "c", "d") ), P = hip_fwf_widths( c(1, 3, 1, 3, 1), c("rt", "hhnum", "pernum", "per_dbl", "per_mix"), c("c", "i", "i", "d", "c") ) ), hip_rt(1, 1) ) # Read a rectangular data.frame data_rect <- hipread_long( hipread_example("test-basic.dat"), hip_fwf_positions( c(1, 2), c(1, 4), c("rt", "hhnum"), c("c", "i") ) )
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.