Type: Package
Title: Simply Read ASCII Single and Multicard Polling Datasets
Version: 0.9.3
Description: A convenient way to read fixed-width ASCII polling datasets from providers like the Roper Center https://ropercenter.cornell.edu.
License: MIT + file LICENSE
Encoding: UTF-8
LazyData: true
Imports: readr (≥ 1.3.1)
Suggests: knitr, rmarkdown, testthat, gdata
VignetteBuilder: knitr
RoxygenNote: 7.1.0
NeedsCompilation: no
Packaged: 2020-04-14 23:52:17 UTC; petulla
Author: Sam Petulla [aut, cre]
Maintainer: Sam Petulla <sam.petulla@gmail.com>
Repository: CRAN
Date/Publication: 2020-04-15 05:50:06 UTC

Reads Roper Center datasets

Description

Reads fixed-width ASCII roper files. Takes arguments in the format a Roper Center survey codebook provides

Usage

read_rpr(
  col_positions = NaN,
  widths = NaN,
  col_names = NaN,
  filepath = NaN,
  card_read = NaN,
  cards = NaN
)

Arguments

col_positions

starting position(s) to read

widths

width of value(s) to read

col_names

names of columns to return

filepath

data obj or filepath to read

card_read

card to read (if blank, reads a single card dataset)

cards

number of cards in dataset (if null, assumes single card)

Value

a dataframe with len(col_names) number of columns, assigned to the values of col_names

Examples

fwf_sample <- readroper_example('testMultiCard.txt')
cat(readr::read_lines(fwf_sample))
fwf_sample2 <- readroper_example('testSingleCard.txt')
cat(readr::read_lines(fwf_sample2))
# 1. Fixed width file, first card, multi-card
read_rpr(col_positions=c(1,2,4), widths=c(1,2,1),
col_names=c('V1','V2','V3'), filepath=fwf_sample, card_read=1, cards=2)
# 2 .Fixed width file, first card, single card
read_rpr(col_positions=c(1,2,4), widths=c(1,2,1),
col_names=c('V1','V2','V3'), filepath=fwf_sample2)
 # 3. Fixed width file, second card, multi-card
read_rpr(col_positions=c(1,2,4), widths=c(1,2,1),
col_names=c('V1','V2','V3'), filepath=fwf_sample, card_read=2, cards=2)


Get path to readroper example

Description

readroper comes bundled with a number of sample files in its 'inst/extdata' directory. This function make them easy to access

Usage

readroper_example(path = NULL)

Arguments

path

Name of file. If 'NULL', the example files will be listed.

Examples

readroper_example()
readroper_example('testMultiCard.txt')
readroper_example('testSingleCard.txt')