get_relations: Compute and Label Pairwise Relationships Across Multiple...

View source: R/label-and-plot.R

get_relationsR Documentation

Compute and Label Pairwise Relationships Across Multiple Family Graphs

Description

Applies [get_generations()] and [label_relatives()] to a tibble of family graph objects from [get_family_graphs()], returning a unified table of labelled pairwise relationships for all individuals across the specified families.

Usage

get_relations(
  family_graphs,
  fid = "fid",
  family_id_vec = NULL,
  fam_graph_col = "fam_graph"
)

Arguments

family_graphs

A tibble containing family-specific graph objects from [get_family_graphs()] (typically of class 'igraph'). Each row should correspond to a distinct family, with one column containing the graph object and another containing the family identifier (typically the proband's id).

fid

A character string specifying the name of the column in 'family_graphs' that holds the family identifiers. Defaults to '"fid"'.

family_id_vec

An optional character or numeric vector specifying which families to process. If 'NULL' (default), the function will process all families in 'family_graphs'.

fam_graph_col

A character string specifying the name of the column in 'family_graphs' that contains the family graph objects. Defaults to '"fam_graph"'.

Value

A tibble containing all labelled pairwise relationships across the specified families, with columns:

fid

Family identifier (typically the proband's id).

id1, id2

Identifiers for the two individuals being compared.

gen.x, gen.y

Number of generations separating each individual from their most recent common ancestor.

k

Kinship coefficient between the pair.

lab

Relationship label (e.g., '"S"', '"P"', '"GP"', '"1C"', '"HNib"').

See Also

[get_generations()] for computing generational distances and kinship coefficients, [label_relatives()] for labelling relationships based on generational patterns.

Examples

# See vignette


LTFGRS documentation built on Nov. 20, 2026, 5:10 p.m.