The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.
Just how closely related are Jon Snow and Daenerys Targaryen? According to the lore of A Song of Ice and Fire, Daenerys is Jon’s paternal aunt. This would suggest a theoretical genetic relatedness of 0.25, assuming a simple pedigree and no inbreeding. But with tangled ancestries and potentially missing information, how confident can we be in that estimate?
In this vignette, we use the BGmisc
package to
reconstruct the ASOIAF pedigree, handle incomplete parentage
data, and compute additive genetic and common nuclear relatedness. We’ll
focus on Jon and Daenerys as a case study, but the methods generalize to
any characters in the provided dataset.
We begin by loading the required libraries and examining the
structure of the built-in ASOIAF
pedigree.
The ASOIAF dataset includes character IDs, names, family identifiers, and parent identifiers for a subset of characters drawn from the A Song of Ice and Fire canon.
## id famID momID dadID name sex twinID zygosity
## 1 1 1 566 564 Walder Frey M NA <NA>
## 2 2 1 NA NA Perra Royce F NA <NA>
## 3 3 1 2 1 Stevron Frey M NA <NA>
## 4 4 1 2 1 Emmon Frey M NA <NA>
## 5 5 1 2 1 Aenys Frey M NA <NA>
## 6 6 1 NA NA Corenna Swann F NA <NA>
Many pedigree-based algorithms rely on biological sex for downstream
calculationss and visualization. We use checkSex()
to
inspect the sex variable, repairing inconsistencies
programmatically.
For interpretability, we convert these square matrices into
long-format tables using com2links()
. This function returns
a dataframe where each row represents a unique pair of individuals,
including their additive and common nuclear coefficients.
df_links <- com2links(
writetodisk = FALSE,
ad_ped_matrix = add, cn_ped_matrix = cn, mit_ped_matrix = mt,
drop_upper_triangular = TRUE
) # %>%
# filter(ID1 != ID2)
The function can return the entire matrix or just the lower
triangular part, which is often sufficient for our purposes. Setting
drop_upper_triangular = TRUE
ensures we only retain one
entry per dyad, since the matrices are symmetric. We also keep the data
in memory by setting writetodisk = FALSE
.
We next identify the rows in the pairwise relatedness table that correspond to Jon Snow and Daenerys Targaryen. First, we retrieve their individual IDs:
# Find the IDs of Jon Snow and Daenerys Targaryen
jon_id <- df_got %>%
filter(name == "Jon Snow") %>%
pull(ID)
dany_id <- df_got %>%
filter(name == "Daenerys Targaryen") %>%
pull(ID)
We can then filter the pairwise relatedness table to isolate the dyad of interest:
jon_dany_row <- df_links %>%
filter(ID1 == jon_id | ID2 == jon_id) %>%
filter(ID1 %in% dany_id | ID2 %in% dany_id) %>% # round to nearest 4th decimal
mutate(across(c(addRel, mitRel, cnuRel), ~ round(.x, 4)))
jon_dany_row
## ID1 ID2 addRel mitRel cnuRel
## 1 206 211 0.5031 0 0
## 2 211 304 0.0562 0 0
This table contains the additive nuclear relatedness estimates for Jon and Daenerys. If the pedigree reflects their canonical aunt-nephew relationship and is free from… complications, we’d expect to see an additive coefficient close to 0.25. However, the value is 0.5031, indicating a more complex relationship and in line with how related we would expect full siblings to be.
Likewise, when we examine the relatedness for a different pair, such as Rhaenyra Targaryen and Damemon Targaryen, we can see how the relatedness coefficients vary across different characters in the dataset.
rhaenyra_id <- df_got %>%
filter(name == "Rhaenyra Targaryen") %>%
pull(ID)
daemon_id <- df_got %>%
filter(name == "Daemon Targaryen") %>%
pull(ID)
rhaenyra_daemon_row <- df_links %>%
filter(ID1 == rhaenyra_id | ID2 == rhaenyra_id) %>%
filter(ID1 %in% daemon_id | ID2 %in% daemon_id) %>% # round to nearest 4th decimal
mutate(across(c(addRel, mitRel, cnuRel), ~ round(.x, 4)))
rhaenyra_daemon_row
## ID1 ID2 addRel mitRel cnuRel
## 1 339 536 0.7355 1 0
Similarly, we can see that Rhaenyra and Daemon have an additive relatedness coefficient of 0.7355, which is also slightly higher than the expected 0.25 for a full uncle-neice relationship. In terms of mitochondrial relatedness, both pairs have a coefficient of 1, indicating that they share the same mitochondrial lineage.
Many real-world and fictional pedigrees contain individuals with
unknown or partially known parentage. In such cases, plotting tools
typically fail unless these gaps are handled. We use
checkParentIDs()
to:
Identify individuals with one known parent and one missing
Create “phantom” placeholders for the missing parent
Optionally repair and harmonize parent fields
To facilitate plotting, we check for individuals with one known parent but a missing other. For those cases, we assign a placeholder ID to the missing parent.
df_repaired <- checkParentIDs(df_got,
addphantoms = TRUE,
repair = TRUE,
parentswithoutrow = FALSE,
repairsex = FALSE
) %>% mutate(
# famID = 1,
affected = case_when(
ID %in% c(jon_id, dany_id, "365") ~ T,
TRUE ~ F
)
)
## REPAIR IN EARLY ALPHA
This code creates new IDs for individuals with one known parent and a
missing other. It checks if either momID
or
dadID
is missing, and if so, it assigns a new ID based on
the row number. This allows us to visualize the pedigree even when some
parental information is incomplete. Now we can check the repaired
pedigree for unique IDs and parent-child relationships.
## Standardizing column names...
## Checking IDs...
## Step 1: Checking for unique IDs...
## All IDs are unique.
## Step 2: Checking for within row duplicats...
## No within row duplicates found.
## Validation Results:
## TRUE0NULL0000FALSENULLNULLNULL
# Check for unique IDs and parent-child relationships
checkPedigreeNetwork<- checkPedigreeNetwork(df_repaired,
personID = "ID",
momID = "momID",
dadID = "dadID",
verbose = TRUE
)
## No individuals with more than two parents detected.
## No duplicate edges detected.
## No cyclic relationships detected.
## $individuals_with_excess_parents
## character(0)
##
## $duplicate_edges
## [,1] [,2]
##
## $is_acyclic
## [1] TRUE
As we can see, the repaired pedigree now has unique IDs for all
individuals, and the parent-child relationships are intact. The function
checkIDs()
confirms that all IDs are unique, while
checkPedigreeNetwork()
verifies that there are no
structural issues like individuals with more than two parents or cyclic
relationships.
We can now visualize the repaired pedigree using the
ggPedigree()
function from {ggpedigree}. This function
generates a plot of the pedigree, with individuals colored based on
their affected status. In this case, we highlight Jon and Daenerys as
“affected” individuals. Otherwise they would be difficult to distinguish
from the rest of the pedigree. To make the plot more informative, we
also fill every member of the tree by how related they are to Rhaenyra
Targaryen, who is the focal individual in this case.
This function provides a more flexible and customizable way to
visualize pedigrees, allowing for easy integration with other
ggplot2
functions relative to kinship2’s pedigree plotting
functions.
library(ggpedigree)
df_repaired_renamed <- df_repaired %>% rename(
personID = ID
)
plt <- ggpedigree(df_repaired_renamed,
overlay_column = "affected",
personID = "personID",
interactive = FALSE,
config = list(
overlay_include = TRUE,
point_size = .75,
code_male = "M",
ped_width = 14,
label_nudge_y = -.25,
include_labels = TRUE,
label_method = "geom_text",
#segment_self_color = "purple",
sex_color_include = FALSE,
focal_fill_personID = 339,#353,
focal_fill_include = TRUE,
tooltip_columns = c( "personID","name", "focal_fill"),
focal_fill_force_zero = TRUE,
focal_fill_mid_color = "orange",
focal_fill_low_color = "#9F2A63FF",
focal_fill_legend_title = "Relatedness to \nRhaenyra Targaryen",
focal_fill_na_value = "black",
value_rounding_digits = 4
))
plt
# reduce file size for CRAN
#if (interactive()) {
# If running interactively, use plotly::partial_bundle
# to reduce file size for CRAN
# plotly::partial_bundle(plt)
#} else {
# plotly::partial_bundle(plt, local = TRUE)
#}
This plot can provide an interactive visualization of the ASOIAF pedigree (if interactive is set to TRUE), allowing users to explore relationships and affected status. The focal individual is highlighted, and tooltips provide additional information about each character.
In this vignette, we demonstrated how to reconstruct and analyze the
A Song of Ice and Fire pedigree using the BGmisc
package. We computed additive and common nuclear relatedness
coefficients for key characters, revealing the complexities of their
relationships. By handling incomplete parentage data and visualizing the
pedigree, we provided a comprehensive overview of how related Jon Snow
and Daenerys Targaryen truly are.
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.