Description Usage Arguments Value See Also Examples

Given an admixture graph, selects a child edge and a parent edges and adds a new edge from the
parent edge to the child edge with an admixture event, if possible.
Thus, the resulting graph is an extension of the input graph in the sense that erasing one of
the admixture edges (the new one) we get the original admixture graph. However, we know that
in practice when fitting data to admixture graphs, the best graph with *k* admixture events
is not always an extension like that from the best graph with *k - 1* admixture events.
For a more relaxed way of adding a new admixture event, try `add_an_admixture2`

.

1 2 | ```
add_an_admixture(graph, admixture_variable_name, labels_matter = FALSE,
outgroup = "")
``` |

`graph` |
An admixture graph. |

`admixture_variable_name` |
A name for the new admixture proportion. |

`labels_matter` |
When |

`outgroup` |
An optional parameter for the preferred outgroup. |

A list of graphs made by adding a new admixture event to the input graph. The list has
no duplicate elements (what that means depends on the value of `labels_matter`

).

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 | ```
# To illustrate what the parameter labels_matter does, consider the following graph:
leaves <- c("A", "B", "C")
inner_nodes <- c("R", "x", "y", "M")
edges <- parent_edges(c(edge("x", "R"),
edge("y", "R"),
edge("A", "x"),
edge("B", "M"),
edge("C", "y"),
admixture_edge("M", "x", "y")))
admixtures <- admixture_proportions(c(admix_props("M", "x", "y", "p")))
graph <- agraph(leaves, inner_nodes, edges, admixtures)
plot(graph, show_admixture_labels = TRUE, title = "graph")
# There are 15 ways this graph can be extended to a graph with two admixture events by
# adding an admixture edge, as can be seeing by having the program explicitly construct
# all the cases:
short_list <- add_an_admixture(graph, "q")
print(length(short_list))
# However, maybe we already have a specific historical event in mind corresponding to the
# original admixture event in graph, or a fixed value for the admixture proportion p.
# Then, for example, it makes a difference to us whether we consider the possibility of
# another admixture event occurring before that event,
leaves <- c("A", "B", "C")
inner_nodes <- c("R", "x", "y", "z", "M", "N")
edges <- parent_edges(c(edge("x", "R"),
edge("z", "R"),
edge("y", "z"),
edge("A", "x"),
edge("B", "M"),
edge("C", "y"),
admixture_edge("N", "x", "z"),
admixture_edge("M", "N", "y")))
admixtures <- admixture_proportions(c(admix_props("N", "x", "z", "q"),
admix_props("M", "N", "y", "p")))
example1 <- agraph(leaves, inner_nodes, edges, admixtures)
plot(example1, show_admixture_labels = TRUE, title = "example 1")
# or after that event,
leaves <- c("A", "B", "C")
inner_nodes <- c("R", "x", "y", "z", "M", "N")
edges <- parent_edges(c(edge("x", "R"),
edge("y", "R"),
edge("z", "y"),
edge("A", "x"),
edge("B", "N"),
edge("C", "z"),
admixture_edge("M", "x", "y"),
admixture_edge("N", "M", "z")))
admixtures <- admixture_proportions(c(admix_props("M", "x", "y", "p"),
admix_props("N", "M", "z", "q")))
example2 <- agraph(leaves, inner_nodes, edges, admixtures)
plot(example2, show_admixture_labels = TRUE, title = "example 2")
# even though as (acyclic) directed graphs with labeled leaves example 1
# and example 2 are isomorphic.
# Counting cases like that dirrerent, we get 21 possible extensions:
long_list <- add_an_admixture(graph, "q", labels_matter = TRUE)
print(length(long_list))
``` |

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.