course_convert {SwimmeR}

Swimming Course Converter

Description

Used to convert times between Long Course Meters, Short Course Meters and Short Course Yards

Usage

course_convert(time, event, course, course_to, verbose = FALSE)

Arguments

time

A time, or vector of times to convert. Can be in either seconds (numeric, 95.97) format or swim (character, "1:35.97") format

event

The event swum as "100 Fly", "200 IM", "400 Free", "50 Back", "200 Breast" etc.

course

The course in which the time was swum as "LCM", "SCM" or "SCY"

course_to

The course to convert the time to as "LCM", "SCM" or "SCY"

verbose

If TRUE will return a data frame containing columns

• Time

• Course

• Course_To

• Event

• Time_Converted_sec

• Time_Converted_mmss

. If FALSE (the default) will return only a converted time.

Value

returns the time for a specified event and course converted to a time for the specified course_to in swimming format OR a data frame containing columns

• Time

• Course

• Course_To

• Event

• Time_Converted_sec

• Time_Converted_mmss

depending on the value of verbose

Note

Relays are not presently supported.

References

Uses the USA swimming age group method described here: https://support.gomotionapp.com/en/articles/6457476-how-to-perform-course-conversion-factoring-of-times

Examples

course_convert(time = "1:35.93", event = "200 Free", course = "SCY", course_to = "LCM")
course_convert(time = 95.93, event = "200 Free", course = "scy", course_to = "lcm")
course_convert(time = 53.89, event = "100 Fly", course = "scm", course_to = "scy")