swim_parse_hytek {SwimmeR} | R Documentation |
Formats Hytek style swimming and diving data read with read_results
into a data frame
Description
Takes the output of read_results
and cleans it, yielding a data frame
of swimming (and diving) results
Usage
swim_parse_hytek(
file_hytek,
avoid_hytek = avoid,
typo_hytek = typo,
replacement_hytek = replacement,
format_results = TRUE,
splits = FALSE,
split_length_hytek = split_length,
relay_swimmers_hytek = relay_swimmers
)
Arguments
file_hytek |
output from read_results
|
avoid_hytek |
a list of strings. Rows in file_hytek containing
these strings will not be included. For example "Pool:", often used to
label pool records, could be passed to avoid_hytek . The default is
avoid_default , which contains many strings similar to "Pool:", such
as "STATE:" and "Qual:". Users can supply their own lists to
avoid_hytek . avoid_hytek is handled before typo_hytek
and replacement_hytek .
|
typo_hytek |
a list of strings that are typos in the original results.
swim_parse is particularly sensitive to accidental double spaces, so
"Central High School", with two spaces between "Central" and "High" is a
problem, which can be fixed. Pass "Central High School" to
typo_hytek . Unexpected commas as also an issue, for example "Texas,
University of" should be fixed using typo_hytek and
replacement_hytek
|
replacement_hytek |
a list of fixes for the strings in
typo_hytek . Here one could pass "Central High School" (one space
between "Central" and "High") and "Texas" to replacement_hytek fix
the issues described in typo_hytek
|
format_results |
should the results be formatted for analysis (special
strings like "DQ" replaced with NA , Finals as
definitive column)? Default is TRUE
|
splits |
either TRUE or the default, FALSE - should
swim_parse attempt to include splits.
|
split_length_hytek |
either 25 or the default, 50 , the
length of pool at which splits are recorded. Not all results are
internally consistent on this issue - some have races with splits by 50 and
other races with splits by 25.
|
relay_swimmers_hytek |
should names of relay swimmers be captured?
Default is FALSE
|
Value
returns a data frame with columns Name
, Place
,
Age
, Team
, Prelims
, Finals
,
Points
, Event
& DQ
. Note all swims will have a
Finals
, even if that time was actually swam in the prelims
(i.e. a swimmer did not qualify for finals). This is so that final results
for an event can be generated from just one column.
See Also
swim_parse_hytek
must be run on the output of
read_results
[Package
SwimmeR version 0.14.2
Index]