Relation_per_proband_plot: Plot the (Average) Number of Relatives per Proband by...

In LTFHPlus: Implementation of LT-FH++

Plot the (Average) Number of Relatives per Proband by Relationship Type

Description

Produces a structured visualisation of the (average) number of each relationship type per proband, based on the labelled pairwise relationship data from label_relatives(). The plot arranges relationship types according to generational distance and degree of relatedness, providing an intuitive overview of kinship structure within the study sample.

Usage

Relation_per_proband_plot(
  labelled_relations,
  proband_vec,
  reported_info = "both"
)

Arguments

labelled_relations	A tibble or data frame containing pairwise relationship labels and their associated metadata. Must include the following columns: id1 Identifier for the first individual (typically the proband). id2 Identifier for the second individual (the relative). gen.x, gen.y Number of generations separating each individual from their most recent common ancestor. k Kinship coefficient between the two individuals. lab Relationship label assigned by label_relatives().
proband_vec	A vector of identifiers for probands. The function restricts the analysis to pairs where id1 is included in this vector.
reported_info	Chose which information is reported on the figure. total shows the total number of relatives of each type across all probands. average shows the average number of relatives of each type per proband. both (default) shows both total and average numbers on the plot.

Details

If any relationship types in the input are not recognised in the predefined mapping (e.g., rare or complex kinships), these are aggregated and shown as "Other".

Value

A ggplot2 object showing the (mean) number of relatives per proband for each relationship type. The plot can be further modified using standard ggplot2 functions (e.g., + theme() or + labs()).

See Also

label_relatives() for generating the relationship labels used as input.

Examples

# see vignette on identifying and labelling relatives

LTFHPlus documentation built on Nov. 17, 2025, 5:07 p.m.