addExtraMarkerFromRawCall: Add an extra marker from raw calling data

Description Usage Arguments Details Value

View source: R/addExtraMarkerFromRawCall.R

Description

Add an extra marker to a map, based on raw calling data, using a QTL-mapping style approach.

Usage

1
2
3
4
5
addExtraMarkerFromRawCall(
  mpcrossMapped,
  newMarker,
  useOnlyExtraImputationPoints = TRUE
)

Arguments

mpcrossMapped

An object of class mpcrossMapped (dataset with a map), which must include imputed IBD genotypes and recombination fraction data.

newMarker

A matrix containing the raw data for the marker to add.

useOnlyExtraImputationPoints

Should we only attempt to add the new marker at points at which imputation data has been generated, which are not markers?

Details

This function uses a QTL-mapping style approach to test for where an extra marker should be added to an existing map. The code uses the imputation data at a collection of points, and the raw calling data for the extra marker. The raw calling data must be bivariate.

Test statistics measuring the association of the new marker to a point are computed using a multivariate analysis of variance approach. If the imputed genotype at a point is independent of the data for the new marker, then the new marker probably should not be mapped to that point. If the imputed genotype at a point and the data for the new marker are strongly dependent, then the new marker should probably be mapped to that point. Dependence and independence are measured using an F-test.

By default the set of points at which the new marker is considered for addition is the set of points at which imputation data is available, which are not markers. The intention is that this set of points should be an equally spaced grid of points; this reduces the number of tests that are performed, as generally there are far fewer points in the grid, than there are markers. After the new marker is added, local reordering will need to be performed anyway, making any loss in accuracy by using the grid of points largely irrelevant. Setting useOnlyExtraImputationPoints to FALSE means that every marker position will also be used as a possible position for the new marker (this is not recommended).

Value

An object of class addExtraMarkersStatistics containing the test statistic values and the genetic map used to generate them.


rohan-shah/mpMap2 documentation built on July 21, 2020, 8:58 p.m.