Lightweight package for airport data and convenience tools to do common airport-data related tasks
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
R prep for CRAN Sep 15, 2018
data Initial commit May 29, 2018
inst/extdata update license Oct 6, 2018
man prep for CRAN Sep 15, 2018
vignettes cran check cleanup Sep 17, 2018
.Rbuildignore prep for CRAN Sep 15, 2018
.gitignore prep for CRAN Sep 15, 2018
.travis.yml prep for CRAN Sep 15, 2018
DESCRIPTION update license Oct 6, 2018
LICENSE update license Oct 6, 2018
NAMESPACE prep for CRAN Sep 15, 2018
README.md Merge branch 'master' of github.com:dshkol/airportr Oct 6, 2018
airportr.Rproj Initial commit May 29, 2018
cran-comments.md cran check cleanup Sep 17, 2018
data_read.R check airport import Sep 17, 2018

README.md

airportr

Travis-CI Build Status CRAN_Status_Badge CRAN_Downloads_Badge

This package uses open source airport data to provide tools to look up information, translate names and codes into other formats, as well as some basic calculation functions for measuring distances.

Installation

install.packages("airportr")
library(airportr)

Alternatively, the dev version can be installed from Github using devtools.

# install.packages("devtools")
devtools::install_github("dshkol/airportr")
library(airportr)

Example Usage: Lookup functions

This package is primarily to facilitate working with and translating structured airport data from one format into another.

# Return an airport name given an IATA code
airport_lookup("YVR", input_type = "IATA", output_type = "name")
[1] "Vancouver International Airport"

# Return an airport IATA code given an airport name
airport_lookup("Vancouver International Airport", input_type = "name", output_type ="IATA")
[1] "YVR"

# If input type is not specified will try to guess
airport_lookup("YVR", output_type = "city")
[1] "Vancouver"

# Return all available details for an aiport given an airport name, IATA code, or ICAO code
airport_detail("YVR")
# A tibble: 1 x 14
  `OpenFlights ID` Name      City  Country IATA  ICAO  Latitude Longitude Altitude   UTC DST  
             <int> <chr>     <chr> <chr>   <chr> <chr>    <dbl>     <dbl>    <int> <dbl> <chr>
1              156 VancouveVancCanada  YVR   CYVR      49.2     -123.       14    -8 A    
# ... with 3 more variables: Timezone <chr>, Type <chr>, Source <chr>

airport_detail("CYVR")
# A tibble: 1 x 14
  `OpenFlights ID` Name      City  Country IATA  ICAO  Latitude Longitude Altitude   UTC DST  
             <int> <chr>     <chr> <chr>   <chr> <chr>    <dbl>     <dbl>    <int> <dbl> <chr>
1              156 VancouveVancCanada  YVR   CYVR      49.2     -123.       14    -8 A    
# ... with 3 more variables: Timezone <chr>, Type <chr>, Source <chr>

# Return location of an airport given an ICAO code
airport_location("CYVR", input_type = "ICAO")
# A tibble: 1 x 2
  Latitude Longitude
     <dbl>     <dbl>
1     49.2     -123.

# Display all airports serving a given city
city_airports("Vancouver")
# A tibble: 3 x 14
  `OpenFlights ID` Name      City  Country IATA  ICAO  Latitude Longitude Altitude   UTC DST  
             <int> <chr>     <chr> <chr>   <chr> <chr>    <dbl>     <dbl>    <int> <dbl> <chr>
1              156 VancouveVancCanada  YVR   CYVR      49.2     -123.       14    -8 A    
2             4107 Coal HarVancCanada  "\\N" CAQ3      50.6     -128.        0    -8 A    
3             5500 VancouveVancCanada  CXH   CYHC      49.3     -123.        0    -8 A    
# ... with 3 more variables: Timezone <chr>, Type <chr>, Source <chr>

Example Usage: Distance functions

This package also includes some convenience functions for working with distances between airports.

# Calculate distance between two airports in km
airport_distance("YVR","LHR")
[1] 7580.963

Another common airport-related task is to locate airports in the vicinity of a city or specified location. This is easy to implement with the airports_near_airport() and airports_around() functions:

#' airports_near_airport("YEG")
# A tibble: 3 x 14
  `OpenFlights ID` Name            City      Country IATA  ICAO  Latitude Longitude Altitude   UTC DST   Timezone   Type  Source 
             <int> <chr>           <chr>     <chr>   <chr> <chr>    <dbl>     <dbl>    <int> <dbl> <chr> <chr>      <chr> <chr>  
1               49 Edmonton InterEdmonton  Canada  YEG   CYEG      53.3     -114.     2373    -7 A     America/EairpOurAir2              131 Rocky MountainRocky MoCanada  YRM   CYRM      52.4     -115.     3244    -7 A     America/EairpOurAir3              165 Edmonton CityEdmonton  Canada  YXD   CYXD      53.6     -114.     2202    -7 A     America/EairpOurAir#' airports_around(49.2,-123, distance = 20)
# A tibble: 3 x 14
  `OpenFlights ID` Name            City     Country IATA  ICAO  Latitude Longitude Altitude   UTC DST   Timezone    Type  Source 
             <int> <chr>           <chr>    <chr>   <chr> <chr>    <dbl>     <dbl>    <int> <dbl> <chr> <chr>       <chr> <chr>  
1              156 Vancouver InteVancouvCanada  YVR   CYVR      49.2     -123.       14    -8 A     America/VaairpOurAir2             5500 Vancouver HarbVancouvCanada  CXH   CYHC      49.3     -123.        0    -8 A     America/VaairpOurAir3             7273 Boundary Bay ABoundarCanada  YDT   CZBB      49.1     -123.        6    -8 A     America/VaairpOurAir

Data and License

Software code is licensed under the MIT license. Airport data is from the OpenFlights Airport Database made available under the Open Database License. A local copy of the license exists in the inst/extdata directory.

Disclaimer on the data from OpenFlights:

This data is not suitable for navigation. OpenFlights does not assume any responsibility whatsoever for its accuracy, and consequently assumes no liability whatsoever for results obtained or loss or damage incurred as a result of application of the data. OpenFlights expressly disclaims all warranties, expressed or implied, including but not limited to implied warranties of merchantability and fitness for any particular purpose.

To-do

  • Build lookup functions with meaningful messages
  • Debug lookup functions
  • Add generic input for functions that can handle different types of inputs
  • Add distance calculation functions
  • Add nearest neighbour search and geographic lookup functions
  • Submit to CRAN

Suggestions for additional functionality are welcome.