The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.
After downloading and decrypting your UK Biobank (UKB) data with the supplied [UKB programs] (http://biobank.ctsu.ox.ac.uk/crystal/docs/UsingUKBData.pdf), you have multiple files that need to be brought together to give you a dataset to explore. The data file has column names that are edited field-codes from the UKB data showcase. ukbtools makes it easy to collapse the multiple UKB files into a single dataset for analysis, in the process giving meaningful names to the variables. The package also includes functionality to retrieve ICD diagnoses, explore a sample subset in the context of the UKB sample, and collect genetic metadata.
```{r, eval = FALSE}
install.packages(“ukbtools”)
devtools::install_github(“kenhanscombe/ukbtools”, dependencies = TRUE)
## Prerequisite: Make a UKB fileset
Download<sup>§</sup> then decrypt your data and create a "UKB fileset" (.tab, .r, .html):
```{bash, eval = FALSE}
ukb_unpack ukbxxxx.enc key
ukb_conv ukbxxxx.enc_ukb r
ukb_conv ukbxxxx.enc_ukb docs
ukb_unpack decrypts your downloaded
ukbxxxx.enc file, outputting a ukbxxxx.enc_ukb
file. ukb_conv with the r flag converts the
decrypted data to a tab-delimited file ukbxxxx.tab and an R
script ukbxxxx.r that reads the tab file. The
docs flag creates an html file containing a
field-code-to-description table (among others).
§ Full details of the data download and decrypt process are given in the Using UK Biobank Data documentation.
The function ukb_df() takes two arguments, the stem of
your fileset and the path, and returns a dataframe with usable column
names. This will take a few minutes. The rate-limiting step is reading
and parsing the code in the UKB-generated .r file - not
ukb_df per se.
```{r, eval = FALSE}
library(ukbtools)
my_ukb_data <- ukb_df(“ukbxxxx”)
You can also specify the path to your fileset if it is not in the current directory. For example, if your fileset is in a subdirectory of the working directory called data
```{r, eval = FALSE}
my_ukb_data <- ukb_df("ukbxxxx", path = "/full/path/to/my/data")
Note: You can move the three files in your fileset
after creating them with ukb_conv, but they should be kept
together. ukb_df() automatically updates the read call in
the R source file to point to the correct directory (the current
directory by default, or a directory specified by
path).
All tools are described on the ukbtools webpage and in the package vignette “Explore UK Biobank Data”
```{r, eval = FALSE}
vignette(“explore-ukb-data”, package = “ukbtools”)
For a list of all functions
```{r, eval = FALSE}
help(package = "ukbtools")
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.