ukb_gen_samples_to_remove: Related samples (with data on the variable of interest) to...

In kenhanscombe/ukbtools: Manipulate and Explore UK Biobank Data

Related samples (with data on the variable of interest) to remove

Description

There are many ways to remove related individuals from phenotypic data for genetic analyses. You could simply exclude all individuals indicated as having "excess relatedness" and include those "used in pca calculation" (these variables are included in the sample QC data, ukb_sqc_v2.txt) - see details. This list is based on the complete dataset, and possibly removes more samples than you need to for your phenotype of interest. Ideally, you want a maximum independent set, i.e., to remove the minimum number of individuals with data on the phenotype of interest, so that no pair exceeds some cutoff for relatedness. ukb_gen_samples_to_remove returns a list of samples to remove in to achieve a maximal set of unrelateds for a given phenotype.

Usage

ukb_gen_samples_to_remove(data, ukb_with_data, cutoff = 0.0884)

Arguments

data	The UKB relatedness data as a dataframe (header: ID1, ID2, HetHet, IBS0, Kinship)
ukb_with_data	A character vector of ukb eids with data on the phenotype of interest
cutoff	KING kingship coefficient cutoff (default 0.0884 includes pairs with greater than 3rd-degree relatedness)

Details

Trims down the UKB relatedness data before selecting individuals to exclude, using the algorithm: step 1. remove pairs below KING kinship coefficient 0.0884 (3rd-degree or less related, by default. Can be set with cutoff argument), and any pairs if either member does not have data on the phenotype of interest. The user supplies a vector of samples with data. step 2. count the number of "connections" (or relatives) each participant has and add to "samples to exclude" the individual with the most connections. This is the greedy part of the algorithm. step 3. repeat step 2 till all remaining participants only have 1 connection, then add one random member of each remaining pair to "samples to exclude" (adds all those listed under ID2)

Another approach from the UKB email distribution list:

To: [e-mail] Date: Wed, 26 Jul 2017 17:06:01 +0100 Subject: A list of unrelated samples

(...) you could use the list of samples which we used to calculate the PCs, which is a (maximal) subset of unrelated participants after applying some QC filtering. Please read supplementary Section S3.3.2 for details. You can find the list of samples using the "used.in.pca.calculation" column in the sample-QC file (ukb_sqc_v2.txt) (...). Note that this set contains diverse ancestries. If you take the intersection with the white British ancestry subset you get ~337,500 unrelated samples.

Value

An integer vector of UKB IDs to remove.

See Also

ukb_gen_rel_count, ukb_gen_related_with_data

kenhanscombe/ukbtools documentation built on Feb. 25, 2023, 8:37 a.m.