Datasets and Functions Relating to Star Trek

Provides datasets related to the Star Trek fictional universe and functions for working with the data. The package also provides access to real world datasets based on the televised series and other related licensed media productions. It interfaces with the Star Trek API (STAPI) (< http://stapi.co/>), Memory Alpha (< http://memory-alpha.wikia.com/>), and Memory Beta (< http://memory-beta.wikia.com/>) to retrieve data, metadata and other information relating to Star Trek. It also contains several local datasets covering a variety of topics. The package also provides functions for working with data from other Star Trek-related R data packages containing larger datasets not stored in 'rtrek'.

rtrek

The rtrek package provides datasets related to the Star Trek fictional universe and functions to assist with the data. It interfaces with Wikipedia, STAPI, Memory Alpha and Memory Beta to retrieve data, metadata and other information relating to Star Trek. It also contains local sample datasets covering a variety of topics such as Star Trek universe species data, geopolitical data, and summary datasets resulting from text mining analyses of Star Trek novels. The package also provides functions for working with data from other Star Trek-related R data packages containing larger datasets not stored in rtrek.

Note: This package is in beta (and not just the quadrant). Breaking changes may occur.

Image: Example Leaflet map using non-geographic Star Trek map tiles.

Installation

Install the development version of rtrek from GitHub with:

devtools::install_github("leonawicz/rtrek")

Example

Use the Star Trek API (STAPI) to obtain information on the whereabouts and whenabouts of the infamous character, Q. Specifically, retrieve data on his appearances and the stardates when he shows up. The first API call does a lightweight, unobtrusive check to see how many pages of potential search results exist for characters in the database. There are a lot of characters. The second call grabs only page two results. The third call uses the universal/unique ID uid to retrieve data on Q. Think of these three successive uses of stapi as safe mode, search mode and extraction mode.

library(rtrek)
library(dplyr)
stapi("character", page_count = TRUE)
#> Total pages to retrieve all results: 62
 
stapi("character", page = 2)
#> # A tibble: 100 x 24
#>    uid     name    gender yearOfBirth monthOfBirth dayOfBirth placeOfBirth
#>    <chr>   <chr>   <chr>        <int>        <int>      <int> <lgl>       
#>  1 CHMA00~ Fuller  M               NA           NA         NA NA          
#>  2 CHMA00~ Burkus  M               NA           NA         NA NA          
#>  3 CHMA00~ Masaka~ <NA>            NA           NA         NA NA          
#>  4 CHMA00~ Thorne  M               NA           NA         NA NA          
#>  5 CHMA00~ Ah-Kel  M               NA           NA         NA NA          
#>  6 CHMA00~ Robert~ <NA>            NA           NA         NA NA          
#>  7 CHMA00~ Q       M               NA           NA         NA NA          
#>  8 CHMA00~ John D~ <NA>            NA           NA         NA NA          
#>  9 CHMA00~ Louis ~ <NA>            NA           NA         NA NA          
#> 10 CHMA00~ Marat ~ M               NA           NA         NA NA          
#> # ... with 90 more rows, and 17 more variables: yearOfDeath <int>,
#> #   monthOfDeath <lgl>, dayOfDeath <lgl>, placeOfDeath <lgl>,
#> #   height <int>, weight <int>, deceased <lgl>, bloodType <chr>,
#> #   maritalStatus <chr>, serialNumber <chr>, hologramActivationDate <chr>,
#> #   hologramStatus <chr>, hologramDateStatus <lgl>, hologram <lgl>,
#> #   fictionalCharacter <lgl>, mirror <lgl>, alternateReality <lgl>
 
Q <- "CHMA0000025118"  #unique ID
Q <- stapi("character", uid = Q)
Q$episodes %>% select(uid, title, stardateFrom, stardateTo)
#>              uid                 title stardateFrom stardateTo
#> 1 EPMA0000001458    All Good Things...      47988.0    47988.0
#> 2 EPMA0000001329                 Q Who      42761.3    42761.3
#> 3 EPMA0000000483 Encounter at Farpoint      41153.7    41153.7
#> 4 EPMA0000162588            Death Wish           NA         NA
#> 5 EPMA0000001510    The Q and the Grey      50384.2    50392.7
#> 6 EPMA0000000845                Q-Less      46531.2    46531.2
#> 7 EPMA0000000651              Tapestry           NA         NA
#> 8 EPMA0000001413                True Q      46192.3    46192.3
#> 9 EPMA0000001377                  Qpid      44741.9    44741.9

Live long and prosper.

See the introduction vignette for more details and examples.

Reference

Complete package reference and function documentation