From 662b27df4f8a10c08fc701d1cde489ceb55bb944 Mon Sep 17 00:00:00 2001 From: PopSim-bot Date: Fri, 22 Nov 2024 00:06:07 +0000 Subject: [PATCH] Automated doc build for refs/heads/main --- main/.buildinfo | 2 +- ...bc0779831b39868cf3b9c8357be3d0e043e333.svg | 15185 +++++++++++ ...2e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg | 21988 --------------- ...6466a4252d011d07cb6f60905a84aeebeae896.svg | 14385 ---------- ...98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg} | 340 +- ...b4c884f73d8ddac2def1e1a801d6246568f650.svg | 22134 ++++++++++++++++ main/api.html | 420 +- main/introduction.html | 10 +- main/quickstart.html | 4 +- 9 files changed, 37707 insertions(+), 36761 deletions(-) create mode 100644 main/_images/230564e0a9cc7e7eaebedb6602bc0779831b39868cf3b9c8357be3d0e043e333.svg delete mode 100644 main/_images/45b4e2c60252937282dcf27aa72e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg delete mode 100644 main/_images/714662ad7895d62f9079a56cd56466a4252d011d07cb6f60905a84aeebeae896.svg rename main/_images/{b0edab92a4955548a0ff02ede54fcb2c62c48e1e38d70eb3a4e602aebe38dd9b.svg => bfe1ce355abd0a2b6df922c6aaf98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg} (61%) create mode 100644 main/_images/fd66f80152f31eae87f896775fb4c884f73d8ddac2def1e1a801d6246568f650.svg diff --git a/main/.buildinfo b/main/.buildinfo index bbaf754..2a60b3d 100644 --- a/main/.buildinfo +++ b/main/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 854f8a222806a0b0efdac2a602702e0b +config: ae0875d727ed2b7a04cf7056e72b91fc tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/main/_images/230564e0a9cc7e7eaebedb6602bc0779831b39868cf3b9c8357be3d0e043e333.svg b/main/_images/230564e0a9cc7e7eaebedb6602bc0779831b39868cf3b9c8357be3d0e043e333.svg new file mode 100644 index 0000000..601acd9 --- /dev/null +++ b/main/_images/230564e0a9cc7e7eaebedb6602bc0779831b39868cf3b9c8357be3d0e043e333.svg @@ -0,0 +1,15185 @@ + + + + + + + + 2024-11-22T00:06:02.253561 + image/svg+xml + + + Matplotlib v3.9.2, https://matplotlib.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/main/_images/45b4e2c60252937282dcf27aa72e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg b/main/_images/45b4e2c60252937282dcf27aa72e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg deleted file mode 100644 index 4e868b2..0000000 --- a/main/_images/45b4e2c60252937282dcf27aa72e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg +++ /dev/null @@ -1,21988 +0,0 @@ - - - - - - - - 2024-04-01T02:09:39.234068 - image/svg+xml - - - Matplotlib v3.8.3, https://matplotlib.org/ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/main/_images/714662ad7895d62f9079a56cd56466a4252d011d07cb6f60905a84aeebeae896.svg b/main/_images/714662ad7895d62f9079a56cd56466a4252d011d07cb6f60905a84aeebeae896.svg deleted file mode 100644 index cc1f027..0000000 --- a/main/_images/714662ad7895d62f9079a56cd56466a4252d011d07cb6f60905a84aeebeae896.svg +++ /dev/null @@ -1,14385 +0,0 @@ - - - - - - - - 2024-04-01T02:09:41.546939 - image/svg+xml - - - Matplotlib v3.8.3, https://matplotlib.org/ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/main/_images/b0edab92a4955548a0ff02ede54fcb2c62c48e1e38d70eb3a4e602aebe38dd9b.svg b/main/_images/bfe1ce355abd0a2b6df922c6aaf98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg similarity index 61% rename from main/_images/b0edab92a4955548a0ff02ede54fcb2c62c48e1e38d70eb3a4e602aebe38dd9b.svg rename to main/_images/bfe1ce355abd0a2b6df922c6aaf98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg index 44a017b..bd8d4ee 100644 --- a/main/_images/b0edab92a4955548a0ff02ede54fcb2c62c48e1e38d70eb3a4e602aebe38dd9b.svg +++ b/main/_images/bfe1ce355abd0a2b6df922c6aaf98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg @@ -6,11 +6,11 @@ - 2024-04-01T02:09:37.066598 + 2024-11-22T00:05:58.159131 image/svg+xml - Matplotlib v3.8.3, https://matplotlib.org/ + Matplotlib v3.9.2, https://matplotlib.org/ @@ -46,7 +46,7 @@ M 449.172443 7.2 L 449.172443 69.364375 L 574.862074 69.364375 L 574.862074 318.021875 -" clip-path="url(#pcba348615b)" style="fill: none; stroke: #ffffff; stroke-width: 3; stroke-linejoin: miter"/> +" clip-path="url(#pa22896ca0a)" style="fill: none; stroke: #ffffff; stroke-width: 3; stroke-linejoin: miter"/> - - + + + - - - - - - - - - + + + + + + + + + - - - - - - - - - - + + + + + + - - - - - + + + + - - - - + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + - - - - + + + - - - - - + + + + + - - - - - + + + + - - - - + + + - - - - - + + + + + - - - - - + + + + - - - - + + + - - - - - + + + + + - - - - - + + + + - - - - + + + - - - - - + + + + + - - - - - + + + + - - - - - + + + + - - - - - + + + + + - - - - - - - + + + + + + + - - - - - + + + + - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + - - + - - - - - - + + + + + \ No newline at end of file diff --git a/main/_images/fd66f80152f31eae87f896775fb4c884f73d8ddac2def1e1a801d6246568f650.svg b/main/_images/fd66f80152f31eae87f896775fb4c884f73d8ddac2def1e1a801d6246568f650.svg new file mode 100644 index 0000000..d1025f0 --- /dev/null +++ b/main/_images/fd66f80152f31eae87f896775fb4c884f73d8ddac2def1e1a801d6246568f650.svg @@ -0,0 +1,22134 @@ + + + + + + + + 2024-11-22T00:06:00.493374 + image/svg+xml + + + Matplotlib v3.9.2, https://matplotlib.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/main/api.html b/main/api.html index 936d1ce..18cfdfb 100644 --- a/main/api.html +++ b/main/api.html @@ -183,13 +183,13 @@

Loading and saving Demes graphsdemes.load(filename, *, format='yaml')[source]

Load a graph from a YAML or JSON file. The keywords and structure of the input are defined by the -Specification.

+Specification.

Parameters:
    -

  • filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object +

  • filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object with a read() method.

    • -

  • format (str) – The format of the input file. Either “yaml” or “json”.

    • +

  • format (str) – The format of the input file. Either “yaml” or “json”.

Returns:
@@ -212,9 +212,9 @@

Loading and saving Demes graphs
Parameters:
    -

  • filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object +

  • filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object with a read() method.

    • -

  • format (str) – The format of the input file. Either “yaml” or “json”.

    • +

  • format (str) – The format of the input file. Either “yaml” or “json”.

Returns:
@@ -222,7 +222,7 @@

Loading and saving Demes graphsReturn type: -

dict

+

dict

@@ -232,12 +232,12 @@

Loading and saving Demes graphsdemes.loads(string, *, format='yaml')[source]

Load a graph from a YAML or JSON string. The keywords and structure of the input are defined by the -Specification.

+Specification.

Parameters:
    -

  • string (str) – The string to be loaded.

    • -

  • format (str) – The format of the input string. Either “yaml” or “json”.

    • +

  • string (str) – The string to be loaded.

    • +

  • format (str) – The format of the input string. Either “yaml” or “json”.

Returns:
@@ -260,8 +260,8 @@

Loading and saving Demes graphs
Parameters:
    -

  • string (str) – The string to be loaded.

    • -

  • format (str) – The format of the input string. Either “yaml” or “json”.

    • +

  • string (str) – The string to be loaded.

    • +

  • format (str) – The format of the input string. Either “yaml” or “json”.

Returns:
@@ -269,7 +269,7 @@

Loading and saving Demes graphsReturn type: -

dict

+

dict

@@ -280,10 +280,10 @@

Loading and saving Demes graphs---. The keywords and structure of each document are defined by the -Specification.

+Specification.

Parameters:
-

filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object +

filename (Union[str, os.PathLike, FileLike]) – The path to the file to be loaded, or a file-like object with a read() method.

Returns:
@@ -300,18 +300,18 @@

Loading and saving Demes graphsdemes.dump(graph, filename, *, format='yaml', simplified=True)[source]

Dump the specified graph to a file. The keywords and structure of the output are defined by the -Specification.

+Specification.

Parameters:

  • graph (demes.Graph) – The graph to dump.

    • -

  • filename (Union[str, os.PathLike, FileLike]) – Path to the output file, or a file-like object with a +

  • filename (Union[str, os.PathLike, FileLike]) – Path to the output file, or a file-like object with a write() method.

    • -

  • format (str) – The format of the output file. Either “yaml” or “json”.

    • -

  • simplified (bool) – If True, the output file follows the Human Data Model, +

  • format (str) – The format of the output file. Either “yaml” or “json”.

    • +

  • simplified (bool) – If True, the output file follows the Human Data Model, which has many fields omitted and is thus more compact. If False, the output file is fully-resolved and follows the -Machine Data Model.

    • +Machine Data Model.

@@ -322,23 +322,23 @@

Loading and saving Demes graphsdemes.dumps(graph, *, format='yaml', simplified=True)[source]

Dump the specified graph to a YAML or JSON string. The keywords and structure of the output are defined by the -Specification.

+Specification.

Parameters:

  • graph (demes.Graph) – The graph to dump.

    • -

  • format (str) – The format of the output file. Either “yaml” or “json”.

    • -

  • simplified (bool) – If True, returns a string following the Human Data Model, +

  • format (str) – The format of the output file. Either “yaml” or “json”.

    • +

  • simplified (bool) – If True, returns a string following the Human Data Model, which has many fields omitted and is thus more compact. If False, returns a string that is fully-resolved following the -Machine Data Model.

    • +Machine Data Model.

Returns:

The YAML or JSON string.

Return type:
-

str

+

str

@@ -351,12 +351,12 @@

Loading and saving Demes graphsParameters:
@@ -371,19 +371,19 @@

Building Demes graphs

The Builder class provides a set of convenient methods for incrementally constructing a demographic model.

The state of the demographic model is stored internally as a dictionary -of objects following Demes’ Human Data Model. +of objects following Demes’ Human Data Model. The content of this dictionary is not resolved and is not verified. The Builder object may be converted into a resolved and validated Graph object using the resolve() method.

Variables:
-

data (dict) –

The data dictionary of the demographic model’s current state. +

data (dict) –

The data dictionary of the demographic model’s current state. The objects nested within this dictionary should follow -Demes’ data model, as described in the Human Data Model schema.

+Demes’ data model, as described in the Human Data Model schema.

Note

Users may freely modify the data dictionary, such as temporarily -adding or deleting fields, as long as the Human Data Model +adding or deleting fields, as long as the Human Data Model is not violated when the resolve() method is called.

@@ -395,16 +395,16 @@

Building Demes graphs
Parameters:
    -

  • description (str) – A human readable description of the demography.

    • -

  • time_units (str) – The units of time used for the demography. This is +

  • description (str) – A human readable description of the demography.

    • +

  • time_units (str) – The units of time used for the demography. This is commonly years or generations, but can be any string.

    • -

  • generation_time (float) – The generation time of demes, in units given +

  • generation_time (float) – The generation time of demes, in units given by the time_units parameter.

    • -

  • doi (list[str]) – If the graph describes a published demography, the DOI(s) +

  • doi (list[str]) – If the graph describes a published demography, the DOI(s) should be be given here as a list.

    • -

  • defaults (dict) – A dictionary of default values, following the -Human Data Model schema for defaults.

    • -

  • metadata (dict) – A dictionary of arbitrary additional data.

    • +

  • defaults (dict) – A dictionary of default values, following the +Human Data Model schema for defaults.

    • +

  • metadata (dict) – A dictionary of arbitrary additional data.

@@ -419,16 +419,16 @@

Building Demes graphs
Parameters:
    -

  • name (str) – A string identifier for the deme.

    • -

  • description (str) – A description of the deme.

    • -

  • ancestors (list[str]) – List of deme names for the deme’s ancestors.

    • -

  • proportions (list[float]) – The proportions of ancestry from each ancestor. +

  • name (str) – A string identifier for the deme.

    • +

  • description (str) – A description of the deme.

    • +

  • ancestors (list[str]) – List of deme names for the deme’s ancestors.

    • +

  • proportions (list[float]) – The proportions of ancestry from each ancestor. This list has the same length as ancestors, and must sum to 1.

    • -

  • start_time (float) – The deme’s start time.

    • -

  • epochs (list[dict]) – List of epoch dictionaries. Each dictionary -follows the Human Data Model schema for an epoch object.

    • -

  • defaults (dict) – A dictionary of default deme values, following the -Human Data Model schema for deme defaults.

    • +

  • start_time (float) – The deme’s start time.

    • +

  • epochs (list[dict]) – List of epoch dictionaries. Each dictionary +follows the Human Data Model schema for an epoch object.

    • +

  • defaults (dict) – A dictionary of default deme values, following the +Human Data Model schema for deme defaults.

@@ -452,15 +452,15 @@

Building Demes graphs
Parameters:
    -

  • demes (list[str]) – List of deme names. If specified, migration is symmetric +

  • demes (list[str]) – List of deme names. If specified, migration is symmetric between all pairs of demes in this list.

    • -

  • source (str) – The name of the source deme. If specified, migration is asymmetric +

  • source (str) – The name of the source deme. If specified, migration is asymmetric from this deme.

    • -

  • dest (str) – The name of the destination deme. If specified, migration is +

  • dest (str) – The name of the destination deme. If specified, migration is asymmetric into this deme.

    • -

  • rate (float) – The rate of migration per generation.

    • -

  • start_time (float) – The time at which the migration rate is enabled.

    • -

  • end_time (float) – The time at which the migration rate is disabled.

    • +

  • rate (float) – The rate of migration per generation.

    • +

  • start_time (float) – The time at which the migration rate is enabled.

    • +

  • end_time (float) – The time at which the migration rate is disabled.

@@ -478,12 +478,12 @@

Building Demes graphs
Parameters:
    -

  • sources (list(str)) – A list of names of the source deme(s).

    • -

  • dest (str) – The name of the destination deme.

    • -

  • proportion (list(float)) – At the instant after migration, this is the expected proportion(s) +

  • sources (list(str)) – A list of names of the source deme(s).

    • +

  • dest (str) – The name of the destination deme.

    • +

  • proportion (list(float)) – At the instant after migration, this is the expected proportion(s) of individuals in the destination deme made up of individuals from the source deme(s).

    • -

  • time (float) – The time at which migrations occur.

    • +

  • time (float) – The time at which migrations occur.

@@ -497,7 +497,7 @@

Building Demes graphsParameters:

data (MutableMapping) – The data dictionary to initialise the Builder’s state. The objects nested within this dictionary should follow -Demes’ Human Data Model, but see the note for +Demes’ Human Data Model, but see the note for Builder.data.

Returns:
@@ -533,7 +533,7 @@

Working with Demes graphsclass demes.Graph(*, description='', time_units, generation_time=None, doi=_Nothing.NOTHING, metadata=_Nothing.NOTHING)[source]

The Graph class is a resolved and validated representation of a demographic model.

-

A Graph object matches Demes’ Machine Data Model, with a small number of +

A Graph object matches Demes’ Machine Data Model, with a small number of additional redundant attributes that make the Graph a more convenient object to use when inspecting a model’s properties. Graph objects are not intended to be constructed directly—demographic @@ -547,21 +547,21 @@

Working with Demes graphs
Variables:
    -

  • description (str) – A human readable description of the demography.

    • -

  • time_units (str) – The units of time used for the demography. This is +

  • description (str) – A human readable description of the demography.

    • +

  • time_units (str) – The units of time used for the demography. This is commonly years or generations, but can be any string. This field is intended to be useful for documenting a demography, but the actual value provided here should not be relied upon.

    • -

  • generation_time (float) – The generation time of demes, in units given +

  • generation_time (float) – The generation time of demes, in units given by the time_units parameter. Concretely, dividing all times by generation_time will convert the graph to have time units in generations. See also: in_generations().

    • -

  • doi (list[str]) – A list of publications that describe the demographic model.

    • -

  • metadata (dict) – A dictionary of arbitrary additional data.

    • -

  • demes (list[Deme]) – The demes in the demographic model.

    • -

  • migrations (list[AsymmetricMigration]) – The continuous asymmetric migrations for the demographic model.

    • -

  • pulses (list[Pulse]) – The instantaneous pulse migrations for the demographic model.

    • +

  • doi (list[str]) – A list of publications that describe the demographic model.

    • +

  • metadata (dict) – A dictionary of arbitrary additional data.

    • +

  • demes (list[Deme]) – The demes in the demographic model.

    • +

  • migrations (list[AsymmetricMigration]) – The continuous asymmetric migrations for the demographic model.

    • +

  • pulses (list[Pulse]) – The instantaneous pulse migrations for the demographic model.

@@ -576,10 +576,10 @@

Working with Demes graphs
Parameters:
-

deme_name (str) – The name of the deme.

+

deme_name (str) – The name of the deme.

Return type:
-

bool

+

bool

Returns:

True if the deme is in the graph, False otherwise.

@@ -598,7 +598,7 @@

Working with Demes graphs
Parameters:
-

deme_name (str) – The name of the deme.

+

deme_name (str) – The name of the deme.

Return type:

Deme

@@ -615,10 +615,10 @@

Working with Demes graphs
Returns:
-

A data dictionary following the Machine Data Model.

+

A data dictionary following the Machine Data Model.

Return type:
-

dict

+

dict

@@ -629,10 +629,10 @@

Working with Demes graphs
Returns:
-

A data dictionary following the Human Data Model.

+

A data dictionary following the Human Data Model.

Return type:
-

dict

+

dict

@@ -656,10 +656,10 @@

Working with Demes graphsParameters:

  • other (Graph) – The graph to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose().

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -690,7 +690,7 @@

Working with Demes graphsMerge, and Admix objects.

Return type:
-

dict[str, list]

+

dict[str, list]

@@ -701,8 +701,8 @@

Working with Demes graphs
Parameters:
-

data (dict) – A data dictionary following either the -Human Data Model or the Machine Data Model.

+

data (dict) – A data dictionary following either the +Human Data Model or the Machine Data Model.

Returns:

A resolved and validated demographic model.

@@ -732,7 +732,7 @@

Working with Demes graphsisclose(other, *, rel_tol=1e-09, abs_tol=1e-12)[source]

Returns true if the graph and other implement essentially the same demographic model. Numerical values are compared using the -math.isclose() function, from which this method takes its name. +math.isclose() function, from which this method takes its name. Furthermore, the following implementation details are ignored during the comparison:

@@ -747,17 +747,17 @@

Working with Demes graphsParameters:

  • other (Graph) – The graph to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose().

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two graphs implement the same model, False otherwise.

Return type:
-

bool

+

bool

@@ -807,7 +807,7 @@

Working with Demes graphsend_times are a list of end times for each matrix.

Return type:
-

tuple[list[list[list[float]]], list[float]]

+

tuple[list[list[list[float]]], list[float]]

@@ -831,7 +831,7 @@

Working with Demes graphs

A NetworkX compatible dict-of-lists graph of the demes’ predecessors.

Return type:
-

dict[str, list[str]]

+

dict[str, list[str]]

@@ -842,7 +842,7 @@

Working with Demes graphs
Parameters:
-

names (dict) – A dictionary with deme names and new names.

+

names (dict) – A dictionary with deme names and new names.

Returns:

A demographic model with renamed demes.

@@ -872,7 +872,7 @@

Working with Demes graphs

A NetworkX compatible dict-of-lists graph of the demes’ successors.

Return type:
-

dict[str, list[str]]

+

dict[str, list[str]]

@@ -887,15 +887,15 @@

Working with Demes graphs
Variables:
    -

  • name (str) – A concise string that identifies the deme.

    • -

  • description (str) – A description of the deme.

    • -

  • start_time (float) – The time at which the deme begins to exist.

    • -

  • ancestors (list[str]) – List of deme names for the deme’s ancestors.

    • -

  • proportions (list[float]) – The proportions of ancestry from each ancestor, +

  • name (str) – A concise string that identifies the deme.

    • +

  • description (str) – A description of the deme.

    • +

  • start_time (float) – The time at which the deme begins to exist.

    • +

  • ancestors (list[str]) – List of deme names for the deme’s ancestors.

    • +

  • proportions (list[float]) – The proportions of ancestry from each ancestor, ordered to correspond with the same order as the ancestors list. If there are one or more ancestors, the proportions sum to 1.

    • -

  • epochs (list[Epoch]) – A list of epochs that span the time interval over which the +

  • epochs (list[Epoch]) – A list of epochs that span the time interval over which the deme exists. Epoch time intervals are non-overlapping, completely cover the deme’s existence time interval, and are listed in time-descending order (from the past @@ -914,10 +914,10 @@

    Working with Demes graphsParameters:

    • other (Deme) – The deme to compare against.

      • -

    • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

      • -

    • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

      • +

    • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

      • +

    • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

    @@ -929,7 +929,7 @@

    Working with Demes graphs
    Return type:
    -

    float

    +

    float

@@ -943,17 +943,17 @@

Working with Demes graphsParameters:

  • other (Deme) – The deme to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two demes are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -967,13 +967,13 @@

Working with Demes graphs
Parameters:
-

time (float) – The time at which the size should be calculated.

+

time (float) – The time at which the size should be calculated.

Returns:

The deme size.

Return type:
-

float

+

float

@@ -984,7 +984,7 @@

Working with Demes graphs
Return type:
-

float

+

float

@@ -1004,16 +1004,16 @@

Working with Demes graphs
Variables:
    -

  • start_time (float) – The start time of the epoch. +

  • start_time (float) – The start time of the epoch. This value is greater than zero and may be infinity.

    • -

  • end_time (float) – The end time of the epoch. +

  • end_time (float) – The end time of the epoch. This value is greater than or equal to zero and finite.

    • -

  • start_size (float) – Population size at start_time.

    • -

  • end_size (float) – Population size at end_time. +

  • start_size (float) – Population size at start_time.

    • +

  • end_size (float) – Population size at end_time. If start_size != end_size, the population size changes between the start and end times according to the size_function.

    • -

  • size_function (str) –

    The size change function. This is either +

  • size_function (str) –

    The size change function. This is either constant, exponential or linear, though it is possible that additional values will be added in the future.

    @@ -1041,8 +1041,8 @@

    Working with Demes graphsfloat) – The selfing rate for this epoch.

    • -

  • cloning_rate (float) – The cloning rate for this epoch.

    • +

  • selfing_rate (float) – The selfing rate for this epoch.

    • +

  • cloning_rate (float) – The cloning rate for this epoch.

@@ -1058,10 +1058,10 @@

Working with Demes graphsParameters:

  • other (Epoch) – The epoch to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1076,17 +1076,17 @@

Working with Demes graphsParameters:

  • other (Epoch) – The epoch to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two epochs are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1097,7 +1097,7 @@

Working with Demes graphs
Return type:
-

float

+

float

@@ -1118,11 +1118,11 @@

Continuous demographic events
Variables:
    -

  • source (str) – The source deme for asymmetric migration.

    • -

  • dest (str) – The destination deme for asymmetric migration.

    • -

  • start_time (float) – The time at which the migration rate is activated.

    • -

  • end_time (float) – The time at which the migration rate is deactivated.

    • -

  • rate (float) – The rate of migration per generation.

    • +

  • source (str) – The source deme for asymmetric migration.

    • +

  • dest (str) – The destination deme for asymmetric migration.

    • +

  • start_time (float) – The time at which the migration rate is activated.

    • +

  • end_time (float) – The time at which the migration rate is deactivated.

    • +

  • rate (float) – The rate of migration per generation.

@@ -1137,10 +1137,10 @@

Continuous demographic eventsParameters:

  • other (AsymmetricMigration) – The migration to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1155,17 +1155,17 @@

Continuous demographic eventsParameters:

  • other (AsymmetricMigration) – The migration to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two epochs are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1188,10 +1188,10 @@

Discrete demographic events
Variables:
    -

  • sources (list(str)) – The source deme(s).

    • -

  • dest (str) – The destination deme.

    • -

  • time (float) – The time of migration.

    • -

  • proportions (list(float)) – Immediately following migration, the proportion(s) +

  • sources (list(str)) – The source deme(s).

    • +

  • dest (str) – The destination deme.

    • +

  • time (float) – The time of migration.

    • +

  • proportions (list(float)) – Immediately following migration, the proportion(s) of individuals in the destination deme made up of migrant individuals or having parents from the source deme(s).

@@ -1208,10 +1208,10 @@

Discrete demographic eventsParameters:

  • other (Pulse) – The pulse to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1226,17 +1226,17 @@

Discrete demographic eventsParameters:

  • other (Pulse) – The pulse to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two pulses are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1254,9 +1254,9 @@

Discrete demographic events
Variables:
    -

  • parent (str) – The parental deme.

    • -

  • children (list[str]) – A list of descendant demes.

    • -

  • time (float) – The split time.

    • +

  • parent (str) – The parental deme.

    • +

  • children (list[str]) – A list of descendant demes.

    • +

  • time (float) – The split time.

@@ -1271,10 +1271,10 @@

Discrete demographic eventsParameters:

  • other (Split) – The split to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1290,17 +1290,17 @@

Discrete demographic eventsParameters:

  • other (Split) – The split to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two splits are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1316,9 +1316,9 @@

Discrete demographic events
Variables:
    -

  • parent (str) – The parental deme.

    • -

  • child (str) – The descendant deme.

    • -

  • time (float) – The branch time.

    • +

  • parent (str) – The parental deme.

    • +

  • child (str) – The descendant deme.

    • +

  • time (float) – The branch time.

@@ -1333,10 +1333,10 @@

Discrete demographic eventsParameters:

  • other (Branch) – The branch to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1351,17 +1351,17 @@

Discrete demographic eventsParameters:

  • other (Branch) – The branch to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two branches are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1377,11 +1377,11 @@

Discrete demographic events
Variables:
    -

  • parents (list[str]) – A list of parental demes.

    • -

  • proportions (list[float]) – A list of ancestry proportions, +

  • parents (list[str]) – A list of parental demes.

    • +

  • proportions (list[float]) – A list of ancestry proportions, in order of parents.

    • -

  • child (str) – The descendant deme.

    • -

  • time (float) – The merge time.

    • +

  • child (str) – The descendant deme.

    • +

  • time (float) – The merge time.

@@ -1396,10 +1396,10 @@

Discrete demographic eventsParameters:

  • other (Merge) – The merge to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1414,17 +1414,17 @@

Discrete demographic eventsParameters:

  • other (Merge) – The merge to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two merges are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1440,11 +1440,11 @@

Discrete demographic events
Variables:
    -

  • parents (list[str]) – A list of source demes.

    • -

  • proportions (list[float]) – A list of ancestry proportions, +

  • parents (list[str]) – A list of source demes.

    • +

  • proportions (list[float]) – A list of ancestry proportions, in order of parents.

    • -

  • child (str) – The admixed deme.

    • -

  • time (float) – The admixture time.

    • +

  • child (str) – The admixed deme.

    • +

  • time (float) – The admixture time.

@@ -1459,10 +1459,10 @@

Discrete demographic eventsParameters:

  • other (Admix) – The admixture to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

@@ -1477,17 +1477,17 @@

Discrete demographic eventsParameters:

  • other (Admix) – The admixture to compare against.

    • -

  • rel_tol (float) – The relative tolerance permitted for numerical -comparisons. See documentation for math.isclose()

    • -

  • abs_tol (float) – The absolute tolerance permitted for numerical -comparisons. See documentation for math.isclose().

    • +

  • rel_tol (float) – The relative tolerance permitted for numerical +comparisons. See documentation for math.isclose()

    • +

  • abs_tol (float) – The absolute tolerance permitted for numerical +comparisons. See documentation for math.isclose().

Returns:

True if the two admixtures are equivalent, False otherwise.

Return type:
-

bool

+

bool

@@ -1530,14 +1530,14 @@

Conversion functions
Parameters:
    -

  • command (str) – The ms command line.

    • -

  • N0 (float) – The reference population size (\(N_0\)) used to translate +

  • command (str) – The ms command line.

    • +

  • N0 (float) – The reference population size (\(N_0\)) used to translate from coalescent units. For a command that specifies a \(\theta\) value with the -t theta option, this can be calculated as \(N_0 = \theta / (4 \mu L)\), where \(\mu\) is the per-generation mutation rate and \(L\) is the length of the sequence being simulated.

    • -

  • deme_names (list[str]) – A list of names to use for the demes. +

  • deme_names (list[str]) – A list of names to use for the demes. If not specified, demes will be named deme1, deme2, etc.

@@ -1562,9 +1562,9 @@

Conversion functions
Parameters:
    -

  • N0 (float) – The reference population size used to translate into coalescent units. +

  • N0 (float) – The reference population size used to translate into coalescent units. See from_ms() for details.

    • -

  • samples (list(int)) – A list of haploid sample numbers, one for each deme, in the same +

  • samples (list(int)) – A list of haploid sample numbers, one for each deme, in the same order as the order of demes in the graph. The parameter is ignored for demographic models with only one deme. The given sampling scheme will be used with the -I argument. @@ -1576,7 +1576,7 @@

    Conversion functions

    The ms command line.

Return type:
-

str

+

str

diff --git a/main/introduction.html b/main/introduction.html index b84f08d..20a45cd 100644 --- a/main/introduction.html +++ b/main/introduction.html @@ -175,8 +175,8 @@

Quick search

Introduction

The demes Python package provides an API for defining, parsing, and sharing -Demes demographic models. Applications can use -demes to parse human-readable Demes YAML files +Demes demographic models. Applications can use +demes to parse human-readable Demes YAML files into fully-resolved demographic models. In addition, demes provides convenient data structures to simplify manipulation of demographic models. If you find an error in the documentation or a bug in the software, @@ -192,7 +192,7 @@

MotivationDemes Specification aims to make defining demographic +

The Demes Specification aims to make defining demographic models more intuitive, less prone to error or ambiguity, and readily interchangeable between simulation platforms. Demographic models, which define populations (or demes), their properties, @@ -203,7 +203,7 @@

Motivation

The following YAML file implements a two-epoch demographic history for a single deme, where the deme doubles in size 100 generations ago. -See the Demes tutorial for a detailed introduction to +See the Demes tutorial for a detailed introduction to writing Demes YAML files.

description: Single-population two-epoch demography.
 time_units: generations
@@ -233,7 +233,7 @@ 
Example
<Axes: ylabel='time ago (generations)'>
-_images/b0edab92a4955548a0ff02ede54fcb2c62c48e1e38d70eb3a4e602aebe38dd9b.svg
+_images/bfe1ce355abd0a2b6df922c6aaf98f8d3d6cbfde92c047a30e93cefe92f01d0a.svg
diff --git a/main/quickstart.html b/main/quickstart.html index 9f74fc2..1161bba 100644 --- a/main/quickstart.html +++ b/main/quickstart.html @@ -231,7 +231,7 @@

Loading a Demes graph
-_images/45b4e2c60252937282dcf27aa72e00bdf1f6a3e9c3eedba9bb8b3fbc8219f9ea.svg
+_images/fd66f80152f31eae87f896775fb4c884f73d8ddac2def1e1a801d6246568f650.svg

This YAML file can be loaded into Python with the load() function, to obtain a Graph instance (modify the filename as appropriate).

@@ -402,7 +402,7 @@

Plotting a Demes graph
<Axes: ylabel='time ago (generations)'>
-_images/714662ad7895d62f9079a56cd56466a4252d011d07cb6f60905a84aeebeae896.svg +_images/230564e0a9cc7e7eaebedb6602bc0779831b39868cf3b9c8357be3d0e043e333.svg