findDFC: Finds the double first cousins in a pedigree

View source: R/findDFC.R

findDFCR Documentation

Finds the double first cousins in a pedigree

Description

Given a pedigree, all pairs of individuals that are double first cousins are returned.

Usage

findDFC(
  pedigree,
  exact = FALSE,
  parallel = FALSE,
  ncores = getOption("mc.cores", 2L)
)

Arguments

pedigree

A pedigree with columns organized: ID, Dam, Sire

exact

A logical statement indicating if individuals who are exactly double first cousins are to be identified

parallel

A logical statement indicating if parallelization should be attempted. Note, only reliable for Mac and Linux operating systems.

ncores

Number of cpus to use, default is maximum available

Details

When exact = TRUE, only those individuals whose grandparents are completely unrelated will be identified as double first cousins. When exact = FALSE, as long as the parents of individuals i and j are two sets of siblings (i.e., either sires full brothers/dams full sisters or two pairs of opposite sex full sibs) then i and j will be considered double first cousins. In the event where the grandparents of i and j are also related, exact = FALSE will still consider i and j full sibs, even though genetically they will be more related than exact = TRUE double first cousins.

parallel = TRUE should only be used on Linux or Mac OSes (i.e., not Windows).

Value

a list:

PedPositionList

gives the list of row numbers for all the pairs of individuals that are related as double first cousins.

DFC

gives the list of IDs, as characters, for all the pairs of individuals that are related as double first cousins.

FamilyCnt

If two individuals, i and j, are double first cousins, then i's siblings will also be double first cousins with j's siblings. Therefore, this is the total number of family pairs where offspring are related as double first cousins.

Author(s)

matthewwolak@gmail.com


nadiv documentation built on May 29, 2024, 10:40 a.m.