engr_survey2: Calculate the Distance between Engineering Survey Points

In iemisc: Irucka Embry's Miscellaneous Functions

Calculate the Distance between Engineering Survey Points

Description

Takes engineering survey points in various units (foot, US survey foot, meters, or kilometers) and calculates the horizontal length in various units (foot, US survey foot, US survey mile, mile, meters, or kilometers).

Usage

engr_survey2(
  station1,
  station2,
  station_distance = 100,
  units1 = c("foot", "survey_ft", "meters", "kilometers"),
  units2 = c("foot", "survey_ft", "survey_mile", "mile", "meters", "kilometers")
)

Arguments

station1	character vector that contains the begin engineering survey station value
station2	character vector that contains the end engineering survey station value
station_distance	numeric vector that contains the horizontal distance between any 2 points along the survey, the default is 100 feet
units1	character vector that contains the system of units for the station_distance (options are foot, survey_ft (United States Customary System) [US survey foot], meters for International System of Units meters, or kilometers for International System of Units kilometers
units2	character vector that contains the system of units for the horizontal length (options are foot, survey_ft (United States Customary System) [US survey foot], survey_mile (United States Customary System) [US survey mile], mile, meters for International System of Units meters, or kilometers for International System of Units kilometers

Value

the calculated horizontal distance in the chosen unit as a numeric vector with the units attached

Author(s)

Irucka Embry

References

1. udunits.dat, v 1.18 2006/09/20 18:59:18 steve Exp, https://web.archive.org/web/20230202155021/https://www.unidata.ucar.edu/software/udunits/udunits-1/udunits.txt. Retrieved thanks to the Internet Archive: Wayback Machine

2. Ben W. Lewis, PE, July 12, 2016, "Construction Plan Reading Basics & Applications Part III Typical Calculations / Quantity Take-off's: Calculate Project Length", http://www.richlandonline.com/Portals/0/Departments/Procurement/SLBE/Plan%20Reading%20PowerPoint%20Presentation.pdf.

3. Georgia Department of Transportation Skills Development Series, Revised May 1, 2008, "Basic Highway Plan Reading", https://web.archive.org/web/20220401015405/http://www.dot.ga.gov/PartnerSmart/Training/Documents/ESD/BasicHiwyPlanReading.pdf. Retrieved thanks to the Internet Archive: Wayback Machine

Examples

# Please refer to the iemisc: Engineering Survey Examples vignette for
# additional examples

# Example 1

library(iemisc)

engr_survey2("395+75", "397+13", station_distance = 100, units1 = "foot",
units2 = "foot")



# Example 2

library(iemisc)

station1 <- "333+03"
station2 <- "332+94"

engr_survey2(station1, station2, units1 = "foot", units2 = "survey_mile")



# Example 3 from Lewis Reference document page 25

library(iemisc)

station3 <- "10+25.62"
station4 <- "189+45.72"

engr_survey2(station3, station4, units1 = "foot", units2 = "mile")



# Example 4 from Georgia reference page 27 (document page 43)

library(iemisc)

engr_survey2("701+50.00", "409+69.00", station_distance = 100,
units1 = "survey_ft", units2 = "foot")

iemisc documentation built on Sept. 25, 2023, 5:09 p.m.