From f1349ec89a21cd8e741eca149b5a354f93ef7a16 Mon Sep 17 00:00:00 2001
From: David Hendriks <davidhendriks93@gmail.com>
Date: Mon, 9 Aug 2021 13:29:47 +0100
Subject: [PATCH] updated documentation with the new notebooks

---
 docs/Makefile                                 |   13 +
 .../doctrees/binary_c_parameters.doctree      |  Bin 916548 -> 916548 bytes
 .../doctrees/custom_logging_functions.doctree |  Bin 53515 -> 53245 bytes
 docs/build/doctrees/environment.pickle        |  Bin 520233 -> 533017 bytes
 docs/build/doctrees/example_notebooks.doctree |  Bin 0 -> 4323 bytes
 docs/build/doctrees/examples.doctree          |  Bin 3032 -> 0 bytes
 docs/build/doctrees/general_examples.doctree  |  Bin 18001 -> 0 bytes
 docs/build/doctrees/grid.doctree              |  Bin 112975 -> 107231 bytes
 docs/build/doctrees/index.doctree             |  Bin 30135 -> 30144 bytes
 .../nbsphinx/notebook_api_functionality.ipynb |  951 ++++++++++++
 .../nbsphinx/notebook_custom_logging.ipynb    |  517 +++++++
 .../nbsphinx/notebook_extra_features.ipynb    |   44 +
 .../notebook_individual_systems.ipynb         |  563 +++++++
 .../nbsphinx/notebook_population.ipynb        | 1162 ++++++++++++--
 .../notebook_api_functionality.doctree        |  Bin 0 -> 409627 bytes
 .../doctrees/notebook_custom_logging.doctree  |  Bin 0 -> 47759 bytes
 .../doctrees/notebook_extra_features.doctree  |  Bin 0 -> 3928 bytes
 .../notebook_individual_systems.doctree       |  Bin 0 -> 54049 bytes
 .../doctrees/notebook_population.doctree      |  Bin 27909 -> 154820 bytes
 docs/build/doctrees/notebooks.doctree         |  Bin 2843 -> 0 bytes
 .../build/doctrees/population_example.doctree |  Bin 17941 -> 0 bytes
 .../utils/custom_logging_functions.html       |  142 +-
 .../utils/distribution_functions.html         |    6 +-
 .../binarycpython/utils/functions.html        |    6 +-
 .../_modules/binarycpython/utils/grid.html    |  110 +-
 .../utils/grid_options_defaults.html          |    8 +-
 .../binarycpython/utils/plot_functions.html   |    6 +-
 .../utils/run_system_wrapper.html             |    6 +-
 .../utils/spacing_functions.html              |    6 +-
 .../binarycpython/utils/useful_funcs.html     |    6 +-
 docs/build/html/_modules/index.html           |    6 +-
 .../html/_sources/binary_c_parameters.rst.txt |    2 +-
 .../html/_sources/example_notebooks.rst.txt   |   15 +
 docs/build/html/_sources/examples.rst.txt     |   10 -
 .../html/_sources/general_examples.rst.txt    |    7 -
 docs/build/html/_sources/index.rst.txt        |    2 +-
 .../notebook_api_functionality.ipynb.txt      |  951 ++++++++++++
 .../notebook_custom_logging.ipynb.txt         |  517 +++++++
 .../notebook_extra_features.ipynb.txt         |   44 +
 .../notebook_individual_systems.ipynb.txt     |  563 +++++++
 .../_sources/notebook_population.ipynb.txt    | 1162 ++++++++++++--
 docs/build/html/_sources/notebooks.rst.txt    |   10 -
 .../html/_sources/population_example.rst.txt  |    7 -
 docs/build/html/binary_c_parameters.html      |   12 +-
 docs/build/html/custom_logging_functions.html |   30 +-
 docs/build/html/distribution_functions.html   |    6 +-
 .../{examples.html => example_notebooks.html} |   59 +-
 docs/build/html/functions.html                |    6 +-
 docs/build/html/general_examples.html         |  719 ---------
 docs/build/html/genindex.html                 |   28 +-
 docs/build/html/grid.html                     |   62 +-
 docs/build/html/grid_options_defaults.html    |    6 +-
 .../build/html/grid_options_descriptions.html |    6 +-
 docs/build/html/hpc_functions.html            |    6 +-
 docs/build/html/index.html                    |   15 +-
 docs/build/html/modules.html                  |    6 +-
 .../html/notebook_api_functionality.html      | 1378 +++++++++++++++++
 .../html/notebook_api_functionality.ipynb     |  951 ++++++++++++
 docs/build/html/notebook_custom_logging.html  |  933 +++++++++++
 docs/build/html/notebook_custom_logging.ipynb |  517 +++++++
 docs/build/html/notebook_extra_features.html  |  518 +++++++
 docs/build/html/notebook_extra_features.ipynb |   44 +
 .../html/notebook_individual_systems.html     |  934 +++++++++++
 .../html/notebook_individual_systems.ipynb    |  563 +++++++
 docs/build/html/notebook_population.html      | 1065 +++++++++++--
 docs/build/html/notebook_population.ipynb     | 1162 ++++++++++++--
 docs/build/html/notebooks.html                |  269 ----
 docs/build/html/objects.inv                   |  Bin 4746 -> 5351 bytes
 docs/build/html/plot_functions.html           |    6 +-
 docs/build/html/population_example.html       |  665 --------
 docs/build/html/py-modindex.html              |    6 +-
 docs/build/html/readme_link.html              |    6 +-
 docs/build/html/run_system_wrapper.html       |    6 +-
 docs/build/html/search.html                   |    6 +-
 docs/build/html/searchindex.js                |    2 +-
 docs/build/html/spacing_functions.html        |    6 +-
 docs/build/html/stellar_types.html            |    6 +-
 docs/build/html/useful_funcs.html             |   10 +-
 docs/source/_templates/footer.html            |    4 +-
 docs/source/binary_c_parameters.rst           |    2 +-
 docs/source/example_notebooks.rst             |   15 +
 docs/source/examples.rst                      |   10 -
 docs/source/general_examples.rst              |    7 -
 docs/source/index.rst                         |    2 +-
 docs/source/notebook_api_functionality.ipynb  |  951 ++++++++++++
 docs/source/notebook_custom_logging.ipynb     |  517 +++++++
 docs/source/notebook_extra_features.ipynb     |   44 +
 docs/source/notebook_individual_systems.ipynb |  563 +++++++
 docs/source/notebook_population.ipynb         | 1162 ++++++++++++--
 docs/source/notebooks.rst                     |   10 -
 docs/source/population_example.rst            |    7 -
 91 files changed, 17395 insertions(+), 2755 deletions(-)
 create mode 100644 docs/build/doctrees/example_notebooks.doctree
 delete mode 100644 docs/build/doctrees/examples.doctree
 delete mode 100644 docs/build/doctrees/general_examples.doctree
 create mode 100644 docs/build/doctrees/nbsphinx/notebook_api_functionality.ipynb
 create mode 100644 docs/build/doctrees/nbsphinx/notebook_custom_logging.ipynb
 create mode 100644 docs/build/doctrees/nbsphinx/notebook_extra_features.ipynb
 create mode 100644 docs/build/doctrees/nbsphinx/notebook_individual_systems.ipynb
 create mode 100644 docs/build/doctrees/notebook_api_functionality.doctree
 create mode 100644 docs/build/doctrees/notebook_custom_logging.doctree
 create mode 100644 docs/build/doctrees/notebook_extra_features.doctree
 create mode 100644 docs/build/doctrees/notebook_individual_systems.doctree
 delete mode 100644 docs/build/doctrees/notebooks.doctree
 delete mode 100644 docs/build/doctrees/population_example.doctree
 create mode 100644 docs/build/html/_sources/example_notebooks.rst.txt
 delete mode 100644 docs/build/html/_sources/examples.rst.txt
 delete mode 100644 docs/build/html/_sources/general_examples.rst.txt
 create mode 100644 docs/build/html/_sources/notebook_api_functionality.ipynb.txt
 create mode 100644 docs/build/html/_sources/notebook_custom_logging.ipynb.txt
 create mode 100644 docs/build/html/_sources/notebook_extra_features.ipynb.txt
 create mode 100644 docs/build/html/_sources/notebook_individual_systems.ipynb.txt
 delete mode 100644 docs/build/html/_sources/notebooks.rst.txt
 delete mode 100644 docs/build/html/_sources/population_example.rst.txt
 rename docs/build/html/{examples.html => example_notebooks.html} (57%)
 delete mode 100644 docs/build/html/general_examples.html
 create mode 100644 docs/build/html/notebook_api_functionality.html
 create mode 100644 docs/build/html/notebook_api_functionality.ipynb
 create mode 100644 docs/build/html/notebook_custom_logging.html
 create mode 100644 docs/build/html/notebook_custom_logging.ipynb
 create mode 100644 docs/build/html/notebook_extra_features.html
 create mode 100644 docs/build/html/notebook_extra_features.ipynb
 create mode 100644 docs/build/html/notebook_individual_systems.html
 create mode 100644 docs/build/html/notebook_individual_systems.ipynb
 delete mode 100644 docs/build/html/notebooks.html
 delete mode 100644 docs/build/html/population_example.html
 create mode 100644 docs/source/example_notebooks.rst
 delete mode 100644 docs/source/examples.rst
 delete mode 100644 docs/source/general_examples.rst
 create mode 100644 docs/source/notebook_api_functionality.ipynb
 create mode 100644 docs/source/notebook_custom_logging.ipynb
 create mode 100644 docs/source/notebook_extra_features.ipynb
 create mode 100644 docs/source/notebook_individual_systems.ipynb
 delete mode 100644 docs/source/notebooks.rst
 delete mode 100644 docs/source/population_example.rst

diff --git a/docs/Makefile b/docs/Makefile
index d0c3cbf10..31daf9645 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -8,6 +8,8 @@ SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = build
 
+# Copy the notebooks
+
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -17,4 +19,15 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
+	# copy the notebooks
+	cp ../examples/notebook_individual_systems.ipynb source/
+	cp ../examples/notebook_custom_logging.ipynb source/
+	cp ../examples/notebook_population.ipynb source/
+	cp ../examples/notebook_extra_features.ipynb source/
+	cp ../examples/notebook_api_functionality.ipynb source/
+
+	# Copy the badges
+	cp -r ../badges/ source/
+	
+	# actually run the sphinx stuff
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/docs/build/doctrees/binary_c_parameters.doctree b/docs/build/doctrees/binary_c_parameters.doctree
index 2b8b0fe1ca46d5a06a73efd23ab144570d88a675..c459014308936f8bff24b47e72c5c4d983c4405d 100644
GIT binary patch
delta 344
zcmX@|!~Dn(^9}b|Yz++zt&9we3=J#{%&n45jf{<wQcaT;z(7mOsWdaEL?J&<OUp{Z
zu{2#l!CV2PSi#WT%Gk)tV6zNsAR~oFtYULwbiwC}DXmi)r_@f-$YAY}w^A^}sdRE8
zyXa(Bj%aHv4mCqEL=3A}%%)_>WW-H&6jGSP!qLpk+0M+#2*gZ4%nZaVK+FonY(UHo
W#2i2jQo{wr+(68;otcx@@iPFYZBwcM

delta 344
zcmX@|!~Dn(^9}b|Yz@pTtc(nd3=PbU%&jaeO-++bO$<{Mz(7mOsWdaEL?J&<OUp{Z
zt29T!$Xo%WSi#81%Gk`xWU~xwAR~oFtYULwbiwC}DXmi)r_@f-$YAY}w^A^}sdRE8
zyXa(Bj%aHv4mCqEL=3A}%%)_>WW-H&6jGSP!qLpk+0M+#2*gZ4%nZaVK+FonY(UHo
W#2i2jQo{wr+(68;otcx@@iPD#^;04M

diff --git a/docs/build/doctrees/custom_logging_functions.doctree b/docs/build/doctrees/custom_logging_functions.doctree
index 8564058641095488be47b9c5a05e3a42bfa0d669..2baedf88c0674787690b0e452b62a95a58a06441 100644
GIT binary patch
delta 6905
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

delta 6423
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

diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle
index 9cac40f21767708fbffa9e71ccc2bc19c6d0c692..59a55f82e1e3ec1d3e6a5e062c827347ee1864b5 100644
GIT binary patch
delta 59290
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

delta 46784
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
B%r5`{

diff --git a/docs/build/doctrees/example_notebooks.doctree b/docs/build/doctrees/example_notebooks.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..b9bef3c20dc63831463b0ae0c0e0c9848b042660
GIT binary patch
literal 4323
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

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/examples.doctree b/docs/build/doctrees/examples.doctree
deleted file mode 100644
index 487fd3e3d1542a5bc3225a3cde737626765268bc..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3032
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

diff --git a/docs/build/doctrees/general_examples.doctree b/docs/build/doctrees/general_examples.doctree
deleted file mode 100644
index e1c0cd131775ba9aff94d24ef4c79963cf4e3d71..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 18001
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

diff --git a/docs/build/doctrees/grid.doctree b/docs/build/doctrees/grid.doctree
index 7a1e57aa7c4d3642e652335e52a163dc78c55582..6954097710a726daade6683f7c30f32b46b5f6eb 100644
GIT binary patch
delta 9268
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%0A?v%>M21S>qxU-4
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
J`fd0N{14NG&B_1(

delta 12462
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
DJEY5*

diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree
index 7d628604db8fc2ac7160e98c9ae762d91b6a70e7..c0b1adc8cd9411e63986831be12d8da490a424fc 100644
GIT binary patch
delta 38
ucmdn~n(@GEMwSMasarR)u%rkIrdA~87UZPH=jE5ACgta6Zx%>dE(icDR1WL_

delta 29
lcmX@`nsNJUMwSMascSZ}u%vKsq*f&67UZOEmP}bL2mrCt3mO0b

diff --git a/docs/build/doctrees/nbsphinx/notebook_api_functionality.ipynb b/docs/build/doctrees/nbsphinx/notebook_api_functionality.ipynb
new file mode 100644
index 000000000..d81c31711
--- /dev/null
+++ b/docs/build/doctrees/nbsphinx/notebook_api_functionality.ipynb
@@ -0,0 +1,951 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "cb9d00f5-9613-471e-a4bb-6181311bf73b",
+   "metadata": {},
+   "source": [
+    "# Using the API functionality of binarycpython\n",
+    "This notebook shows how to use the API functions that interface with binary_c. It usually is better to use wrapper functions that internally use these API functions, because most of the output here is very raw\n",
+    "\n",
+    "Binarycpython uses the Python-C extension framework to interface Python with C. The sourcecode for this is contained in `src/binary_c_python.c`, and the functions are available via `from binarycpython import _binary_c_bindings`.\n",
+    "\n",
+    "The following functions are available through the API: (run cell below)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "ded7eaf6-e1ba-46c2-9f6f-9ebcb14a264d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on module binarycpython._binary_c_bindings in binarycpython:\n",
+      "\n",
+      "NAME\n",
+      "    binarycpython._binary_c_bindings - Module to interface the Binary_c API with python.\n",
+      "\n",
+      "FUNCTIONS\n",
+      "    free_persistent_data_memaddr_and_return_json_output(...)\n",
+      "        Frees the persistent_data memory and returns the json output\n",
+      "    \n",
+      "    free_store_memaddr(...)\n",
+      "        Frees the store memaddr\n",
+      "    \n",
+      "    return_arglines(...)\n",
+      "        Return the default args for a binary_c system\n",
+      "    \n",
+      "    return_help(...)\n",
+      "        Return the help info for a given parameter\n",
+      "    \n",
+      "    return_help_all(...)\n",
+      "        Return an overview of all the parameters, their description, categorized in sections\n",
+      "    \n",
+      "    return_maximum_mass_ratio_for_RLOF(...)\n",
+      "        Returns a string containing the maximum mass ratio for which a binary system does not RLOF at zams. Optionally accepts a store_capsule. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_minimum_orbit_for_RLOF(...)\n",
+      "        Returns a string containing the minimum orbit and separation for which a binary system does not RLOF at zams. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_persistent_data_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_store_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_version_info(...)\n",
+      "        Return the version information of the used binary_c build\n",
+      "    \n",
+      "    run_system(...)\n",
+      "        Function to run a system. This is a general function that will be able to handle different kinds of situations: single system run with different settings, population run with different settings, etc. To avoid having too many functions doing slightly different things. \n",
+      "        \n",
+      "        Arguments:\n",
+      "                argstring: argument string for binary_c\n",
+      "                (opt) custom_logging_func_memaddr: memory address value for custom logging function. Default = -1 (None)\n",
+      "                (opt) store_memaddr: memory adress of the store. Default = -1 (None)\n",
+      "                (opt) write_logfile: Boolean (in int form) for whether to enable the writing of the log function. Default = 0\n",
+      "                (opt) population: Boolean (in int form) for whether this system is part of a population run. Default = 0.\n",
+      "    \n",
+      "    test_func(...)\n",
+      "        Function that contains random snippets. Do not expect this to remain available, or reliable. i.e. dont use it.\n",
+      "\n",
+      "FILE\n",
+      "    /home/david/.pyenv/versions/3.6.4/envs/dev-binarycpython3.6.4/lib/python3.6/site-packages/binarycpython/_binary_c_bindings.cpython-36m-x86_64-linux-gnu.so\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "help(_binary_c_bindings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7ddede71-ffaa-4b24-aece-e94128a60d7f",
+   "metadata": {},
+   "source": [
+    "There are three main categories of functions:\n",
+    "\n",
+    "- Functions to get information from binary_c: these can be used to evolve systems, and get utility information from binary_c.\n",
+    "    - run_system\n",
+    "    - return_minimum_orbit_for_RLOF\n",
+    "    - return_maximum_mass_ratio_for_RLOF\n",
+    "    - return_help\n",
+    "    - return_help_all\n",
+    "    - return_arglines\n",
+    "\n",
+    "- Memory creation functions: these can be used to have binary_c allocate memory which is used or written to by binary_c\n",
+    "    - return_persistent_data_memaddr\n",
+    "    - return_store_memaddr\n",
+    "\n",
+    "- Memory freeing functions: These can be used to free the allocated memory, and in the case of persistent memory it will also return the contents of the ensemble\n",
+    "    - free_persistent_data_memaddr_and_return_json_output\n",
+    "    - free_store_memaddr"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0dd3e115-1571-42f7-9ab9-cf7688fa28c1",
+   "metadata": {},
+   "source": [
+    "## Example usage:"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5015daa-35ab-4736-a04d-f3cbe661638c",
+   "metadata": {},
+   "source": [
+    "### Setting up, using and freeing store"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "10a74d5a-a3d5-4543-a5bc-20d1fe885bb4",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<capsule object \"STORE\" at 0x7f163859d0c0>\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# allocating store memory\n",
+    "store_memaddr = _binary_c_bindings.return_store_memaddr()\n",
+    "print(store_memaddr)\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.run_system(argstring, store_memaddr=store_memaddr)\n",
+    "print(output)\n",
+    "\n",
+    "# Freeing store\n",
+    "_binary_c_bindings.free_store_memaddr(store_memaddr)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e9da5fc6-e680-483c-982e-4819767ed5b2",
+   "metadata": {},
+   "source": [
+    "### Getting information from binary_c"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "24f7ffe5-0076-459d-a37f-254e10d0d9f9",
+   "metadata": {},
+   "source": [
+    "We can get information for a parameter via return_help(parameter_name):\n",
+    "This will return an unparsed output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "318874f6-7acf-49bb-9786-299d4dffc0b3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "binary_c help for variable : M_1 <Float>\n",
+      "\n",
+      "The initial mass of star one (in solar units, internally this is star index 0).\n",
+      "\n",
+      "Default : 0\n",
+      "\n",
+      "\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help('M_1'))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f7fafce6-a522-43ac-a0c2-15a3db393b49",
+   "metadata": {},
+   "source": [
+    "We can get information on all available parameters via return_help(parameter_name):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "d7e757ae-579c-42a2-a310-f0401b7800e8",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "############################################################\n",
+      "##### Section Stars\n",
+      "############################################################\n",
+      "metallicity : This sets the metallicity of the stars, i.e. the amount (by mass) of matter which is not hydrogen or helium. If you are using the BSE algorithm, this must be 1e-4 <= metallicity <= 0.03. See also nucsyn_metallicity and effective_metallicity. : (null)\n",
+      "effective_metallicity : This sets effective metallicity of stars as used in routines like the Schneider wind loss. If not set, or set to DEFAULT_TO_METALLICITY (==-1, the default), this is just the same as metallicity. The main difference between effective_metallicity and metallicity is the range of validity: 0 <= effective_metallicity <= 1, while metallicity's range of validity is limited by the stellar evolution algorithm (so, for BSE, is 1e-4 <= metallicity <= 0.03). : (null)\n",
+      "M_1 : The initial mass of star one (in solar units, internally this is star index 0). : (null)\n",
+      "M_2 : The initial mass of star two (in solar units, internally this is star index 1). : (null)\n",
+      "M_3 : The initial mass of star three (in solar units, internally this is star index 2). : (null)\n",
+      "M_4 : The initial mass of star four (in solar units, internally this is star index 3). : (null)\n",
+      "vrot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot2,3,4. : (null)\n",
+      "vrot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,3,4. : (null)\n",
+      "vrot3 : The initial equatorial rotational velocity of star three (in km/s, internally this is star index 2). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,4. : (null)\n",
+      "vrot4 : The initial equatorial rotational velocity of star four (in km/s, internally this is star index 3). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,3. : (null)\n",
+      "Prot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). See also Prot2,3,4. : (null)\n",
+      "Prot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). See also Prot1,3,4. : (null)\n",
+      "Prot3 : The initial equatorial rotational period of star three (in days, internally this is star index 2). See also Prot1,2,4. : (null)\n",
+      "Prot4 : The initial equatorial rotational period of star four (in days, internally this is star index 3). See also Prot1,2,3. : (null)\n",
+      "inclination1 : The initial inclination of star one (in degrees). : (null)\n",
+      "inclination2 : The initial inclination of star two (in degrees). : (null)\n",
+      "inclination3 : The initial inclination of star three (in degrees). : (null)\n",
+      "inclination4 : The initial inclination of star four (in degrees). : (null)\n",
+      "B_1 : The initial magnetic field of star one (in Gauss, internally this is star index 0). : (null)\n",
+      "B_2 : The initial magnetic field of star two (in Gauss, internally this is star index 1). : (null)\n",
+      "B_3 : The initial magnetic field of star three (in Gauss, internally this is star index 2). : (null)\n",
+      "B_4 : The initial magnetic field of star four (in Gauss, internally this is star index 3). : (null)\n",
+      "B_inclination1 : The initial inclination of the magnetic field of star one (in degrees). : (null)\n",
+      "B_inclination2 : The initial inclination of the magnetic field of star two (in degrees). : (null)\n",
+      "B_inclination3 : The initial inclination of the magnetic field of star three (in degrees). : (null)\n",
+      "B_inclination4 : The initial inclination of the magnetic field of star four (in degrees). : (null)\n",
+      "stellar_type_1 : Set the stellar type of star 1 (internal index 0), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_2 : Set the stellar type of star 2 (internal index 1), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_3 : Set the stellar type of star 3 (internal index 2), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_4 : Set the stellar type of star 4 (internal index 3), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "max_stellar_type_1 : The maximum stellar type of star 1 (internal index 0). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value. \n",
+      " : (null)\n",
+      "max_stellar_type_2 : The maximum stellar type of star 2 (internal index 1). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_3 : The maximum stellar type of star 3 (internal index 2). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_4 : The maximum stellar type of star 4 (internal index 3). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "probability : The probability is a weighting applied to the star based on, say, the initial mass function. When running a grid of stars to simulate *all* stars, the summed probability of all the stars should be 1.0. : (null)\n",
+      "phasevol : The system's phase volume, used by binary_grid. : (null)\n",
+      "stellar_structure_algorithm : Set the stellar structure algorithm. 0=modified BSE (default), 1=none, 2=external function (must be defined by the calling code), 3=binary_c (not yet implemented). : (null)\n",
+      "solver : The type of solver. Default is the Forward-Euler (0), but could be RK2 (1), RK4 (2) or a predictor-corretor (3). : (null)\n",
+      "max_evolution_time : Set the maximum age for the stars (Myr). : (null)\n",
+      "max_model_number : Set the maximum number of models, ignored if 0 (default is 0). : (null)\n",
+      "monte_carlo_kicks : Turn on Monte-Carlo SN kicks. On (True) by default, and indeed other algorithms are probably broken. : (null)\n",
+      "disable_debug : Disables debug output. Only has an effect when DEBUG is 1, which probably requires a rebuild. Default FALSE. : (null)\n",
+      "timestep_logging : Turn on timestep logging (default is False). : (null)\n",
+      "rejects_in_log : Show timestep rejections in the main log (default is False). : (null)\n",
+      "vandenHeuvel_logging : Turn on van den Heuvel logging (default is False). : (null)\n",
+      "evolution_splitting : If True, turn on splitting of an evolutionary run if splitpoint (e.g. supernova) occurs. : (null)\n",
+      "disable_events : Whether to disable the new events code (defaults to False, so we use events by default)\n",
+      " : (null)\n",
+      "evolution_splitting_sn_eccentricity_threshold : Threshold eccentricity above which evolution splitting happens in a system with no SN kick. (0.01) : (null)\n",
+      "evolution_splitting_sn_n : Number of runs to split into when a SN occurs. : (null)\n",
+      "evolution_splitting_maxdepth : Max number of splits in an evolutionary run. : (null)\n",
+      "equation_of_state_algorithm : Set the equation of state algorithm. 0 = Paczynski. : (null)\n",
+      "opacity_algorithm : Set the opacity algorithm. 0 = Paczynski, 1 = Ferguson/Opal. : (null)\n",
+      "wind_mass_loss : Defines the algorithm used for stellar winds. 0 = none, 1 = Hurley et al. (2002), 2 = Schneider (2018). : 0\n",
+      "gbwind : Wind prescription for first red giant branch stars.  0=Reimers (Hurley et al 2000/2002; choose gb_reimers_eta=0.5 for their mass loss rate), 1=Schroeder+Cuntz 2005 (set gb_reimers_eta=1.0 for their mass loss rate). : (null)\n",
+      "mattsson_Orich_tpagbwind : Experimental : turns on Mattsson's TPAGB wind when the star is oxygen rich. Requires MATTSSON_MASS_LOSS. : (null)\n",
+      "magnetic_braking_factor : Multiplier for the magnetic braking angular momentum loss rate. : (null)\n",
+      "magnetic_braking_gamma : gamma factor in Rappaport style magnetic braking expression. : (null)\n",
+      "magnetic_braking_algorithm : Algorithm for the magnetic braking angular momentum loss rate. 0 = Hurley et al. 2002, 1 = Andronov, Pinnsonneault and Sills 2003, 2 = Barnes and Kim 2010  : (null)\n",
+      "helium_flash_mass_loss : Mass to be lost at the helium flash. : (null)\n",
+      "gb_reimers_eta : First red giant branch wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) : (null)\n",
+      "gbwindfac : Multiplier for the giant branch wind mass loss rate : (null)\n",
+      "tpagbwindfac : Multiplier for the TPAGB wind mass loss rate : (null)\n",
+      "eagbwindfac : Multiplier for the EAGB wind mass loss rate : (null)\n",
+      "nieuwenhuijzen_windfac : Multiplier for the Nieuwenhuijzen & de Jager wind mass loss rate : (null)\n",
+      "tpagbwind : Wind prescription during the TPAGB. 0=Karakas 2002 (a modified Vassiliadis and Wood 1993), 1=Hurley et al 2000/2002 (Vassiliadis and Wood 1993), 2=Reimers, 3=Bloecker, 4=Van Loon,  5=Rob's C-wind (broken?), 6,7=Vassiliadis and Wood 1993 (Karakas,Hurley variants respectively) when C/O>1, 8=Mattsson, 9 = Goldman et al. (2017), 10 = Beasor et al. (2020). : (null)\n",
+      "eagbwind : Wind prescription during the EAGB. 0=BSE (Hurley+2002, based on VW93), 1 = Goldman et al. (2017), 2 = Beasor et al. (2020). : (null)\n",
+      "wind_gas_to_dust_ratio : Gas to dust ratio used in wind calculations (e.g. Goldman et al. 2017). Typically 200 (Milky Way)-500 (Magellanic Clouds). Default is 200, approximately as in MW stars. : (null)\n",
+      "vwind_multiplier : Multiplier for the stellar wind velocity. : (null)\n",
+      "vwind_beta : Beta for stellar wind speed calculations, where vwind=sqrt(beta) * escape velocity. Default 0.125 (from BSE, Hurley et al. 2002).  : (null)\n",
+      "superwind_mira_switchon : In the Vassiliadis and Wood (1993) AGB wind prescription, the superwind is turned on at a given Mira period, usually 500 days. You can vary when this switch-on happens with this parameter. : (null)\n",
+      "vw93_mira_shift : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate depends on the Mira period plus this offset. Requires VW93_MIRA_SHIFT. : (null)\n",
+      "vw93_multiplier : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate is multiplied by this factor. Requires VW93_MULTIPLIER. : (null)\n",
+      "tpagb_reimers_eta : TPAGB Reimers wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) Note that Reimers is not the default TPAGB wind prescription. See also tpagbwind. : (null)\n",
+      "artificial_mass_accretion_rate%d : Constant mass accretion rate for star <n>. : (null)\n",
+      "artificial_angular_momentum_accretion_rate%d : Constant angular momentum accretion for star <n>. : (null)\n",
+      "artificial_orbital_angular_momentum_accretion_rate : Constant angular momentum accretion rate on the orbit. : (null)\n",
+      "artificial_accretion_start_time : Time at which artificial accretion stars. Ignored if <0 (default is -1). : (null)\n",
+      "artificial_accretion_end_time : Time at which artificial accretion ends. Ignored if <0 (default is -1). : (null)\n",
+      "wr_wind : Massive-star (WR) wind prescription. 0 = Hurley et al 2000/2002, 1=Maeder and Meynet, 2=Nugis and Lamers, 3=John Eldridge's version of Vink's early-2000s wind (See Lynnette Dray's thesis, or John Eldridge's thesis) : (null)\n",
+      "wr_wind_fac : Massive-star (WR) wind multiplication factor. : (null)\n",
+      "wrwindfac : Massive-star (WR) wind multiplication factor. Synonymous with wr_wind_fac (which you should use instead). : (null)\n",
+      "BH_prescription : Black hole mass prescrition: relates the mass of a newly formed black hole to its progenitor's (CO) core mass. 0=Hurley et al 2000/2002, 1=Belczynski (early 2000s). : (null)\n",
+      "PPISN_prescription : (Pulsational) Pair-Instability Supernova prescription: Relates initial helium core mass of star to whether the star undergoes PPISN or PISN. Requires PPISN flag to be True (see binary_c_parameters.h). 0=no ppisn, 1=Farmer et al 2019. : Ignore\n",
+      "sn_kick_distribution_II : Set the distribution of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_ECAP : Set the distribution of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_NS_NS : Set the distribution of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IBC : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_GRB_COLLAPSAR : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_TZ : Set the distribution of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_AIC_BH : Set the distribution of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_BH : Set the distribution of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_NS : Set the distribution of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD : Set the distribution of speeds applied to any survivor of a hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD_subluminous : Set the distribution of speeds applied to any survivor of a subluminous hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PPISN : Set the distribution of speeds applied to PPISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PISN : Set the distribution of speeds applied to PISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PHDIS : Set the distribution of speeds applied to PHDIS supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_II : Set the dispersion of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_ECAP : Set the dispersion of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_NS_NS : Set the dispersion of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IBC : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_GRB_COLLAPSAR : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_TZ : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_AIC_BH : Set the dispersion of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_BH : Set the dispersion of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_NS : Set the dispersion of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD : Set the dispersion of speeds applied to the survivor of a SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD_subluminous : Set the dispersion of speeds applied to the survivor of a subluminous SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PPISN : Set the dispersion of speeds applied to the survivor of a PPISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PISN : Set the dispersion of speeds applied to the survivor of a PISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PHDIS : Set the dispersion of speeds applied to the survivor of a PHDIS supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_companion_IA_He : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia He supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_ELD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia ELD (sub-Mch) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an accretion induced collapse (supernova) occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_ECAP : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an electron capture supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_He_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia helium merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_NS_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron-star neutron-star merger. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_GRB_COLLAPSAR : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a GRB Collapsar (rapidly rotating SN Ibc) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_HeStarIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a He-star Ia supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IBC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type Ib/c supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_II : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type II supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type IIa supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_WDKICK : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a WD is kicked. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_TZ : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Thorne-Zytkow object is formed. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron star collapses to a black hole. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when two black holes merge. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a black hole merges with a neutron star. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD_subluminous : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a subluminous hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PPISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PPISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PHDIS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PHDIS supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "wd_sigma : Set the speed at which white dwarfs are kicked when they form, in km/s. Default is zero (i.e. no kick). Requires WD_KICKS. : (null)\n",
+      "wd_kick_direction : Set the direction of white dwarf kicks. 0 = random, 1 = up, 2 = forward, 3 = backward, 4 = inward, 5 = outward. Requires WD_KICKS. : (null)\n",
+      "wd_kick_when : Decide when to kick a white dwarf. 0=at birth, 1=at first RLOF, 2=at given pulse number (see wd_kick_pulse_number), 3 at every pulse Requires WD_KICKS. : (null)\n",
+      "wd_kick_pulse_number : Apply a kick to a star at a desired pulse number on the TPAGB (i.e. pre-WD). Requires WD_KICKS. : (null)\n",
+      "minimum_helium_ignition_core_mass : Minimum helium core mass required to ignite helium in the case that the hydrogen envelope is stripped on the giant branch, e.g. to make an sdB or sdO star. Typically 0.4, if 0.0 then the BSE algorithm (based on the total mass) is used. : (null)\n",
+      "minimum_CO_core_mass_for_carbon_ignition : Minimum CO core mass for carbon ignition, assuming Mc,bagb>1.6Msun. Typically around 1.08Msun (Pols+1998). : (null)\n",
+      "minimum_CO_core_mass_for_neon_ignition : Minimum CO core mass for neon ignition. Typically around 1.42Msun. Stars that have cores that ignite carbon, but not neon explode in electon-capture supernovae. : (null)\n",
+      "minimum_mcbagb_for_nondegenerate_carbon_ignition : Minimum Mc,bagb (core mass at the base of the AGB) for non-degenerate carbon ignition. Typically around 2.25Msun (Pols+1998). : (null)\n",
+      "maximum_mcbagb_for_degenerate_carbon_ignition : Maximum Mc,bagb (core mass at the base of the AGB) for degenerate carbon ignition. Typically around 1.6Msun (Pols+1998). : (null)\n",
+      "max_neutron_star_mass : Maximum mass of a neutron star before it collapses to a black hole. Typically around 2Msun. : (null)\n",
+      "chandrasekhar_mass : The Chandrasekhar mass, usually 1.44Msun : (null)\n",
+      "delta_mcmin : A parameter to reduce the minimum core mass for third dredge up to occur on the TPAGB. As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "lambda_min : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. See also lambda_multiplier. : (null)\n",
+      "lambda_multiplier : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "minimum_envelope_mass_for_third_dredgeup : The minimum envelope mass for third dredge up on the TPAGB. Early, solar metallicity models by Straniero et al suggested 0.5Msun is typical. However, circumstantial evidence (Izzard et al 2009) as well as newer models by Stancliffe and Karakas suggest that at low metallicity a value nearer zero is more appropriate. : (null)\n",
+      "mass_of_pmz : The mass in the partial mixing zone of a TPAGB star, using the Karakas 2012 tables. Ask Carlo Abate for more details, or see the series of papers Abate et al 2012, 2013, 2014. Requires NUCSYN and USE_TABULAR_INTERSHELL_ABUNDANCES_KARAKAS_2012. : (null)\n",
+      "c13_eff : The \"efficiency\" of partial mixing in a TPAGB star intershell region, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "mc13_pocket_multiplier : Multiplies the mass in the partial mixing zone of a TPAGB star, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "tides_convective_damping : Tidal convective damping algorithm. 0=TIDES_HURLEY2002 Zahn 197x timescales + Hut, as in Hurley et al (2002), 1 = TIDES_ZAHN1989 : Zahn 1989 lambdas + Hut. : (null)\n",
+      "E2_prescription : Choose how to calculate the E2 structural parameter (used in tidal timescale calculations). 0=Hurley 1=Izzard (see Siess et al 2013). : (null)\n",
+      "dtfac : A parameter to decrease the timestep ONLY during the TPAGB phase. : (null)\n",
+      "hbbtfac : A parameter to modulate the temperature at the base of the hot-bottom burning zone in TPAGB stars. (Works only if NUCSYN is defined) : (null)\n",
+      "wind_multiplier_%d : Wind multiplier for the stellar type specified by the intger %d. By default these are all 1.0. : (null)\n",
+      "wind_type_multiplier_%d : Wind multiplier for different types of wind (MS, GB, AGB, WR, LBV, OTHER), given by the integer %d. By default these are all 1.0. : (null)\n",
+      "pre_main_sequence : Set to True to turn on pre-main sequence evolution. Currently this is not a special stellar type, rather the first (small) fraction of the main sequence has increased radii to match the Railton et al 2014 fits to Tout's pre-main sequence stars. Requires PRE_MAIN_SEQUENCE. See also pre_main_sequence_fit_lobes. : (null)\n",
+      "pre_main_sequence_fit_lobes : Set to True force a pre-main sequence star into its Roche lobe. This is done by artificially aging it. Requires PRE_MAIN_SEQUENCE : (null)\n",
+      "small_envelope_method : Choose the method used to determine the stellar radius when the envelope mass is very thin. 0 = Hurley et al. (2002), 1 = Miller Bertolami et al. (2016+) for GB and AGB stars only. : (null)\n",
+      "timestep_modulator : Multiplier applied to the global timestep. Requires TIMESTEP_MODULATION. : (null)\n",
+      "timestep_multiplier%d : Multiplier applied to timestep limit <n>. : (null)\n",
+      "maximum_timestep : The maximum timestep (MYr). : (null)\n",
+      "zoomfac_multiplier_decrease : When a timestep is rejected, decrease the timestep by this factor (0.5). : (null)\n",
+      "zoomfac_multiplier_increase : When a timestep is rejected, zooms, then succeeds, increase the timestep by this factor (1.2). : (null)\n",
+      "maximum_timestep_factor : The maximum factor between two subsequent timesteps (1.2). : (null)\n",
+      "maximum_nuclear_burning_timestep : The maximum timestep (MYr) in any nuclear burning phase. : (null)\n",
+      "nova_retention_method : Algorithm used to calculate the amount of mass retained during a nova explosion. 0=use nova_retention_fraction. (other methods pending) : (null)\n",
+      "MINT_metallicity : This sets the metallicity for MINT. It is ignored if set to -1.0, the default, in which case the normal metallicity parameter is used. : (null)\n",
+      "gaia_Teff_binwidth : log10(Effective temperature) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_L_binwidth : log10(luminosity) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_colour_transform_method : Use this to select the method used to transform to Gaia colours from other colour schemes. GAIA_CONVERSION_UBVRI_UNIVARIATE_JORDI2010 = 0 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_UBVRI_BIVARIATE_JORDI2010 = 1 Jordi et al.'s bivariate UBVRI fits, GAIA_CONVERSION_ugriz_UNIVARIATE_JORDI2010 = 2 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_ugriz_BIVARIATE_JORDI2010 = 3 Jordi et al.'s univariate ugriv fits, GAIA_CONVERSION_UBVRI_UNIVARIATE_EVANS2018 = 4 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_ugriz_UNIVARIATE_EVANS2018 = 5 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_UBVRI_RIELLO2020 = 6 Riello et al. (2020, DR3) fits, GAIA_CONVERSION_ugriz_RIELLO2020 = 7 Riello et al. (2020, DR3) fits. : (null)\n",
+      "rotationally_enhanced_mass_loss : Set to 1 to enable rotationally enhanced mass loss rate algorithms: 0= none, 1=formula cf. Langer models (=ROTATIONALLY_ENHANCED_MASSLOSS_LANGER_FORMULA), 2=limit accretion rate before wind loss is applied, 3 = both 1 and 2. See also rotationally_enhanced_exponent : (null)\n",
+      "AGB_core_algorithm : Algorithm to use for calculating AGB core masses. 0=Hurley et al. 2002 if no NUCSYN, Karakas 2002 if NUCSYN is defined; 1=Hurley et al. 2002 (overshooting models); 1=Karakas 2002 (non-overshooting models). : (null)\n",
+      "AGB_radius_algorithm : Algorithm to use for calculating radii on the TPAGB. : (null)\n",
+      "AGB_luminosity_algorithm : Algorithm to use for calculating luminosities on the TPAGB. : (null)\n",
+      "AGB_3dup_algorithm : Algorithm to use for calculating third dredge up efficiency on the TPAGB. : (null)\n",
+      "overspin_algorithm : Algorithm to determine what we do when a star is rotating at its breakup velocity. OVERSPIN_BSE (0) conservatively transfers the angular momentum back to the orbit. OVERSPIN_MASSLOSS uses the rotationally_enhanced_massloss parameter to lose mass which carries away the angular momentum. : (null)\n",
+      "rotationally_enhanced_exponent : The exponent (power) by which rotationally enhanced mass loss is raised. Requires ROTATIONALLY_ENHANCED_MASS_LOSS. See also rotationally_enhanced_mass_loss. : (null)\n",
+      "batchmode : Set the batchmode control variable. Use only if you know what you are doing! : (null)\n",
+      "speedtests : If True, turns on speedtests during version information (off by default). : (null)\n",
+      "use_fixed_timestep_%d : Set to True to use fixed timestep <n>, False to turn off. Fixed timesteps are on (this is True) by default. : (null)\n",
+      "task%d : Control tasks to be performed by binary_c. By default, these are all TRUE. For more information see binary_c_macros.h, particularly the BINARY_C_TASK_* macros. : (null)\n",
+      "orbiting_object : Usage: --orbiting_object mass,spinrate,central_object,period. : 1.0\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_wind_accretion_multiplier : Multiplier for wind accretion on orbiting objects. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "orbiting_objects_close_pc_threshold : How close are orbiting objects allowed to be? Set this to be the absolute percentage difference minimum. : (null)\n",
+      "orbiting_objects_tides_multiplier : Multiplier for tidal torques on orbiting objects. : (null)\n",
+      "evaporate_escaped_orbiting_objects : If True, evaporate orbiting objects that have escaped the system. : (null)\n",
+      "RLOF_transition_objects_escape : If True, objects that escape their Roche lobe are ejected from the system, otherwise they are placed just outside the minimum stable orbit. : (null)\n",
+      "PN_resolve : If True, the timestep will be shortened to resolve better the PN phase (FALSE). : (null)\n",
+      "PN_resolve_minimum_luminosity : The luminosity above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_maximum_envelope_mass : The envelope mass below which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_minimum_effective_temperature : The minimum effective temperature above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_fast_wind : If True, thin-envelope PNe will have fast winds (FALSE). : (null)\n",
+      "PN_fast_wind_dm_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_mdot_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_dm_AGB : The envelope mass below which fast wind used during the AGB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "PN_fast_wind_mdot_AGB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "HeWD_HeWD_ignition_mass : HeWD-HeWD mergers above this mass reignite helium. (0.3) : (null)\n",
+      "wind_Nieuwenhuijzen_luminosity_lower_limit : Above this luminosity we activate the Nieuwenhuijzen and de Jager wind (4e3 Lsun). : (null)\n",
+      "wind_LBV_luminosity_lower_limit : Above this luminosity we activate the LBV wind (6e5 Lsun). : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Binary\n",
+      "############################################################\n",
+      "separation : Set the orbital separation (actually the semi-major axis) of the binary (internal index 0, stellar indices 0 and 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_triple : Set the orbital separation (actually the semi-major axis) of the triple (internal index 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_quadruple : Set the orbital separation (actually the semi-major axis) of the quadruple (internal index 2) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "orbital_period : Set the initial orbital period of the binary, stars 1 and 2 (internal indices 0 and 1) in days. See also separation. : (null)\n",
+      "orbital_period_triple : Set the initial orbital period of the triple in days. See also separation. : (null)\n",
+      "orbital_period_quadruple : Set the orbital period of the outer binary in a quadrulple (stars 3 and 4, internal indices 2 and 3) in days. See also separation. : (null)\n",
+      "eccentricity : Set the initial eccentricity of the binary orbit (stars 1 and 2, internal indices 0 and 1). : (null)\n",
+      "eccentricity_triple : Set the initial eccentricity of the triple orbit. : (null)\n",
+      "eccentricity_quadruple : Set the initial eccentricity of the outer binary of a quadruple (stars 3 and 4, internal indices 2 and 3). : (null)\n",
+      "incliniation : Set the initial orbital_inclination of the binary relative to zero. : (null)\n",
+      "incliniation_triple : Set the initial orbital_inclination of the triple orbit relative to zero. : (null)\n",
+      "incliniation_quadruple : Set the initial orbital_inclinationy of the quadruple orbit relative to zero. : (null)\n",
+      "orbital_phase : Set the initial orbital phase of the binary orbit. : (null)\n",
+      "orbital_phase_triple : Set the initial orbital phase of the triple orbit. : (null)\n",
+      "orbital_phase_quadruple : Set the initial orbital phase of the quadruple orbit. : (null)\n",
+      "argument_of_periastron : Set the initial argument of periastron of the binary orbit. : (null)\n",
+      "argument_of_periastron_triple : Set the initial argument of periastron of the triple orbit. : (null)\n",
+      "argument_of_periastron_quadruple : Set the initial argument of periastron of the quadruple orbit. : (null)\n",
+      "disc_timestep_factor : Factor that multiplies the natural timestep of a disc. : (null)\n",
+      "white_dwarf_cooling_model : White dwarf cooling model, relates age to luminosity. WHITE_DWARF_COOLING_MESTEL = 0 is Mestel's model, WHITE_DWARF_COOLING_MESTEL_MODIFIED = 1 is Hurley's modified Mestel model, WHITE_DWARF_COOLING_CARRASCO2014 = 2 is based on Carrasco (2014) tables.   : (null)\n",
+      "white_dwarf_radius_model : White dwarf radius model, radius to mass (and perhaps age). WHITE_DWARF_RADIUS_NAUENBERG1972 = 0 Nauenberg (1972), WHITE_DWARF_RADIUS_MU = 1 mu-dependent variant, WHITE_DWARF_RADIUS_CARRASCO2014 = 2 is based on Carrasco (2014) tables. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_accretion_method : Chooses where the mass that is accreted from the inner edge of a circumbinary disc goes, i.e. to which star. 0 = Young and Clarke 2015, 1 = Gerosa et al 2015, 2 = 50:50 (i.e. not dependence on mass). : (null)\n",
+      "cbdisc_inner_edge_stripping : If True, allow inner edge mass stripping. : (null)\n",
+      "cbdisc_end_evolution_after_disc : If True, stop evolution when a disc evaporates. : (null)\n",
+      "cbdisc_no_wind_if_cbdisc : If True, disable stellar winds when there is a circumbinary disc. : (null)\n",
+      "cbdisc_outer_edge_stripping : If True, allow outer edge mass stripping. : (null)\n",
+      "disc_n_monte_carlo_guesses : Number of monte carlo guesses to try in the disc solver if the normal list of guesses fails (0). : (null)\n",
+      "disc_log : If 1, turn on the disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log2d : If 1, turn on the 2d disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log_dt : If non-zero, only allows disc log output every disc_log_dt Myr. : (null)\n",
+      "disc_log_directory : Directory into which disc logging is sent (must exist!). : /tmp/\n",
+      "post_ce_adaptive_menv : If TRUE, and if post_ce_objects_have_envelopes is TRUE, then the envelope mass of a post-CE star is such that it sits just inside its Roche lobe. If FALSE then a fixed (thin) envelope mass is applied that depends on the stellar type (see macros POST_CE_ENVELOPE_DM_GB, POST_CE_ENVELOPE_DM_EAGB and POST_CE_ENVELOPE_DM_TPAGB). : (null)\n",
+      "post_ce_objects_have_envelopes : If TRUE then post-common-envelope objects have thin envelopes. You need this if you are to have post-CE post-AGB stars. Note that this *may* be unstable, i.e. you may end up having many CEEs. The mass in the envelope is controlled by post_ce_adaptive_menv. TRUE by default. : (null)\n",
+      "PN_comenv_transition_time : post-common envelope transition time in years (1e2).  This is the time taken to move from CEE ejection to Teff > 30e4 K. Hall et al. (2013) suggest ~100 years. : (null)\n",
+      "minimum_time_between_PNe : The minimum time (Myr) between planetary nebula detections. This prevents multiple, fast common envelopes triggering two PNe (0.1). : (null)\n",
+      "PN_Hall_fading_time_algorithm : In stars with low mass (<0.45Msun) cores, you can choose to set the PN fading time to either the minimum (PN_HALL_FADING_TIME_ALGORITHM_MINIMUM) or maximum (PN_HALL_FADING_TIME_ALGORITHM_MAXIMUM) as shown in Fig. 6 of Hall et al. (2013). : (null)\n",
+      "PPN_envelope_mass : Desired pre-planetary nebula (post-AGB) envelope mass. : (null)\n",
+      "cbdisc_eccentricity_pumping_method : Select from various eccentricity-pumping methods when there is a circumbinary disc. Requires DISCS. 0 = off. : (null)\n",
+      "cbdisc_viscous_photoevaporative_coupling : Set to 1 to turn on viscous-photoevaporative coupling in circumbinary discs. Requires DISCS. 0 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_NONE = off, 1 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_INSTANT instant, 2 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_VISCOUS slow, viscous wind. : (null)\n",
+      "cbdisc_inner_edge_stripping_timescale : Defines the timescale for mass loss from by inner edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_in. : (null)\n",
+      "cbdisc_outer_edge_stripping_timescale : Defines the timescale for mass loss from by outer edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_out. : (null)\n",
+      "cbdisc_viscous_L2_coupling : Set to 1 to turn on viscous-L2-loss coupling in circumbinary discs. Requires DISCS. 0 = off. : (null)\n",
+      "gravitational_radiation_model : Model for gravitational radiation from the system. 0=Hurley et al 2002 (Landau and Lifshitz 1951). 1 = as 0 but only when there is no RLOF. 2 = none. : (null)\n",
+      "nova_irradiation_multiplier : Multiplier for nova-radiative induced mass loss. (Shara+1986) : (null)\n",
+      "gravitational_radiation_modulator_J : Modulator for gravitational wave radiation angular momentum loss rate (1.0). : (null)\n",
+      "gravitational_radiation_modulator_e : Modulator for gravitational wave radiation eccentricity pumping rate (1.0). : (null)\n",
+      "nova_faml_multiplier : Nova friction-induced angular momentum loss multiplier. (Shara+1986) : (null)\n",
+      "RLOF_angular_momentum_transfer_model : Choose angular momentum transfer model in RLOF. 0=BSE (with discs), 1=conservative : (null)\n",
+      "post_SN_orbit_method : Method by which the post-SN orbit is calculated. 0=BSE, 1=Tauris&Taken 1998. : (null)\n",
+      "multiplicity : Multiplicity: 1=single star, 2=binary, 3=triple, 4=quadruple. : (null)\n",
+      "accretion_limit_eddington_steady_multiplier : Steady accretion is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_steady_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_LMMS_multiplier : Accretion from a low-mass, convective, main_sequence star is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_LMMS_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_WD_to_remnant_multiplier : Accretion from a WD onto a remnant star (e.g. another white dwarf, neutron star or black hole) is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_WD_to_remnant_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_thermal_multiplier : Mass transfer onto a MS, HG or CHeB star is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "accretion_limit_dynamical_multiplier : Mass transfer is limited by the accretor's dynamical rate times this multiplier. : (null)\n",
+      "donor_limit_envelope_multiplier : Mass transfer by RLOF is limited by this fraction of the donor's envelope mass per timestep : (null)\n",
+      "donor_limit_thermal_multiplier : Mass transfer by RLOF is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "donor_limit_dynamical_multiplier : Mass transfer by RLOF is limited by the donor's dynamical rate times this multiplier. : (null)\n",
+      "Bondi_Hoyle_accretion_factor : Wind accretion rate, as calculated by the Bondi-Hoyle-Littleton formula, multiplcation factor. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "tidal_strength_factor : A modulator for the tidal strength. If this factor > 1 then tides are stronger, i.e. tidal timescales are reduced. : (null)\n",
+      "hachisu_qcrit : Critical q=Maccretor/Mdonor above which Hachisu's disk wind turns on. : (null)\n",
+      "hachisu_disk_wind : Set to True to turn on Hachisu's disk wind when material accretes too fast onto a white dwarf. This helps to make more SNeIa. See also hachisu_qcrit. : (null)\n",
+      "mass_accretion_for_eld : The mass that must be accreted onto a COWD for it to ignite as an edge-lit detonation SNIa. : (null)\n",
+      "WDWD_merger_algorithm : Algorithm to be used when merging two white dwarfs. 0 = Hurley et al. (2002), 1 = Perets+ (2019), 2 = Chen+ (2016, todo)  : (null)\n",
+      "type_Ia_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from Chandrasekhar-mass exploders. 0 = DD7 (Iwamoto 1999), 1 = Seitenzahl 2013 3D hydro yields (you must also set Seitenzahl2013_model)  : (null)\n",
+      "Seitenzahl2013_model : Which of Seitenzahl et al. 2013's models to use? One of N1,N3,N5,N10,N20,N40,N100L,N100,N100H,N150,N200,N300C,N1600,N1600C,N100_Z0.5,N100_Z0.1,N100_Z0.01 (defaults to N100). : N1\n",
+      "type_Ia_sub_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from sub-Chandrasekhar-mass exploders. (Currently unused.) : (null)\n",
+      "max_HeWD_mass : The maximum mass a HeWD can have before it ignites helium (0.7). : (null)\n",
+      "merger_mass_loss_fraction : Fraction of the total mass which is lost when stars merge. : (null)\n",
+      "merger_angular_momentum_factor : When two stars merge the resulting single star retains a fraction of the total system angular momentum (or the critical spin angular momentum, if it is smaller) multiplied by this factor. : (null)\n",
+      "wind_angular_momentum_loss : Prescription for losing angular momentum in a stellar wind. 0=Hurley et al 2002 ('Tout') prescription, 1=lw i.e. a factor multiplying the specific orbital angular momentum, 2=lw hybrid for fast winds. Set wind_djorb_fac to the desired factor.. : (null)\n",
+      "wind_djorb_fac : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=0 (the Tout/Hurley et al 2002 prescription). See wind_angular_momentum_loss. : (null)\n",
+      "lw : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=1,2 (the 'lw' prescription). See wind_angular_momentum_loss. : (null)\n",
+      "VW93_EAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "VW93_TPAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "use_periastron_Roche_radius : Set this to True to use the Roche lobe radius at periastron, rather than (the default to) assume a circular orbit. This will be useful one day when we treat RLOF in eccentric orbits properly, hopefully. : (null)\n",
+      "qcrit_LMMS : Apply critical q=Mdonor/Maccretor value for low-mass main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_LMMS : Apply critical q=Mdonor/Maccretor value for (low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "mass_for_Hestar_Ia_upper : Only helium stars below this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_lower. : (null)\n",
+      "mass_for_Hestar_Ia_lower : Only helium stars above this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_upper. : (null)\n",
+      "alphaCB : Circumbinary disk viscosity parameter, alpha. : (null)\n",
+      "minimum_donor_menv_for_comenv : Minimum donor envelope mass for common envelope evolution to be triggered (Msun). Default 0. : (null)\n",
+      "comenv_prescription : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_prescription%d : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_ejection_spin_method : When a common envelope is ejected, we need to decide how fast the stars are left spinning. COMENV_EJECTION_SPIN_METHOD_DO_NOTHING (0) is the default, this just leaves the stars/stellar cores spinning with the same spin rate (omega = angular velocity) with which they entered the common envelope phase. COMENV_EJECTION_SPIN_METHOD_SYCHRONIZE instead tidally synchronizes the stars with their new orbital angular velocity. : (null)\n",
+      "comenv_merger_spin_method : When a common envelope binary merges, we need to decide how fast the resulting single star is left spinning. COMENV_MERGER_SPIN_METHOD_SPECIFIC (0) is the default, this preserves angular momentum but limits the specific angular momentum of the merged star to the specific angular momentum of the system at the onset of common envelope evolution. COMENV_MERGER_SPIN_METHOD_CONSERVE_ANGMOM (1) sets the merger's angular momentum to be that of the system at the onset of common envelope evolution (which means the star may be rotating supercritically). COMENV_MERGER_SPIN_METHOD_CONSERVE_OMEGA (2) sets the spin rate (angular frequency = omega) of the merged star to be that of the orbit just at the onset of common envelope evolution. : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "comenv_ms_accretion_fraction : Experimental. During common envelope evolution, a main sequence may accrete a fraction of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_mass. : (null)\n",
+      "comenv_ns_accretion_mass : Experimental. During common envelope evolution, a neutron star may accrete some of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_fraction. : (null)\n",
+      "comenv_ns_accretion_fraction : Experimental. During common envelope evolution, a neutron star may accrete a fraction of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_mass. : (null)\n",
+      "alpha_ce : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "alpha_ce%d : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "lambda_ce : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "lambda_ce%d : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "comenv_splitmass : When lambda_ce=-2, the envelope binding energy, lambda, is calculated using a polytropic formalism. The comenv_splitmass defines the point, in the units of the core mass, above which material is ejected. : (null)\n",
+      "nelemans_recalc_eccentricity : If True, recalculate the eccentricity after angular momentum is removed.  : (null)\n",
+      "comenv_post_eccentricity : Eccentricity remaining after common envelope ejection. : (null)\n",
+      "nelemans_gamma : Set the fraction of the orbital specific angular momentum that is used to eject the common envelope according to the Nelemans and Tout prescription. See also nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_minq : Only activate the Nelemans and Tout common envelope prescription for q>nelemans_minq. See also nelemans_gamma, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_max_frac_j_change : Maximum fractional angular momentum change in the Nelemans and Tout common envelope prescription. See also nelemans_gamma, nelemans_minq, nelemans_n_comenvs. : (null)\n",
+      "nelemans_n_comenvs : Set the maximum number of common envelope ejections allowed to follow the Nelemans and Tout prescription, after which the standard alpha prescription is used. : (null)\n",
+      "lambda_ionisation : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_ionisation%d : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_enthalpy : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "lambda_enthalpy%d : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "cbdisc_albedo : Circumbinary-disc albedo. Requires DISCS. : (null)\n",
+      "cbdisc_gamma : Circumbinary disc gamma (equation of state) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_alpha : Circumbinary disc alpha (viscosity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_kappa : Circumbinary disc kappa (opacity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_evaporation_timescale : Circumbinary disc minimum evaporation timescale (years). If (slow, not edge stripped) mass loss would evaporate the disc on a timescale less than this, simply evaporate the disc immediated. Usually set to 1y, ignore if zero. Requires DISCS. : (null)\n",
+      "cbdisc_torquef : Circumbinary disc binary torque multiplier. Requires DISCS. : (null)\n",
+      "cbdisc_max_lifetime : Circumbinary disc maximum lifetime (years, ignored if 0). Requires DISCS. : (null)\n",
+      "cbdisc_init_dM : On cbdisc start, reduce mass by a fraction dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_init_dJdM : On cbdisc start, reduce angular momentum by a fraction dJ/dM*dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_constant_rate : Circumbinary disc constant mass loss rate (Msun/year). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_FUV_multiplier : Circumbinary disc FUV mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_Xray_multiplier : Circumbinary disc X-ray mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_ram_pressure_multiplier : Circumbinary disc interstellar medium ram pressure stripping mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_pressure : Circumbinary disc interstellar medium ram pressure in units of Boltzmann constant per Kelvin (I think...). Requires DISCS. Typically 3000.0. See e.g. http://www.astronomy.ohio-state.edu/~pogge/Ast871/Notes/Intro.pdf page 15 or https://arxiv.org/pdf/0902.0820.pdf Fig. 1 (left panel). : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_multiplier : Circumbinary disc inner edge viscous mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_angular_momentum_multiplier : Circumbinary disc inner edge viscous angular momentum multiplier (no units). The inner edge angular momentum Requires DISCS. : (null)\n",
+      "cbdisc_resonance_multiplier : Circumbinary disc resonant interaction multiplier, affects eccentricity pumping and angular momentum rates. Requires DISCS. : (null)\n",
+      "cbdisc_resonance_damping : Circumbinary disc resonant interaction damping: should be on (True) to damp the l=1, m=2 resonance when the disc inner edge lies outside the resonance location. Requires DISCS. : (null)\n",
+      "cbdisc_fail_ring_inside_separation : If True, while converging on a structure, circumbinary discs with Rring < the binary separation are immediately failed. : (null)\n",
+      "cbdisc_mass_loss_inner_L2_cross_multiplier : Circumbinary disc inner edge L2-crossing mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_minimum_luminosity : Circumbinary disc minimum luminosity. If the disc becomes dimmer than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_mass : Circumbinary disc minimum mass. If the disc becomes less massive than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_fRing : Circumbinary disc minimum fRing. If the disc becomes a ring, and fRing = |Rout/Rin-1| < this value (and this value is non-zero), the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "comenv_disc_angmom_fraction : If >0 Fraction of the common envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the moments of inertia to calculate (deprecated), if -2 use the common envelope's specific angular momentum, if -3 uses the L2 point at the end of the common envelope to set the angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "comenv_disc_mass_fraction : Fraction of the common envelope's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "wind_disc_angmom_fraction : If >0 Fraction of the wind envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the L2 point's specific angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "wind_disc_mass_fraction : Fraction of the stellar wind's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "WRLOF_method : Choose whether and how to apply wind-Roche-lobe-overflow. 0=none, 1=q-dependent, 2=quadratic See Abate et al 2013/14 for details. Requires WRLOF_MASS_TRANSFER. : (null)\n",
+      "minimum_timestep : The minimum timestep (Myr). : (null)\n",
+      "timestep_solver_factor : Factor applied in timestep_limits, e.g. to prevent X changing too fast by comparing to X/dX/dt, which is usually 1 but can be higher to lengthen timesteps when using an alternative solver. : (null)\n",
+      "RLOF_mdot_factor : Multiplier applied to the mass transfer rate during Roche-lobe overflow. Requires RLOF_MDOT_MODULATION. : (null)\n",
+      "RLOF_f : Factor to enlarge a Roche lobe, nominally because of radiation pressure (see Dermine et al paper). Requires RLOF_RADIATION_CORRECTION. : (null)\n",
+      "minimum_separation_for_instant_RLOF : If True, instead of evolving the system just report the minimum separation (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_orbital_period_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "minimum_orbital_period_for_instant_RLOF : If True, instead of evolving the system just report the minimum orbital period (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_separation_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "maximum_mass_ratio_for_instant_RLOF : If True, instead of evolving the system just report the maximum mass ratio (on the zero-age main sequence) that would lead to instant RLOF, given M1 and orbital period. Used by binary_grid. See also minimum_separation_for_instant_RLOF and minimum_orbital_period_for_instant_RLOF. : (null)\n",
+      "RLOF_method : Use RLOF_method to choose the algorithm you use for Roche-lobe overflow mass loss rate calculations. 0=Hurley et al 2002, 1=Adaptive (for radiative stars) R=RL method, 2=Ritter (probably broken), 3=Claeys etal 2014 variant on Hurley et al 2002. : (null)\n",
+      "RLOF_interpolation_method : When a star overflows its Roche lobe, it always has R>RL because of the limited time resolution of the simulation. Binary_c then uses an algorithm to get back to when R~RL (within a desired tolerance, set in RLOF_ENTRY_THRESHOLD which is usually 1.02, i.e. overflow of 2%). You can choose algorithm 0, the Hurley et al 2002 method which reverses time (i.e. uses a Newton-like scheme), or 1 to use the binary_c method which rejects a timestep (and hence does no logging on that timestep) and repeats with half the timestep until R~RL. The latter is now the default, because this means there are no negative timesteps which break various other algorithms (e.g. nucleosynthesis). : (null)\n",
+      "nova_retention_fraction : The mass accreted during a nova as fraction of mass transferred : (null)\n",
+      "beta_reverse_nova : The fraction of mass ejected in a nova explosion which is accreted back onto the companion star. Set to -1 to automatically calculate based on a geometric argument, or 0 or positive to set the value. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_hydrogen_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is hydrogen rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_helium_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_other_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is neither hydrogen nor helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a hydrogen-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_helium_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a helium-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_other_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope when the donor is neither hydrogen nor helium rich. Below this mass transfer leads to stable burning. : (null)\n",
+      "CRAP_parameter : Tidally enhanced mass loss parameter. See Tout and Eggleton's paper on the subject. (Was the parameter bb). : (null)\n",
+      "individual_novae : If individual_novae is True, novae are resolved such that each explosion is performed separtaely. : (null)\n",
+      "nova_timestep_accelerator_num : The nova timestep is accelerated if the nova number exceeds nova_timestep_accelerator_num. If zero or negative, acceleration is off. See also nova_timestep_accelerator_index and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_index : The index at which the nova timestep is accelerated. A larger value gives longer timesteps. See also nova_timestep_accelerator_num and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_max : The nova timestep is accelerated by a factor that is capped at nova_timestep_accelerator_max. This parameter is ignored if it is zero or negative. See also nova_timestep_accelerator_num and nova_timestep_accelerator_index. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nonconservative_angmom_gamma : Mass lost from the system (but NOT from a stellar wind) takes a fraction gamma of the orbital angular momentum with it. Set to -1 to take the specific angular momentum of the donor star. Set to -2 to take super-Eddington, nova and disk-wind angular momenta as if a wind from the accretor. : (null)\n",
+      "max_stellar_angmom_change : Maxmimum fractional change in stellar angular momentum allowed before a timestep is rejected (0.05). : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Nucsyn\n",
+      "############################################################\n",
+      "third_dup : If True, enables third dredge up. Requires NUCSYN and NUCSYN_THIRD_DREDGE_UP. : (null)\n",
+      "third_dup_multiplier : Usage: --third_dup_multiplier <i> <f>. Multiplies the abundance of element <i> by <f> during third dredge up. : 1.0\n",
+      "NeNaMgAl : Enables NeNaMgAl reaction network. Requires NUCSYN and NUCSYN_HBB. : Ignore\n",
+      "nucsyn_network%d : Usage: --nucsyn_network%d <boolean>. Turn a nuclear network on or off. : (null)\n",
+      "nucsyn_network_error%d : Usage: --nucsyn_network_error%d <f>. Threshold error in nuclear network solver for network %d. : (null)\n",
+      "nucreacmult%d : Usage: --nucreacmult%d <f>. Multiply nuclear reaction given by the integer %d (integer) by f (float).  : (null)\n",
+      "nucsyn_metallicity : This sets the metallicity of the nucleosynthesis algorithms, i.e. the amount (by mass) of matter which is not hydrogen or helium. Usually you'd just set this with the metallicity parameter, but if you want the nucleosynthesis to be outside the range of the stellar evolution algorithm (e.g. Z=0 or Z=0.04) then you need to use nucsyn_metallicity. That said, it's also outside the range of some of the nucleosynthesis algorithms as well, so you have been warned! : (null)\n",
+      "nucsyn_solver : Choose the solver used in nuclear burning. 0 = KAPS_RENTROP is a Kaps-Rentrop scheme (fast, not great for stiff problems), 1 = LSODA (Adams/BSF switcher), 2 = CVODE library (https://computing.llnl.gov/projects/sundials. Default 0.  : 0\n",
+      "initial_abundance_mix : initial abundance mixture: 0=AG89, 1=Karakas 2002, 2=Lodders 2003, 3=Asplund 2005 (not available?), 4=Garcia Berro, 5=Grevesse Noels 1993 : 0\n",
+      "init_abund : Usage: --init_abund <i> <X>. Sets the initial abundance of isotope number <i> to mass fraction <X>. : 0.02\n",
+      "init_abund_mult : Usage: --init_abund_mult <i> <f>. Multiplies the initial abundance of isotope number <i> by <f>. : 1.0\n",
+      "init_abund_dex : Usage: --init_abund_dex <i> <f>. Changes the initial abundance of isotope number <i> by <f> dex. : 0.0\n",
+      "init_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "initial_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "no_thermohaline_mixing : If True, disables thermohaline mixing. : (null)\n",
+      "lithium_GB_post_Heflash : Sets the lithium abundances after the helium flash. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_GB_post_1DUP : Sets the lithium abundance after first dredge up. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_hbb_multiplier : Multiplies the lithium abundances on the AGB during HBB (based on Karakas/Fishlock et al models).Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "angelou_lithium_decay_function : Functional form which describes Li7 decay. Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Choices are : 0 expoential (see angelou_lithium_decay_time). : (null)\n",
+      "angelou_lithium_LMMS_time : Time at which lithium manufacture is triggered in a low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_time : Time at which lithium manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_time : Time at which lithium manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_time : Time at which lithium manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_time : Time at which lithium manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_time : Time at which lithium manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_time : Time at which lithium manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_decay_time : Decay time for surface lithium abundance during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_decay_time : Decay time for surface lithium abundance on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_decay_time : Decay time for surface lithium abundance on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_decay_time : Decay time for surface lithium abundance on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_decay_time : Decay time for surface lithium abundance during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_decay_time : Decay time for surface lithium abundance on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_decay_time : Decay time for surface lithium abundance on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_massfrac : Lithium mass fraction when its manufacture is triggered during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_massfrac : Lithium mass fraction when its manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_massfrac : Lithium mass fraction when its manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_massfrac : Lithium mass fraction when its manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_massfrac : Lithium mass fraction when its manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_vrot_trigger : Equatorial rotational velocity at which lithium manufacture is triggered (km/s). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "angelou_lithium_vrotfrac_trigger : Fraction of Keplerian (breakup) equatorial rotational velocity at which lithium manufacture is triggered (must be <1, ignored if 0). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Output\n",
+      "############################################################\n",
+      "david_logging_function : Function to choose which kind of information gets logged Requires DAVID. Choices are: 0= None, >0 for custom logging functions : Ignore\n",
+      "cf_amanda_log : Enable logging to compare to Amanda's models. : (null)\n",
+      "float_overflow_checks : Turn on to enable floating-point overflow checks at the end of each timestep, if they are available. 0=off, 1=warn (stderr) on failure, 2=exit on failure (0) : (null)\n",
+      "save_pre_events_stardata : Enable this to save a copy of stardata to stardata->pre_events_stardata just before an event. : (null)\n",
+      "disable_end_logging : Disable the logging that happens at the end of the evolution. : (null)\n",
+      "ensemble : Turn on ensemble calculations and output. : (null)\n",
+      "ensemble_filters_off : Sets all ensemble filters to be off (FALSE) - these can then be enabled one-by-one with --ensemble_filter_[...] TRUE. : (null)\n",
+      "ensemble_filter_%d : Turn on or off ensemble filter <n>. For a list of filters, see ensemble_macros.h. : (null)\n",
+      "ensemble_legacy_ensemble : Turn on ensemble legacy population output. : (null)\n",
+      "legacy_yields : Turn on ensemble legacy yield output. : (null)\n",
+      "ensemble_defer : Defer ensemble output. : (null)\n",
+      "ensemble_dt : When doing ensemble calculations, data are stored and/or output every ensemble_dt Myr. See also ensemble, ensemble_logdt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logdt : When doing ensemble calculations, and when logensembletimes is set, the ensemble is stored/output every ensemble_logdt Myr. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_startlogtime : Start log ensemble data storage/calculations/output at ensemble_startlogtime. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logtimes : When doing ensemble calculations/output, set this to act at log times rather than linear times. : (null)\n",
+      "postagb_legacy_logging : Turn on post-AGB legacy logging. : (null)\n",
+      "disc_legacy_logging : Turn on disc legacy logging. : (null)\n",
+      "EMP_logg_maximum : Maximum logg that EMP stars are allowed to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_minimum_age. : (null)\n",
+      "EMP_minimum_age : Minimum age that EMP stars are required to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum. : (null)\n",
+      "EMP_feh_maximum : Maximum [Fe/H] that an EMP stars may have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default -2.0. : (null)\n",
+      "CEMP_cfe_minimum : Minimum [C/Fe] that CEMP stars are required to have. See Izzard et al 2009. See also NEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 0.7. : (null)\n",
+      "NEMP_cfe_minimum : Minimum [N/Fe] that NEMP stars are required to have. See Izzard et al 2009, Pols et al. 2012. See also CEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 1.0. : (null)\n",
+      "thick_disc_start_age : Lookback time for the start of the thick disc star formation, e.g. 13e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_end_age : Lookback time for the end of the thick disc star formation, e.g. 4e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_logg_min : Minimum logg for thick disc giants to be logged. : (null)\n",
+      "thick_disc_logg_max : Maximum logg for thick disc giants to be logged. : (null)\n",
+      "escape_velocity : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 1e9 km/s. See also escape_fraction. : (null)\n",
+      "escape_fraction : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 0.0. See also escape_velocity. : (null)\n",
+      "colour_log : If set to True, thelog is coloured with ANSI colour formatting. Requires FILE_LOG to be defined. : \n",
+      "log_filename : Location of the output logging filename. If set to \"/dev/null\" then there is no logging. : \n",
+      "stopfile : File which, when it exists, will stop the current binary_c repeat run. : \n",
+      "stardata_dump_filename : Location of the stardata dump file. : \n",
+      "stardata_load_filename : Location of the stardata file to load. : \n",
+      "api_log_filename_prefix : Location of the output logging filename prefix for the API. If set to \"/dev/null\" then there is no logging. : 0\n",
+      "hrdiag_output : Set to True to output high time-resolution Hertzstrpung-Russell diagram information. Requires HRDIAG. : (null)\n",
+      "internal_buffering : Experimental. Set to non-zero values to implement internal buffering prior to output. For use with binary_grid, you shouldn't really be playing with this. : (null)\n",
+      "eccentric_RLOF_model : Chooses which model is used to handle eccentric RLOF. Default is RLOF_ECCENTRIC_AS_CIRCULAR, i.e. ignore the eccentricity. Note: requires force_corotation_of_primary_and_orbit to be FALSE.\n",
+      " : (null)\n",
+      "force_circularization_on_RLOF : If True forces circularization of stars and orbit when RLOF starts, this is as in the BSE algorithm. (True) : (null)\n",
+      "wtts_log : If True, enables log file output for WTTS2. : (null)\n",
+      "fabian_imf_log_time : Time at which to output for Fabian Schneider's IMF project. Requires FABIAN_IMF_LOG : Ignore\n",
+      "fabian_imf_log_timestep : Timestep for Fabian Schneider's IMF project logging. Requires FABIAN_IMF_LOG : Ignore\n",
+      "version : Display binary_c version and build information. Also performs timing tests. : Ignore\n",
+      "dumpversion : Display binary_c version number (short format). : Ignore\n",
+      "version_only : Display binary_c version number and build information, but do not perform timing tests or anything that requires stardata to be non-NULL. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Input\n",
+      "############################################################\n",
+      "MINT_dir : Location of MINT algorithm data. : \n",
+      "MINT_data_cleanup : Activate checks on incoming data to try to account for problems. Will make data-loading slower, but may fix a few things. : \n",
+      "MINT_MS_rejuvenation : Turn on or off (hydrogen) main-sequence rejuvenation. : \n",
+      "MINT_remesh : Turn on or off MINT's remeshing. : \n",
+      "MINT_use_ZAMS_profiles : Use chemical profiles at the ZAMS if MINT_use_ZAMS_profiles is TRUE, otherwise set homogeneous abundances. (Default is TRUE, so we use the profiles if they are available.) : \n",
+      "MINT_disable_grid_load_warnings : Use this to explicitly disable MINT's warnings when loading a grid with, e.g., missing or too much data. : \n",
+      "MINT_Kippenhahn : Turn on or off MINT's Kippenhahn diagrams. If 0, off, if 1, output star 1 (index 0), if 2 output star 2 (index 1). Default 0. : \n",
+      "MINT_Kippenhahn_stellar_type : Stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for which Kippenhahn plot data should be output. : \n",
+      "MINT_Kippenhahn_companion_stellar_type : Companion stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for the companion for which Kippenhahn plot data should be output. : \n",
+      "MINT_nuclear_burning : Turn on or off MINT's nuclear burning algorithm. : \n",
+      "MINT_minimum_shell_mass : Minimum shell mass in MINT's nuclear burning routines. : \n",
+      "MINT_maximum_shell_mass : Maximum shell mass in MINT's nuclear burning routines. : \n",
+      "\n",
+      "############################################################\n",
+      "##### Section I/O\n",
+      "############################################################\n",
+      "go : batchmode control command : Ignore\n",
+      "gogo : batchmode control command : Ignore\n",
+      "reset_stars : Reset the star structures. Used in batchmode : Ignore\n",
+      "reset_stars_defaults : Reset the star structures and set defaults. Used in batchmode : Ignore\n",
+      "defaults : Reset all defaults. Used in batchmode : Ignore\n",
+      "echo : Activate batchmode command echoing, i.e. when you enter a command, binary_c repeats the command then executes it. : Ignore\n",
+      "noecho : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "noechonow : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "bye : Quit binary_c. Used in batchmode. : Ignore\n",
+      "fin : batchmode control command : Ignore\n",
+      "reset_prefs : Reset preferences struct. Used in batchmode : Ignore\n",
+      "status : Output batchmode status information. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Algorithms\n",
+      "############################################################\n",
+      "repeat : If > 1, repeats the system as many times as required. Handy if you're using Monte-Carlo kicks and want to sample the parameter space well. Also, if you are running speed tests this is good to give a statistically more reasonable result. (See e.g. 'tbse pgo'). : (null)\n",
+      "random_systems : Experimental. Use this to apply random initial system parameters (masses, separations, etc.). Useful for testing only. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Misc\n",
+      "############################################################\n",
+      "random_seed : Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "random_systems_seed : Random number seed for the generation of random systems. See random_systems and random_seed. : (null)\n",
+      "random_skip : Skip the first <random_seed> random numbers that are generated. Usually this is 0 so they are all used. : (null)\n",
+      "idum : [NB: deprecated, please use 'random_seed' instead.] Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "reverse_time : Make time go backwards. To be considered very experimental! : (null)\n",
+      "start_time : Start time for the simulation. : (null)\n",
+      "warmup_cpu : Uses the CPU at maximum power the given number of seconds, prior to running normal stellar evolution. : Ignore\n",
+      "help : Display help pages. Usage: --help <help topic>. : Ignore\n",
+      "argopts : Display argument options. Usage: --argopts <argument>. : Ignore\n",
+      "help_all : Display all help pages. : Ignore\n",
+      "list_args : Display list of arguments with their default values. Useful for batchmode. : Ignore\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help_all())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bfec32cf-7240-4a82-ac30-b3d99a018a28",
+   "metadata": {},
+   "source": [
+    "We can get all the parameter names and their default values with return_arglines(): (abridged output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "3d29ca9d-ac66-4f9e-81cf-2edd14a98b79",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "__ARG_BEGIN\n",
+      "metallicity = 0.02\n",
+      "effective_metallicity = -1\n",
+      "M_1 = 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print('\\n'.join(_binary_c_bindings.return_arglines().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e8b1c8b6-a878-43f4-bc36-1b20b3e66c6f",
+   "metadata": {},
+   "source": [
+    "Lastly, we can ask binary_c to determine the minimum period or maximum mass for RLOF at the ZAMS: Both of them need an argstring as input"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "e517f561-09c6-419d-ba89-d9cb61e6ebab",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MINIMUM SEPARATION 0.31\n",
+      "MINIMUM PERIOD 0.00632092\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_minimum_orbit_for_RLOF(argstring, store_capsule=store_memaddr)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 46,
+   "id": "7da75a95-8831-4346-a584-e042ced75249",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MAXIMUM MASS RATIO 0.0141\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=5,\n",
+    "    M_2=1,\n",
+    "    orbital_period=0.0001,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_maximum_mass_ratio_for_RLOF(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5fe52d8e-1721-4796-a856-002cf4525d96",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/doctrees/nbsphinx/notebook_custom_logging.ipynb b/docs/build/doctrees/nbsphinx/notebook_custom_logging.ipynb
new file mode 100644
index 000000000..e84895375
--- /dev/null
+++ b/docs/build/doctrees/nbsphinx/notebook_custom_logging.ipynb
@@ -0,0 +1,517 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "879b596b-d70c-4f90-b668-563b4ad93ffc",
+   "metadata": {},
+   "source": [
+    "# Notebook custom logging\n",
+    "In this notebook you'll learn how to use the custom logging functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "696ecbb9-1efd-48f4-a57e-2cf6dfe416f1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "from binarycpython.utils.custom_logging_functions import (\n",
+    "    autogen_C_logging_code,\n",
+    "    binary_c_log_code,\n",
+    "    create_and_load_logging_function,\n",
+    ")\n",
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "from binarycpython.utils.grid import Population"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d4d721cc-df4f-4ac2-b6f9-62e85ca0c1e5",
+   "metadata": {},
+   "source": [
+    "The custom logging functionality allows us to decide the output of binary_c _without_ modifying the actual sourcecode of binary_c (i.e. editing `src/logging/log_every_timestep` in binary_c). Rather, we can create a logging routine from within python.\n",
+    "\n",
+    "Technically, the following steps are taken:\n",
+    "- User creates a logging print statement from within python\n",
+    "- The logging print statement string gets wrapped into a proper c-function by `binary_c_log_code`\n",
+    "- The c-function string gets compiled and loaded into memory by `create_and_load_logging_function`\n",
+    "- The memory adress of the compiled and loaded print function can now be passed to C\n",
+    "- binary_c uses the custom print function \n",
+    "\n",
+    "The custom logging functionality can be used when running systems via `run_system()`, via `Population.evolve()` and `Population.evolve_single()`, and directly via the API\n",
+    "\n",
+    "Within the logging statement we can access information from the stardata object, as well as use logical statements to determine when to log information. What we cannot do, however, is access functions that are not _publicly available_. For very elaborate printing routines it is still advised to actually hardcode the print statement into binary_c itself."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "be137151-bb57-43d7-bab1-0167512ac727",
+   "metadata": {},
+   "source": [
+    "## Usage"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac4e5f4c-81e6-4980-b852-aca84ca74f4c",
+   "metadata": {},
+   "source": [
+    "There are two methods to create the C-code that will be compiled:\n",
+    "- Automatically generate the print statement and use the wrapper to generate the full function string, by using `autogen_C_logging_code`\n",
+    "- Create your custom print statement and use the wrapper to generate the full function string, by writing out the print statement. Here the logging statement obviously has to be valid C code"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "236cf821-09ac-4237-9b8f-6e36d2edf446",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA %g %g\\n\",((double)stardata->model.time),((double)stardata->star[0].mass));\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines. Here you can choose whatever you want to have logged, and with what header\n",
+    "# this generates working print statements\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "feb423d5-5cc3-433c-9801-f8017abbc03a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "2f5defbf-c623-49ed-a238-fba52a563a58",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "#pragma push_macro(\"Max\")\n",
+      "#pragma push_macro(\"Min\")\n",
+      "#undef Max\n",
+      "#undef Min\n",
+      "#include \"binary_c.h\"\n",
+      "\n",
+      "// add visibility __attribute__ ((visibility (\"default\"))) to it \n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata);\n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata)\n",
+      "{\n",
+      "    // struct stardata_t * stardata = (struct stardata_t *)x;\n",
+      "    Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass);\n",
+      "}\n",
+      "\n",
+      "#undef Max \n",
+      "#undef Min\n",
+      "#pragma pop_macro(\"Min\")\n",
+      "#pragma pop_macro(\"Max\")    \n"
+     ]
+    }
+   ],
+   "source": [
+    "# Generate the entire 'script' by wrapping the logging line\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "print(custom_logging_code)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "efa7f1e9-247e-4196-a883-bcff05265d02",
+   "metadata": {},
+   "source": [
+    "Combining the above with e.g. run_system() (see notebook_individual_systems for more examples):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "dcd74bbc-478b-43e4-b495-8c456e8d1d88",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=1e-06 mass=2\n",
+      "MY_STELLAR_DATA time=2e-06 mass=2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# logging statement\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=2, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1998ee8f-8c0a-462b-b1e0-54f5963902cc",
+   "metadata": {},
+   "source": [
+    "### Using custom logging with the population object\n",
+    "Custom logging can be used for a whole population by setting the print statement (so not the entire logging script) in `C_logging_code`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "77bd09b0-1a94-499d-97db-a1f991c67c12",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_ABOVE_MS             1.041660877905e+02 4.99198 4.99198 6.1357 6.1357 2 1\n",
+      "EXAMPLE_ABOVE_MS             1.041662558619e+02 4.99198 4.99198 6.14057 6.1357 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662560111e+02 4.99198 4.99198 6.14057 6.14057 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662564579e+02 4.99198 4.99198 6.14059 6.14057 2 2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Set up population\n",
+    "pop = Population()\n",
+    "\n",
+    "# Set some BSE parameters\n",
+    "pop.set(\n",
+    "    M_1=5\n",
+    ")\n",
+    "\n",
+    "# Example logging that prints only if the star is post main-sequence\n",
+    "example_logging_string_post_MS = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>MS)\n",
+    "{\n",
+    "    Printf(\"EXAMPLE_ABOVE_MS %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "        // \n",
+    "        stardata->model.time, // 1\n",
+    "\n",
+    "        stardata->star[0].mass, //2\n",
+    "        stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "        stardata->star[0].radius, //4\n",
+    "        stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "        stardata->star[0].stellar_type, //6\n",
+    "        stardata->previous_stardata->star[0].stellar_type //7\n",
+    "  );\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Set the logging\n",
+    "pop.set(\n",
+    "    C_logging_code=example_logging_string_post_MS\n",
+    ")\n",
+    "out = pop.evolve_single()\n",
+    "\n",
+    "# Print (abridged) output\n",
+    "print('\\n'.join(out.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93397ff3-9b71-470d-8bc4-08fe5b1a5dca",
+   "metadata": {},
+   "source": [
+    "### Using custom logging when running directly from the API\n",
+    "When running a system directly with the API we need to manually load the custom logging into memory (via `create_and_load_logging_function`) and pass the memory address to the binary_c binding via `_binary_c_bindings.run_system(argstring, custom_logging_func_memaddr=custom_logging_memaddr)`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "id": "30142286-34ce-433e-82c8-565e2160ff5b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 1e-06 15\n",
+      "MY_STELLAR_DATA 2e-06 15\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "# Generate code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Generate library and get memaddr\n",
+    "custom_logging_memaddr, shared_lib_filename = create_and_load_logging_function(\n",
+    "    custom_logging_code\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "m1 = 15.0  # Msun\n",
+    "m2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000\n",
+    "argstring = \"binary_c M_1 {0:g} M_2 {1:g} separation {2:g} orbital_period {3:g} eccentricity {4:g} metallicity {5:g} max_evolution_time {6:g}\".format(\n",
+    "    m1,\n",
+    "    m2,\n",
+    "    separation,\n",
+    "    orbital_period,\n",
+    "    eccentricity,\n",
+    "    metallicity,\n",
+    "    max_evolution_time,\n",
+    ")\n",
+    "output = _binary_c_bindings.run_system(\n",
+    "    argstring, custom_logging_func_memaddr=custom_logging_memaddr\n",
+    ")\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print('\\n'.join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39c76b1d-d968-4eef-b5ae-2542ed9557c3",
+   "metadata": {},
+   "source": [
+    "## Examples of logging strings\n",
+    "Below are some examples of logging strings"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2ac4af72-6dab-4cc9-986e-5b5b1fa31b73",
+   "metadata": {},
+   "source": [
+    "### Compact object\n",
+    "This logging will print the timestep when the star becomes a compact object. After it does, we change the maximum time to be the current time, effectively terminating the evolution"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "id": "6f0edc65-a788-4706-a0c5-2ace030765ec",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "EXAMPLE_LOG_CO             2.773581245005e+01 1.33524 9.19314 1.72498e-05 730.446 13 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_LOG_CO %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "            stardata->star[0].radius, //4\n",
+    "            stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type //7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=10, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "51c51592-6406-43bd-a879-10ace64aaf28",
+   "metadata": {},
+   "source": [
+    "### Logging mass evolution and the supernova\n",
+    "This logging code prints the mass evolution and the moment the star goes supernova"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 47,
+   "id": "8f58fdf9-3e76-4c18-a1c5-eed0980d4133",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_MASSLOSS             9.878236827680e+00 1.61349 8.38063 20 13 1\n",
+      "EXAMPLE_SN             9.878236827680e+00 1.61349 8.38063 20 12 13 5 1 6.74037 4.92267 6.74037 0 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d %g\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type, //5\n",
+    "    stardata->model.probability //6\n",
+    ");\n",
+    "if(stardata->star[0].SN_type != SN_NONE)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        if(stardata->pre_events_stardata != NULL)\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->pre_events_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->pre_events_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[ID_core(stardata->pre_events_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "        else\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->previous_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->previous_stardata->star[0].core_mass[ID_core(stardata->previous_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=20, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[-2:]))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/doctrees/nbsphinx/notebook_extra_features.ipynb b/docs/build/doctrees/nbsphinx/notebook_extra_features.ipynb
new file mode 100644
index 000000000..d453a6f5b
--- /dev/null
+++ b/docs/build/doctrees/nbsphinx/notebook_extra_features.ipynb
@@ -0,0 +1,44 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d5c04b77-f0be-4b33-8c03-c72eb846527c",
+   "metadata": {},
+   "source": [
+    "# Extra features and functionality of binarycpython\n",
+    "In this notebook we'll go over some of the extra features and functionality that was not covered in the other notebooks.\n",
+    "\n",
+    "TODO"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0020f1bc-2a23-455c-8216-9e63e6e038ae",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/doctrees/nbsphinx/notebook_individual_systems.ipynb b/docs/build/doctrees/nbsphinx/notebook_individual_systems.ipynb
new file mode 100644
index 000000000..19c2d29fb
--- /dev/null
+++ b/docs/build/doctrees/nbsphinx/notebook_individual_systems.ipynb
@@ -0,0 +1,563 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "a544d28c-c2e1-4c6a-b55b-8caec440743f",
+   "metadata": {},
+   "source": [
+    "# Running individual systems with binarycpython\n",
+    "This notebook will show you how to run single systems and analyze their results.\n",
+    "\n",
+    "It can be useful to have some functions to quickly run a single system to e.g. inspect what evolutionary steps a specific system goes through, to plot the mass loss evolution of a single star, etc. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dd5d9ec7-5791-45f1-afbd-225947e2a583",
+   "metadata": {},
+   "source": [
+    "## Single system with run_wrapper\n",
+    "The simplest method to run a single system is to use the run_system wrapper. This function deals with setting up the argument string, makes sure all the required parameters are included and handles setting and cleaning up the custom logging functionality (see notebook_custom_logging).\n",
+    "\n",
+    "As arguments to this function we can add any of the parameters that binary_c itself actually knows, as well as:\n",
+    "- custom_logging_code: string containing a print statement that binary_c can use to print information\n",
+    "- log_filename: path of the logfile that binary_c generates\n",
+    "- parse_function: function that handles parsing the output of binary-c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "425efed3-d8e3-432d-829e-41d8ebe05162",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "# help(run_system) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "b2abab48-433d-4936-8434-14804c52c9f6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 1 12462\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f127a5e4-dc01-4472-9130-8a943c92e8a7",
+   "metadata": {},
+   "source": [
+    "Lets try adding a log filename now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "029fc3f2-f09a-49af-a32b-248505738f2e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "      TIME      M1       M2   K1  K2           SEP   ECC  R1/ROL1 R2/ROL2  TYPE RANDOM_SEED=67365 RANDOM_COUNT=0\n",
+      "     0.0000    1.000    0.000  1  15            -1 -1.00   0.000   0.000  \"INITIAL \"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"OFF_MS\"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 11582.2424    1.000    0.000  3  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12325.1085    0.817    0.000  4  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12457.1300    0.783    0.000  5  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"shrinkAGB\"\n",
+      " 12461.9514    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 15000.0000    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"MAX_TIME\"\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1, log_filename='/tmp/test_logfile.txt')\n",
+    "with open('/tmp/test_logfile.txt', 'r') as f:\n",
+    "    print(f.read())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "606670f2-3e0a-43c7-a885-006b92fac9d2",
+   "metadata": {},
+   "source": [
+    "To get more useful output we can include a custom_logging snippet (see notebook_custom_logging):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "e6a23b55-ca42-440d-83ac-e76a24a83a67",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 1 1 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 1 1 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython.utils.custom_logging_functions import binary_c_log_code\n",
+    "\n",
+    "# Create the print statement\n",
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"\n",
+    "\n",
+    "# Generate entire shared lib code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(custom_logging_print_statement)\n",
+    "\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code)\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4c885143-db79-4fed-b4c4-0bd846e24f7d",
+   "metadata": {},
+   "source": [
+    "Now we have some actual output, it is time to create a parse_function which parses the output. Adding a parse_function to the run_system will make run_system run the output of binary_c through the parse_function."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "3822721f-217a-495b-962e-d57137b9e290",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 1.0, 1.0, 1.0], [0.0, 1.0, 1.0, 1.0]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "def parse_function(output):\n",
+    "    \"\"\"\n",
+    "    Example function to parse the output of binary_c\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    return value_lines\n",
+    "\n",
+    "# Catch output\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code, parse_function=parse_function)\n",
+    "print(output[:3])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a551f07f-2eff-4425-9375-267579a581b3",
+   "metadata": {},
+   "source": [
+    "This output can now be turned into e.g. an Numpy array or Pandas dataframe (my favorite: makes querying the data very easy)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "654a07ed-2a88-46ff-9da0-b7759580f9f3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0        time      mass initial_mass stellar_type\n",
+      "1           0         1            1            1\n",
+      "2           0         1            1            1\n",
+      "3       1e-06         1            1            1\n",
+      "4       2e-06         1            1            1\n",
+      "5       3e-06         1            1            1\n",
+      "...       ...       ...          ...          ...\n",
+      "1612  12461.8  0.577754            1            6\n",
+      "1613    12462  0.522806            1           11\n",
+      "1614    13462  0.522806            1           11\n",
+      "1615    14462  0.522806            1           11\n",
+      "1616    15000  0.522806            1           11\n",
+      "\n",
+      "[1616 rows x 4 columns]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import pandas as pd\n",
+    "\n",
+    "# Load data into dataframe\n",
+    "example_df = pd.DataFrame(output)\n",
+    "\n",
+    "# Fix column headers\n",
+    "example_df.columns = example_df.iloc[0]\n",
+    "example_df = example_df.drop(example_df.index[0])\n",
+    "\n",
+    "print(example_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "325c2ce6-f9a1-46b7-937f-84040e1252cf",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## Single system via population object\n",
+    "When setting up your population object (see notebook_population), and configuring all the parameters, it is possible to run a single system using that same configuration. It will use the parse_function if set, and running a single system is a good method to test if everything works accordingly."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "4a98ffca-1b72-4bb8-8df1-3bf3187d882f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.grid import Population\n",
+    "# help(Population) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7e2c2ef0-3db2-46a6-8c85-9b6cf720eb6a",
+   "metadata": {},
+   "source": [
+    "First, let's try this without any custom logging or parsing functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "bff1cc2e-6b32-4ba0-879f-879ffbabd223",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Create the population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# Set some parameters\n",
+    "example_pop.set(\n",
+    "    verbosity=1\n",
+    ")\n",
+    "example_pop.set(\n",
+    "    M_1=10\n",
+    ")\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ae01fa35-f8b1-4a40-bfb2-b9e872cae0e7",
+   "metadata": {},
+   "source": [
+    "Now lets add some actual output with the custom logging"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "dd748bab-b57e-4129-8350-9ea11fa179d0",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\n\",\n",
+      "    // \n",
+      "    stardata->model.time, // 1\n",
+      "    stardata->star[0].mass, //2\n",
+      "    stardata->previous_stardata->star[0].mass, //3\n",
+      "    stardata->common.zero_age.mass[0], //4\n",
+      "\n",
+      "    stardata->star[0].stellar_type //5\n",
+      ");\n",
+      " to grid_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294.so\n",
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 10 0 10 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 10 10 10 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 10 10 10 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 10 10 10 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"   \n",
+    "\n",
+    "example_pop.set(C_logging_code=custom_logging_print_statement)\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "588a7d9e-9d64-4b3b-8907-656b905286e8",
+   "metadata": {},
+   "source": [
+    "Lastly we can add a parse_function to handle parsing the output again. \n",
+    "\n",
+    "Because the parse_function will now be part of the population object, it can access information of the object. We need to make a new parse function that is fit for an object: we the arguments now need to be (self, output). Returning the data is useful when running evolve_single(), but won't be used in a population evolution."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "fec39154-cce6-438c-8c2c-509d76b00f34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "import numpy as np\n",
+    "\n",
+    "def object_parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function that can be added to the population object\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # We can access object instance information now. \n",
+    "    # In this way we can store the results in a file for example. \n",
+    "    output_file = os.path.join(self.custom_options['output_dir'], 'example_output.json')\n",
+    "    \n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    # Turn into an array\n",
+    "    values_array = np.array(value_lines[1:])\n",
+    "    \n",
+    "    # make dict and fill\n",
+    "    output_dict = {}\n",
+    "    for i in range(len(column_names)):\n",
+    "        output_dict[column_names[i]] = list(values_array[:,i])\n",
+    "\n",
+    "    # Write to file\n",
+    "    with open(output_file, 'w') as f:\n",
+    "        f.write(json.dumps(output_dict, indent=4))\n",
+    "        \n",
+    "    # Return something anyway\n",
+    "    return value_lines"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "57347512-fd4a-434b-b13c-5e6dbd3ac415",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: parse_function=<function object_parse_function at 0x7f9265091598> to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: output_dir=/tmp/ to custom_options >>>>\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_e9c2bec7f15541eb847fc6013e48e7ed.so\n",
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 10.0, 0.0, 10.0, 1.0], [0.0, 10.0, 10.0, 10.0, 1.0], [1e-06, 10.0, 10.0, 10.0, 1.0]]\n",
+      "dict_keys(['time', 'mass', 'initial_mass', 'stellar_type'])\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(\n",
+    "    parse_function=object_parse_function,\n",
+    "    output_dir='/tmp/'\n",
+    ")\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output[:4])\n",
+    "\n",
+    "# Example of loading the data that was written\n",
+    "with open(os.path.join(example_pop.custom_options['output_dir'], 'example_output.json')) as f:\n",
+    "    written_data = json.loads(f.read())\n",
+    "\n",
+    "print(written_data.keys())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ddc06da3-fc68-4c6f-8067-14ea862b964d",
+   "metadata": {},
+   "source": [
+    "## Single system via API functionality\n",
+    "It is possible to construct your own functionality to run a single system by directly calling the API function to run a system. Under the hood all the other functions and wrappers actually use this API.\n",
+    "\n",
+    "There are less failsafes for this method, so this make sure the input is correct and binary_c knows all the arguments you pass in.\n",
+    "\n",
+    "for more details on this API function see `notebook_api_functions`"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "56886792-d379-4eac-b0d4-54508edb39c7",
+   "metadata": {},
+   "source": [
+    "First we must construct the argument string that we pass to binary_c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "ec48125c-6bf5-48f4-9357-8261800b5d8b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 15 14.2383\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For a binary system we need to pass in these arguments\n",
+    "M_1 = 15.0  # Msun\n",
+    "M_2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000  # Myr. You need to include this argument.\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} M_2 {M_2} separation {separation} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=M_1,\n",
+    "    M_2=M_2,\n",
+    "    separation=separation,\n",
+    "    orbital_period=orbital_period,\n",
+    "    eccentricity=eccentricity,\n",
+    "    metallicity=metallicity,\n",
+    "    max_evolution_time=max_evolution_time,\n",
+    ").strip()\n",
+    "\n",
+    "from binarycpython import _binary_c_bindings\n",
+    "\n",
+    "output = _binary_c_bindings.run_system(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "55c8ea24-0fc0-452c-8121-1e7667433479",
+   "metadata": {},
+   "source": [
+    "As we can see above, the output is rather empty. But if SINGLE_STAR_LIFETIME is printed we know we caught the output correctly. To get actual output we should have timesteps printed in the `log_every_timestep.c` in binary_c, or add some custom_logging (see notebook_custom_logging). "
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/doctrees/nbsphinx/notebook_population.ipynb b/docs/build/doctrees/nbsphinx/notebook_population.ipynb
index 8d2bdbf98..56f3b153c 100644
--- a/docs/build/doctrees/nbsphinx/notebook_population.ipynb
+++ b/docs/build/doctrees/nbsphinx/notebook_population.ipynb
@@ -5,44 +5,82 @@
    "id": "bbbaafbb-fd7d-4b73-a970-93506ba35d71",
    "metadata": {},
    "source": [
-    "# Title page\n"
+    "# Running populations with binarycpython\n",
+    "This notebook will show you how to evolve a population of stars\n",
+    "\n",
+    "Much of the code in the binarycpython package is written to evolve a population of stars through the Population object, rather than running a single system. Let's go through the functionality of this object step by step and set up some example populations. \n",
+    "\n",
+    "At the bottom of this notebook there are some complete example scripts"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "bf6b8673-a2b5-4b50-ad1b-e90671f57470",
    "metadata": {},
    "outputs": [],
    "source": [
     "import os\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
     "from binarycpython.utils.grid import Population\n",
-    "from binarycpython.utils.functions import (\n",
-    "    get_help_all,\n",
-    "    get_help,\n",
-    "    create_hdf5,\n",
-    "    output_lines,\n",
-    ")\n",
-    "from binarycpython.utils.custom_logging_functions import temp_dir\n"
+    "\n",
+    "# help(Population) # Uncomment to see the public functions of this object"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a081ab23-7822-4971-aa82-991548534714",
+   "metadata": {},
+   "source": [
+    "- running ensemble\n",
+    "- using M&S grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f268eff3-4e08-4f6b-8b59-f22dba4d2074",
+   "metadata": {},
+   "source": [
+    "## Setting up the Population object\n",
+    "To set up and configure the population object we need to make an object instance of the `Population` object, and add configuration via the `.set()` function.\n",
+    "\n",
+    "There are three categories of options that the Population object can set:\n",
+    "- BSE options: these options will be used for the binary_c calls, and are recognized by comparing the arguments to a known list of available arguments of binary_c. To see which options are available, see section [`binary_c parameters` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html). You can access these through `population.bse_options['<bse option name>']` after you have set them. \n",
+    "\n",
+    "- Grid options: these options will be used to configure the behaviour of the Population object. To see which options are available, see section [`Population grid code options` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html). They can be accessed via `population.grid_options['<grid option name>']` after you have set them. \n",
+    "\n",
+    "- Custom options: these options are not recognized as either of the above, so they will be stored in the custom_options, and can be accessed via `population.custom_options['<custom option name>']`"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "79ab50b7-591f-4883-af09-116d1835a751",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "adding: orbital_period=45000000080 to BSE_options\n",
+      "adding: max_evolution_time=15000 to BSE_options\n",
+      "adding: eccentricity=0.02 to BSE_options\n",
+      "adding: amt_cores=2 to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: data_dir=/tmp/binary_c_python/example_python_population_result to custom_options >>>>\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: base_filename=example_pop.dat to custom_options >>>>\n",
+      "1\n",
+      "example_pop.dat\n",
+      "10\n"
+     ]
+    }
+   ],
    "source": [
-    "#########################################################\n",
-    "# This file serves as an example for running a population.\n",
-    "# The use of help(<function>) is a good way to inspect what parameters are there to use\n",
-    "#########################################################\n",
-    "\n",
     "# Create population object\n",
     "example_pop = Population()\n",
     "\n",
     "# If you want verbosity, set this before other things\n",
-    "example_pop.set(verbose=1)\n",
+    "example_pop.set(verbosity=1)\n",
     "\n",
     "# Setting values can be done via .set(<parameter_name>=<value>)\n",
     "# Values that are known to be binary_c_parameters are loaded into bse_options.\n",
@@ -51,115 +89,244 @@
     "example_pop.set(\n",
     "    # binary_c physics options\n",
     "    M_1=10,  # bse_options\n",
-    "    separation=0,  # bse_options\n",
     "    orbital_period=45000000080,  # bse_options\n",
     "    max_evolution_time=15000,  # bse_options\n",
     "    eccentricity=0.02,  # bse_options\n",
-    "    # Set companion to low mass\n",
-    "    M_2=0.08,  # Since in the example we run a single system, we should set the companion mass here. If we donm't do this, the code will complain.\n",
+    "\n",
+    "\n",
     "    # grid_options\n",
     "    amt_cores=2,  # grid_options\n",
-    "    verbose=1,  # verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff\n",
+    "    \n",
     "    # Custom options # TODO: need to be set in grid_options probably\n",
     "    data_dir=os.path.join(\n",
     "        temp_dir(), \"example_python_population_result\"\n",
     "    ),  # custom_options\n",
     "    base_filename=\"example_pop.dat\",  # custom_options\n",
-    ")"
+    ")\n",
+    "\n",
+    "# We can use the options through\n",
+    "print(example_pop.grid_options['verbosity'])\n",
+    "print(example_pop.custom_options['base_filename'])\n",
+    "print(example_pop.bse_options['M_1'])"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
+   "cell_type": "markdown",
+   "id": "f8d46d19-633d-4911-821d-a59daed31816",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "def parse_function(self, output):\n",
-    "    # EXAMPLE PARSE_FUNCTION\n",
-    "\n",
-    "    # extract info from the population instance\n",
-    "\n",
-    "    # Get some information from the\n",
-    "    data_dir = self.custom_options[\"data_dir\"]\n",
-    "    base_filename = self.custom_options[\"base_filename\"]\n",
-    "\n",
-    "    # Check directory, make if necessary\n",
-    "    os.makedirs(data_dir, exist_ok=True)\n",
-    "\n",
-    "    seperator = \" \"\n",
-    "\n",
-    "    # Create filename\n",
-    "    outfilename = os.path.join(data_dir, base_filename)\n",
-    "\n",
-    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "After configuring the population, but before running the actual population, its usually a good idea to export the full configuration (including version info of binary_c and all the parameters) to a file. To do this we use `example_pop.export_all_info()`.\n",
     "\n",
-    "    # Go over the output.\n",
-    "    for el in output_lines(output):\n",
-    "        headerline = el.split()[0]\n",
-    "\n",
-    "        # CHeck the header and act accordingly\n",
-    "        if headerline == \"MY_STELLAR_DATA\":\n",
-    "            values = el.split()[1:]\n",
-    "            print(values)\n",
-    "\n",
-    "            if not len(parameters) == len(values):\n",
-    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
-    "                raise ValueError\n",
+    "On default this exports everything, each of the sections can be disabled:\n",
+    "  - population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
+    "      settings=False\n",
+    "  - binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
+    "      turn off with include_binary_c_defaults=False\n",
+    "  - include_binary_c_version_info (all the compilation info, and information about the compiled\n",
+    "      parameters), turn off with include_binary_c_version_info=False\n",
+    "  - include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
+    "      turn off with include_binary_c_help_all=Fase\n",
+    "      \n",
+    "On default it will write this to the custom_options['data_dir'], but that can be overriden by setting use_datadir=False and providing an outfile=<>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "b9c2471a-a5b0-48b7-a50b-2f0d22100926",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Writing settings to /tmp/binary_c_python/example_python_population_result/example_pop_settings.json\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "example_pop.export_all_info()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f9a65554-36ab-4a04-96ca-9f1422c307fd",
+   "metadata": {},
+   "source": [
+    "## Adding grid variables\n",
+    "The main purpose of the Population object is to handle the population synthesis side of running a set of stars. The main method to do this with binarycpython, as is the case with Perl binarygrid, is to use grid variables. These are loops over a predefined range of values, where a probability will be assigned to the systems based on the chosen probability distributions.\n",
     "\n",
-    "            if not os.path.exists(outfilename):\n",
-    "                with open(outfilename, \"w\") as f:\n",
-    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "Usually we use either 1 mass grid variable, or a trio of mass, mass ratio and period (See below for full examples of all of these). We can, however, also add grid sampling for e.g. eccentricity, metallicity or other parameters. \n",
     "\n",
-    "            with open(outfilename, \"a\") as f:\n",
-    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "In some cases it could be easier to set up a for loop that sets that parameter and calls the evolve function several times, e.g. when you want to vary a prescription (usually a discrete, unweighted parameter) \n",
     "\n",
     "\n",
+    "A notable special type of grid variable is that of the Moe & di Stefano 2017 dataset (see further down in the notebook).\n",
     "\n",
-    "# Creating a parsing function\n",
-    "example_pop.set(\n",
-    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
-    ")"
+    "To add a grid variable to the population object we use `example_pop.add_grid_variable` (see next cell)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "2fa5188e-312f-4a05-aeda-0bd4c00629c8",
+   "execution_count": 4,
+   "id": "68c84521-9ae8-4020-af7a-5334173db969",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method add_grid_variable in module binarycpython.utils.grid:\n",
+      "\n",
+      "add_grid_variable(name:str, longname:str, valuerange:Union[list, str], resolution:str, spacingfunc:str, probdist:str, dphasevol:Union[str, int], parameter_name:str, gridtype:str='edge', branchpoint:int=0, precode:Union[str, NoneType]=None, condition:Union[str, NoneType]=None) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function to add grid variables to the grid_options.\n",
+      "    \n",
+      "    The execution of the grid generation will be through a nested for loop.\n",
+      "    Each of the grid variables will get create a deeper for loop.\n",
+      "    \n",
+      "    The real function that generates the numbers will get written to a new file in the TMP_DIR,\n",
+      "    and then loaded imported and evaluated.\n",
+      "    beware that if you insert some destructive piece of code, it will be executed anyway.\n",
+      "    Use at own risk.\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: Fix this complex function.\n",
+      "    \n",
+      "    Args:\n",
+      "        name:\n",
+      "            name of parameter. This is evaluated as a parameter and you can use it throughout\n",
+      "            the rest of the function\n",
+      "            \n",
+      "            Examples:\n",
+      "                name = 'lnm1'\n",
+      "        longname:\n",
+      "            Long name of parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                longname = 'Primary mass'\n",
+      "        range:\n",
+      "            Range of values to take. Does not get used really, the spacingfunction is used to\n",
+      "            get the values from\n",
+      "            \n",
+      "            Examples:\n",
+      "                range = [math.log(m_min), math.log(m_max)]\n",
+      "        resolution:\n",
+      "            Resolution of the sampled range (amount of samples).\n",
+      "            TODO: check if this is used anywhere\n",
+      "    \n",
+      "            Examples: \n",
+      "                resolution = resolution[\"M_1\"]\n",
+      "        spacingfunction:\n",
+      "            Function determining how the range is sampled. You can either use a real function,\n",
+      "            or a string representation of a function call. Will get written to a file and\n",
+      "            then evaluated.\n",
+      "    \n",
+      "            Examples:\n",
+      "                spacingfunction = \"const(math.log(m_min), math.log(m_max), {})\".format(resolution['M_1'])\n",
+      "    \n",
+      "        precode:\n",
+      "            Extra room for some code. This code will be evaluated within the loop of the\n",
+      "            sampling function (i.e. a value for lnm1 is chosen already)\n",
+      "            \n",
+      "            Examples:\n",
+      "                precode = 'M_1=math.exp(lnm1);'\n",
+      "        probdist:\n",
+      "            Function determining the probability that gets assigned to the sampled parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                probdist = 'Kroupa2001(M_1)*M_1'\n",
+      "        dphasevol:\n",
+      "            part of the parameter space that the total probability is calculated with. Put to -1\n",
+      "            if you want to ignore any dphasevol calculations and set the value to 1\n",
+      "            Examples:\n",
+      "                dphasevol = 'dlnm1'\n",
+      "        condition:\n",
+      "            condition that has to be met in order for the grid generation to continue\n",
+      "            Examples:\n",
+      "                condition = 'self.grid_options['binary']==1'\n",
+      "        gridtype:\n",
+      "            Method on how the value range is sampled. Can be either 'edge' (steps starting at\n",
+      "            the lower edge of the value range) or 'center'\n",
+      "            (steps starting at lower edge + 0.5 * stepsize).\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.add_grid_variable)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bd75cebe-2152-4025-b680-dc020b80889b",
    "metadata": {},
+   "source": [
+    "All the distribution functions that we can use are stored in the `binarycpython.utils.distribution_functions` or `binarycpython/utils/distribution_functions.py` on git. If you uncomment the help statement below you can see which functions are available now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "048db541-3e92-4c5d-a25c-9c5a34b9c857",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
    "outputs": [],
    "source": [
-    "### Custom logging\n",
-    "# Log the moment when the star turns into neutron\n",
-    "example_pop.set(\n",
-    "    C_logging_code=\"\"\"\n",
-    "if(stardata->star[0].stellar_type >= 13)    \n",
-    "{\n",
-    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
-    "    {\n",
-    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
-    "            // \n",
-    "            stardata->model.time, // 1\n",
-    "            stardata->star[0].mass, // 2\n",
-    "            stardata->common.zero_age.mass[0], // 4\n",
-    "            stardata->model.probability, // 5\n",
-    "            stardata->star[0].radius, // 6\n",
-    "            stardata->star[0].stellar_type // 7\n",
-    "      );\n",
-    "    };\n",
-    "    /* Kill the simulation to save time */\n",
-    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
-    "};\n",
-    "\"\"\"\n",
-    ")"
+    "# import binarycpython.utils.distribution_functions\n",
+    "# help(binarycpython.utils.distribution_functions)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b3a007b-5c17-42a7-a981-7e268e6f545c",
+   "metadata": {},
+   "source": [
+    "The next cell contains an example of adding the mass grid variable, but sampling in log mass. The commented grid variables are examples of the mass ratio sampling and the period sampling."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "fd197154-a8ce-4865-8929-008d3483101a",
+   "execution_count": 6,
+   "id": "47979841-2c26-4b26-8945-603d013dc93a",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added grid variable: {\n",
+      "    \"name\": \"lnm1\",\n",
+      "    \"longname\": \"Primary mass\",\n",
+      "    \"valuerange\": [\n",
+      "        2,\n",
+      "        150\n",
+      "    ],\n",
+      "    \"resolution\": \"20\",\n",
+      "    \"spacingfunc\": \"const(math.log(2), math.log(150), 20)\",\n",
+      "    \"precode\": \"M_1=math.exp(lnm1)\",\n",
+      "    \"probdist\": \"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+      "    \"dphasevol\": \"dlnm1\",\n",
+      "    \"parameter_name\": \"M_1\",\n",
+      "    \"condition\": \"\",\n",
+      "    \"gridtype\": \"edge\",\n",
+      "    \"branchpoint\": 0,\n",
+      "    \"grid_variable_number\": 0\n",
+      "}\n"
+     ]
+    }
+   ],
    "source": [
     "# Add grid variables\n",
     "resolution = {\"M_1\": 20, \"q\": 20, \"per\": 40}\n",
@@ -211,128 +378,815 @@
   },
   {
    "cell_type": "markdown",
-   "id": "8c96b151-8c3b-4479-969f-6c2f898497a5",
+   "id": "163f13ae-fec1-4ee8-b9d4-c1b75c19ff39",
    "metadata": {},
    "source": [
-    "Exporting of all the settings can be done with .export_all_info()\n",
-    "on default it exports everything, but can be supressed by turning it off:\n",
-    "  population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
-    "      settings=False\n",
-    "  binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
-    "      turn off with include_binary_c_defaults=False\n",
-    "  include_binary_c_version_info (all the compilation info, and information about the compiled\n",
-    "      parameters), turn off with include_binary_c_version_info=False\n",
-    "  include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
-    "      turn off with include_binary_c_help_all=Fase\n",
-    "On default it will write this to the custom_options['data_dir'], but that can be overriden by\n",
-    "  setting use_datadir=False and providing an outfile=<>"
+    "## Setting logging and handling the output\n",
+    "On default, binary_c will not output anything (except for 'SINGLE STAR LIFETIME'). It is up to us to determine what will be printed. We can either do that by hardcoding the print statements into `binary_c` (see documentation binary_c). Or, we can use the custom logging functionality of binarycpython (see notebook `notebook_custom_logging.ipynb`), which is faster to set up and requires no recompilation of binary_c, but is somewhat more limited in its functionality. \n",
+    "\n",
+    "After configuring what will be printed, we need to make a function to parse the output. This can be done by setting the parse_function parameter in the population object (see also notebook `notebook_individual_systems.ipynb`). \n",
+    "\n",
+    "In the code below we will set up both the custom logging, and a parse function to handle that output"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
-   "id": "ba83443c-64b4-4126-90b3-b1ca76c0f73d",
+   "execution_count": 7,
+   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
    "metadata": {},
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "if(stardata->star[0].stellar_type >= 13)    \n",
+      "{\n",
+      "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+      "    {\n",
+      "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\n\",\n",
+      "            // \n",
+      "            stardata->model.time, // 1\n",
+      "            stardata->star[0].mass, // 2\n",
+      "            stardata->common.zero_age.mass[0], // 3\n",
+      "            stardata->model.probability, // 4\n",
+      "            stardata->star[0].stellar_type // 5\n",
+      "      );\n",
+      "    };\n",
+      "    /* Kill the simulation to save time */\n",
+      "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+      "};\n",
+      " to grid_options\n"
+     ]
     }
    ],
    "source": [
-    "example_pop.export_all_info()"
+    "# Create custom logging statement: in this case we will log when the star turns into a compact object, and then terminate the evolution.\n",
+    "custom_logging_statement = \"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 3\n",
+    "            stardata->model.probability, // 4\n",
+    "            stardata->star[0].stellar_type // 5\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "example_pop.set(\n",
+    "    C_logging_code=custom_logging_statement\n",
+    ")"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "ef5b51a1-e56d-4bec-a5c7-b9d5bceeceba",
+   "id": "ae1f1f0c-1f8b-42d8-b051-cbf8c6b51514",
    "metadata": {},
    "source": [
-    "Executing a single system\n",
-    "This uses the M_1 orbital period etc set with the set function"
+    "The parse function must now catch lines that start with \"EXAMPLE_COMPACT_OBJECT\", and write that line to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
-   "id": "c0a9aed7-1fc9-4fe3-8bcf-4e987bfc00a9",
+   "execution_count": 8,
+   "id": "fd197154-a8ce-4865-8929-008d3483101a",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating the code for the shared library for the custom logging\n",
-      "['2.773586668293e+01', '1.33526', '10', '1', '1.72498e-05', '13']\n",
-      "None\n"
+      "adding: parse_function=<function parse_function at 0x7ff3bdf79620> to grid_options\n"
      ]
     }
    ],
    "source": [
-    "output = example_pop.evolve_single()\n",
-    "print(output)"
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # get info from the population instance\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for line in output.splitlines():\n",
+    "        headerline = line.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_COMPACT_OBJECT\":\n",
+    "            values = line.split()[1:]\n",
+    "            print(line)\n",
+    "            \n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "# Add the parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,\n",
+    ")"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
-   "metadata": {
-    "tags": []
-   },
-   "outputs": [],
+   "cell_type": "markdown",
+   "id": "91509ce5-ffe7-4937-aa87-6d7baac9ac04",
+   "metadata": {},
    "source": [
-    "## Executing a population\n",
-    "## This uses the values generated by the grid_variables\n",
-    "example_pop.evolve()  # TODO: update this function call"
+    "## Evolving the grid\n",
+    "Now that we configured all the main parts of the population object, we can actually run the population! Doing this is straightforward: `example_pop.evolve()`\n",
+    "\n",
+    "This will start up the processing of all the systems. We can control how many cores are used by settings `amt_cores`. By setting the `verbosity` of the population object to a higher value we can get a lot of verbose information about the run, but for now we will set it to 0.\n",
+    "\n",
+    "There are many grid_options that can lead to different behaviour of the evolution of the grid. Please do have a look at those: [grid options docs](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html), and try  "
    ]
   },
   {
-   "cell_type": "markdown",
-   "id": "ce937b07-7292-4bb1-b2e7-d69e51bdff6e",
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
    "metadata": {
     "tags": []
    },
-   "source": [
-    "Wrapping up the results to an hdf5 file can be done by using the create_hdf5\n",
-    "(<directory containing data and settings>) This function takes the settings file\n",
-    "(ending in _settings.json) and the data files (ending in .dat) from the data_dir\n",
-    "and packing them into an hdf5 file, which is then written into the same data_dir directory"
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: verbosity=0 to grid_options\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "EXAMPLE_COMPACT_OBJECT             2.867655467480e+01 1.33079 9.81391 0.00167028 13\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "EXAMPLE_COMPACT_OBJECT             1.931266944719e+01 1.3933 12.3177 0.00124307 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.439623364590e+01 1.38004 7.81906 0.00224431 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.364277535630e+01 1.47961 15.4603 0.000925128 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.017435498578e+01 1.59052 19.4046 0.000688507 13\n",
+      "EXAMPLE_COMPACT_OBJECT             8.294870923827e+00 1.7197 24.3552 0.000512406 13\n",
+      "EXAMPLE_COMPACT_OBJECT             6.802132608769e+00 1.84162 30.5689 0.000381347 13\n",
+      "EXAMPLE_COMPACT_OBJECT             5.723570798020e+00 1.99471 38.3678 0.00028381 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.933751523833e+00 2.15875 48.1564 0.000211219 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.337250536639e+00 2.35209 60.4424 0.000157195 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.862081089332e+00 2.56776 75.8628 0.000116989 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.449960890183e+00 2.80457 95.2174 8.70668e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.172196856333e+00 3.05193 119.51 6.47976e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.069627290216e+00 3.27563 150 4.82242e-05 14\n",
+      "Population-2a7732d03e594ef4b5dfe9051b41d9c0 finished! The total probability was: 0.05150046619238191. It took a total of 0.7797017097473145s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# change verbosity\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "## Executing a population\n",
+    "## This uses the values generated by the grid_variables\n",
+    "analytics = example_pop.evolve()  # TODO: update this function call"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "91ab45c7-7d31-4543-aee4-127ab58e891f",
+   "metadata": {},
+   "source": [
+    "After the run is complete, some technical report on the run is returned. I stored that in `analytics`. As we can see below, this dictionary is like a status report of the evolution. Useful for e.g. debugging."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
-   "id": "ad444138-f854-4fdb-8e18-49e35ac9c7e2",
+   "execution_count": 10,
+   "id": "e1f0464b-0424-4022-b34b-5b744bc2c59d",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating /tmp/binary_c_python/example_python_population_result/example_pop.hdf5\n",
-      "Adding settings to HDF5 file\n",
-      "Adding data to HDF5 file\n"
+      "{'population_name': '2a7732d03e594ef4b5dfe9051b41d9c0', 'evolution_type': 'grid', 'failed_count': 0, 'failed_prob': 0, 'failed_systems_error_codes': [], 'errors_exceeded': False, 'errors_found': False, 'total_probability': 0.05150046619238191, 'total_count': 20, 'start_timestamp': 1628444120.234709, 'end_timestamp': 1628444121.0144107, 'total_mass_run': 730.1048014407228, 'total_probability_weighted_mass_run': 0.2983275843337705, 'zero_prob_stars_skipped': 0}\n"
      ]
     }
    ],
    "source": [
-    "create_hdf5(data_dir=example_pop.custom_options[\"data_dir\"], name=\"example_pop.hdf5\")\n"
+    "print(analytics)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6460df56-9fba-4817-9a1e-593ef15d98c1",
+   "metadata": {},
+   "source": [
+    "## Noteworthy functionality\n",
+    "Some extra features that are available from via the population object are:\n",
+    "- write_binary_c_calls_to_file: Function to write the calls that would be passed to binary_c to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "34da69bc-fe60-4a9d-b07a-f6cd2f216964",
+   "execution_count": 11,
+   "id": "83f8e519-4f7c-474a-ad95-f175a34fae81",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method write_binary_c_calls_to_file in module binarycpython.utils.grid:\n",
+      "\n",
+      "write_binary_c_calls_to_file(output_dir:Union[str, NoneType]=None, output_filename:Union[str, NoneType]=None, include_defaults:bool=False) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function that loops over the grid code and writes the generated parameters to a file.\n",
+      "    In the form of a command line call\n",
+      "    \n",
+      "    Only useful when you have a variable grid as system_generator. MC wouldn't be that useful\n",
+      "    \n",
+      "    Also, make sure that in this export there are the basic parameters\n",
+      "    like m1,m2,sep, orb-per, ecc, probability etc.\n",
+      "    \n",
+      "    On default this will write to the datadir, if it exists\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: test this function\n",
+      "        - TODO: make sure the binary_c_python .. output file has a unique name\n",
+      "    \n",
+      "    Args:\n",
+      "        output_dir: (optional, default = None) directory where to write the file to. If custom_options['data_dir'] is present, then that one will be used first, and then the output_dir\n",
+      "        output_filename: (optional, default = None) filename of the output. If not set it will be called \"binary_c_calls.txt\"\n",
+      "        include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.\n",
+      "    \n",
+      "    Returns:\n",
+      "        filename: filename that was used to write the calls to\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.write_binary_c_calls_to_file)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "dacfed75-dfe3-4afd-a0ff-a4be17746021",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Saving grid code to grid_options\n",
+      "Writing grid code to /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Loading grid code function from /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Grid code loaded\n",
+      "Writing binary_c calls to /tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "/tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "binary_c M_1 2.0 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.013208238029791246\n",
+      "binary_c M_1 2.5102526289471614 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.009829948023831718\n",
+      "binary_c M_1 3.1506841305680684 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.0073157281034221516\n",
+      "binary_c M_1 3.9545065608702976 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.005444573822104362\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(verbosity=10)\n",
+    "calls_filename = example_pop.write_binary_c_calls_to_file()\n",
+    "print(calls_filename)\n",
+    "\n",
+    "with open(calls_filename, 'r') as f:\n",
+    "    print('\\n'.join(f.read().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "60359eb1-4d0c-4d2d-8265-ec5171b944a2",
+   "metadata": {},
+   "source": [
+    "## Full examples of population scripts\n",
+    "Below is a full setup for a population of single stars"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "7212b6be-9787-4122-a7f1-86538cf38179",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Population-3680f3882c0a449c944462abffea2447 finished! The total probability was: 0.05150046619238191. It took a total of 0.6246354579925537s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass zams_mass probability radius stellar_type\n",
+      "2.867655467480e+01 1.33079 9.81391 0.00167028 1.72498e-05 13\n",
+      "1.931266944719e+01 1.3933 12.3177 0.00124307 1.72498e-05 13\n",
+      "4.439623364590e+01 1.38004 7.81906 0.00224431 1.72498e-05 13\n",
+      "1.364277535630e+01 1.47961 15.4603 0.000925128 1.72498e-05 13\n",
+      "1.017435498578e+01 1.59052 19.4046 0.000688507 1.72498e-05 13\n",
+      "8.294870923827e+00 1.7197 24.3552 0.000512406 1.72498e-05 13\n",
+      "6.802132608769e+00 1.84162 30.5689 0.000381347 1.72498e-05 13\n",
+      "5.723570798020e+00 1.99471 38.3678 0.00028381 1.72498e-05 13\n",
+      "4.933751523833e+00 2.15875 48.1564 0.000211219 1.72498e-05 13\n",
+      "4.337250536639e+00 2.35209 60.4424 0.000157195 9.97286e-06 14\n",
+      "3.862081089332e+00 2.56776 75.8628 0.000116989 1.08873e-05 14\n",
+      "3.449960890183e+00 2.80457 95.2174 8.70668e-05 1.18914e-05 14\n",
+      "3.172196856333e+00 3.05193 119.51 6.47976e-05 1.29402e-05 14\n",
+      "3.069627290216e+00 3.27563 150 4.82242e-05 1.38887e-05 14\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"MY_STELLAR_DATA\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 4\n",
+    "            stardata->model.probability, // 5\n",
+    "            stardata->star[0].radius, // 6\n",
+    "            stardata->star[0].stellar_type // 7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 20}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2ab0979-6575-481d-9c1c-ca98517b2437",
+   "metadata": {},
+   "source": [
+    "We can also set up a population that samples biinary systems, by adding extra grid variables. Below is an example of a full script that runs a binary population and registers when a double compact object is formed. The logging is rather compact and should be expanded top be more useful"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "79acdbb2-7dd6-45c4-9609-80994f03619a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Grid has handled 125 stars\n",
+      "with a total probability of 0.0862478164626921\n",
+      "Total starcount for this run will be: 125\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Population-d20a4c74d20a43b881c0c9e5def5f76c finished! The total probability was: 0.08624781646269201. It took a total of 8.561265707015991s to run 125 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass_1 zams_mass_1 mass_2 zams_mass_2 stellar_type_1 prev_stellar_type_1 stellar_type_2 prev_stellar_type_2 metallicity probability\n",
+      "8.863377990313e+01 1.29444 5.88566 0 2.99283 13 5 15 15 0.02 0.000627913\n",
+      "1.146421815741e+02 0 5.88566 1.33062 4.43925 15 15 13 5 0.02 0.000627913\n",
+      "7.222715508467e+01 1.34922 5.88566 0 5.88566 13 5 15 15 0.02 0.000627913\n",
+      "1.350021848285e+01 1.48488 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171108213270e+01 1.53113 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171086983243e+01 1.53177 17.3205 0 0.1 13 9 15 15 0.02 0.000154349\n",
+      "1.170770599495e+01 1.53176 17.3205 0 4.40513 13 5 15 15 0.02 0.000172877\n",
+      "1.230407246199e+01 1.59499 17.3205 0 4.40513 13 5 15 15 0.02 0.000610573\n",
+      "1.108751340926e+01 1.70319 17.3205 0 8.71025 13 4 15 15 0.02 0.000610573\n",
+      "1.941017702765e+01 1.34903 17.3205 1.65097 8.71025 13 13 13 5 0.02 0.000172877\n",
+      "1.980988739731e+01 1.36979 17.3205 1.60808 8.71025 13 13 13 5 0.02 0.000121486\n",
+      "3.571858031651e+01 1.53174 17.3205 1.30504 8.71025 13 13 13 5 0.02 8.42148e-05\n",
+      "3.459153942631e+01 1.53176 17.3205 1.31004 8.71025 13 13 13 5 0.02 9.8162e-05\n",
+      "1.687368550125e+01 1.34937 17.3205 1.73856 13.0154 13 13 13 8 0.02 0.000172877\n",
+      "1.194842917007e+01 1.78096 17.3205 0 13.0154 13 8 15 15 0.02 0.000610573\n",
+      "1.733614170983e+01 1.53184 17.3205 1.42375 13.0154 13 13 13 5 0.02 9.8162e-05\n",
+      "1.723547465714e+01 1.38403 17.3205 1.71288 13.0154 13 13 13 8 0.02 0.000121486\n",
+      "1.764340254985e+01 1.53174 17.3205 1.41264 13.0154 13 13 13 5 0.02 8.42148e-05\n",
+      "1.170425790780e+01 1.52963 17.3205 0 17.3205 13 5 15 15 0.02 0.000172877\n",
+      "8.922967341481e+00 1.85486 17.3205 0 17.3205 13 8 15 15 0.02 0.000610573\n",
+      "1.232906623449e+01 1.41074 17.3205 1.34281 17.3205 13 13 13 8 0.02 0.000121486\n",
+      "1.170775828562e+01 1.53183 17.3205 1.53183 17.3205 13 5 13 5 0.02 9.8162e-05\n",
+      "1.170770422321e+01 1.53175 17.3205 1.53175 17.3205 13 5 13 5 0.02 8.42148e-05\n",
+      "5.075844624794e+00 2.12303 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.766606588165e+00 2.20484 50.9713 0 0.1 14 8 15 15 0.02 3.79411e-05\n",
+      "4.768305081494e+00 2.18838 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.458869865939e+00 2.29864 50.9713 0 12.8178 14 8 15 15 0.02 0.000150087\n",
+      "1.806014211040e+01 2.10446 50.9713 1.40749 12.8178 13 13 13 5 0.02 2.9863e-05\n",
+      "4.797342083485e+00 2.10328 50.9713 0 12.8178 13 13 15 1 0.02 4.24954e-05\n",
+      "1.721374713429e+01 2.21673 50.9713 1.42212 12.8178 14 14 13 5 0.02 2.41295e-05\n",
+      "4.055645404546e+00 2.47276 50.9713 0 25.5357 14 7 15 15 0.02 0.000150087\n",
+      "1.806123543037e+01 2.21893 50.9713 1.40745 12.8178 14 14 13 5 0.02 2.07011e-05\n",
+      "8.117519147635e+00 2.10433 50.9713 2.21473 25.5357 13 13 14 8 0.02 4.24954e-05\n",
+      "8.315554923168e+00 2.15343 50.9713 2.08519 25.5357 13 13 13 8 0.02 2.9863e-05\n",
+      "7.917420996633e+00 2.21892 50.9713 1.7431 25.5357 14 14 13 8 0.02 2.07011e-05\n",
+      "7.693213405973e+00 2.21805 50.9713 1.78384 25.5357 14 14 13 8 0.02 2.41295e-05\n",
+      "3.753837732894e+00 2.62517 50.9713 0 38.2535 14 7 15 15 0.02 0.000150087\n",
+      "7.087296558990e+00 2.10417 50.9713 2.40935 38.2535 13 13 14 8 0.02 4.24954e-05\n",
+      "7.007109286263e+00 2.15854 50.9713 2.28672 38.2535 13 13 14 8 0.02 2.9863e-05\n",
+      "5.653200958306e+00 2.21878 50.9713 2.0587 38.2535 14 14 13 8 0.02 2.41295e-05\n",
+      "5.733794947644e+00 2.21892 50.9713 1.99255 38.2535 14 14 13 8 0.02 2.07011e-05\n",
+      "3.513216011269e+00 2.76647 50.9713 0 50.9713 14 7 15 15 0.02 0.000150087\n",
+      "4.750574783854e+00 2.27442 50.9713 0 50.9713 14 8 15 15 0.02 4.24954e-05\n",
+      "7.278384712062e+00 1.29678 50.9713 2.09216 50.9713 13 8 13 13 0.02 2.9863e-05\n",
+      "4.765996194699e+00 2.20787 50.9713 2.20787 50.9713 14 8 14 8 0.02 2.07011e-05\n",
+      "4.765535914728e+00 2.21331 50.9713 2.21331 50.9713 14 8 14 8 0.02 2.41295e-05\n",
+      "3.104706358826e+00 3.17639 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.069363482023e+00 3.27572 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.047074050271e+00 3.3836 150 0 37.575 14 7 15 15 0.02 3.68933e-05\n",
+      "5.974759306305e+00 3.23604 150 2.53922 37.575 14 14 14 7 0.02 1.04459e-05\n",
+      "6.074084349384e+00 3.30145 150 2.13876 37.575 14 14 13 8 0.02 7.34071e-06\n",
+      "5.733865371895e+00 3.29994 150 2.00498 37.575 14 14 13 8 0.02 5.93135e-06\n",
+      "3.027099358410e+00 3.53631 150 0 75.05 14 7 15 15 0.02 3.68933e-05\n",
+      "5.807147339697e+00 3.30197 150 1.9791 37.575 14 14 13 8 0.02 5.08861e-06\n",
+      "4.862942347290e+00 3.25294 150 2.97823 75.05 14 14 14 7 0.02 1.04459e-05\n",
+      "4.556479830908e+00 3.29942 150 2.73221 75.05 14 14 14 7 0.02 7.34071e-06\n",
+      "3.853070305680e+00 3.29977 150 2.62486 75.05 14 14 14 7 0.02 5.93135e-06\n",
+      "3.881529045940e+00 3.30149 150 2.55924 75.05 14 14 14 7 0.02 5.08861e-06\n",
+      "3.015033359333e+00 3.64419 150 0 112.525 14 7 15 15 0.02 3.68933e-05\n",
+      "4.126828648362e+00 3.32047 150 0 112.525 14 14 15 3 0.02 1.04459e-05\n",
+      "3.990017992944e+00 3.3032 150 2.94027 112.525 14 14 14 7 0.02 7.34071e-06\n",
+      "3.206771867883e+00 3.07671 150 3.11282 112.525 14 14 14 7 0.02 5.93135e-06\n",
+      "3.006827156705e+00 3.72638 150 0 150 14 7 15 15 0.02 3.68933e-05\n",
+      "3.218786094847e+00 3.30337 150 3.01344 112.525 14 14 14 7 0.02 5.08861e-06\n",
+      "4.527722847382e+00 1.42238 150 0 150 13 5 15 15 0.02 1.04459e-05\n",
+      "3.069567332611e+00 3.27804 150 3.27804 150 14 7 14 7 0.02 5.93135e-06\n",
+      "5.726405299909e+00 1.29746 150 3.22759 150 13 8 14 14 0.02 7.34071e-06\n",
+      "3.069626478211e+00 3.27565 150 3.27565 150 14 7 14 7 0.02 5.08861e-06\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\n",
+    "        \"time\", \n",
+    "        \"mass_1\", \"zams_mass_1\", \"mass_2\", \"zams_mass_2\",\n",
+    "        \"stellar_type_1\", \"prev_stellar_type_1\", \"stellar_type_2\", \"prev_stellar_type_2\", \n",
+    "        \"metallicity\", \"probability\"\n",
+    "    ]\n",
+    "    \n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_DCO\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "// logger to find gravitational wave progenitors\n",
+    "if(stardata->star[0].stellar_type>=NS && stardata->star[1].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_DCO %30.12e \" // 1\n",
+    "            \"%g %g %g %g \" // 2-5\n",
+    "            \"%d %d %d %d \" // 6-9\n",
+    "            \"%g %g\\\\n\", // 10-11\n",
+    "\n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->common.zero_age.mass[0], //3\n",
+    "            stardata->star[1].mass, //4\n",
+    "            stardata->common.zero_age.mass[1], //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "            stardata->star[1].stellar_type, //8\n",
+    "            stardata->previous_stardata->star[1].stellar_type, //9\n",
+    "\n",
+    "            // model stuff\n",
+    "            stardata->common.metallicity, //10\n",
+    "            stardata->model.probability //11\n",
+    "        );\n",
+    "    }\n",
+    "    /* Kill the simulation to safe time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "}\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 5, \"q\": 5, \"per\": 5}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "# Mass ratio\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"q\",\n",
+    "    longname=\"Mass ratio\",\n",
+    "    valuerange=[\"0.1/M_1\", 1],\n",
+    "    resolution=\"{}\".format(resolution['q']),\n",
+    "    spacingfunc=\"const(0.1/M_1, 1, {})\".format(resolution['q']),\n",
+    "    probdist=\"flatsections(q, [{'min': 0.1/M_1, 'max': 1.0, 'height': 1}])\",\n",
+    "    dphasevol=\"dq\",\n",
+    "    precode=\"M_2 = q * M_1\",\n",
+    "    parameter_name=\"M_2\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "example_pop.add_grid_variable(\n",
+    "   name=\"log10per\", # in days\n",
+    "   longname=\"log10(Orbital_Period)\",\n",
+    "   valuerange=[0.15, 5.5],\n",
+    "   resolution=\"{}\".format(resolution[\"per\"]),\n",
+    "   spacingfunc=\"const(0.15, 5.5, {})\".format(resolution[\"per\"]),\n",
+    "   precode=\"\"\"orbital_period = 10** log10per\n",
+    "sep = calc_sep_from_period(M_1, M_2, orbital_period)\n",
+    "sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)\n",
+    "sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)\"\"\",\n",
+    "   probdist=\"sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)\",\n",
+    "   parameter_name=\"orbital_period\",\n",
+    "   dphasevol=\"dlog10per\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
   }
  ],
  "metadata": {
diff --git a/docs/build/doctrees/notebook_api_functionality.doctree b/docs/build/doctrees/notebook_api_functionality.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..d13dc561967683b55c3d7d9fa7e91bc39cca513f
GIT binary patch
literal 409627
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

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/notebook_custom_logging.doctree b/docs/build/doctrees/notebook_custom_logging.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..0897e2ff37eec933d0519126e6a06dd587d9bdee
GIT binary patch
literal 47759
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

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/notebook_extra_features.doctree b/docs/build/doctrees/notebook_extra_features.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..f0032b9960a7cf4b362985aa0456b119598a5c5e
GIT binary patch
literal 3928
zcmcgvTW=h<6_#x6P13I9TTq~OJGr4Qiq*z&5EusfP^1l-s8xU<ErJvV!I|MM8O@Lr
zk|XUV5Sl&&unWG0LD2t`KhnJBInV9Kx$H%*b7_Dqu+s97JoodR!%ucT|MS6C^>GKL
z;6l!iXqrluGUHu8RY{pMY5iyZ*Z=Sr{;nHndTvyy6Xx9(P9$7psb<nY@^|@`8*(w@
z8NN27a<;t2JG{$#kG$KZ)@l)#7VHDNt0FbH>Uv2=jR6tAJCf%0uYOt<t3^zcQ_ZH;
znVpKg+mT8_k<L^Fg`T*BOh_h`<(e6;vef^x|DXEv_tNz&ods^54_vpPP}+Kam2dN_
zuG^X<CtT%hlF~DgP719)V2L%8SV*cDBq3TU+pLmeVY!kdWoOI%aZQ`RZDvxloIo2E
zD|JfP+-gdujM@^~9f@KgWAAo?#{PJ_jNK@B+ltH_HSX^vD&O#a>qb6;@A%;(&#&Wq
z6W{0X{TX~WnCIC;Q_v8eegQd5pD|zZU+|asFKc6Y#GmIc9Cyo@zvy}f1_~vgiqu_f
zcC4@&TibH?{t%3aS|cJV(`Z`CiUrMtT|{ac)!u6S<3rfNYv*0q4_5yVi%)%(d$9f?
zjCc?t#-kJd!bus^XSyQT{2Gqmua8$Y4=S4nh&`QYTJUw#=5NZ#a$%x2V9`1IRhC6F
z6{$0(BZIsM)>+P?DwN;m1<R?8&S}LgO2U1XMj{9R5B$+fDdwp5&~M#G|3iVVKKa*A
zqQc6<e}c>2`u-mNW0OsLt*7DPH*2Wi9R&UD-@o13S1(qQ-p7^qez>IJnxvOoNj17W
zGZ*-TztYygdOqB!^C3~vQk0=y%ZHj{fV3SYv&B<8Na-OGo@ttqI8({#+6lMwx9HKs
zrQOwHWp@__e0(``0Z3Zqh4pl!ocjUhN;*R|*HG75vH+8_;QPyrHm>imd7*KY+dQj4
zz~b76fSSIHYq0lj|8-#f?=+()_`haE<I<15#l>z{$fC3aP)eVzcppd?kn+A?SN@Cd
zRKE2HzW_Yjlxgjsgdl!i+rT!Web@CQa0l9W*Of7viS=yV7vZMD&9(3YKKPH#pxb4<
zQl!DQaSM-Qz~guW9>;1r-h@ZmLb$v4ov88@w$c{&gLU^{UDeH+k_6bTRBNTQ7nU85
zKksg~$v}imvNB~PF~&a*Jh$B_DRt<Sr0I|+Zoj2eo$JK)4YO9r8Rms+%MLcxs3|5>
zMB}eCE78u|34*_N;s!H@YNJ+Zk3~u`4Op5NSnSne2zZ}jx!WvDonbY!Dj{JC2)hv1
zfnIvy-SsKja)9l%&Esu1482X3IhkWT$kAin$YA&=NYhpgSpK}Gu#AO9Ysk5<oV2qD
zBsLeC;RMEORw!*r#?DygkFU60PP65*<F2u}fUhi?ylD@0Tqk95IfJ;-In@%r!U@z&
z4$1)iG-1Ig|JaS{dSWtBDNdoCmv%aSFg60eZ*OiA6ok@*BgZlzSEvy!5~TluDs8CB
z6_-xM#k)I~b}q5tU%OGwbnWV2-hE^I0KzvnF5Ps8!2km<Vel%lYWf(q&;@q`SlkuN
zi0+1FiP9;CrUJ<UF#?%!;<`ZKDQtv0L`pEWOvT*ut{c(PDzYNED*_ocOv}6=%dCS}
zD}q46X-Tud@Svi=wbF#xuSkVqWvU3KB%C?~JSxMG_N$v!iX@ht2_x$KJRqqsG|o^K
zt(LvE8c;p^FvcMNX*EV6WtwATDzbWt9Tlt~un9weOe%Z#10|*q9TM9`+}grCoJ`Ko
z&yQ-bJW_f#38N)Wnu&L}!i~T&+#r_a@UpFDJXVZfe&toTWu&JVP&dQ`%1X@bR*Y2&
zL#AMMT8RnW0U`#L#>oHFa(~=+caTjvSr*okFR6#iC+@jQ8zC`a2FsCd!AB{wcn?p6
z<q}nQXcp+NbFzFIgsE4B^xii)MKOI?qIQ8e?nbq)mjq3fHXgi_aExpTqEy!uA{M}h
z;Pz=*VD1m2b2Y3swf+Q2q7ose2z6Wh*8?1wGTuCQ$nuz_sK*6lamFmT-AXb=F|g-U
zWCX7vjM3p~^4MKv@(g)%trDIwIRjW^A{W-bwe|0BI-#-F_<({$dI^~dB)lb->KU`u
z!{r(@K)P5A`qkqB&zTD#*ao$J@_-C()8(RzMR+ZN-V4O~H~+F}96zY*7&izk?4p2O
z7oLB4V))^O|KK;<TU-3Tal`e%S0aar0H_6>p+-#!#o3;#ZCj_*=kO#!`14q0%Ur6C
z-n>Lyo*ry)9JEraOV>B}17x)gsDA4*uV!Zp^GS+oEJJyFx0k3aLo{FmdPnc|hW;7s
p|J1*O`oXgR6^W;(!N64uTq4K@d2dOs;=G#%P;2Tx476o@^k4Q|@hSiS

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/notebook_individual_systems.doctree b/docs/build/doctrees/notebook_individual_systems.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..9d602efb727073bda11972d674aef97623b4bce7
GIT binary patch
literal 54049
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
H)zbe5sF#lC

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/notebook_population.doctree b/docs/build/doctrees/notebook_population.doctree
index 08f0c57f12317e7f4149d83f15a4840761b0faaf..2fe6b3d2cc9149c8f3a8350e8ae7e16a7bbf1060 100644
GIT binary patch
literal 154820
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

literal 27909
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
KX*DRUmj4&byYr&}

diff --git a/docs/build/doctrees/notebooks.doctree b/docs/build/doctrees/notebooks.doctree
deleted file mode 100644
index f123d088aa1dfda9abcccddf71c255d92624ca9c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2843
zcmZ`*&ubhv6n0|ode>gB?YPM$b}^+bX;XW1=plqsD1jbo*g{EqONC~nT`8WCrjo{9
z9|G+mB>^1@QUAdH5xw`*{PONX42wrkPw&U~-ut9Kw*EQT-KhTjzAc1Qi*w4D(u~{S
z2TZ4B&Xo%v!dHKWH{p>V8hUMYX;L2i1~gJ3GiJC7uYw;(btf}>-kjgIJatm5?zrfQ
zzSw>h9*LpvIq5RKwB?6W?RcW~r43ODI$JOJB068*dK;=pVCu;C3ku&Zh(mElZ2Eo^
z+0<`kQt>b?6Y6)Ub4DhmLq;)!P04JGc00|ewGiUFr)XY(4Om&+E)tqv8a|6UrQddR
z9=C$n7Z1fKdKAb0w~5d>pD=nQ*`zS~HBz>dL@H`-NJ@;>u34qUjT2fC#;>~lvsyL*
za&}TjKT$0T=f)znlZ(4$0xX8emCg+<#4={%7lNPOo~VI);Mc{spglqC=XLB;aS{;{
zp8^(f3cx?Z?{oaV#P1PO7GH~R#Ibmc7&hCKt5^o9&I?^CwiHTTS+N0}bm|OWE^V{-
zF-PK|A9gvQGAOB$RXwKusNEoiF3OBn{q$F$ek4_zm5k41R;h}gsUPHY!Fb_BxVVb~
z)1uP$!{=H#7`4xW-<oGS3GaPhNXF2&@BLn5s1poSnJ3(E7A`jYPSvJXtLz54J81vg
z=&EJwMZAo7{m|gm2VUQ=gX{MjXwI%t$AX(c*YW<Y#ksbF`tYtk%OKIVSgXRN%I(0?
zW?ks2g6N`;m%1Ar@i=C2$B)y}#L*(%NR3)aJz9QXxpPv@!4rqw;Ll8jGz-4}E6qw2
zrezMXKlQ^oSKLsiO~8UtjHIJ^fyHj^hQRhEmOIU|G#OTVK#jyvjJt5xixs#D{@x73
z729KJ^Wu)*i>!kZlEqA$JU}wG=%<39X(O3gn0#1Ec*ZLUxt30lmJr~vInXe~)Q=1=
zv~eWkS3HZ&wIgWOEqnfuFC?&X)RneX>iHhyNjZnR@ijFHSV6;ZnnN;lhNe6w72f%=
zR7L3sSE**u0^OBvcJ}nlN_-!$ZW3;cHbhXxGBgkhhul&Z{Jt*Ts+C@4CHRxIoi!8U
zZ$GY$-UiTn`Qpd3r*OWyv3AlQ!~`r*62K=zLc#B4RLx5|=YX4GeHSz4j|@+>VW7T(
zD@<J)r+e!Asa7-O2sk7o1(;SYg6R7(EuAK}B7aw+qxM*t7o_VtpjrteM%yTwMT7g5
z1kfrQYkw;$EH9ZRi#+zz0bdl_a<Y7~YLV2DD`{ojpZkPKOOq@n(nPu4PJ?*tM@Yt^
z|7$`*%QR}F<s&~XctMa8m_(&jzN08fC|t+J_NT(R!akc!uCK4p>x<xAoB1SO5YV)f
z;P1y1(PBJ79M6HW1F8ea&%Su_Enpd&8LpWXH&Jry=D2m^w8q^mxtmpPgv&Fy7&@Au
z|5+r>fj>bv<)j;|&MvV<Ebn{&po&H+%S|L#G;PF)p^JCHjolJccVKUnqYEPBTx9s6
zN4GK^+k0eliedV_#Ozv}JgV09l4LriHKY5JRN&4_QQvx|P_alp1g9^{0>Q)=N5#+0
ztb@!Uk!prgx5Ixg(t$0LRlNfaif5R|8~75OJ6OA)W}03So>Q3-yn+m`-UsjeCRbPJ
zo5RX^#?>5Tk;z=T@YBY>|Mkkm4{CnEK%%{*ViFDSh@)oC!8dqe93ld=i^Kb<dII20
z@dgaGBCX#Y5X0K6TlBGrPZr3xqp<!Kuf^Pg`yp^Q1yFnw#OtXQr}#e?BkT8;YgnD$
zOC|Uzx`)MD66dVdtHWHD)OrXWmCO^Jb!}0pezGR)w1+DehppG@(7hG=;7j8oLEm4u
z)$HK<1q-BjX`ly!-%WLv0a)aKYhe3%BmaQp--cf>3V0%6xbT#-AfVb|M+Ph6-A-JU
QY==dDYDPKUnPqbRKPALw8UO$Q

diff --git a/docs/build/doctrees/population_example.doctree b/docs/build/doctrees/population_example.doctree
deleted file mode 100644
index 6a13c71bb631c06a385ab1128f9652c3c2d2d912..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 17941
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
UZf23;>k{CftSQr)Sxm?O2dHsiD*ylh

diff --git a/docs/build/html/_modules/binarycpython/utils/custom_logging_functions.html b/docs/build/html/_modules/binarycpython/utils/custom_logging_functions.html
index 58baa7f28..6178bd940 100644
--- a/docs/build/html/_modules/binarycpython/utils/custom_logging_functions.html
+++ b/docs/build/html/_modules/binarycpython/utils/custom_logging_functions.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -171,7 +171,7 @@
 <span class="kn">from</span> <span class="nn">binarycpython.utils.functions</span> <span class="kn">import</span> <span class="n">temp_dir</span><span class="p">,</span> <span class="n">remove_file</span><span class="p">,</span> <span class="n">verbose_print</span>
 
 
-<div class="viewcode-block" id="autogen_C_logging_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.autogen_C_logging_code">[docs]</a><span class="k">def</span> <span class="nf">autogen_C_logging_code</span><span class="p">(</span><span class="n">logging_dict</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<div class="viewcode-block" id="autogen_C_logging_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.autogen_C_logging_code">[docs]</a><span class="k">def</span> <span class="nf">autogen_C_logging_code</span><span class="p">(</span><span class="n">logging_dict</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function that auto-generates PRINTF statements for binaryc.</span>
 <span class="sd">    Input is a dictionary where the key is the header of that logging line</span>
@@ -208,12 +208,13 @@
 
     <span class="c1"># Loop over dict keys</span>
     <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">logging_dict</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span>
-                <span class="s2">&quot;Generating Print statement for custom logging code with </span><span class="si">{}</span><span class="s2"> as a header&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+        <span class="n">verbose_print</span><span class="p">(</span>
+            <span class="s2">&quot;Generating Print statement for custom logging code with </span><span class="si">{}</span><span class="s2"> as a header&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
                     <span class="n">key</span>
-                <span class="p">)</span>
-            <span class="p">)</span>
+            <span class="p">),</span>
+            <span class="n">verbosity</span><span class="p">,</span>
+            <span class="mi">1</span><span class="p">,</span>
+        <span class="p">)</span>
         <span class="n">logging_dict_entry</span> <span class="o">=</span> <span class="n">logging_dict</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
 
         <span class="c1"># Check if item is of correct type:</span>
@@ -241,7 +242,7 @@
 
 
 <span class="c1">####################################################################################</span>
-<div class="viewcode-block" id="binary_c_log_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.binary_c_log_code">[docs]</a><span class="k">def</span> <span class="nf">binary_c_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<div class="viewcode-block" id="binary_c_log_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.binary_c_log_code">[docs]</a><span class="k">def</span> <span class="nf">binary_c_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function to construct the code to construct the custom logging function</span>
 
@@ -272,16 +273,17 @@
 
 <span class="sd">    Args:</span>
 <span class="sd">        code: Exact c-statement to output information in binary_c. Can be wrapped in logical statements.</span>
-<span class="sd">        verbose: Level of verbosity. Defaults to zero if not set explicitly.</span>
+<span class="sd">        verbosity: Level of verbosity. Defaults to zero if not set explicitly.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        string containing the custom logging code. This includes all the includes and other definitions. This code will be used as the shared library</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
     <span class="n">verbose_print</span><span class="p">(</span>
-        <span class="s2">&quot;Creating the code for the shared library for the custom logging&quot;</span><span class="p">,</span> <span class="n">verbose</span><span class="p">,</span> <span class="mi">0</span>
+        <span class="s2">&quot;Creating the code for the shared library for the custom logging&quot;</span><span class="p">,</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
     <span class="p">)</span>
-
     <span class="k">if</span> <span class="ow">not</span> <span class="s2">&quot;Printf&quot;</span> <span class="ow">in</span> <span class="n">code</span><span class="p">:</span>
         <span class="nb">print</span><span class="p">(</span>
             <span class="s2">&quot;Error: There has to be at least a printf statement in the provided code. Aborting&quot;</span>
@@ -316,14 +318,14 @@
     <span class="k">return</span> <span class="n">textwrap</span><span class="o">.</span><span class="n">dedent</span><span class="p">(</span><span class="n">custom_logging_function_string</span><span class="p">)</span></div>
 
 
-<div class="viewcode-block" id="binary_c_write_log_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.binary_c_write_log_code">[docs]</a><span class="k">def</span> <span class="nf">binary_c_write_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">filename</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<div class="viewcode-block" id="binary_c_write_log_code"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.binary_c_write_log_code">[docs]</a><span class="k">def</span> <span class="nf">binary_c_write_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">filename</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function to write the generated logging code to a file</span>
 
 <span class="sd">    Args:</span>
 <span class="sd">        code: string containing the custom logging code to write to a file.</span>
 <span class="sd">        filename: target filename.</span>
-<span class="sd">        verbose: Level of verbosity. Defaults to zero if not set explicitly.</span>
+<span class="sd">        verbosity: Level of verbosity. Defaults to zero if not set explicitly.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
     <span class="c1"># TODO: change this. I don&#39;t like the cwd</span>
@@ -331,10 +333,12 @@
     <span class="n">filePath</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">cwd</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
 
     <span class="c1"># Remove if it exists</span>
-    <span class="n">remove_file</span><span class="p">(</span><span class="n">filePath</span><span class="p">,</span> <span class="n">verbose</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Writing the custom logging code to </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">filePath</span><span class="p">))</span>
+    <span class="n">remove_file</span><span class="p">(</span><span class="n">filePath</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">)</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;Writing the custom logging code to </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">filePath</span><span class="p">),</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
 
     <span class="c1"># Write again</span>
     <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">filePath</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span>
@@ -366,7 +370,7 @@
     <span class="k">return</span> <span class="n">res</span></div>
 
 
-<div class="viewcode-block" id="return_compilation_dict"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.return_compilation_dict">[docs]</a><span class="k">def</span> <span class="nf">return_compilation_dict</span><span class="p">(</span><span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
+<div class="viewcode-block" id="return_compilation_dict"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.return_compilation_dict">[docs]</a><span class="k">def</span> <span class="nf">return_compilation_dict</span><span class="p">(</span><span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function to build the compile command for the shared library</span>
 
@@ -376,16 +380,18 @@
 <span class="sd">    # https://developers.redhat.com/blog/2018/03/21/compiler-and-linker-flags-gcc/</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        verbose: Level of verbosity. Defaults to zero if not set explicitly.</span>
+<span class="sd">        verbosity: Level of verbosity. Defaults to zero if not set explicitly.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        string containing the command to build the shared library</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span>
-            <span class="s2">&quot;Calling the binary_c config code to get the info to build the shared library&quot;</span>
-        <span class="p">)</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;Calling the binary_c config code to get the info to build the shared library&quot;</span><span class="p">,</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
+
     <span class="c1"># use binary_c-config to get necessary flags</span>
     <span class="n">BINARY_C_DIR</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s2">&quot;BINARY_C&quot;</span><span class="p">)</span>
     <span class="k">if</span> <span class="n">BINARY_C_DIR</span><span class="p">:</span>
@@ -455,18 +461,20 @@
     <span class="p">]</span>
     <span class="n">libs</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{}</span><span class="s2"> </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">library_paths</span><span class="p">),</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">non_library_paths</span><span class="p">))</span>
 
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span>
-            <span class="s2">&quot;Got options to compile:</span><span class="se">\n\t</span><span class="s2">cc = </span><span class="si">{cc}</span><span class="se">\n\t</span><span class="s2">ccflags = </span><span class="si">{ccflags}</span><span class="se">\n\t</span><span class="s2">ld = </span><span class="si">{ld}</span><span class="se">\n\t</span><span class="s2">libs = </span><span class="si">{libs}</span><span class="se">\n\t</span><span class="s2">inc = </span><span class="si">{inc}</span><span class="se">\n\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="c1">#</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;Got options to compile:</span><span class="se">\n\t</span><span class="s2">cc = </span><span class="si">{cc}</span><span class="se">\n\t</span><span class="s2">ccflags = </span><span class="si">{ccflags}</span><span class="se">\n\t</span><span class="s2">ld = </span><span class="si">{ld}</span><span class="se">\n\t</span><span class="s2">libs = </span><span class="si">{libs}</span><span class="se">\n\t</span><span class="s2">inc = </span><span class="si">{inc}</span><span class="se">\n\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
                 <span class="n">cc</span><span class="o">=</span><span class="n">cc</span><span class="p">,</span> <span class="n">ccflags</span><span class="o">=</span><span class="n">ccflags</span><span class="p">,</span> <span class="n">ld</span><span class="o">=</span><span class="n">ld</span><span class="p">,</span> <span class="n">libs</span><span class="o">=</span><span class="n">libs</span><span class="p">,</span> <span class="n">inc</span><span class="o">=</span><span class="n">inc</span>
-            <span class="p">)</span>
-        <span class="p">)</span>
+        <span class="p">),</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
 
     <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;cc&quot;</span><span class="p">:</span> <span class="n">cc</span><span class="p">,</span> <span class="s2">&quot;ld&quot;</span><span class="p">:</span> <span class="n">ld</span><span class="p">,</span> <span class="s2">&quot;ccflags&quot;</span><span class="p">:</span> <span class="n">ccflags</span><span class="p">,</span> <span class="s2">&quot;libs&quot;</span><span class="p">:</span> <span class="n">libs</span><span class="p">,</span> <span class="s2">&quot;inc&quot;</span><span class="p">:</span> <span class="n">inc</span><span class="p">}</span></div>
 
 
 <div class="viewcode-block" id="compile_shared_lib"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.compile_shared_lib">[docs]</a><span class="k">def</span> <span class="nf">compile_shared_lib</span><span class="p">(</span>
-    <span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">sourcefile_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">outfile_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span>
+    <span class="n">code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">sourcefile_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">outfile_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function to write the custom logging code to a file and then compile it.</span>
@@ -478,17 +486,17 @@
 <span class="sd">        code: string containing the custom logging code</span>
 <span class="sd">        sourcefile_name: name of the file that will contain the code</span>
 <span class="sd">        outfile_name: name of the file that will be the shared library</span>
-<span class="sd">        verbose: Level of verbosity. Defaults to zero if not set explicitly.</span>
+<span class="sd">        verbosity: Level of verbosity. Defaults to zero if not set explicitly.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
     <span class="c1"># Write code to file</span>
-    <span class="n">binary_c_write_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">sourcefile_name</span><span class="p">,</span> <span class="n">verbose</span><span class="p">)</span>
+    <span class="n">binary_c_write_log_code</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">sourcefile_name</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">)</span>
 
     <span class="c1"># Remove the library if present:</span>
-    <span class="n">remove_file</span><span class="p">(</span><span class="n">outfile_name</span><span class="p">,</span> <span class="n">verbose</span><span class="p">)</span>
+    <span class="n">remove_file</span><span class="p">(</span><span class="n">outfile_name</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">)</span>
 
     <span class="c1"># create compilation command</span>
-    <span class="n">compilation_dict</span> <span class="o">=</span> <span class="n">return_compilation_dict</span><span class="p">(</span><span class="n">verbose</span><span class="p">)</span>
+    <span class="n">compilation_dict</span> <span class="o">=</span> <span class="n">return_compilation_dict</span><span class="p">(</span><span class="n">verbosity</span><span class="p">)</span>
 
     <span class="c1"># Construct full command</span>
     <span class="n">command</span> <span class="o">=</span> <span class="p">(</span>
@@ -506,26 +514,32 @@
     <span class="n">command</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">command</span><span class="o">.</span><span class="n">split</span><span class="p">())</span>
 
     <span class="c1"># Execute compilation and create the library</span>
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span>
-            <span class="s2">&quot;Building shared library for custom logging with (binary_c.h) on </span><span class="si">{}</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;Building shared library for custom logging with (binary_c.h) on </span><span class="si">{}</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
                 <span class="n">socket</span><span class="o">.</span><span class="n">gethostname</span><span class="p">()</span>
-            <span class="p">)</span>
-        <span class="p">)</span>
-        <span class="nb">print</span><span class="p">(</span>
-            <span class="s2">&quot;Executing following command to compile the shared library:</span><span class="se">\n</span><span class="si">{command}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-                <span class="n">command</span><span class="o">=</span><span class="n">command</span>
-            <span class="p">)</span>
-        <span class="p">)</span>
-    <span class="n">res</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">check_output</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">{command}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">command</span><span class="o">=</span><span class="n">command</span><span class="p">),</span> <span class="n">shell</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-    <span class="c1"># print(res)</span>
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">res</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Output of compilation command:</span><span class="se">\n</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">res</span><span class="p">))</span></div>
+        <span class="p">),</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;Executing following command to compile the shared library:</span><span class="se">\n</span><span class="si">{command}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+            <span class="n">command</span><span class="o">=</span><span class="n">command</span>
+        <span class="p">),</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
 
+    <span class="c1">#</span>
+    <span class="n">res</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">check_output</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">{command}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">command</span><span class="o">=</span><span class="n">command</span><span class="p">),</span> <span class="n">shell</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">res</span><span class="p">:</span>
+        <span class="n">verbose_print</span><span class="p">(</span>
+            <span class="s2">&quot;Output of compilation command:</span><span class="se">\n</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">res</span><span class="p">),</span>
+            <span class="n">verbosity</span><span class="p">,</span>
+            <span class="mi">1</span><span class="p">,</span>
+        <span class="p">)</span></div>
 
 <div class="viewcode-block" id="create_and_load_logging_function"><a class="viewcode-back" href="../../../custom_logging_functions.html#binarycpython.utils.custom_logging_functions.create_and_load_logging_function">[docs]</a><span class="k">def</span> <span class="nf">create_and_load_logging_function</span><span class="p">(</span>
-    <span class="n">custom_logging_code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbose</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">custom_tmp_dir</span><span class="o">=</span><span class="kc">None</span>
+    <span class="n">custom_logging_code</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">verbosity</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">custom_tmp_dir</span><span class="o">=</span><span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">str</span><span class="p">]:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Function to automatically compile the shared library with the given</span>
@@ -536,7 +550,7 @@
 
 <span class="sd">    Args:</span>
 <span class="sd">        custom_logging_code: string containing the custom logging code</span>
-<span class="sd">        verbose: Level of verbosity. Defaults to zero if not set explicitly.</span>
+<span class="sd">        verbosity: Level of verbosity. Defaults to zero if not set explicitly.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        memory address of the custom logging function in a capsule.</span>
@@ -562,11 +576,14 @@
         <span class="n">custom_logging_code</span><span class="p">,</span>
         <span class="n">sourcefile_name</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">custom_logging_dir</span><span class="p">,</span> <span class="s2">&quot;custom_logging.c&quot;</span><span class="p">),</span>
         <span class="n">outfile_name</span><span class="o">=</span><span class="n">library_name</span><span class="p">,</span>
-        <span class="n">verbose</span><span class="o">=</span><span class="n">verbose</span><span class="p">,</span>
+        <span class="n">verbosity</span><span class="o">=</span><span class="n">verbosity</span><span class="p">,</span>
     <span class="p">)</span>
 
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;loading shared library for custom logging&quot;</span><span class="p">)</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;loading shared library for custom logging&quot;</span><span class="p">,</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
 
     <span class="c1"># Loading library</span>
     <span class="n">_</span> <span class="o">=</span> <span class="n">ctypes</span><span class="o">.</span><span class="n">CDLL</span><span class="p">(</span><span class="s2">&quot;libgslcblas.so&quot;</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="n">ctypes</span><span class="o">.</span><span class="n">RTLD_GLOBAL</span><span class="p">)</span>
@@ -591,13 +608,14 @@
         <span class="p">)</span>
         <span class="k">raise</span> <span class="ne">ValueError</span>
 
-    <span class="k">if</span> <span class="n">verbose</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="nb">print</span><span class="p">(</span>
-            <span class="s2">&quot;loaded shared library for custom logging. </span><span class="se">\</span>
-<span class="s2">            custom_output_function is loaded in memory at </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-                <span class="n">func_memaddr</span>
-            <span class="p">)</span>
-        <span class="p">)</span>
+    <span class="n">verbose_print</span><span class="p">(</span>
+        <span class="s2">&quot;loaded shared library for custom logging. </span><span class="se">\</span>
+<span class="s2">        custom_output_function is loaded in memory at </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+            <span class="n">func_memaddr</span>
+        <span class="p">),</span>
+        <span class="n">verbosity</span><span class="p">,</span>
+        <span class="mi">1</span><span class="p">,</span>
+    <span class="p">)</span>
 
     <span class="k">return</span> <span class="n">func_memaddr</span><span class="p">,</span> <span class="n">library_name</span></div>
 </pre></div>
@@ -626,9 +644,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/distribution_functions.html b/docs/build/html/_modules/binarycpython/utils/distribution_functions.html
index ea5e18686..851e9eb7c 100644
--- a/docs/build/html/_modules/binarycpython/utils/distribution_functions.html
+++ b/docs/build/html/_modules/binarycpython/utils/distribution_functions.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -2482,9 +2482,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/functions.html b/docs/build/html/_modules/binarycpython/utils/functions.html
index 1e2d750e9..dea1362a7 100644
--- a/docs/build/html/_modules/binarycpython/utils/functions.html
+++ b/docs/build/html/_modules/binarycpython/utils/functions.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -2153,9 +2153,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/grid.html b/docs/build/html/_modules/binarycpython/utils/grid.html
index c6fdf1d6e..e3499d472 100644
--- a/docs/build/html/_modules/binarycpython/utils/grid.html
+++ b/docs/build/html/_modules/binarycpython/utils/grid.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -205,6 +205,8 @@
     <span class="n">grid_options_defaults_dict</span><span class="p">,</span>
     <span class="n">moe_di_stefano_default_options</span><span class="p">,</span>
     <span class="n">_MS_VERBOSITY_LEVEL</span><span class="p">,</span>
+    <span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="p">,</span>
+    <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">,</span>
 <span class="p">)</span>
 
 <span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="p">(</span>
@@ -387,13 +389,16 @@
 
             <span class="c1"># The of the keys go into a custom_options dict</span>
             <span class="k">else</span><span class="p">:</span>
-                <span class="nb">print</span><span class="p">(</span>
-                    <span class="s2">&quot;!! Key doesnt match previously known parameter: </span><span class="se">\</span>
-<span class="s2">                    adding: </span><span class="si">{}</span><span class="s2">=</span><span class="si">{}</span><span class="s2"> to custom_options&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+                <span class="n">verbose_print</span><span class="p">(</span>
+                    <span class="s2">&quot;&lt;&lt;&lt;&lt; Warning: Key does not match previously known parameter: </span><span class="se">\</span>
+<span class="s2">                    adding: </span><span class="si">{}</span><span class="s2">=</span><span class="si">{}</span><span class="s2"> to custom_options &gt;&gt;&gt;&gt;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
                         <span class="n">key</span><span class="p">,</span> <span class="n">kwargs</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-                    <span class="p">)</span>
+                    <span class="p">),</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
+                    <span class="mi">1</span><span class="p">,</span>
                 <span class="p">)</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">kwargs</span><span class="p">[</span><span class="n">key</span><span class="p">]</span></div>
+
 <div class="viewcode-block" id="Population.parse_cmdline"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.parse_cmdline">[docs]</a>    <span class="k">def</span> <span class="nf">parse_cmdline</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function to handle settings values via the command line.</span>
@@ -501,7 +506,7 @@
         <span class="n">argline</span> <span class="o">=</span> <span class="n">argline</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
         <span class="k">return</span> <span class="n">argline</span>
 
-<div class="viewcode-block" id="Population.last_grid_variable"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.last_grid_variable">[docs]</a>    <span class="k">def</span> <span class="nf">last_grid_variable</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">_last_grid_variable</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function that returns the last grid variable</span>
 <span class="sd">        (i.e. the one with the highest grid_variable_number)</span>
@@ -515,7 +520,8 @@
                 <span class="p">]</span>
                 <span class="o">==</span> <span class="n">number</span> <span class="o">-</span> <span class="mi">1</span>
             <span class="p">):</span>
-                <span class="k">return</span> <span class="n">grid_variable</span></div>
+                <span class="k">return</span> <span class="n">grid_variable</span>
+
 <div class="viewcode-block" id="Population.add_grid_variable"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.add_grid_variable">[docs]</a>    <span class="k">def</span> <span class="nf">add_grid_variable</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
@@ -652,21 +658,21 @@
 
         <span class="k">return</span> <span class="n">options</span></div>
 
-    <span class="k">def</span> <span class="nf">_return_binary_c_version_info</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parsed</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+<div class="viewcode-block" id="Population.return_binary_c_version_info"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.return_binary_c_version_info">[docs]</a>    <span class="k">def</span> <span class="nf">return_binary_c_version_info</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parsed</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function that returns the version information of binary_c</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
         <span class="n">version_info</span> <span class="o">=</span> <span class="n">return_binary_c_version_info</span><span class="p">(</span><span class="n">parsed</span><span class="o">=</span><span class="n">parsed</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="n">version_info</span>
+        <span class="k">return</span> <span class="n">version_info</span></div>
 
-    <span class="k">def</span> <span class="nf">_return_binary_c_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<div class="viewcode-block" id="Population.return_binary_c_defaults"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.return_binary_c_defaults">[docs]</a>    <span class="k">def</span> <span class="nf">return_binary_c_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function that returns the defaults of the binary_c version that is used.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span>
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span></div>
 
 <div class="viewcode-block" id="Population.return_all_info"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.return_all_info">[docs]</a>    <span class="k">def</span> <span class="nf">return_all_info</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
@@ -705,7 +711,7 @@
 
         <span class="c1">#</span>
         <span class="k">if</span> <span class="n">include_binary_c_defaults</span><span class="p">:</span>
-            <span class="n">binary_c_defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_return_binary_c_defaults</span><span class="p">()</span>
+            <span class="n">binary_c_defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">return_binary_c_defaults</span><span class="p">()</span>
             <span class="n">all_info</span><span class="p">[</span><span class="s2">&quot;binary_c_defaults&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">binary_c_defaults</span>
 
         <span class="k">if</span> <span class="n">include_binary_c_version_info</span><span class="p">:</span>
@@ -835,7 +841,7 @@
             <span class="c1"># Generate entire shared lib code around logging lines</span>
             <span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;C_logging_code&quot;</span><span class="p">],</span>
-                <span class="n">verbose</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
+                <span class="n">verbosity</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span><span class="o">-</span><span class="p">(</span><span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="o">-</span><span class="mi">1</span><span class="p">),</span>
             <span class="p">)</span>
 
             <span class="c1"># Load memory address</span>
@@ -844,7 +850,7 @@
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;_custom_logging_shared_library_file&quot;</span><span class="p">],</span>
             <span class="p">)</span> <span class="o">=</span> <span class="n">create_and_load_logging_function</span><span class="p">(</span>
                 <span class="n">custom_logging_code</span><span class="p">,</span>
-                <span class="n">verbose</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
+                <span class="n">verbosity</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span><span class="o">-</span><span class="p">(</span><span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="o">-</span><span class="mi">1</span><span class="p">),</span>
                 <span class="n">custom_tmp_dir</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;tmp_dir&quot;</span><span class="p">],</span>
             <span class="p">)</span>
 
@@ -852,12 +858,12 @@
             <span class="c1"># Generate real logging code</span>
             <span class="n">logging_line</span> <span class="o">=</span> <span class="n">autogen_C_logging_code</span><span class="p">(</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;C_auto_logging&quot;</span><span class="p">],</span>
-                <span class="n">verbose</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
+                <span class="n">verbosity</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span><span class="o">-</span><span class="p">(</span><span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="o">-</span><span class="mi">1</span><span class="p">),</span>
             <span class="p">)</span>
 
             <span class="c1"># Generate entire shared lib code around logging lines</span>
             <span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span>
-                <span class="n">logging_line</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span>
+                <span class="n">logging_line</span><span class="p">,</span> <span class="n">verbosity</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span><span class="o">-</span><span class="p">(</span><span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
             <span class="p">)</span>
 
             <span class="c1"># Load memory address</span>
@@ -866,9 +872,10 @@
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;_custom_logging_shared_library_file&quot;</span><span class="p">],</span>
             <span class="p">)</span> <span class="o">=</span> <span class="n">create_and_load_logging_function</span><span class="p">(</span>
                 <span class="n">custom_logging_code</span><span class="p">,</span>
-                <span class="n">verbose</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
+                <span class="n">verbosity</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">]</span><span class="o">-</span><span class="p">(</span><span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span><span class="o">-</span><span class="mi">1</span><span class="p">),</span>
                 <span class="n">custom_tmp_dir</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;tmp_dir&quot;</span><span class="p">],</span>
             <span class="p">)</span>
+
     <span class="c1">###################################################</span>
     <span class="c1"># Ensemble functions</span>
     <span class="c1">###################################################</span>
@@ -918,7 +925,7 @@
             <span class="bp">self</span><span class="o">.</span><span class="n">_condor_grid</span><span class="p">()</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="c1"># Execute population evolution subroutines</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">evolve_population</span><span class="p">()</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">_evolve_population</span><span class="p">()</span>
 
         <span class="c1"># Put all interesting stuff in a variable and output that afterwards, as analytics of the run.</span>
         <span class="n">analytics_dict</span> <span class="o">=</span> <span class="p">{</span>
@@ -949,7 +956,7 @@
 
         <span class="k">return</span> <span class="n">analytics_dict</span></div>
 
-<div class="viewcode-block" id="Population.evolve_population"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.evolve_population">[docs]</a>    <span class="k">def</span> <span class="nf">evolve_population</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">_evolve_population</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function to evolve populations. This handles the setting up, evolving</span>
 <span class="sd">        and cleaning up of a population of stars.</span>
@@ -1038,9 +1045,9 @@
                 <span class="s2">&quot;There were no errors found in this run.&quot;</span><span class="p">,</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
                 <span class="mi">0</span><span class="p">,</span>
-            <span class="p">)</span></div>
+            <span class="p">)</span>
 
-<div class="viewcode-block" id="Population.get_stream_logger"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.get_stream_logger">[docs]</a>    <span class="k">def</span> <span class="nf">get_stream_logger</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">_get_stream_logger</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;Return logger with configured StreamHandler.&quot;&quot;&quot;</span>
         <span class="n">stream_logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="s2">&quot;stream_logger&quot;</span><span class="p">)</span>
         <span class="n">stream_logger</span><span class="o">.</span><span class="n">handlers</span> <span class="o">=</span> <span class="p">[]</span>
@@ -1052,9 +1059,9 @@
         <span class="n">sh</span><span class="o">.</span><span class="n">setFormatter</span><span class="p">(</span><span class="n">formatter</span><span class="p">)</span>
         <span class="n">stream_logger</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">sh</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="n">stream_logger</span></div>
+        <span class="k">return</span> <span class="n">stream_logger</span>
 
-<div class="viewcode-block" id="Population.system_queue_filler"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.system_queue_filler">[docs]</a>    <span class="k">def</span> <span class="nf">system_queue_filler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">job_queue</span><span class="p">,</span> <span class="n">amt_cores</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">_system_queue_filler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">job_queue</span><span class="p">,</span> <span class="n">amt_cores</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function that is responsible for keeping the queue filled.</span>
 
@@ -1062,8 +1069,9 @@
 <span class="sd">        Will have to play with the size of this.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="n">stream_logger</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_stream_logger</span><span class="p">()</span>
-        <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;setting up the system_queue_filler now&quot;</span><span class="p">)</span>
+        <span class="n">stream_logger</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_stream_logger</span><span class="p">()</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">:</span>
+            <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;setting up the system_queue_filler now&quot;</span><span class="p">)</span>
 
         <span class="c1"># Setup of the generator</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_generate_grid_code</span><span class="p">(</span><span class="n">dry_run</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
@@ -1079,7 +1087,6 @@
             <span class="n">job_queue</span><span class="o">.</span><span class="n">put</span><span class="p">((</span><span class="n">system_number</span><span class="p">,</span> <span class="n">system_dict</span><span class="p">))</span>
 
             <span class="c1"># Print some info</span>
-            <span class="c1"># stream_logger.debug(f&quot;producing: {system_number}&quot;)  # DEBUG</span>
             <span class="n">verbose_print</span><span class="p">(</span>
                 <span class="s2">&quot;Queue produced system </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">system_number</span><span class="p">),</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
@@ -1101,9 +1108,11 @@
             <span class="c1">#     print(&quot;\tsystem_queue_filler: Size dir(self): {}&quot;.format(convert_bytes(bytes_size_self)))</span>
 
         <span class="c1"># Send closing signal to workers. When they receive this they will terminate</span>
-        <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Signaling stop to processes&quot;</span><span class="p">)</span>  <span class="c1"># DEBUG</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">:</span>
+            <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Signaling stop to processes&quot;</span><span class="p">)</span>  <span class="c1"># DEBUG</span>
+    
         <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">amt_cores</span><span class="p">):</span>
-            <span class="n">job_queue</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="s2">&quot;STOP&quot;</span><span class="p">)</span></div>
+            <span class="n">job_queue</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="s2">&quot;STOP&quot;</span><span class="p">)</span>
 
 <div class="viewcode-block" id="Population.format_ensemble_results"><a class="viewcode-back" href="../../../grid.html#binarycpython.utils.grid.Population.format_ensemble_results">[docs]</a>    <span class="k">def</span> <span class="nf">format_ensemble_results</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ensemble_dictionary</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
@@ -1176,7 +1185,7 @@
             <span class="n">p</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
 
         <span class="c1"># Set up the system_queue</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">system_queue_filler</span><span class="p">(</span><span class="n">job_queue</span><span class="p">,</span> <span class="n">amt_cores</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;amt_cores&quot;</span><span class="p">])</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">_system_queue_filler</span><span class="p">(</span><span class="n">job_queue</span><span class="p">,</span> <span class="n">amt_cores</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;amt_cores&quot;</span><span class="p">])</span>
 
         <span class="c1"># Join the processes</span>
         <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">processes</span><span class="p">:</span>
@@ -1246,6 +1255,7 @@
             <span class="s2">&quot;_total_probability_weighted_mass_run&quot;</span>
         <span class="p">]</span> <span class="o">=</span> <span class="n">combined_output_dict</span><span class="p">[</span><span class="s2">&quot;_total_probability_weighted_mass_run&quot;</span><span class="p">]</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;_zero_prob_stars_skipped&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">combined_output_dict</span><span class="p">[</span><span class="s1">&#39;_zero_prob_stars_skipped&#39;</span><span class="p">]</span>
+
     <span class="k">def</span> <span class="nf">_evolve_system_mp</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">full_system_dict</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Function that the multiprocessing evolution method calls to evolve a system</span>
@@ -1298,8 +1308,9 @@
             <span class="n">ID</span>  <span class="c1"># Store the ID as a object property again, lets see if that works.</span>
         <span class="p">)</span>
 
-        <span class="n">stream_logger</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_stream_logger</span><span class="p">()</span>
-        <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Setting up processor: process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="n">stream_logger</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_stream_logger</span><span class="p">()</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">:</span>
+            <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Setting up processor: process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
 
         <span class="c1"># Set the process names</span>
         <span class="n">name</span> <span class="o">=</span> <span class="s1">&#39;binarycpython population thread </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">ID</span><span class="p">)</span>
@@ -1328,7 +1339,7 @@
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;_store_memaddr&quot;</span><span class="p">],</span>
             <span class="p">),</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
-            <span class="mi">0</span><span class="p">,</span>
+            <span class="mi">1</span><span class="p">,</span>
         <span class="p">)</span>
 
         <span class="c1"># Set the ensemble memory address</span>
@@ -1345,7 +1356,7 @@
             <span class="n">verbose_print</span><span class="p">(</span>
                 <span class="s2">&quot;</span><span class="se">\t</span><span class="s2">Using persistent_data memaddr: </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">persistent_data_memaddr</span><span class="p">),</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
-                <span class="mi">0</span><span class="p">,</span>
+                <span class="mi">1</span><span class="p">,</span>
             <span class="p">)</span>
 
         <span class="c1"># Set up local variables</span>
@@ -1513,7 +1524,10 @@
             <span class="s2">&quot;w&quot;</span><span class="p">,</span>
         <span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
             <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s2">&quot;FINISHING&quot;</span><span class="p">)</span>
-        <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2"> is finishing.&quot;</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">:</span>
+            <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2"> is finishing.&quot;</span><span class="p">)</span>
+
 
         <span class="c1"># Handle ensemble output: is ensemble==1, then either directly write that data to a file, or combine everything into 1 file.</span>
         <span class="n">ensemble_json</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># Make sure it exists already</span>
@@ -1612,7 +1626,7 @@
 
             <span class="p">),</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
-            <span class="mi">0</span><span class="p">,</span>
+            <span class="mi">1</span><span class="p">,</span>
         <span class="p">)</span>
 
         <span class="c1"># Write summary</span>
@@ -1653,7 +1667,9 @@
             <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s2">&quot;FINISHED&quot;</span><span class="p">)</span>
 
         <span class="n">result_queue</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">output_dict</span><span class="p">)</span>
-        <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2"> is finished.&quot;</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="n">_LOGGER_VERBOSITY_LEVEL</span><span class="p">:</span>
+            <span class="n">stream_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Process-</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">process_ID</span><span class="si">}</span><span class="s2"> is finished.&quot;</span><span class="p">)</span>
 
         <span class="c1"># Clean up the interpolators if they exist</span>
 
@@ -3160,6 +3176,9 @@
 <span class="sd">            output_dir: (optional, default = None) directory where to write the file to. If custom_options[&#39;data_dir&#39;] is present, then that one will be used first, and then the output_dir</span>
 <span class="sd">            output_filename: (optional, default = None) filename of the output. If not set it will be called &quot;binary_c_calls.txt&quot;</span>
 <span class="sd">            include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            filename: filename that was used to write the calls to</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
         <span class="c1"># Check if there is no compiled grid yet. If not, lets try to build it first.</span>
@@ -3232,7 +3251,11 @@
                     <span class="n">file</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">binary_cmdline_string</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Error. No grid function found!&quot;</span><span class="p">)</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span></div>
+            <span class="k">raise</span> <span class="ne">ValueError</span>
+
+
+        <span class="k">return</span> <span class="n">binary_c_calls_full_filename</span></div>
+
 
     <span class="k">def</span> <span class="nf">_cleanup_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
@@ -3248,7 +3271,7 @@
 <span class="sd">        TODO: Rethink this functionality. seems a bit double, could also be just outside of the class</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="n">binary_c_defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_return_binary_c_defaults</span><span class="p">()</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
+        <span class="n">binary_c_defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">return_binary_c_defaults</span><span class="p">()</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
         <span class="n">cleaned_dict</span> <span class="o">=</span> <span class="n">filter_arg_dict</span><span class="p">(</span><span class="n">binary_c_defaults</span><span class="p">)</span>
 
         <span class="k">return</span> <span class="n">cleaned_dict</span>
@@ -4046,15 +4069,10 @@
         <span class="p">)</span>
 
         <span class="c1"># and finally the probability calculator</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;_grid_variables&quot;</span><span class="p">][</span><span class="bp">self</span><span class="o">.</span><span class="n">last_grid_variable</span><span class="p">()][</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;_grid_variables&quot;</span><span class="p">][</span><span class="bp">self</span><span class="o">.</span><span class="n">_last_grid_variable</span><span class="p">()][</span>
             <span class="s2">&quot;probdist&quot;</span>
         <span class="p">]</span> <span class="o">=</span> <span class="n">probdist_addition</span>
 
-        <span class="c1"># Add the options to the grid</span>
-        <span class="c1"># self.grid_options[&quot;_grid_variables&quot;][self.last_grid_variable()][</span>
-        <span class="c1">#     &quot;precode&quot;</span>
-        <span class="c1"># ] += &quot;; self.grid_options[&#39;m&amp;s_ensemble_options&#39;] = {}&quot;.format(o)</span>
-
         <span class="n">verbose_print</span><span class="p">(</span>
             <span class="s2">&quot;</span><span class="se">\t</span><span class="s2">Moe_di_Stefano_2017: Added final call to the pdf function&quot;</span><span class="p">,</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s2">&quot;verbosity&quot;</span><span class="p">],</span>
@@ -4221,9 +4239,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/grid_options_defaults.html b/docs/build/html/_modules/binarycpython/utils/grid_options_defaults.html
index 3349af953..eaf338168 100644
--- a/docs/build/html/_modules/binarycpython/utils/grid_options_defaults.html
+++ b/docs/build/html/_modules/binarycpython/utils/grid_options_defaults.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -176,6 +176,8 @@
 <span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">temp_dir</span>
 <span class="kn">from</span> <span class="nn">binarycpython.utils.functions</span> <span class="kn">import</span> <span class="n">return_binary_c_version_info</span>
 
+<span class="n">_LOGGER_VERBOSITY_LEVEL</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">_CUSTOM_LOGGING_VERBOSITY_LEVEL</span> <span class="o">=</span> <span class="mi">2</span>
 <span class="n">_MS_VERBOSITY_LEVEL</span> <span class="o">=</span> <span class="mi">5</span>
 <span class="n">_MS_VERBOSITY_INTERPOLATOR_LEVEL</span> <span class="o">=</span> <span class="mi">6</span>
 <span class="n">_MS_VERBOSITY_INTERPOLATOR_EXTRA_LEVEL</span> <span class="o">=</span> <span class="mi">7</span>
@@ -1005,9 +1007,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/plot_functions.html b/docs/build/html/_modules/binarycpython/utils/plot_functions.html
index 390e89bdd..c0bd299b7 100644
--- a/docs/build/html/_modules/binarycpython/utils/plot_functions.html
+++ b/docs/build/html/_modules/binarycpython/utils/plot_functions.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -829,9 +829,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/run_system_wrapper.html b/docs/build/html/_modules/binarycpython/utils/run_system_wrapper.html
index cfa05a03b..52de49e39 100644
--- a/docs/build/html/_modules/binarycpython/utils/run_system_wrapper.html
+++ b/docs/build/html/_modules/binarycpython/utils/run_system_wrapper.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -287,9 +287,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/spacing_functions.html b/docs/build/html/_modules/binarycpython/utils/spacing_functions.html
index 06d3820d3..ae925983e 100644
--- a/docs/build/html/_modules/binarycpython/utils/spacing_functions.html
+++ b/docs/build/html/_modules/binarycpython/utils/spacing_functions.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -209,9 +209,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/binarycpython/utils/useful_funcs.html b/docs/build/html/_modules/binarycpython/utils/useful_funcs.html
index 8ba8b4426..f7eda3033 100644
--- a/docs/build/html/_modules/binarycpython/utils/useful_funcs.html
+++ b/docs/build/html/_modules/binarycpython/utils/useful_funcs.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../../../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -566,9 +566,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_modules/index.html b/docs/build/html/_modules/index.html
index 1ed7f7d1c..a432647e0 100644
--- a/docs/build/html/_modules/index.html
+++ b/docs/build/html/_modules/index.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="../readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -189,9 +189,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/_sources/binary_c_parameters.rst.txt b/docs/build/html/_sources/binary_c_parameters.rst.txt
index 0c1a4dd88..96a16995f 100644
--- a/docs/build/html/_sources/binary_c_parameters.rst.txt
+++ b/docs/build/html/_sources/binary_c_parameters.rst.txt
@@ -4,7 +4,7 @@ The following chapter contains all the parameters that the current version of bi
 
 
 This information was obtained by the following binary_c build:
-	**binary_c git branch**: branch_david	**binary_c git revision**: 6068:20210727:8955b541d	**Built on**: Jul 27 2021 22:36:46
+	**binary_c git branch**: branch_david	**binary_c git revision**: 6101:20210807:c5232be5c	**Built on**: Aug  7 2021 17:32:06
 
 
 Section: stars
diff --git a/docs/build/html/_sources/example_notebooks.rst.txt b/docs/build/html/_sources/example_notebooks.rst.txt
new file mode 100644
index 000000000..7e2eef403
--- /dev/null
+++ b/docs/build/html/_sources/example_notebooks.rst.txt
@@ -0,0 +1,15 @@
+Example notebooks
+=================
+We have a set of notebooks that explain and show the usage of the binarycpython features. The notebooks are also stored in the examples/ directory in the `repository <https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/master/examples>`_
+
+The order of the notebooks below is more or less the recommended order to read.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Contents:
+    
+    notebook_individual_systems.ipynb
+    notebook_custom_logging.ipynb
+    notebook_population.ipynb
+    notebook_extra_features.ipynb
+    notebook_api_functionality.ipynb
\ No newline at end of file
diff --git a/docs/build/html/_sources/examples.rst.txt b/docs/build/html/_sources/examples.rst.txt
deleted file mode 100644
index 16e4dc3a0..000000000
--- a/docs/build/html/_sources/examples.rst.txt
+++ /dev/null
@@ -1,10 +0,0 @@
-Examples
-========
-This chapter contains the source code of example scripts which show the way of using certain functions
-
-.. toctree::                                                                    
-   :hidden:                                                                     
-
-   general_examples
-   population_example
-   notebooks
\ No newline at end of file
diff --git a/docs/build/html/_sources/general_examples.rst.txt b/docs/build/html/_sources/general_examples.rst.txt
deleted file mode 100644
index 8509de5b7..000000000
--- a/docs/build/html/_sources/general_examples.rst.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-Examples
-========
-The source code of the general examples.
-
-.. literalinclude:: ../../examples/examples.py
-    :language: python
-    :linenos:
\ No newline at end of file
diff --git a/docs/build/html/_sources/index.rst.txt b/docs/build/html/_sources/index.rst.txt
index b07d6ec3c..dd3e4bb0c 100644
--- a/docs/build/html/_sources/index.rst.txt
+++ b/docs/build/html/_sources/index.rst.txt
@@ -14,7 +14,7 @@ Welcome to binary_c-python's documentation!
 
    readme_link
    modules
-   examples
+   example_notebooks
    binary_c_parameters
    grid_options_descriptions
    Visit the GitLab repo <https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python>
diff --git a/docs/build/html/_sources/notebook_api_functionality.ipynb.txt b/docs/build/html/_sources/notebook_api_functionality.ipynb.txt
new file mode 100644
index 000000000..d81c31711
--- /dev/null
+++ b/docs/build/html/_sources/notebook_api_functionality.ipynb.txt
@@ -0,0 +1,951 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "cb9d00f5-9613-471e-a4bb-6181311bf73b",
+   "metadata": {},
+   "source": [
+    "# Using the API functionality of binarycpython\n",
+    "This notebook shows how to use the API functions that interface with binary_c. It usually is better to use wrapper functions that internally use these API functions, because most of the output here is very raw\n",
+    "\n",
+    "Binarycpython uses the Python-C extension framework to interface Python with C. The sourcecode for this is contained in `src/binary_c_python.c`, and the functions are available via `from binarycpython import _binary_c_bindings`.\n",
+    "\n",
+    "The following functions are available through the API: (run cell below)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "ded7eaf6-e1ba-46c2-9f6f-9ebcb14a264d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on module binarycpython._binary_c_bindings in binarycpython:\n",
+      "\n",
+      "NAME\n",
+      "    binarycpython._binary_c_bindings - Module to interface the Binary_c API with python.\n",
+      "\n",
+      "FUNCTIONS\n",
+      "    free_persistent_data_memaddr_and_return_json_output(...)\n",
+      "        Frees the persistent_data memory and returns the json output\n",
+      "    \n",
+      "    free_store_memaddr(...)\n",
+      "        Frees the store memaddr\n",
+      "    \n",
+      "    return_arglines(...)\n",
+      "        Return the default args for a binary_c system\n",
+      "    \n",
+      "    return_help(...)\n",
+      "        Return the help info for a given parameter\n",
+      "    \n",
+      "    return_help_all(...)\n",
+      "        Return an overview of all the parameters, their description, categorized in sections\n",
+      "    \n",
+      "    return_maximum_mass_ratio_for_RLOF(...)\n",
+      "        Returns a string containing the maximum mass ratio for which a binary system does not RLOF at zams. Optionally accepts a store_capsule. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_minimum_orbit_for_RLOF(...)\n",
+      "        Returns a string containing the minimum orbit and separation for which a binary system does not RLOF at zams. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_persistent_data_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_store_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_version_info(...)\n",
+      "        Return the version information of the used binary_c build\n",
+      "    \n",
+      "    run_system(...)\n",
+      "        Function to run a system. This is a general function that will be able to handle different kinds of situations: single system run with different settings, population run with different settings, etc. To avoid having too many functions doing slightly different things. \n",
+      "        \n",
+      "        Arguments:\n",
+      "                argstring: argument string for binary_c\n",
+      "                (opt) custom_logging_func_memaddr: memory address value for custom logging function. Default = -1 (None)\n",
+      "                (opt) store_memaddr: memory adress of the store. Default = -1 (None)\n",
+      "                (opt) write_logfile: Boolean (in int form) for whether to enable the writing of the log function. Default = 0\n",
+      "                (opt) population: Boolean (in int form) for whether this system is part of a population run. Default = 0.\n",
+      "    \n",
+      "    test_func(...)\n",
+      "        Function that contains random snippets. Do not expect this to remain available, or reliable. i.e. dont use it.\n",
+      "\n",
+      "FILE\n",
+      "    /home/david/.pyenv/versions/3.6.4/envs/dev-binarycpython3.6.4/lib/python3.6/site-packages/binarycpython/_binary_c_bindings.cpython-36m-x86_64-linux-gnu.so\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "help(_binary_c_bindings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7ddede71-ffaa-4b24-aece-e94128a60d7f",
+   "metadata": {},
+   "source": [
+    "There are three main categories of functions:\n",
+    "\n",
+    "- Functions to get information from binary_c: these can be used to evolve systems, and get utility information from binary_c.\n",
+    "    - run_system\n",
+    "    - return_minimum_orbit_for_RLOF\n",
+    "    - return_maximum_mass_ratio_for_RLOF\n",
+    "    - return_help\n",
+    "    - return_help_all\n",
+    "    - return_arglines\n",
+    "\n",
+    "- Memory creation functions: these can be used to have binary_c allocate memory which is used or written to by binary_c\n",
+    "    - return_persistent_data_memaddr\n",
+    "    - return_store_memaddr\n",
+    "\n",
+    "- Memory freeing functions: These can be used to free the allocated memory, and in the case of persistent memory it will also return the contents of the ensemble\n",
+    "    - free_persistent_data_memaddr_and_return_json_output\n",
+    "    - free_store_memaddr"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0dd3e115-1571-42f7-9ab9-cf7688fa28c1",
+   "metadata": {},
+   "source": [
+    "## Example usage:"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5015daa-35ab-4736-a04d-f3cbe661638c",
+   "metadata": {},
+   "source": [
+    "### Setting up, using and freeing store"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "10a74d5a-a3d5-4543-a5bc-20d1fe885bb4",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<capsule object \"STORE\" at 0x7f163859d0c0>\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# allocating store memory\n",
+    "store_memaddr = _binary_c_bindings.return_store_memaddr()\n",
+    "print(store_memaddr)\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.run_system(argstring, store_memaddr=store_memaddr)\n",
+    "print(output)\n",
+    "\n",
+    "# Freeing store\n",
+    "_binary_c_bindings.free_store_memaddr(store_memaddr)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e9da5fc6-e680-483c-982e-4819767ed5b2",
+   "metadata": {},
+   "source": [
+    "### Getting information from binary_c"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "24f7ffe5-0076-459d-a37f-254e10d0d9f9",
+   "metadata": {},
+   "source": [
+    "We can get information for a parameter via return_help(parameter_name):\n",
+    "This will return an unparsed output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "318874f6-7acf-49bb-9786-299d4dffc0b3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "binary_c help for variable : M_1 <Float>\n",
+      "\n",
+      "The initial mass of star one (in solar units, internally this is star index 0).\n",
+      "\n",
+      "Default : 0\n",
+      "\n",
+      "\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help('M_1'))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f7fafce6-a522-43ac-a0c2-15a3db393b49",
+   "metadata": {},
+   "source": [
+    "We can get information on all available parameters via return_help(parameter_name):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "d7e757ae-579c-42a2-a310-f0401b7800e8",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "############################################################\n",
+      "##### Section Stars\n",
+      "############################################################\n",
+      "metallicity : This sets the metallicity of the stars, i.e. the amount (by mass) of matter which is not hydrogen or helium. If you are using the BSE algorithm, this must be 1e-4 <= metallicity <= 0.03. See also nucsyn_metallicity and effective_metallicity. : (null)\n",
+      "effective_metallicity : This sets effective metallicity of stars as used in routines like the Schneider wind loss. If not set, or set to DEFAULT_TO_METALLICITY (==-1, the default), this is just the same as metallicity. The main difference between effective_metallicity and metallicity is the range of validity: 0 <= effective_metallicity <= 1, while metallicity's range of validity is limited by the stellar evolution algorithm (so, for BSE, is 1e-4 <= metallicity <= 0.03). : (null)\n",
+      "M_1 : The initial mass of star one (in solar units, internally this is star index 0). : (null)\n",
+      "M_2 : The initial mass of star two (in solar units, internally this is star index 1). : (null)\n",
+      "M_3 : The initial mass of star three (in solar units, internally this is star index 2). : (null)\n",
+      "M_4 : The initial mass of star four (in solar units, internally this is star index 3). : (null)\n",
+      "vrot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot2,3,4. : (null)\n",
+      "vrot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,3,4. : (null)\n",
+      "vrot3 : The initial equatorial rotational velocity of star three (in km/s, internally this is star index 2). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,4. : (null)\n",
+      "vrot4 : The initial equatorial rotational velocity of star four (in km/s, internally this is star index 3). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,3. : (null)\n",
+      "Prot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). See also Prot2,3,4. : (null)\n",
+      "Prot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). See also Prot1,3,4. : (null)\n",
+      "Prot3 : The initial equatorial rotational period of star three (in days, internally this is star index 2). See also Prot1,2,4. : (null)\n",
+      "Prot4 : The initial equatorial rotational period of star four (in days, internally this is star index 3). See also Prot1,2,3. : (null)\n",
+      "inclination1 : The initial inclination of star one (in degrees). : (null)\n",
+      "inclination2 : The initial inclination of star two (in degrees). : (null)\n",
+      "inclination3 : The initial inclination of star three (in degrees). : (null)\n",
+      "inclination4 : The initial inclination of star four (in degrees). : (null)\n",
+      "B_1 : The initial magnetic field of star one (in Gauss, internally this is star index 0). : (null)\n",
+      "B_2 : The initial magnetic field of star two (in Gauss, internally this is star index 1). : (null)\n",
+      "B_3 : The initial magnetic field of star three (in Gauss, internally this is star index 2). : (null)\n",
+      "B_4 : The initial magnetic field of star four (in Gauss, internally this is star index 3). : (null)\n",
+      "B_inclination1 : The initial inclination of the magnetic field of star one (in degrees). : (null)\n",
+      "B_inclination2 : The initial inclination of the magnetic field of star two (in degrees). : (null)\n",
+      "B_inclination3 : The initial inclination of the magnetic field of star three (in degrees). : (null)\n",
+      "B_inclination4 : The initial inclination of the magnetic field of star four (in degrees). : (null)\n",
+      "stellar_type_1 : Set the stellar type of star 1 (internal index 0), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_2 : Set the stellar type of star 2 (internal index 1), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_3 : Set the stellar type of star 3 (internal index 2), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_4 : Set the stellar type of star 4 (internal index 3), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "max_stellar_type_1 : The maximum stellar type of star 1 (internal index 0). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value. \n",
+      " : (null)\n",
+      "max_stellar_type_2 : The maximum stellar type of star 2 (internal index 1). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_3 : The maximum stellar type of star 3 (internal index 2). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_4 : The maximum stellar type of star 4 (internal index 3). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "probability : The probability is a weighting applied to the star based on, say, the initial mass function. When running a grid of stars to simulate *all* stars, the summed probability of all the stars should be 1.0. : (null)\n",
+      "phasevol : The system's phase volume, used by binary_grid. : (null)\n",
+      "stellar_structure_algorithm : Set the stellar structure algorithm. 0=modified BSE (default), 1=none, 2=external function (must be defined by the calling code), 3=binary_c (not yet implemented). : (null)\n",
+      "solver : The type of solver. Default is the Forward-Euler (0), but could be RK2 (1), RK4 (2) or a predictor-corretor (3). : (null)\n",
+      "max_evolution_time : Set the maximum age for the stars (Myr). : (null)\n",
+      "max_model_number : Set the maximum number of models, ignored if 0 (default is 0). : (null)\n",
+      "monte_carlo_kicks : Turn on Monte-Carlo SN kicks. On (True) by default, and indeed other algorithms are probably broken. : (null)\n",
+      "disable_debug : Disables debug output. Only has an effect when DEBUG is 1, which probably requires a rebuild. Default FALSE. : (null)\n",
+      "timestep_logging : Turn on timestep logging (default is False). : (null)\n",
+      "rejects_in_log : Show timestep rejections in the main log (default is False). : (null)\n",
+      "vandenHeuvel_logging : Turn on van den Heuvel logging (default is False). : (null)\n",
+      "evolution_splitting : If True, turn on splitting of an evolutionary run if splitpoint (e.g. supernova) occurs. : (null)\n",
+      "disable_events : Whether to disable the new events code (defaults to False, so we use events by default)\n",
+      " : (null)\n",
+      "evolution_splitting_sn_eccentricity_threshold : Threshold eccentricity above which evolution splitting happens in a system with no SN kick. (0.01) : (null)\n",
+      "evolution_splitting_sn_n : Number of runs to split into when a SN occurs. : (null)\n",
+      "evolution_splitting_maxdepth : Max number of splits in an evolutionary run. : (null)\n",
+      "equation_of_state_algorithm : Set the equation of state algorithm. 0 = Paczynski. : (null)\n",
+      "opacity_algorithm : Set the opacity algorithm. 0 = Paczynski, 1 = Ferguson/Opal. : (null)\n",
+      "wind_mass_loss : Defines the algorithm used for stellar winds. 0 = none, 1 = Hurley et al. (2002), 2 = Schneider (2018). : 0\n",
+      "gbwind : Wind prescription for first red giant branch stars.  0=Reimers (Hurley et al 2000/2002; choose gb_reimers_eta=0.5 for their mass loss rate), 1=Schroeder+Cuntz 2005 (set gb_reimers_eta=1.0 for their mass loss rate). : (null)\n",
+      "mattsson_Orich_tpagbwind : Experimental : turns on Mattsson's TPAGB wind when the star is oxygen rich. Requires MATTSSON_MASS_LOSS. : (null)\n",
+      "magnetic_braking_factor : Multiplier for the magnetic braking angular momentum loss rate. : (null)\n",
+      "magnetic_braking_gamma : gamma factor in Rappaport style magnetic braking expression. : (null)\n",
+      "magnetic_braking_algorithm : Algorithm for the magnetic braking angular momentum loss rate. 0 = Hurley et al. 2002, 1 = Andronov, Pinnsonneault and Sills 2003, 2 = Barnes and Kim 2010  : (null)\n",
+      "helium_flash_mass_loss : Mass to be lost at the helium flash. : (null)\n",
+      "gb_reimers_eta : First red giant branch wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) : (null)\n",
+      "gbwindfac : Multiplier for the giant branch wind mass loss rate : (null)\n",
+      "tpagbwindfac : Multiplier for the TPAGB wind mass loss rate : (null)\n",
+      "eagbwindfac : Multiplier for the EAGB wind mass loss rate : (null)\n",
+      "nieuwenhuijzen_windfac : Multiplier for the Nieuwenhuijzen & de Jager wind mass loss rate : (null)\n",
+      "tpagbwind : Wind prescription during the TPAGB. 0=Karakas 2002 (a modified Vassiliadis and Wood 1993), 1=Hurley et al 2000/2002 (Vassiliadis and Wood 1993), 2=Reimers, 3=Bloecker, 4=Van Loon,  5=Rob's C-wind (broken?), 6,7=Vassiliadis and Wood 1993 (Karakas,Hurley variants respectively) when C/O>1, 8=Mattsson, 9 = Goldman et al. (2017), 10 = Beasor et al. (2020). : (null)\n",
+      "eagbwind : Wind prescription during the EAGB. 0=BSE (Hurley+2002, based on VW93), 1 = Goldman et al. (2017), 2 = Beasor et al. (2020). : (null)\n",
+      "wind_gas_to_dust_ratio : Gas to dust ratio used in wind calculations (e.g. Goldman et al. 2017). Typically 200 (Milky Way)-500 (Magellanic Clouds). Default is 200, approximately as in MW stars. : (null)\n",
+      "vwind_multiplier : Multiplier for the stellar wind velocity. : (null)\n",
+      "vwind_beta : Beta for stellar wind speed calculations, where vwind=sqrt(beta) * escape velocity. Default 0.125 (from BSE, Hurley et al. 2002).  : (null)\n",
+      "superwind_mira_switchon : In the Vassiliadis and Wood (1993) AGB wind prescription, the superwind is turned on at a given Mira period, usually 500 days. You can vary when this switch-on happens with this parameter. : (null)\n",
+      "vw93_mira_shift : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate depends on the Mira period plus this offset. Requires VW93_MIRA_SHIFT. : (null)\n",
+      "vw93_multiplier : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate is multiplied by this factor. Requires VW93_MULTIPLIER. : (null)\n",
+      "tpagb_reimers_eta : TPAGB Reimers wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) Note that Reimers is not the default TPAGB wind prescription. See also tpagbwind. : (null)\n",
+      "artificial_mass_accretion_rate%d : Constant mass accretion rate for star <n>. : (null)\n",
+      "artificial_angular_momentum_accretion_rate%d : Constant angular momentum accretion for star <n>. : (null)\n",
+      "artificial_orbital_angular_momentum_accretion_rate : Constant angular momentum accretion rate on the orbit. : (null)\n",
+      "artificial_accretion_start_time : Time at which artificial accretion stars. Ignored if <0 (default is -1). : (null)\n",
+      "artificial_accretion_end_time : Time at which artificial accretion ends. Ignored if <0 (default is -1). : (null)\n",
+      "wr_wind : Massive-star (WR) wind prescription. 0 = Hurley et al 2000/2002, 1=Maeder and Meynet, 2=Nugis and Lamers, 3=John Eldridge's version of Vink's early-2000s wind (See Lynnette Dray's thesis, or John Eldridge's thesis) : (null)\n",
+      "wr_wind_fac : Massive-star (WR) wind multiplication factor. : (null)\n",
+      "wrwindfac : Massive-star (WR) wind multiplication factor. Synonymous with wr_wind_fac (which you should use instead). : (null)\n",
+      "BH_prescription : Black hole mass prescrition: relates the mass of a newly formed black hole to its progenitor's (CO) core mass. 0=Hurley et al 2000/2002, 1=Belczynski (early 2000s). : (null)\n",
+      "PPISN_prescription : (Pulsational) Pair-Instability Supernova prescription: Relates initial helium core mass of star to whether the star undergoes PPISN or PISN. Requires PPISN flag to be True (see binary_c_parameters.h). 0=no ppisn, 1=Farmer et al 2019. : Ignore\n",
+      "sn_kick_distribution_II : Set the distribution of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_ECAP : Set the distribution of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_NS_NS : Set the distribution of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IBC : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_GRB_COLLAPSAR : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_TZ : Set the distribution of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_AIC_BH : Set the distribution of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_BH : Set the distribution of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_NS : Set the distribution of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD : Set the distribution of speeds applied to any survivor of a hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD_subluminous : Set the distribution of speeds applied to any survivor of a subluminous hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PPISN : Set the distribution of speeds applied to PPISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PISN : Set the distribution of speeds applied to PISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PHDIS : Set the distribution of speeds applied to PHDIS supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_II : Set the dispersion of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_ECAP : Set the dispersion of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_NS_NS : Set the dispersion of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IBC : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_GRB_COLLAPSAR : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_TZ : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_AIC_BH : Set the dispersion of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_BH : Set the dispersion of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_NS : Set the dispersion of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD : Set the dispersion of speeds applied to the survivor of a SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD_subluminous : Set the dispersion of speeds applied to the survivor of a subluminous SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PPISN : Set the dispersion of speeds applied to the survivor of a PPISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PISN : Set the dispersion of speeds applied to the survivor of a PISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PHDIS : Set the dispersion of speeds applied to the survivor of a PHDIS supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_companion_IA_He : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia He supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_ELD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia ELD (sub-Mch) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an accretion induced collapse (supernova) occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_ECAP : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an electron capture supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_He_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia helium merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_NS_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron-star neutron-star merger. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_GRB_COLLAPSAR : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a GRB Collapsar (rapidly rotating SN Ibc) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_HeStarIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a He-star Ia supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IBC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type Ib/c supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_II : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type II supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type IIa supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_WDKICK : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a WD is kicked. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_TZ : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Thorne-Zytkow object is formed. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron star collapses to a black hole. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when two black holes merge. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a black hole merges with a neutron star. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD_subluminous : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a subluminous hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PPISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PPISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PHDIS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PHDIS supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "wd_sigma : Set the speed at which white dwarfs are kicked when they form, in km/s. Default is zero (i.e. no kick). Requires WD_KICKS. : (null)\n",
+      "wd_kick_direction : Set the direction of white dwarf kicks. 0 = random, 1 = up, 2 = forward, 3 = backward, 4 = inward, 5 = outward. Requires WD_KICKS. : (null)\n",
+      "wd_kick_when : Decide when to kick a white dwarf. 0=at birth, 1=at first RLOF, 2=at given pulse number (see wd_kick_pulse_number), 3 at every pulse Requires WD_KICKS. : (null)\n",
+      "wd_kick_pulse_number : Apply a kick to a star at a desired pulse number on the TPAGB (i.e. pre-WD). Requires WD_KICKS. : (null)\n",
+      "minimum_helium_ignition_core_mass : Minimum helium core mass required to ignite helium in the case that the hydrogen envelope is stripped on the giant branch, e.g. to make an sdB or sdO star. Typically 0.4, if 0.0 then the BSE algorithm (based on the total mass) is used. : (null)\n",
+      "minimum_CO_core_mass_for_carbon_ignition : Minimum CO core mass for carbon ignition, assuming Mc,bagb>1.6Msun. Typically around 1.08Msun (Pols+1998). : (null)\n",
+      "minimum_CO_core_mass_for_neon_ignition : Minimum CO core mass for neon ignition. Typically around 1.42Msun. Stars that have cores that ignite carbon, but not neon explode in electon-capture supernovae. : (null)\n",
+      "minimum_mcbagb_for_nondegenerate_carbon_ignition : Minimum Mc,bagb (core mass at the base of the AGB) for non-degenerate carbon ignition. Typically around 2.25Msun (Pols+1998). : (null)\n",
+      "maximum_mcbagb_for_degenerate_carbon_ignition : Maximum Mc,bagb (core mass at the base of the AGB) for degenerate carbon ignition. Typically around 1.6Msun (Pols+1998). : (null)\n",
+      "max_neutron_star_mass : Maximum mass of a neutron star before it collapses to a black hole. Typically around 2Msun. : (null)\n",
+      "chandrasekhar_mass : The Chandrasekhar mass, usually 1.44Msun : (null)\n",
+      "delta_mcmin : A parameter to reduce the minimum core mass for third dredge up to occur on the TPAGB. As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "lambda_min : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. See also lambda_multiplier. : (null)\n",
+      "lambda_multiplier : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "minimum_envelope_mass_for_third_dredgeup : The minimum envelope mass for third dredge up on the TPAGB. Early, solar metallicity models by Straniero et al suggested 0.5Msun is typical. However, circumstantial evidence (Izzard et al 2009) as well as newer models by Stancliffe and Karakas suggest that at low metallicity a value nearer zero is more appropriate. : (null)\n",
+      "mass_of_pmz : The mass in the partial mixing zone of a TPAGB star, using the Karakas 2012 tables. Ask Carlo Abate for more details, or see the series of papers Abate et al 2012, 2013, 2014. Requires NUCSYN and USE_TABULAR_INTERSHELL_ABUNDANCES_KARAKAS_2012. : (null)\n",
+      "c13_eff : The \"efficiency\" of partial mixing in a TPAGB star intershell region, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "mc13_pocket_multiplier : Multiplies the mass in the partial mixing zone of a TPAGB star, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "tides_convective_damping : Tidal convective damping algorithm. 0=TIDES_HURLEY2002 Zahn 197x timescales + Hut, as in Hurley et al (2002), 1 = TIDES_ZAHN1989 : Zahn 1989 lambdas + Hut. : (null)\n",
+      "E2_prescription : Choose how to calculate the E2 structural parameter (used in tidal timescale calculations). 0=Hurley 1=Izzard (see Siess et al 2013). : (null)\n",
+      "dtfac : A parameter to decrease the timestep ONLY during the TPAGB phase. : (null)\n",
+      "hbbtfac : A parameter to modulate the temperature at the base of the hot-bottom burning zone in TPAGB stars. (Works only if NUCSYN is defined) : (null)\n",
+      "wind_multiplier_%d : Wind multiplier for the stellar type specified by the intger %d. By default these are all 1.0. : (null)\n",
+      "wind_type_multiplier_%d : Wind multiplier for different types of wind (MS, GB, AGB, WR, LBV, OTHER), given by the integer %d. By default these are all 1.0. : (null)\n",
+      "pre_main_sequence : Set to True to turn on pre-main sequence evolution. Currently this is not a special stellar type, rather the first (small) fraction of the main sequence has increased radii to match the Railton et al 2014 fits to Tout's pre-main sequence stars. Requires PRE_MAIN_SEQUENCE. See also pre_main_sequence_fit_lobes. : (null)\n",
+      "pre_main_sequence_fit_lobes : Set to True force a pre-main sequence star into its Roche lobe. This is done by artificially aging it. Requires PRE_MAIN_SEQUENCE : (null)\n",
+      "small_envelope_method : Choose the method used to determine the stellar radius when the envelope mass is very thin. 0 = Hurley et al. (2002), 1 = Miller Bertolami et al. (2016+) for GB and AGB stars only. : (null)\n",
+      "timestep_modulator : Multiplier applied to the global timestep. Requires TIMESTEP_MODULATION. : (null)\n",
+      "timestep_multiplier%d : Multiplier applied to timestep limit <n>. : (null)\n",
+      "maximum_timestep : The maximum timestep (MYr). : (null)\n",
+      "zoomfac_multiplier_decrease : When a timestep is rejected, decrease the timestep by this factor (0.5). : (null)\n",
+      "zoomfac_multiplier_increase : When a timestep is rejected, zooms, then succeeds, increase the timestep by this factor (1.2). : (null)\n",
+      "maximum_timestep_factor : The maximum factor between two subsequent timesteps (1.2). : (null)\n",
+      "maximum_nuclear_burning_timestep : The maximum timestep (MYr) in any nuclear burning phase. : (null)\n",
+      "nova_retention_method : Algorithm used to calculate the amount of mass retained during a nova explosion. 0=use nova_retention_fraction. (other methods pending) : (null)\n",
+      "MINT_metallicity : This sets the metallicity for MINT. It is ignored if set to -1.0, the default, in which case the normal metallicity parameter is used. : (null)\n",
+      "gaia_Teff_binwidth : log10(Effective temperature) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_L_binwidth : log10(luminosity) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_colour_transform_method : Use this to select the method used to transform to Gaia colours from other colour schemes. GAIA_CONVERSION_UBVRI_UNIVARIATE_JORDI2010 = 0 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_UBVRI_BIVARIATE_JORDI2010 = 1 Jordi et al.'s bivariate UBVRI fits, GAIA_CONVERSION_ugriz_UNIVARIATE_JORDI2010 = 2 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_ugriz_BIVARIATE_JORDI2010 = 3 Jordi et al.'s univariate ugriv fits, GAIA_CONVERSION_UBVRI_UNIVARIATE_EVANS2018 = 4 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_ugriz_UNIVARIATE_EVANS2018 = 5 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_UBVRI_RIELLO2020 = 6 Riello et al. (2020, DR3) fits, GAIA_CONVERSION_ugriz_RIELLO2020 = 7 Riello et al. (2020, DR3) fits. : (null)\n",
+      "rotationally_enhanced_mass_loss : Set to 1 to enable rotationally enhanced mass loss rate algorithms: 0= none, 1=formula cf. Langer models (=ROTATIONALLY_ENHANCED_MASSLOSS_LANGER_FORMULA), 2=limit accretion rate before wind loss is applied, 3 = both 1 and 2. See also rotationally_enhanced_exponent : (null)\n",
+      "AGB_core_algorithm : Algorithm to use for calculating AGB core masses. 0=Hurley et al. 2002 if no NUCSYN, Karakas 2002 if NUCSYN is defined; 1=Hurley et al. 2002 (overshooting models); 1=Karakas 2002 (non-overshooting models). : (null)\n",
+      "AGB_radius_algorithm : Algorithm to use for calculating radii on the TPAGB. : (null)\n",
+      "AGB_luminosity_algorithm : Algorithm to use for calculating luminosities on the TPAGB. : (null)\n",
+      "AGB_3dup_algorithm : Algorithm to use for calculating third dredge up efficiency on the TPAGB. : (null)\n",
+      "overspin_algorithm : Algorithm to determine what we do when a star is rotating at its breakup velocity. OVERSPIN_BSE (0) conservatively transfers the angular momentum back to the orbit. OVERSPIN_MASSLOSS uses the rotationally_enhanced_massloss parameter to lose mass which carries away the angular momentum. : (null)\n",
+      "rotationally_enhanced_exponent : The exponent (power) by which rotationally enhanced mass loss is raised. Requires ROTATIONALLY_ENHANCED_MASS_LOSS. See also rotationally_enhanced_mass_loss. : (null)\n",
+      "batchmode : Set the batchmode control variable. Use only if you know what you are doing! : (null)\n",
+      "speedtests : If True, turns on speedtests during version information (off by default). : (null)\n",
+      "use_fixed_timestep_%d : Set to True to use fixed timestep <n>, False to turn off. Fixed timesteps are on (this is True) by default. : (null)\n",
+      "task%d : Control tasks to be performed by binary_c. By default, these are all TRUE. For more information see binary_c_macros.h, particularly the BINARY_C_TASK_* macros. : (null)\n",
+      "orbiting_object : Usage: --orbiting_object mass,spinrate,central_object,period. : 1.0\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_wind_accretion_multiplier : Multiplier for wind accretion on orbiting objects. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "orbiting_objects_close_pc_threshold : How close are orbiting objects allowed to be? Set this to be the absolute percentage difference minimum. : (null)\n",
+      "orbiting_objects_tides_multiplier : Multiplier for tidal torques on orbiting objects. : (null)\n",
+      "evaporate_escaped_orbiting_objects : If True, evaporate orbiting objects that have escaped the system. : (null)\n",
+      "RLOF_transition_objects_escape : If True, objects that escape their Roche lobe are ejected from the system, otherwise they are placed just outside the minimum stable orbit. : (null)\n",
+      "PN_resolve : If True, the timestep will be shortened to resolve better the PN phase (FALSE). : (null)\n",
+      "PN_resolve_minimum_luminosity : The luminosity above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_maximum_envelope_mass : The envelope mass below which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_minimum_effective_temperature : The minimum effective temperature above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_fast_wind : If True, thin-envelope PNe will have fast winds (FALSE). : (null)\n",
+      "PN_fast_wind_dm_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_mdot_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_dm_AGB : The envelope mass below which fast wind used during the AGB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "PN_fast_wind_mdot_AGB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "HeWD_HeWD_ignition_mass : HeWD-HeWD mergers above this mass reignite helium. (0.3) : (null)\n",
+      "wind_Nieuwenhuijzen_luminosity_lower_limit : Above this luminosity we activate the Nieuwenhuijzen and de Jager wind (4e3 Lsun). : (null)\n",
+      "wind_LBV_luminosity_lower_limit : Above this luminosity we activate the LBV wind (6e5 Lsun). : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Binary\n",
+      "############################################################\n",
+      "separation : Set the orbital separation (actually the semi-major axis) of the binary (internal index 0, stellar indices 0 and 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_triple : Set the orbital separation (actually the semi-major axis) of the triple (internal index 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_quadruple : Set the orbital separation (actually the semi-major axis) of the quadruple (internal index 2) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "orbital_period : Set the initial orbital period of the binary, stars 1 and 2 (internal indices 0 and 1) in days. See also separation. : (null)\n",
+      "orbital_period_triple : Set the initial orbital period of the triple in days. See also separation. : (null)\n",
+      "orbital_period_quadruple : Set the orbital period of the outer binary in a quadrulple (stars 3 and 4, internal indices 2 and 3) in days. See also separation. : (null)\n",
+      "eccentricity : Set the initial eccentricity of the binary orbit (stars 1 and 2, internal indices 0 and 1). : (null)\n",
+      "eccentricity_triple : Set the initial eccentricity of the triple orbit. : (null)\n",
+      "eccentricity_quadruple : Set the initial eccentricity of the outer binary of a quadruple (stars 3 and 4, internal indices 2 and 3). : (null)\n",
+      "incliniation : Set the initial orbital_inclination of the binary relative to zero. : (null)\n",
+      "incliniation_triple : Set the initial orbital_inclination of the triple orbit relative to zero. : (null)\n",
+      "incliniation_quadruple : Set the initial orbital_inclinationy of the quadruple orbit relative to zero. : (null)\n",
+      "orbital_phase : Set the initial orbital phase of the binary orbit. : (null)\n",
+      "orbital_phase_triple : Set the initial orbital phase of the triple orbit. : (null)\n",
+      "orbital_phase_quadruple : Set the initial orbital phase of the quadruple orbit. : (null)\n",
+      "argument_of_periastron : Set the initial argument of periastron of the binary orbit. : (null)\n",
+      "argument_of_periastron_triple : Set the initial argument of periastron of the triple orbit. : (null)\n",
+      "argument_of_periastron_quadruple : Set the initial argument of periastron of the quadruple orbit. : (null)\n",
+      "disc_timestep_factor : Factor that multiplies the natural timestep of a disc. : (null)\n",
+      "white_dwarf_cooling_model : White dwarf cooling model, relates age to luminosity. WHITE_DWARF_COOLING_MESTEL = 0 is Mestel's model, WHITE_DWARF_COOLING_MESTEL_MODIFIED = 1 is Hurley's modified Mestel model, WHITE_DWARF_COOLING_CARRASCO2014 = 2 is based on Carrasco (2014) tables.   : (null)\n",
+      "white_dwarf_radius_model : White dwarf radius model, radius to mass (and perhaps age). WHITE_DWARF_RADIUS_NAUENBERG1972 = 0 Nauenberg (1972), WHITE_DWARF_RADIUS_MU = 1 mu-dependent variant, WHITE_DWARF_RADIUS_CARRASCO2014 = 2 is based on Carrasco (2014) tables. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_accretion_method : Chooses where the mass that is accreted from the inner edge of a circumbinary disc goes, i.e. to which star. 0 = Young and Clarke 2015, 1 = Gerosa et al 2015, 2 = 50:50 (i.e. not dependence on mass). : (null)\n",
+      "cbdisc_inner_edge_stripping : If True, allow inner edge mass stripping. : (null)\n",
+      "cbdisc_end_evolution_after_disc : If True, stop evolution when a disc evaporates. : (null)\n",
+      "cbdisc_no_wind_if_cbdisc : If True, disable stellar winds when there is a circumbinary disc. : (null)\n",
+      "cbdisc_outer_edge_stripping : If True, allow outer edge mass stripping. : (null)\n",
+      "disc_n_monte_carlo_guesses : Number of monte carlo guesses to try in the disc solver if the normal list of guesses fails (0). : (null)\n",
+      "disc_log : If 1, turn on the disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log2d : If 1, turn on the 2d disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log_dt : If non-zero, only allows disc log output every disc_log_dt Myr. : (null)\n",
+      "disc_log_directory : Directory into which disc logging is sent (must exist!). : /tmp/\n",
+      "post_ce_adaptive_menv : If TRUE, and if post_ce_objects_have_envelopes is TRUE, then the envelope mass of a post-CE star is such that it sits just inside its Roche lobe. If FALSE then a fixed (thin) envelope mass is applied that depends on the stellar type (see macros POST_CE_ENVELOPE_DM_GB, POST_CE_ENVELOPE_DM_EAGB and POST_CE_ENVELOPE_DM_TPAGB). : (null)\n",
+      "post_ce_objects_have_envelopes : If TRUE then post-common-envelope objects have thin envelopes. You need this if you are to have post-CE post-AGB stars. Note that this *may* be unstable, i.e. you may end up having many CEEs. The mass in the envelope is controlled by post_ce_adaptive_menv. TRUE by default. : (null)\n",
+      "PN_comenv_transition_time : post-common envelope transition time in years (1e2).  This is the time taken to move from CEE ejection to Teff > 30e4 K. Hall et al. (2013) suggest ~100 years. : (null)\n",
+      "minimum_time_between_PNe : The minimum time (Myr) between planetary nebula detections. This prevents multiple, fast common envelopes triggering two PNe (0.1). : (null)\n",
+      "PN_Hall_fading_time_algorithm : In stars with low mass (<0.45Msun) cores, you can choose to set the PN fading time to either the minimum (PN_HALL_FADING_TIME_ALGORITHM_MINIMUM) or maximum (PN_HALL_FADING_TIME_ALGORITHM_MAXIMUM) as shown in Fig. 6 of Hall et al. (2013). : (null)\n",
+      "PPN_envelope_mass : Desired pre-planetary nebula (post-AGB) envelope mass. : (null)\n",
+      "cbdisc_eccentricity_pumping_method : Select from various eccentricity-pumping methods when there is a circumbinary disc. Requires DISCS. 0 = off. : (null)\n",
+      "cbdisc_viscous_photoevaporative_coupling : Set to 1 to turn on viscous-photoevaporative coupling in circumbinary discs. Requires DISCS. 0 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_NONE = off, 1 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_INSTANT instant, 2 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_VISCOUS slow, viscous wind. : (null)\n",
+      "cbdisc_inner_edge_stripping_timescale : Defines the timescale for mass loss from by inner edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_in. : (null)\n",
+      "cbdisc_outer_edge_stripping_timescale : Defines the timescale for mass loss from by outer edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_out. : (null)\n",
+      "cbdisc_viscous_L2_coupling : Set to 1 to turn on viscous-L2-loss coupling in circumbinary discs. Requires DISCS. 0 = off. : (null)\n",
+      "gravitational_radiation_model : Model for gravitational radiation from the system. 0=Hurley et al 2002 (Landau and Lifshitz 1951). 1 = as 0 but only when there is no RLOF. 2 = none. : (null)\n",
+      "nova_irradiation_multiplier : Multiplier for nova-radiative induced mass loss. (Shara+1986) : (null)\n",
+      "gravitational_radiation_modulator_J : Modulator for gravitational wave radiation angular momentum loss rate (1.0). : (null)\n",
+      "gravitational_radiation_modulator_e : Modulator for gravitational wave radiation eccentricity pumping rate (1.0). : (null)\n",
+      "nova_faml_multiplier : Nova friction-induced angular momentum loss multiplier. (Shara+1986) : (null)\n",
+      "RLOF_angular_momentum_transfer_model : Choose angular momentum transfer model in RLOF. 0=BSE (with discs), 1=conservative : (null)\n",
+      "post_SN_orbit_method : Method by which the post-SN orbit is calculated. 0=BSE, 1=Tauris&Taken 1998. : (null)\n",
+      "multiplicity : Multiplicity: 1=single star, 2=binary, 3=triple, 4=quadruple. : (null)\n",
+      "accretion_limit_eddington_steady_multiplier : Steady accretion is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_steady_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_LMMS_multiplier : Accretion from a low-mass, convective, main_sequence star is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_LMMS_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_WD_to_remnant_multiplier : Accretion from a WD onto a remnant star (e.g. another white dwarf, neutron star or black hole) is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_WD_to_remnant_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_thermal_multiplier : Mass transfer onto a MS, HG or CHeB star is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "accretion_limit_dynamical_multiplier : Mass transfer is limited by the accretor's dynamical rate times this multiplier. : (null)\n",
+      "donor_limit_envelope_multiplier : Mass transfer by RLOF is limited by this fraction of the donor's envelope mass per timestep : (null)\n",
+      "donor_limit_thermal_multiplier : Mass transfer by RLOF is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "donor_limit_dynamical_multiplier : Mass transfer by RLOF is limited by the donor's dynamical rate times this multiplier. : (null)\n",
+      "Bondi_Hoyle_accretion_factor : Wind accretion rate, as calculated by the Bondi-Hoyle-Littleton formula, multiplcation factor. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "tidal_strength_factor : A modulator for the tidal strength. If this factor > 1 then tides are stronger, i.e. tidal timescales are reduced. : (null)\n",
+      "hachisu_qcrit : Critical q=Maccretor/Mdonor above which Hachisu's disk wind turns on. : (null)\n",
+      "hachisu_disk_wind : Set to True to turn on Hachisu's disk wind when material accretes too fast onto a white dwarf. This helps to make more SNeIa. See also hachisu_qcrit. : (null)\n",
+      "mass_accretion_for_eld : The mass that must be accreted onto a COWD for it to ignite as an edge-lit detonation SNIa. : (null)\n",
+      "WDWD_merger_algorithm : Algorithm to be used when merging two white dwarfs. 0 = Hurley et al. (2002), 1 = Perets+ (2019), 2 = Chen+ (2016, todo)  : (null)\n",
+      "type_Ia_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from Chandrasekhar-mass exploders. 0 = DD7 (Iwamoto 1999), 1 = Seitenzahl 2013 3D hydro yields (you must also set Seitenzahl2013_model)  : (null)\n",
+      "Seitenzahl2013_model : Which of Seitenzahl et al. 2013's models to use? One of N1,N3,N5,N10,N20,N40,N100L,N100,N100H,N150,N200,N300C,N1600,N1600C,N100_Z0.5,N100_Z0.1,N100_Z0.01 (defaults to N100). : N1\n",
+      "type_Ia_sub_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from sub-Chandrasekhar-mass exploders. (Currently unused.) : (null)\n",
+      "max_HeWD_mass : The maximum mass a HeWD can have before it ignites helium (0.7). : (null)\n",
+      "merger_mass_loss_fraction : Fraction of the total mass which is lost when stars merge. : (null)\n",
+      "merger_angular_momentum_factor : When two stars merge the resulting single star retains a fraction of the total system angular momentum (or the critical spin angular momentum, if it is smaller) multiplied by this factor. : (null)\n",
+      "wind_angular_momentum_loss : Prescription for losing angular momentum in a stellar wind. 0=Hurley et al 2002 ('Tout') prescription, 1=lw i.e. a factor multiplying the specific orbital angular momentum, 2=lw hybrid for fast winds. Set wind_djorb_fac to the desired factor.. : (null)\n",
+      "wind_djorb_fac : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=0 (the Tout/Hurley et al 2002 prescription). See wind_angular_momentum_loss. : (null)\n",
+      "lw : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=1,2 (the 'lw' prescription). See wind_angular_momentum_loss. : (null)\n",
+      "VW93_EAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "VW93_TPAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "use_periastron_Roche_radius : Set this to True to use the Roche lobe radius at periastron, rather than (the default to) assume a circular orbit. This will be useful one day when we treat RLOF in eccentric orbits properly, hopefully. : (null)\n",
+      "qcrit_LMMS : Apply critical q=Mdonor/Maccretor value for low-mass main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_LMMS : Apply critical q=Mdonor/Maccretor value for (low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "mass_for_Hestar_Ia_upper : Only helium stars below this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_lower. : (null)\n",
+      "mass_for_Hestar_Ia_lower : Only helium stars above this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_upper. : (null)\n",
+      "alphaCB : Circumbinary disk viscosity parameter, alpha. : (null)\n",
+      "minimum_donor_menv_for_comenv : Minimum donor envelope mass for common envelope evolution to be triggered (Msun). Default 0. : (null)\n",
+      "comenv_prescription : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_prescription%d : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_ejection_spin_method : When a common envelope is ejected, we need to decide how fast the stars are left spinning. COMENV_EJECTION_SPIN_METHOD_DO_NOTHING (0) is the default, this just leaves the stars/stellar cores spinning with the same spin rate (omega = angular velocity) with which they entered the common envelope phase. COMENV_EJECTION_SPIN_METHOD_SYCHRONIZE instead tidally synchronizes the stars with their new orbital angular velocity. : (null)\n",
+      "comenv_merger_spin_method : When a common envelope binary merges, we need to decide how fast the resulting single star is left spinning. COMENV_MERGER_SPIN_METHOD_SPECIFIC (0) is the default, this preserves angular momentum but limits the specific angular momentum of the merged star to the specific angular momentum of the system at the onset of common envelope evolution. COMENV_MERGER_SPIN_METHOD_CONSERVE_ANGMOM (1) sets the merger's angular momentum to be that of the system at the onset of common envelope evolution (which means the star may be rotating supercritically). COMENV_MERGER_SPIN_METHOD_CONSERVE_OMEGA (2) sets the spin rate (angular frequency = omega) of the merged star to be that of the orbit just at the onset of common envelope evolution. : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "comenv_ms_accretion_fraction : Experimental. During common envelope evolution, a main sequence may accrete a fraction of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_mass. : (null)\n",
+      "comenv_ns_accretion_mass : Experimental. During common envelope evolution, a neutron star may accrete some of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_fraction. : (null)\n",
+      "comenv_ns_accretion_fraction : Experimental. During common envelope evolution, a neutron star may accrete a fraction of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_mass. : (null)\n",
+      "alpha_ce : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "alpha_ce%d : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "lambda_ce : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "lambda_ce%d : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "comenv_splitmass : When lambda_ce=-2, the envelope binding energy, lambda, is calculated using a polytropic formalism. The comenv_splitmass defines the point, in the units of the core mass, above which material is ejected. : (null)\n",
+      "nelemans_recalc_eccentricity : If True, recalculate the eccentricity after angular momentum is removed.  : (null)\n",
+      "comenv_post_eccentricity : Eccentricity remaining after common envelope ejection. : (null)\n",
+      "nelemans_gamma : Set the fraction of the orbital specific angular momentum that is used to eject the common envelope according to the Nelemans and Tout prescription. See also nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_minq : Only activate the Nelemans and Tout common envelope prescription for q>nelemans_minq. See also nelemans_gamma, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_max_frac_j_change : Maximum fractional angular momentum change in the Nelemans and Tout common envelope prescription. See also nelemans_gamma, nelemans_minq, nelemans_n_comenvs. : (null)\n",
+      "nelemans_n_comenvs : Set the maximum number of common envelope ejections allowed to follow the Nelemans and Tout prescription, after which the standard alpha prescription is used. : (null)\n",
+      "lambda_ionisation : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_ionisation%d : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_enthalpy : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "lambda_enthalpy%d : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "cbdisc_albedo : Circumbinary-disc albedo. Requires DISCS. : (null)\n",
+      "cbdisc_gamma : Circumbinary disc gamma (equation of state) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_alpha : Circumbinary disc alpha (viscosity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_kappa : Circumbinary disc kappa (opacity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_evaporation_timescale : Circumbinary disc minimum evaporation timescale (years). If (slow, not edge stripped) mass loss would evaporate the disc on a timescale less than this, simply evaporate the disc immediated. Usually set to 1y, ignore if zero. Requires DISCS. : (null)\n",
+      "cbdisc_torquef : Circumbinary disc binary torque multiplier. Requires DISCS. : (null)\n",
+      "cbdisc_max_lifetime : Circumbinary disc maximum lifetime (years, ignored if 0). Requires DISCS. : (null)\n",
+      "cbdisc_init_dM : On cbdisc start, reduce mass by a fraction dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_init_dJdM : On cbdisc start, reduce angular momentum by a fraction dJ/dM*dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_constant_rate : Circumbinary disc constant mass loss rate (Msun/year). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_FUV_multiplier : Circumbinary disc FUV mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_Xray_multiplier : Circumbinary disc X-ray mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_ram_pressure_multiplier : Circumbinary disc interstellar medium ram pressure stripping mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_pressure : Circumbinary disc interstellar medium ram pressure in units of Boltzmann constant per Kelvin (I think...). Requires DISCS. Typically 3000.0. See e.g. http://www.astronomy.ohio-state.edu/~pogge/Ast871/Notes/Intro.pdf page 15 or https://arxiv.org/pdf/0902.0820.pdf Fig. 1 (left panel). : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_multiplier : Circumbinary disc inner edge viscous mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_angular_momentum_multiplier : Circumbinary disc inner edge viscous angular momentum multiplier (no units). The inner edge angular momentum Requires DISCS. : (null)\n",
+      "cbdisc_resonance_multiplier : Circumbinary disc resonant interaction multiplier, affects eccentricity pumping and angular momentum rates. Requires DISCS. : (null)\n",
+      "cbdisc_resonance_damping : Circumbinary disc resonant interaction damping: should be on (True) to damp the l=1, m=2 resonance when the disc inner edge lies outside the resonance location. Requires DISCS. : (null)\n",
+      "cbdisc_fail_ring_inside_separation : If True, while converging on a structure, circumbinary discs with Rring < the binary separation are immediately failed. : (null)\n",
+      "cbdisc_mass_loss_inner_L2_cross_multiplier : Circumbinary disc inner edge L2-crossing mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_minimum_luminosity : Circumbinary disc minimum luminosity. If the disc becomes dimmer than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_mass : Circumbinary disc minimum mass. If the disc becomes less massive than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_fRing : Circumbinary disc minimum fRing. If the disc becomes a ring, and fRing = |Rout/Rin-1| < this value (and this value is non-zero), the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "comenv_disc_angmom_fraction : If >0 Fraction of the common envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the moments of inertia to calculate (deprecated), if -2 use the common envelope's specific angular momentum, if -3 uses the L2 point at the end of the common envelope to set the angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "comenv_disc_mass_fraction : Fraction of the common envelope's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "wind_disc_angmom_fraction : If >0 Fraction of the wind envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the L2 point's specific angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "wind_disc_mass_fraction : Fraction of the stellar wind's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "WRLOF_method : Choose whether and how to apply wind-Roche-lobe-overflow. 0=none, 1=q-dependent, 2=quadratic See Abate et al 2013/14 for details. Requires WRLOF_MASS_TRANSFER. : (null)\n",
+      "minimum_timestep : The minimum timestep (Myr). : (null)\n",
+      "timestep_solver_factor : Factor applied in timestep_limits, e.g. to prevent X changing too fast by comparing to X/dX/dt, which is usually 1 but can be higher to lengthen timesteps when using an alternative solver. : (null)\n",
+      "RLOF_mdot_factor : Multiplier applied to the mass transfer rate during Roche-lobe overflow. Requires RLOF_MDOT_MODULATION. : (null)\n",
+      "RLOF_f : Factor to enlarge a Roche lobe, nominally because of radiation pressure (see Dermine et al paper). Requires RLOF_RADIATION_CORRECTION. : (null)\n",
+      "minimum_separation_for_instant_RLOF : If True, instead of evolving the system just report the minimum separation (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_orbital_period_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "minimum_orbital_period_for_instant_RLOF : If True, instead of evolving the system just report the minimum orbital period (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_separation_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "maximum_mass_ratio_for_instant_RLOF : If True, instead of evolving the system just report the maximum mass ratio (on the zero-age main sequence) that would lead to instant RLOF, given M1 and orbital period. Used by binary_grid. See also minimum_separation_for_instant_RLOF and minimum_orbital_period_for_instant_RLOF. : (null)\n",
+      "RLOF_method : Use RLOF_method to choose the algorithm you use for Roche-lobe overflow mass loss rate calculations. 0=Hurley et al 2002, 1=Adaptive (for radiative stars) R=RL method, 2=Ritter (probably broken), 3=Claeys etal 2014 variant on Hurley et al 2002. : (null)\n",
+      "RLOF_interpolation_method : When a star overflows its Roche lobe, it always has R>RL because of the limited time resolution of the simulation. Binary_c then uses an algorithm to get back to when R~RL (within a desired tolerance, set in RLOF_ENTRY_THRESHOLD which is usually 1.02, i.e. overflow of 2%). You can choose algorithm 0, the Hurley et al 2002 method which reverses time (i.e. uses a Newton-like scheme), or 1 to use the binary_c method which rejects a timestep (and hence does no logging on that timestep) and repeats with half the timestep until R~RL. The latter is now the default, because this means there are no negative timesteps which break various other algorithms (e.g. nucleosynthesis). : (null)\n",
+      "nova_retention_fraction : The mass accreted during a nova as fraction of mass transferred : (null)\n",
+      "beta_reverse_nova : The fraction of mass ejected in a nova explosion which is accreted back onto the companion star. Set to -1 to automatically calculate based on a geometric argument, or 0 or positive to set the value. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_hydrogen_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is hydrogen rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_helium_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_other_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is neither hydrogen nor helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a hydrogen-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_helium_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a helium-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_other_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope when the donor is neither hydrogen nor helium rich. Below this mass transfer leads to stable burning. : (null)\n",
+      "CRAP_parameter : Tidally enhanced mass loss parameter. See Tout and Eggleton's paper on the subject. (Was the parameter bb). : (null)\n",
+      "individual_novae : If individual_novae is True, novae are resolved such that each explosion is performed separtaely. : (null)\n",
+      "nova_timestep_accelerator_num : The nova timestep is accelerated if the nova number exceeds nova_timestep_accelerator_num. If zero or negative, acceleration is off. See also nova_timestep_accelerator_index and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_index : The index at which the nova timestep is accelerated. A larger value gives longer timesteps. See also nova_timestep_accelerator_num and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_max : The nova timestep is accelerated by a factor that is capped at nova_timestep_accelerator_max. This parameter is ignored if it is zero or negative. See also nova_timestep_accelerator_num and nova_timestep_accelerator_index. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nonconservative_angmom_gamma : Mass lost from the system (but NOT from a stellar wind) takes a fraction gamma of the orbital angular momentum with it. Set to -1 to take the specific angular momentum of the donor star. Set to -2 to take super-Eddington, nova and disk-wind angular momenta as if a wind from the accretor. : (null)\n",
+      "max_stellar_angmom_change : Maxmimum fractional change in stellar angular momentum allowed before a timestep is rejected (0.05). : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Nucsyn\n",
+      "############################################################\n",
+      "third_dup : If True, enables third dredge up. Requires NUCSYN and NUCSYN_THIRD_DREDGE_UP. : (null)\n",
+      "third_dup_multiplier : Usage: --third_dup_multiplier <i> <f>. Multiplies the abundance of element <i> by <f> during third dredge up. : 1.0\n",
+      "NeNaMgAl : Enables NeNaMgAl reaction network. Requires NUCSYN and NUCSYN_HBB. : Ignore\n",
+      "nucsyn_network%d : Usage: --nucsyn_network%d <boolean>. Turn a nuclear network on or off. : (null)\n",
+      "nucsyn_network_error%d : Usage: --nucsyn_network_error%d <f>. Threshold error in nuclear network solver for network %d. : (null)\n",
+      "nucreacmult%d : Usage: --nucreacmult%d <f>. Multiply nuclear reaction given by the integer %d (integer) by f (float).  : (null)\n",
+      "nucsyn_metallicity : This sets the metallicity of the nucleosynthesis algorithms, i.e. the amount (by mass) of matter which is not hydrogen or helium. Usually you'd just set this with the metallicity parameter, but if you want the nucleosynthesis to be outside the range of the stellar evolution algorithm (e.g. Z=0 or Z=0.04) then you need to use nucsyn_metallicity. That said, it's also outside the range of some of the nucleosynthesis algorithms as well, so you have been warned! : (null)\n",
+      "nucsyn_solver : Choose the solver used in nuclear burning. 0 = KAPS_RENTROP is a Kaps-Rentrop scheme (fast, not great for stiff problems), 1 = LSODA (Adams/BSF switcher), 2 = CVODE library (https://computing.llnl.gov/projects/sundials. Default 0.  : 0\n",
+      "initial_abundance_mix : initial abundance mixture: 0=AG89, 1=Karakas 2002, 2=Lodders 2003, 3=Asplund 2005 (not available?), 4=Garcia Berro, 5=Grevesse Noels 1993 : 0\n",
+      "init_abund : Usage: --init_abund <i> <X>. Sets the initial abundance of isotope number <i> to mass fraction <X>. : 0.02\n",
+      "init_abund_mult : Usage: --init_abund_mult <i> <f>. Multiplies the initial abundance of isotope number <i> by <f>. : 1.0\n",
+      "init_abund_dex : Usage: --init_abund_dex <i> <f>. Changes the initial abundance of isotope number <i> by <f> dex. : 0.0\n",
+      "init_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "initial_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "no_thermohaline_mixing : If True, disables thermohaline mixing. : (null)\n",
+      "lithium_GB_post_Heflash : Sets the lithium abundances after the helium flash. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_GB_post_1DUP : Sets the lithium abundance after first dredge up. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_hbb_multiplier : Multiplies the lithium abundances on the AGB during HBB (based on Karakas/Fishlock et al models).Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "angelou_lithium_decay_function : Functional form which describes Li7 decay. Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Choices are : 0 expoential (see angelou_lithium_decay_time). : (null)\n",
+      "angelou_lithium_LMMS_time : Time at which lithium manufacture is triggered in a low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_time : Time at which lithium manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_time : Time at which lithium manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_time : Time at which lithium manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_time : Time at which lithium manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_time : Time at which lithium manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_time : Time at which lithium manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_decay_time : Decay time for surface lithium abundance during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_decay_time : Decay time for surface lithium abundance on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_decay_time : Decay time for surface lithium abundance on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_decay_time : Decay time for surface lithium abundance on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_decay_time : Decay time for surface lithium abundance during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_decay_time : Decay time for surface lithium abundance on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_decay_time : Decay time for surface lithium abundance on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_massfrac : Lithium mass fraction when its manufacture is triggered during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_massfrac : Lithium mass fraction when its manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_massfrac : Lithium mass fraction when its manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_massfrac : Lithium mass fraction when its manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_massfrac : Lithium mass fraction when its manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_vrot_trigger : Equatorial rotational velocity at which lithium manufacture is triggered (km/s). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "angelou_lithium_vrotfrac_trigger : Fraction of Keplerian (breakup) equatorial rotational velocity at which lithium manufacture is triggered (must be <1, ignored if 0). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Output\n",
+      "############################################################\n",
+      "david_logging_function : Function to choose which kind of information gets logged Requires DAVID. Choices are: 0= None, >0 for custom logging functions : Ignore\n",
+      "cf_amanda_log : Enable logging to compare to Amanda's models. : (null)\n",
+      "float_overflow_checks : Turn on to enable floating-point overflow checks at the end of each timestep, if they are available. 0=off, 1=warn (stderr) on failure, 2=exit on failure (0) : (null)\n",
+      "save_pre_events_stardata : Enable this to save a copy of stardata to stardata->pre_events_stardata just before an event. : (null)\n",
+      "disable_end_logging : Disable the logging that happens at the end of the evolution. : (null)\n",
+      "ensemble : Turn on ensemble calculations and output. : (null)\n",
+      "ensemble_filters_off : Sets all ensemble filters to be off (FALSE) - these can then be enabled one-by-one with --ensemble_filter_[...] TRUE. : (null)\n",
+      "ensemble_filter_%d : Turn on or off ensemble filter <n>. For a list of filters, see ensemble_macros.h. : (null)\n",
+      "ensemble_legacy_ensemble : Turn on ensemble legacy population output. : (null)\n",
+      "legacy_yields : Turn on ensemble legacy yield output. : (null)\n",
+      "ensemble_defer : Defer ensemble output. : (null)\n",
+      "ensemble_dt : When doing ensemble calculations, data are stored and/or output every ensemble_dt Myr. See also ensemble, ensemble_logdt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logdt : When doing ensemble calculations, and when logensembletimes is set, the ensemble is stored/output every ensemble_logdt Myr. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_startlogtime : Start log ensemble data storage/calculations/output at ensemble_startlogtime. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logtimes : When doing ensemble calculations/output, set this to act at log times rather than linear times. : (null)\n",
+      "postagb_legacy_logging : Turn on post-AGB legacy logging. : (null)\n",
+      "disc_legacy_logging : Turn on disc legacy logging. : (null)\n",
+      "EMP_logg_maximum : Maximum logg that EMP stars are allowed to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_minimum_age. : (null)\n",
+      "EMP_minimum_age : Minimum age that EMP stars are required to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum. : (null)\n",
+      "EMP_feh_maximum : Maximum [Fe/H] that an EMP stars may have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default -2.0. : (null)\n",
+      "CEMP_cfe_minimum : Minimum [C/Fe] that CEMP stars are required to have. See Izzard et al 2009. See also NEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 0.7. : (null)\n",
+      "NEMP_cfe_minimum : Minimum [N/Fe] that NEMP stars are required to have. See Izzard et al 2009, Pols et al. 2012. See also CEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 1.0. : (null)\n",
+      "thick_disc_start_age : Lookback time for the start of the thick disc star formation, e.g. 13e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_end_age : Lookback time for the end of the thick disc star formation, e.g. 4e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_logg_min : Minimum logg for thick disc giants to be logged. : (null)\n",
+      "thick_disc_logg_max : Maximum logg for thick disc giants to be logged. : (null)\n",
+      "escape_velocity : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 1e9 km/s. See also escape_fraction. : (null)\n",
+      "escape_fraction : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 0.0. See also escape_velocity. : (null)\n",
+      "colour_log : If set to True, thelog is coloured with ANSI colour formatting. Requires FILE_LOG to be defined. : \n",
+      "log_filename : Location of the output logging filename. If set to \"/dev/null\" then there is no logging. : \n",
+      "stopfile : File which, when it exists, will stop the current binary_c repeat run. : \n",
+      "stardata_dump_filename : Location of the stardata dump file. : \n",
+      "stardata_load_filename : Location of the stardata file to load. : \n",
+      "api_log_filename_prefix : Location of the output logging filename prefix for the API. If set to \"/dev/null\" then there is no logging. : 0\n",
+      "hrdiag_output : Set to True to output high time-resolution Hertzstrpung-Russell diagram information. Requires HRDIAG. : (null)\n",
+      "internal_buffering : Experimental. Set to non-zero values to implement internal buffering prior to output. For use with binary_grid, you shouldn't really be playing with this. : (null)\n",
+      "eccentric_RLOF_model : Chooses which model is used to handle eccentric RLOF. Default is RLOF_ECCENTRIC_AS_CIRCULAR, i.e. ignore the eccentricity. Note: requires force_corotation_of_primary_and_orbit to be FALSE.\n",
+      " : (null)\n",
+      "force_circularization_on_RLOF : If True forces circularization of stars and orbit when RLOF starts, this is as in the BSE algorithm. (True) : (null)\n",
+      "wtts_log : If True, enables log file output for WTTS2. : (null)\n",
+      "fabian_imf_log_time : Time at which to output for Fabian Schneider's IMF project. Requires FABIAN_IMF_LOG : Ignore\n",
+      "fabian_imf_log_timestep : Timestep for Fabian Schneider's IMF project logging. Requires FABIAN_IMF_LOG : Ignore\n",
+      "version : Display binary_c version and build information. Also performs timing tests. : Ignore\n",
+      "dumpversion : Display binary_c version number (short format). : Ignore\n",
+      "version_only : Display binary_c version number and build information, but do not perform timing tests or anything that requires stardata to be non-NULL. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Input\n",
+      "############################################################\n",
+      "MINT_dir : Location of MINT algorithm data. : \n",
+      "MINT_data_cleanup : Activate checks on incoming data to try to account for problems. Will make data-loading slower, but may fix a few things. : \n",
+      "MINT_MS_rejuvenation : Turn on or off (hydrogen) main-sequence rejuvenation. : \n",
+      "MINT_remesh : Turn on or off MINT's remeshing. : \n",
+      "MINT_use_ZAMS_profiles : Use chemical profiles at the ZAMS if MINT_use_ZAMS_profiles is TRUE, otherwise set homogeneous abundances. (Default is TRUE, so we use the profiles if they are available.) : \n",
+      "MINT_disable_grid_load_warnings : Use this to explicitly disable MINT's warnings when loading a grid with, e.g., missing or too much data. : \n",
+      "MINT_Kippenhahn : Turn on or off MINT's Kippenhahn diagrams. If 0, off, if 1, output star 1 (index 0), if 2 output star 2 (index 1). Default 0. : \n",
+      "MINT_Kippenhahn_stellar_type : Stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for which Kippenhahn plot data should be output. : \n",
+      "MINT_Kippenhahn_companion_stellar_type : Companion stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for the companion for which Kippenhahn plot data should be output. : \n",
+      "MINT_nuclear_burning : Turn on or off MINT's nuclear burning algorithm. : \n",
+      "MINT_minimum_shell_mass : Minimum shell mass in MINT's nuclear burning routines. : \n",
+      "MINT_maximum_shell_mass : Maximum shell mass in MINT's nuclear burning routines. : \n",
+      "\n",
+      "############################################################\n",
+      "##### Section I/O\n",
+      "############################################################\n",
+      "go : batchmode control command : Ignore\n",
+      "gogo : batchmode control command : Ignore\n",
+      "reset_stars : Reset the star structures. Used in batchmode : Ignore\n",
+      "reset_stars_defaults : Reset the star structures and set defaults. Used in batchmode : Ignore\n",
+      "defaults : Reset all defaults. Used in batchmode : Ignore\n",
+      "echo : Activate batchmode command echoing, i.e. when you enter a command, binary_c repeats the command then executes it. : Ignore\n",
+      "noecho : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "noechonow : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "bye : Quit binary_c. Used in batchmode. : Ignore\n",
+      "fin : batchmode control command : Ignore\n",
+      "reset_prefs : Reset preferences struct. Used in batchmode : Ignore\n",
+      "status : Output batchmode status information. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Algorithms\n",
+      "############################################################\n",
+      "repeat : If > 1, repeats the system as many times as required. Handy if you're using Monte-Carlo kicks and want to sample the parameter space well. Also, if you are running speed tests this is good to give a statistically more reasonable result. (See e.g. 'tbse pgo'). : (null)\n",
+      "random_systems : Experimental. Use this to apply random initial system parameters (masses, separations, etc.). Useful for testing only. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Misc\n",
+      "############################################################\n",
+      "random_seed : Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "random_systems_seed : Random number seed for the generation of random systems. See random_systems and random_seed. : (null)\n",
+      "random_skip : Skip the first <random_seed> random numbers that are generated. Usually this is 0 so they are all used. : (null)\n",
+      "idum : [NB: deprecated, please use 'random_seed' instead.] Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "reverse_time : Make time go backwards. To be considered very experimental! : (null)\n",
+      "start_time : Start time for the simulation. : (null)\n",
+      "warmup_cpu : Uses the CPU at maximum power the given number of seconds, prior to running normal stellar evolution. : Ignore\n",
+      "help : Display help pages. Usage: --help <help topic>. : Ignore\n",
+      "argopts : Display argument options. Usage: --argopts <argument>. : Ignore\n",
+      "help_all : Display all help pages. : Ignore\n",
+      "list_args : Display list of arguments with their default values. Useful for batchmode. : Ignore\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help_all())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bfec32cf-7240-4a82-ac30-b3d99a018a28",
+   "metadata": {},
+   "source": [
+    "We can get all the parameter names and their default values with return_arglines(): (abridged output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "3d29ca9d-ac66-4f9e-81cf-2edd14a98b79",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "__ARG_BEGIN\n",
+      "metallicity = 0.02\n",
+      "effective_metallicity = -1\n",
+      "M_1 = 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print('\\n'.join(_binary_c_bindings.return_arglines().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e8b1c8b6-a878-43f4-bc36-1b20b3e66c6f",
+   "metadata": {},
+   "source": [
+    "Lastly, we can ask binary_c to determine the minimum period or maximum mass for RLOF at the ZAMS: Both of them need an argstring as input"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "e517f561-09c6-419d-ba89-d9cb61e6ebab",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MINIMUM SEPARATION 0.31\n",
+      "MINIMUM PERIOD 0.00632092\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_minimum_orbit_for_RLOF(argstring, store_capsule=store_memaddr)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 46,
+   "id": "7da75a95-8831-4346-a584-e042ced75249",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MAXIMUM MASS RATIO 0.0141\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=5,\n",
+    "    M_2=1,\n",
+    "    orbital_period=0.0001,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_maximum_mass_ratio_for_RLOF(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5fe52d8e-1721-4796-a856-002cf4525d96",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/_sources/notebook_custom_logging.ipynb.txt b/docs/build/html/_sources/notebook_custom_logging.ipynb.txt
new file mode 100644
index 000000000..e84895375
--- /dev/null
+++ b/docs/build/html/_sources/notebook_custom_logging.ipynb.txt
@@ -0,0 +1,517 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "879b596b-d70c-4f90-b668-563b4ad93ffc",
+   "metadata": {},
+   "source": [
+    "# Notebook custom logging\n",
+    "In this notebook you'll learn how to use the custom logging functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "696ecbb9-1efd-48f4-a57e-2cf6dfe416f1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "from binarycpython.utils.custom_logging_functions import (\n",
+    "    autogen_C_logging_code,\n",
+    "    binary_c_log_code,\n",
+    "    create_and_load_logging_function,\n",
+    ")\n",
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "from binarycpython.utils.grid import Population"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d4d721cc-df4f-4ac2-b6f9-62e85ca0c1e5",
+   "metadata": {},
+   "source": [
+    "The custom logging functionality allows us to decide the output of binary_c _without_ modifying the actual sourcecode of binary_c (i.e. editing `src/logging/log_every_timestep` in binary_c). Rather, we can create a logging routine from within python.\n",
+    "\n",
+    "Technically, the following steps are taken:\n",
+    "- User creates a logging print statement from within python\n",
+    "- The logging print statement string gets wrapped into a proper c-function by `binary_c_log_code`\n",
+    "- The c-function string gets compiled and loaded into memory by `create_and_load_logging_function`\n",
+    "- The memory adress of the compiled and loaded print function can now be passed to C\n",
+    "- binary_c uses the custom print function \n",
+    "\n",
+    "The custom logging functionality can be used when running systems via `run_system()`, via `Population.evolve()` and `Population.evolve_single()`, and directly via the API\n",
+    "\n",
+    "Within the logging statement we can access information from the stardata object, as well as use logical statements to determine when to log information. What we cannot do, however, is access functions that are not _publicly available_. For very elaborate printing routines it is still advised to actually hardcode the print statement into binary_c itself."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "be137151-bb57-43d7-bab1-0167512ac727",
+   "metadata": {},
+   "source": [
+    "## Usage"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac4e5f4c-81e6-4980-b852-aca84ca74f4c",
+   "metadata": {},
+   "source": [
+    "There are two methods to create the C-code that will be compiled:\n",
+    "- Automatically generate the print statement and use the wrapper to generate the full function string, by using `autogen_C_logging_code`\n",
+    "- Create your custom print statement and use the wrapper to generate the full function string, by writing out the print statement. Here the logging statement obviously has to be valid C code"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "236cf821-09ac-4237-9b8f-6e36d2edf446",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA %g %g\\n\",((double)stardata->model.time),((double)stardata->star[0].mass));\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines. Here you can choose whatever you want to have logged, and with what header\n",
+    "# this generates working print statements\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "feb423d5-5cc3-433c-9801-f8017abbc03a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "2f5defbf-c623-49ed-a238-fba52a563a58",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "#pragma push_macro(\"Max\")\n",
+      "#pragma push_macro(\"Min\")\n",
+      "#undef Max\n",
+      "#undef Min\n",
+      "#include \"binary_c.h\"\n",
+      "\n",
+      "// add visibility __attribute__ ((visibility (\"default\"))) to it \n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata);\n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata)\n",
+      "{\n",
+      "    // struct stardata_t * stardata = (struct stardata_t *)x;\n",
+      "    Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass);\n",
+      "}\n",
+      "\n",
+      "#undef Max \n",
+      "#undef Min\n",
+      "#pragma pop_macro(\"Min\")\n",
+      "#pragma pop_macro(\"Max\")    \n"
+     ]
+    }
+   ],
+   "source": [
+    "# Generate the entire 'script' by wrapping the logging line\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "print(custom_logging_code)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "efa7f1e9-247e-4196-a883-bcff05265d02",
+   "metadata": {},
+   "source": [
+    "Combining the above with e.g. run_system() (see notebook_individual_systems for more examples):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "dcd74bbc-478b-43e4-b495-8c456e8d1d88",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=1e-06 mass=2\n",
+      "MY_STELLAR_DATA time=2e-06 mass=2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# logging statement\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=2, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1998ee8f-8c0a-462b-b1e0-54f5963902cc",
+   "metadata": {},
+   "source": [
+    "### Using custom logging with the population object\n",
+    "Custom logging can be used for a whole population by setting the print statement (so not the entire logging script) in `C_logging_code`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "77bd09b0-1a94-499d-97db-a1f991c67c12",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_ABOVE_MS             1.041660877905e+02 4.99198 4.99198 6.1357 6.1357 2 1\n",
+      "EXAMPLE_ABOVE_MS             1.041662558619e+02 4.99198 4.99198 6.14057 6.1357 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662560111e+02 4.99198 4.99198 6.14057 6.14057 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662564579e+02 4.99198 4.99198 6.14059 6.14057 2 2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Set up population\n",
+    "pop = Population()\n",
+    "\n",
+    "# Set some BSE parameters\n",
+    "pop.set(\n",
+    "    M_1=5\n",
+    ")\n",
+    "\n",
+    "# Example logging that prints only if the star is post main-sequence\n",
+    "example_logging_string_post_MS = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>MS)\n",
+    "{\n",
+    "    Printf(\"EXAMPLE_ABOVE_MS %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "        // \n",
+    "        stardata->model.time, // 1\n",
+    "\n",
+    "        stardata->star[0].mass, //2\n",
+    "        stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "        stardata->star[0].radius, //4\n",
+    "        stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "        stardata->star[0].stellar_type, //6\n",
+    "        stardata->previous_stardata->star[0].stellar_type //7\n",
+    "  );\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Set the logging\n",
+    "pop.set(\n",
+    "    C_logging_code=example_logging_string_post_MS\n",
+    ")\n",
+    "out = pop.evolve_single()\n",
+    "\n",
+    "# Print (abridged) output\n",
+    "print('\\n'.join(out.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93397ff3-9b71-470d-8bc4-08fe5b1a5dca",
+   "metadata": {},
+   "source": [
+    "### Using custom logging when running directly from the API\n",
+    "When running a system directly with the API we need to manually load the custom logging into memory (via `create_and_load_logging_function`) and pass the memory address to the binary_c binding via `_binary_c_bindings.run_system(argstring, custom_logging_func_memaddr=custom_logging_memaddr)`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "id": "30142286-34ce-433e-82c8-565e2160ff5b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 1e-06 15\n",
+      "MY_STELLAR_DATA 2e-06 15\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "# Generate code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Generate library and get memaddr\n",
+    "custom_logging_memaddr, shared_lib_filename = create_and_load_logging_function(\n",
+    "    custom_logging_code\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "m1 = 15.0  # Msun\n",
+    "m2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000\n",
+    "argstring = \"binary_c M_1 {0:g} M_2 {1:g} separation {2:g} orbital_period {3:g} eccentricity {4:g} metallicity {5:g} max_evolution_time {6:g}\".format(\n",
+    "    m1,\n",
+    "    m2,\n",
+    "    separation,\n",
+    "    orbital_period,\n",
+    "    eccentricity,\n",
+    "    metallicity,\n",
+    "    max_evolution_time,\n",
+    ")\n",
+    "output = _binary_c_bindings.run_system(\n",
+    "    argstring, custom_logging_func_memaddr=custom_logging_memaddr\n",
+    ")\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print('\\n'.join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39c76b1d-d968-4eef-b5ae-2542ed9557c3",
+   "metadata": {},
+   "source": [
+    "## Examples of logging strings\n",
+    "Below are some examples of logging strings"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2ac4af72-6dab-4cc9-986e-5b5b1fa31b73",
+   "metadata": {},
+   "source": [
+    "### Compact object\n",
+    "This logging will print the timestep when the star becomes a compact object. After it does, we change the maximum time to be the current time, effectively terminating the evolution"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "id": "6f0edc65-a788-4706-a0c5-2ace030765ec",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "EXAMPLE_LOG_CO             2.773581245005e+01 1.33524 9.19314 1.72498e-05 730.446 13 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_LOG_CO %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "            stardata->star[0].radius, //4\n",
+    "            stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type //7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=10, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "51c51592-6406-43bd-a879-10ace64aaf28",
+   "metadata": {},
+   "source": [
+    "### Logging mass evolution and the supernova\n",
+    "This logging code prints the mass evolution and the moment the star goes supernova"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 47,
+   "id": "8f58fdf9-3e76-4c18-a1c5-eed0980d4133",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_MASSLOSS             9.878236827680e+00 1.61349 8.38063 20 13 1\n",
+      "EXAMPLE_SN             9.878236827680e+00 1.61349 8.38063 20 12 13 5 1 6.74037 4.92267 6.74037 0 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d %g\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type, //5\n",
+    "    stardata->model.probability //6\n",
+    ");\n",
+    "if(stardata->star[0].SN_type != SN_NONE)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        if(stardata->pre_events_stardata != NULL)\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->pre_events_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->pre_events_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[ID_core(stardata->pre_events_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "        else\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->previous_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->previous_stardata->star[0].core_mass[ID_core(stardata->previous_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=20, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[-2:]))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/_sources/notebook_extra_features.ipynb.txt b/docs/build/html/_sources/notebook_extra_features.ipynb.txt
new file mode 100644
index 000000000..d453a6f5b
--- /dev/null
+++ b/docs/build/html/_sources/notebook_extra_features.ipynb.txt
@@ -0,0 +1,44 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d5c04b77-f0be-4b33-8c03-c72eb846527c",
+   "metadata": {},
+   "source": [
+    "# Extra features and functionality of binarycpython\n",
+    "In this notebook we'll go over some of the extra features and functionality that was not covered in the other notebooks.\n",
+    "\n",
+    "TODO"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0020f1bc-2a23-455c-8216-9e63e6e038ae",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/_sources/notebook_individual_systems.ipynb.txt b/docs/build/html/_sources/notebook_individual_systems.ipynb.txt
new file mode 100644
index 000000000..19c2d29fb
--- /dev/null
+++ b/docs/build/html/_sources/notebook_individual_systems.ipynb.txt
@@ -0,0 +1,563 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "a544d28c-c2e1-4c6a-b55b-8caec440743f",
+   "metadata": {},
+   "source": [
+    "# Running individual systems with binarycpython\n",
+    "This notebook will show you how to run single systems and analyze their results.\n",
+    "\n",
+    "It can be useful to have some functions to quickly run a single system to e.g. inspect what evolutionary steps a specific system goes through, to plot the mass loss evolution of a single star, etc. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dd5d9ec7-5791-45f1-afbd-225947e2a583",
+   "metadata": {},
+   "source": [
+    "## Single system with run_wrapper\n",
+    "The simplest method to run a single system is to use the run_system wrapper. This function deals with setting up the argument string, makes sure all the required parameters are included and handles setting and cleaning up the custom logging functionality (see notebook_custom_logging).\n",
+    "\n",
+    "As arguments to this function we can add any of the parameters that binary_c itself actually knows, as well as:\n",
+    "- custom_logging_code: string containing a print statement that binary_c can use to print information\n",
+    "- log_filename: path of the logfile that binary_c generates\n",
+    "- parse_function: function that handles parsing the output of binary-c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "425efed3-d8e3-432d-829e-41d8ebe05162",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "# help(run_system) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "b2abab48-433d-4936-8434-14804c52c9f6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 1 12462\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f127a5e4-dc01-4472-9130-8a943c92e8a7",
+   "metadata": {},
+   "source": [
+    "Lets try adding a log filename now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "029fc3f2-f09a-49af-a32b-248505738f2e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "      TIME      M1       M2   K1  K2           SEP   ECC  R1/ROL1 R2/ROL2  TYPE RANDOM_SEED=67365 RANDOM_COUNT=0\n",
+      "     0.0000    1.000    0.000  1  15            -1 -1.00   0.000   0.000  \"INITIAL \"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"OFF_MS\"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 11582.2424    1.000    0.000  3  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12325.1085    0.817    0.000  4  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12457.1300    0.783    0.000  5  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"shrinkAGB\"\n",
+      " 12461.9514    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 15000.0000    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"MAX_TIME\"\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1, log_filename='/tmp/test_logfile.txt')\n",
+    "with open('/tmp/test_logfile.txt', 'r') as f:\n",
+    "    print(f.read())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "606670f2-3e0a-43c7-a885-006b92fac9d2",
+   "metadata": {},
+   "source": [
+    "To get more useful output we can include a custom_logging snippet (see notebook_custom_logging):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "e6a23b55-ca42-440d-83ac-e76a24a83a67",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 1 1 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 1 1 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython.utils.custom_logging_functions import binary_c_log_code\n",
+    "\n",
+    "# Create the print statement\n",
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"\n",
+    "\n",
+    "# Generate entire shared lib code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(custom_logging_print_statement)\n",
+    "\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code)\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4c885143-db79-4fed-b4c4-0bd846e24f7d",
+   "metadata": {},
+   "source": [
+    "Now we have some actual output, it is time to create a parse_function which parses the output. Adding a parse_function to the run_system will make run_system run the output of binary_c through the parse_function."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "3822721f-217a-495b-962e-d57137b9e290",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 1.0, 1.0, 1.0], [0.0, 1.0, 1.0, 1.0]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "def parse_function(output):\n",
+    "    \"\"\"\n",
+    "    Example function to parse the output of binary_c\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    return value_lines\n",
+    "\n",
+    "# Catch output\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code, parse_function=parse_function)\n",
+    "print(output[:3])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a551f07f-2eff-4425-9375-267579a581b3",
+   "metadata": {},
+   "source": [
+    "This output can now be turned into e.g. an Numpy array or Pandas dataframe (my favorite: makes querying the data very easy)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "654a07ed-2a88-46ff-9da0-b7759580f9f3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0        time      mass initial_mass stellar_type\n",
+      "1           0         1            1            1\n",
+      "2           0         1            1            1\n",
+      "3       1e-06         1            1            1\n",
+      "4       2e-06         1            1            1\n",
+      "5       3e-06         1            1            1\n",
+      "...       ...       ...          ...          ...\n",
+      "1612  12461.8  0.577754            1            6\n",
+      "1613    12462  0.522806            1           11\n",
+      "1614    13462  0.522806            1           11\n",
+      "1615    14462  0.522806            1           11\n",
+      "1616    15000  0.522806            1           11\n",
+      "\n",
+      "[1616 rows x 4 columns]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import pandas as pd\n",
+    "\n",
+    "# Load data into dataframe\n",
+    "example_df = pd.DataFrame(output)\n",
+    "\n",
+    "# Fix column headers\n",
+    "example_df.columns = example_df.iloc[0]\n",
+    "example_df = example_df.drop(example_df.index[0])\n",
+    "\n",
+    "print(example_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "325c2ce6-f9a1-46b7-937f-84040e1252cf",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## Single system via population object\n",
+    "When setting up your population object (see notebook_population), and configuring all the parameters, it is possible to run a single system using that same configuration. It will use the parse_function if set, and running a single system is a good method to test if everything works accordingly."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "4a98ffca-1b72-4bb8-8df1-3bf3187d882f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.grid import Population\n",
+    "# help(Population) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7e2c2ef0-3db2-46a6-8c85-9b6cf720eb6a",
+   "metadata": {},
+   "source": [
+    "First, let's try this without any custom logging or parsing functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "bff1cc2e-6b32-4ba0-879f-879ffbabd223",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Create the population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# Set some parameters\n",
+    "example_pop.set(\n",
+    "    verbosity=1\n",
+    ")\n",
+    "example_pop.set(\n",
+    "    M_1=10\n",
+    ")\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ae01fa35-f8b1-4a40-bfb2-b9e872cae0e7",
+   "metadata": {},
+   "source": [
+    "Now lets add some actual output with the custom logging"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "dd748bab-b57e-4129-8350-9ea11fa179d0",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\n\",\n",
+      "    // \n",
+      "    stardata->model.time, // 1\n",
+      "    stardata->star[0].mass, //2\n",
+      "    stardata->previous_stardata->star[0].mass, //3\n",
+      "    stardata->common.zero_age.mass[0], //4\n",
+      "\n",
+      "    stardata->star[0].stellar_type //5\n",
+      ");\n",
+      " to grid_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294.so\n",
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 10 0 10 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 10 10 10 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 10 10 10 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 10 10 10 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"   \n",
+    "\n",
+    "example_pop.set(C_logging_code=custom_logging_print_statement)\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "588a7d9e-9d64-4b3b-8907-656b905286e8",
+   "metadata": {},
+   "source": [
+    "Lastly we can add a parse_function to handle parsing the output again. \n",
+    "\n",
+    "Because the parse_function will now be part of the population object, it can access information of the object. We need to make a new parse function that is fit for an object: we the arguments now need to be (self, output). Returning the data is useful when running evolve_single(), but won't be used in a population evolution."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "fec39154-cce6-438c-8c2c-509d76b00f34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "import numpy as np\n",
+    "\n",
+    "def object_parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function that can be added to the population object\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # We can access object instance information now. \n",
+    "    # In this way we can store the results in a file for example. \n",
+    "    output_file = os.path.join(self.custom_options['output_dir'], 'example_output.json')\n",
+    "    \n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    # Turn into an array\n",
+    "    values_array = np.array(value_lines[1:])\n",
+    "    \n",
+    "    # make dict and fill\n",
+    "    output_dict = {}\n",
+    "    for i in range(len(column_names)):\n",
+    "        output_dict[column_names[i]] = list(values_array[:,i])\n",
+    "\n",
+    "    # Write to file\n",
+    "    with open(output_file, 'w') as f:\n",
+    "        f.write(json.dumps(output_dict, indent=4))\n",
+    "        \n",
+    "    # Return something anyway\n",
+    "    return value_lines"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "57347512-fd4a-434b-b13c-5e6dbd3ac415",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: parse_function=<function object_parse_function at 0x7f9265091598> to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: output_dir=/tmp/ to custom_options >>>>\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_e9c2bec7f15541eb847fc6013e48e7ed.so\n",
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 10.0, 0.0, 10.0, 1.0], [0.0, 10.0, 10.0, 10.0, 1.0], [1e-06, 10.0, 10.0, 10.0, 1.0]]\n",
+      "dict_keys(['time', 'mass', 'initial_mass', 'stellar_type'])\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(\n",
+    "    parse_function=object_parse_function,\n",
+    "    output_dir='/tmp/'\n",
+    ")\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output[:4])\n",
+    "\n",
+    "# Example of loading the data that was written\n",
+    "with open(os.path.join(example_pop.custom_options['output_dir'], 'example_output.json')) as f:\n",
+    "    written_data = json.loads(f.read())\n",
+    "\n",
+    "print(written_data.keys())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ddc06da3-fc68-4c6f-8067-14ea862b964d",
+   "metadata": {},
+   "source": [
+    "## Single system via API functionality\n",
+    "It is possible to construct your own functionality to run a single system by directly calling the API function to run a system. Under the hood all the other functions and wrappers actually use this API.\n",
+    "\n",
+    "There are less failsafes for this method, so this make sure the input is correct and binary_c knows all the arguments you pass in.\n",
+    "\n",
+    "for more details on this API function see `notebook_api_functions`"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "56886792-d379-4eac-b0d4-54508edb39c7",
+   "metadata": {},
+   "source": [
+    "First we must construct the argument string that we pass to binary_c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "ec48125c-6bf5-48f4-9357-8261800b5d8b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 15 14.2383\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For a binary system we need to pass in these arguments\n",
+    "M_1 = 15.0  # Msun\n",
+    "M_2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000  # Myr. You need to include this argument.\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} M_2 {M_2} separation {separation} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=M_1,\n",
+    "    M_2=M_2,\n",
+    "    separation=separation,\n",
+    "    orbital_period=orbital_period,\n",
+    "    eccentricity=eccentricity,\n",
+    "    metallicity=metallicity,\n",
+    "    max_evolution_time=max_evolution_time,\n",
+    ").strip()\n",
+    "\n",
+    "from binarycpython import _binary_c_bindings\n",
+    "\n",
+    "output = _binary_c_bindings.run_system(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "55c8ea24-0fc0-452c-8121-1e7667433479",
+   "metadata": {},
+   "source": [
+    "As we can see above, the output is rather empty. But if SINGLE_STAR_LIFETIME is printed we know we caught the output correctly. To get actual output we should have timesteps printed in the `log_every_timestep.c` in binary_c, or add some custom_logging (see notebook_custom_logging). "
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/_sources/notebook_population.ipynb.txt b/docs/build/html/_sources/notebook_population.ipynb.txt
index 8d2bdbf98..56f3b153c 100644
--- a/docs/build/html/_sources/notebook_population.ipynb.txt
+++ b/docs/build/html/_sources/notebook_population.ipynb.txt
@@ -5,44 +5,82 @@
    "id": "bbbaafbb-fd7d-4b73-a970-93506ba35d71",
    "metadata": {},
    "source": [
-    "# Title page\n"
+    "# Running populations with binarycpython\n",
+    "This notebook will show you how to evolve a population of stars\n",
+    "\n",
+    "Much of the code in the binarycpython package is written to evolve a population of stars through the Population object, rather than running a single system. Let's go through the functionality of this object step by step and set up some example populations. \n",
+    "\n",
+    "At the bottom of this notebook there are some complete example scripts"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "bf6b8673-a2b5-4b50-ad1b-e90671f57470",
    "metadata": {},
    "outputs": [],
    "source": [
     "import os\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
     "from binarycpython.utils.grid import Population\n",
-    "from binarycpython.utils.functions import (\n",
-    "    get_help_all,\n",
-    "    get_help,\n",
-    "    create_hdf5,\n",
-    "    output_lines,\n",
-    ")\n",
-    "from binarycpython.utils.custom_logging_functions import temp_dir\n"
+    "\n",
+    "# help(Population) # Uncomment to see the public functions of this object"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a081ab23-7822-4971-aa82-991548534714",
+   "metadata": {},
+   "source": [
+    "- running ensemble\n",
+    "- using M&S grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f268eff3-4e08-4f6b-8b59-f22dba4d2074",
+   "metadata": {},
+   "source": [
+    "## Setting up the Population object\n",
+    "To set up and configure the population object we need to make an object instance of the `Population` object, and add configuration via the `.set()` function.\n",
+    "\n",
+    "There are three categories of options that the Population object can set:\n",
+    "- BSE options: these options will be used for the binary_c calls, and are recognized by comparing the arguments to a known list of available arguments of binary_c. To see which options are available, see section [`binary_c parameters` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html). You can access these through `population.bse_options['<bse option name>']` after you have set them. \n",
+    "\n",
+    "- Grid options: these options will be used to configure the behaviour of the Population object. To see which options are available, see section [`Population grid code options` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html). They can be accessed via `population.grid_options['<grid option name>']` after you have set them. \n",
+    "\n",
+    "- Custom options: these options are not recognized as either of the above, so they will be stored in the custom_options, and can be accessed via `population.custom_options['<custom option name>']`"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "79ab50b7-591f-4883-af09-116d1835a751",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "adding: orbital_period=45000000080 to BSE_options\n",
+      "adding: max_evolution_time=15000 to BSE_options\n",
+      "adding: eccentricity=0.02 to BSE_options\n",
+      "adding: amt_cores=2 to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: data_dir=/tmp/binary_c_python/example_python_population_result to custom_options >>>>\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: base_filename=example_pop.dat to custom_options >>>>\n",
+      "1\n",
+      "example_pop.dat\n",
+      "10\n"
+     ]
+    }
+   ],
    "source": [
-    "#########################################################\n",
-    "# This file serves as an example for running a population.\n",
-    "# The use of help(<function>) is a good way to inspect what parameters are there to use\n",
-    "#########################################################\n",
-    "\n",
     "# Create population object\n",
     "example_pop = Population()\n",
     "\n",
     "# If you want verbosity, set this before other things\n",
-    "example_pop.set(verbose=1)\n",
+    "example_pop.set(verbosity=1)\n",
     "\n",
     "# Setting values can be done via .set(<parameter_name>=<value>)\n",
     "# Values that are known to be binary_c_parameters are loaded into bse_options.\n",
@@ -51,115 +89,244 @@
     "example_pop.set(\n",
     "    # binary_c physics options\n",
     "    M_1=10,  # bse_options\n",
-    "    separation=0,  # bse_options\n",
     "    orbital_period=45000000080,  # bse_options\n",
     "    max_evolution_time=15000,  # bse_options\n",
     "    eccentricity=0.02,  # bse_options\n",
-    "    # Set companion to low mass\n",
-    "    M_2=0.08,  # Since in the example we run a single system, we should set the companion mass here. If we donm't do this, the code will complain.\n",
+    "\n",
+    "\n",
     "    # grid_options\n",
     "    amt_cores=2,  # grid_options\n",
-    "    verbose=1,  # verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff\n",
+    "    \n",
     "    # Custom options # TODO: need to be set in grid_options probably\n",
     "    data_dir=os.path.join(\n",
     "        temp_dir(), \"example_python_population_result\"\n",
     "    ),  # custom_options\n",
     "    base_filename=\"example_pop.dat\",  # custom_options\n",
-    ")"
+    ")\n",
+    "\n",
+    "# We can use the options through\n",
+    "print(example_pop.grid_options['verbosity'])\n",
+    "print(example_pop.custom_options['base_filename'])\n",
+    "print(example_pop.bse_options['M_1'])"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
+   "cell_type": "markdown",
+   "id": "f8d46d19-633d-4911-821d-a59daed31816",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "def parse_function(self, output):\n",
-    "    # EXAMPLE PARSE_FUNCTION\n",
-    "\n",
-    "    # extract info from the population instance\n",
-    "\n",
-    "    # Get some information from the\n",
-    "    data_dir = self.custom_options[\"data_dir\"]\n",
-    "    base_filename = self.custom_options[\"base_filename\"]\n",
-    "\n",
-    "    # Check directory, make if necessary\n",
-    "    os.makedirs(data_dir, exist_ok=True)\n",
-    "\n",
-    "    seperator = \" \"\n",
-    "\n",
-    "    # Create filename\n",
-    "    outfilename = os.path.join(data_dir, base_filename)\n",
-    "\n",
-    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "After configuring the population, but before running the actual population, its usually a good idea to export the full configuration (including version info of binary_c and all the parameters) to a file. To do this we use `example_pop.export_all_info()`.\n",
     "\n",
-    "    # Go over the output.\n",
-    "    for el in output_lines(output):\n",
-    "        headerline = el.split()[0]\n",
-    "\n",
-    "        # CHeck the header and act accordingly\n",
-    "        if headerline == \"MY_STELLAR_DATA\":\n",
-    "            values = el.split()[1:]\n",
-    "            print(values)\n",
-    "\n",
-    "            if not len(parameters) == len(values):\n",
-    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
-    "                raise ValueError\n",
+    "On default this exports everything, each of the sections can be disabled:\n",
+    "  - population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
+    "      settings=False\n",
+    "  - binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
+    "      turn off with include_binary_c_defaults=False\n",
+    "  - include_binary_c_version_info (all the compilation info, and information about the compiled\n",
+    "      parameters), turn off with include_binary_c_version_info=False\n",
+    "  - include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
+    "      turn off with include_binary_c_help_all=Fase\n",
+    "      \n",
+    "On default it will write this to the custom_options['data_dir'], but that can be overriden by setting use_datadir=False and providing an outfile=<>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "b9c2471a-a5b0-48b7-a50b-2f0d22100926",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Writing settings to /tmp/binary_c_python/example_python_population_result/example_pop_settings.json\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "example_pop.export_all_info()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f9a65554-36ab-4a04-96ca-9f1422c307fd",
+   "metadata": {},
+   "source": [
+    "## Adding grid variables\n",
+    "The main purpose of the Population object is to handle the population synthesis side of running a set of stars. The main method to do this with binarycpython, as is the case with Perl binarygrid, is to use grid variables. These are loops over a predefined range of values, where a probability will be assigned to the systems based on the chosen probability distributions.\n",
     "\n",
-    "            if not os.path.exists(outfilename):\n",
-    "                with open(outfilename, \"w\") as f:\n",
-    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "Usually we use either 1 mass grid variable, or a trio of mass, mass ratio and period (See below for full examples of all of these). We can, however, also add grid sampling for e.g. eccentricity, metallicity or other parameters. \n",
     "\n",
-    "            with open(outfilename, \"a\") as f:\n",
-    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "In some cases it could be easier to set up a for loop that sets that parameter and calls the evolve function several times, e.g. when you want to vary a prescription (usually a discrete, unweighted parameter) \n",
     "\n",
     "\n",
+    "A notable special type of grid variable is that of the Moe & di Stefano 2017 dataset (see further down in the notebook).\n",
     "\n",
-    "# Creating a parsing function\n",
-    "example_pop.set(\n",
-    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
-    ")"
+    "To add a grid variable to the population object we use `example_pop.add_grid_variable` (see next cell)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "2fa5188e-312f-4a05-aeda-0bd4c00629c8",
+   "execution_count": 4,
+   "id": "68c84521-9ae8-4020-af7a-5334173db969",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method add_grid_variable in module binarycpython.utils.grid:\n",
+      "\n",
+      "add_grid_variable(name:str, longname:str, valuerange:Union[list, str], resolution:str, spacingfunc:str, probdist:str, dphasevol:Union[str, int], parameter_name:str, gridtype:str='edge', branchpoint:int=0, precode:Union[str, NoneType]=None, condition:Union[str, NoneType]=None) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function to add grid variables to the grid_options.\n",
+      "    \n",
+      "    The execution of the grid generation will be through a nested for loop.\n",
+      "    Each of the grid variables will get create a deeper for loop.\n",
+      "    \n",
+      "    The real function that generates the numbers will get written to a new file in the TMP_DIR,\n",
+      "    and then loaded imported and evaluated.\n",
+      "    beware that if you insert some destructive piece of code, it will be executed anyway.\n",
+      "    Use at own risk.\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: Fix this complex function.\n",
+      "    \n",
+      "    Args:\n",
+      "        name:\n",
+      "            name of parameter. This is evaluated as a parameter and you can use it throughout\n",
+      "            the rest of the function\n",
+      "            \n",
+      "            Examples:\n",
+      "                name = 'lnm1'\n",
+      "        longname:\n",
+      "            Long name of parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                longname = 'Primary mass'\n",
+      "        range:\n",
+      "            Range of values to take. Does not get used really, the spacingfunction is used to\n",
+      "            get the values from\n",
+      "            \n",
+      "            Examples:\n",
+      "                range = [math.log(m_min), math.log(m_max)]\n",
+      "        resolution:\n",
+      "            Resolution of the sampled range (amount of samples).\n",
+      "            TODO: check if this is used anywhere\n",
+      "    \n",
+      "            Examples: \n",
+      "                resolution = resolution[\"M_1\"]\n",
+      "        spacingfunction:\n",
+      "            Function determining how the range is sampled. You can either use a real function,\n",
+      "            or a string representation of a function call. Will get written to a file and\n",
+      "            then evaluated.\n",
+      "    \n",
+      "            Examples:\n",
+      "                spacingfunction = \"const(math.log(m_min), math.log(m_max), {})\".format(resolution['M_1'])\n",
+      "    \n",
+      "        precode:\n",
+      "            Extra room for some code. This code will be evaluated within the loop of the\n",
+      "            sampling function (i.e. a value for lnm1 is chosen already)\n",
+      "            \n",
+      "            Examples:\n",
+      "                precode = 'M_1=math.exp(lnm1);'\n",
+      "        probdist:\n",
+      "            Function determining the probability that gets assigned to the sampled parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                probdist = 'Kroupa2001(M_1)*M_1'\n",
+      "        dphasevol:\n",
+      "            part of the parameter space that the total probability is calculated with. Put to -1\n",
+      "            if you want to ignore any dphasevol calculations and set the value to 1\n",
+      "            Examples:\n",
+      "                dphasevol = 'dlnm1'\n",
+      "        condition:\n",
+      "            condition that has to be met in order for the grid generation to continue\n",
+      "            Examples:\n",
+      "                condition = 'self.grid_options['binary']==1'\n",
+      "        gridtype:\n",
+      "            Method on how the value range is sampled. Can be either 'edge' (steps starting at\n",
+      "            the lower edge of the value range) or 'center'\n",
+      "            (steps starting at lower edge + 0.5 * stepsize).\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.add_grid_variable)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bd75cebe-2152-4025-b680-dc020b80889b",
    "metadata": {},
+   "source": [
+    "All the distribution functions that we can use are stored in the `binarycpython.utils.distribution_functions` or `binarycpython/utils/distribution_functions.py` on git. If you uncomment the help statement below you can see which functions are available now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "048db541-3e92-4c5d-a25c-9c5a34b9c857",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
    "outputs": [],
    "source": [
-    "### Custom logging\n",
-    "# Log the moment when the star turns into neutron\n",
-    "example_pop.set(\n",
-    "    C_logging_code=\"\"\"\n",
-    "if(stardata->star[0].stellar_type >= 13)    \n",
-    "{\n",
-    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
-    "    {\n",
-    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
-    "            // \n",
-    "            stardata->model.time, // 1\n",
-    "            stardata->star[0].mass, // 2\n",
-    "            stardata->common.zero_age.mass[0], // 4\n",
-    "            stardata->model.probability, // 5\n",
-    "            stardata->star[0].radius, // 6\n",
-    "            stardata->star[0].stellar_type // 7\n",
-    "      );\n",
-    "    };\n",
-    "    /* Kill the simulation to save time */\n",
-    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
-    "};\n",
-    "\"\"\"\n",
-    ")"
+    "# import binarycpython.utils.distribution_functions\n",
+    "# help(binarycpython.utils.distribution_functions)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b3a007b-5c17-42a7-a981-7e268e6f545c",
+   "metadata": {},
+   "source": [
+    "The next cell contains an example of adding the mass grid variable, but sampling in log mass. The commented grid variables are examples of the mass ratio sampling and the period sampling."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "fd197154-a8ce-4865-8929-008d3483101a",
+   "execution_count": 6,
+   "id": "47979841-2c26-4b26-8945-603d013dc93a",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added grid variable: {\n",
+      "    \"name\": \"lnm1\",\n",
+      "    \"longname\": \"Primary mass\",\n",
+      "    \"valuerange\": [\n",
+      "        2,\n",
+      "        150\n",
+      "    ],\n",
+      "    \"resolution\": \"20\",\n",
+      "    \"spacingfunc\": \"const(math.log(2), math.log(150), 20)\",\n",
+      "    \"precode\": \"M_1=math.exp(lnm1)\",\n",
+      "    \"probdist\": \"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+      "    \"dphasevol\": \"dlnm1\",\n",
+      "    \"parameter_name\": \"M_1\",\n",
+      "    \"condition\": \"\",\n",
+      "    \"gridtype\": \"edge\",\n",
+      "    \"branchpoint\": 0,\n",
+      "    \"grid_variable_number\": 0\n",
+      "}\n"
+     ]
+    }
+   ],
    "source": [
     "# Add grid variables\n",
     "resolution = {\"M_1\": 20, \"q\": 20, \"per\": 40}\n",
@@ -211,128 +378,815 @@
   },
   {
    "cell_type": "markdown",
-   "id": "8c96b151-8c3b-4479-969f-6c2f898497a5",
+   "id": "163f13ae-fec1-4ee8-b9d4-c1b75c19ff39",
    "metadata": {},
    "source": [
-    "Exporting of all the settings can be done with .export_all_info()\n",
-    "on default it exports everything, but can be supressed by turning it off:\n",
-    "  population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
-    "      settings=False\n",
-    "  binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
-    "      turn off with include_binary_c_defaults=False\n",
-    "  include_binary_c_version_info (all the compilation info, and information about the compiled\n",
-    "      parameters), turn off with include_binary_c_version_info=False\n",
-    "  include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
-    "      turn off with include_binary_c_help_all=Fase\n",
-    "On default it will write this to the custom_options['data_dir'], but that can be overriden by\n",
-    "  setting use_datadir=False and providing an outfile=<>"
+    "## Setting logging and handling the output\n",
+    "On default, binary_c will not output anything (except for 'SINGLE STAR LIFETIME'). It is up to us to determine what will be printed. We can either do that by hardcoding the print statements into `binary_c` (see documentation binary_c). Or, we can use the custom logging functionality of binarycpython (see notebook `notebook_custom_logging.ipynb`), which is faster to set up and requires no recompilation of binary_c, but is somewhat more limited in its functionality. \n",
+    "\n",
+    "After configuring what will be printed, we need to make a function to parse the output. This can be done by setting the parse_function parameter in the population object (see also notebook `notebook_individual_systems.ipynb`). \n",
+    "\n",
+    "In the code below we will set up both the custom logging, and a parse function to handle that output"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
-   "id": "ba83443c-64b4-4126-90b3-b1ca76c0f73d",
+   "execution_count": 7,
+   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
    "metadata": {},
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "if(stardata->star[0].stellar_type >= 13)    \n",
+      "{\n",
+      "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+      "    {\n",
+      "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\n\",\n",
+      "            // \n",
+      "            stardata->model.time, // 1\n",
+      "            stardata->star[0].mass, // 2\n",
+      "            stardata->common.zero_age.mass[0], // 3\n",
+      "            stardata->model.probability, // 4\n",
+      "            stardata->star[0].stellar_type // 5\n",
+      "      );\n",
+      "    };\n",
+      "    /* Kill the simulation to save time */\n",
+      "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+      "};\n",
+      " to grid_options\n"
+     ]
     }
    ],
    "source": [
-    "example_pop.export_all_info()"
+    "# Create custom logging statement: in this case we will log when the star turns into a compact object, and then terminate the evolution.\n",
+    "custom_logging_statement = \"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 3\n",
+    "            stardata->model.probability, // 4\n",
+    "            stardata->star[0].stellar_type // 5\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "example_pop.set(\n",
+    "    C_logging_code=custom_logging_statement\n",
+    ")"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "ef5b51a1-e56d-4bec-a5c7-b9d5bceeceba",
+   "id": "ae1f1f0c-1f8b-42d8-b051-cbf8c6b51514",
    "metadata": {},
    "source": [
-    "Executing a single system\n",
-    "This uses the M_1 orbital period etc set with the set function"
+    "The parse function must now catch lines that start with \"EXAMPLE_COMPACT_OBJECT\", and write that line to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
-   "id": "c0a9aed7-1fc9-4fe3-8bcf-4e987bfc00a9",
+   "execution_count": 8,
+   "id": "fd197154-a8ce-4865-8929-008d3483101a",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating the code for the shared library for the custom logging\n",
-      "['2.773586668293e+01', '1.33526', '10', '1', '1.72498e-05', '13']\n",
-      "None\n"
+      "adding: parse_function=<function parse_function at 0x7ff3bdf79620> to grid_options\n"
      ]
     }
    ],
    "source": [
-    "output = example_pop.evolve_single()\n",
-    "print(output)"
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # get info from the population instance\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for line in output.splitlines():\n",
+    "        headerline = line.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_COMPACT_OBJECT\":\n",
+    "            values = line.split()[1:]\n",
+    "            print(line)\n",
+    "            \n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "# Add the parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,\n",
+    ")"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
-   "metadata": {
-    "tags": []
-   },
-   "outputs": [],
+   "cell_type": "markdown",
+   "id": "91509ce5-ffe7-4937-aa87-6d7baac9ac04",
+   "metadata": {},
    "source": [
-    "## Executing a population\n",
-    "## This uses the values generated by the grid_variables\n",
-    "example_pop.evolve()  # TODO: update this function call"
+    "## Evolving the grid\n",
+    "Now that we configured all the main parts of the population object, we can actually run the population! Doing this is straightforward: `example_pop.evolve()`\n",
+    "\n",
+    "This will start up the processing of all the systems. We can control how many cores are used by settings `amt_cores`. By setting the `verbosity` of the population object to a higher value we can get a lot of verbose information about the run, but for now we will set it to 0.\n",
+    "\n",
+    "There are many grid_options that can lead to different behaviour of the evolution of the grid. Please do have a look at those: [grid options docs](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html), and try  "
    ]
   },
   {
-   "cell_type": "markdown",
-   "id": "ce937b07-7292-4bb1-b2e7-d69e51bdff6e",
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
    "metadata": {
     "tags": []
    },
-   "source": [
-    "Wrapping up the results to an hdf5 file can be done by using the create_hdf5\n",
-    "(<directory containing data and settings>) This function takes the settings file\n",
-    "(ending in _settings.json) and the data files (ending in .dat) from the data_dir\n",
-    "and packing them into an hdf5 file, which is then written into the same data_dir directory"
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: verbosity=0 to grid_options\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "EXAMPLE_COMPACT_OBJECT             2.867655467480e+01 1.33079 9.81391 0.00167028 13\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "EXAMPLE_COMPACT_OBJECT             1.931266944719e+01 1.3933 12.3177 0.00124307 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.439623364590e+01 1.38004 7.81906 0.00224431 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.364277535630e+01 1.47961 15.4603 0.000925128 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.017435498578e+01 1.59052 19.4046 0.000688507 13\n",
+      "EXAMPLE_COMPACT_OBJECT             8.294870923827e+00 1.7197 24.3552 0.000512406 13\n",
+      "EXAMPLE_COMPACT_OBJECT             6.802132608769e+00 1.84162 30.5689 0.000381347 13\n",
+      "EXAMPLE_COMPACT_OBJECT             5.723570798020e+00 1.99471 38.3678 0.00028381 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.933751523833e+00 2.15875 48.1564 0.000211219 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.337250536639e+00 2.35209 60.4424 0.000157195 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.862081089332e+00 2.56776 75.8628 0.000116989 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.449960890183e+00 2.80457 95.2174 8.70668e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.172196856333e+00 3.05193 119.51 6.47976e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.069627290216e+00 3.27563 150 4.82242e-05 14\n",
+      "Population-2a7732d03e594ef4b5dfe9051b41d9c0 finished! The total probability was: 0.05150046619238191. It took a total of 0.7797017097473145s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# change verbosity\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "## Executing a population\n",
+    "## This uses the values generated by the grid_variables\n",
+    "analytics = example_pop.evolve()  # TODO: update this function call"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "91ab45c7-7d31-4543-aee4-127ab58e891f",
+   "metadata": {},
+   "source": [
+    "After the run is complete, some technical report on the run is returned. I stored that in `analytics`. As we can see below, this dictionary is like a status report of the evolution. Useful for e.g. debugging."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
-   "id": "ad444138-f854-4fdb-8e18-49e35ac9c7e2",
+   "execution_count": 10,
+   "id": "e1f0464b-0424-4022-b34b-5b744bc2c59d",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating /tmp/binary_c_python/example_python_population_result/example_pop.hdf5\n",
-      "Adding settings to HDF5 file\n",
-      "Adding data to HDF5 file\n"
+      "{'population_name': '2a7732d03e594ef4b5dfe9051b41d9c0', 'evolution_type': 'grid', 'failed_count': 0, 'failed_prob': 0, 'failed_systems_error_codes': [], 'errors_exceeded': False, 'errors_found': False, 'total_probability': 0.05150046619238191, 'total_count': 20, 'start_timestamp': 1628444120.234709, 'end_timestamp': 1628444121.0144107, 'total_mass_run': 730.1048014407228, 'total_probability_weighted_mass_run': 0.2983275843337705, 'zero_prob_stars_skipped': 0}\n"
      ]
     }
    ],
    "source": [
-    "create_hdf5(data_dir=example_pop.custom_options[\"data_dir\"], name=\"example_pop.hdf5\")\n"
+    "print(analytics)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6460df56-9fba-4817-9a1e-593ef15d98c1",
+   "metadata": {},
+   "source": [
+    "## Noteworthy functionality\n",
+    "Some extra features that are available from via the population object are:\n",
+    "- write_binary_c_calls_to_file: Function to write the calls that would be passed to binary_c to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "34da69bc-fe60-4a9d-b07a-f6cd2f216964",
+   "execution_count": 11,
+   "id": "83f8e519-4f7c-474a-ad95-f175a34fae81",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method write_binary_c_calls_to_file in module binarycpython.utils.grid:\n",
+      "\n",
+      "write_binary_c_calls_to_file(output_dir:Union[str, NoneType]=None, output_filename:Union[str, NoneType]=None, include_defaults:bool=False) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function that loops over the grid code and writes the generated parameters to a file.\n",
+      "    In the form of a command line call\n",
+      "    \n",
+      "    Only useful when you have a variable grid as system_generator. MC wouldn't be that useful\n",
+      "    \n",
+      "    Also, make sure that in this export there are the basic parameters\n",
+      "    like m1,m2,sep, orb-per, ecc, probability etc.\n",
+      "    \n",
+      "    On default this will write to the datadir, if it exists\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: test this function\n",
+      "        - TODO: make sure the binary_c_python .. output file has a unique name\n",
+      "    \n",
+      "    Args:\n",
+      "        output_dir: (optional, default = None) directory where to write the file to. If custom_options['data_dir'] is present, then that one will be used first, and then the output_dir\n",
+      "        output_filename: (optional, default = None) filename of the output. If not set it will be called \"binary_c_calls.txt\"\n",
+      "        include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.\n",
+      "    \n",
+      "    Returns:\n",
+      "        filename: filename that was used to write the calls to\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.write_binary_c_calls_to_file)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "dacfed75-dfe3-4afd-a0ff-a4be17746021",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Saving grid code to grid_options\n",
+      "Writing grid code to /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Loading grid code function from /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Grid code loaded\n",
+      "Writing binary_c calls to /tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "/tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "binary_c M_1 2.0 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.013208238029791246\n",
+      "binary_c M_1 2.5102526289471614 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.009829948023831718\n",
+      "binary_c M_1 3.1506841305680684 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.0073157281034221516\n",
+      "binary_c M_1 3.9545065608702976 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.005444573822104362\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(verbosity=10)\n",
+    "calls_filename = example_pop.write_binary_c_calls_to_file()\n",
+    "print(calls_filename)\n",
+    "\n",
+    "with open(calls_filename, 'r') as f:\n",
+    "    print('\\n'.join(f.read().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "60359eb1-4d0c-4d2d-8265-ec5171b944a2",
+   "metadata": {},
+   "source": [
+    "## Full examples of population scripts\n",
+    "Below is a full setup for a population of single stars"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "7212b6be-9787-4122-a7f1-86538cf38179",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Population-3680f3882c0a449c944462abffea2447 finished! The total probability was: 0.05150046619238191. It took a total of 0.6246354579925537s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass zams_mass probability radius stellar_type\n",
+      "2.867655467480e+01 1.33079 9.81391 0.00167028 1.72498e-05 13\n",
+      "1.931266944719e+01 1.3933 12.3177 0.00124307 1.72498e-05 13\n",
+      "4.439623364590e+01 1.38004 7.81906 0.00224431 1.72498e-05 13\n",
+      "1.364277535630e+01 1.47961 15.4603 0.000925128 1.72498e-05 13\n",
+      "1.017435498578e+01 1.59052 19.4046 0.000688507 1.72498e-05 13\n",
+      "8.294870923827e+00 1.7197 24.3552 0.000512406 1.72498e-05 13\n",
+      "6.802132608769e+00 1.84162 30.5689 0.000381347 1.72498e-05 13\n",
+      "5.723570798020e+00 1.99471 38.3678 0.00028381 1.72498e-05 13\n",
+      "4.933751523833e+00 2.15875 48.1564 0.000211219 1.72498e-05 13\n",
+      "4.337250536639e+00 2.35209 60.4424 0.000157195 9.97286e-06 14\n",
+      "3.862081089332e+00 2.56776 75.8628 0.000116989 1.08873e-05 14\n",
+      "3.449960890183e+00 2.80457 95.2174 8.70668e-05 1.18914e-05 14\n",
+      "3.172196856333e+00 3.05193 119.51 6.47976e-05 1.29402e-05 14\n",
+      "3.069627290216e+00 3.27563 150 4.82242e-05 1.38887e-05 14\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"MY_STELLAR_DATA\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 4\n",
+    "            stardata->model.probability, // 5\n",
+    "            stardata->star[0].radius, // 6\n",
+    "            stardata->star[0].stellar_type // 7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 20}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2ab0979-6575-481d-9c1c-ca98517b2437",
+   "metadata": {},
+   "source": [
+    "We can also set up a population that samples biinary systems, by adding extra grid variables. Below is an example of a full script that runs a binary population and registers when a double compact object is formed. The logging is rather compact and should be expanded top be more useful"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "79acdbb2-7dd6-45c4-9609-80994f03619a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Grid has handled 125 stars\n",
+      "with a total probability of 0.0862478164626921\n",
+      "Total starcount for this run will be: 125\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Population-d20a4c74d20a43b881c0c9e5def5f76c finished! The total probability was: 0.08624781646269201. It took a total of 8.561265707015991s to run 125 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass_1 zams_mass_1 mass_2 zams_mass_2 stellar_type_1 prev_stellar_type_1 stellar_type_2 prev_stellar_type_2 metallicity probability\n",
+      "8.863377990313e+01 1.29444 5.88566 0 2.99283 13 5 15 15 0.02 0.000627913\n",
+      "1.146421815741e+02 0 5.88566 1.33062 4.43925 15 15 13 5 0.02 0.000627913\n",
+      "7.222715508467e+01 1.34922 5.88566 0 5.88566 13 5 15 15 0.02 0.000627913\n",
+      "1.350021848285e+01 1.48488 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171108213270e+01 1.53113 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171086983243e+01 1.53177 17.3205 0 0.1 13 9 15 15 0.02 0.000154349\n",
+      "1.170770599495e+01 1.53176 17.3205 0 4.40513 13 5 15 15 0.02 0.000172877\n",
+      "1.230407246199e+01 1.59499 17.3205 0 4.40513 13 5 15 15 0.02 0.000610573\n",
+      "1.108751340926e+01 1.70319 17.3205 0 8.71025 13 4 15 15 0.02 0.000610573\n",
+      "1.941017702765e+01 1.34903 17.3205 1.65097 8.71025 13 13 13 5 0.02 0.000172877\n",
+      "1.980988739731e+01 1.36979 17.3205 1.60808 8.71025 13 13 13 5 0.02 0.000121486\n",
+      "3.571858031651e+01 1.53174 17.3205 1.30504 8.71025 13 13 13 5 0.02 8.42148e-05\n",
+      "3.459153942631e+01 1.53176 17.3205 1.31004 8.71025 13 13 13 5 0.02 9.8162e-05\n",
+      "1.687368550125e+01 1.34937 17.3205 1.73856 13.0154 13 13 13 8 0.02 0.000172877\n",
+      "1.194842917007e+01 1.78096 17.3205 0 13.0154 13 8 15 15 0.02 0.000610573\n",
+      "1.733614170983e+01 1.53184 17.3205 1.42375 13.0154 13 13 13 5 0.02 9.8162e-05\n",
+      "1.723547465714e+01 1.38403 17.3205 1.71288 13.0154 13 13 13 8 0.02 0.000121486\n",
+      "1.764340254985e+01 1.53174 17.3205 1.41264 13.0154 13 13 13 5 0.02 8.42148e-05\n",
+      "1.170425790780e+01 1.52963 17.3205 0 17.3205 13 5 15 15 0.02 0.000172877\n",
+      "8.922967341481e+00 1.85486 17.3205 0 17.3205 13 8 15 15 0.02 0.000610573\n",
+      "1.232906623449e+01 1.41074 17.3205 1.34281 17.3205 13 13 13 8 0.02 0.000121486\n",
+      "1.170775828562e+01 1.53183 17.3205 1.53183 17.3205 13 5 13 5 0.02 9.8162e-05\n",
+      "1.170770422321e+01 1.53175 17.3205 1.53175 17.3205 13 5 13 5 0.02 8.42148e-05\n",
+      "5.075844624794e+00 2.12303 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.766606588165e+00 2.20484 50.9713 0 0.1 14 8 15 15 0.02 3.79411e-05\n",
+      "4.768305081494e+00 2.18838 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.458869865939e+00 2.29864 50.9713 0 12.8178 14 8 15 15 0.02 0.000150087\n",
+      "1.806014211040e+01 2.10446 50.9713 1.40749 12.8178 13 13 13 5 0.02 2.9863e-05\n",
+      "4.797342083485e+00 2.10328 50.9713 0 12.8178 13 13 15 1 0.02 4.24954e-05\n",
+      "1.721374713429e+01 2.21673 50.9713 1.42212 12.8178 14 14 13 5 0.02 2.41295e-05\n",
+      "4.055645404546e+00 2.47276 50.9713 0 25.5357 14 7 15 15 0.02 0.000150087\n",
+      "1.806123543037e+01 2.21893 50.9713 1.40745 12.8178 14 14 13 5 0.02 2.07011e-05\n",
+      "8.117519147635e+00 2.10433 50.9713 2.21473 25.5357 13 13 14 8 0.02 4.24954e-05\n",
+      "8.315554923168e+00 2.15343 50.9713 2.08519 25.5357 13 13 13 8 0.02 2.9863e-05\n",
+      "7.917420996633e+00 2.21892 50.9713 1.7431 25.5357 14 14 13 8 0.02 2.07011e-05\n",
+      "7.693213405973e+00 2.21805 50.9713 1.78384 25.5357 14 14 13 8 0.02 2.41295e-05\n",
+      "3.753837732894e+00 2.62517 50.9713 0 38.2535 14 7 15 15 0.02 0.000150087\n",
+      "7.087296558990e+00 2.10417 50.9713 2.40935 38.2535 13 13 14 8 0.02 4.24954e-05\n",
+      "7.007109286263e+00 2.15854 50.9713 2.28672 38.2535 13 13 14 8 0.02 2.9863e-05\n",
+      "5.653200958306e+00 2.21878 50.9713 2.0587 38.2535 14 14 13 8 0.02 2.41295e-05\n",
+      "5.733794947644e+00 2.21892 50.9713 1.99255 38.2535 14 14 13 8 0.02 2.07011e-05\n",
+      "3.513216011269e+00 2.76647 50.9713 0 50.9713 14 7 15 15 0.02 0.000150087\n",
+      "4.750574783854e+00 2.27442 50.9713 0 50.9713 14 8 15 15 0.02 4.24954e-05\n",
+      "7.278384712062e+00 1.29678 50.9713 2.09216 50.9713 13 8 13 13 0.02 2.9863e-05\n",
+      "4.765996194699e+00 2.20787 50.9713 2.20787 50.9713 14 8 14 8 0.02 2.07011e-05\n",
+      "4.765535914728e+00 2.21331 50.9713 2.21331 50.9713 14 8 14 8 0.02 2.41295e-05\n",
+      "3.104706358826e+00 3.17639 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.069363482023e+00 3.27572 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.047074050271e+00 3.3836 150 0 37.575 14 7 15 15 0.02 3.68933e-05\n",
+      "5.974759306305e+00 3.23604 150 2.53922 37.575 14 14 14 7 0.02 1.04459e-05\n",
+      "6.074084349384e+00 3.30145 150 2.13876 37.575 14 14 13 8 0.02 7.34071e-06\n",
+      "5.733865371895e+00 3.29994 150 2.00498 37.575 14 14 13 8 0.02 5.93135e-06\n",
+      "3.027099358410e+00 3.53631 150 0 75.05 14 7 15 15 0.02 3.68933e-05\n",
+      "5.807147339697e+00 3.30197 150 1.9791 37.575 14 14 13 8 0.02 5.08861e-06\n",
+      "4.862942347290e+00 3.25294 150 2.97823 75.05 14 14 14 7 0.02 1.04459e-05\n",
+      "4.556479830908e+00 3.29942 150 2.73221 75.05 14 14 14 7 0.02 7.34071e-06\n",
+      "3.853070305680e+00 3.29977 150 2.62486 75.05 14 14 14 7 0.02 5.93135e-06\n",
+      "3.881529045940e+00 3.30149 150 2.55924 75.05 14 14 14 7 0.02 5.08861e-06\n",
+      "3.015033359333e+00 3.64419 150 0 112.525 14 7 15 15 0.02 3.68933e-05\n",
+      "4.126828648362e+00 3.32047 150 0 112.525 14 14 15 3 0.02 1.04459e-05\n",
+      "3.990017992944e+00 3.3032 150 2.94027 112.525 14 14 14 7 0.02 7.34071e-06\n",
+      "3.206771867883e+00 3.07671 150 3.11282 112.525 14 14 14 7 0.02 5.93135e-06\n",
+      "3.006827156705e+00 3.72638 150 0 150 14 7 15 15 0.02 3.68933e-05\n",
+      "3.218786094847e+00 3.30337 150 3.01344 112.525 14 14 14 7 0.02 5.08861e-06\n",
+      "4.527722847382e+00 1.42238 150 0 150 13 5 15 15 0.02 1.04459e-05\n",
+      "3.069567332611e+00 3.27804 150 3.27804 150 14 7 14 7 0.02 5.93135e-06\n",
+      "5.726405299909e+00 1.29746 150 3.22759 150 13 8 14 14 0.02 7.34071e-06\n",
+      "3.069626478211e+00 3.27565 150 3.27565 150 14 7 14 7 0.02 5.08861e-06\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\n",
+    "        \"time\", \n",
+    "        \"mass_1\", \"zams_mass_1\", \"mass_2\", \"zams_mass_2\",\n",
+    "        \"stellar_type_1\", \"prev_stellar_type_1\", \"stellar_type_2\", \"prev_stellar_type_2\", \n",
+    "        \"metallicity\", \"probability\"\n",
+    "    ]\n",
+    "    \n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_DCO\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "// logger to find gravitational wave progenitors\n",
+    "if(stardata->star[0].stellar_type>=NS && stardata->star[1].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_DCO %30.12e \" // 1\n",
+    "            \"%g %g %g %g \" // 2-5\n",
+    "            \"%d %d %d %d \" // 6-9\n",
+    "            \"%g %g\\\\n\", // 10-11\n",
+    "\n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->common.zero_age.mass[0], //3\n",
+    "            stardata->star[1].mass, //4\n",
+    "            stardata->common.zero_age.mass[1], //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "            stardata->star[1].stellar_type, //8\n",
+    "            stardata->previous_stardata->star[1].stellar_type, //9\n",
+    "\n",
+    "            // model stuff\n",
+    "            stardata->common.metallicity, //10\n",
+    "            stardata->model.probability //11\n",
+    "        );\n",
+    "    }\n",
+    "    /* Kill the simulation to safe time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "}\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 5, \"q\": 5, \"per\": 5}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "# Mass ratio\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"q\",\n",
+    "    longname=\"Mass ratio\",\n",
+    "    valuerange=[\"0.1/M_1\", 1],\n",
+    "    resolution=\"{}\".format(resolution['q']),\n",
+    "    spacingfunc=\"const(0.1/M_1, 1, {})\".format(resolution['q']),\n",
+    "    probdist=\"flatsections(q, [{'min': 0.1/M_1, 'max': 1.0, 'height': 1}])\",\n",
+    "    dphasevol=\"dq\",\n",
+    "    precode=\"M_2 = q * M_1\",\n",
+    "    parameter_name=\"M_2\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "example_pop.add_grid_variable(\n",
+    "   name=\"log10per\", # in days\n",
+    "   longname=\"log10(Orbital_Period)\",\n",
+    "   valuerange=[0.15, 5.5],\n",
+    "   resolution=\"{}\".format(resolution[\"per\"]),\n",
+    "   spacingfunc=\"const(0.15, 5.5, {})\".format(resolution[\"per\"]),\n",
+    "   precode=\"\"\"orbital_period = 10** log10per\n",
+    "sep = calc_sep_from_period(M_1, M_2, orbital_period)\n",
+    "sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)\n",
+    "sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)\"\"\",\n",
+    "   probdist=\"sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)\",\n",
+    "   parameter_name=\"orbital_period\",\n",
+    "   dphasevol=\"dlog10per\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
   }
  ],
  "metadata": {
diff --git a/docs/build/html/_sources/notebooks.rst.txt b/docs/build/html/_sources/notebooks.rst.txt
deleted file mode 100644
index 8002bcb2b..000000000
--- a/docs/build/html/_sources/notebooks.rst.txt
+++ /dev/null
@@ -1,10 +0,0 @@
-Notebooks
-=========
-The notebooks.
-
-
-.. toctree::
-    :maxdepth: 2
-    :caption: Contents:
-
-    notebook_population.ipynb
diff --git a/docs/build/html/_sources/population_example.rst.txt b/docs/build/html/_sources/population_example.rst.txt
deleted file mode 100644
index 192372d01..000000000
--- a/docs/build/html/_sources/population_example.rst.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-Example of population script
-============================
-The source code of a script to run a population of stars. 
-
-.. literalinclude:: ../../examples/example_population.py
-    :language: python
-    :linenos:
\ No newline at end of file
diff --git a/docs/build/html/binary_c_parameters.html b/docs/build/html/binary_c_parameters.html
index d76fcd537..afc5c2ce7 100644
--- a/docs/build/html/binary_c_parameters.html
+++ b/docs/build/html/binary_c_parameters.html
@@ -40,7 +40,7 @@
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
     <link rel="next" title="Population grid code options" href="grid_options_descriptions.html" />
-    <link rel="prev" title="Title page" href="notebook_population.html" /> 
+    <link rel="prev" title="Using the API functionality of binarycpython" href="notebook_api_functionality.html" /> 
 </head>
 
 <body class="wy-body-for-nav">
@@ -89,7 +89,7 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Binary_c parameters</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="#section-stars">Section: stars</a></li>
 <li class="toctree-l2"><a class="reference internal" href="#section-binary">Section: binary</a></li>
@@ -197,7 +197,7 @@
 <h1>Binary_c parameters<a class="headerlink" href="#binary-c-parameters" title="Permalink to this headline">¶</a></h1>
 <p>The following chapter contains all the parameters that the current version of binary_c can handle, along with their descriptions and other properties.</p>
 <dl class="simple">
-<dt>This information was obtained by the following binary_c build:</dt><dd><p><strong>binary_c git branch</strong>: branch_david   <strong>binary_c git revision</strong>: 6068:20210727:8955b541d      <strong>Built on</strong>: Jul 27 2021 22:36:46</p>
+<dt>This information was obtained by the following binary_c build:</dt><dd><p><strong>binary_c git branch</strong>: branch_david   <strong>binary_c git revision</strong>: 6101:20210807:c5232be5c      <strong>Built on</strong>: Aug  7 2021 17:32:06</p>
 </dd>
 </dl>
 <div class="section" id="section-stars">
@@ -3460,7 +3460,7 @@
         <a href="grid_options_descriptions.html" class="btn btn-neutral float-right" title="Population grid code options" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
       
       
-        <a href="notebook_population.html" class="btn btn-neutral float-left" title="Title page" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+        <a href="notebook_api_functionality.html" class="btn btn-neutral float-left" title="Using the API functionality of binarycpython" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
       
     </div>
   
@@ -3483,9 +3483,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/custom_logging_functions.html b/docs/build/html/custom_logging_functions.html
index 40bf0c78f..ab21c5903 100644
--- a/docs/build/html/custom_logging_functions.html
+++ b/docs/build/html/custom_logging_functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -204,7 +204,7 @@
 The functions here make it possible for the user to define binaryc output logs on runtime</p>
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.autogen_C_logging_code">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">autogen_C_logging_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">logging_dict</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#autogen_C_logging_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.autogen_C_logging_code" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">autogen_C_logging_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">logging_dict</span></em>, <em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#autogen_C_logging_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.autogen_C_logging_code" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function that auto-generates PRINTF statements for binaryc.
 Input is a dictionary where the key is the header of that logging line
 and items which are lists of parameters that will be put in that logging line</p>
@@ -225,7 +225,7 @@ and items which are lists of parameters that will be put in that logging line</p
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>logging_dict</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">dict</span></code>) – Dictionary containing lists of parameters that binary_c has to output. The keys are used by binary_c as start of the sentence.</p></li>
-<li><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
+<li><p><strong>verbose</strong> – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type</dt>
@@ -239,7 +239,7 @@ and items which are lists of parameters that will be put in that logging line</p
 
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.binary_c_log_code">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">binary_c_log_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#binary_c_log_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.binary_c_log_code" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">binary_c_log_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#binary_c_log_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.binary_c_log_code" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function to construct the code to construct the custom logging function</p>
 <p class="rubric">Example</p>
 <p>Code to log and terminate evolution when the primary star becomes a NS:</p>
@@ -270,7 +270,7 @@ and items which are lists of parameters that will be put in that logging line</p
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>code</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Exact c-statement to output information in binary_c. Can be wrapped in logical statements.</p></li>
-<li><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
+<li><p><strong>verbosity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type</dt>
@@ -284,14 +284,14 @@ and items which are lists of parameters that will be put in that logging line</p
 
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.binary_c_write_log_code">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">binary_c_write_log_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">filename</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#binary_c_write_log_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.binary_c_write_log_code" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">binary_c_write_log_code</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">filename</span></em>, <em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#binary_c_write_log_code"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.binary_c_write_log_code" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function to write the generated logging code to a file</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>code</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – string containing the custom logging code to write to a file.</p></li>
 <li><p><strong>filename</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – target filename.</p></li>
-<li><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
+<li><p><strong>verbosity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type</dt>
@@ -302,7 +302,7 @@ and items which are lists of parameters that will be put in that logging line</p
 
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.compile_shared_lib">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">compile_shared_lib</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">sourcefile_name</span></em>, <em class="sig-param"><span class="n">outfile_name</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#compile_shared_lib"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.compile_shared_lib" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">compile_shared_lib</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">code</span></em>, <em class="sig-param"><span class="n">sourcefile_name</span></em>, <em class="sig-param"><span class="n">outfile_name</span></em>, <em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#compile_shared_lib"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.compile_shared_lib" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function to write the custom logging code to a file and then compile it.</p>
 <p>TODO: nicely put in the -fPIC
 TODO: consider returning a status</p>
@@ -312,7 +312,7 @@ TODO: consider returning a status</p>
 <li><p><strong>code</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – string containing the custom logging code</p></li>
 <li><p><strong>sourcefile_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – name of the file that will contain the code</p></li>
 <li><p><strong>outfile_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – name of the file that will be the shared library</p></li>
-<li><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
+<li><p><strong>verbosity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type</dt>
@@ -323,7 +323,7 @@ TODO: consider returning a status</p>
 
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.create_and_load_logging_function">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">create_and_load_logging_function</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">custom_logging_code</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em>, <em class="sig-param"><span class="n">custom_tmp_dir</span><span class="o">=</span><span class="default_value">None</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#create_and_load_logging_function"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.create_and_load_logging_function" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">create_and_load_logging_function</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">custom_logging_code</span></em>, <em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em>, <em class="sig-param"><span class="n">custom_tmp_dir</span><span class="o">=</span><span class="default_value">None</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#create_and_load_logging_function"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.create_and_load_logging_function" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function to automatically compile the shared library with the given
 custom logging code and load it with ctypes.</p>
 <p>This function is more or less the main function of this module and unless you know what you’re doing with the other functions
@@ -332,7 +332,7 @@ I recommend using this in function in combination with a function that generates
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>custom_logging_code</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – string containing the custom logging code</p></li>
-<li><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
+<li><p><strong>verbosity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type</dt>
@@ -366,14 +366,14 @@ I recommend using this in function in combination with a function that generates
 
 <dl class="py function">
 <dt id="binarycpython.utils.custom_logging_functions.return_compilation_dict">
-<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">return_compilation_dict</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#return_compilation_dict"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.return_compilation_dict" title="Permalink to this definition">¶</a></dt>
+<code class="sig-prename descclassname">binarycpython.utils.custom_logging_functions.</code><code class="sig-name descname">return_compilation_dict</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">verbosity</span><span class="o">=</span><span class="default_value">0</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/custom_logging_functions.html#return_compilation_dict"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.custom_logging_functions.return_compilation_dict" title="Permalink to this definition">¶</a></dt>
 <dd><p>Function to build the compile command for the shared library</p>
 <p>Inspired by binary_c_inline_config command in Perl</p>
 <p>TODO: this function still has some cleaning up to do w.r.t. default values for the compile command
 # <a class="reference external" href="https://developers.redhat.com/blog/2018/03/21/compiler-and-linker-flags-gcc/">https://developers.redhat.com/blog/2018/03/21/compiler-and-linker-flags-gcc/</a></p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
-<dd class="field-odd"><p><strong>verbose</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p>
+<dd class="field-odd"><p><strong>verbosity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>) – Level of verbosity. Defaults to zero if not set explicitly.</p>
 </dd>
 <dt class="field-even">Return type</dt>
 <dd class="field-even"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">dict</span></code></p>
@@ -420,9 +420,9 @@ I recommend using this in function in combination with a function that generates
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/distribution_functions.html b/docs/build/html/distribution_functions.html
index 0261d69ff..7f5ad7906 100644
--- a/docs/build/html/distribution_functions.html
+++ b/docs/build/html/distribution_functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -911,9 +911,9 @@ and is be given by dp/dlogP ~ (logP)^p for all other binary configurations (defa
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/examples.html b/docs/build/html/example_notebooks.html
similarity index 57%
rename from docs/build/html/examples.html
rename to docs/build/html/example_notebooks.html
index 75ebcda6b..e089e2876 100644
--- a/docs/build/html/examples.html
+++ b/docs/build/html/example_notebooks.html
@@ -7,7 +7,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Examples &mdash; binary_c-python  documentation</title>
+  <title>Example notebooks &mdash; binary_c-python  documentation</title>
   
 
   
@@ -39,7 +39,7 @@
     
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Examples" href="general_examples.html" />
+    <link rel="next" title="Running individual systems with binarycpython" href="notebook_individual_systems.html" />
     <link rel="prev" title="useful_funcs module" href="useful_funcs.html" /> 
 </head>
 
@@ -89,10 +89,12 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Examples</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="general_examples.html">Examples</a></li>
-<li class="toctree-l2"><a class="reference internal" href="population_example.html">Example of population script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="notebooks.html">Notebooks</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Example notebooks</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
@@ -145,13 +147,13 @@
     
       <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
         
-      <li>Examples</li>
+      <li>Example notebooks</li>
     
     
       <li class="wy-breadcrumbs-aside">
         
             
-            <a href="_sources/examples.rst.txt" rel="nofollow"> View page source</a>
+            <a href="_sources/example_notebooks.rst.txt" rel="nofollow"> View page source</a>
           
         
       </li>
@@ -188,10 +190,39 @@
     text-align: unset;
 }
 </style>
-<div class="section" id="examples">
-<h1>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h1>
-<p>This chapter contains the source code of example scripts which show the way of using certain functions</p>
+<div class="section" id="example-notebooks">
+<h1>Example notebooks<a class="headerlink" href="#example-notebooks" title="Permalink to this headline">¶</a></h1>
+<p>We have a set of notebooks that explain and show the usage of the binarycpython features. The notebooks are also stored in the examples/ directory in the <a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/master/examples">repository</a></p>
+<p>The order of the notebooks below is more or less the recommended order to read.</p>
 <div class="toctree-wrapper compound">
+<p class="caption"><span class="caption-text">Contents:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html#Single-system-with-run_wrapper">Single system with run_wrapper</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html#Single-system-via-population-object">Single system via population object</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html#Single-system-via-API-functionality">Single system via API functionality</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html#Usage">Usage</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html#Examples-of-logging-strings">Examples of logging strings</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Setting-up-the-Population-object">Setting up the Population object</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Adding-grid-variables">Adding grid variables</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Setting-logging-and-handling-the-output">Setting logging and handling the output</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Evolving-the-grid">Evolving the grid</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Noteworthy-functionality">Noteworthy functionality</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html#Full-examples-of-population-scripts">Full examples of population scripts</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l1"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html#Example-usage:">Example usage:</a></li>
+</ul>
+</li>
+</ul>
 </div>
 </div>
 
@@ -203,7 +234,7 @@
   
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
       
-        <a href="general_examples.html" class="btn btn-neutral float-right" title="Examples" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="notebook_individual_systems.html" class="btn btn-neutral float-right" title="Running individual systems with binarycpython" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
       
       
         <a href="useful_funcs.html" class="btn btn-neutral float-left" title="useful_funcs module" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -229,9 +260,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/functions.html b/docs/build/html/functions.html
index 995bd180d..6fb57785b 100644
--- a/docs/build/html/functions.html
+++ b/docs/build/html/functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -975,9 +975,9 @@ of all the binary_c parameters.</p>
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/general_examples.html b/docs/build/html/general_examples.html
deleted file mode 100644
index c574cef1c..000000000
--- a/docs/build/html/general_examples.html
+++ /dev/null
@@ -1,719 +0,0 @@
-
-
-<!DOCTYPE html>
-<html class="writer-html5" lang="en" >
-<head>
-  <meta charset="utf-8">
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <title>Examples &mdash; binary_c-python  documentation</title>
-  
-
-  
-  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
-  
-  
-  
-  
-
-  
-  <!--[if lt IE 9]>
-    <script src="_static/js/html5shiv.min.js"></script>
-  <![endif]-->
-  
-    
-      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
-        <script src="_static/jquery.js"></script>
-        <script src="_static/underscore.js"></script>
-        <script src="_static/doctools.js"></script>
-        <script src="_static/language_data.js"></script>
-        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
-        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
-    
-    <script type="text/javascript" src="_static/js/theme.js"></script>
-
-    
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Example of population script" href="population_example.html" />
-    <link rel="prev" title="Examples" href="examples.html" /> 
-</head>
-
-<body class="wy-body-for-nav">
-
-   
-  <div class="wy-grid-for-nav">
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
-      <div class="wy-side-scroll">
-        <div class="wy-side-nav-search" >
-          
-
-          
-            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
-          
-
-          
-          </a>
-
-          
-            
-            
-          
-
-          
-<div role="search">
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
-    <input type="text" name="q" placeholder="Search docs" />
-    <input type="hidden" name="check_keywords" value="yes" />
-    <input type="hidden" name="area" value="default" />
-  </form>
-</div>
-
-          
-        </div>
-
-        
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
-<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Examples</a></li>
-<li class="toctree-l2"><a class="reference internal" href="population_example.html">Example of population script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="notebooks.html">Notebooks</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
-</ul>
-
-            
-          
-        </div>
-        
-      </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" aria-label="top navigation">
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href="index.html">binary_c-python</a>
-        
-      </nav>
-
-
-      <div class="wy-nav-content">
-        
-        <div class="rst-content">
-        
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<div role="navigation" aria-label="breadcrumbs navigation">
-
-  <ul class="wy-breadcrumbs">
-    
-      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
-        
-          <li><a href="examples.html">Examples</a> &raquo;</li>
-        
-      <li>Examples</li>
-    
-    
-      <li class="wy-breadcrumbs-aside">
-        
-            
-            <a href="_sources/general_examples.rst.txt" rel="nofollow"> View page source</a>
-          
-        
-      </li>
-    
-  </ul>
-
-  
-  <hr/>
-</div>
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-           <div itemprop="articleBody">
-            
-  
-<style>
-/* CSS overrides for sphinx_rtd_theme */
-
-/* 24px margin */
-.nbinput.nblast.container,
-.nboutput.nblast.container {
-    margin-bottom: 19px;  /* padding has already 5px */
-}
-
-/* ... except between code cells! */
-.nblast.container + .nbinput.container {
-    margin-top: -19px;
-}
-
-.admonition > p:before {
-    margin-right: 4px;  /* make room for the exclamation icon */
-}
-
-/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
-.math {
-    text-align: unset;
-}
-</style>
-<div class="section" id="examples">
-<h1>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h1>
-<p>The source code of the general examples.</p>
-<div class="highlight-python notranslate"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>  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
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
-100
-101
-102
-103
-104
-105
-106
-107
-108
-109
-110
-111
-112
-113
-114
-115
-116
-117
-118
-119
-120
-121
-122
-123
-124
-125
-126
-127
-128
-129
-130
-131
-132
-133
-134
-135
-136
-137
-138
-139
-140
-141
-142
-143
-144
-145
-146
-147
-148
-149
-150
-151
-152
-153
-154
-155
-156
-157
-158
-159
-160
-161
-162
-163
-164
-165
-166
-167
-168
-169
-170
-171
-172
-173
-174
-175
-176
-177
-178
-179
-180
-181
-182
-183
-184
-185
-186
-187
-188
-189
-190
-191
-192
-193
-194
-195
-196
-197
-198
-199
-200
-201
-202
-203
-204
-205
-206
-207
-208
-209
-210
-211
-212
-213
-214
-215
-216
-217
-218
-219
-220
-221
-222
-223
-224
-225
-226
-227
-228
-229</pre></div></td><td class="code"><div class="highlight"><pre><span></span><span class="ch">#!/usr/bin/python3</span>
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">sys</span>
-
-<span class="kn">from</span> <span class="nn">binarycpython</span> <span class="kn">import</span> <span class="n">_binary_c_bindings</span>
-
-<span class="kn">from</span> <span class="nn">binarycpython.utils.functions</span> <span class="kn">import</span> <span class="n">example_parse_output</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">autogen_C_logging_code</span><span class="p">,</span>
-    <span class="n">binary_c_log_code</span><span class="p">,</span>
-    <span class="n">create_and_load_logging_function</span><span class="p">,</span>
-<span class="p">)</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.run_system_wrapper</span> <span class="kn">import</span> <span class="n">run_system</span>
-
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">Very basic scripts to run a binary system and print the output.</span>
-
-<span class="sd">Use these as inspiration/base.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-
-<span class="k">def</span> <span class="nf">run_example_binary</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Function to run a binary system. Very basic approach which directly adresses the run_system(..) python-c wrapper function.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">m1</span> <span class="o">=</span> <span class="mf">15.0</span>  <span class="c1"># Msun</span>
-    <span class="n">m2</span> <span class="o">=</span> <span class="mf">14.0</span>  <span class="c1"># Msun</span>
-    <span class="n">separation</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># 0 = ignored, use period</span>
-    <span class="n">orbital_period</span> <span class="o">=</span> <span class="mf">4530.0</span>  <span class="c1"># days</span>
-    <span class="n">eccentricity</span> <span class="o">=</span> <span class="mf">0.0</span>
-    <span class="n">metallicity</span> <span class="o">=</span> <span class="mf">0.02</span>
-    <span class="n">max_evolution_time</span> <span class="o">=</span> <span class="mi">15000</span>  <span class="c1"># Myr. You need to include this argument.</span>
-
-    <span class="c1">#</span>
-    <span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;binary_c M_1 </span><span class="si">{m1}</span><span class="s2"> M_2 </span><span class="si">{m2}</span><span class="s2"> separation </span><span class="si">{separation}</span><span class="s2"> orbital_period </span><span class="si">{orbital_period}</span><span class="s2"> </span><span class="se">\</span>
-<span class="s2">        eccentricity </span><span class="si">{eccentricity}</span><span class="s2"> metallicity </span><span class="si">{metallicity}</span><span class="s2"> </span><span class="se">\</span>
-<span class="s2">        max_evolution_time </span><span class="si">{max_evolution_time}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-        <span class="n">m1</span><span class="o">=</span><span class="n">m1</span><span class="p">,</span>
-        <span class="n">m2</span><span class="o">=</span><span class="n">m2</span><span class="p">,</span>
-        <span class="n">separation</span><span class="o">=</span><span class="n">separation</span><span class="p">,</span>
-        <span class="n">orbital_period</span><span class="o">=</span><span class="n">orbital_period</span><span class="p">,</span>
-        <span class="n">eccentricity</span><span class="o">=</span><span class="n">eccentricity</span><span class="p">,</span>
-        <span class="n">metallicity</span><span class="o">=</span><span class="n">metallicity</span><span class="p">,</span>
-        <span class="n">max_evolution_time</span><span class="o">=</span><span class="n">max_evolution_time</span><span class="p">,</span>
-    <span class="p">)</span>
-    <span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">run_system</span><span class="p">(</span><span class="n">argstring</span><span class="p">)</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
-
-
-<span class="n">run_example_binary</span><span class="p">()</span>
-
-
-<span class="k">def</span> <span class="nf">run_example_binary_with_run_system</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    This function serves as an example on the function run_system and parse_output.</span>
-<span class="sd">    There is more functionality with this method and several tasks are done behind the scene.</span>
-
-<span class="sd">    Requires pandas, numpy to run.</span>
-
-<span class="sd">    run_system: mostly just makes passing arguments to the function easier. It also loads all the necessary defaults in the background</span>
-<span class="sd">    parse_output: Takes the raw output of binary_c and selects those lines that start with the given header.</span>
-<span class="sd">    Note, if you dont use the custom_logging functionality binary_c should be configured to have output that starts with that given header</span>
-
-<span class="sd">    The parsing of the output only works correctly if either all of the values are described inline like `mass=&lt;number&gt;&#39; or none of them are.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
-    <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-
-    <span class="c1"># Run system. all arguments can be given as optional arguments.</span>
-    <span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span> <span class="n">M_2</span><span class="o">=</span><span class="mi">20</span><span class="p">,</span> <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">orbital_period</span><span class="o">=</span><span class="mi">100000000000</span><span class="p">)</span>
-
-    <span class="c1"># print(output)</span>
-
-    <span class="c1"># Catch results that start with a given header. (Mind that binary_c has to be configured to print them if your not using a custom logging function)</span>
-    <span class="n">result_example_header_1</span> <span class="o">=</span> <span class="n">example_parse_output</span><span class="p">(</span>
-        <span class="n">output</span><span class="p">,</span> <span class="n">selected_header</span><span class="o">=</span><span class="s2">&quot;example_header_1&quot;</span>
-    <span class="p">)</span>
-    <span class="n">result_example_header_2</span> <span class="o">=</span> <span class="n">example_parse_output</span><span class="p">(</span>
-        <span class="n">output</span><span class="p">,</span> <span class="n">selected_header</span><span class="o">=</span><span class="s2">&quot;example_header_2&quot;</span>
-    <span class="p">)</span>
-
-    <span class="c1"># print(result_example_header_1)</span>
-
-    <span class="c1">#### Now do whatever you want with it:</span>
-    <span class="c1"># Put it in numpy arrays</span>
-    <span class="c1"># t_res = np.asarray(result_example_header[&#39;t&#39;], dtype=np.float64, order=&#39;C&#39;)</span>
-    <span class="c1"># m_res = np.asarray(result_example_header[&#39;mass&#39;], dtype=np.float64, order=&#39;C&#39;)</span>
-
-    <span class="c1"># Or put them into a pandas array</span>
-
-    <span class="c1"># Cast the data into a dataframe.</span>
-    <span class="c1"># This example automatically catches the column names because the binary_c output line is constructed as &#39;example_header_1 time=&lt;number&gt;..&#39;</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">result_example_header_1</span><span class="p">)</span>
-    <span class="n">df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span><span class="n">result_example_header_1</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">float64</span><span class="p">)</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">df</span><span class="p">)</span>
-
-    <span class="c1"># This example has column headers which are numbered, but we can override that with custom headers.</span>
-    <span class="n">df2</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span><span class="n">result_example_header_2</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">float64</span><span class="p">)</span>
-    <span class="n">df2</span><span class="o">.</span><span class="n">columns</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;mass_1&quot;</span><span class="p">,</span> <span class="s2">&quot;mass_2&quot;</span><span class="p">,</span> <span class="s2">&quot;st1&quot;</span><span class="p">,</span> <span class="s2">&quot;st2&quot;</span><span class="p">,</span> <span class="s2">&quot;sep&quot;</span><span class="p">,</span> <span class="s2">&quot;ecc&quot;</span><span class="p">]</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">df2</span><span class="p">)</span>
-
-    <span class="c1"># print(df)</span>
-    <span class="c1"># sliced_df = df[df.t &lt; 1000] # Cut off late parts of evolution</span>
-    <span class="c1"># print(sliced_df[[&quot;t&quot;,&quot;m1&quot;]])</span>
-
-    <span class="c1"># Some routine to plot.</span>
-
-
-<span class="c1"># run_example_binary_with_run_system()</span>
-
-
-<span class="k">def</span> <span class="nf">run_example_custom_logging_autogenerated</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    This is an example function for the autogeneration of logging codes that binary_c uses.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1"># generate logging lines</span>
-    <span class="n">logging_line</span> <span class="o">=</span> <span class="n">autogen_C_logging_code</span><span class="p">(</span>
-        <span class="p">{</span>
-            <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;model.time&quot;</span><span class="p">,</span> <span class="s2">&quot;star[0].mass&quot;</span><span class="p">],</span>
-            <span class="s2">&quot;my_sss2&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;model.time&quot;</span><span class="p">,</span> <span class="s2">&quot;star[1].mass&quot;</span><span class="p">],</span>
-        <span class="p">}</span>
-    <span class="p">)</span>
-
-    <span class="c1"># Generate code around logging lines</span>
-    <span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
-
-    <span class="c1"># Generate library and get memaddr</span>
-    <span class="n">func_memaddr</span><span class="p">,</span> <span class="n">shared_lib_filename</span> <span class="o">=</span> <span class="n">create_and_load_logging_function</span><span class="p">(</span>
-        <span class="n">custom_logging_code</span>
-    <span class="p">)</span>
-
-    <span class="c1">#</span>
-    <span class="n">m1</span> <span class="o">=</span> <span class="mf">15.0</span>  <span class="c1"># Msun</span>
-    <span class="n">m2</span> <span class="o">=</span> <span class="mf">14.0</span>  <span class="c1"># Msun</span>
-    <span class="n">separation</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># 0 = ignored, use period</span>
-    <span class="n">orbital_period</span> <span class="o">=</span> <span class="mf">4530.0</span>  <span class="c1"># days</span>
-    <span class="n">eccentricity</span> <span class="o">=</span> <span class="mf">0.0</span>
-    <span class="n">metallicity</span> <span class="o">=</span> <span class="mf">0.02</span>
-    <span class="n">max_evolution_time</span> <span class="o">=</span> <span class="mi">15000</span>
-    <span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;binary_c M_1 </span><span class="si">{0:g}</span><span class="s2"> M_2 </span><span class="si">{1:g}</span><span class="s2"> separation </span><span class="si">{2:g}</span><span class="s2"> orbital_period </span><span class="si">{3:g}</span><span class="s2"> eccentricity </span><span class="si">{4:g}</span><span class="s2"> metallicity </span><span class="si">{5:g}</span><span class="s2"> max_evolution_time </span><span class="si">{6:g}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-        <span class="n">m1</span><span class="p">,</span>
-        <span class="n">m2</span><span class="p">,</span>
-        <span class="n">separation</span><span class="p">,</span>
-        <span class="n">orbital_period</span><span class="p">,</span>
-        <span class="n">eccentricity</span><span class="p">,</span>
-        <span class="n">metallicity</span><span class="p">,</span>
-        <span class="n">max_evolution_time</span><span class="p">,</span>
-    <span class="p">)</span>
-    <span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">run_system</span><span class="p">(</span>
-        <span class="n">argstring</span><span class="p">,</span> <span class="n">custom_logging_func_memaddr</span><span class="o">=</span><span class="n">func_memaddr</span>
-    <span class="p">)</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
-
-
-<span class="c1"># run_example_custom_logging_autogenerated()</span>
-
-
-<span class="k">def</span> <span class="nf">run_example_binary_with_custom_logging</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Function that will use a automatically generated piece of logging code. Compile it, load it</span>
-<span class="sd">    into memory and run a binary system. See run_system on how several things are done in the background here.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
-    <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-
-    <span class="c1"># generate logging lines. Here you can choose whatever you want to have logged, and with what header</span>
-    <span class="c1"># this generates working print statements</span>
-    <span class="n">logging_line</span> <span class="o">=</span> <span class="n">autogen_C_logging_code</span><span class="p">(</span>
-        <span class="p">{</span>
-            <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;model.time&quot;</span><span class="p">,</span> <span class="s2">&quot;star[0].mass&quot;</span><span class="p">],</span>
-        <span class="p">}</span>
-    <span class="p">)</span>
-    <span class="c1"># OR</span>
-    <span class="c1"># You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.</span>
-    <span class="n">logging_line</span> <span class="o">=</span> <span class="s1">&#39;Printf(&quot;MY_STELLAR_DATA time=</span><span class="si">%g</span><span class="s1"> mass=</span><span class="si">%g</span><span class="se">\\</span><span class="s1">n&quot;, stardata-&gt;model.time, stardata-&gt;star[0].mass)&#39;</span>
-
-    <span class="c1"># Generate entire shared lib code around logging lines</span>
-    <span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
-
-    <span class="c1"># Run system. all arguments can be given as optional arguments. the custom_logging_code is one of them and will be processed automatically.</span>
-    <span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span>
-        <span class="n">M_1</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
-        <span class="n">metallicity</span><span class="o">=</span><span class="mf">0.002</span><span class="p">,</span>
-        <span class="n">M_2</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span>
-        <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
-        <span class="n">orbital_period</span><span class="o">=</span><span class="mi">100000000000</span><span class="p">,</span>
-        <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">,</span>
-    <span class="p">)</span>
-
-    <span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
-
-    <span class="c1"># Catch results that start with a given header. (Mind that binary_c has to be configured to print them if your not using a custom logging function)</span>
-    <span class="c1"># DOESNT WORK YET if you have the line autogenerated.</span>
-    <span class="n">result_example_header</span> <span class="o">=</span> <span class="n">parse_output</span><span class="p">(</span><span class="n">output</span><span class="p">,</span> <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">)</span>
-
-    <span class="c1"># Cast the data into a dataframe.</span>
-    <span class="n">df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span><span class="n">result_example_header</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">float64</span><span class="p">)</span>
-
-    <span class="c1"># Do whatever you like with the dataframe.</span>
-    <span class="nb">print</span><span class="p">(</span><span class="n">df</span><span class="p">)</span>
-
-
-<span class="c1"># run_example_binary_with_custom_logging()</span>
-
-
-<span class="k">def</span> <span class="nf">run_example_binary_with_writing_logfile</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Same as above but when giving the log_filename argument the log filename will be written</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
-    <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-    <span class="kn">import</span> <span class="nn">tempfile</span>
-
-    <span class="c1"># Run system. all arguments can be given as optional arguments.</span>
-    <span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span>
-        <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
-        <span class="n">M_2</span><span class="o">=</span><span class="mi">20</span><span class="p">,</span>
-        <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
-        <span class="n">orbital_period</span><span class="o">=</span><span class="mi">100000000000</span><span class="p">,</span>
-        <span class="n">log_filename</span><span class="o">=</span><span class="n">tempfile</span><span class="o">.</span><span class="n">gettempdir</span><span class="p">()</span> <span class="o">+</span> <span class="s2">&quot;/test_log.txt&quot;</span><span class="p">,</span>
-    <span class="p">)</span>
-
-
-<span class="n">run_example_binary_with_writing_logfile</span><span class="p">()</span>
-</pre></div>
-</td></tr></table></div>
-</div>
-
-
-           </div>
-           
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
-        <a href="population_example.html" class="btn btn-neutral float-right" title="Example of population script" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
-      
-      
-        <a href="examples.html" class="btn btn-neutral float-left" title="Examples" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
-      
-    </div>
-  
-
-  <hr/>
-
-  <div role="contentinfo">
-    <p>
-        
-        &copy; Copyright 2021, David Hendriks, Robert Izzard
-
-    </p>
-  </div>
-    
-    
-    
-    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
-    
-    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
-    
-    provided by <a href="https://readthedocs.org">Read the Docs</a>.
-<br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
-<br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
-
-
-
-</footer>
-
-        </div>
-      </div>
-
-    </section>
-
-  </div>
-  
-
-  <script type="text/javascript">
-      jQuery(function () {
-          SphinxRtdTheme.Navigation.enable(true);
-      });
-  </script>
-
-  
-  
-    
-   
-
-</body>
-</html>
\ No newline at end of file
diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html
index 8c67f1634..99325fce3 100644
--- a/docs/build/html/genindex.html
+++ b/docs/build/html/genindex.html
@@ -87,7 +87,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -385,8 +385,6 @@
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="grid.html#binarycpython.utils.grid.Population.evolve">evolve() (binarycpython.utils.grid.Population method)</a>
-</li>
-      <li><a href="grid.html#binarycpython.utils.grid.Population.evolve_population">evolve_population() (binarycpython.utils.grid.Population method)</a>
 </li>
       <li><a href="grid.html#binarycpython.utils.grid.Population.evolve_single">evolve_single() (binarycpython.utils.grid.Population method)</a>
 </li>
@@ -449,8 +447,6 @@
       <li><a href="functions.html#binarycpython.utils.functions.get_moe_di_stefano_dataset">get_moe_di_stefano_dataset() (in module binarycpython.utils.functions)</a>
 </li>
       <li><a href="functions.html#binarycpython.utils.functions.get_size">get_size() (in module binarycpython.utils.functions)</a>
-</li>
-      <li><a href="grid.html#binarycpython.utils.grid.Population.get_stream_logger">get_stream_logger() (binarycpython.utils.grid.Population method)</a>
 </li>
       <li><a href="grid_options_defaults.html#binarycpython.utils.grid_options_defaults.grid_options_description_checker">grid_options_description_checker() (in module binarycpython.utils.grid_options_defaults)</a>
 </li>
@@ -508,12 +504,10 @@
 <h2 id="L">L</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="grid.html#binarycpython.utils.grid.Population.last_grid_variable">last_grid_variable() (binarycpython.utils.grid.Population method)</a>
+      <li><a href="distribution_functions.html#binarycpython.utils.distribution_functions.linear_extrapolation_q">linear_extrapolation_q() (in module binarycpython.utils.distribution_functions)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="distribution_functions.html#binarycpython.utils.distribution_functions.linear_extrapolation_q">linear_extrapolation_q() (in module binarycpython.utils.distribution_functions)</a>
-</li>
       <li><a href="functions.html#binarycpython.utils.functions.load_logfile">load_logfile() (in module binarycpython.utils.functions)</a>
 </li>
   </ul></td>
@@ -648,11 +642,17 @@
       <li><a href="functions.html#binarycpython.utils.functions.remove_file">remove_file() (in module binarycpython.utils.functions)</a>
 </li>
       <li><a href="grid.html#binarycpython.utils.grid.Population.return_all_info">return_all_info() (binarycpython.utils.grid.Population method)</a>
+</li>
+      <li><a href="grid.html#binarycpython.utils.grid.Population.return_binary_c_defaults">return_binary_c_defaults() (binarycpython.utils.grid.Population method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="functions.html#binarycpython.utils.functions.return_binary_c_version_info">return_binary_c_version_info() (in module binarycpython.utils.functions)</a>
+      <li><a href="grid.html#binarycpython.utils.grid.Population.return_binary_c_version_info">return_binary_c_version_info() (binarycpython.utils.grid.Population method)</a>
+
+      <ul>
+        <li><a href="functions.html#binarycpython.utils.functions.return_binary_c_version_info">(in module binarycpython.utils.functions)</a>
 </li>
+      </ul></li>
       <li><a href="custom_logging_functions.html#binarycpython.utils.custom_logging_functions.return_compilation_dict">return_compilation_dict() (in module binarycpython.utils.custom_logging_functions)</a>
 </li>
       <li><a href="grid.html#binarycpython.utils.grid.Population.return_population_settings">return_population_settings() (binarycpython.utils.grid.Population method)</a>
@@ -672,16 +672,14 @@
       <li><a href="distribution_functions.html#binarycpython.utils.distribution_functions.sana12">sana12() (in module binarycpython.utils.distribution_functions)</a>
 </li>
       <li><a href="grid.html#binarycpython.utils.grid.Population.set">set() (binarycpython.utils.grid.Population method)</a>
-</li>
-      <li><a href="grid.html#binarycpython.utils.grid.Population.set_moe_di_stefano_settings">set_moe_di_stefano_settings() (binarycpython.utils.grid.Population method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="grid.html#binarycpython.utils.grid.Population.set_moe_di_stefano_settings">set_moe_di_stefano_settings() (binarycpython.utils.grid.Population method)</a>
+</li>
       <li><a href="distribution_functions.html#binarycpython.utils.distribution_functions.set_opts">set_opts() (in module binarycpython.utils.distribution_functions)</a>
 </li>
       <li><a href="functions.html#binarycpython.utils.functions.subtract_dicts">subtract_dicts() (in module binarycpython.utils.functions)</a>
-</li>
-      <li><a href="grid.html#binarycpython.utils.grid.Population.system_queue_filler">system_queue_filler() (binarycpython.utils.grid.Population method)</a>
 </li>
   </ul></td>
 </tr></table>
@@ -762,9 +760,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/grid.html b/docs/build/html/grid.html
index e12568025..678f92ce0 100644
--- a/docs/build/html/grid.html
+++ b/docs/build/html/grid.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -334,22 +334,6 @@ TODO: change the way this is done. Slurm &amp; CONDOR should probably do this di
 </dl>
 </dd></dl>
 
-<dl class="py method">
-<dt id="binarycpython.utils.grid.Population.evolve_population">
-<code class="sig-name descname">evolve_population</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.evolve_population"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.evolve_population" title="Permalink to this definition">¶</a></dt>
-<dd><p>Function to evolve populations. This handles the setting up, evolving
-and cleaning up of a population of stars.</p>
-<dl class="simple">
-<dt>Choices here are:</dt><dd><p>to evolve a population via multiprocessing or linearly on 1 core.
-NOT IMPLEMENTED YET to evolve a population via a variable grid, a source file or MC</p>
-</dd>
-<dt>Tasks:</dt><dd><ul class="simple">
-<li><p>TODO: include options for different ways of generating a population here. (i.e. MC or source file)</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
 <dl class="py method">
 <dt id="binarycpython.utils.grid.Population.evolve_single">
 <code class="sig-name descname">evolve_single</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">clean_up_custom_logging_files</span><span class="o">=</span><span class="default_value">True</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.evolve_single"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.evolve_single" title="Permalink to this definition">¶</a></dt>
@@ -424,19 +408,6 @@ simulation_&lt;date+time&gt;_settings.json will be created</p></li>
 </dl>
 </dd></dl>
 
-<dl class="py method">
-<dt id="binarycpython.utils.grid.Population.get_stream_logger">
-<code class="sig-name descname">get_stream_logger</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">level</span><span class="o">=</span><span class="default_value">10</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.get_stream_logger"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.get_stream_logger" title="Permalink to this definition">¶</a></dt>
-<dd><p>Return logger with configured StreamHandler.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt id="binarycpython.utils.grid.Population.last_grid_variable">
-<code class="sig-name descname">last_grid_variable</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.last_grid_variable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.last_grid_variable" title="Permalink to this definition">¶</a></dt>
-<dd><p>Function that returns the last grid variable
-(i.e. the one with the highest grid_variable_number)</p>
-</dd></dl>
-
 <dl class="py method">
 <dt id="binarycpython.utils.grid.Population.parse_cmdline">
 <code class="sig-name descname">parse_cmdline</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.parse_cmdline"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.parse_cmdline" title="Permalink to this definition">¶</a></dt>
@@ -486,6 +457,18 @@ the binary_c parameters (see get_help_all)</p></li>
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt id="binarycpython.utils.grid.Population.return_binary_c_defaults">
+<code class="sig-name descname">return_binary_c_defaults</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.return_binary_c_defaults"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.return_binary_c_defaults" title="Permalink to this definition">¶</a></dt>
+<dd><p>Function that returns the defaults of the binary_c version that is used.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt id="binarycpython.utils.grid.Population.return_binary_c_version_info">
+<code class="sig-name descname">return_binary_c_version_info</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">parsed</span><span class="o">=</span><span class="default_value">False</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.return_binary_c_version_info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.return_binary_c_version_info" title="Permalink to this definition">¶</a></dt>
+<dd><p>Function that returns the version information of binary_c</p>
+</dd></dl>
+
 <dl class="py method">
 <dt id="binarycpython.utils.grid.Population.return_population_settings">
 <code class="sig-name descname">return_population_settings</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.return_population_settings"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.return_population_settings" title="Permalink to this definition">¶</a></dt>
@@ -531,14 +514,6 @@ in the self.grid_options</p>
 <p>If nothing is passed then we just use the default options</p>
 </dd></dl>
 
-<dl class="py method">
-<dt id="binarycpython.utils.grid.Population.system_queue_filler">
-<code class="sig-name descname">system_queue_filler</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">job_queue</span></em>, <em class="sig-param"><span class="n">amt_cores</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.system_queue_filler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.system_queue_filler" title="Permalink to this definition">¶</a></dt>
-<dd><p>Function that is responsible for keeping the queue filled.</p>
-<p>This will generate the systems until it is full, and then keeps trying to fill it.
-Will have to play with the size of this.</p>
-</dd></dl>
-
 <dl class="py method">
 <dt id="binarycpython.utils.grid.Population.write_binary_c_calls_to_file">
 <code class="sig-name descname">write_binary_c_calls_to_file</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">output_dir</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">output_filename</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">include_defaults</span><span class="o">=</span><span class="default_value">False</span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/binarycpython/utils/grid.html#Population.write_binary_c_calls_to_file"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#binarycpython.utils.grid.Population.write_binary_c_calls_to_file" title="Permalink to this definition">¶</a></dt>
@@ -563,8 +538,11 @@ like m1,m2,sep, orb-per, ecc, probability etc.</p>
 <li><p><strong>include_defaults</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.</p></li>
 </ul>
 </dd>
-<dt class="field-even">Return type</dt>
-<dd class="field-even"><p><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></p>
+<dt class="field-even">Returns</dt>
+<dd class="field-even"><p>filename that was used to write the calls to</p>
+</dd>
+<dt class="field-odd">Return type</dt>
+<dd class="field-odd"><p>filename</p>
 </dd>
 </dl>
 </dd></dl>
@@ -607,9 +585,9 @@ like m1,m2,sep, orb-per, ecc, probability etc.</p>
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/grid_options_defaults.html b/docs/build/html/grid_options_defaults.html
index fe3ca3872..112c791bf 100644
--- a/docs/build/html/grid_options_defaults.html
+++ b/docs/build/html/grid_options_defaults.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -308,9 +308,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/grid_options_descriptions.html b/docs/build/html/grid_options_descriptions.html
index ec8a52d1b..a007d6ba1 100644
--- a/docs/build/html/grid_options_descriptions.html
+++ b/docs/build/html/grid_options_descriptions.html
@@ -88,7 +88,7 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Population grid code options</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="#public-options">Public options</a></li>
@@ -479,9 +479,9 @@ q extrapolation (below 0.15) method
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/hpc_functions.html b/docs/build/html/hpc_functions.html
index b615bb2a7..2449b3411 100644
--- a/docs/build/html/hpc_functions.html
+++ b/docs/build/html/hpc_functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -239,9 +239,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/index.html b/docs/build/html/index.html
index 07a6be2bc..3cd491f71 100644
--- a/docs/build/html/index.html
+++ b/docs/build/html/index.html
@@ -88,7 +88,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -310,7 +310,14 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
+</ul>
+</li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="binary_c_parameters.html#section-stars">Section: stars</a></li>
 <li class="toctree-l2"><a class="reference internal" href="binary_c_parameters.html#section-binary">Section: binary</a></li>
@@ -375,9 +382,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/modules.html b/docs/build/html/modules.html
index af71bd8bc..b15b9715b 100644
--- a/docs/build/html/modules.html
+++ b/docs/build/html/modules.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -250,9 +250,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/notebook_api_functionality.html b/docs/build/html/notebook_api_functionality.html
new file mode 100644
index 000000000..7b56c0572
--- /dev/null
+++ b/docs/build/html/notebook_api_functionality.html
@@ -0,0 +1,1378 @@
+
+
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8">
+  
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  
+  <title>Using the API functionality of binarycpython &mdash; binary_c-python  documentation</title>
+  
+
+  
+  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+  
+  
+  
+  
+
+  
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+    
+      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/language_data.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
+    
+    <script type="text/javascript" src="_static/js/theme.js"></script>
+
+    
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Binary_c parameters" href="binary_c_parameters.html" />
+    <link rel="prev" title="Extra features and functionality of binarycpython" href="notebook_extra_features.html" /> 
+</head>
+
+<body class="wy-body-for-nav">
+
+   
+  <div class="wy-grid-for-nav">
+    
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+          
+
+          
+            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
+          
+
+          
+          </a>
+
+          
+            
+            
+          
+
+          
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+          
+        </div>
+
+        
+        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+          
+            
+            
+              
+            
+            
+              <p class="caption"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
+<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Using the API functionality of binarycpython</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Example-usage:">Example usage:</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#Setting-up,-using-and-freeing-store">Setting up, using and freeing store</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Getting-information-from-binary_c">Getting information from binary_c</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
+<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
+</ul>
+
+            
+          
+        </div>
+        
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+      
+      <nav class="wy-nav-top" aria-label="top navigation">
+        
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">binary_c-python</a>
+        
+      </nav>
+
+
+      <div class="wy-nav-content">
+        
+        <div class="rst-content">
+        
+          
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+
+  <ul class="wy-breadcrumbs">
+    
+      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
+        
+          <li><a href="example_notebooks.html">Example notebooks</a> &raquo;</li>
+        
+      <li>Using the API functionality of binarycpython</li>
+    
+    
+      <li class="wy-breadcrumbs-aside">
+        
+            
+            <a href="_sources/notebook_api_functionality.ipynb.txt" rel="nofollow"> View page source</a>
+          
+        
+      </li>
+    
+  </ul>
+
+  
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+            
+  
+<style>
+/* CSS for nbsphinx extension */
+
+/* remove conflicting styling from Sphinx themes */
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt *,
+div.nbinput.container div.input_area pre,
+div.nboutput.container div.output_area pre,
+div.nbinput.container div.input_area .highlight,
+div.nboutput.container div.output_area .highlight {
+    border: none;
+    padding: 0;
+    margin: 0;
+    box-shadow: none;
+}
+
+div.nbinput.container > div[class*=highlight],
+div.nboutput.container > div[class*=highlight] {
+    margin: 0;
+}
+
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt * {
+    background: none;
+}
+
+div.nboutput.container div.output_area .highlight,
+div.nboutput.container div.output_area pre {
+    background: unset;
+}
+
+div.nboutput.container div.output_area div.highlight {
+    color: unset;  /* override Pygments text color */
+}
+
+/* avoid gaps between output lines */
+div.nboutput.container div[class*=highlight] pre {
+    line-height: normal;
+}
+
+/* input/output containers */
+div.nbinput.container,
+div.nboutput.container {
+    display: -webkit-flex;
+    display: flex;
+    align-items: flex-start;
+    margin: 0;
+    width: 100%;
+}
+@media (max-width: 540px) {
+    div.nbinput.container,
+    div.nboutput.container {
+        flex-direction: column;
+    }
+}
+
+/* input container */
+div.nbinput.container {
+    padding-top: 5px;
+}
+
+/* last container */
+div.nblast.container {
+    padding-bottom: 5px;
+}
+
+/* input prompt */
+div.nbinput.container div.prompt pre {
+    color: #307FC1;
+}
+
+/* output prompt */
+div.nboutput.container div.prompt pre {
+    color: #BF5B3D;
+}
+
+/* all prompts */
+div.nbinput.container div.prompt,
+div.nboutput.container div.prompt {
+    width: 4.5ex;
+    padding-top: 5px;
+    position: relative;
+    user-select: none;
+}
+
+div.nbinput.container div.prompt > div,
+div.nboutput.container div.prompt > div {
+    position: absolute;
+    right: 0;
+    margin-right: 0.3ex;
+}
+
+@media (max-width: 540px) {
+    div.nbinput.container div.prompt,
+    div.nboutput.container div.prompt {
+        width: unset;
+        text-align: left;
+        padding: 0.4em;
+    }
+    div.nboutput.container div.prompt.empty {
+        padding: 0;
+    }
+
+    div.nbinput.container div.prompt > div,
+    div.nboutput.container div.prompt > div {
+        position: unset;
+    }
+}
+
+/* disable scrollbars on prompts */
+div.nbinput.container div.prompt pre,
+div.nboutput.container div.prompt pre {
+    overflow: hidden;
+}
+
+/* input/output area */
+div.nbinput.container div.input_area,
+div.nboutput.container div.output_area {
+    -webkit-flex: 1;
+    flex: 1;
+    overflow: auto;
+}
+@media (max-width: 540px) {
+    div.nbinput.container div.input_area,
+    div.nboutput.container div.output_area {
+        width: 100%;
+    }
+}
+
+/* input area */
+div.nbinput.container div.input_area {
+    border: 1px solid #e0e0e0;
+    border-radius: 2px;
+    /*background: #f5f5f5;*/
+}
+
+/* override MathJax center alignment in output cells */
+div.nboutput.container div[class*=MathJax] {
+    text-align: left !important;
+}
+
+/* override sphinx.ext.imgmath center alignment in output cells */
+div.nboutput.container div.math p {
+    text-align: left;
+}
+
+/* standard error */
+div.nboutput.container div.output_area.stderr {
+    background: #fdd;
+}
+
+/* ANSI colors */
+.ansi-black-fg { color: #3E424D; }
+.ansi-black-bg { background-color: #3E424D; }
+.ansi-black-intense-fg { color: #282C36; }
+.ansi-black-intense-bg { background-color: #282C36; }
+.ansi-red-fg { color: #E75C58; }
+.ansi-red-bg { background-color: #E75C58; }
+.ansi-red-intense-fg { color: #B22B31; }
+.ansi-red-intense-bg { background-color: #B22B31; }
+.ansi-green-fg { color: #00A250; }
+.ansi-green-bg { background-color: #00A250; }
+.ansi-green-intense-fg { color: #007427; }
+.ansi-green-intense-bg { background-color: #007427; }
+.ansi-yellow-fg { color: #DDB62B; }
+.ansi-yellow-bg { background-color: #DDB62B; }
+.ansi-yellow-intense-fg { color: #B27D12; }
+.ansi-yellow-intense-bg { background-color: #B27D12; }
+.ansi-blue-fg { color: #208FFB; }
+.ansi-blue-bg { background-color: #208FFB; }
+.ansi-blue-intense-fg { color: #0065CA; }
+.ansi-blue-intense-bg { background-color: #0065CA; }
+.ansi-magenta-fg { color: #D160C4; }
+.ansi-magenta-bg { background-color: #D160C4; }
+.ansi-magenta-intense-fg { color: #A03196; }
+.ansi-magenta-intense-bg { background-color: #A03196; }
+.ansi-cyan-fg { color: #60C6C8; }
+.ansi-cyan-bg { background-color: #60C6C8; }
+.ansi-cyan-intense-fg { color: #258F8F; }
+.ansi-cyan-intense-bg { background-color: #258F8F; }
+.ansi-white-fg { color: #C5C1B4; }
+.ansi-white-bg { background-color: #C5C1B4; }
+.ansi-white-intense-fg { color: #A1A6B2; }
+.ansi-white-intense-bg { background-color: #A1A6B2; }
+
+.ansi-default-inverse-fg { color: #FFFFFF; }
+.ansi-default-inverse-bg { background-color: #000000; }
+
+.ansi-bold { font-weight: bold; }
+.ansi-underline { text-decoration: underline; }
+
+
+div.nbinput.container div.input_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight].math,
+div.nboutput.container div.output_area.rendered_html,
+div.nboutput.container div.output_area > div.output_javascript,
+div.nboutput.container div.output_area:not(.rendered_html) > img{
+    padding: 5px;
+    margin: 0;
+}
+
+/* fix copybtn overflow problem in chromium (needed for 'sphinx_copybutton') */
+div.nbinput.container div.input_area > div[class^='highlight'],
+div.nboutput.container div.output_area > div[class^='highlight']{
+    overflow-y: hidden;
+}
+
+/* hide copybtn icon on prompts (needed for 'sphinx_copybutton') */
+.prompt a.copybtn {
+    display: none;
+}
+
+/* Some additional styling taken form the Jupyter notebook CSS */
+div.rendered_html table {
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: black;
+  font-size: 12px;
+  table-layout: fixed;
+}
+div.rendered_html thead {
+  border-bottom: 1px solid black;
+  vertical-align: bottom;
+}
+div.rendered_html tr,
+div.rendered_html th,
+div.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+div.rendered_html th {
+  font-weight: bold;
+}
+div.rendered_html tbody tr:nth-child(odd) {
+  background: #f5f5f5;
+}
+div.rendered_html tbody tr:hover {
+  background: rgba(66, 165, 245, 0.2);
+}
+
+/* CSS overrides for sphinx_rtd_theme */
+
+/* 24px margin */
+.nbinput.nblast.container,
+.nboutput.nblast.container {
+    margin-bottom: 19px;  /* padding has already 5px */
+}
+
+/* ... except between code cells! */
+.nblast.container + .nbinput.container {
+    margin-top: -19px;
+}
+
+.admonition > p:before {
+    margin-right: 4px;  /* make room for the exclamation icon */
+}
+
+/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
+.math {
+    text-align: unset;
+}
+</style>
+<div class="section" id="Using-the-API-functionality-of-binarycpython">
+<h1>Using the API functionality of binarycpython<a class="headerlink" href="#Using-the-API-functionality-of-binarycpython" title="Permalink to this headline">¶</a></h1>
+<p>This notebook shows how to use the API functions that interface with binary_c. It usually is better to use wrapper functions that internally use these API functions, because most of the output here is very raw</p>
+<p>Binarycpython uses the Python-C extension framework to interface Python with C. The sourcecode for this is contained in <code class="docutils literal notranslate"><span class="pre">src/binary_c_python.c</span></code>, and the functions are available via <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">binarycpython</span> <span class="pre">import</span> <span class="pre">_binary_c_bindings</span></code>.</p>
+<p>The following functions are available through the API: (run cell below)</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">from</span> <span class="nn">binarycpython</span> <span class="kn">import</span> <span class="n">_binary_c_bindings</span>
+<span class="n">help</span><span class="p">(</span><span class="n">_binary_c_bindings</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Help on module binarycpython._binary_c_bindings in binarycpython:
+
+NAME
+    binarycpython._binary_c_bindings - Module to interface the Binary_c API with python.
+
+FUNCTIONS
+    free_persistent_data_memaddr_and_return_json_output(...)
+        Frees the persistent_data memory and returns the json output
+
+    free_store_memaddr(...)
+        Frees the store memaddr
+
+    return_arglines(...)
+        Return the default args for a binary_c system
+
+    return_help(...)
+        Return the help info for a given parameter
+
+    return_help_all(...)
+        Return an overview of all the parameters, their description, categorized in sections
+
+    return_maximum_mass_ratio_for_RLOF(...)
+        Returns a string containing the maximum mass ratio for which a binary system does not RLOF at zams. Optionally accepts a store_capsule. Please use the wrapper functions in utils for this except when you know what you&#39;re doing
+
+    return_minimum_orbit_for_RLOF(...)
+        Returns a string containing the minimum orbit and separation for which a binary system does not RLOF at zams. Please use the wrapper functions in utils for this except when you know what you&#39;re doing
+
+    return_persistent_data_memaddr(...)
+        Return the store memory adress that will be passed to run_population
+
+    return_store_memaddr(...)
+        Return the store memory adress that will be passed to run_population
+
+    return_version_info(...)
+        Return the version information of the used binary_c build
+
+    run_system(...)
+        Function to run a system. This is a general function that will be able to handle different kinds of situations: single system run with different settings, population run with different settings, etc. To avoid having too many functions doing slightly different things.
+
+        Arguments:
+                argstring: argument string for binary_c
+                (opt) custom_logging_func_memaddr: memory address value for custom logging function. Default = -1 (None)
+                (opt) store_memaddr: memory adress of the store. Default = -1 (None)
+                (opt) write_logfile: Boolean (in int form) for whether to enable the writing of the log function. Default = 0
+                (opt) population: Boolean (in int form) for whether this system is part of a population run. Default = 0.
+
+    test_func(...)
+        Function that contains random snippets. Do not expect this to remain available, or reliable. i.e. dont use it.
+
+FILE
+    /home/david/.pyenv/versions/3.6.4/envs/dev-binarycpython3.6.4/lib/python3.6/site-packages/binarycpython/_binary_c_bindings.cpython-36m-x86_64-linux-gnu.so
+
+
+</pre></div></div>
+</div>
+<p>There are three main categories of functions:</p>
+<ul class="simple">
+<li><p>Functions to get information from binary_c: these can be used to evolve systems, and get utility information from binary_c.</p>
+<ul>
+<li><p>run_system</p></li>
+<li><p>return_minimum_orbit_for_RLOF</p></li>
+<li><p>return_maximum_mass_ratio_for_RLOF</p></li>
+<li><p>return_help</p></li>
+<li><p>return_help_all</p></li>
+<li><p>return_arglines</p></li>
+</ul>
+</li>
+<li><p>Memory creation functions: these can be used to have binary_c allocate memory which is used or written to by binary_c</p>
+<ul>
+<li><p>return_persistent_data_memaddr</p></li>
+<li><p>return_store_memaddr</p></li>
+</ul>
+</li>
+<li><p>Memory freeing functions: These can be used to free the allocated memory, and in the case of persistent memory it will also return the contents of the ensemble</p>
+<ul>
+<li><p>free_persistent_data_memaddr_and_return_json_output</p></li>
+<li><p>free_store_memaddr</p></li>
+</ul>
+</li>
+</ul>
+<div class="section" id="Example-usage:">
+<h2>Example usage:<a class="headerlink" href="#Example-usage:" title="Permalink to this headline">¶</a></h2>
+<div class="section" id="Setting-up,-using-and-freeing-store">
+<h3>Setting up, using and freeing store<a class="headerlink" href="#Setting-up,-using-and-freeing-store" title="Permalink to this headline">¶</a></h3>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># allocating store memory</span>
+<span class="n">store_memaddr</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_store_memaddr</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">store_memaddr</span><span class="p">)</span>
+
+<span class="c1"># Here we set up the argument string that is passed to the bindings</span>
+<span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">binary_c M_1 </span><span class="si">{M_1}</span><span class="s2"> orbital_period </span><span class="si">{orbital_period}</span><span class="s2"> eccentricity </span><span class="si">{eccentricity}</span><span class="s2"> metallicity </span><span class="si">{metallicity}</span><span class="s2"> max_evolution_time </span><span class="si">{max_evolution_time}</span><span class="s2"></span>
+<span class="s2">&quot;&quot;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="mi">4500</span><span class="p">,</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span>
+    <span class="n">metallicity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>
+<span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+
+<span class="c1">#</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">run_system</span><span class="p">(</span><span class="n">argstring</span><span class="p">,</span> <span class="n">store_memaddr</span><span class="o">=</span><span class="n">store_memaddr</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+
+<span class="c1"># Freeing store</span>
+<span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">free_store_memaddr</span><span class="p">(</span><span class="n">store_memaddr</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+&lt;capsule object &#34;STORE&#34; at 0x7f163859d0c0&gt;
+SINGLE_STAR_LIFETIME 10 27.7358
+
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Getting-information-from-binary_c">
+<h3>Getting information from binary_c<a class="headerlink" href="#Getting-information-from-binary_c" title="Permalink to this headline">¶</a></h3>
+<p>We can get information for a parameter via return_help(parameter_name): This will return an unparsed output</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="nb">print</span><span class="p">(</span><span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_help</span><span class="p">(</span><span class="s1">&#39;M_1&#39;</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+binary_c help for variable : M_1 &lt;Float&gt;
+
+The initial mass of star one (in solar units, internally this is star index 0).
+
+Default : 0
+
+
+
+
+</pre></div></div>
+</div>
+<p>We can get information on all available parameters via return_help(parameter_name):</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[16]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="nb">print</span><span class="p">(</span><span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_help_all</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+
+############################################################
+##### Section Stars
+############################################################
+metallicity : This sets the metallicity of the stars, i.e. the amount (by mass) of matter which is not hydrogen or helium. If you are using the BSE algorithm, this must be 1e-4 &lt;= metallicity &lt;= 0.03. See also nucsyn_metallicity and effective_metallicity. : (null)
+effective_metallicity : This sets effective metallicity of stars as used in routines like the Schneider wind loss. If not set, or set to DEFAULT_TO_METALLICITY (==-1, the default), this is just the same as metallicity. The main difference between effective_metallicity and metallicity is the range of validity: 0 &lt;= effective_metallicity &lt;= 1, while metallicity&#39;s range of validity is limited by the stellar evolution algorithm (so, for BSE, is 1e-4 &lt;= metallicity &lt;= 0.03). : (null)
+M_1 : The initial mass of star one (in solar units, internally this is star index 0). : (null)
+M_2 : The initial mass of star two (in solar units, internally this is star index 1). : (null)
+M_3 : The initial mass of star three (in solar units, internally this is star index 2). : (null)
+M_4 : The initial mass of star four (in solar units, internally this is star index 3). : (null)
+vrot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot2,3,4. : (null)
+vrot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,3,4. : (null)
+vrot3 : The initial equatorial rotational velocity of star three (in km/s, internally this is star index 2). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,4. : (null)
+vrot4 : The initial equatorial rotational velocity of star four (in km/s, internally this is star index 3). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,3. : (null)
+Prot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). See also Prot2,3,4. : (null)
+Prot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). See also Prot1,3,4. : (null)
+Prot3 : The initial equatorial rotational period of star three (in days, internally this is star index 2). See also Prot1,2,4. : (null)
+Prot4 : The initial equatorial rotational period of star four (in days, internally this is star index 3). See also Prot1,2,3. : (null)
+inclination1 : The initial inclination of star one (in degrees). : (null)
+inclination2 : The initial inclination of star two (in degrees). : (null)
+inclination3 : The initial inclination of star three (in degrees). : (null)
+inclination4 : The initial inclination of star four (in degrees). : (null)
+B_1 : The initial magnetic field of star one (in Gauss, internally this is star index 0). : (null)
+B_2 : The initial magnetic field of star two (in Gauss, internally this is star index 1). : (null)
+B_3 : The initial magnetic field of star three (in Gauss, internally this is star index 2). : (null)
+B_4 : The initial magnetic field of star four (in Gauss, internally this is star index 3). : (null)
+B_inclination1 : The initial inclination of the magnetic field of star one (in degrees). : (null)
+B_inclination2 : The initial inclination of the magnetic field of star two (in degrees). : (null)
+B_inclination3 : The initial inclination of the magnetic field of star three (in degrees). : (null)
+B_inclination4 : The initial inclination of the magnetic field of star four (in degrees). : (null)
+stellar_type_1 : Set the stellar type of star 1 (internal index 0), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)
+stellar_type_2 : Set the stellar type of star 2 (internal index 1), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)
+stellar_type_3 : Set the stellar type of star 3 (internal index 2), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)
+stellar_type_4 : Set the stellar type of star 4 (internal index 3), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)
+max_stellar_type_1 : The maximum stellar type of star 1 (internal index 0). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.
+ : (null)
+max_stellar_type_2 : The maximum stellar type of star 2 (internal index 1). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.
+ : (null)
+max_stellar_type_3 : The maximum stellar type of star 3 (internal index 2). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.
+ : (null)
+max_stellar_type_4 : The maximum stellar type of star 4 (internal index 3). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.
+ : (null)
+probability : The probability is a weighting applied to the star based on, say, the initial mass function. When running a grid of stars to simulate *all* stars, the summed probability of all the stars should be 1.0. : (null)
+phasevol : The system&#39;s phase volume, used by binary_grid. : (null)
+stellar_structure_algorithm : Set the stellar structure algorithm. 0=modified BSE (default), 1=none, 2=external function (must be defined by the calling code), 3=binary_c (not yet implemented). : (null)
+solver : The type of solver. Default is the Forward-Euler (0), but could be RK2 (1), RK4 (2) or a predictor-corretor (3). : (null)
+max_evolution_time : Set the maximum age for the stars (Myr). : (null)
+max_model_number : Set the maximum number of models, ignored if 0 (default is 0). : (null)
+monte_carlo_kicks : Turn on Monte-Carlo SN kicks. On (True) by default, and indeed other algorithms are probably broken. : (null)
+disable_debug : Disables debug output. Only has an effect when DEBUG is 1, which probably requires a rebuild. Default FALSE. : (null)
+timestep_logging : Turn on timestep logging (default is False). : (null)
+rejects_in_log : Show timestep rejections in the main log (default is False). : (null)
+vandenHeuvel_logging : Turn on van den Heuvel logging (default is False). : (null)
+evolution_splitting : If True, turn on splitting of an evolutionary run if splitpoint (e.g. supernova) occurs. : (null)
+disable_events : Whether to disable the new events code (defaults to False, so we use events by default)
+ : (null)
+evolution_splitting_sn_eccentricity_threshold : Threshold eccentricity above which evolution splitting happens in a system with no SN kick. (0.01) : (null)
+evolution_splitting_sn_n : Number of runs to split into when a SN occurs. : (null)
+evolution_splitting_maxdepth : Max number of splits in an evolutionary run. : (null)
+equation_of_state_algorithm : Set the equation of state algorithm. 0 = Paczynski. : (null)
+opacity_algorithm : Set the opacity algorithm. 0 = Paczynski, 1 = Ferguson/Opal. : (null)
+wind_mass_loss : Defines the algorithm used for stellar winds. 0 = none, 1 = Hurley et al. (2002), 2 = Schneider (2018). : 0
+gbwind : Wind prescription for first red giant branch stars.  0=Reimers (Hurley et al 2000/2002; choose gb_reimers_eta=0.5 for their mass loss rate), 1=Schroeder+Cuntz 2005 (set gb_reimers_eta=1.0 for their mass loss rate). : (null)
+mattsson_Orich_tpagbwind : Experimental : turns on Mattsson&#39;s TPAGB wind when the star is oxygen rich. Requires MATTSSON_MASS_LOSS. : (null)
+magnetic_braking_factor : Multiplier for the magnetic braking angular momentum loss rate. : (null)
+magnetic_braking_gamma : gamma factor in Rappaport style magnetic braking expression. : (null)
+magnetic_braking_algorithm : Algorithm for the magnetic braking angular momentum loss rate. 0 = Hurley et al. 2002, 1 = Andronov, Pinnsonneault and Sills 2003, 2 = Barnes and Kim 2010  : (null)
+helium_flash_mass_loss : Mass to be lost at the helium flash. : (null)
+gb_reimers_eta : First red giant branch wind multiplication factor, cf. eta in Reimers&#39; mass loss formula. (This multiplies the 4e-13 in Reimers&#39; formula, or the 8e-14 in Schroeder and Cuntz.) : (null)
+gbwindfac : Multiplier for the giant branch wind mass loss rate : (null)
+tpagbwindfac : Multiplier for the TPAGB wind mass loss rate : (null)
+eagbwindfac : Multiplier for the EAGB wind mass loss rate : (null)
+nieuwenhuijzen_windfac : Multiplier for the Nieuwenhuijzen &amp; de Jager wind mass loss rate : (null)
+tpagbwind : Wind prescription during the TPAGB. 0=Karakas 2002 (a modified Vassiliadis and Wood 1993), 1=Hurley et al 2000/2002 (Vassiliadis and Wood 1993), 2=Reimers, 3=Bloecker, 4=Van Loon,  5=Rob&#39;s C-wind (broken?), 6,7=Vassiliadis and Wood 1993 (Karakas,Hurley variants respectively) when C/O&gt;1, 8=Mattsson, 9 = Goldman et al. (2017), 10 = Beasor et al. (2020). : (null)
+eagbwind : Wind prescription during the EAGB. 0=BSE (Hurley+2002, based on VW93), 1 = Goldman et al. (2017), 2 = Beasor et al. (2020). : (null)
+wind_gas_to_dust_ratio : Gas to dust ratio used in wind calculations (e.g. Goldman et al. 2017). Typically 200 (Milky Way)-500 (Magellanic Clouds). Default is 200, approximately as in MW stars. : (null)
+vwind_multiplier : Multiplier for the stellar wind velocity. : (null)
+vwind_beta : Beta for stellar wind speed calculations, where vwind=sqrt(beta) * escape velocity. Default 0.125 (from BSE, Hurley et al. 2002).  : (null)
+superwind_mira_switchon : In the Vassiliadis and Wood (1993) AGB wind prescription, the superwind is turned on at a given Mira period, usually 500 days. You can vary when this switch-on happens with this parameter. : (null)
+vw93_mira_shift : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate depends on the Mira period plus this offset. Requires VW93_MIRA_SHIFT. : (null)
+vw93_multiplier : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate is multiplied by this factor. Requires VW93_MULTIPLIER. : (null)
+tpagb_reimers_eta : TPAGB Reimers wind multiplication factor, cf. eta in Reimers&#39; mass loss formula. (This multiplies the 4e-13 in Reimers&#39; formula, or the 8e-14 in Schroeder and Cuntz.) Note that Reimers is not the default TPAGB wind prescription. See also tpagbwind. : (null)
+artificial_mass_accretion_rate%d : Constant mass accretion rate for star &lt;n&gt;. : (null)
+artificial_angular_momentum_accretion_rate%d : Constant angular momentum accretion for star &lt;n&gt;. : (null)
+artificial_orbital_angular_momentum_accretion_rate : Constant angular momentum accretion rate on the orbit. : (null)
+artificial_accretion_start_time : Time at which artificial accretion stars. Ignored if &lt;0 (default is -1). : (null)
+artificial_accretion_end_time : Time at which artificial accretion ends. Ignored if &lt;0 (default is -1). : (null)
+wr_wind : Massive-star (WR) wind prescription. 0 = Hurley et al 2000/2002, 1=Maeder and Meynet, 2=Nugis and Lamers, 3=John Eldridge&#39;s version of Vink&#39;s early-2000s wind (See Lynnette Dray&#39;s thesis, or John Eldridge&#39;s thesis) : (null)
+wr_wind_fac : Massive-star (WR) wind multiplication factor. : (null)
+wrwindfac : Massive-star (WR) wind multiplication factor. Synonymous with wr_wind_fac (which you should use instead). : (null)
+BH_prescription : Black hole mass prescrition: relates the mass of a newly formed black hole to its progenitor&#39;s (CO) core mass. 0=Hurley et al 2000/2002, 1=Belczynski (early 2000s). : (null)
+PPISN_prescription : (Pulsational) Pair-Instability Supernova prescription: Relates initial helium core mass of star to whether the star undergoes PPISN or PISN. Requires PPISN flag to be True (see binary_c_parameters.h). 0=no ppisn, 1=Farmer et al 2019. : Ignore
+sn_kick_distribution_II : Set the distribution of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_ECAP : Set the distribution of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_NS_NS : Set the distribution of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_IBC : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_GRB_COLLAPSAR : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_TZ : Set the distribution of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_AIC_BH : Set the distribution of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_BH_BH : Set the distribution of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_BH_NS : Set the distribution of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_IA_Hybrid_HeCOWD : Set the distribution of speeds applied to any survivor of a hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_IA_Hybrid_HeCOWD_subluminous : Set the distribution of speeds applied to any survivor of a subluminous hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_PPISN : Set the distribution of speeds applied to PPISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_PISN : Set the distribution of speeds applied to PISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_distribution_PHDIS : Set the distribution of speeds applied to PHDIS supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_II : Set the dispersion of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_ECAP : Set the dispersion of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_NS_NS : Set the dispersion of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_IBC : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_GRB_COLLAPSAR : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_TZ : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_AIC_BH : Set the dispersion of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_BH_BH : Set the dispersion of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_BH_NS : Set the dispersion of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_IA_Hybrid_HeCOWD : Set the dispersion of speeds applied to the survivor of a SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_IA_Hybrid_HeCOWD_subluminous : Set the dispersion of speeds applied to the survivor of a subluminous SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_PPISN : Set the dispersion of speeds applied to the survivor of a PPISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_PISN : Set the dispersion of speeds applied to the survivor of a PISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_dispersion_PHDIS : Set the dispersion of speeds applied to the survivor of a PHDIS supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)
+sn_kick_companion_IA_He : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Ia He supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_ELD : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Ia ELD (sub-Mch) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_CHAND : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Ia Mch supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_AIC : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when an accretion induced collapse (supernova) occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_ECAP : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when an electron capture supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_He_Coal : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Ia helium merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_CHAND_Coal : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Ia Mch merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_NS_NS : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a neutron-star neutron-star merger. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_GRB_COLLAPSAR : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a GRB Collapsar (rapidly rotating SN Ibc) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_HeStarIa : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a He-star Ia supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IBC : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a type Ib/c supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_II : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a type II supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IIa : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a type IIa supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_WDKICK : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a WD is kicked. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_TZ : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a Thorne-Zytkow object is formed. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_AIC_BH : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a neutron star collapses to a black hole. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_BH_BH : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when two black holes merge. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_BH_NS : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the, kick on the companion when a black hole merges with a neutron star. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_Hybrid_HeCOWD : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the kick on the companion, if it survives, in a hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_IA_Hybrid_HeCOWD_subluminous : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the kick on the companion, if it survives, in a subluminous hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_PPISN : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the kick on the companion, if it survives, in a PPISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_PISN : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the kick on the companion, if it survives, in a PISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+sn_kick_companion_PHDIS : Set the speed (if &gt;=0) of, or the algothim (if &lt;0) used to calculate the kick on the companion, if it survives, in a PHDIS supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)
+wd_sigma : Set the speed at which white dwarfs are kicked when they form, in km/s. Default is zero (i.e. no kick). Requires WD_KICKS. : (null)
+wd_kick_direction : Set the direction of white dwarf kicks. 0 = random, 1 = up, 2 = forward, 3 = backward, 4 = inward, 5 = outward. Requires WD_KICKS. : (null)
+wd_kick_when : Decide when to kick a white dwarf. 0=at birth, 1=at first RLOF, 2=at given pulse number (see wd_kick_pulse_number), 3 at every pulse Requires WD_KICKS. : (null)
+wd_kick_pulse_number : Apply a kick to a star at a desired pulse number on the TPAGB (i.e. pre-WD). Requires WD_KICKS. : (null)
+minimum_helium_ignition_core_mass : Minimum helium core mass required to ignite helium in the case that the hydrogen envelope is stripped on the giant branch, e.g. to make an sdB or sdO star. Typically 0.4, if 0.0 then the BSE algorithm (based on the total mass) is used. : (null)
+minimum_CO_core_mass_for_carbon_ignition : Minimum CO core mass for carbon ignition, assuming Mc,bagb&gt;1.6Msun. Typically around 1.08Msun (Pols+1998). : (null)
+minimum_CO_core_mass_for_neon_ignition : Minimum CO core mass for neon ignition. Typically around 1.42Msun. Stars that have cores that ignite carbon, but not neon explode in electon-capture supernovae. : (null)
+minimum_mcbagb_for_nondegenerate_carbon_ignition : Minimum Mc,bagb (core mass at the base of the AGB) for non-degenerate carbon ignition. Typically around 2.25Msun (Pols+1998). : (null)
+maximum_mcbagb_for_degenerate_carbon_ignition : Maximum Mc,bagb (core mass at the base of the AGB) for degenerate carbon ignition. Typically around 1.6Msun (Pols+1998). : (null)
+max_neutron_star_mass : Maximum mass of a neutron star before it collapses to a black hole. Typically around 2Msun. : (null)
+chandrasekhar_mass : The Chandrasekhar mass, usually 1.44Msun : (null)
+delta_mcmin : A parameter to reduce the minimum core mass for third dredge up to occur on the TPAGB. As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)
+lambda_min : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min&gt;0 implies that, once Mc&gt;Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. See also lambda_multiplier. : (null)
+lambda_multiplier : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min&gt;0 implies that, once Mc&gt;Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)
+minimum_envelope_mass_for_third_dredgeup : The minimum envelope mass for third dredge up on the TPAGB. Early, solar metallicity models by Straniero et al suggested 0.5Msun is typical. However, circumstantial evidence (Izzard et al 2009) as well as newer models by Stancliffe and Karakas suggest that at low metallicity a value nearer zero is more appropriate. : (null)
+mass_of_pmz : The mass in the partial mixing zone of a TPAGB star, using the Karakas 2012 tables. Ask Carlo Abate for more details, or see the series of papers Abate et al 2012, 2013, 2014. Requires NUCSYN and USE_TABULAR_INTERSHELL_ABUNDANCES_KARAKAS_2012. : (null)
+c13_eff : The &#34;efficiency&#34; of partial mixing in a TPAGB star intershell region, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)
+mc13_pocket_multiplier : Multiplies the mass in the partial mixing zone of a TPAGB star, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)
+tides_convective_damping : Tidal convective damping algorithm. 0=TIDES_HURLEY2002 Zahn 197x timescales + Hut, as in Hurley et al (2002), 1 = TIDES_ZAHN1989 : Zahn 1989 lambdas + Hut. : (null)
+E2_prescription : Choose how to calculate the E2 structural parameter (used in tidal timescale calculations). 0=Hurley 1=Izzard (see Siess et al 2013). : (null)
+dtfac : A parameter to decrease the timestep ONLY during the TPAGB phase. : (null)
+hbbtfac : A parameter to modulate the temperature at the base of the hot-bottom burning zone in TPAGB stars. (Works only if NUCSYN is defined) : (null)
+wind_multiplier_%d : Wind multiplier for the stellar type specified by the intger %d. By default these are all 1.0. : (null)
+wind_type_multiplier_%d : Wind multiplier for different types of wind (MS, GB, AGB, WR, LBV, OTHER), given by the integer %d. By default these are all 1.0. : (null)
+pre_main_sequence : Set to True to turn on pre-main sequence evolution. Currently this is not a special stellar type, rather the first (small) fraction of the main sequence has increased radii to match the Railton et al 2014 fits to Tout&#39;s pre-main sequence stars. Requires PRE_MAIN_SEQUENCE. See also pre_main_sequence_fit_lobes. : (null)
+pre_main_sequence_fit_lobes : Set to True force a pre-main sequence star into its Roche lobe. This is done by artificially aging it. Requires PRE_MAIN_SEQUENCE : (null)
+small_envelope_method : Choose the method used to determine the stellar radius when the envelope mass is very thin. 0 = Hurley et al. (2002), 1 = Miller Bertolami et al. (2016+) for GB and AGB stars only. : (null)
+timestep_modulator : Multiplier applied to the global timestep. Requires TIMESTEP_MODULATION. : (null)
+timestep_multiplier%d : Multiplier applied to timestep limit &lt;n&gt;. : (null)
+maximum_timestep : The maximum timestep (MYr). : (null)
+zoomfac_multiplier_decrease : When a timestep is rejected, decrease the timestep by this factor (0.5). : (null)
+zoomfac_multiplier_increase : When a timestep is rejected, zooms, then succeeds, increase the timestep by this factor (1.2). : (null)
+maximum_timestep_factor : The maximum factor between two subsequent timesteps (1.2). : (null)
+maximum_nuclear_burning_timestep : The maximum timestep (MYr) in any nuclear burning phase. : (null)
+nova_retention_method : Algorithm used to calculate the amount of mass retained during a nova explosion. 0=use nova_retention_fraction. (other methods pending) : (null)
+MINT_metallicity : This sets the metallicity for MINT. It is ignored if set to -1.0, the default, in which case the normal metallicity parameter is used. : (null)
+gaia_Teff_binwidth : log10(Effective temperature) bin width used to make Gaia-like HRDs
+ : (null)
+gaia_L_binwidth : log10(luminosity) bin width used to make Gaia-like HRDs
+ : (null)
+gaia_colour_transform_method : Use this to select the method used to transform to Gaia colours from other colour schemes. GAIA_CONVERSION_UBVRI_UNIVARIATE_JORDI2010 = 0 Jordi et al.&#39;s univariate UBVRI fits, GAIA_CONVERSION_UBVRI_BIVARIATE_JORDI2010 = 1 Jordi et al.&#39;s bivariate UBVRI fits, GAIA_CONVERSION_ugriz_UNIVARIATE_JORDI2010 = 2 Jordi et al.&#39;s univariate UBVRI fits, GAIA_CONVERSION_ugriz_BIVARIATE_JORDI2010 = 3 Jordi et al.&#39;s univariate ugriv fits, GAIA_CONVERSION_UBVRI_UNIVARIATE_EVANS2018 = 4 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_ugriz_UNIVARIATE_EVANS2018 = 5 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_UBVRI_RIELLO2020 = 6 Riello et al. (2020, DR3) fits, GAIA_CONVERSION_ugriz_RIELLO2020 = 7 Riello et al. (2020, DR3) fits. : (null)
+rotationally_enhanced_mass_loss : Set to 1 to enable rotationally enhanced mass loss rate algorithms: 0= none, 1=formula cf. Langer models (=ROTATIONALLY_ENHANCED_MASSLOSS_LANGER_FORMULA), 2=limit accretion rate before wind loss is applied, 3 = both 1 and 2. See also rotationally_enhanced_exponent : (null)
+AGB_core_algorithm : Algorithm to use for calculating AGB core masses. 0=Hurley et al. 2002 if no NUCSYN, Karakas 2002 if NUCSYN is defined; 1=Hurley et al. 2002 (overshooting models); 1=Karakas 2002 (non-overshooting models). : (null)
+AGB_radius_algorithm : Algorithm to use for calculating radii on the TPAGB. : (null)
+AGB_luminosity_algorithm : Algorithm to use for calculating luminosities on the TPAGB. : (null)
+AGB_3dup_algorithm : Algorithm to use for calculating third dredge up efficiency on the TPAGB. : (null)
+overspin_algorithm : Algorithm to determine what we do when a star is rotating at its breakup velocity. OVERSPIN_BSE (0) conservatively transfers the angular momentum back to the orbit. OVERSPIN_MASSLOSS uses the rotationally_enhanced_massloss parameter to lose mass which carries away the angular momentum. : (null)
+rotationally_enhanced_exponent : The exponent (power) by which rotationally enhanced mass loss is raised. Requires ROTATIONALLY_ENHANCED_MASS_LOSS. See also rotationally_enhanced_mass_loss. : (null)
+batchmode : Set the batchmode control variable. Use only if you know what you are doing! : (null)
+speedtests : If True, turns on speedtests during version information (off by default). : (null)
+use_fixed_timestep_%d : Set to True to use fixed timestep &lt;n&gt;, False to turn off. Fixed timesteps are on (this is True) by default. : (null)
+task%d : Control tasks to be performed by binary_c. By default, these are all TRUE. For more information see binary_c_macros.h, particularly the BINARY_C_TASK_* macros. : (null)
+orbiting_object : Usage: --orbiting_object mass,spinrate,central_object,period. : 1.0
+orbiting_objects_log : If True, turn on orbiting-object log. : (null)
+orbiting_objects_log : If True, turn on orbiting-object log. : (null)
+orbiting_objects_wind_accretion_multiplier : Multiplier for wind accretion on orbiting objects. Hurley et al 2002 use 1.5, which is the default. : (null)
+orbiting_objects_close_pc_threshold : How close are orbiting objects allowed to be? Set this to be the absolute percentage difference minimum. : (null)
+orbiting_objects_tides_multiplier : Multiplier for tidal torques on orbiting objects. : (null)
+evaporate_escaped_orbiting_objects : If True, evaporate orbiting objects that have escaped the system. : (null)
+RLOF_transition_objects_escape : If True, objects that escape their Roche lobe are ejected from the system, otherwise they are placed just outside the minimum stable orbit. : (null)
+PN_resolve : If True, the timestep will be shortened to resolve better the PN phase (FALSE). : (null)
+PN_resolve_minimum_luminosity : The luminosity above which extra time resolution for PNe is applied (see PN_resolve). : (null)
+PN_resolve_maximum_envelope_mass : The envelope mass below which extra time resolution for PNe is applied (see PN_resolve). : (null)
+PN_resolve_minimum_effective_temperature : The minimum effective temperature above which extra time resolution for PNe is applied (see PN_resolve). : (null)
+PN_fast_wind : If True, thin-envelope PNe will have fast winds (FALSE). : (null)
+PN_fast_wind_dm_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)
+PN_fast_wind_mdot_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)
+PN_fast_wind_dm_AGB : The envelope mass below which fast wind used during the AGB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)
+PN_fast_wind_mdot_AGB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)
+HeWD_HeWD_ignition_mass : HeWD-HeWD mergers above this mass reignite helium. (0.3) : (null)
+wind_Nieuwenhuijzen_luminosity_lower_limit : Above this luminosity we activate the Nieuwenhuijzen and de Jager wind (4e3 Lsun). : (null)
+wind_LBV_luminosity_lower_limit : Above this luminosity we activate the LBV wind (6e5 Lsun). : (null)
+
+############################################################
+##### Section Binary
+############################################################
+separation : Set the orbital separation (actually the semi-major axis) of the binary (internal index 0, stellar indices 0 and 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)
+separation_triple : Set the orbital separation (actually the semi-major axis) of the triple (internal index 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)
+separation_quadruple : Set the orbital separation (actually the semi-major axis) of the quadruple (internal index 2) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)
+orbital_period : Set the initial orbital period of the binary, stars 1 and 2 (internal indices 0 and 1) in days. See also separation. : (null)
+orbital_period_triple : Set the initial orbital period of the triple in days. See also separation. : (null)
+orbital_period_quadruple : Set the orbital period of the outer binary in a quadrulple (stars 3 and 4, internal indices 2 and 3) in days. See also separation. : (null)
+eccentricity : Set the initial eccentricity of the binary orbit (stars 1 and 2, internal indices 0 and 1). : (null)
+eccentricity_triple : Set the initial eccentricity of the triple orbit. : (null)
+eccentricity_quadruple : Set the initial eccentricity of the outer binary of a quadruple (stars 3 and 4, internal indices 2 and 3). : (null)
+incliniation : Set the initial orbital_inclination of the binary relative to zero. : (null)
+incliniation_triple : Set the initial orbital_inclination of the triple orbit relative to zero. : (null)
+incliniation_quadruple : Set the initial orbital_inclinationy of the quadruple orbit relative to zero. : (null)
+orbital_phase : Set the initial orbital phase of the binary orbit. : (null)
+orbital_phase_triple : Set the initial orbital phase of the triple orbit. : (null)
+orbital_phase_quadruple : Set the initial orbital phase of the quadruple orbit. : (null)
+argument_of_periastron : Set the initial argument of periastron of the binary orbit. : (null)
+argument_of_periastron_triple : Set the initial argument of periastron of the triple orbit. : (null)
+argument_of_periastron_quadruple : Set the initial argument of periastron of the quadruple orbit. : (null)
+disc_timestep_factor : Factor that multiplies the natural timestep of a disc. : (null)
+white_dwarf_cooling_model : White dwarf cooling model, relates age to luminosity. WHITE_DWARF_COOLING_MESTEL = 0 is Mestel&#39;s model, WHITE_DWARF_COOLING_MESTEL_MODIFIED = 1 is Hurley&#39;s modified Mestel model, WHITE_DWARF_COOLING_CARRASCO2014 = 2 is based on Carrasco (2014) tables.   : (null)
+white_dwarf_radius_model : White dwarf radius model, radius to mass (and perhaps age). WHITE_DWARF_RADIUS_NAUENBERG1972 = 0 Nauenberg (1972), WHITE_DWARF_RADIUS_MU = 1 mu-dependent variant, WHITE_DWARF_RADIUS_CARRASCO2014 = 2 is based on Carrasco (2014) tables. : (null)
+cbdisc_mass_loss_inner_viscous_accretion_method : Chooses where the mass that is accreted from the inner edge of a circumbinary disc goes, i.e. to which star. 0 = Young and Clarke 2015, 1 = Gerosa et al 2015, 2 = 50:50 (i.e. not dependence on mass). : (null)
+cbdisc_inner_edge_stripping : If True, allow inner edge mass stripping. : (null)
+cbdisc_end_evolution_after_disc : If True, stop evolution when a disc evaporates. : (null)
+cbdisc_no_wind_if_cbdisc : If True, disable stellar winds when there is a circumbinary disc. : (null)
+cbdisc_outer_edge_stripping : If True, allow outer edge mass stripping. : (null)
+disc_n_monte_carlo_guesses : Number of monte carlo guesses to try in the disc solver if the normal list of guesses fails (0). : (null)
+disc_log : If 1, turn on the disc log. Requires DISC_LOG to be defined on build. : (null)
+disc_log2d : If 1, turn on the 2d disc log. Requires DISC_LOG to be defined on build. : (null)
+disc_log_dt : If non-zero, only allows disc log output every disc_log_dt Myr. : (null)
+disc_log_directory : Directory into which disc logging is sent (must exist!). : /tmp/
+post_ce_adaptive_menv : If TRUE, and if post_ce_objects_have_envelopes is TRUE, then the envelope mass of a post-CE star is such that it sits just inside its Roche lobe. If FALSE then a fixed (thin) envelope mass is applied that depends on the stellar type (see macros POST_CE_ENVELOPE_DM_GB, POST_CE_ENVELOPE_DM_EAGB and POST_CE_ENVELOPE_DM_TPAGB). : (null)
+post_ce_objects_have_envelopes : If TRUE then post-common-envelope objects have thin envelopes. You need this if you are to have post-CE post-AGB stars. Note that this *may* be unstable, i.e. you may end up having many CEEs. The mass in the envelope is controlled by post_ce_adaptive_menv. TRUE by default. : (null)
+PN_comenv_transition_time : post-common envelope transition time in years (1e2).  This is the time taken to move from CEE ejection to Teff &gt; 30e4 K. Hall et al. (2013) suggest ~100 years. : (null)
+minimum_time_between_PNe : The minimum time (Myr) between planetary nebula detections. This prevents multiple, fast common envelopes triggering two PNe (0.1). : (null)
+PN_Hall_fading_time_algorithm : In stars with low mass (&lt;0.45Msun) cores, you can choose to set the PN fading time to either the minimum (PN_HALL_FADING_TIME_ALGORITHM_MINIMUM) or maximum (PN_HALL_FADING_TIME_ALGORITHM_MAXIMUM) as shown in Fig. 6 of Hall et al. (2013). : (null)
+PPN_envelope_mass : Desired pre-planetary nebula (post-AGB) envelope mass. : (null)
+cbdisc_eccentricity_pumping_method : Select from various eccentricity-pumping methods when there is a circumbinary disc. Requires DISCS. 0 = off. : (null)
+cbdisc_viscous_photoevaporative_coupling : Set to 1 to turn on viscous-photoevaporative coupling in circumbinary discs. Requires DISCS. 0 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_NONE = off, 1 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_INSTANT instant, 2 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_VISCOUS slow, viscous wind. : (null)
+cbdisc_inner_edge_stripping_timescale : Defines the timescale for mass loss from by inner edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_in. : (null)
+cbdisc_outer_edge_stripping_timescale : Defines the timescale for mass loss from by outer edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_out. : (null)
+cbdisc_viscous_L2_coupling : Set to 1 to turn on viscous-L2-loss coupling in circumbinary discs. Requires DISCS. 0 = off. : (null)
+gravitational_radiation_model : Model for gravitational radiation from the system. 0=Hurley et al 2002 (Landau and Lifshitz 1951). 1 = as 0 but only when there is no RLOF. 2 = none. : (null)
+nova_irradiation_multiplier : Multiplier for nova-radiative induced mass loss. (Shara+1986) : (null)
+gravitational_radiation_modulator_J : Modulator for gravitational wave radiation angular momentum loss rate (1.0). : (null)
+gravitational_radiation_modulator_e : Modulator for gravitational wave radiation eccentricity pumping rate (1.0). : (null)
+nova_faml_multiplier : Nova friction-induced angular momentum loss multiplier. (Shara+1986) : (null)
+RLOF_angular_momentum_transfer_model : Choose angular momentum transfer model in RLOF. 0=BSE (with discs), 1=conservative : (null)
+post_SN_orbit_method : Method by which the post-SN orbit is calculated. 0=BSE, 1=Tauris&amp;Taken 1998. : (null)
+multiplicity : Multiplicity: 1=single star, 2=binary, 3=triple, 4=quadruple. : (null)
+accretion_limit_eddington_steady_multiplier : Steady accretion is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_steady_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)
+accretion_limit_eddington_LMMS_multiplier : Accretion from a low-mass, convective, main_sequence star is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_LMMS_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)
+accretion_limit_eddington_WD_to_remnant_multiplier : Accretion from a WD onto a remnant star (e.g. another white dwarf, neutron star or black hole) is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_WD_to_remnant_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)
+accretion_limit_thermal_multiplier : Mass transfer onto a MS, HG or CHeB star is limited by the accretor&#39;s thermal rate times this multiplier. : (null)
+accretion_limit_dynamical_multiplier : Mass transfer is limited by the accretor&#39;s dynamical rate times this multiplier. : (null)
+donor_limit_envelope_multiplier : Mass transfer by RLOF is limited by this fraction of the donor&#39;s envelope mass per timestep : (null)
+donor_limit_thermal_multiplier : Mass transfer by RLOF is limited by the accretor&#39;s thermal rate times this multiplier. : (null)
+donor_limit_dynamical_multiplier : Mass transfer by RLOF is limited by the donor&#39;s dynamical rate times this multiplier. : (null)
+Bondi_Hoyle_accretion_factor : Wind accretion rate, as calculated by the Bondi-Hoyle-Littleton formula, multiplcation factor. Hurley et al 2002 use 1.5, which is the default. : (null)
+tidal_strength_factor : A modulator for the tidal strength. If this factor &gt; 1 then tides are stronger, i.e. tidal timescales are reduced. : (null)
+hachisu_qcrit : Critical q=Maccretor/Mdonor above which Hachisu&#39;s disk wind turns on. : (null)
+hachisu_disk_wind : Set to True to turn on Hachisu&#39;s disk wind when material accretes too fast onto a white dwarf. This helps to make more SNeIa. See also hachisu_qcrit. : (null)
+mass_accretion_for_eld : The mass that must be accreted onto a COWD for it to ignite as an edge-lit detonation SNIa. : (null)
+WDWD_merger_algorithm : Algorithm to be used when merging two white dwarfs. 0 = Hurley et al. (2002), 1 = Perets+ (2019), 2 = Chen+ (2016, todo)  : (null)
+type_Ia_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from Chandrasekhar-mass exploders. 0 = DD7 (Iwamoto 1999), 1 = Seitenzahl 2013 3D hydro yields (you must also set Seitenzahl2013_model)  : (null)
+Seitenzahl2013_model : Which of Seitenzahl et al. 2013&#39;s models to use? One of N1,N3,N5,N10,N20,N40,N100L,N100,N100H,N150,N200,N300C,N1600,N1600C,N100_Z0.5,N100_Z0.1,N100_Z0.01 (defaults to N100). : N1
+type_Ia_sub_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from sub-Chandrasekhar-mass exploders. (Currently unused.) : (null)
+max_HeWD_mass : The maximum mass a HeWD can have before it ignites helium (0.7). : (null)
+merger_mass_loss_fraction : Fraction of the total mass which is lost when stars merge. : (null)
+merger_angular_momentum_factor : When two stars merge the resulting single star retains a fraction of the total system angular momentum (or the critical spin angular momentum, if it is smaller) multiplied by this factor. : (null)
+wind_angular_momentum_loss : Prescription for losing angular momentum in a stellar wind. 0=Hurley et al 2002 (&#39;Tout&#39;) prescription, 1=lw i.e. a factor multiplying the specific orbital angular momentum, 2=lw hybrid for fast winds. Set wind_djorb_fac to the desired factor.. : (null)
+wind_djorb_fac : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=0 (the Tout/Hurley et al 2002 prescription). See wind_angular_momentum_loss. : (null)
+lw : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=1,2 (the &#39;lw&#39; prescription). See wind_angular_momentum_loss. : (null)
+VW93_EAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)
+VW93_TPAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)
+use_periastron_Roche_radius : Set this to True to use the Roche lobe radius at periastron, rather than (the default to) assume a circular orbit. This will be useful one day when we treat RLOF in eccentric orbits properly, hopefully. : (null)
+qcrit_LMMS : Apply critical q=Mdonor/Maccretor value for low-mass main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_LMMS : Apply critical q=Mdonor/Maccretor value for (low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+qcrit_degenerate_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)
+mass_for_Hestar_Ia_upper : Only helium stars below this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_lower. : (null)
+mass_for_Hestar_Ia_lower : Only helium stars above this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_upper. : (null)
+alphaCB : Circumbinary disk viscosity parameter, alpha. : (null)
+minimum_donor_menv_for_comenv : Minimum donor envelope mass for common envelope evolution to be triggered (Msun). Default 0. : (null)
+comenv_prescription : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)
+comenv_prescription%d : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)
+comenv_ejection_spin_method : When a common envelope is ejected, we need to decide how fast the stars are left spinning. COMENV_EJECTION_SPIN_METHOD_DO_NOTHING (0) is the default, this just leaves the stars/stellar cores spinning with the same spin rate (omega = angular velocity) with which they entered the common envelope phase. COMENV_EJECTION_SPIN_METHOD_SYCHRONIZE instead tidally synchronizes the stars with their new orbital angular velocity. : (null)
+comenv_merger_spin_method : When a common envelope binary merges, we need to decide how fast the resulting single star is left spinning. COMENV_MERGER_SPIN_METHOD_SPECIFIC (0) is the default, this preserves angular momentum but limits the specific angular momentum of the merged star to the specific angular momentum of the system at the onset of common envelope evolution. COMENV_MERGER_SPIN_METHOD_CONSERVE_ANGMOM (1) sets the merger&#39;s angular momentum to be that of the system at the onset of common envelope evolution (which means the star may be rotating supercritically). COMENV_MERGER_SPIN_METHOD_CONSERVE_OMEGA (2) sets the spin rate (angular frequency = omega) of the merged star to be that of the orbit just at the onset of common envelope evolution. : (null)
+comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope&#39;s mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)
+comenv_ms_accretion_fraction : Experimental. During common envelope evolution, a main sequence may accrete a fraction of the envelope&#39;s mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_mass. : (null)
+comenv_ns_accretion_mass : Experimental. During common envelope evolution, a neutron star may accrete some of the envelope&#39;s mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_fraction. : (null)
+comenv_ns_accretion_fraction : Experimental. During common envelope evolution, a neutron star may accrete a fraction of the envelope&#39;s mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_mass. : (null)
+alpha_ce : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)
+alpha_ce%d : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)
+lambda_ce : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)
+lambda_ce%d : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)
+comenv_splitmass : When lambda_ce=-2, the envelope binding energy, lambda, is calculated using a polytropic formalism. The comenv_splitmass defines the point, in the units of the core mass, above which material is ejected. : (null)
+nelemans_recalc_eccentricity : If True, recalculate the eccentricity after angular momentum is removed.  : (null)
+comenv_post_eccentricity : Eccentricity remaining after common envelope ejection. : (null)
+nelemans_gamma : Set the fraction of the orbital specific angular momentum that is used to eject the common envelope according to the Nelemans and Tout prescription. See also nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)
+nelemans_minq : Only activate the Nelemans and Tout common envelope prescription for q&gt;nelemans_minq. See also nelemans_gamma, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)
+nelemans_max_frac_j_change : Maximum fractional angular momentum change in the Nelemans and Tout common envelope prescription. See also nelemans_gamma, nelemans_minq, nelemans_n_comenvs. : (null)
+nelemans_n_comenvs : Set the maximum number of common envelope ejections allowed to follow the Nelemans and Tout prescription, after which the standard alpha prescription is used. : (null)
+lambda_ionisation : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)
+lambda_ionisation%d : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)
+lambda_enthalpy : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)
+lambda_enthalpy%d : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)
+cbdisc_albedo : Circumbinary-disc albedo. Requires DISCS. : (null)
+cbdisc_gamma : Circumbinary disc gamma (equation of state) parameter. Requires DISCS. : (null)
+cbdisc_alpha : Circumbinary disc alpha (viscosity) parameter. Requires DISCS. : (null)
+cbdisc_kappa : Circumbinary disc kappa (opacity) parameter. Requires DISCS. : (null)
+cbdisc_minimum_evaporation_timescale : Circumbinary disc minimum evaporation timescale (years). If (slow, not edge stripped) mass loss would evaporate the disc on a timescale less than this, simply evaporate the disc immediated. Usually set to 1y, ignore if zero. Requires DISCS. : (null)
+cbdisc_torquef : Circumbinary disc binary torque multiplier. Requires DISCS. : (null)
+cbdisc_max_lifetime : Circumbinary disc maximum lifetime (years, ignored if 0). Requires DISCS. : (null)
+cbdisc_init_dM : On cbdisc start, reduce mass by a fraction dM if it won&#39;t converge. Requires DISCS. : (null)
+cbdisc_init_dJdM : On cbdisc start, reduce angular momentum by a fraction dJ/dM*dM if it won&#39;t converge. Requires DISCS. : (null)
+cbdisc_mass_loss_constant_rate : Circumbinary disc constant mass loss rate (Msun/year). Requires DISCS. : (null)
+cbdisc_mass_loss_FUV_multiplier : Circumbinary disc FUV mass loss rate multiplier (no units). Requires DISCS. : (null)
+cbdisc_mass_loss_Xray_multiplier : Circumbinary disc X-ray mass loss rate multiplier (no units). Requires DISCS. : (null)
+cbdisc_mass_loss_ISM_ram_pressure_multiplier : Circumbinary disc interstellar medium ram pressure stripping mass loss rate multiplier (no units). Requires DISCS. : (null)
+cbdisc_mass_loss_ISM_pressure : Circumbinary disc interstellar medium ram pressure in units of Boltzmann constant per Kelvin (I think...). Requires DISCS. Typically 3000.0. See e.g. http://www.astronomy.ohio-state.edu/~pogge/Ast871/Notes/Intro.pdf page 15 or https://arxiv.org/pdf/0902.0820.pdf Fig. 1 (left panel). : (null)
+cbdisc_mass_loss_inner_viscous_multiplier : Circumbinary disc inner edge viscous mass loss rate multiplier (no units). Requires DISCS. : (null)
+cbdisc_mass_loss_inner_viscous_angular_momentum_multiplier : Circumbinary disc inner edge viscous angular momentum multiplier (no units). The inner edge angular momentum Requires DISCS. : (null)
+cbdisc_resonance_multiplier : Circumbinary disc resonant interaction multiplier, affects eccentricity pumping and angular momentum rates. Requires DISCS. : (null)
+cbdisc_resonance_damping : Circumbinary disc resonant interaction damping: should be on (True) to damp the l=1, m=2 resonance when the disc inner edge lies outside the resonance location. Requires DISCS. : (null)
+cbdisc_fail_ring_inside_separation : If True, while converging on a structure, circumbinary discs with Rring &lt; the binary separation are immediately failed. : (null)
+cbdisc_mass_loss_inner_L2_cross_multiplier : Circumbinary disc inner edge L2-crossing mass loss rate multiplier (no units). Requires DISCS. : (null)
+cbdisc_minimum_luminosity : Circumbinary disc minimum luminosity. If the disc becomes dimmer than this, the disc is evaporated instantly. Requires DISCS. : (null)
+cbdisc_minimum_mass : Circumbinary disc minimum mass. If the disc becomes less massive than this, the disc is evaporated instantly. Requires DISCS. : (null)
+cbdisc_minimum_fRing : Circumbinary disc minimum fRing. If the disc becomes a ring, and fRing = |Rout/Rin-1| &lt; this value (and this value is non-zero), the disc is evaporated instantly. Requires DISCS. : (null)
+comenv_disc_angmom_fraction : If &gt;0 Fraction of the common envelope&#39;s angular momentum that goes into the circumbinary disc. If -1 then uses the moments of inertia to calculate (deprecated), if -2 use the common envelope&#39;s specific angular momentum, if -3 uses the L2 point at the end of the common envelope to set the angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)
+comenv_disc_mass_fraction : Fraction of the common envelope&#39;s mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)
+wind_disc_angmom_fraction : If &gt;0 Fraction of the wind envelope&#39;s angular momentum that goes into the circumbinary disc. If -1 then uses the L2 point&#39;s specific angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)
+wind_disc_mass_fraction : Fraction of the stellar wind&#39;s mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)
+WRLOF_method : Choose whether and how to apply wind-Roche-lobe-overflow. 0=none, 1=q-dependent, 2=quadratic See Abate et al 2013/14 for details. Requires WRLOF_MASS_TRANSFER. : (null)
+minimum_timestep : The minimum timestep (Myr). : (null)
+timestep_solver_factor : Factor applied in timestep_limits, e.g. to prevent X changing too fast by comparing to X/dX/dt, which is usually 1 but can be higher to lengthen timesteps when using an alternative solver. : (null)
+RLOF_mdot_factor : Multiplier applied to the mass transfer rate during Roche-lobe overflow. Requires RLOF_MDOT_MODULATION. : (null)
+RLOF_f : Factor to enlarge a Roche lobe, nominally because of radiation pressure (see Dermine et al paper). Requires RLOF_RADIATION_CORRECTION. : (null)
+minimum_separation_for_instant_RLOF : If True, instead of evolving the system just report the minimum separation (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_orbital_period_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)
+minimum_orbital_period_for_instant_RLOF : If True, instead of evolving the system just report the minimum orbital period (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_separation_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)
+maximum_mass_ratio_for_instant_RLOF : If True, instead of evolving the system just report the maximum mass ratio (on the zero-age main sequence) that would lead to instant RLOF, given M1 and orbital period. Used by binary_grid. See also minimum_separation_for_instant_RLOF and minimum_orbital_period_for_instant_RLOF. : (null)
+RLOF_method : Use RLOF_method to choose the algorithm you use for Roche-lobe overflow mass loss rate calculations. 0=Hurley et al 2002, 1=Adaptive (for radiative stars) R=RL method, 2=Ritter (probably broken), 3=Claeys etal 2014 variant on Hurley et al 2002. : (null)
+RLOF_interpolation_method : When a star overflows its Roche lobe, it always has R&gt;RL because of the limited time resolution of the simulation. Binary_c then uses an algorithm to get back to when R~RL (within a desired tolerance, set in RLOF_ENTRY_THRESHOLD which is usually 1.02, i.e. overflow of 2%). You can choose algorithm 0, the Hurley et al 2002 method which reverses time (i.e. uses a Newton-like scheme), or 1 to use the binary_c method which rejects a timestep (and hence does no logging on that timestep) and repeats with half the timestep until R~RL. The latter is now the default, because this means there are no negative timesteps which break various other algorithms (e.g. nucleosynthesis). : (null)
+nova_retention_fraction : The mass accreted during a nova as fraction of mass transferred : (null)
+beta_reverse_nova : The fraction of mass ejected in a nova explosion which is accreted back onto the companion star. Set to -1 to automatically calculate based on a geometric argument, or 0 or positive to set the value. : (null)
+WD_accretion_rate_novae_upper_limit_hydrogen_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is hydrogen rich : above this rate the mass transfer leads to stable burning. : (null)
+WD_accretion_rate_novae_upper_limit_helium_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is helium rich : above this rate the mass transfer leads to stable burning. : (null)
+WD_accretion_rate_novae_upper_limit_other_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is neither hydrogen nor helium rich : above this rate the mass transfer leads to stable burning. : (null)
+WD_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a hydrogen-rich donor. Below this mass transfer leads to stable burning. : (null)
+WD_accretion_rate_new_giant_envelope_lower_limit_helium_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a helium-rich donor. Below this mass transfer leads to stable burning. : (null)
+WD_accretion_rate_new_giant_envelope_lower_limit_other_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope when the donor is neither hydrogen nor helium rich. Below this mass transfer leads to stable burning. : (null)
+CRAP_parameter : Tidally enhanced mass loss parameter. See Tout and Eggleton&#39;s paper on the subject. (Was the parameter bb). : (null)
+individual_novae : If individual_novae is True, novae are resolved such that each explosion is performed separtaely. : (null)
+nova_timestep_accelerator_num : The nova timestep is accelerated if the nova number exceeds nova_timestep_accelerator_num. If zero or negative, acceleration is off. See also nova_timestep_accelerator_index and nova_timestep_accelerator_max. Only used if individual_novae is on.
+ : (null)
+nova_timestep_accelerator_index : The index at which the nova timestep is accelerated. A larger value gives longer timesteps. See also nova_timestep_accelerator_num and nova_timestep_accelerator_max. Only used if individual_novae is on.
+ : (null)
+nova_timestep_accelerator_max : The nova timestep is accelerated by a factor that is capped at nova_timestep_accelerator_max. This parameter is ignored if it is zero or negative. See also nova_timestep_accelerator_num and nova_timestep_accelerator_index. Only used if individual_novae is on.
+ : (null)
+nonconservative_angmom_gamma : Mass lost from the system (but NOT from a stellar wind) takes a fraction gamma of the orbital angular momentum with it. Set to -1 to take the specific angular momentum of the donor star. Set to -2 to take super-Eddington, nova and disk-wind angular momenta as if a wind from the accretor. : (null)
+max_stellar_angmom_change : Maxmimum fractional change in stellar angular momentum allowed before a timestep is rejected (0.05). : (null)
+comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope&#39;s mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)
+
+############################################################
+##### Section Nucsyn
+############################################################
+third_dup : If True, enables third dredge up. Requires NUCSYN and NUCSYN_THIRD_DREDGE_UP. : (null)
+third_dup_multiplier : Usage: --third_dup_multiplier &lt;i&gt; &lt;f&gt;. Multiplies the abundance of element &lt;i&gt; by &lt;f&gt; during third dredge up. : 1.0
+NeNaMgAl : Enables NeNaMgAl reaction network. Requires NUCSYN and NUCSYN_HBB. : Ignore
+nucsyn_network%d : Usage: --nucsyn_network%d &lt;boolean&gt;. Turn a nuclear network on or off. : (null)
+nucsyn_network_error%d : Usage: --nucsyn_network_error%d &lt;f&gt;. Threshold error in nuclear network solver for network %d. : (null)
+nucreacmult%d : Usage: --nucreacmult%d &lt;f&gt;. Multiply nuclear reaction given by the integer %d (integer) by f (float).  : (null)
+nucsyn_metallicity : This sets the metallicity of the nucleosynthesis algorithms, i.e. the amount (by mass) of matter which is not hydrogen or helium. Usually you&#39;d just set this with the metallicity parameter, but if you want the nucleosynthesis to be outside the range of the stellar evolution algorithm (e.g. Z=0 or Z=0.04) then you need to use nucsyn_metallicity. That said, it&#39;s also outside the range of some of the nucleosynthesis algorithms as well, so you have been warned! : (null)
+nucsyn_solver : Choose the solver used in nuclear burning. 0 = KAPS_RENTROP is a Kaps-Rentrop scheme (fast, not great for stiff problems), 1 = LSODA (Adams/BSF switcher), 2 = CVODE library (https://computing.llnl.gov/projects/sundials. Default 0.  : 0
+initial_abundance_mix : initial abundance mixture: 0=AG89, 1=Karakas 2002, 2=Lodders 2003, 3=Asplund 2005 (not available?), 4=Garcia Berro, 5=Grevesse Noels 1993 : 0
+init_abund : Usage: --init_abund &lt;i&gt; &lt;X&gt;. Sets the initial abundance of isotope number &lt;i&gt; to mass fraction &lt;X&gt;. : 0.02
+init_abund_mult : Usage: --init_abund_mult &lt;i&gt; &lt;f&gt;. Multiplies the initial abundance of isotope number &lt;i&gt; by &lt;f&gt;. : 1.0
+init_abund_dex : Usage: --init_abund_dex &lt;i&gt; &lt;f&gt;. Changes the initial abundance of isotope number &lt;i&gt; by &lt;f&gt; dex. : 0.0
+init_abunds_only : If True, outputs only the initial abundances, then exits. : (null)
+initial_abunds_only : If True, outputs only the initial abundances, then exits. : (null)
+no_thermohaline_mixing : If True, disables thermohaline mixing. : (null)
+lithium_GB_post_Heflash : Sets the lithium abundances after the helium flash. Requires NUCSYN and LITHIUM_TABLES. : (null)
+lithium_GB_post_1DUP : Sets the lithium abundance after first dredge up. Requires NUCSYN and LITHIUM_TABLES. : (null)
+lithium_hbb_multiplier : Multiplies the lithium abundances on the AGB during HBB (based on Karakas/Fishlock et al models).Requires NUCSYN and LITHIUM_TABLES. : (null)
+angelou_lithium_decay_function : Functional form which describes Li7 decay. Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Choices are : 0 expoential (see angelou_lithium_decay_time). : (null)
+angelou_lithium_LMMS_time : Time at which lithium manufacture is triggered in a low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_MS_time : Time at which lithium manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_HG_time : Time at which lithium manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_GB_time : Time at which lithium manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_CHeB_time : Time at which lithium manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_EAGB_time : Time at which lithium manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_TPAGB_time : Time at which lithium manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_LMMS_decay_time : Decay time for surface lithium abundance during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_MS_decay_time : Decay time for surface lithium abundance on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_HG_decay_time : Decay time for surface lithium abundance on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_GB_decay_time : Decay time for surface lithium abundance on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_CHeB_decay_time : Decay time for surface lithium abundance during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_EAGB_decay_time : Decay time for surface lithium abundance on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_TPAGB_decay_time : Decay time for surface lithium abundance on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_LMMS_massfrac : Lithium mass fraction when its manufacture is triggered during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_MS_massfrac : Lithium mass fraction when its manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_HG_massfrac : Lithium mass fraction when its manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_GB_massfrac : Lithium mass fraction when its manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_CHeB_massfrac : Lithium mass fraction when its manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_EAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_TPAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).
+ : (null)
+angelou_lithium_vrot_trigger : Equatorial rotational velocity at which lithium manufacture is triggered (km/s). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.
+ : (null)
+angelou_lithium_vrotfrac_trigger : Fraction of Keplerian (breakup) equatorial rotational velocity at which lithium manufacture is triggered (must be &lt;1, ignored if 0). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.
+ : (null)
+
+############################################################
+##### Section Output
+############################################################
+david_logging_function : Function to choose which kind of information gets logged Requires DAVID. Choices are: 0= None, &gt;0 for custom logging functions : Ignore
+cf_amanda_log : Enable logging to compare to Amanda&#39;s models. : (null)
+float_overflow_checks : Turn on to enable floating-point overflow checks at the end of each timestep, if they are available. 0=off, 1=warn (stderr) on failure, 2=exit on failure (0) : (null)
+save_pre_events_stardata : Enable this to save a copy of stardata to stardata-&gt;pre_events_stardata just before an event. : (null)
+disable_end_logging : Disable the logging that happens at the end of the evolution. : (null)
+ensemble : Turn on ensemble calculations and output. : (null)
+ensemble_filters_off : Sets all ensemble filters to be off (FALSE) - these can then be enabled one-by-one with --ensemble_filter_[...] TRUE. : (null)
+ensemble_filter_%d : Turn on or off ensemble filter &lt;n&gt;. For a list of filters, see ensemble_macros.h. : (null)
+ensemble_legacy_ensemble : Turn on ensemble legacy population output. : (null)
+legacy_yields : Turn on ensemble legacy yield output. : (null)
+ensemble_defer : Defer ensemble output. : (null)
+ensemble_dt : When doing ensemble calculations, data are stored and/or output every ensemble_dt Myr. See also ensemble, ensemble_logdt, ensemble_startlogtime. : (null)
+ensemble_logdt : When doing ensemble calculations, and when logensembletimes is set, the ensemble is stored/output every ensemble_logdt Myr. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)
+ensemble_startlogtime : Start log ensemble data storage/calculations/output at ensemble_startlogtime. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)
+ensemble_logtimes : When doing ensemble calculations/output, set this to act at log times rather than linear times. : (null)
+postagb_legacy_logging : Turn on post-AGB legacy logging. : (null)
+disc_legacy_logging : Turn on disc legacy logging. : (null)
+EMP_logg_maximum : Maximum logg that EMP stars are allowed to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_minimum_age. : (null)
+EMP_minimum_age : Minimum age that EMP stars are required to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum. : (null)
+EMP_feh_maximum : Maximum [Fe/H] that an EMP stars may have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default -2.0. : (null)
+CEMP_cfe_minimum : Minimum [C/Fe] that CEMP stars are required to have. See Izzard et al 2009. See also NEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 0.7. : (null)
+NEMP_cfe_minimum : Minimum [N/Fe] that NEMP stars are required to have. See Izzard et al 2009, Pols et al. 2012. See also CEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 1.0. : (null)
+thick_disc_start_age : Lookback time for the start of the thick disc star formation, e.g. 13e3 Myr. Units = Myr. : (null)
+thick_disc_end_age : Lookback time for the end of the thick disc star formation, e.g. 4e3 Myr. Units = Myr. : (null)
+thick_disc_logg_min : Minimum logg for thick disc giants to be logged. : (null)
+thick_disc_logg_max : Maximum logg for thick disc giants to be logged. : (null)
+escape_velocity : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 1e9 km/s. See also escape_fraction. : (null)
+escape_fraction : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 0.0. See also escape_velocity. : (null)
+colour_log : If set to True, thelog is coloured with ANSI colour formatting. Requires FILE_LOG to be defined. :
+log_filename : Location of the output logging filename. If set to &#34;/dev/null&#34; then there is no logging. :
+stopfile : File which, when it exists, will stop the current binary_c repeat run. :
+stardata_dump_filename : Location of the stardata dump file. :
+stardata_load_filename : Location of the stardata file to load. :
+api_log_filename_prefix : Location of the output logging filename prefix for the API. If set to &#34;/dev/null&#34; then there is no logging. : 0
+hrdiag_output : Set to True to output high time-resolution Hertzstrpung-Russell diagram information. Requires HRDIAG. : (null)
+internal_buffering : Experimental. Set to non-zero values to implement internal buffering prior to output. For use with binary_grid, you shouldn&#39;t really be playing with this. : (null)
+eccentric_RLOF_model : Chooses which model is used to handle eccentric RLOF. Default is RLOF_ECCENTRIC_AS_CIRCULAR, i.e. ignore the eccentricity. Note: requires force_corotation_of_primary_and_orbit to be FALSE.
+ : (null)
+force_circularization_on_RLOF : If True forces circularization of stars and orbit when RLOF starts, this is as in the BSE algorithm. (True) : (null)
+wtts_log : If True, enables log file output for WTTS2. : (null)
+fabian_imf_log_time : Time at which to output for Fabian Schneider&#39;s IMF project. Requires FABIAN_IMF_LOG : Ignore
+fabian_imf_log_timestep : Timestep for Fabian Schneider&#39;s IMF project logging. Requires FABIAN_IMF_LOG : Ignore
+version : Display binary_c version and build information. Also performs timing tests. : Ignore
+dumpversion : Display binary_c version number (short format). : Ignore
+version_only : Display binary_c version number and build information, but do not perform timing tests or anything that requires stardata to be non-NULL. : Ignore
+
+############################################################
+##### Section Input
+############################################################
+MINT_dir : Location of MINT algorithm data. :
+MINT_data_cleanup : Activate checks on incoming data to try to account for problems. Will make data-loading slower, but may fix a few things. :
+MINT_MS_rejuvenation : Turn on or off (hydrogen) main-sequence rejuvenation. :
+MINT_remesh : Turn on or off MINT&#39;s remeshing. :
+MINT_use_ZAMS_profiles : Use chemical profiles at the ZAMS if MINT_use_ZAMS_profiles is TRUE, otherwise set homogeneous abundances. (Default is TRUE, so we use the profiles if they are available.) :
+MINT_disable_grid_load_warnings : Use this to explicitly disable MINT&#39;s warnings when loading a grid with, e.g., missing or too much data. :
+MINT_Kippenhahn : Turn on or off MINT&#39;s Kippenhahn diagrams. If 0, off, if 1, output star 1 (index 0), if 2 output star 2 (index 1). Default 0. :
+MINT_Kippenhahn_stellar_type : Stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for which Kippenhahn plot data should be output. :
+MINT_Kippenhahn_companion_stellar_type : Companion stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for the companion for which Kippenhahn plot data should be output. :
+MINT_nuclear_burning : Turn on or off MINT&#39;s nuclear burning algorithm. :
+MINT_minimum_shell_mass : Minimum shell mass in MINT&#39;s nuclear burning routines. :
+MINT_maximum_shell_mass : Maximum shell mass in MINT&#39;s nuclear burning routines. :
+
+############################################################
+##### Section I/O
+############################################################
+go : batchmode control command : Ignore
+gogo : batchmode control command : Ignore
+reset_stars : Reset the star structures. Used in batchmode : Ignore
+reset_stars_defaults : Reset the star structures and set defaults. Used in batchmode : Ignore
+defaults : Reset all defaults. Used in batchmode : Ignore
+echo : Activate batchmode command echoing, i.e. when you enter a command, binary_c repeats the command then executes it. : Ignore
+noecho : Deactivate batchmode command echoing. See &#39;echo&#39;. : Ignore
+noechonow : Deactivate batchmode command echoing. See &#39;echo&#39;. : Ignore
+bye : Quit binary_c. Used in batchmode. : Ignore
+fin : batchmode control command : Ignore
+reset_prefs : Reset preferences struct. Used in batchmode : Ignore
+status : Output batchmode status information. : Ignore
+
+############################################################
+##### Section Algorithms
+############################################################
+repeat : If &gt; 1, repeats the system as many times as required. Handy if you&#39;re using Monte-Carlo kicks and want to sample the parameter space well. Also, if you are running speed tests this is good to give a statistically more reasonable result. (See e.g. &#39;tbse pgo&#39;). : (null)
+random_systems : Experimental. Use this to apply random initial system parameters (masses, separations, etc.). Useful for testing only. : (null)
+
+############################################################
+##### Section Misc
+############################################################
+random_seed : Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)
+random_systems_seed : Random number seed for the generation of random systems. See random_systems and random_seed. : (null)
+random_skip : Skip the first &lt;random_seed&gt; random numbers that are generated. Usually this is 0 so they are all used. : (null)
+idum : [NB: deprecated, please use &#39;random_seed&#39; instead.] Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)
+reverse_time : Make time go backwards. To be considered very experimental! : (null)
+start_time : Start time for the simulation. : (null)
+warmup_cpu : Uses the CPU at maximum power the given number of seconds, prior to running normal stellar evolution. : Ignore
+help : Display help pages. Usage: --help &lt;help topic&gt;. : Ignore
+argopts : Display argument options. Usage: --argopts &lt;argument&gt;. : Ignore
+help_all : Display all help pages. : Ignore
+list_args : Display list of arguments with their default values. Useful for batchmode. : Ignore
+
+</pre></div></div>
+</div>
+<p>We can get all the parameter names and their default values with return_arglines(): (abridged output)</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[20]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_arglines</span><span class="p">()</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+__ARG_BEGIN
+metallicity = 0.02
+effective_metallicity = -1
+M_1 = 0
+</pre></div></div>
+</div>
+<p>Lastly, we can ask binary_c to determine the minimum period or maximum mass for RLOF at the ZAMS: Both of them need an argstring as input</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># Here we set up the argument string that is passed to the bindings</span>
+<span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">binary_c M_1 </span><span class="si">{M_1}</span><span class="s2"> orbital_period </span><span class="si">{orbital_period}</span><span class="s2"> eccentricity </span><span class="si">{eccentricity}</span><span class="s2"> metallicity </span><span class="si">{metallicity}</span><span class="s2"> max_evolution_time </span><span class="si">{max_evolution_time}</span><span class="s2"></span>
+<span class="s2">&quot;&quot;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="mi">4500</span><span class="p">,</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span>
+    <span class="n">metallicity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>
+<span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+
+<span class="c1">#</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_minimum_orbit_for_RLOF</span><span class="p">(</span><span class="n">argstring</span><span class="p">,</span> <span class="n">store_capsule</span><span class="o">=</span><span class="n">store_memaddr</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+MINIMUM SEPARATION 0.31
+MINIMUM PERIOD 0.00632092
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[46]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># Here we set up the argument string that is passed to the bindings</span>
+<span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">binary_c M_1 </span><span class="si">{M_1}</span><span class="s2"> orbital_period </span><span class="si">{orbital_period}</span><span class="s2"> eccentricity </span><span class="si">{eccentricity}</span><span class="s2"> metallicity </span><span class="si">{metallicity}</span><span class="s2"> max_evolution_time </span><span class="si">{max_evolution_time}</span><span class="s2"></span>
+<span class="s2">&quot;&quot;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span>
+    <span class="n">M_2</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="mf">0.0001</span><span class="p">,</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span>
+    <span class="n">metallicity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>
+<span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+
+<span class="c1">#</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">return_maximum_mass_ratio_for_RLOF</span><span class="p">(</span><span class="n">argstring</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+MAXIMUM MASS RATIO 0.0141
+
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span>
+</pre></div>
+</div>
+</div>
+</div>
+</div>
+</div>
+
+
+           </div>
+           
+          </div>
+          <footer>
+  
+    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+      
+        <a href="binary_c_parameters.html" class="btn btn-neutral float-right" title="Binary_c parameters" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+      
+      
+        <a href="notebook_extra_features.html" class="btn btn-neutral float-left" title="Extra features and functionality of binarycpython" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+      
+    </div>
+  
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>
+        
+        &copy; Copyright 2021, David Hendriks, Robert Izzard
+
+    </p>
+  </div>
+    
+    
+    
+    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
+    
+    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
+    
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+<br><br>
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+<br><br>
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+
+
+
+</footer>
+
+        </div>
+      </div>
+
+    </section>
+
+  </div>
+  
+
+  <script type="text/javascript">
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+
+  
+  
+    
+   
+
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/notebook_api_functionality.ipynb b/docs/build/html/notebook_api_functionality.ipynb
new file mode 100644
index 000000000..d81c31711
--- /dev/null
+++ b/docs/build/html/notebook_api_functionality.ipynb
@@ -0,0 +1,951 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "cb9d00f5-9613-471e-a4bb-6181311bf73b",
+   "metadata": {},
+   "source": [
+    "# Using the API functionality of binarycpython\n",
+    "This notebook shows how to use the API functions that interface with binary_c. It usually is better to use wrapper functions that internally use these API functions, because most of the output here is very raw\n",
+    "\n",
+    "Binarycpython uses the Python-C extension framework to interface Python with C. The sourcecode for this is contained in `src/binary_c_python.c`, and the functions are available via `from binarycpython import _binary_c_bindings`.\n",
+    "\n",
+    "The following functions are available through the API: (run cell below)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "ded7eaf6-e1ba-46c2-9f6f-9ebcb14a264d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on module binarycpython._binary_c_bindings in binarycpython:\n",
+      "\n",
+      "NAME\n",
+      "    binarycpython._binary_c_bindings - Module to interface the Binary_c API with python.\n",
+      "\n",
+      "FUNCTIONS\n",
+      "    free_persistent_data_memaddr_and_return_json_output(...)\n",
+      "        Frees the persistent_data memory and returns the json output\n",
+      "    \n",
+      "    free_store_memaddr(...)\n",
+      "        Frees the store memaddr\n",
+      "    \n",
+      "    return_arglines(...)\n",
+      "        Return the default args for a binary_c system\n",
+      "    \n",
+      "    return_help(...)\n",
+      "        Return the help info for a given parameter\n",
+      "    \n",
+      "    return_help_all(...)\n",
+      "        Return an overview of all the parameters, their description, categorized in sections\n",
+      "    \n",
+      "    return_maximum_mass_ratio_for_RLOF(...)\n",
+      "        Returns a string containing the maximum mass ratio for which a binary system does not RLOF at zams. Optionally accepts a store_capsule. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_minimum_orbit_for_RLOF(...)\n",
+      "        Returns a string containing the minimum orbit and separation for which a binary system does not RLOF at zams. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_persistent_data_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_store_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_version_info(...)\n",
+      "        Return the version information of the used binary_c build\n",
+      "    \n",
+      "    run_system(...)\n",
+      "        Function to run a system. This is a general function that will be able to handle different kinds of situations: single system run with different settings, population run with different settings, etc. To avoid having too many functions doing slightly different things. \n",
+      "        \n",
+      "        Arguments:\n",
+      "                argstring: argument string for binary_c\n",
+      "                (opt) custom_logging_func_memaddr: memory address value for custom logging function. Default = -1 (None)\n",
+      "                (opt) store_memaddr: memory adress of the store. Default = -1 (None)\n",
+      "                (opt) write_logfile: Boolean (in int form) for whether to enable the writing of the log function. Default = 0\n",
+      "                (opt) population: Boolean (in int form) for whether this system is part of a population run. Default = 0.\n",
+      "    \n",
+      "    test_func(...)\n",
+      "        Function that contains random snippets. Do not expect this to remain available, or reliable. i.e. dont use it.\n",
+      "\n",
+      "FILE\n",
+      "    /home/david/.pyenv/versions/3.6.4/envs/dev-binarycpython3.6.4/lib/python3.6/site-packages/binarycpython/_binary_c_bindings.cpython-36m-x86_64-linux-gnu.so\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "help(_binary_c_bindings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7ddede71-ffaa-4b24-aece-e94128a60d7f",
+   "metadata": {},
+   "source": [
+    "There are three main categories of functions:\n",
+    "\n",
+    "- Functions to get information from binary_c: these can be used to evolve systems, and get utility information from binary_c.\n",
+    "    - run_system\n",
+    "    - return_minimum_orbit_for_RLOF\n",
+    "    - return_maximum_mass_ratio_for_RLOF\n",
+    "    - return_help\n",
+    "    - return_help_all\n",
+    "    - return_arglines\n",
+    "\n",
+    "- Memory creation functions: these can be used to have binary_c allocate memory which is used or written to by binary_c\n",
+    "    - return_persistent_data_memaddr\n",
+    "    - return_store_memaddr\n",
+    "\n",
+    "- Memory freeing functions: These can be used to free the allocated memory, and in the case of persistent memory it will also return the contents of the ensemble\n",
+    "    - free_persistent_data_memaddr_and_return_json_output\n",
+    "    - free_store_memaddr"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0dd3e115-1571-42f7-9ab9-cf7688fa28c1",
+   "metadata": {},
+   "source": [
+    "## Example usage:"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5015daa-35ab-4736-a04d-f3cbe661638c",
+   "metadata": {},
+   "source": [
+    "### Setting up, using and freeing store"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "10a74d5a-a3d5-4543-a5bc-20d1fe885bb4",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<capsule object \"STORE\" at 0x7f163859d0c0>\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# allocating store memory\n",
+    "store_memaddr = _binary_c_bindings.return_store_memaddr()\n",
+    "print(store_memaddr)\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.run_system(argstring, store_memaddr=store_memaddr)\n",
+    "print(output)\n",
+    "\n",
+    "# Freeing store\n",
+    "_binary_c_bindings.free_store_memaddr(store_memaddr)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e9da5fc6-e680-483c-982e-4819767ed5b2",
+   "metadata": {},
+   "source": [
+    "### Getting information from binary_c"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "24f7ffe5-0076-459d-a37f-254e10d0d9f9",
+   "metadata": {},
+   "source": [
+    "We can get information for a parameter via return_help(parameter_name):\n",
+    "This will return an unparsed output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "318874f6-7acf-49bb-9786-299d4dffc0b3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "binary_c help for variable : M_1 <Float>\n",
+      "\n",
+      "The initial mass of star one (in solar units, internally this is star index 0).\n",
+      "\n",
+      "Default : 0\n",
+      "\n",
+      "\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help('M_1'))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f7fafce6-a522-43ac-a0c2-15a3db393b49",
+   "metadata": {},
+   "source": [
+    "We can get information on all available parameters via return_help(parameter_name):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "d7e757ae-579c-42a2-a310-f0401b7800e8",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "############################################################\n",
+      "##### Section Stars\n",
+      "############################################################\n",
+      "metallicity : This sets the metallicity of the stars, i.e. the amount (by mass) of matter which is not hydrogen or helium. If you are using the BSE algorithm, this must be 1e-4 <= metallicity <= 0.03. See also nucsyn_metallicity and effective_metallicity. : (null)\n",
+      "effective_metallicity : This sets effective metallicity of stars as used in routines like the Schneider wind loss. If not set, or set to DEFAULT_TO_METALLICITY (==-1, the default), this is just the same as metallicity. The main difference between effective_metallicity and metallicity is the range of validity: 0 <= effective_metallicity <= 1, while metallicity's range of validity is limited by the stellar evolution algorithm (so, for BSE, is 1e-4 <= metallicity <= 0.03). : (null)\n",
+      "M_1 : The initial mass of star one (in solar units, internally this is star index 0). : (null)\n",
+      "M_2 : The initial mass of star two (in solar units, internally this is star index 1). : (null)\n",
+      "M_3 : The initial mass of star three (in solar units, internally this is star index 2). : (null)\n",
+      "M_4 : The initial mass of star four (in solar units, internally this is star index 3). : (null)\n",
+      "vrot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot2,3,4. : (null)\n",
+      "vrot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,3,4. : (null)\n",
+      "vrot3 : The initial equatorial rotational velocity of star three (in km/s, internally this is star index 2). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,4. : (null)\n",
+      "vrot4 : The initial equatorial rotational velocity of star four (in km/s, internally this is star index 3). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,3. : (null)\n",
+      "Prot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). See also Prot2,3,4. : (null)\n",
+      "Prot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). See also Prot1,3,4. : (null)\n",
+      "Prot3 : The initial equatorial rotational period of star three (in days, internally this is star index 2). See also Prot1,2,4. : (null)\n",
+      "Prot4 : The initial equatorial rotational period of star four (in days, internally this is star index 3). See also Prot1,2,3. : (null)\n",
+      "inclination1 : The initial inclination of star one (in degrees). : (null)\n",
+      "inclination2 : The initial inclination of star two (in degrees). : (null)\n",
+      "inclination3 : The initial inclination of star three (in degrees). : (null)\n",
+      "inclination4 : The initial inclination of star four (in degrees). : (null)\n",
+      "B_1 : The initial magnetic field of star one (in Gauss, internally this is star index 0). : (null)\n",
+      "B_2 : The initial magnetic field of star two (in Gauss, internally this is star index 1). : (null)\n",
+      "B_3 : The initial magnetic field of star three (in Gauss, internally this is star index 2). : (null)\n",
+      "B_4 : The initial magnetic field of star four (in Gauss, internally this is star index 3). : (null)\n",
+      "B_inclination1 : The initial inclination of the magnetic field of star one (in degrees). : (null)\n",
+      "B_inclination2 : The initial inclination of the magnetic field of star two (in degrees). : (null)\n",
+      "B_inclination3 : The initial inclination of the magnetic field of star three (in degrees). : (null)\n",
+      "B_inclination4 : The initial inclination of the magnetic field of star four (in degrees). : (null)\n",
+      "stellar_type_1 : Set the stellar type of star 1 (internal index 0), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_2 : Set the stellar type of star 2 (internal index 1), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_3 : Set the stellar type of star 3 (internal index 2), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_4 : Set the stellar type of star 4 (internal index 3), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "max_stellar_type_1 : The maximum stellar type of star 1 (internal index 0). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value. \n",
+      " : (null)\n",
+      "max_stellar_type_2 : The maximum stellar type of star 2 (internal index 1). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_3 : The maximum stellar type of star 3 (internal index 2). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_4 : The maximum stellar type of star 4 (internal index 3). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "probability : The probability is a weighting applied to the star based on, say, the initial mass function. When running a grid of stars to simulate *all* stars, the summed probability of all the stars should be 1.0. : (null)\n",
+      "phasevol : The system's phase volume, used by binary_grid. : (null)\n",
+      "stellar_structure_algorithm : Set the stellar structure algorithm. 0=modified BSE (default), 1=none, 2=external function (must be defined by the calling code), 3=binary_c (not yet implemented). : (null)\n",
+      "solver : The type of solver. Default is the Forward-Euler (0), but could be RK2 (1), RK4 (2) or a predictor-corretor (3). : (null)\n",
+      "max_evolution_time : Set the maximum age for the stars (Myr). : (null)\n",
+      "max_model_number : Set the maximum number of models, ignored if 0 (default is 0). : (null)\n",
+      "monte_carlo_kicks : Turn on Monte-Carlo SN kicks. On (True) by default, and indeed other algorithms are probably broken. : (null)\n",
+      "disable_debug : Disables debug output. Only has an effect when DEBUG is 1, which probably requires a rebuild. Default FALSE. : (null)\n",
+      "timestep_logging : Turn on timestep logging (default is False). : (null)\n",
+      "rejects_in_log : Show timestep rejections in the main log (default is False). : (null)\n",
+      "vandenHeuvel_logging : Turn on van den Heuvel logging (default is False). : (null)\n",
+      "evolution_splitting : If True, turn on splitting of an evolutionary run if splitpoint (e.g. supernova) occurs. : (null)\n",
+      "disable_events : Whether to disable the new events code (defaults to False, so we use events by default)\n",
+      " : (null)\n",
+      "evolution_splitting_sn_eccentricity_threshold : Threshold eccentricity above which evolution splitting happens in a system with no SN kick. (0.01) : (null)\n",
+      "evolution_splitting_sn_n : Number of runs to split into when a SN occurs. : (null)\n",
+      "evolution_splitting_maxdepth : Max number of splits in an evolutionary run. : (null)\n",
+      "equation_of_state_algorithm : Set the equation of state algorithm. 0 = Paczynski. : (null)\n",
+      "opacity_algorithm : Set the opacity algorithm. 0 = Paczynski, 1 = Ferguson/Opal. : (null)\n",
+      "wind_mass_loss : Defines the algorithm used for stellar winds. 0 = none, 1 = Hurley et al. (2002), 2 = Schneider (2018). : 0\n",
+      "gbwind : Wind prescription for first red giant branch stars.  0=Reimers (Hurley et al 2000/2002; choose gb_reimers_eta=0.5 for their mass loss rate), 1=Schroeder+Cuntz 2005 (set gb_reimers_eta=1.0 for their mass loss rate). : (null)\n",
+      "mattsson_Orich_tpagbwind : Experimental : turns on Mattsson's TPAGB wind when the star is oxygen rich. Requires MATTSSON_MASS_LOSS. : (null)\n",
+      "magnetic_braking_factor : Multiplier for the magnetic braking angular momentum loss rate. : (null)\n",
+      "magnetic_braking_gamma : gamma factor in Rappaport style magnetic braking expression. : (null)\n",
+      "magnetic_braking_algorithm : Algorithm for the magnetic braking angular momentum loss rate. 0 = Hurley et al. 2002, 1 = Andronov, Pinnsonneault and Sills 2003, 2 = Barnes and Kim 2010  : (null)\n",
+      "helium_flash_mass_loss : Mass to be lost at the helium flash. : (null)\n",
+      "gb_reimers_eta : First red giant branch wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) : (null)\n",
+      "gbwindfac : Multiplier for the giant branch wind mass loss rate : (null)\n",
+      "tpagbwindfac : Multiplier for the TPAGB wind mass loss rate : (null)\n",
+      "eagbwindfac : Multiplier for the EAGB wind mass loss rate : (null)\n",
+      "nieuwenhuijzen_windfac : Multiplier for the Nieuwenhuijzen & de Jager wind mass loss rate : (null)\n",
+      "tpagbwind : Wind prescription during the TPAGB. 0=Karakas 2002 (a modified Vassiliadis and Wood 1993), 1=Hurley et al 2000/2002 (Vassiliadis and Wood 1993), 2=Reimers, 3=Bloecker, 4=Van Loon,  5=Rob's C-wind (broken?), 6,7=Vassiliadis and Wood 1993 (Karakas,Hurley variants respectively) when C/O>1, 8=Mattsson, 9 = Goldman et al. (2017), 10 = Beasor et al. (2020). : (null)\n",
+      "eagbwind : Wind prescription during the EAGB. 0=BSE (Hurley+2002, based on VW93), 1 = Goldman et al. (2017), 2 = Beasor et al. (2020). : (null)\n",
+      "wind_gas_to_dust_ratio : Gas to dust ratio used in wind calculations (e.g. Goldman et al. 2017). Typically 200 (Milky Way)-500 (Magellanic Clouds). Default is 200, approximately as in MW stars. : (null)\n",
+      "vwind_multiplier : Multiplier for the stellar wind velocity. : (null)\n",
+      "vwind_beta : Beta for stellar wind speed calculations, where vwind=sqrt(beta) * escape velocity. Default 0.125 (from BSE, Hurley et al. 2002).  : (null)\n",
+      "superwind_mira_switchon : In the Vassiliadis and Wood (1993) AGB wind prescription, the superwind is turned on at a given Mira period, usually 500 days. You can vary when this switch-on happens with this parameter. : (null)\n",
+      "vw93_mira_shift : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate depends on the Mira period plus this offset. Requires VW93_MIRA_SHIFT. : (null)\n",
+      "vw93_multiplier : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate is multiplied by this factor. Requires VW93_MULTIPLIER. : (null)\n",
+      "tpagb_reimers_eta : TPAGB Reimers wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) Note that Reimers is not the default TPAGB wind prescription. See also tpagbwind. : (null)\n",
+      "artificial_mass_accretion_rate%d : Constant mass accretion rate for star <n>. : (null)\n",
+      "artificial_angular_momentum_accretion_rate%d : Constant angular momentum accretion for star <n>. : (null)\n",
+      "artificial_orbital_angular_momentum_accretion_rate : Constant angular momentum accretion rate on the orbit. : (null)\n",
+      "artificial_accretion_start_time : Time at which artificial accretion stars. Ignored if <0 (default is -1). : (null)\n",
+      "artificial_accretion_end_time : Time at which artificial accretion ends. Ignored if <0 (default is -1). : (null)\n",
+      "wr_wind : Massive-star (WR) wind prescription. 0 = Hurley et al 2000/2002, 1=Maeder and Meynet, 2=Nugis and Lamers, 3=John Eldridge's version of Vink's early-2000s wind (See Lynnette Dray's thesis, or John Eldridge's thesis) : (null)\n",
+      "wr_wind_fac : Massive-star (WR) wind multiplication factor. : (null)\n",
+      "wrwindfac : Massive-star (WR) wind multiplication factor. Synonymous with wr_wind_fac (which you should use instead). : (null)\n",
+      "BH_prescription : Black hole mass prescrition: relates the mass of a newly formed black hole to its progenitor's (CO) core mass. 0=Hurley et al 2000/2002, 1=Belczynski (early 2000s). : (null)\n",
+      "PPISN_prescription : (Pulsational) Pair-Instability Supernova prescription: Relates initial helium core mass of star to whether the star undergoes PPISN or PISN. Requires PPISN flag to be True (see binary_c_parameters.h). 0=no ppisn, 1=Farmer et al 2019. : Ignore\n",
+      "sn_kick_distribution_II : Set the distribution of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_ECAP : Set the distribution of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_NS_NS : Set the distribution of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IBC : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_GRB_COLLAPSAR : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_TZ : Set the distribution of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_AIC_BH : Set the distribution of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_BH : Set the distribution of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_NS : Set the distribution of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD : Set the distribution of speeds applied to any survivor of a hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD_subluminous : Set the distribution of speeds applied to any survivor of a subluminous hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PPISN : Set the distribution of speeds applied to PPISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PISN : Set the distribution of speeds applied to PISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PHDIS : Set the distribution of speeds applied to PHDIS supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_II : Set the dispersion of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_ECAP : Set the dispersion of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_NS_NS : Set the dispersion of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IBC : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_GRB_COLLAPSAR : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_TZ : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_AIC_BH : Set the dispersion of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_BH : Set the dispersion of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_NS : Set the dispersion of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD : Set the dispersion of speeds applied to the survivor of a SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD_subluminous : Set the dispersion of speeds applied to the survivor of a subluminous SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PPISN : Set the dispersion of speeds applied to the survivor of a PPISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PISN : Set the dispersion of speeds applied to the survivor of a PISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PHDIS : Set the dispersion of speeds applied to the survivor of a PHDIS supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_companion_IA_He : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia He supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_ELD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia ELD (sub-Mch) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an accretion induced collapse (supernova) occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_ECAP : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an electron capture supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_He_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia helium merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_NS_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron-star neutron-star merger. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_GRB_COLLAPSAR : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a GRB Collapsar (rapidly rotating SN Ibc) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_HeStarIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a He-star Ia supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IBC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type Ib/c supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_II : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type II supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type IIa supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_WDKICK : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a WD is kicked. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_TZ : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Thorne-Zytkow object is formed. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron star collapses to a black hole. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when two black holes merge. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a black hole merges with a neutron star. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD_subluminous : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a subluminous hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PPISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PPISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PHDIS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PHDIS supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "wd_sigma : Set the speed at which white dwarfs are kicked when they form, in km/s. Default is zero (i.e. no kick). Requires WD_KICKS. : (null)\n",
+      "wd_kick_direction : Set the direction of white dwarf kicks. 0 = random, 1 = up, 2 = forward, 3 = backward, 4 = inward, 5 = outward. Requires WD_KICKS. : (null)\n",
+      "wd_kick_when : Decide when to kick a white dwarf. 0=at birth, 1=at first RLOF, 2=at given pulse number (see wd_kick_pulse_number), 3 at every pulse Requires WD_KICKS. : (null)\n",
+      "wd_kick_pulse_number : Apply a kick to a star at a desired pulse number on the TPAGB (i.e. pre-WD). Requires WD_KICKS. : (null)\n",
+      "minimum_helium_ignition_core_mass : Minimum helium core mass required to ignite helium in the case that the hydrogen envelope is stripped on the giant branch, e.g. to make an sdB or sdO star. Typically 0.4, if 0.0 then the BSE algorithm (based on the total mass) is used. : (null)\n",
+      "minimum_CO_core_mass_for_carbon_ignition : Minimum CO core mass for carbon ignition, assuming Mc,bagb>1.6Msun. Typically around 1.08Msun (Pols+1998). : (null)\n",
+      "minimum_CO_core_mass_for_neon_ignition : Minimum CO core mass for neon ignition. Typically around 1.42Msun. Stars that have cores that ignite carbon, but not neon explode in electon-capture supernovae. : (null)\n",
+      "minimum_mcbagb_for_nondegenerate_carbon_ignition : Minimum Mc,bagb (core mass at the base of the AGB) for non-degenerate carbon ignition. Typically around 2.25Msun (Pols+1998). : (null)\n",
+      "maximum_mcbagb_for_degenerate_carbon_ignition : Maximum Mc,bagb (core mass at the base of the AGB) for degenerate carbon ignition. Typically around 1.6Msun (Pols+1998). : (null)\n",
+      "max_neutron_star_mass : Maximum mass of a neutron star before it collapses to a black hole. Typically around 2Msun. : (null)\n",
+      "chandrasekhar_mass : The Chandrasekhar mass, usually 1.44Msun : (null)\n",
+      "delta_mcmin : A parameter to reduce the minimum core mass for third dredge up to occur on the TPAGB. As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "lambda_min : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. See also lambda_multiplier. : (null)\n",
+      "lambda_multiplier : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "minimum_envelope_mass_for_third_dredgeup : The minimum envelope mass for third dredge up on the TPAGB. Early, solar metallicity models by Straniero et al suggested 0.5Msun is typical. However, circumstantial evidence (Izzard et al 2009) as well as newer models by Stancliffe and Karakas suggest that at low metallicity a value nearer zero is more appropriate. : (null)\n",
+      "mass_of_pmz : The mass in the partial mixing zone of a TPAGB star, using the Karakas 2012 tables. Ask Carlo Abate for more details, or see the series of papers Abate et al 2012, 2013, 2014. Requires NUCSYN and USE_TABULAR_INTERSHELL_ABUNDANCES_KARAKAS_2012. : (null)\n",
+      "c13_eff : The \"efficiency\" of partial mixing in a TPAGB star intershell region, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "mc13_pocket_multiplier : Multiplies the mass in the partial mixing zone of a TPAGB star, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "tides_convective_damping : Tidal convective damping algorithm. 0=TIDES_HURLEY2002 Zahn 197x timescales + Hut, as in Hurley et al (2002), 1 = TIDES_ZAHN1989 : Zahn 1989 lambdas + Hut. : (null)\n",
+      "E2_prescription : Choose how to calculate the E2 structural parameter (used in tidal timescale calculations). 0=Hurley 1=Izzard (see Siess et al 2013). : (null)\n",
+      "dtfac : A parameter to decrease the timestep ONLY during the TPAGB phase. : (null)\n",
+      "hbbtfac : A parameter to modulate the temperature at the base of the hot-bottom burning zone in TPAGB stars. (Works only if NUCSYN is defined) : (null)\n",
+      "wind_multiplier_%d : Wind multiplier for the stellar type specified by the intger %d. By default these are all 1.0. : (null)\n",
+      "wind_type_multiplier_%d : Wind multiplier for different types of wind (MS, GB, AGB, WR, LBV, OTHER), given by the integer %d. By default these are all 1.0. : (null)\n",
+      "pre_main_sequence : Set to True to turn on pre-main sequence evolution. Currently this is not a special stellar type, rather the first (small) fraction of the main sequence has increased radii to match the Railton et al 2014 fits to Tout's pre-main sequence stars. Requires PRE_MAIN_SEQUENCE. See also pre_main_sequence_fit_lobes. : (null)\n",
+      "pre_main_sequence_fit_lobes : Set to True force a pre-main sequence star into its Roche lobe. This is done by artificially aging it. Requires PRE_MAIN_SEQUENCE : (null)\n",
+      "small_envelope_method : Choose the method used to determine the stellar radius when the envelope mass is very thin. 0 = Hurley et al. (2002), 1 = Miller Bertolami et al. (2016+) for GB and AGB stars only. : (null)\n",
+      "timestep_modulator : Multiplier applied to the global timestep. Requires TIMESTEP_MODULATION. : (null)\n",
+      "timestep_multiplier%d : Multiplier applied to timestep limit <n>. : (null)\n",
+      "maximum_timestep : The maximum timestep (MYr). : (null)\n",
+      "zoomfac_multiplier_decrease : When a timestep is rejected, decrease the timestep by this factor (0.5). : (null)\n",
+      "zoomfac_multiplier_increase : When a timestep is rejected, zooms, then succeeds, increase the timestep by this factor (1.2). : (null)\n",
+      "maximum_timestep_factor : The maximum factor between two subsequent timesteps (1.2). : (null)\n",
+      "maximum_nuclear_burning_timestep : The maximum timestep (MYr) in any nuclear burning phase. : (null)\n",
+      "nova_retention_method : Algorithm used to calculate the amount of mass retained during a nova explosion. 0=use nova_retention_fraction. (other methods pending) : (null)\n",
+      "MINT_metallicity : This sets the metallicity for MINT. It is ignored if set to -1.0, the default, in which case the normal metallicity parameter is used. : (null)\n",
+      "gaia_Teff_binwidth : log10(Effective temperature) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_L_binwidth : log10(luminosity) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_colour_transform_method : Use this to select the method used to transform to Gaia colours from other colour schemes. GAIA_CONVERSION_UBVRI_UNIVARIATE_JORDI2010 = 0 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_UBVRI_BIVARIATE_JORDI2010 = 1 Jordi et al.'s bivariate UBVRI fits, GAIA_CONVERSION_ugriz_UNIVARIATE_JORDI2010 = 2 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_ugriz_BIVARIATE_JORDI2010 = 3 Jordi et al.'s univariate ugriv fits, GAIA_CONVERSION_UBVRI_UNIVARIATE_EVANS2018 = 4 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_ugriz_UNIVARIATE_EVANS2018 = 5 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_UBVRI_RIELLO2020 = 6 Riello et al. (2020, DR3) fits, GAIA_CONVERSION_ugriz_RIELLO2020 = 7 Riello et al. (2020, DR3) fits. : (null)\n",
+      "rotationally_enhanced_mass_loss : Set to 1 to enable rotationally enhanced mass loss rate algorithms: 0= none, 1=formula cf. Langer models (=ROTATIONALLY_ENHANCED_MASSLOSS_LANGER_FORMULA), 2=limit accretion rate before wind loss is applied, 3 = both 1 and 2. See also rotationally_enhanced_exponent : (null)\n",
+      "AGB_core_algorithm : Algorithm to use for calculating AGB core masses. 0=Hurley et al. 2002 if no NUCSYN, Karakas 2002 if NUCSYN is defined; 1=Hurley et al. 2002 (overshooting models); 1=Karakas 2002 (non-overshooting models). : (null)\n",
+      "AGB_radius_algorithm : Algorithm to use for calculating radii on the TPAGB. : (null)\n",
+      "AGB_luminosity_algorithm : Algorithm to use for calculating luminosities on the TPAGB. : (null)\n",
+      "AGB_3dup_algorithm : Algorithm to use for calculating third dredge up efficiency on the TPAGB. : (null)\n",
+      "overspin_algorithm : Algorithm to determine what we do when a star is rotating at its breakup velocity. OVERSPIN_BSE (0) conservatively transfers the angular momentum back to the orbit. OVERSPIN_MASSLOSS uses the rotationally_enhanced_massloss parameter to lose mass which carries away the angular momentum. : (null)\n",
+      "rotationally_enhanced_exponent : The exponent (power) by which rotationally enhanced mass loss is raised. Requires ROTATIONALLY_ENHANCED_MASS_LOSS. See also rotationally_enhanced_mass_loss. : (null)\n",
+      "batchmode : Set the batchmode control variable. Use only if you know what you are doing! : (null)\n",
+      "speedtests : If True, turns on speedtests during version information (off by default). : (null)\n",
+      "use_fixed_timestep_%d : Set to True to use fixed timestep <n>, False to turn off. Fixed timesteps are on (this is True) by default. : (null)\n",
+      "task%d : Control tasks to be performed by binary_c. By default, these are all TRUE. For more information see binary_c_macros.h, particularly the BINARY_C_TASK_* macros. : (null)\n",
+      "orbiting_object : Usage: --orbiting_object mass,spinrate,central_object,period. : 1.0\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_wind_accretion_multiplier : Multiplier for wind accretion on orbiting objects. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "orbiting_objects_close_pc_threshold : How close are orbiting objects allowed to be? Set this to be the absolute percentage difference minimum. : (null)\n",
+      "orbiting_objects_tides_multiplier : Multiplier for tidal torques on orbiting objects. : (null)\n",
+      "evaporate_escaped_orbiting_objects : If True, evaporate orbiting objects that have escaped the system. : (null)\n",
+      "RLOF_transition_objects_escape : If True, objects that escape their Roche lobe are ejected from the system, otherwise they are placed just outside the minimum stable orbit. : (null)\n",
+      "PN_resolve : If True, the timestep will be shortened to resolve better the PN phase (FALSE). : (null)\n",
+      "PN_resolve_minimum_luminosity : The luminosity above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_maximum_envelope_mass : The envelope mass below which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_minimum_effective_temperature : The minimum effective temperature above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_fast_wind : If True, thin-envelope PNe will have fast winds (FALSE). : (null)\n",
+      "PN_fast_wind_dm_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_mdot_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_dm_AGB : The envelope mass below which fast wind used during the AGB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "PN_fast_wind_mdot_AGB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "HeWD_HeWD_ignition_mass : HeWD-HeWD mergers above this mass reignite helium. (0.3) : (null)\n",
+      "wind_Nieuwenhuijzen_luminosity_lower_limit : Above this luminosity we activate the Nieuwenhuijzen and de Jager wind (4e3 Lsun). : (null)\n",
+      "wind_LBV_luminosity_lower_limit : Above this luminosity we activate the LBV wind (6e5 Lsun). : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Binary\n",
+      "############################################################\n",
+      "separation : Set the orbital separation (actually the semi-major axis) of the binary (internal index 0, stellar indices 0 and 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_triple : Set the orbital separation (actually the semi-major axis) of the triple (internal index 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_quadruple : Set the orbital separation (actually the semi-major axis) of the quadruple (internal index 2) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "orbital_period : Set the initial orbital period of the binary, stars 1 and 2 (internal indices 0 and 1) in days. See also separation. : (null)\n",
+      "orbital_period_triple : Set the initial orbital period of the triple in days. See also separation. : (null)\n",
+      "orbital_period_quadruple : Set the orbital period of the outer binary in a quadrulple (stars 3 and 4, internal indices 2 and 3) in days. See also separation. : (null)\n",
+      "eccentricity : Set the initial eccentricity of the binary orbit (stars 1 and 2, internal indices 0 and 1). : (null)\n",
+      "eccentricity_triple : Set the initial eccentricity of the triple orbit. : (null)\n",
+      "eccentricity_quadruple : Set the initial eccentricity of the outer binary of a quadruple (stars 3 and 4, internal indices 2 and 3). : (null)\n",
+      "incliniation : Set the initial orbital_inclination of the binary relative to zero. : (null)\n",
+      "incliniation_triple : Set the initial orbital_inclination of the triple orbit relative to zero. : (null)\n",
+      "incliniation_quadruple : Set the initial orbital_inclinationy of the quadruple orbit relative to zero. : (null)\n",
+      "orbital_phase : Set the initial orbital phase of the binary orbit. : (null)\n",
+      "orbital_phase_triple : Set the initial orbital phase of the triple orbit. : (null)\n",
+      "orbital_phase_quadruple : Set the initial orbital phase of the quadruple orbit. : (null)\n",
+      "argument_of_periastron : Set the initial argument of periastron of the binary orbit. : (null)\n",
+      "argument_of_periastron_triple : Set the initial argument of periastron of the triple orbit. : (null)\n",
+      "argument_of_periastron_quadruple : Set the initial argument of periastron of the quadruple orbit. : (null)\n",
+      "disc_timestep_factor : Factor that multiplies the natural timestep of a disc. : (null)\n",
+      "white_dwarf_cooling_model : White dwarf cooling model, relates age to luminosity. WHITE_DWARF_COOLING_MESTEL = 0 is Mestel's model, WHITE_DWARF_COOLING_MESTEL_MODIFIED = 1 is Hurley's modified Mestel model, WHITE_DWARF_COOLING_CARRASCO2014 = 2 is based on Carrasco (2014) tables.   : (null)\n",
+      "white_dwarf_radius_model : White dwarf radius model, radius to mass (and perhaps age). WHITE_DWARF_RADIUS_NAUENBERG1972 = 0 Nauenberg (1972), WHITE_DWARF_RADIUS_MU = 1 mu-dependent variant, WHITE_DWARF_RADIUS_CARRASCO2014 = 2 is based on Carrasco (2014) tables. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_accretion_method : Chooses where the mass that is accreted from the inner edge of a circumbinary disc goes, i.e. to which star. 0 = Young and Clarke 2015, 1 = Gerosa et al 2015, 2 = 50:50 (i.e. not dependence on mass). : (null)\n",
+      "cbdisc_inner_edge_stripping : If True, allow inner edge mass stripping. : (null)\n",
+      "cbdisc_end_evolution_after_disc : If True, stop evolution when a disc evaporates. : (null)\n",
+      "cbdisc_no_wind_if_cbdisc : If True, disable stellar winds when there is a circumbinary disc. : (null)\n",
+      "cbdisc_outer_edge_stripping : If True, allow outer edge mass stripping. : (null)\n",
+      "disc_n_monte_carlo_guesses : Number of monte carlo guesses to try in the disc solver if the normal list of guesses fails (0). : (null)\n",
+      "disc_log : If 1, turn on the disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log2d : If 1, turn on the 2d disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log_dt : If non-zero, only allows disc log output every disc_log_dt Myr. : (null)\n",
+      "disc_log_directory : Directory into which disc logging is sent (must exist!). : /tmp/\n",
+      "post_ce_adaptive_menv : If TRUE, and if post_ce_objects_have_envelopes is TRUE, then the envelope mass of a post-CE star is such that it sits just inside its Roche lobe. If FALSE then a fixed (thin) envelope mass is applied that depends on the stellar type (see macros POST_CE_ENVELOPE_DM_GB, POST_CE_ENVELOPE_DM_EAGB and POST_CE_ENVELOPE_DM_TPAGB). : (null)\n",
+      "post_ce_objects_have_envelopes : If TRUE then post-common-envelope objects have thin envelopes. You need this if you are to have post-CE post-AGB stars. Note that this *may* be unstable, i.e. you may end up having many CEEs. The mass in the envelope is controlled by post_ce_adaptive_menv. TRUE by default. : (null)\n",
+      "PN_comenv_transition_time : post-common envelope transition time in years (1e2).  This is the time taken to move from CEE ejection to Teff > 30e4 K. Hall et al. (2013) suggest ~100 years. : (null)\n",
+      "minimum_time_between_PNe : The minimum time (Myr) between planetary nebula detections. This prevents multiple, fast common envelopes triggering two PNe (0.1). : (null)\n",
+      "PN_Hall_fading_time_algorithm : In stars with low mass (<0.45Msun) cores, you can choose to set the PN fading time to either the minimum (PN_HALL_FADING_TIME_ALGORITHM_MINIMUM) or maximum (PN_HALL_FADING_TIME_ALGORITHM_MAXIMUM) as shown in Fig. 6 of Hall et al. (2013). : (null)\n",
+      "PPN_envelope_mass : Desired pre-planetary nebula (post-AGB) envelope mass. : (null)\n",
+      "cbdisc_eccentricity_pumping_method : Select from various eccentricity-pumping methods when there is a circumbinary disc. Requires DISCS. 0 = off. : (null)\n",
+      "cbdisc_viscous_photoevaporative_coupling : Set to 1 to turn on viscous-photoevaporative coupling in circumbinary discs. Requires DISCS. 0 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_NONE = off, 1 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_INSTANT instant, 2 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_VISCOUS slow, viscous wind. : (null)\n",
+      "cbdisc_inner_edge_stripping_timescale : Defines the timescale for mass loss from by inner edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_in. : (null)\n",
+      "cbdisc_outer_edge_stripping_timescale : Defines the timescale for mass loss from by outer edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_out. : (null)\n",
+      "cbdisc_viscous_L2_coupling : Set to 1 to turn on viscous-L2-loss coupling in circumbinary discs. Requires DISCS. 0 = off. : (null)\n",
+      "gravitational_radiation_model : Model for gravitational radiation from the system. 0=Hurley et al 2002 (Landau and Lifshitz 1951). 1 = as 0 but only when there is no RLOF. 2 = none. : (null)\n",
+      "nova_irradiation_multiplier : Multiplier for nova-radiative induced mass loss. (Shara+1986) : (null)\n",
+      "gravitational_radiation_modulator_J : Modulator for gravitational wave radiation angular momentum loss rate (1.0). : (null)\n",
+      "gravitational_radiation_modulator_e : Modulator for gravitational wave radiation eccentricity pumping rate (1.0). : (null)\n",
+      "nova_faml_multiplier : Nova friction-induced angular momentum loss multiplier. (Shara+1986) : (null)\n",
+      "RLOF_angular_momentum_transfer_model : Choose angular momentum transfer model in RLOF. 0=BSE (with discs), 1=conservative : (null)\n",
+      "post_SN_orbit_method : Method by which the post-SN orbit is calculated. 0=BSE, 1=Tauris&Taken 1998. : (null)\n",
+      "multiplicity : Multiplicity: 1=single star, 2=binary, 3=triple, 4=quadruple. : (null)\n",
+      "accretion_limit_eddington_steady_multiplier : Steady accretion is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_steady_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_LMMS_multiplier : Accretion from a low-mass, convective, main_sequence star is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_LMMS_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_WD_to_remnant_multiplier : Accretion from a WD onto a remnant star (e.g. another white dwarf, neutron star or black hole) is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_WD_to_remnant_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_thermal_multiplier : Mass transfer onto a MS, HG or CHeB star is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "accretion_limit_dynamical_multiplier : Mass transfer is limited by the accretor's dynamical rate times this multiplier. : (null)\n",
+      "donor_limit_envelope_multiplier : Mass transfer by RLOF is limited by this fraction of the donor's envelope mass per timestep : (null)\n",
+      "donor_limit_thermal_multiplier : Mass transfer by RLOF is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "donor_limit_dynamical_multiplier : Mass transfer by RLOF is limited by the donor's dynamical rate times this multiplier. : (null)\n",
+      "Bondi_Hoyle_accretion_factor : Wind accretion rate, as calculated by the Bondi-Hoyle-Littleton formula, multiplcation factor. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "tidal_strength_factor : A modulator for the tidal strength. If this factor > 1 then tides are stronger, i.e. tidal timescales are reduced. : (null)\n",
+      "hachisu_qcrit : Critical q=Maccretor/Mdonor above which Hachisu's disk wind turns on. : (null)\n",
+      "hachisu_disk_wind : Set to True to turn on Hachisu's disk wind when material accretes too fast onto a white dwarf. This helps to make more SNeIa. See also hachisu_qcrit. : (null)\n",
+      "mass_accretion_for_eld : The mass that must be accreted onto a COWD for it to ignite as an edge-lit detonation SNIa. : (null)\n",
+      "WDWD_merger_algorithm : Algorithm to be used when merging two white dwarfs. 0 = Hurley et al. (2002), 1 = Perets+ (2019), 2 = Chen+ (2016, todo)  : (null)\n",
+      "type_Ia_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from Chandrasekhar-mass exploders. 0 = DD7 (Iwamoto 1999), 1 = Seitenzahl 2013 3D hydro yields (you must also set Seitenzahl2013_model)  : (null)\n",
+      "Seitenzahl2013_model : Which of Seitenzahl et al. 2013's models to use? One of N1,N3,N5,N10,N20,N40,N100L,N100,N100H,N150,N200,N300C,N1600,N1600C,N100_Z0.5,N100_Z0.1,N100_Z0.01 (defaults to N100). : N1\n",
+      "type_Ia_sub_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from sub-Chandrasekhar-mass exploders. (Currently unused.) : (null)\n",
+      "max_HeWD_mass : The maximum mass a HeWD can have before it ignites helium (0.7). : (null)\n",
+      "merger_mass_loss_fraction : Fraction of the total mass which is lost when stars merge. : (null)\n",
+      "merger_angular_momentum_factor : When two stars merge the resulting single star retains a fraction of the total system angular momentum (or the critical spin angular momentum, if it is smaller) multiplied by this factor. : (null)\n",
+      "wind_angular_momentum_loss : Prescription for losing angular momentum in a stellar wind. 0=Hurley et al 2002 ('Tout') prescription, 1=lw i.e. a factor multiplying the specific orbital angular momentum, 2=lw hybrid for fast winds. Set wind_djorb_fac to the desired factor.. : (null)\n",
+      "wind_djorb_fac : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=0 (the Tout/Hurley et al 2002 prescription). See wind_angular_momentum_loss. : (null)\n",
+      "lw : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=1,2 (the 'lw' prescription). See wind_angular_momentum_loss. : (null)\n",
+      "VW93_EAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "VW93_TPAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "use_periastron_Roche_radius : Set this to True to use the Roche lobe radius at periastron, rather than (the default to) assume a circular orbit. This will be useful one day when we treat RLOF in eccentric orbits properly, hopefully. : (null)\n",
+      "qcrit_LMMS : Apply critical q=Mdonor/Maccretor value for low-mass main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_LMMS : Apply critical q=Mdonor/Maccretor value for (low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "mass_for_Hestar_Ia_upper : Only helium stars below this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_lower. : (null)\n",
+      "mass_for_Hestar_Ia_lower : Only helium stars above this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_upper. : (null)\n",
+      "alphaCB : Circumbinary disk viscosity parameter, alpha. : (null)\n",
+      "minimum_donor_menv_for_comenv : Minimum donor envelope mass for common envelope evolution to be triggered (Msun). Default 0. : (null)\n",
+      "comenv_prescription : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_prescription%d : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_ejection_spin_method : When a common envelope is ejected, we need to decide how fast the stars are left spinning. COMENV_EJECTION_SPIN_METHOD_DO_NOTHING (0) is the default, this just leaves the stars/stellar cores spinning with the same spin rate (omega = angular velocity) with which they entered the common envelope phase. COMENV_EJECTION_SPIN_METHOD_SYCHRONIZE instead tidally synchronizes the stars with their new orbital angular velocity. : (null)\n",
+      "comenv_merger_spin_method : When a common envelope binary merges, we need to decide how fast the resulting single star is left spinning. COMENV_MERGER_SPIN_METHOD_SPECIFIC (0) is the default, this preserves angular momentum but limits the specific angular momentum of the merged star to the specific angular momentum of the system at the onset of common envelope evolution. COMENV_MERGER_SPIN_METHOD_CONSERVE_ANGMOM (1) sets the merger's angular momentum to be that of the system at the onset of common envelope evolution (which means the star may be rotating supercritically). COMENV_MERGER_SPIN_METHOD_CONSERVE_OMEGA (2) sets the spin rate (angular frequency = omega) of the merged star to be that of the orbit just at the onset of common envelope evolution. : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "comenv_ms_accretion_fraction : Experimental. During common envelope evolution, a main sequence may accrete a fraction of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_mass. : (null)\n",
+      "comenv_ns_accretion_mass : Experimental. During common envelope evolution, a neutron star may accrete some of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_fraction. : (null)\n",
+      "comenv_ns_accretion_fraction : Experimental. During common envelope evolution, a neutron star may accrete a fraction of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_mass. : (null)\n",
+      "alpha_ce : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "alpha_ce%d : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "lambda_ce : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "lambda_ce%d : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "comenv_splitmass : When lambda_ce=-2, the envelope binding energy, lambda, is calculated using a polytropic formalism. The comenv_splitmass defines the point, in the units of the core mass, above which material is ejected. : (null)\n",
+      "nelemans_recalc_eccentricity : If True, recalculate the eccentricity after angular momentum is removed.  : (null)\n",
+      "comenv_post_eccentricity : Eccentricity remaining after common envelope ejection. : (null)\n",
+      "nelemans_gamma : Set the fraction of the orbital specific angular momentum that is used to eject the common envelope according to the Nelemans and Tout prescription. See also nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_minq : Only activate the Nelemans and Tout common envelope prescription for q>nelemans_minq. See also nelemans_gamma, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_max_frac_j_change : Maximum fractional angular momentum change in the Nelemans and Tout common envelope prescription. See also nelemans_gamma, nelemans_minq, nelemans_n_comenvs. : (null)\n",
+      "nelemans_n_comenvs : Set the maximum number of common envelope ejections allowed to follow the Nelemans and Tout prescription, after which the standard alpha prescription is used. : (null)\n",
+      "lambda_ionisation : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_ionisation%d : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_enthalpy : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "lambda_enthalpy%d : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "cbdisc_albedo : Circumbinary-disc albedo. Requires DISCS. : (null)\n",
+      "cbdisc_gamma : Circumbinary disc gamma (equation of state) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_alpha : Circumbinary disc alpha (viscosity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_kappa : Circumbinary disc kappa (opacity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_evaporation_timescale : Circumbinary disc minimum evaporation timescale (years). If (slow, not edge stripped) mass loss would evaporate the disc on a timescale less than this, simply evaporate the disc immediated. Usually set to 1y, ignore if zero. Requires DISCS. : (null)\n",
+      "cbdisc_torquef : Circumbinary disc binary torque multiplier. Requires DISCS. : (null)\n",
+      "cbdisc_max_lifetime : Circumbinary disc maximum lifetime (years, ignored if 0). Requires DISCS. : (null)\n",
+      "cbdisc_init_dM : On cbdisc start, reduce mass by a fraction dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_init_dJdM : On cbdisc start, reduce angular momentum by a fraction dJ/dM*dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_constant_rate : Circumbinary disc constant mass loss rate (Msun/year). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_FUV_multiplier : Circumbinary disc FUV mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_Xray_multiplier : Circumbinary disc X-ray mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_ram_pressure_multiplier : Circumbinary disc interstellar medium ram pressure stripping mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_pressure : Circumbinary disc interstellar medium ram pressure in units of Boltzmann constant per Kelvin (I think...). Requires DISCS. Typically 3000.0. See e.g. http://www.astronomy.ohio-state.edu/~pogge/Ast871/Notes/Intro.pdf page 15 or https://arxiv.org/pdf/0902.0820.pdf Fig. 1 (left panel). : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_multiplier : Circumbinary disc inner edge viscous mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_angular_momentum_multiplier : Circumbinary disc inner edge viscous angular momentum multiplier (no units). The inner edge angular momentum Requires DISCS. : (null)\n",
+      "cbdisc_resonance_multiplier : Circumbinary disc resonant interaction multiplier, affects eccentricity pumping and angular momentum rates. Requires DISCS. : (null)\n",
+      "cbdisc_resonance_damping : Circumbinary disc resonant interaction damping: should be on (True) to damp the l=1, m=2 resonance when the disc inner edge lies outside the resonance location. Requires DISCS. : (null)\n",
+      "cbdisc_fail_ring_inside_separation : If True, while converging on a structure, circumbinary discs with Rring < the binary separation are immediately failed. : (null)\n",
+      "cbdisc_mass_loss_inner_L2_cross_multiplier : Circumbinary disc inner edge L2-crossing mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_minimum_luminosity : Circumbinary disc minimum luminosity. If the disc becomes dimmer than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_mass : Circumbinary disc minimum mass. If the disc becomes less massive than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_fRing : Circumbinary disc minimum fRing. If the disc becomes a ring, and fRing = |Rout/Rin-1| < this value (and this value is non-zero), the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "comenv_disc_angmom_fraction : If >0 Fraction of the common envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the moments of inertia to calculate (deprecated), if -2 use the common envelope's specific angular momentum, if -3 uses the L2 point at the end of the common envelope to set the angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "comenv_disc_mass_fraction : Fraction of the common envelope's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "wind_disc_angmom_fraction : If >0 Fraction of the wind envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the L2 point's specific angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "wind_disc_mass_fraction : Fraction of the stellar wind's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "WRLOF_method : Choose whether and how to apply wind-Roche-lobe-overflow. 0=none, 1=q-dependent, 2=quadratic See Abate et al 2013/14 for details. Requires WRLOF_MASS_TRANSFER. : (null)\n",
+      "minimum_timestep : The minimum timestep (Myr). : (null)\n",
+      "timestep_solver_factor : Factor applied in timestep_limits, e.g. to prevent X changing too fast by comparing to X/dX/dt, which is usually 1 but can be higher to lengthen timesteps when using an alternative solver. : (null)\n",
+      "RLOF_mdot_factor : Multiplier applied to the mass transfer rate during Roche-lobe overflow. Requires RLOF_MDOT_MODULATION. : (null)\n",
+      "RLOF_f : Factor to enlarge a Roche lobe, nominally because of radiation pressure (see Dermine et al paper). Requires RLOF_RADIATION_CORRECTION. : (null)\n",
+      "minimum_separation_for_instant_RLOF : If True, instead of evolving the system just report the minimum separation (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_orbital_period_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "minimum_orbital_period_for_instant_RLOF : If True, instead of evolving the system just report the minimum orbital period (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_separation_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "maximum_mass_ratio_for_instant_RLOF : If True, instead of evolving the system just report the maximum mass ratio (on the zero-age main sequence) that would lead to instant RLOF, given M1 and orbital period. Used by binary_grid. See also minimum_separation_for_instant_RLOF and minimum_orbital_period_for_instant_RLOF. : (null)\n",
+      "RLOF_method : Use RLOF_method to choose the algorithm you use for Roche-lobe overflow mass loss rate calculations. 0=Hurley et al 2002, 1=Adaptive (for radiative stars) R=RL method, 2=Ritter (probably broken), 3=Claeys etal 2014 variant on Hurley et al 2002. : (null)\n",
+      "RLOF_interpolation_method : When a star overflows its Roche lobe, it always has R>RL because of the limited time resolution of the simulation. Binary_c then uses an algorithm to get back to when R~RL (within a desired tolerance, set in RLOF_ENTRY_THRESHOLD which is usually 1.02, i.e. overflow of 2%). You can choose algorithm 0, the Hurley et al 2002 method which reverses time (i.e. uses a Newton-like scheme), or 1 to use the binary_c method which rejects a timestep (and hence does no logging on that timestep) and repeats with half the timestep until R~RL. The latter is now the default, because this means there are no negative timesteps which break various other algorithms (e.g. nucleosynthesis). : (null)\n",
+      "nova_retention_fraction : The mass accreted during a nova as fraction of mass transferred : (null)\n",
+      "beta_reverse_nova : The fraction of mass ejected in a nova explosion which is accreted back onto the companion star. Set to -1 to automatically calculate based on a geometric argument, or 0 or positive to set the value. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_hydrogen_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is hydrogen rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_helium_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_other_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is neither hydrogen nor helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a hydrogen-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_helium_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a helium-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_other_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope when the donor is neither hydrogen nor helium rich. Below this mass transfer leads to stable burning. : (null)\n",
+      "CRAP_parameter : Tidally enhanced mass loss parameter. See Tout and Eggleton's paper on the subject. (Was the parameter bb). : (null)\n",
+      "individual_novae : If individual_novae is True, novae are resolved such that each explosion is performed separtaely. : (null)\n",
+      "nova_timestep_accelerator_num : The nova timestep is accelerated if the nova number exceeds nova_timestep_accelerator_num. If zero or negative, acceleration is off. See also nova_timestep_accelerator_index and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_index : The index at which the nova timestep is accelerated. A larger value gives longer timesteps. See also nova_timestep_accelerator_num and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_max : The nova timestep is accelerated by a factor that is capped at nova_timestep_accelerator_max. This parameter is ignored if it is zero or negative. See also nova_timestep_accelerator_num and nova_timestep_accelerator_index. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nonconservative_angmom_gamma : Mass lost from the system (but NOT from a stellar wind) takes a fraction gamma of the orbital angular momentum with it. Set to -1 to take the specific angular momentum of the donor star. Set to -2 to take super-Eddington, nova and disk-wind angular momenta as if a wind from the accretor. : (null)\n",
+      "max_stellar_angmom_change : Maxmimum fractional change in stellar angular momentum allowed before a timestep is rejected (0.05). : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Nucsyn\n",
+      "############################################################\n",
+      "third_dup : If True, enables third dredge up. Requires NUCSYN and NUCSYN_THIRD_DREDGE_UP. : (null)\n",
+      "third_dup_multiplier : Usage: --third_dup_multiplier <i> <f>. Multiplies the abundance of element <i> by <f> during third dredge up. : 1.0\n",
+      "NeNaMgAl : Enables NeNaMgAl reaction network. Requires NUCSYN and NUCSYN_HBB. : Ignore\n",
+      "nucsyn_network%d : Usage: --nucsyn_network%d <boolean>. Turn a nuclear network on or off. : (null)\n",
+      "nucsyn_network_error%d : Usage: --nucsyn_network_error%d <f>. Threshold error in nuclear network solver for network %d. : (null)\n",
+      "nucreacmult%d : Usage: --nucreacmult%d <f>. Multiply nuclear reaction given by the integer %d (integer) by f (float).  : (null)\n",
+      "nucsyn_metallicity : This sets the metallicity of the nucleosynthesis algorithms, i.e. the amount (by mass) of matter which is not hydrogen or helium. Usually you'd just set this with the metallicity parameter, but if you want the nucleosynthesis to be outside the range of the stellar evolution algorithm (e.g. Z=0 or Z=0.04) then you need to use nucsyn_metallicity. That said, it's also outside the range of some of the nucleosynthesis algorithms as well, so you have been warned! : (null)\n",
+      "nucsyn_solver : Choose the solver used in nuclear burning. 0 = KAPS_RENTROP is a Kaps-Rentrop scheme (fast, not great for stiff problems), 1 = LSODA (Adams/BSF switcher), 2 = CVODE library (https://computing.llnl.gov/projects/sundials. Default 0.  : 0\n",
+      "initial_abundance_mix : initial abundance mixture: 0=AG89, 1=Karakas 2002, 2=Lodders 2003, 3=Asplund 2005 (not available?), 4=Garcia Berro, 5=Grevesse Noels 1993 : 0\n",
+      "init_abund : Usage: --init_abund <i> <X>. Sets the initial abundance of isotope number <i> to mass fraction <X>. : 0.02\n",
+      "init_abund_mult : Usage: --init_abund_mult <i> <f>. Multiplies the initial abundance of isotope number <i> by <f>. : 1.0\n",
+      "init_abund_dex : Usage: --init_abund_dex <i> <f>. Changes the initial abundance of isotope number <i> by <f> dex. : 0.0\n",
+      "init_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "initial_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "no_thermohaline_mixing : If True, disables thermohaline mixing. : (null)\n",
+      "lithium_GB_post_Heflash : Sets the lithium abundances after the helium flash. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_GB_post_1DUP : Sets the lithium abundance after first dredge up. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_hbb_multiplier : Multiplies the lithium abundances on the AGB during HBB (based on Karakas/Fishlock et al models).Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "angelou_lithium_decay_function : Functional form which describes Li7 decay. Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Choices are : 0 expoential (see angelou_lithium_decay_time). : (null)\n",
+      "angelou_lithium_LMMS_time : Time at which lithium manufacture is triggered in a low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_time : Time at which lithium manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_time : Time at which lithium manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_time : Time at which lithium manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_time : Time at which lithium manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_time : Time at which lithium manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_time : Time at which lithium manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_decay_time : Decay time for surface lithium abundance during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_decay_time : Decay time for surface lithium abundance on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_decay_time : Decay time for surface lithium abundance on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_decay_time : Decay time for surface lithium abundance on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_decay_time : Decay time for surface lithium abundance during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_decay_time : Decay time for surface lithium abundance on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_decay_time : Decay time for surface lithium abundance on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_massfrac : Lithium mass fraction when its manufacture is triggered during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_massfrac : Lithium mass fraction when its manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_massfrac : Lithium mass fraction when its manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_massfrac : Lithium mass fraction when its manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_massfrac : Lithium mass fraction when its manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_vrot_trigger : Equatorial rotational velocity at which lithium manufacture is triggered (km/s). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "angelou_lithium_vrotfrac_trigger : Fraction of Keplerian (breakup) equatorial rotational velocity at which lithium manufacture is triggered (must be <1, ignored if 0). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Output\n",
+      "############################################################\n",
+      "david_logging_function : Function to choose which kind of information gets logged Requires DAVID. Choices are: 0= None, >0 for custom logging functions : Ignore\n",
+      "cf_amanda_log : Enable logging to compare to Amanda's models. : (null)\n",
+      "float_overflow_checks : Turn on to enable floating-point overflow checks at the end of each timestep, if they are available. 0=off, 1=warn (stderr) on failure, 2=exit on failure (0) : (null)\n",
+      "save_pre_events_stardata : Enable this to save a copy of stardata to stardata->pre_events_stardata just before an event. : (null)\n",
+      "disable_end_logging : Disable the logging that happens at the end of the evolution. : (null)\n",
+      "ensemble : Turn on ensemble calculations and output. : (null)\n",
+      "ensemble_filters_off : Sets all ensemble filters to be off (FALSE) - these can then be enabled one-by-one with --ensemble_filter_[...] TRUE. : (null)\n",
+      "ensemble_filter_%d : Turn on or off ensemble filter <n>. For a list of filters, see ensemble_macros.h. : (null)\n",
+      "ensemble_legacy_ensemble : Turn on ensemble legacy population output. : (null)\n",
+      "legacy_yields : Turn on ensemble legacy yield output. : (null)\n",
+      "ensemble_defer : Defer ensemble output. : (null)\n",
+      "ensemble_dt : When doing ensemble calculations, data are stored and/or output every ensemble_dt Myr. See also ensemble, ensemble_logdt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logdt : When doing ensemble calculations, and when logensembletimes is set, the ensemble is stored/output every ensemble_logdt Myr. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_startlogtime : Start log ensemble data storage/calculations/output at ensemble_startlogtime. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logtimes : When doing ensemble calculations/output, set this to act at log times rather than linear times. : (null)\n",
+      "postagb_legacy_logging : Turn on post-AGB legacy logging. : (null)\n",
+      "disc_legacy_logging : Turn on disc legacy logging. : (null)\n",
+      "EMP_logg_maximum : Maximum logg that EMP stars are allowed to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_minimum_age. : (null)\n",
+      "EMP_minimum_age : Minimum age that EMP stars are required to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum. : (null)\n",
+      "EMP_feh_maximum : Maximum [Fe/H] that an EMP stars may have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default -2.0. : (null)\n",
+      "CEMP_cfe_minimum : Minimum [C/Fe] that CEMP stars are required to have. See Izzard et al 2009. See also NEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 0.7. : (null)\n",
+      "NEMP_cfe_minimum : Minimum [N/Fe] that NEMP stars are required to have. See Izzard et al 2009, Pols et al. 2012. See also CEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 1.0. : (null)\n",
+      "thick_disc_start_age : Lookback time for the start of the thick disc star formation, e.g. 13e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_end_age : Lookback time for the end of the thick disc star formation, e.g. 4e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_logg_min : Minimum logg for thick disc giants to be logged. : (null)\n",
+      "thick_disc_logg_max : Maximum logg for thick disc giants to be logged. : (null)\n",
+      "escape_velocity : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 1e9 km/s. See also escape_fraction. : (null)\n",
+      "escape_fraction : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 0.0. See also escape_velocity. : (null)\n",
+      "colour_log : If set to True, thelog is coloured with ANSI colour formatting. Requires FILE_LOG to be defined. : \n",
+      "log_filename : Location of the output logging filename. If set to \"/dev/null\" then there is no logging. : \n",
+      "stopfile : File which, when it exists, will stop the current binary_c repeat run. : \n",
+      "stardata_dump_filename : Location of the stardata dump file. : \n",
+      "stardata_load_filename : Location of the stardata file to load. : \n",
+      "api_log_filename_prefix : Location of the output logging filename prefix for the API. If set to \"/dev/null\" then there is no logging. : 0\n",
+      "hrdiag_output : Set to True to output high time-resolution Hertzstrpung-Russell diagram information. Requires HRDIAG. : (null)\n",
+      "internal_buffering : Experimental. Set to non-zero values to implement internal buffering prior to output. For use with binary_grid, you shouldn't really be playing with this. : (null)\n",
+      "eccentric_RLOF_model : Chooses which model is used to handle eccentric RLOF. Default is RLOF_ECCENTRIC_AS_CIRCULAR, i.e. ignore the eccentricity. Note: requires force_corotation_of_primary_and_orbit to be FALSE.\n",
+      " : (null)\n",
+      "force_circularization_on_RLOF : If True forces circularization of stars and orbit when RLOF starts, this is as in the BSE algorithm. (True) : (null)\n",
+      "wtts_log : If True, enables log file output for WTTS2. : (null)\n",
+      "fabian_imf_log_time : Time at which to output for Fabian Schneider's IMF project. Requires FABIAN_IMF_LOG : Ignore\n",
+      "fabian_imf_log_timestep : Timestep for Fabian Schneider's IMF project logging. Requires FABIAN_IMF_LOG : Ignore\n",
+      "version : Display binary_c version and build information. Also performs timing tests. : Ignore\n",
+      "dumpversion : Display binary_c version number (short format). : Ignore\n",
+      "version_only : Display binary_c version number and build information, but do not perform timing tests or anything that requires stardata to be non-NULL. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Input\n",
+      "############################################################\n",
+      "MINT_dir : Location of MINT algorithm data. : \n",
+      "MINT_data_cleanup : Activate checks on incoming data to try to account for problems. Will make data-loading slower, but may fix a few things. : \n",
+      "MINT_MS_rejuvenation : Turn on or off (hydrogen) main-sequence rejuvenation. : \n",
+      "MINT_remesh : Turn on or off MINT's remeshing. : \n",
+      "MINT_use_ZAMS_profiles : Use chemical profiles at the ZAMS if MINT_use_ZAMS_profiles is TRUE, otherwise set homogeneous abundances. (Default is TRUE, so we use the profiles if they are available.) : \n",
+      "MINT_disable_grid_load_warnings : Use this to explicitly disable MINT's warnings when loading a grid with, e.g., missing or too much data. : \n",
+      "MINT_Kippenhahn : Turn on or off MINT's Kippenhahn diagrams. If 0, off, if 1, output star 1 (index 0), if 2 output star 2 (index 1). Default 0. : \n",
+      "MINT_Kippenhahn_stellar_type : Stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for which Kippenhahn plot data should be output. : \n",
+      "MINT_Kippenhahn_companion_stellar_type : Companion stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for the companion for which Kippenhahn plot data should be output. : \n",
+      "MINT_nuclear_burning : Turn on or off MINT's nuclear burning algorithm. : \n",
+      "MINT_minimum_shell_mass : Minimum shell mass in MINT's nuclear burning routines. : \n",
+      "MINT_maximum_shell_mass : Maximum shell mass in MINT's nuclear burning routines. : \n",
+      "\n",
+      "############################################################\n",
+      "##### Section I/O\n",
+      "############################################################\n",
+      "go : batchmode control command : Ignore\n",
+      "gogo : batchmode control command : Ignore\n",
+      "reset_stars : Reset the star structures. Used in batchmode : Ignore\n",
+      "reset_stars_defaults : Reset the star structures and set defaults. Used in batchmode : Ignore\n",
+      "defaults : Reset all defaults. Used in batchmode : Ignore\n",
+      "echo : Activate batchmode command echoing, i.e. when you enter a command, binary_c repeats the command then executes it. : Ignore\n",
+      "noecho : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "noechonow : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "bye : Quit binary_c. Used in batchmode. : Ignore\n",
+      "fin : batchmode control command : Ignore\n",
+      "reset_prefs : Reset preferences struct. Used in batchmode : Ignore\n",
+      "status : Output batchmode status information. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Algorithms\n",
+      "############################################################\n",
+      "repeat : If > 1, repeats the system as many times as required. Handy if you're using Monte-Carlo kicks and want to sample the parameter space well. Also, if you are running speed tests this is good to give a statistically more reasonable result. (See e.g. 'tbse pgo'). : (null)\n",
+      "random_systems : Experimental. Use this to apply random initial system parameters (masses, separations, etc.). Useful for testing only. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Misc\n",
+      "############################################################\n",
+      "random_seed : Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "random_systems_seed : Random number seed for the generation of random systems. See random_systems and random_seed. : (null)\n",
+      "random_skip : Skip the first <random_seed> random numbers that are generated. Usually this is 0 so they are all used. : (null)\n",
+      "idum : [NB: deprecated, please use 'random_seed' instead.] Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "reverse_time : Make time go backwards. To be considered very experimental! : (null)\n",
+      "start_time : Start time for the simulation. : (null)\n",
+      "warmup_cpu : Uses the CPU at maximum power the given number of seconds, prior to running normal stellar evolution. : Ignore\n",
+      "help : Display help pages. Usage: --help <help topic>. : Ignore\n",
+      "argopts : Display argument options. Usage: --argopts <argument>. : Ignore\n",
+      "help_all : Display all help pages. : Ignore\n",
+      "list_args : Display list of arguments with their default values. Useful for batchmode. : Ignore\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help_all())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bfec32cf-7240-4a82-ac30-b3d99a018a28",
+   "metadata": {},
+   "source": [
+    "We can get all the parameter names and their default values with return_arglines(): (abridged output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "3d29ca9d-ac66-4f9e-81cf-2edd14a98b79",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "__ARG_BEGIN\n",
+      "metallicity = 0.02\n",
+      "effective_metallicity = -1\n",
+      "M_1 = 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print('\\n'.join(_binary_c_bindings.return_arglines().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e8b1c8b6-a878-43f4-bc36-1b20b3e66c6f",
+   "metadata": {},
+   "source": [
+    "Lastly, we can ask binary_c to determine the minimum period or maximum mass for RLOF at the ZAMS: Both of them need an argstring as input"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "e517f561-09c6-419d-ba89-d9cb61e6ebab",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MINIMUM SEPARATION 0.31\n",
+      "MINIMUM PERIOD 0.00632092\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_minimum_orbit_for_RLOF(argstring, store_capsule=store_memaddr)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 46,
+   "id": "7da75a95-8831-4346-a584-e042ced75249",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MAXIMUM MASS RATIO 0.0141\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=5,\n",
+    "    M_2=1,\n",
+    "    orbital_period=0.0001,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_maximum_mass_ratio_for_RLOF(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5fe52d8e-1721-4796-a856-002cf4525d96",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/notebook_custom_logging.html b/docs/build/html/notebook_custom_logging.html
new file mode 100644
index 000000000..7639278a2
--- /dev/null
+++ b/docs/build/html/notebook_custom_logging.html
@@ -0,0 +1,933 @@
+
+
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8">
+  
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  
+  <title>Notebook custom logging &mdash; binary_c-python  documentation</title>
+  
+
+  
+  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+  
+  
+  
+  
+
+  
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+    
+      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/language_data.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
+    
+    <script type="text/javascript" src="_static/js/theme.js"></script>
+
+    
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Running populations with binarycpython" href="notebook_population.html" />
+    <link rel="prev" title="Running individual systems with binarycpython" href="notebook_individual_systems.html" /> 
+</head>
+
+<body class="wy-body-for-nav">
+
+   
+  <div class="wy-grid-for-nav">
+    
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+          
+
+          
+            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
+          
+
+          
+          </a>
+
+          
+            
+            
+          
+
+          
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+          
+        </div>
+
+        
+        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+          
+            
+            
+              
+            
+            
+              <p class="caption"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
+<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Notebook custom logging</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Usage">Usage</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#Using-custom-logging-with-the-population-object">Using custom logging with the population object</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Using-custom-logging-when-running-directly-from-the-API">Using custom logging when running directly from the API</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#Examples-of-logging-strings">Examples of logging strings</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#Compact-object">Compact object</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Logging-mass-evolution-and-the-supernova">Logging mass evolution and the supernova</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
+<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
+</ul>
+
+            
+          
+        </div>
+        
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+      
+      <nav class="wy-nav-top" aria-label="top navigation">
+        
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">binary_c-python</a>
+        
+      </nav>
+
+
+      <div class="wy-nav-content">
+        
+        <div class="rst-content">
+        
+          
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+
+  <ul class="wy-breadcrumbs">
+    
+      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
+        
+          <li><a href="example_notebooks.html">Example notebooks</a> &raquo;</li>
+        
+      <li>Notebook custom logging</li>
+    
+    
+      <li class="wy-breadcrumbs-aside">
+        
+            
+            <a href="_sources/notebook_custom_logging.ipynb.txt" rel="nofollow"> View page source</a>
+          
+        
+      </li>
+    
+  </ul>
+
+  
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+            
+  
+<style>
+/* CSS for nbsphinx extension */
+
+/* remove conflicting styling from Sphinx themes */
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt *,
+div.nbinput.container div.input_area pre,
+div.nboutput.container div.output_area pre,
+div.nbinput.container div.input_area .highlight,
+div.nboutput.container div.output_area .highlight {
+    border: none;
+    padding: 0;
+    margin: 0;
+    box-shadow: none;
+}
+
+div.nbinput.container > div[class*=highlight],
+div.nboutput.container > div[class*=highlight] {
+    margin: 0;
+}
+
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt * {
+    background: none;
+}
+
+div.nboutput.container div.output_area .highlight,
+div.nboutput.container div.output_area pre {
+    background: unset;
+}
+
+div.nboutput.container div.output_area div.highlight {
+    color: unset;  /* override Pygments text color */
+}
+
+/* avoid gaps between output lines */
+div.nboutput.container div[class*=highlight] pre {
+    line-height: normal;
+}
+
+/* input/output containers */
+div.nbinput.container,
+div.nboutput.container {
+    display: -webkit-flex;
+    display: flex;
+    align-items: flex-start;
+    margin: 0;
+    width: 100%;
+}
+@media (max-width: 540px) {
+    div.nbinput.container,
+    div.nboutput.container {
+        flex-direction: column;
+    }
+}
+
+/* input container */
+div.nbinput.container {
+    padding-top: 5px;
+}
+
+/* last container */
+div.nblast.container {
+    padding-bottom: 5px;
+}
+
+/* input prompt */
+div.nbinput.container div.prompt pre {
+    color: #307FC1;
+}
+
+/* output prompt */
+div.nboutput.container div.prompt pre {
+    color: #BF5B3D;
+}
+
+/* all prompts */
+div.nbinput.container div.prompt,
+div.nboutput.container div.prompt {
+    width: 4.5ex;
+    padding-top: 5px;
+    position: relative;
+    user-select: none;
+}
+
+div.nbinput.container div.prompt > div,
+div.nboutput.container div.prompt > div {
+    position: absolute;
+    right: 0;
+    margin-right: 0.3ex;
+}
+
+@media (max-width: 540px) {
+    div.nbinput.container div.prompt,
+    div.nboutput.container div.prompt {
+        width: unset;
+        text-align: left;
+        padding: 0.4em;
+    }
+    div.nboutput.container div.prompt.empty {
+        padding: 0;
+    }
+
+    div.nbinput.container div.prompt > div,
+    div.nboutput.container div.prompt > div {
+        position: unset;
+    }
+}
+
+/* disable scrollbars on prompts */
+div.nbinput.container div.prompt pre,
+div.nboutput.container div.prompt pre {
+    overflow: hidden;
+}
+
+/* input/output area */
+div.nbinput.container div.input_area,
+div.nboutput.container div.output_area {
+    -webkit-flex: 1;
+    flex: 1;
+    overflow: auto;
+}
+@media (max-width: 540px) {
+    div.nbinput.container div.input_area,
+    div.nboutput.container div.output_area {
+        width: 100%;
+    }
+}
+
+/* input area */
+div.nbinput.container div.input_area {
+    border: 1px solid #e0e0e0;
+    border-radius: 2px;
+    /*background: #f5f5f5;*/
+}
+
+/* override MathJax center alignment in output cells */
+div.nboutput.container div[class*=MathJax] {
+    text-align: left !important;
+}
+
+/* override sphinx.ext.imgmath center alignment in output cells */
+div.nboutput.container div.math p {
+    text-align: left;
+}
+
+/* standard error */
+div.nboutput.container div.output_area.stderr {
+    background: #fdd;
+}
+
+/* ANSI colors */
+.ansi-black-fg { color: #3E424D; }
+.ansi-black-bg { background-color: #3E424D; }
+.ansi-black-intense-fg { color: #282C36; }
+.ansi-black-intense-bg { background-color: #282C36; }
+.ansi-red-fg { color: #E75C58; }
+.ansi-red-bg { background-color: #E75C58; }
+.ansi-red-intense-fg { color: #B22B31; }
+.ansi-red-intense-bg { background-color: #B22B31; }
+.ansi-green-fg { color: #00A250; }
+.ansi-green-bg { background-color: #00A250; }
+.ansi-green-intense-fg { color: #007427; }
+.ansi-green-intense-bg { background-color: #007427; }
+.ansi-yellow-fg { color: #DDB62B; }
+.ansi-yellow-bg { background-color: #DDB62B; }
+.ansi-yellow-intense-fg { color: #B27D12; }
+.ansi-yellow-intense-bg { background-color: #B27D12; }
+.ansi-blue-fg { color: #208FFB; }
+.ansi-blue-bg { background-color: #208FFB; }
+.ansi-blue-intense-fg { color: #0065CA; }
+.ansi-blue-intense-bg { background-color: #0065CA; }
+.ansi-magenta-fg { color: #D160C4; }
+.ansi-magenta-bg { background-color: #D160C4; }
+.ansi-magenta-intense-fg { color: #A03196; }
+.ansi-magenta-intense-bg { background-color: #A03196; }
+.ansi-cyan-fg { color: #60C6C8; }
+.ansi-cyan-bg { background-color: #60C6C8; }
+.ansi-cyan-intense-fg { color: #258F8F; }
+.ansi-cyan-intense-bg { background-color: #258F8F; }
+.ansi-white-fg { color: #C5C1B4; }
+.ansi-white-bg { background-color: #C5C1B4; }
+.ansi-white-intense-fg { color: #A1A6B2; }
+.ansi-white-intense-bg { background-color: #A1A6B2; }
+
+.ansi-default-inverse-fg { color: #FFFFFF; }
+.ansi-default-inverse-bg { background-color: #000000; }
+
+.ansi-bold { font-weight: bold; }
+.ansi-underline { text-decoration: underline; }
+
+
+div.nbinput.container div.input_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight].math,
+div.nboutput.container div.output_area.rendered_html,
+div.nboutput.container div.output_area > div.output_javascript,
+div.nboutput.container div.output_area:not(.rendered_html) > img{
+    padding: 5px;
+    margin: 0;
+}
+
+/* fix copybtn overflow problem in chromium (needed for 'sphinx_copybutton') */
+div.nbinput.container div.input_area > div[class^='highlight'],
+div.nboutput.container div.output_area > div[class^='highlight']{
+    overflow-y: hidden;
+}
+
+/* hide copybtn icon on prompts (needed for 'sphinx_copybutton') */
+.prompt a.copybtn {
+    display: none;
+}
+
+/* Some additional styling taken form the Jupyter notebook CSS */
+div.rendered_html table {
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: black;
+  font-size: 12px;
+  table-layout: fixed;
+}
+div.rendered_html thead {
+  border-bottom: 1px solid black;
+  vertical-align: bottom;
+}
+div.rendered_html tr,
+div.rendered_html th,
+div.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+div.rendered_html th {
+  font-weight: bold;
+}
+div.rendered_html tbody tr:nth-child(odd) {
+  background: #f5f5f5;
+}
+div.rendered_html tbody tr:hover {
+  background: rgba(66, 165, 245, 0.2);
+}
+
+/* CSS overrides for sphinx_rtd_theme */
+
+/* 24px margin */
+.nbinput.nblast.container,
+.nboutput.nblast.container {
+    margin-bottom: 19px;  /* padding has already 5px */
+}
+
+/* ... except between code cells! */
+.nblast.container + .nbinput.container {
+    margin-top: -19px;
+}
+
+.admonition > p:before {
+    margin-right: 4px;  /* make room for the exclamation icon */
+}
+
+/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
+.math {
+    text-align: unset;
+}
+</style>
+<div class="section" id="Notebook-custom-logging">
+<h1>Notebook custom logging<a class="headerlink" href="#Notebook-custom-logging" title="Permalink to this headline">¶</a></h1>
+<p>In this notebook you’ll learn how to use the custom logging functionality</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[37]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">from</span> <span class="nn">binarycpython</span> <span class="kn">import</span> <span class="n">_binary_c_bindings</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="p">(</span>
+    <span class="n">autogen_C_logging_code</span><span class="p">,</span>
+    <span class="n">binary_c_log_code</span><span class="p">,</span>
+    <span class="n">create_and_load_logging_function</span><span class="p">,</span>
+<span class="p">)</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.run_system_wrapper</span> <span class="kn">import</span> <span class="n">run_system</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
+</pre></div>
+</div>
+</div>
+<p>The custom logging functionality allows us to decide the output of binary_c <em>without</em> modifying the actual sourcecode of binary_c (i.e. editing <code class="docutils literal notranslate"><span class="pre">src/logging/log_every_timestep</span></code> in binary_c). Rather, we can create a logging routine from within python.</p>
+<p>Technically, the following steps are taken: - User creates a logging print statement from within python - The logging print statement string gets wrapped into a proper c-function by <code class="docutils literal notranslate"><span class="pre">binary_c_log_code</span></code> - The c-function string gets compiled and loaded into memory by <code class="docutils literal notranslate"><span class="pre">create_and_load_logging_function</span></code> - The memory adress of the compiled and loaded print function can now be passed to C - binary_c uses the custom print function</p>
+<p>The custom logging functionality can be used when running systems via <code class="docutils literal notranslate"><span class="pre">run_system()</span></code>, via <code class="docutils literal notranslate"><span class="pre">Population.evolve()</span></code> and <code class="docutils literal notranslate"><span class="pre">Population.evolve_single()</span></code>, and directly via the API</p>
+<p>Within the logging statement we can access information from the stardata object, as well as use logical statements to determine when to log information. What we cannot do, however, is access functions that are not <em>publicly available</em>. For very elaborate printing routines it is still advised to actually hardcode the print statement into binary_c itself.</p>
+<div class="section" id="Usage">
+<h2>Usage<a class="headerlink" href="#Usage" title="Permalink to this headline">¶</a></h2>
+<p>There are two methods to create the C-code that will be compiled: - Automatically generate the print statement and use the wrapper to generate the full function string, by using <code class="docutils literal notranslate"><span class="pre">autogen_C_logging_code</span></code> - Create your custom print statement and use the wrapper to generate the full function string, by writing out the print statement. Here the logging statement obviously has to be valid C code</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># generate logging lines. Here you can choose whatever you want to have logged, and with what header</span>
+<span class="c1"># this generates working print statements</span>
+<span class="n">logging_line</span> <span class="o">=</span> <span class="n">autogen_C_logging_code</span><span class="p">(</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;model.time&quot;</span><span class="p">,</span> <span class="s2">&quot;star[0].mass&quot;</span><span class="p">],</span>
+    <span class="p">}</span>
+<span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Printf(&#34;MY_STELLAR_DATA %g %g\n&#34;,((double)stardata-&gt;model.time),((double)stardata-&gt;star[0].mass));
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[30]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.</span>
+<span class="n">logging_line</span> <span class="o">=</span> <span class="s1">&#39;Printf(&quot;MY_STELLAR_DATA time=</span><span class="si">%g</span><span class="s1"> mass=</span><span class="si">%g</span><span class="se">\\</span><span class="s1">n&quot;, stardata-&gt;model.time, stardata-&gt;star[0].mass)&#39;</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Printf(&#34;MY_STELLAR_DATA time=%g mass=%g\n&#34;, stardata-&gt;model.time, stardata-&gt;star[0].mass)
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[31]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># Generate the entire &#39;script&#39; by wrapping the logging line</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">custom_logging_code</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+#pragma push_macro(&#34;Max&#34;)
+#pragma push_macro(&#34;Min&#34;)
+#undef Max
+#undef Min
+#include &#34;binary_c.h&#34;
+
+// add visibility __attribute__ ((visibility (&#34;default&#34;))) to it
+void binary_c_API_function custom_output_function(struct stardata_t * stardata);
+void binary_c_API_function custom_output_function(struct stardata_t * stardata)
+{
+    // struct stardata_t * stardata = (struct stardata_t *)x;
+    Printf(&#34;MY_STELLAR_DATA time=%g mass=%g\n&#34;, stardata-&gt;model.time, stardata-&gt;star[0].mass);
+}
+
+#undef Max
+#undef Min
+#pragma pop_macro(&#34;Min&#34;)
+#pragma pop_macro(&#34;Max&#34;)
+</pre></div></div>
+</div>
+<p>Combining the above with e.g. run_system() (see notebook_individual_systems for more examples):</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[32]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># logging statement</span>
+<span class="n">logging_line</span> <span class="o">=</span> <span class="s1">&#39;Printf(&quot;MY_STELLAR_DATA time=</span><span class="si">%g</span><span class="s1"> mass=</span><span class="si">%g</span><span class="se">\\</span><span class="s1">n&quot;, stardata-&gt;model.time, stardata-&gt;star[0].mass)&#39;</span>
+
+<span class="c1"># Entire script</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
+
+<span class="c1"># Run system</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">)</span>
+
+<span class="c1"># print (abridged) output</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+MY_STELLAR_DATA time=0 mass=2
+MY_STELLAR_DATA time=0 mass=2
+MY_STELLAR_DATA time=1e-06 mass=2
+MY_STELLAR_DATA time=2e-06 mass=2
+</pre></div></div>
+</div>
+<div class="section" id="Using-custom-logging-with-the-population-object">
+<h3>Using custom logging with the population object<a class="headerlink" href="#Using-custom-logging-with-the-population-object" title="Permalink to this headline">¶</a></h3>
+<p>Custom logging can be used for a whole population by setting the print statement (so not the entire logging script) in <code class="docutils literal notranslate"><span class="pre">C_logging_code</span></code></p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[33]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># Set up population</span>
+<span class="n">pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
+
+<span class="c1"># Set some BSE parameters</span>
+<span class="n">pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">5</span>
+<span class="p">)</span>
+
+<span class="c1"># Example logging that prints only if the star is post main-sequence</span>
+<span class="n">example_logging_string_post_MS</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">if(stardata-&gt;star[0].stellar_type&gt;MS)</span>
+<span class="s2">{</span>
+<span class="s2">    Printf(&quot;EXAMPLE_ABOVE_MS </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">        //</span>
+<span class="s2">        stardata-&gt;model.time, // 1</span>
+
+<span class="s2">        stardata-&gt;star[0].mass, //2</span>
+<span class="s2">        stardata-&gt;previous_stardata-&gt;star[0].mass, //3</span>
+
+<span class="s2">        stardata-&gt;star[0].radius, //4</span>
+<span class="s2">        stardata-&gt;previous_stardata-&gt;star[0].radius, //5</span>
+
+<span class="s2">        stardata-&gt;star[0].stellar_type, //6</span>
+<span class="s2">        stardata-&gt;previous_stardata-&gt;star[0].stellar_type //7</span>
+<span class="s2">  );</span>
+<span class="s2">};</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="c1"># Set the logging</span>
+<span class="n">pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">C_logging_code</span><span class="o">=</span><span class="n">example_logging_string_post_MS</span>
+<span class="p">)</span>
+<span class="n">out</span> <span class="o">=</span> <span class="n">pop</span><span class="o">.</span><span class="n">evolve_single</span><span class="p">()</span>
+
+<span class="c1"># Print (abridged) output</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">out</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+EXAMPLE_ABOVE_MS             1.041660877905e+02 4.99198 4.99198 6.1357 6.1357 2 1
+EXAMPLE_ABOVE_MS             1.041662558619e+02 4.99198 4.99198 6.14057 6.1357 2 2
+EXAMPLE_ABOVE_MS             1.041662560111e+02 4.99198 4.99198 6.14057 6.14057 2 2
+EXAMPLE_ABOVE_MS             1.041662564579e+02 4.99198 4.99198 6.14059 6.14057 2 2
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Using-custom-logging-when-running-directly-from-the-API">
+<h3>Using custom logging when running directly from the API<a class="headerlink" href="#Using-custom-logging-when-running-directly-from-the-API" title="Permalink to this headline">¶</a></h3>
+<p>When running a system directly with the API we need to manually load the custom logging into memory (via <code class="docutils literal notranslate"><span class="pre">create_and_load_logging_function</span></code>) and pass the memory address to the binary_c binding via <code class="docutils literal notranslate"><span class="pre">_binary_c_bindings.run_system(argstring,</span> <span class="pre">custom_logging_func_memaddr=custom_logging_memaddr)</span></code></p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[40]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># generate logging lines</span>
+<span class="n">logging_line</span> <span class="o">=</span> <span class="n">autogen_C_logging_code</span><span class="p">(</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;model.time&quot;</span><span class="p">,</span> <span class="s2">&quot;star[0].mass&quot;</span><span class="p">],</span>
+    <span class="p">}</span>
+<span class="p">)</span>
+
+<span class="c1"># Generate code around logging lines</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">logging_line</span><span class="p">)</span>
+
+<span class="c1"># Generate library and get memaddr</span>
+<span class="n">custom_logging_memaddr</span><span class="p">,</span> <span class="n">shared_lib_filename</span> <span class="o">=</span> <span class="n">create_and_load_logging_function</span><span class="p">(</span>
+    <span class="n">custom_logging_code</span>
+<span class="p">)</span>
+
+<span class="c1">#</span>
+<span class="n">m1</span> <span class="o">=</span> <span class="mf">15.0</span>  <span class="c1"># Msun</span>
+<span class="n">m2</span> <span class="o">=</span> <span class="mf">14.0</span>  <span class="c1"># Msun</span>
+<span class="n">separation</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># 0 = ignored, use period</span>
+<span class="n">orbital_period</span> <span class="o">=</span> <span class="mf">4530.0</span>  <span class="c1"># days</span>
+<span class="n">eccentricity</span> <span class="o">=</span> <span class="mf">0.0</span>
+<span class="n">metallicity</span> <span class="o">=</span> <span class="mf">0.02</span>
+<span class="n">max_evolution_time</span> <span class="o">=</span> <span class="mi">15000</span>
+<span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;binary_c M_1 </span><span class="si">{0:g}</span><span class="s2"> M_2 </span><span class="si">{1:g}</span><span class="s2"> separation </span><span class="si">{2:g}</span><span class="s2"> orbital_period </span><span class="si">{3:g}</span><span class="s2"> eccentricity </span><span class="si">{4:g}</span><span class="s2"> metallicity </span><span class="si">{5:g}</span><span class="s2"> max_evolution_time </span><span class="si">{6:g}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">m1</span><span class="p">,</span>
+    <span class="n">m2</span><span class="p">,</span>
+    <span class="n">separation</span><span class="p">,</span>
+    <span class="n">orbital_period</span><span class="p">,</span>
+    <span class="n">eccentricity</span><span class="p">,</span>
+    <span class="n">metallicity</span><span class="p">,</span>
+    <span class="n">max_evolution_time</span><span class="p">,</span>
+<span class="p">)</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">run_system</span><span class="p">(</span>
+    <span class="n">argstring</span><span class="p">,</span> <span class="n">custom_logging_func_memaddr</span><span class="o">=</span><span class="n">custom_logging_memaddr</span>
+<span class="p">)</span>
+
+<span class="c1"># print (abridged) output</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+MY_STELLAR_DATA 0 15
+MY_STELLAR_DATA 0 15
+MY_STELLAR_DATA 1e-06 15
+MY_STELLAR_DATA 2e-06 15
+</pre></div></div>
+</div>
+</div>
+</div>
+<div class="section" id="Examples-of-logging-strings">
+<h2>Examples of logging strings<a class="headerlink" href="#Examples-of-logging-strings" title="Permalink to this headline">¶</a></h2>
+<p>Below are some examples of logging strings</p>
+<div class="section" id="Compact-object">
+<h3>Compact object<a class="headerlink" href="#Compact-object" title="Permalink to this headline">¶</a></h3>
+<p>This logging will print the timestep when the star becomes a compact object. After it does, we change the maximum time to be the current time, effectively terminating the evolution</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[42]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">example_logging_string_CO</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">if(stardata-&gt;star[0].stellar_type&gt;=NS)</span>
+<span class="s2">{</span>
+<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
+<span class="s2">    {</span>
+<span class="s2">        Printf(&quot;EXAMPLE_LOG_CO </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">            //</span>
+<span class="s2">            stardata-&gt;model.time, // 1</span>
+
+<span class="s2">            stardata-&gt;star[0].mass, //2</span>
+<span class="s2">            stardata-&gt;previous_stardata-&gt;star[0].mass, //3</span>
+
+<span class="s2">            stardata-&gt;star[0].radius, //4</span>
+<span class="s2">            stardata-&gt;previous_stardata-&gt;star[0].radius, //5</span>
+
+<span class="s2">            stardata-&gt;star[0].stellar_type, //6</span>
+<span class="s2">            stardata-&gt;previous_stardata-&gt;star[0].stellar_type //7</span>
+<span class="s2">      );</span>
+<span class="s2">    };</span>
+<span class="s2">    /* Kill the simulation to save time */</span>
+<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
+<span class="s2">};</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="c1"># Entire script</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">example_logging_string_CO</span><span class="p">)</span>
+
+<span class="c1"># Run system</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span> <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">)</span>
+
+<span class="c1"># print (abridged) output</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+SINGLE_STAR_LIFETIME 10 27.7358
+EXAMPLE_LOG_CO             2.773581245005e+01 1.33524 9.19314 1.72498e-05 730.446 13 5
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Logging-mass-evolution-and-the-supernova">
+<h3>Logging mass evolution and the supernova<a class="headerlink" href="#Logging-mass-evolution-and-the-supernova" title="Permalink to this headline">¶</a></h3>
+<p>This logging code prints the mass evolution and the moment the star goes supernova</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[47]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">example_logging_string_CO</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">Printf(&quot;EXAMPLE_MASSLOSS </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%g</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">    //</span>
+<span class="s2">    stardata-&gt;model.time, // 1</span>
+<span class="s2">    stardata-&gt;star[0].mass, //2</span>
+<span class="s2">    stardata-&gt;previous_stardata-&gt;star[0].mass, //3</span>
+<span class="s2">    stardata-&gt;common.zero_age.mass[0], //4</span>
+
+<span class="s2">    stardata-&gt;star[0].stellar_type, //5</span>
+<span class="s2">    stardata-&gt;model.probability //6</span>
+<span class="s2">);</span>
+<span class="s2">if(stardata-&gt;star[0].SN_type != SN_NONE)</span>
+<span class="s2">{</span>
+<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
+<span class="s2">    {</span>
+<span class="s2">        if(stardata-&gt;pre_events_stardata != NULL)</span>
+<span class="s2">        {</span>
+<span class="s2">            Printf(&quot;EXAMPLE_SN </span><span class="si">%30.12e</span><span class="s2"> &quot; // 1</span>
+<span class="s2">                &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> &quot; // 2-5</span>
+<span class="s2">                &quot;</span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> &quot; // 6-9</span>
+<span class="s2">                &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="se">\\</span><span class="s2">n&quot;, // 10-13</span>
+
+<span class="s2">                //</span>
+<span class="s2">                stardata-&gt;model.time, // 1</span>
+
+<span class="s2">                stardata-&gt;star[0].mass, //2</span>
+<span class="s2">                stardata-&gt;pre_events_stardata-&gt;star[0].mass, //3</span>
+<span class="s2">                stardata-&gt;common.zero_age.mass[0], //4</span>
+<span class="s2">                stardata-&gt;star[0].SN_type, //5</span>
+
+<span class="s2">                stardata-&gt;star[0].stellar_type, //6</span>
+<span class="s2">                stardata-&gt;pre_events_stardata-&gt;star[0].stellar_type, //7</span>
+<span class="s2">                stardata-&gt;model.probability, //8</span>
+<span class="s2">                stardata-&gt;pre_events_stardata-&gt;star[0].core_mass[ID_core(stardata-&gt;pre_events_stardata-&gt;star[0].stellar_type)],           // 9</span>
+
+<span class="s2">                stardata-&gt;pre_events_stardata-&gt;star[0].core_mass[CORE_CO],     // 10</span>
+<span class="s2">                stardata-&gt;pre_events_stardata-&gt;star[0].core_mass[CORE_He],    // 11</span>
+<span class="s2">                stardata-&gt;star[0].fallback, // 12</span>
+<span class="s2">                stardata-&gt;star[0].fallback_mass // 13</span>
+<span class="s2">            );</span>
+<span class="s2">        }</span>
+<span class="s2">        else</span>
+<span class="s2">        {</span>
+<span class="s2">            Printf(&quot;EXAMPLE_SN </span><span class="si">%30.12e</span><span class="s2"> &quot; // 1</span>
+<span class="s2">                &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> &quot; // 2-5</span>
+<span class="s2">                &quot;</span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> &quot; // 6-9</span>
+<span class="s2">                &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="se">\\</span><span class="s2">n&quot;, // 10-13</span>
+
+<span class="s2">                //</span>
+<span class="s2">                stardata-&gt;model.time, // 1</span>
+
+<span class="s2">                stardata-&gt;star[0].mass, //2</span>
+<span class="s2">                stardata-&gt;previous_stardata-&gt;star[0].mass, //3</span>
+<span class="s2">                stardata-&gt;common.zero_age.mass[0], //4</span>
+<span class="s2">                stardata-&gt;star[0].SN_type, //5</span>
+
+<span class="s2">                stardata-&gt;star[0].stellar_type, //6</span>
+<span class="s2">                stardata-&gt;previous_stardata-&gt;star[0].stellar_type, //7</span>
+<span class="s2">                stardata-&gt;model.probability, //8</span>
+<span class="s2">                stardata-&gt;previous_stardata-&gt;star[0].core_mass[ID_core(stardata-&gt;previous_stardata-&gt;star[0].stellar_type)],           // 9</span>
+
+<span class="s2">                stardata-&gt;previous_stardata-&gt;star[0].core_mass[CORE_CO],     // 10</span>
+<span class="s2">                stardata-&gt;previous_stardata-&gt;star[0].core_mass[CORE_He],    // 11</span>
+<span class="s2">                stardata-&gt;star[0].fallback, // 12</span>
+<span class="s2">                stardata-&gt;star[0].fallback_mass // 13</span>
+<span class="s2">            );</span>
+<span class="s2">        }</span>
+<span class="s2">    };</span>
+<span class="s2">    /* Kill the simulation to save time */</span>
+<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
+<span class="s2">};</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="c1"># Entire script</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">example_logging_string_CO</span><span class="p">)</span>
+
+<span class="c1"># Run system</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">20</span><span class="p">,</span> <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">)</span>
+
+<span class="c1"># print (abridged) output</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[</span><span class="o">-</span><span class="mi">2</span><span class="p">:]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+EXAMPLE_MASSLOSS             9.878236827680e+00 1.61349 8.38063 20 13 1
+EXAMPLE_SN             9.878236827680e+00 1.61349 8.38063 20 12 13 5 1 6.74037 4.92267 6.74037 0 0
+</pre></div></div>
+</div>
+</div>
+</div>
+</div>
+
+
+           </div>
+           
+          </div>
+          <footer>
+  
+    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+      
+        <a href="notebook_population.html" class="btn btn-neutral float-right" title="Running populations with binarycpython" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+      
+      
+        <a href="notebook_individual_systems.html" class="btn btn-neutral float-left" title="Running individual systems with binarycpython" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+      
+    </div>
+  
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>
+        
+        &copy; Copyright 2021, David Hendriks, Robert Izzard
+
+    </p>
+  </div>
+    
+    
+    
+    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
+    
+    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
+    
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+<br><br>
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+<br><br>
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+
+
+
+</footer>
+
+        </div>
+      </div>
+
+    </section>
+
+  </div>
+  
+
+  <script type="text/javascript">
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+
+  
+  
+    
+   
+
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/notebook_custom_logging.ipynb b/docs/build/html/notebook_custom_logging.ipynb
new file mode 100644
index 000000000..e84895375
--- /dev/null
+++ b/docs/build/html/notebook_custom_logging.ipynb
@@ -0,0 +1,517 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "879b596b-d70c-4f90-b668-563b4ad93ffc",
+   "metadata": {},
+   "source": [
+    "# Notebook custom logging\n",
+    "In this notebook you'll learn how to use the custom logging functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "696ecbb9-1efd-48f4-a57e-2cf6dfe416f1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "from binarycpython.utils.custom_logging_functions import (\n",
+    "    autogen_C_logging_code,\n",
+    "    binary_c_log_code,\n",
+    "    create_and_load_logging_function,\n",
+    ")\n",
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "from binarycpython.utils.grid import Population"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d4d721cc-df4f-4ac2-b6f9-62e85ca0c1e5",
+   "metadata": {},
+   "source": [
+    "The custom logging functionality allows us to decide the output of binary_c _without_ modifying the actual sourcecode of binary_c (i.e. editing `src/logging/log_every_timestep` in binary_c). Rather, we can create a logging routine from within python.\n",
+    "\n",
+    "Technically, the following steps are taken:\n",
+    "- User creates a logging print statement from within python\n",
+    "- The logging print statement string gets wrapped into a proper c-function by `binary_c_log_code`\n",
+    "- The c-function string gets compiled and loaded into memory by `create_and_load_logging_function`\n",
+    "- The memory adress of the compiled and loaded print function can now be passed to C\n",
+    "- binary_c uses the custom print function \n",
+    "\n",
+    "The custom logging functionality can be used when running systems via `run_system()`, via `Population.evolve()` and `Population.evolve_single()`, and directly via the API\n",
+    "\n",
+    "Within the logging statement we can access information from the stardata object, as well as use logical statements to determine when to log information. What we cannot do, however, is access functions that are not _publicly available_. For very elaborate printing routines it is still advised to actually hardcode the print statement into binary_c itself."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "be137151-bb57-43d7-bab1-0167512ac727",
+   "metadata": {},
+   "source": [
+    "## Usage"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac4e5f4c-81e6-4980-b852-aca84ca74f4c",
+   "metadata": {},
+   "source": [
+    "There are two methods to create the C-code that will be compiled:\n",
+    "- Automatically generate the print statement and use the wrapper to generate the full function string, by using `autogen_C_logging_code`\n",
+    "- Create your custom print statement and use the wrapper to generate the full function string, by writing out the print statement. Here the logging statement obviously has to be valid C code"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "236cf821-09ac-4237-9b8f-6e36d2edf446",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA %g %g\\n\",((double)stardata->model.time),((double)stardata->star[0].mass));\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines. Here you can choose whatever you want to have logged, and with what header\n",
+    "# this generates working print statements\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "feb423d5-5cc3-433c-9801-f8017abbc03a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "2f5defbf-c623-49ed-a238-fba52a563a58",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "#pragma push_macro(\"Max\")\n",
+      "#pragma push_macro(\"Min\")\n",
+      "#undef Max\n",
+      "#undef Min\n",
+      "#include \"binary_c.h\"\n",
+      "\n",
+      "// add visibility __attribute__ ((visibility (\"default\"))) to it \n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata);\n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata)\n",
+      "{\n",
+      "    // struct stardata_t * stardata = (struct stardata_t *)x;\n",
+      "    Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass);\n",
+      "}\n",
+      "\n",
+      "#undef Max \n",
+      "#undef Min\n",
+      "#pragma pop_macro(\"Min\")\n",
+      "#pragma pop_macro(\"Max\")    \n"
+     ]
+    }
+   ],
+   "source": [
+    "# Generate the entire 'script' by wrapping the logging line\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "print(custom_logging_code)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "efa7f1e9-247e-4196-a883-bcff05265d02",
+   "metadata": {},
+   "source": [
+    "Combining the above with e.g. run_system() (see notebook_individual_systems for more examples):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "dcd74bbc-478b-43e4-b495-8c456e8d1d88",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=1e-06 mass=2\n",
+      "MY_STELLAR_DATA time=2e-06 mass=2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# logging statement\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=2, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1998ee8f-8c0a-462b-b1e0-54f5963902cc",
+   "metadata": {},
+   "source": [
+    "### Using custom logging with the population object\n",
+    "Custom logging can be used for a whole population by setting the print statement (so not the entire logging script) in `C_logging_code`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "77bd09b0-1a94-499d-97db-a1f991c67c12",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_ABOVE_MS             1.041660877905e+02 4.99198 4.99198 6.1357 6.1357 2 1\n",
+      "EXAMPLE_ABOVE_MS             1.041662558619e+02 4.99198 4.99198 6.14057 6.1357 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662560111e+02 4.99198 4.99198 6.14057 6.14057 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662564579e+02 4.99198 4.99198 6.14059 6.14057 2 2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Set up population\n",
+    "pop = Population()\n",
+    "\n",
+    "# Set some BSE parameters\n",
+    "pop.set(\n",
+    "    M_1=5\n",
+    ")\n",
+    "\n",
+    "# Example logging that prints only if the star is post main-sequence\n",
+    "example_logging_string_post_MS = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>MS)\n",
+    "{\n",
+    "    Printf(\"EXAMPLE_ABOVE_MS %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "        // \n",
+    "        stardata->model.time, // 1\n",
+    "\n",
+    "        stardata->star[0].mass, //2\n",
+    "        stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "        stardata->star[0].radius, //4\n",
+    "        stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "        stardata->star[0].stellar_type, //6\n",
+    "        stardata->previous_stardata->star[0].stellar_type //7\n",
+    "  );\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Set the logging\n",
+    "pop.set(\n",
+    "    C_logging_code=example_logging_string_post_MS\n",
+    ")\n",
+    "out = pop.evolve_single()\n",
+    "\n",
+    "# Print (abridged) output\n",
+    "print('\\n'.join(out.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93397ff3-9b71-470d-8bc4-08fe5b1a5dca",
+   "metadata": {},
+   "source": [
+    "### Using custom logging when running directly from the API\n",
+    "When running a system directly with the API we need to manually load the custom logging into memory (via `create_and_load_logging_function`) and pass the memory address to the binary_c binding via `_binary_c_bindings.run_system(argstring, custom_logging_func_memaddr=custom_logging_memaddr)`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "id": "30142286-34ce-433e-82c8-565e2160ff5b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 1e-06 15\n",
+      "MY_STELLAR_DATA 2e-06 15\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "# Generate code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Generate library and get memaddr\n",
+    "custom_logging_memaddr, shared_lib_filename = create_and_load_logging_function(\n",
+    "    custom_logging_code\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "m1 = 15.0  # Msun\n",
+    "m2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000\n",
+    "argstring = \"binary_c M_1 {0:g} M_2 {1:g} separation {2:g} orbital_period {3:g} eccentricity {4:g} metallicity {5:g} max_evolution_time {6:g}\".format(\n",
+    "    m1,\n",
+    "    m2,\n",
+    "    separation,\n",
+    "    orbital_period,\n",
+    "    eccentricity,\n",
+    "    metallicity,\n",
+    "    max_evolution_time,\n",
+    ")\n",
+    "output = _binary_c_bindings.run_system(\n",
+    "    argstring, custom_logging_func_memaddr=custom_logging_memaddr\n",
+    ")\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print('\\n'.join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39c76b1d-d968-4eef-b5ae-2542ed9557c3",
+   "metadata": {},
+   "source": [
+    "## Examples of logging strings\n",
+    "Below are some examples of logging strings"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2ac4af72-6dab-4cc9-986e-5b5b1fa31b73",
+   "metadata": {},
+   "source": [
+    "### Compact object\n",
+    "This logging will print the timestep when the star becomes a compact object. After it does, we change the maximum time to be the current time, effectively terminating the evolution"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "id": "6f0edc65-a788-4706-a0c5-2ace030765ec",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "EXAMPLE_LOG_CO             2.773581245005e+01 1.33524 9.19314 1.72498e-05 730.446 13 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_LOG_CO %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "            stardata->star[0].radius, //4\n",
+    "            stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type //7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=10, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "51c51592-6406-43bd-a879-10ace64aaf28",
+   "metadata": {},
+   "source": [
+    "### Logging mass evolution and the supernova\n",
+    "This logging code prints the mass evolution and the moment the star goes supernova"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 47,
+   "id": "8f58fdf9-3e76-4c18-a1c5-eed0980d4133",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_MASSLOSS             9.878236827680e+00 1.61349 8.38063 20 13 1\n",
+      "EXAMPLE_SN             9.878236827680e+00 1.61349 8.38063 20 12 13 5 1 6.74037 4.92267 6.74037 0 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d %g\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type, //5\n",
+    "    stardata->model.probability //6\n",
+    ");\n",
+    "if(stardata->star[0].SN_type != SN_NONE)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        if(stardata->pre_events_stardata != NULL)\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->pre_events_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->pre_events_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[ID_core(stardata->pre_events_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "        else\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->previous_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->previous_stardata->star[0].core_mass[ID_core(stardata->previous_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=20, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[-2:]))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/notebook_extra_features.html b/docs/build/html/notebook_extra_features.html
new file mode 100644
index 000000000..e48ab4068
--- /dev/null
+++ b/docs/build/html/notebook_extra_features.html
@@ -0,0 +1,518 @@
+
+
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8">
+  
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  
+  <title>Extra features and functionality of binarycpython &mdash; binary_c-python  documentation</title>
+  
+
+  
+  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+  
+  
+  
+  
+
+  
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+    
+      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/language_data.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
+    
+    <script type="text/javascript" src="_static/js/theme.js"></script>
+
+    
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Using the API functionality of binarycpython" href="notebook_api_functionality.html" />
+    <link rel="prev" title="Running populations with binarycpython" href="notebook_population.html" /> 
+</head>
+
+<body class="wy-body-for-nav">
+
+   
+  <div class="wy-grid-for-nav">
+    
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+          
+
+          
+            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
+          
+
+          
+          </a>
+
+          
+            
+            
+          
+
+          
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+          
+        </div>
+
+        
+        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+          
+            
+            
+              
+            
+            
+              <p class="caption"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
+<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
+<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
+</ul>
+
+            
+          
+        </div>
+        
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+      
+      <nav class="wy-nav-top" aria-label="top navigation">
+        
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">binary_c-python</a>
+        
+      </nav>
+
+
+      <div class="wy-nav-content">
+        
+        <div class="rst-content">
+        
+          
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+
+  <ul class="wy-breadcrumbs">
+    
+      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
+        
+          <li><a href="example_notebooks.html">Example notebooks</a> &raquo;</li>
+        
+      <li>Extra features and functionality of binarycpython</li>
+    
+    
+      <li class="wy-breadcrumbs-aside">
+        
+            
+            <a href="_sources/notebook_extra_features.ipynb.txt" rel="nofollow"> View page source</a>
+          
+        
+      </li>
+    
+  </ul>
+
+  
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+            
+  
+<style>
+/* CSS for nbsphinx extension */
+
+/* remove conflicting styling from Sphinx themes */
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt *,
+div.nbinput.container div.input_area pre,
+div.nboutput.container div.output_area pre,
+div.nbinput.container div.input_area .highlight,
+div.nboutput.container div.output_area .highlight {
+    border: none;
+    padding: 0;
+    margin: 0;
+    box-shadow: none;
+}
+
+div.nbinput.container > div[class*=highlight],
+div.nboutput.container > div[class*=highlight] {
+    margin: 0;
+}
+
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt * {
+    background: none;
+}
+
+div.nboutput.container div.output_area .highlight,
+div.nboutput.container div.output_area pre {
+    background: unset;
+}
+
+div.nboutput.container div.output_area div.highlight {
+    color: unset;  /* override Pygments text color */
+}
+
+/* avoid gaps between output lines */
+div.nboutput.container div[class*=highlight] pre {
+    line-height: normal;
+}
+
+/* input/output containers */
+div.nbinput.container,
+div.nboutput.container {
+    display: -webkit-flex;
+    display: flex;
+    align-items: flex-start;
+    margin: 0;
+    width: 100%;
+}
+@media (max-width: 540px) {
+    div.nbinput.container,
+    div.nboutput.container {
+        flex-direction: column;
+    }
+}
+
+/* input container */
+div.nbinput.container {
+    padding-top: 5px;
+}
+
+/* last container */
+div.nblast.container {
+    padding-bottom: 5px;
+}
+
+/* input prompt */
+div.nbinput.container div.prompt pre {
+    color: #307FC1;
+}
+
+/* output prompt */
+div.nboutput.container div.prompt pre {
+    color: #BF5B3D;
+}
+
+/* all prompts */
+div.nbinput.container div.prompt,
+div.nboutput.container div.prompt {
+    width: 4.5ex;
+    padding-top: 5px;
+    position: relative;
+    user-select: none;
+}
+
+div.nbinput.container div.prompt > div,
+div.nboutput.container div.prompt > div {
+    position: absolute;
+    right: 0;
+    margin-right: 0.3ex;
+}
+
+@media (max-width: 540px) {
+    div.nbinput.container div.prompt,
+    div.nboutput.container div.prompt {
+        width: unset;
+        text-align: left;
+        padding: 0.4em;
+    }
+    div.nboutput.container div.prompt.empty {
+        padding: 0;
+    }
+
+    div.nbinput.container div.prompt > div,
+    div.nboutput.container div.prompt > div {
+        position: unset;
+    }
+}
+
+/* disable scrollbars on prompts */
+div.nbinput.container div.prompt pre,
+div.nboutput.container div.prompt pre {
+    overflow: hidden;
+}
+
+/* input/output area */
+div.nbinput.container div.input_area,
+div.nboutput.container div.output_area {
+    -webkit-flex: 1;
+    flex: 1;
+    overflow: auto;
+}
+@media (max-width: 540px) {
+    div.nbinput.container div.input_area,
+    div.nboutput.container div.output_area {
+        width: 100%;
+    }
+}
+
+/* input area */
+div.nbinput.container div.input_area {
+    border: 1px solid #e0e0e0;
+    border-radius: 2px;
+    /*background: #f5f5f5;*/
+}
+
+/* override MathJax center alignment in output cells */
+div.nboutput.container div[class*=MathJax] {
+    text-align: left !important;
+}
+
+/* override sphinx.ext.imgmath center alignment in output cells */
+div.nboutput.container div.math p {
+    text-align: left;
+}
+
+/* standard error */
+div.nboutput.container div.output_area.stderr {
+    background: #fdd;
+}
+
+/* ANSI colors */
+.ansi-black-fg { color: #3E424D; }
+.ansi-black-bg { background-color: #3E424D; }
+.ansi-black-intense-fg { color: #282C36; }
+.ansi-black-intense-bg { background-color: #282C36; }
+.ansi-red-fg { color: #E75C58; }
+.ansi-red-bg { background-color: #E75C58; }
+.ansi-red-intense-fg { color: #B22B31; }
+.ansi-red-intense-bg { background-color: #B22B31; }
+.ansi-green-fg { color: #00A250; }
+.ansi-green-bg { background-color: #00A250; }
+.ansi-green-intense-fg { color: #007427; }
+.ansi-green-intense-bg { background-color: #007427; }
+.ansi-yellow-fg { color: #DDB62B; }
+.ansi-yellow-bg { background-color: #DDB62B; }
+.ansi-yellow-intense-fg { color: #B27D12; }
+.ansi-yellow-intense-bg { background-color: #B27D12; }
+.ansi-blue-fg { color: #208FFB; }
+.ansi-blue-bg { background-color: #208FFB; }
+.ansi-blue-intense-fg { color: #0065CA; }
+.ansi-blue-intense-bg { background-color: #0065CA; }
+.ansi-magenta-fg { color: #D160C4; }
+.ansi-magenta-bg { background-color: #D160C4; }
+.ansi-magenta-intense-fg { color: #A03196; }
+.ansi-magenta-intense-bg { background-color: #A03196; }
+.ansi-cyan-fg { color: #60C6C8; }
+.ansi-cyan-bg { background-color: #60C6C8; }
+.ansi-cyan-intense-fg { color: #258F8F; }
+.ansi-cyan-intense-bg { background-color: #258F8F; }
+.ansi-white-fg { color: #C5C1B4; }
+.ansi-white-bg { background-color: #C5C1B4; }
+.ansi-white-intense-fg { color: #A1A6B2; }
+.ansi-white-intense-bg { background-color: #A1A6B2; }
+
+.ansi-default-inverse-fg { color: #FFFFFF; }
+.ansi-default-inverse-bg { background-color: #000000; }
+
+.ansi-bold { font-weight: bold; }
+.ansi-underline { text-decoration: underline; }
+
+
+div.nbinput.container div.input_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight].math,
+div.nboutput.container div.output_area.rendered_html,
+div.nboutput.container div.output_area > div.output_javascript,
+div.nboutput.container div.output_area:not(.rendered_html) > img{
+    padding: 5px;
+    margin: 0;
+}
+
+/* fix copybtn overflow problem in chromium (needed for 'sphinx_copybutton') */
+div.nbinput.container div.input_area > div[class^='highlight'],
+div.nboutput.container div.output_area > div[class^='highlight']{
+    overflow-y: hidden;
+}
+
+/* hide copybtn icon on prompts (needed for 'sphinx_copybutton') */
+.prompt a.copybtn {
+    display: none;
+}
+
+/* Some additional styling taken form the Jupyter notebook CSS */
+div.rendered_html table {
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: black;
+  font-size: 12px;
+  table-layout: fixed;
+}
+div.rendered_html thead {
+  border-bottom: 1px solid black;
+  vertical-align: bottom;
+}
+div.rendered_html tr,
+div.rendered_html th,
+div.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+div.rendered_html th {
+  font-weight: bold;
+}
+div.rendered_html tbody tr:nth-child(odd) {
+  background: #f5f5f5;
+}
+div.rendered_html tbody tr:hover {
+  background: rgba(66, 165, 245, 0.2);
+}
+
+/* CSS overrides for sphinx_rtd_theme */
+
+/* 24px margin */
+.nbinput.nblast.container,
+.nboutput.nblast.container {
+    margin-bottom: 19px;  /* padding has already 5px */
+}
+
+/* ... except between code cells! */
+.nblast.container + .nbinput.container {
+    margin-top: -19px;
+}
+
+.admonition > p:before {
+    margin-right: 4px;  /* make room for the exclamation icon */
+}
+
+/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
+.math {
+    text-align: unset;
+}
+</style>
+<div class="section" id="Extra-features-and-functionality-of-binarycpython">
+<h1>Extra features and functionality of binarycpython<a class="headerlink" href="#Extra-features-and-functionality-of-binarycpython" title="Permalink to this headline">¶</a></h1>
+<p>In this notebook we’ll go over some of the extra features and functionality that was not covered in the other notebooks.</p>
+<p>TODO</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span>
+</pre></div>
+</div>
+</div>
+</div>
+
+
+           </div>
+           
+          </div>
+          <footer>
+  
+    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+      
+        <a href="notebook_api_functionality.html" class="btn btn-neutral float-right" title="Using the API functionality of binarycpython" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+      
+      
+        <a href="notebook_population.html" class="btn btn-neutral float-left" title="Running populations with binarycpython" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+      
+    </div>
+  
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>
+        
+        &copy; Copyright 2021, David Hendriks, Robert Izzard
+
+    </p>
+  </div>
+    
+    
+    
+    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
+    
+    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
+    
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+<br><br>
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+<br><br>
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+
+
+
+</footer>
+
+        </div>
+      </div>
+
+    </section>
+
+  </div>
+  
+
+  <script type="text/javascript">
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+
+  
+  
+    
+   
+
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/notebook_extra_features.ipynb b/docs/build/html/notebook_extra_features.ipynb
new file mode 100644
index 000000000..d453a6f5b
--- /dev/null
+++ b/docs/build/html/notebook_extra_features.ipynb
@@ -0,0 +1,44 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d5c04b77-f0be-4b33-8c03-c72eb846527c",
+   "metadata": {},
+   "source": [
+    "# Extra features and functionality of binarycpython\n",
+    "In this notebook we'll go over some of the extra features and functionality that was not covered in the other notebooks.\n",
+    "\n",
+    "TODO"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0020f1bc-2a23-455c-8216-9e63e6e038ae",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/notebook_individual_systems.html b/docs/build/html/notebook_individual_systems.html
new file mode 100644
index 000000000..0d679203a
--- /dev/null
+++ b/docs/build/html/notebook_individual_systems.html
@@ -0,0 +1,934 @@
+
+
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8">
+  
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  
+  <title>Running individual systems with binarycpython &mdash; binary_c-python  documentation</title>
+  
+
+  
+  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+  
+  
+  
+  
+
+  
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+    
+      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/language_data.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
+    
+    <script type="text/javascript" src="_static/js/theme.js"></script>
+
+    
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Notebook custom logging" href="notebook_custom_logging.html" />
+    <link rel="prev" title="Example notebooks" href="example_notebooks.html" /> 
+</head>
+
+<body class="wy-body-for-nav">
+
+   
+  <div class="wy-grid-for-nav">
+    
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+          
+
+          
+            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
+          
+
+          
+          </a>
+
+          
+            
+            
+          
+
+          
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+          
+        </div>
+
+        
+        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+          
+            
+            
+              
+            
+            
+              <p class="caption"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
+<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Running individual systems with binarycpython</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Single-system-with-run_wrapper">Single system with run_wrapper</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Single-system-via-population-object">Single system via population object</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Single-system-via-API-functionality">Single system via API functionality</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_population.html">Running populations with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
+<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
+</ul>
+
+            
+          
+        </div>
+        
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+      
+      <nav class="wy-nav-top" aria-label="top navigation">
+        
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">binary_c-python</a>
+        
+      </nav>
+
+
+      <div class="wy-nav-content">
+        
+        <div class="rst-content">
+        
+          
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+
+  <ul class="wy-breadcrumbs">
+    
+      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
+        
+          <li><a href="example_notebooks.html">Example notebooks</a> &raquo;</li>
+        
+      <li>Running individual systems with binarycpython</li>
+    
+    
+      <li class="wy-breadcrumbs-aside">
+        
+            
+            <a href="_sources/notebook_individual_systems.ipynb.txt" rel="nofollow"> View page source</a>
+          
+        
+      </li>
+    
+  </ul>
+
+  
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+            
+  
+<style>
+/* CSS for nbsphinx extension */
+
+/* remove conflicting styling from Sphinx themes */
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt *,
+div.nbinput.container div.input_area pre,
+div.nboutput.container div.output_area pre,
+div.nbinput.container div.input_area .highlight,
+div.nboutput.container div.output_area .highlight {
+    border: none;
+    padding: 0;
+    margin: 0;
+    box-shadow: none;
+}
+
+div.nbinput.container > div[class*=highlight],
+div.nboutput.container > div[class*=highlight] {
+    margin: 0;
+}
+
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt * {
+    background: none;
+}
+
+div.nboutput.container div.output_area .highlight,
+div.nboutput.container div.output_area pre {
+    background: unset;
+}
+
+div.nboutput.container div.output_area div.highlight {
+    color: unset;  /* override Pygments text color */
+}
+
+/* avoid gaps between output lines */
+div.nboutput.container div[class*=highlight] pre {
+    line-height: normal;
+}
+
+/* input/output containers */
+div.nbinput.container,
+div.nboutput.container {
+    display: -webkit-flex;
+    display: flex;
+    align-items: flex-start;
+    margin: 0;
+    width: 100%;
+}
+@media (max-width: 540px) {
+    div.nbinput.container,
+    div.nboutput.container {
+        flex-direction: column;
+    }
+}
+
+/* input container */
+div.nbinput.container {
+    padding-top: 5px;
+}
+
+/* last container */
+div.nblast.container {
+    padding-bottom: 5px;
+}
+
+/* input prompt */
+div.nbinput.container div.prompt pre {
+    color: #307FC1;
+}
+
+/* output prompt */
+div.nboutput.container div.prompt pre {
+    color: #BF5B3D;
+}
+
+/* all prompts */
+div.nbinput.container div.prompt,
+div.nboutput.container div.prompt {
+    width: 4.5ex;
+    padding-top: 5px;
+    position: relative;
+    user-select: none;
+}
+
+div.nbinput.container div.prompt > div,
+div.nboutput.container div.prompt > div {
+    position: absolute;
+    right: 0;
+    margin-right: 0.3ex;
+}
+
+@media (max-width: 540px) {
+    div.nbinput.container div.prompt,
+    div.nboutput.container div.prompt {
+        width: unset;
+        text-align: left;
+        padding: 0.4em;
+    }
+    div.nboutput.container div.prompt.empty {
+        padding: 0;
+    }
+
+    div.nbinput.container div.prompt > div,
+    div.nboutput.container div.prompt > div {
+        position: unset;
+    }
+}
+
+/* disable scrollbars on prompts */
+div.nbinput.container div.prompt pre,
+div.nboutput.container div.prompt pre {
+    overflow: hidden;
+}
+
+/* input/output area */
+div.nbinput.container div.input_area,
+div.nboutput.container div.output_area {
+    -webkit-flex: 1;
+    flex: 1;
+    overflow: auto;
+}
+@media (max-width: 540px) {
+    div.nbinput.container div.input_area,
+    div.nboutput.container div.output_area {
+        width: 100%;
+    }
+}
+
+/* input area */
+div.nbinput.container div.input_area {
+    border: 1px solid #e0e0e0;
+    border-radius: 2px;
+    /*background: #f5f5f5;*/
+}
+
+/* override MathJax center alignment in output cells */
+div.nboutput.container div[class*=MathJax] {
+    text-align: left !important;
+}
+
+/* override sphinx.ext.imgmath center alignment in output cells */
+div.nboutput.container div.math p {
+    text-align: left;
+}
+
+/* standard error */
+div.nboutput.container div.output_area.stderr {
+    background: #fdd;
+}
+
+/* ANSI colors */
+.ansi-black-fg { color: #3E424D; }
+.ansi-black-bg { background-color: #3E424D; }
+.ansi-black-intense-fg { color: #282C36; }
+.ansi-black-intense-bg { background-color: #282C36; }
+.ansi-red-fg { color: #E75C58; }
+.ansi-red-bg { background-color: #E75C58; }
+.ansi-red-intense-fg { color: #B22B31; }
+.ansi-red-intense-bg { background-color: #B22B31; }
+.ansi-green-fg { color: #00A250; }
+.ansi-green-bg { background-color: #00A250; }
+.ansi-green-intense-fg { color: #007427; }
+.ansi-green-intense-bg { background-color: #007427; }
+.ansi-yellow-fg { color: #DDB62B; }
+.ansi-yellow-bg { background-color: #DDB62B; }
+.ansi-yellow-intense-fg { color: #B27D12; }
+.ansi-yellow-intense-bg { background-color: #B27D12; }
+.ansi-blue-fg { color: #208FFB; }
+.ansi-blue-bg { background-color: #208FFB; }
+.ansi-blue-intense-fg { color: #0065CA; }
+.ansi-blue-intense-bg { background-color: #0065CA; }
+.ansi-magenta-fg { color: #D160C4; }
+.ansi-magenta-bg { background-color: #D160C4; }
+.ansi-magenta-intense-fg { color: #A03196; }
+.ansi-magenta-intense-bg { background-color: #A03196; }
+.ansi-cyan-fg { color: #60C6C8; }
+.ansi-cyan-bg { background-color: #60C6C8; }
+.ansi-cyan-intense-fg { color: #258F8F; }
+.ansi-cyan-intense-bg { background-color: #258F8F; }
+.ansi-white-fg { color: #C5C1B4; }
+.ansi-white-bg { background-color: #C5C1B4; }
+.ansi-white-intense-fg { color: #A1A6B2; }
+.ansi-white-intense-bg { background-color: #A1A6B2; }
+
+.ansi-default-inverse-fg { color: #FFFFFF; }
+.ansi-default-inverse-bg { background-color: #000000; }
+
+.ansi-bold { font-weight: bold; }
+.ansi-underline { text-decoration: underline; }
+
+
+div.nbinput.container div.input_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight].math,
+div.nboutput.container div.output_area.rendered_html,
+div.nboutput.container div.output_area > div.output_javascript,
+div.nboutput.container div.output_area:not(.rendered_html) > img{
+    padding: 5px;
+    margin: 0;
+}
+
+/* fix copybtn overflow problem in chromium (needed for 'sphinx_copybutton') */
+div.nbinput.container div.input_area > div[class^='highlight'],
+div.nboutput.container div.output_area > div[class^='highlight']{
+    overflow-y: hidden;
+}
+
+/* hide copybtn icon on prompts (needed for 'sphinx_copybutton') */
+.prompt a.copybtn {
+    display: none;
+}
+
+/* Some additional styling taken form the Jupyter notebook CSS */
+div.rendered_html table {
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: black;
+  font-size: 12px;
+  table-layout: fixed;
+}
+div.rendered_html thead {
+  border-bottom: 1px solid black;
+  vertical-align: bottom;
+}
+div.rendered_html tr,
+div.rendered_html th,
+div.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+div.rendered_html th {
+  font-weight: bold;
+}
+div.rendered_html tbody tr:nth-child(odd) {
+  background: #f5f5f5;
+}
+div.rendered_html tbody tr:hover {
+  background: rgba(66, 165, 245, 0.2);
+}
+
+/* CSS overrides for sphinx_rtd_theme */
+
+/* 24px margin */
+.nbinput.nblast.container,
+.nboutput.nblast.container {
+    margin-bottom: 19px;  /* padding has already 5px */
+}
+
+/* ... except between code cells! */
+.nblast.container + .nbinput.container {
+    margin-top: -19px;
+}
+
+.admonition > p:before {
+    margin-right: 4px;  /* make room for the exclamation icon */
+}
+
+/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
+.math {
+    text-align: unset;
+}
+</style>
+<div class="section" id="Running-individual-systems-with-binarycpython">
+<h1>Running individual systems with binarycpython<a class="headerlink" href="#Running-individual-systems-with-binarycpython" title="Permalink to this headline">¶</a></h1>
+<p>This notebook will show you how to run single systems and analyze their results.</p>
+<p>It can be useful to have some functions to quickly run a single system to e.g. inspect what evolutionary steps a specific system goes through, to plot the mass loss evolution of a single star, etc.</p>
+<div class="section" id="Single-system-with-run_wrapper">
+<h2>Single system with run_wrapper<a class="headerlink" href="#Single-system-with-run_wrapper" title="Permalink to this headline">¶</a></h2>
+<p>The simplest method to run a single system is to use the run_system wrapper. This function deals with setting up the argument string, makes sure all the required parameters are included and handles setting and cleaning up the custom logging functionality (see notebook_custom_logging).</p>
+<p>As arguments to this function we can add any of the parameters that binary_c itself actually knows, as well as: - custom_logging_code: string containing a print statement that binary_c can use to print information - log_filename: path of the logfile that binary_c generates - parse_function: function that handles parsing the output of binary-c</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">from</span> <span class="nn">binarycpython.utils.run_system_wrapper</span> <span class="kn">import</span> <span class="n">run_system</span>
+<span class="c1"># help(run_system) # Uncomment to see the docstring</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+SINGLE_STAR_LIFETIME 1 12462
+
+</pre></div></div>
+</div>
+<p>Lets try adding a log filename now:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">log_filename</span><span class="o">=</span><span class="s1">&#39;/tmp/test_logfile.txt&#39;</span><span class="p">)</span>
+<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="s1">&#39;/tmp/test_logfile.txt&#39;</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+      TIME      M1       M2   K1  K2           SEP   ECC  R1/ROL1 R2/ROL2  TYPE RANDOM_SEED=67365 RANDOM_COUNT=0
+     0.0000    1.000    0.000  1  15            -1 -1.00   0.000   0.000  &#34;INITIAL &#34;
+ 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  &#34;OFF_MS&#34;
+ 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 11582.2424    1.000    0.000  3  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 12325.1085    0.817    0.000  4  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 12457.1300    0.783    0.000  5  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  &#34;shrinkAGB&#34;
+ 12461.9514    0.523    0.000 11  15            -1 -1.00   0.000   0.000  &#34;TYPE_CHNGE&#34;
+ 15000.0000    0.523    0.000 11  15            -1 -1.00   0.000   0.000  &#34;MAX_TIME&#34;
+
+</pre></div></div>
+</div>
+<p>To get more useful output we can include a custom_logging snippet (see notebook_custom_logging):</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">binary_c_log_code</span>
+
+<span class="c1"># Create the print statement</span>
+<span class="n">custom_logging_print_statement</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">Printf(&quot;EXAMPLE_MASSLOSS </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">    //</span>
+<span class="s2">    stardata-&gt;model.time, // 1</span>
+<span class="s2">    stardata-&gt;star[0].mass, //2</span>
+<span class="s2">    stardata-&gt;common.zero_age.mass[0], //4</span>
+
+<span class="s2">    stardata-&gt;star[0].stellar_type //5</span>
+<span class="s2">);</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="c1"># Generate entire shared lib code around logging lines</span>
+<span class="n">custom_logging_code</span> <span class="o">=</span> <span class="n">binary_c_log_code</span><span class="p">(</span><span class="n">custom_logging_print_statement</span><span class="p">)</span>
+
+<span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[&#39;EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1&#39;, &#39;EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1&#39;, &#39;EXAMPLE_MASSLOSS             1.000000000000e-06 1 1 1&#39;, &#39;EXAMPLE_MASSLOSS             2.000000000000e-06 1 1 1&#39;]
+</pre></div></div>
+</div>
+<p>Now we have some actual output, it is time to create a parse_function which parses the output. Adding a parse_function to the run_system will make run_system run the output of binary_c through the parse_function.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="n">output</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Example function to parse the output of binary_c</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1">#</span>
+    <span class="n">column_names</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;time&#39;</span><span class="p">,</span> <span class="s1">&#39;mass&#39;</span><span class="p">,</span> <span class="s1">&#39;initial_mass&#39;</span><span class="p">,</span> <span class="s1">&#39;stellar_type&#39;</span><span class="p">]</span>
+    <span class="n">value_lines</span> <span class="o">=</span> <span class="p">[</span><span class="n">column_names</span><span class="p">]</span>
+
+    <span class="c1"># Loop over output</span>
+    <span class="k">for</span> <span class="n">line</span> <span class="ow">in</span> <span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">():</span>
+
+        <span class="c1"># Select the lines starting with the header we chose</span>
+        <span class="k">if</span> <span class="n">line</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;EXAMPLE_MASSLOSS&quot;</span><span class="p">):</span>
+
+        <span class="c1"># Split the output and fetch the data</span>
+            <span class="n">split_line</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">split</span><span class="p">()</span>
+            <span class="n">values</span> <span class="o">=</span> <span class="p">[</span><span class="nb">float</span><span class="p">(</span><span class="n">el</span><span class="p">)</span> <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">split_line</span><span class="p">[</span><span class="mi">1</span><span class="p">:]]</span>
+            <span class="n">value_lines</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">value_lines</span>
+
+<span class="c1"># Catch output</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">run_system</span><span class="p">(</span><span class="n">M_1</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">custom_logging_code</span><span class="o">=</span><span class="n">custom_logging_code</span><span class="p">,</span> <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">[:</span><span class="mi">3</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[[&#39;time&#39;, &#39;mass&#39;, &#39;initial_mass&#39;, &#39;stellar_type&#39;], [0.0, 1.0, 1.0, 1.0], [0.0, 1.0, 1.0, 1.0]]
+</pre></div></div>
+</div>
+<p>This output can now be turned into e.g. an Numpy array or Pandas dataframe (my favorite: makes querying the data very easy)</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
+
+<span class="c1"># Load data into dataframe</span>
+<span class="n">example_df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+
+<span class="c1"># Fix column headers</span>
+<span class="n">example_df</span><span class="o">.</span><span class="n">columns</span> <span class="o">=</span> <span class="n">example_df</span><span class="o">.</span><span class="n">iloc</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+<span class="n">example_df</span> <span class="o">=</span> <span class="n">example_df</span><span class="o">.</span><span class="n">drop</span><span class="p">(</span><span class="n">example_df</span><span class="o">.</span><span class="n">index</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">example_df</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+0        time      mass initial_mass stellar_type
+1           0         1            1            1
+2           0         1            1            1
+3       1e-06         1            1            1
+4       2e-06         1            1            1
+5       3e-06         1            1            1
+...       ...       ...          ...          ...
+1612  12461.8  0.577754            1            6
+1613    12462  0.522806            1           11
+1614    13462  0.522806            1           11
+1615    14462  0.522806            1           11
+1616    15000  0.522806            1           11
+
+[1616 rows x 4 columns]
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Single-system-via-population-object">
+<h2>Single system via population object<a class="headerlink" href="#Single-system-via-population-object" title="Permalink to this headline">¶</a></h2>
+<p>When setting up your population object (see notebook_population), and configuring all the parameters, it is possible to run a single system using that same configuration. It will use the parse_function if set, and running a single system is a good method to test if everything works accordingly.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
+<span class="c1"># help(Population) # Uncomment to see the docstring</span>
+</pre></div>
+</div>
+</div>
+<p>First, let’s try this without any custom logging or parsing functionality</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># Create the population object</span>
+<span class="n">example_pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
+
+<span class="c1"># Set some parameters</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">verbosity</span><span class="o">=</span><span class="mi">1</span>
+<span class="p">)</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span>
+<span class="p">)</span>
+
+<span class="c1"># get output and print</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">evolve_single</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+adding: M_1=10 to BSE_options
+Creating and loading custom logging functionality
+Running binary_c M_1 10
+Cleaning up the custom logging stuff. type: single
+SINGLE_STAR_LIFETIME 10 27.7358
+
+</pre></div></div>
+</div>
+<p>Now lets add some actual output with the custom logging</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[13]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">custom_logging_print_statement</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">Printf(&quot;EXAMPLE_MASSLOSS </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">    //</span>
+<span class="s2">    stardata-&gt;model.time, // 1</span>
+<span class="s2">    stardata-&gt;star[0].mass, //2</span>
+<span class="s2">    stardata-&gt;previous_stardata-&gt;star[0].mass, //3</span>
+<span class="s2">    stardata-&gt;common.zero_age.mass[0], //4</span>
+
+<span class="s2">    stardata-&gt;star[0].stellar_type //5</span>
+<span class="s2">);</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">C_logging_code</span><span class="o">=</span><span class="n">custom_logging_print_statement</span><span class="p">)</span>
+
+<span class="c1"># get output and print</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">evolve_single</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+adding: C_logging_code=
+Printf(&#34;EXAMPLE_MASSLOSS %30.12e %g %g %g %d\n&#34;,
+    //
+    stardata-&gt;model.time, // 1
+    stardata-&gt;star[0].mass, //2
+    stardata-&gt;previous_stardata-&gt;star[0].mass, //3
+    stardata-&gt;common.zero_age.mass[0], //4
+
+    stardata-&gt;star[0].stellar_type //5
+);
+ to grid_options
+Creating and loading custom logging functionality
+Running binary_c M_1 10
+Cleaning up the custom logging stuff. type: single
+Removed /tmp/binary_c_python/custom_logging/libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294.so
+[&#39;EXAMPLE_MASSLOSS             0.000000000000e+00 10 0 10 1&#39;, &#39;EXAMPLE_MASSLOSS             0.000000000000e+00 10 10 10 1&#39;, &#39;EXAMPLE_MASSLOSS             1.000000000000e-06 10 10 10 1&#39;, &#39;EXAMPLE_MASSLOSS             2.000000000000e-06 10 10 10 1&#39;]
+</pre></div></div>
+</div>
+<p>Lastly we can add a parse_function to handle parsing the output again.</p>
+<p>Because the parse_function will now be part of the population object, it can access information of the object. We need to make a new parse function that is fit for an object: we the arguments now need to be (self, output). Returning the data is useful when running evolve_single(), but won’t be used in a population evolution.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[14]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">json</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="k">def</span> <span class="nf">object_parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Example parse function that can be added to the population object</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># We can access object instance information now.</span>
+    <span class="c1"># In this way we can store the results in a file for example.</span>
+    <span class="n">output_file</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s1">&#39;output_dir&#39;</span><span class="p">],</span> <span class="s1">&#39;example_output.json&#39;</span><span class="p">)</span>
+
+    <span class="c1">#</span>
+    <span class="n">column_names</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;time&#39;</span><span class="p">,</span> <span class="s1">&#39;mass&#39;</span><span class="p">,</span> <span class="s1">&#39;initial_mass&#39;</span><span class="p">,</span> <span class="s1">&#39;stellar_type&#39;</span><span class="p">]</span>
+    <span class="n">value_lines</span> <span class="o">=</span> <span class="p">[</span><span class="n">column_names</span><span class="p">]</span>
+
+    <span class="c1"># Loop over output</span>
+    <span class="k">for</span> <span class="n">line</span> <span class="ow">in</span> <span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">():</span>
+
+        <span class="c1"># Select the lines starting with the header we chose</span>
+        <span class="k">if</span> <span class="n">line</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;EXAMPLE_MASSLOSS&quot;</span><span class="p">):</span>
+
+        <span class="c1"># Split the output and fetch the data</span>
+            <span class="n">split_line</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">split</span><span class="p">()</span>
+            <span class="n">values</span> <span class="o">=</span> <span class="p">[</span><span class="nb">float</span><span class="p">(</span><span class="n">el</span><span class="p">)</span> <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">split_line</span><span class="p">[</span><span class="mi">1</span><span class="p">:]]</span>
+            <span class="n">value_lines</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
+
+    <span class="c1"># Turn into an array</span>
+    <span class="n">values_array</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">value_lines</span><span class="p">[</span><span class="mi">1</span><span class="p">:])</span>
+
+    <span class="c1"># make dict and fill</span>
+    <span class="n">output_dict</span> <span class="o">=</span> <span class="p">{}</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">column_names</span><span class="p">)):</span>
+        <span class="n">output_dict</span><span class="p">[</span><span class="n">column_names</span><span class="p">[</span><span class="n">i</span><span class="p">]]</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">values_array</span><span class="p">[:,</span><span class="n">i</span><span class="p">])</span>
+
+    <span class="c1"># Write to file</span>
+    <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">output_file</span><span class="p">,</span> <span class="s1">&#39;w&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">output_dict</span><span class="p">,</span> <span class="n">indent</span><span class="o">=</span><span class="mi">4</span><span class="p">))</span>
+
+    <span class="c1"># Return something anyway</span>
+    <span class="k">return</span> <span class="n">value_lines</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[15]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">parse_function</span><span class="o">=</span><span class="n">object_parse_function</span><span class="p">,</span>
+    <span class="n">output_dir</span><span class="o">=</span><span class="s1">&#39;/tmp/&#39;</span>
+<span class="p">)</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">evolve_single</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">[:</span><span class="mi">4</span><span class="p">])</span>
+
+<span class="c1"># Example of loading the data that was written</span>
+<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s1">&#39;output_dir&#39;</span><span class="p">],</span> <span class="s1">&#39;example_output.json&#39;</span><span class="p">))</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+    <span class="n">written_data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">())</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">written_data</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+adding: parse_function=&lt;function object_parse_function at 0x7f9265091598&gt; to grid_options
+&lt;&lt;&lt;&lt; Warning: Key does not match previously known parameter:                     adding: output_dir=/tmp/ to custom_options &gt;&gt;&gt;&gt;
+Creating and loading custom logging functionality
+Running binary_c M_1 10
+Cleaning up the custom logging stuff. type: single
+Removed /tmp/binary_c_python/custom_logging/libcustom_logging_e9c2bec7f15541eb847fc6013e48e7ed.so
+[[&#39;time&#39;, &#39;mass&#39;, &#39;initial_mass&#39;, &#39;stellar_type&#39;], [0.0, 10.0, 0.0, 10.0, 1.0], [0.0, 10.0, 10.0, 10.0, 1.0], [1e-06, 10.0, 10.0, 10.0, 1.0]]
+dict_keys([&#39;time&#39;, &#39;mass&#39;, &#39;initial_mass&#39;, &#39;stellar_type&#39;])
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Single-system-via-API-functionality">
+<h2>Single system via API functionality<a class="headerlink" href="#Single-system-via-API-functionality" title="Permalink to this headline">¶</a></h2>
+<p>It is possible to construct your own functionality to run a single system by directly calling the API function to run a system. Under the hood all the other functions and wrappers actually use this API.</p>
+<p>There are less failsafes for this method, so this make sure the input is correct and binary_c knows all the arguments you pass in.</p>
+<p>for more details on this API function see <code class="docutils literal notranslate"><span class="pre">notebook_api_functions</span></code></p>
+<p>First we must construct the argument string that we pass to binary_c</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[16]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># For a binary system we need to pass in these arguments</span>
+<span class="n">M_1</span> <span class="o">=</span> <span class="mf">15.0</span>  <span class="c1"># Msun</span>
+<span class="n">M_2</span> <span class="o">=</span> <span class="mf">14.0</span>  <span class="c1"># Msun</span>
+<span class="n">separation</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># 0 = ignored, use period</span>
+<span class="n">orbital_period</span> <span class="o">=</span> <span class="mf">4530.0</span>  <span class="c1"># days</span>
+<span class="n">eccentricity</span> <span class="o">=</span> <span class="mf">0.0</span>
+<span class="n">metallicity</span> <span class="o">=</span> <span class="mf">0.02</span>
+<span class="n">max_evolution_time</span> <span class="o">=</span> <span class="mi">15000</span>  <span class="c1"># Myr. You need to include this argument.</span>
+
+<span class="c1"># Here we set up the argument string that is passed to the bindings</span>
+<span class="n">argstring</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">binary_c M_1 </span><span class="si">{M_1}</span><span class="s2"> M_2 </span><span class="si">{M_2}</span><span class="s2"> separation </span><span class="si">{separation}</span><span class="s2"> orbital_period </span><span class="si">{orbital_period}</span><span class="s2"> eccentricity </span><span class="si">{eccentricity}</span><span class="s2"> metallicity </span><span class="si">{metallicity}</span><span class="s2"> max_evolution_time </span><span class="si">{max_evolution_time}</span><span class="s2"></span>
+<span class="s2">&quot;&quot;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="n">M_1</span><span class="p">,</span>
+    <span class="n">M_2</span><span class="o">=</span><span class="n">M_2</span><span class="p">,</span>
+    <span class="n">separation</span><span class="o">=</span><span class="n">separation</span><span class="p">,</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="n">orbital_period</span><span class="p">,</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="n">eccentricity</span><span class="p">,</span>
+    <span class="n">metallicity</span><span class="o">=</span><span class="n">metallicity</span><span class="p">,</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="n">max_evolution_time</span><span class="p">,</span>
+<span class="p">)</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+
+<span class="kn">from</span> <span class="nn">binarycpython</span> <span class="kn">import</span> <span class="n">_binary_c_bindings</span>
+
+<span class="n">output</span> <span class="o">=</span> <span class="n">_binary_c_bindings</span><span class="o">.</span><span class="n">run_system</span><span class="p">(</span><span class="n">argstring</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+SINGLE_STAR_LIFETIME 15 14.2383
+
+</pre></div></div>
+</div>
+<p>As we can see above, the output is rather empty. But if SINGLE_STAR_LIFETIME is printed we know we caught the output correctly. To get actual output we should have timesteps printed in the <code class="docutils literal notranslate"><span class="pre">log_every_timestep.c</span></code> in binary_c, or add some custom_logging (see notebook_custom_logging).</p>
+</div>
+</div>
+
+
+           </div>
+           
+          </div>
+          <footer>
+  
+    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+      
+        <a href="notebook_custom_logging.html" class="btn btn-neutral float-right" title="Notebook custom logging" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+      
+      
+        <a href="example_notebooks.html" class="btn btn-neutral float-left" title="Example notebooks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+      
+    </div>
+  
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>
+        
+        &copy; Copyright 2021, David Hendriks, Robert Izzard
+
+    </p>
+  </div>
+    
+    
+    
+    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
+    
+    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
+    
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+<br><br>
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+<br><br>
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+
+
+
+</footer>
+
+        </div>
+      </div>
+
+    </section>
+
+  </div>
+  
+
+  <script type="text/javascript">
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+
+  
+  
+    
+   
+
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/notebook_individual_systems.ipynb b/docs/build/html/notebook_individual_systems.ipynb
new file mode 100644
index 000000000..19c2d29fb
--- /dev/null
+++ b/docs/build/html/notebook_individual_systems.ipynb
@@ -0,0 +1,563 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "a544d28c-c2e1-4c6a-b55b-8caec440743f",
+   "metadata": {},
+   "source": [
+    "# Running individual systems with binarycpython\n",
+    "This notebook will show you how to run single systems and analyze their results.\n",
+    "\n",
+    "It can be useful to have some functions to quickly run a single system to e.g. inspect what evolutionary steps a specific system goes through, to plot the mass loss evolution of a single star, etc. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dd5d9ec7-5791-45f1-afbd-225947e2a583",
+   "metadata": {},
+   "source": [
+    "## Single system with run_wrapper\n",
+    "The simplest method to run a single system is to use the run_system wrapper. This function deals with setting up the argument string, makes sure all the required parameters are included and handles setting and cleaning up the custom logging functionality (see notebook_custom_logging).\n",
+    "\n",
+    "As arguments to this function we can add any of the parameters that binary_c itself actually knows, as well as:\n",
+    "- custom_logging_code: string containing a print statement that binary_c can use to print information\n",
+    "- log_filename: path of the logfile that binary_c generates\n",
+    "- parse_function: function that handles parsing the output of binary-c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "425efed3-d8e3-432d-829e-41d8ebe05162",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "# help(run_system) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "b2abab48-433d-4936-8434-14804c52c9f6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 1 12462\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f127a5e4-dc01-4472-9130-8a943c92e8a7",
+   "metadata": {},
+   "source": [
+    "Lets try adding a log filename now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "029fc3f2-f09a-49af-a32b-248505738f2e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "      TIME      M1       M2   K1  K2           SEP   ECC  R1/ROL1 R2/ROL2  TYPE RANDOM_SEED=67365 RANDOM_COUNT=0\n",
+      "     0.0000    1.000    0.000  1  15            -1 -1.00   0.000   0.000  \"INITIAL \"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"OFF_MS\"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 11582.2424    1.000    0.000  3  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12325.1085    0.817    0.000  4  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12457.1300    0.783    0.000  5  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"shrinkAGB\"\n",
+      " 12461.9514    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 15000.0000    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"MAX_TIME\"\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1, log_filename='/tmp/test_logfile.txt')\n",
+    "with open('/tmp/test_logfile.txt', 'r') as f:\n",
+    "    print(f.read())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "606670f2-3e0a-43c7-a885-006b92fac9d2",
+   "metadata": {},
+   "source": [
+    "To get more useful output we can include a custom_logging snippet (see notebook_custom_logging):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "e6a23b55-ca42-440d-83ac-e76a24a83a67",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 1 1 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 1 1 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython.utils.custom_logging_functions import binary_c_log_code\n",
+    "\n",
+    "# Create the print statement\n",
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"\n",
+    "\n",
+    "# Generate entire shared lib code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(custom_logging_print_statement)\n",
+    "\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code)\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4c885143-db79-4fed-b4c4-0bd846e24f7d",
+   "metadata": {},
+   "source": [
+    "Now we have some actual output, it is time to create a parse_function which parses the output. Adding a parse_function to the run_system will make run_system run the output of binary_c through the parse_function."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "3822721f-217a-495b-962e-d57137b9e290",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 1.0, 1.0, 1.0], [0.0, 1.0, 1.0, 1.0]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "def parse_function(output):\n",
+    "    \"\"\"\n",
+    "    Example function to parse the output of binary_c\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    return value_lines\n",
+    "\n",
+    "# Catch output\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code, parse_function=parse_function)\n",
+    "print(output[:3])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a551f07f-2eff-4425-9375-267579a581b3",
+   "metadata": {},
+   "source": [
+    "This output can now be turned into e.g. an Numpy array or Pandas dataframe (my favorite: makes querying the data very easy)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "654a07ed-2a88-46ff-9da0-b7759580f9f3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0        time      mass initial_mass stellar_type\n",
+      "1           0         1            1            1\n",
+      "2           0         1            1            1\n",
+      "3       1e-06         1            1            1\n",
+      "4       2e-06         1            1            1\n",
+      "5       3e-06         1            1            1\n",
+      "...       ...       ...          ...          ...\n",
+      "1612  12461.8  0.577754            1            6\n",
+      "1613    12462  0.522806            1           11\n",
+      "1614    13462  0.522806            1           11\n",
+      "1615    14462  0.522806            1           11\n",
+      "1616    15000  0.522806            1           11\n",
+      "\n",
+      "[1616 rows x 4 columns]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import pandas as pd\n",
+    "\n",
+    "# Load data into dataframe\n",
+    "example_df = pd.DataFrame(output)\n",
+    "\n",
+    "# Fix column headers\n",
+    "example_df.columns = example_df.iloc[0]\n",
+    "example_df = example_df.drop(example_df.index[0])\n",
+    "\n",
+    "print(example_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "325c2ce6-f9a1-46b7-937f-84040e1252cf",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## Single system via population object\n",
+    "When setting up your population object (see notebook_population), and configuring all the parameters, it is possible to run a single system using that same configuration. It will use the parse_function if set, and running a single system is a good method to test if everything works accordingly."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "4a98ffca-1b72-4bb8-8df1-3bf3187d882f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.grid import Population\n",
+    "# help(Population) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7e2c2ef0-3db2-46a6-8c85-9b6cf720eb6a",
+   "metadata": {},
+   "source": [
+    "First, let's try this without any custom logging or parsing functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "bff1cc2e-6b32-4ba0-879f-879ffbabd223",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Create the population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# Set some parameters\n",
+    "example_pop.set(\n",
+    "    verbosity=1\n",
+    ")\n",
+    "example_pop.set(\n",
+    "    M_1=10\n",
+    ")\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ae01fa35-f8b1-4a40-bfb2-b9e872cae0e7",
+   "metadata": {},
+   "source": [
+    "Now lets add some actual output with the custom logging"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "dd748bab-b57e-4129-8350-9ea11fa179d0",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\n\",\n",
+      "    // \n",
+      "    stardata->model.time, // 1\n",
+      "    stardata->star[0].mass, //2\n",
+      "    stardata->previous_stardata->star[0].mass, //3\n",
+      "    stardata->common.zero_age.mass[0], //4\n",
+      "\n",
+      "    stardata->star[0].stellar_type //5\n",
+      ");\n",
+      " to grid_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294.so\n",
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 10 0 10 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 10 10 10 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 10 10 10 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 10 10 10 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"   \n",
+    "\n",
+    "example_pop.set(C_logging_code=custom_logging_print_statement)\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "588a7d9e-9d64-4b3b-8907-656b905286e8",
+   "metadata": {},
+   "source": [
+    "Lastly we can add a parse_function to handle parsing the output again. \n",
+    "\n",
+    "Because the parse_function will now be part of the population object, it can access information of the object. We need to make a new parse function that is fit for an object: we the arguments now need to be (self, output). Returning the data is useful when running evolve_single(), but won't be used in a population evolution."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "fec39154-cce6-438c-8c2c-509d76b00f34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "import numpy as np\n",
+    "\n",
+    "def object_parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function that can be added to the population object\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # We can access object instance information now. \n",
+    "    # In this way we can store the results in a file for example. \n",
+    "    output_file = os.path.join(self.custom_options['output_dir'], 'example_output.json')\n",
+    "    \n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    # Turn into an array\n",
+    "    values_array = np.array(value_lines[1:])\n",
+    "    \n",
+    "    # make dict and fill\n",
+    "    output_dict = {}\n",
+    "    for i in range(len(column_names)):\n",
+    "        output_dict[column_names[i]] = list(values_array[:,i])\n",
+    "\n",
+    "    # Write to file\n",
+    "    with open(output_file, 'w') as f:\n",
+    "        f.write(json.dumps(output_dict, indent=4))\n",
+    "        \n",
+    "    # Return something anyway\n",
+    "    return value_lines"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "57347512-fd4a-434b-b13c-5e6dbd3ac415",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: parse_function=<function object_parse_function at 0x7f9265091598> to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: output_dir=/tmp/ to custom_options >>>>\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_e9c2bec7f15541eb847fc6013e48e7ed.so\n",
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 10.0, 0.0, 10.0, 1.0], [0.0, 10.0, 10.0, 10.0, 1.0], [1e-06, 10.0, 10.0, 10.0, 1.0]]\n",
+      "dict_keys(['time', 'mass', 'initial_mass', 'stellar_type'])\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(\n",
+    "    parse_function=object_parse_function,\n",
+    "    output_dir='/tmp/'\n",
+    ")\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output[:4])\n",
+    "\n",
+    "# Example of loading the data that was written\n",
+    "with open(os.path.join(example_pop.custom_options['output_dir'], 'example_output.json')) as f:\n",
+    "    written_data = json.loads(f.read())\n",
+    "\n",
+    "print(written_data.keys())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ddc06da3-fc68-4c6f-8067-14ea862b964d",
+   "metadata": {},
+   "source": [
+    "## Single system via API functionality\n",
+    "It is possible to construct your own functionality to run a single system by directly calling the API function to run a system. Under the hood all the other functions and wrappers actually use this API.\n",
+    "\n",
+    "There are less failsafes for this method, so this make sure the input is correct and binary_c knows all the arguments you pass in.\n",
+    "\n",
+    "for more details on this API function see `notebook_api_functions`"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "56886792-d379-4eac-b0d4-54508edb39c7",
+   "metadata": {},
+   "source": [
+    "First we must construct the argument string that we pass to binary_c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "ec48125c-6bf5-48f4-9357-8261800b5d8b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 15 14.2383\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For a binary system we need to pass in these arguments\n",
+    "M_1 = 15.0  # Msun\n",
+    "M_2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000  # Myr. You need to include this argument.\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} M_2 {M_2} separation {separation} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=M_1,\n",
+    "    M_2=M_2,\n",
+    "    separation=separation,\n",
+    "    orbital_period=orbital_period,\n",
+    "    eccentricity=eccentricity,\n",
+    "    metallicity=metallicity,\n",
+    "    max_evolution_time=max_evolution_time,\n",
+    ").strip()\n",
+    "\n",
+    "from binarycpython import _binary_c_bindings\n",
+    "\n",
+    "output = _binary_c_bindings.run_system(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "55c8ea24-0fc0-452c-8121-1e7667433479",
+   "metadata": {},
+   "source": [
+    "As we can see above, the output is rather empty. But if SINGLE_STAR_LIFETIME is printed we know we caught the output correctly. To get actual output we should have timesteps printed in the `log_every_timestep.c` in binary_c, or add some custom_logging (see notebook_custom_logging). "
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/build/html/notebook_population.html b/docs/build/html/notebook_population.html
index ff600f916..20d542b90 100644
--- a/docs/build/html/notebook_population.html
+++ b/docs/build/html/notebook_population.html
@@ -7,7 +7,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Title page &mdash; binary_c-python  documentation</title>
+  <title>Running populations with binarycpython &mdash; binary_c-python  documentation</title>
   
 
   
@@ -39,8 +39,8 @@
     
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Binary_c parameters" href="binary_c_parameters.html" />
-    <link rel="prev" title="Notebooks" href="notebooks.html" /> 
+    <link rel="next" title="Extra features and functionality of binarycpython" href="notebook_extra_features.html" />
+    <link rel="prev" title="Notebook custom logging" href="notebook_custom_logging.html" /> 
 </head>
 
 <body class="wy-body-for-nav">
@@ -89,13 +89,20 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="general_examples.html">Examples</a></li>
-<li class="toctree-l2"><a class="reference internal" href="population_example.html">Example of population script</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="notebooks.html">Notebooks</a><ul class="current">
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Title page</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="example_notebooks.html">Example notebooks</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="notebook_individual_systems.html">Running individual systems with binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_custom_logging.html">Notebook custom logging</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Running populations with binarycpython</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Setting-up-the-Population-object">Setting up the Population object</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Adding-grid-variables">Adding grid variables</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Setting-logging-and-handling-the-output">Setting logging and handling the output</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Evolving-the-grid">Evolving the grid</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Noteworthy-functionality">Noteworthy functionality</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Full-examples-of-population-scripts">Full examples of population scripts</a></li>
 </ul>
 </li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_extra_features.html">Extra features and functionality of binarycpython</a></li>
+<li class="toctree-l2"><a class="reference internal" href="notebook_api_functionality.html">Using the API functionality of binarycpython</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
@@ -148,11 +155,9 @@
     
       <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
         
-          <li><a href="examples.html">Examples</a> &raquo;</li>
+          <li><a href="example_notebooks.html">Example notebooks</a> &raquo;</li>
         
-          <li><a href="notebooks.html">Notebooks</a> &raquo;</li>
-        
-      <li>Title page</li>
+      <li>Running populations with binarycpython</li>
     
     
       <li class="wy-breadcrumbs-aside">
@@ -441,41 +446,47 @@ div.rendered_html tbody tr:hover {
     text-align: unset;
 }
 </style>
-<div class="section" id="Title-page">
-<h1>Title page<a class="headerlink" href="#Title-page" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="Running-populations-with-binarycpython">
+<h1>Running populations with binarycpython<a class="headerlink" href="#Running-populations-with-binarycpython" title="Permalink to this headline">¶</a></h1>
+<p>This notebook will show you how to evolve a population of stars</p>
+<p>Much of the code in the binarycpython package is written to evolve a population of stars through the Population object, rather than running a single system. Let’s go through the functionality of this object step by step and set up some example populations.</p>
+<p>At the bottom of this notebook there are some complete example scripts</p>
 <div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
 <span></span><span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.functions</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">get_help_all</span><span class="p">,</span>
-    <span class="n">get_help</span><span class="p">,</span>
-    <span class="n">create_hdf5</span><span class="p">,</span>
-    <span class="n">output_lines</span><span class="p">,</span>
-<span class="p">)</span>
 <span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">temp_dir</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
 
+<span class="c1"># help(Population) # Uncomment to see the public functions of this object</span>
 </pre></div>
 </div>
 </div>
-<div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+<ul class="simple">
+<li><p>running ensemble</p></li>
+<li><p>using M&amp;S grid</p></li>
+</ul>
+<div class="section" id="Setting-up-the-Population-object">
+<h2>Setting up the Population object<a class="headerlink" href="#Setting-up-the-Population-object" title="Permalink to this headline">¶</a></h2>
+<p>To set up and configure the population object we need to make an object instance of the <code class="docutils literal notranslate"><span class="pre">Population</span></code> object, and add configuration via the <code class="docutils literal notranslate"><span class="pre">.set()</span></code> function.</p>
+<p>There are three categories of options that the Population object can set: - BSE options: these options will be used for the binary_c calls, and are recognized by comparing the arguments to a known list of available arguments of binary_c. To see which options are available, see section <code class="docutils literal notranslate"><span class="pre">`binary_c</span> <span class="pre">parameters</span></code> in the documentation &lt;<a class="reference external" href="https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html">https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html</a>&gt;`__. You can access these through <code class="docutils literal notranslate"><span class="pre">population.bse_options['&lt;bse</span> <span class="pre">option</span> <span class="pre">name&gt;']</span></code> after
+you have set them.</p>
+<ul class="simple">
+<li><p>Grid options: these options will be used to configure the behaviour of the Population object. To see which options are available, see section <code class="docutils literal notranslate"><span class="pre">`Population</span> <span class="pre">grid</span> <span class="pre">code</span> <span class="pre">options</span></code> in the documentation &lt;<a class="reference external" href="https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html">https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html</a>&gt;`__. They can be accessed via <code class="docutils literal notranslate"><span class="pre">population.grid_options['&lt;grid</span> <span class="pre">option</span> <span class="pre">name&gt;']</span></code> after you have set them.</p></li>
+<li><p>Custom options: these options are not recognized as either of the above, so they will be stored in the custom_options, and can be accessed via <code class="docutils literal notranslate"><span class="pre">population.custom_options['&lt;custom</span> <span class="pre">option</span> <span class="pre">name&gt;']</span></code></p></li>
+</ul>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="c1">#########################################################</span>
-<span class="c1"># This file serves as an example for running a population.</span>
-<span class="c1"># The use of help(&lt;function&gt;) is a good way to inspect what parameters are there to use</span>
-<span class="c1">#########################################################</span>
-
-<span class="c1"># Create population object</span>
+<span></span><span class="c1"># Create population object</span>
 <span class="n">example_pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
 
 <span class="c1"># If you want verbosity, set this before other things</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbose</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbosity</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
 
 <span class="c1"># Setting values can be done via .set(&lt;parameter_name&gt;=&lt;value&gt;)</span>
 <span class="c1"># Values that are known to be binary_c_parameters are loaded into bse_options.</span>
@@ -484,110 +495,186 @@ div.rendered_html tbody tr:hover {
 <span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
     <span class="c1"># binary_c physics options</span>
     <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>  <span class="c1"># bse_options</span>
     <span class="n">orbital_period</span><span class="o">=</span><span class="mi">45000000080</span><span class="p">,</span>  <span class="c1"># bse_options</span>
     <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>  <span class="c1"># bse_options</span>
     <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="c1"># Set companion to low mass</span>
-    <span class="n">M_2</span><span class="o">=</span><span class="mf">0.08</span><span class="p">,</span>  <span class="c1"># Since in the example we run a single system, we should set the companion mass here. If we donm&#39;t do this, the code will complain.</span>
+
+
     <span class="c1"># grid_options</span>
     <span class="n">amt_cores</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>  <span class="c1"># grid_options</span>
-    <span class="n">verbose</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>  <span class="c1"># verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff</span>
+
     <span class="c1"># Custom options # TODO: need to be set in grid_options probably</span>
     <span class="n">data_dir</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
         <span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span>
     <span class="p">),</span>  <span class="c1"># custom_options</span>
     <span class="n">base_filename</span><span class="o">=</span><span class="s2">&quot;example_pop.dat&quot;</span><span class="p">,</span>  <span class="c1"># custom_options</span>
 <span class="p">)</span>
+
+<span class="c1"># We can use the options through</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">grid_options</span><span class="p">[</span><span class="s1">&#39;verbosity&#39;</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s1">&#39;base_filename&#39;</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">bse_options</span><span class="p">[</span><span class="s1">&#39;M_1&#39;</span><span class="p">])</span>
 </pre></div>
 </div>
 </div>
-<div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+adding: M_1=10 to BSE_options
+adding: orbital_period=45000000080 to BSE_options
+adding: max_evolution_time=15000 to BSE_options
+adding: eccentricity=0.02 to BSE_options
+adding: amt_cores=2 to grid_options
+&lt;&lt;&lt;&lt; Warning: Key does not match previously known parameter:                     adding: data_dir=/tmp/binary_c_python/example_python_population_result to custom_options &gt;&gt;&gt;&gt;
+&lt;&lt;&lt;&lt; Warning: Key does not match previously known parameter:                     adding: base_filename=example_pop.dat to custom_options &gt;&gt;&gt;&gt;
+1
+example_pop.dat
+10
+</pre></div></div>
+</div>
+<p>After configuring the population, but before running the actual population, its usually a good idea to export the full configuration (including version info of binary_c and all the parameters) to a file. To do this we use <code class="docutils literal notranslate"><span class="pre">example_pop.export_all_info()</span></code>.</p>
+<p>On default this exports everything, each of the sections can be disabled: - population settings (bse_options, grid_options, custom_options), turn off with include_population settings=False - binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults). turn off with include_binary_c_defaults=False - include_binary_c_version_info (all the compilation info, and information about the compiled parameters), turn off with
+include_binary_c_version_info=False - include_binary_c_help_all (all the help information for all the binary_c parameters), turn off with include_binary_c_help_all=Fase</p>
+<p>On default it will write this to the custom_options[‘data_dir’], but that can be overriden by setting use_datadir=False and providing an outfile=&lt;&gt;</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
-    <span class="c1"># EXAMPLE PARSE_FUNCTION</span>
-
-    <span class="c1"># extract info from the population instance</span>
-
-    <span class="c1"># Get some information from the</span>
-    <span class="n">data_dir</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">]</span>
-    <span class="n">base_filename</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;base_filename&quot;</span><span class="p">]</span>
-
-    <span class="c1"># Check directory, make if necessary</span>
-    <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-    <span class="n">seperator</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span>
-
-    <span class="c1"># Create filename</span>
-    <span class="n">outfilename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">base_filename</span><span class="p">)</span>
-
-    <span class="n">parameters</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;mass&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass&quot;</span><span class="p">,</span> <span class="s2">&quot;probability&quot;</span><span class="p">,</span> <span class="s2">&quot;radius&quot;</span><span class="p">,</span> <span class="s2">&quot;stellar_type&quot;</span><span class="p">]</span>
-
-    <span class="c1"># Go over the output.</span>
-    <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">output_lines</span><span class="p">(</span><span class="n">output</span><span class="p">):</span>
-        <span class="n">headerline</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
-
-        <span class="c1"># CHeck the header and act accordingly</span>
-        <span class="k">if</span> <span class="n">headerline</span> <span class="o">==</span> <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span>
-            <span class="n">values</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">1</span><span class="p">:]</span>
-            <span class="nb">print</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-
-            <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">):</span>
-                <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Amount of column names isnt equal to amount of columns&quot;</span><span class="p">)</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span>
-
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">outfilename</span><span class="p">):</span>
-                <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-                    <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-
-            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">values</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-
-
-
-<span class="c1"># Creating a parsing function</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
-    <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">,</span>  <span class="c1"># Setting the parse function thats used in the evolve_population</span>
-<span class="p">)</span>
+<span></span><span class="n">example_pop</span><span class="o">.</span><span class="n">export_all_info</span><span class="p">()</span>
 </pre></div>
 </div>
 </div>
-<div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Writing settings to /tmp/binary_c_python/example_python_population_result/example_pop_settings.json
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+&#39;/tmp/binary_c_python/example_python_population_result/example_pop_settings.json&#39;
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Adding-grid-variables">
+<h2>Adding grid variables<a class="headerlink" href="#Adding-grid-variables" title="Permalink to this headline">¶</a></h2>
+<p>The main purpose of the Population object is to handle the population synthesis side of running a set of stars. The main method to do this with binarycpython, as is the case with Perl binarygrid, is to use grid variables. These are loops over a predefined range of values, where a probability will be assigned to the systems based on the chosen probability distributions.</p>
+<p>Usually we use either 1 mass grid variable, or a trio of mass, mass ratio and period (See below for full examples of all of these). We can, however, also add grid sampling for e.g. eccentricity, metallicity or other parameters.</p>
+<p>In some cases it could be easier to set up a for loop that sets that parameter and calls the evolve function several times, e.g. when you want to vary a prescription (usually a discrete, unweighted parameter)</p>
+<p>A notable special type of grid variable is that of the Moe &amp; di Stefano 2017 dataset (see further down in the notebook).</p>
+<p>To add a grid variable to the population object we use <code class="docutils literal notranslate"><span class="pre">example_pop.add_grid_variable</span></code> (see next cell)</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="c1">### Custom logging</span>
-<span class="c1"># Log the moment when the star turns into neutron</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
-    <span class="n">C_logging_code</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;</span>
-<span class="s2">if(stardata-&gt;star[0].stellar_type &gt;= 13)</span>
-<span class="s2">{</span>
-<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
-<span class="s2">    {</span>
-<span class="s2">        Printf(&quot;MY_STELLAR_DATA </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
-<span class="s2">            //</span>
-<span class="s2">            stardata-&gt;model.time, // 1</span>
-<span class="s2">            stardata-&gt;star[0].mass, // 2</span>
-<span class="s2">            stardata-&gt;common.zero_age.mass[0], // 4</span>
-<span class="s2">            stardata-&gt;model.probability, // 5</span>
-<span class="s2">            stardata-&gt;star[0].radius, // 6</span>
-<span class="s2">            stardata-&gt;star[0].stellar_type // 7</span>
-<span class="s2">      );</span>
-<span class="s2">    };</span>
-<span class="s2">    /* Kill the simulation to save time */</span>
-<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
-<span class="s2">};</span>
-<span class="s2">&quot;&quot;&quot;</span>
-<span class="p">)</span>
+<span></span><span class="n">help</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Help on method add_grid_variable in module binarycpython.utils.grid:
+
+add_grid_variable(name:str, longname:str, valuerange:Union[list, str], resolution:str, spacingfunc:str, probdist:str, dphasevol:Union[str, int], parameter_name:str, gridtype:str=&#39;edge&#39;, branchpoint:int=0, precode:Union[str, NoneType]=None, condition:Union[str, NoneType]=None) -&gt; None method of binarycpython.utils.grid.Population instance
+    Function to add grid variables to the grid_options.
+
+    The execution of the grid generation will be through a nested for loop.
+    Each of the grid variables will get create a deeper for loop.
+
+    The real function that generates the numbers will get written to a new file in the TMP_DIR,
+    and then loaded imported and evaluated.
+    beware that if you insert some destructive piece of code, it will be executed anyway.
+    Use at own risk.
+
+    Tasks:
+        - TODO: Fix this complex function.
+
+    Args:
+        name:
+            name of parameter. This is evaluated as a parameter and you can use it throughout
+            the rest of the function
+
+            Examples:
+                name = &#39;lnm1&#39;
+        longname:
+            Long name of parameter
+
+            Examples:
+                longname = &#39;Primary mass&#39;
+        range:
+            Range of values to take. Does not get used really, the spacingfunction is used to
+            get the values from
+
+            Examples:
+                range = [math.log(m_min), math.log(m_max)]
+        resolution:
+            Resolution of the sampled range (amount of samples).
+            TODO: check if this is used anywhere
+
+            Examples:
+                resolution = resolution[&#34;M_1&#34;]
+        spacingfunction:
+            Function determining how the range is sampled. You can either use a real function,
+            or a string representation of a function call. Will get written to a file and
+            then evaluated.
+
+            Examples:
+                spacingfunction = &#34;const(math.log(m_min), math.log(m_max), {})&#34;.format(resolution[&#39;M_1&#39;])
+
+        precode:
+            Extra room for some code. This code will be evaluated within the loop of the
+            sampling function (i.e. a value for lnm1 is chosen already)
+
+            Examples:
+                precode = &#39;M_1=math.exp(lnm1);&#39;
+        probdist:
+            Function determining the probability that gets assigned to the sampled parameter
+
+            Examples:
+                probdist = &#39;Kroupa2001(M_1)*M_1&#39;
+        dphasevol:
+            part of the parameter space that the total probability is calculated with. Put to -1
+            if you want to ignore any dphasevol calculations and set the value to 1
+            Examples:
+                dphasevol = &#39;dlnm1&#39;
+        condition:
+            condition that has to be met in order for the grid generation to continue
+            Examples:
+                condition = &#39;self.grid_options[&#39;binary&#39;]==1&#39;
+        gridtype:
+            Method on how the value range is sampled. Can be either &#39;edge&#39; (steps starting at
+            the lower edge of the value range) or &#39;center&#39;
+            (steps starting at lower edge + 0.5 * stepsize).
+
+</pre></div></div>
+</div>
+<p>All the distribution functions that we can use are stored in the <code class="docutils literal notranslate"><span class="pre">binarycpython.utils.distribution_functions</span></code> or <code class="docutils literal notranslate"><span class="pre">binarycpython/utils/distribution_functions.py</span></code> on git. If you uncomment the help statement below you can see which functions are available now:</p>
 <div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="c1"># import binarycpython.utils.distribution_functions</span>
+<span class="c1"># help(binarycpython.utils.distribution_functions)</span>
+</pre></div>
+</div>
+</div>
+<p>The next cell contains an example of adding the mass grid variable, but sampling in log mass. The commented grid variables are examples of the mass ratio sampling and the period sampling.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
@@ -641,34 +728,142 @@ div.rendered_html tbody tr:hover {
 </pre></div>
 </div>
 </div>
-<p>Exporting of all the settings can be done with .export_all_info() on default it exports everything, but can be supressed by turning it off: population settings (bse_options, grid_options, custom_options), turn off with include_population settings=False binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults). turn off with include_binary_c_defaults=False include_binary_c_version_info (all the compilation info, and information about the compiled
-parameters), turn off with include_binary_c_version_info=False include_binary_c_help_all (all the help information for all the binary_c parameters), turn off with include_binary_c_help_all=Fase On default it will write this to the custom_options[‘data_dir’], but that can be overriden by setting use_datadir=False and providing an outfile=&lt;&gt;</p>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Added grid variable: {
+    &#34;name&#34;: &#34;lnm1&#34;,
+    &#34;longname&#34;: &#34;Primary mass&#34;,
+    &#34;valuerange&#34;: [
+        2,
+        150
+    ],
+    &#34;resolution&#34;: &#34;20&#34;,
+    &#34;spacingfunc&#34;: &#34;const(math.log(2), math.log(150), 20)&#34;,
+    &#34;precode&#34;: &#34;M_1=math.exp(lnm1)&#34;,
+    &#34;probdist&#34;: &#34;three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1&#34;,
+    &#34;dphasevol&#34;: &#34;dlnm1&#34;,
+    &#34;parameter_name&#34;: &#34;M_1&#34;,
+    &#34;condition&#34;: &#34;&#34;,
+    &#34;gridtype&#34;: &#34;edge&#34;,
+    &#34;branchpoint&#34;: 0,
+    &#34;grid_variable_number&#34;: 0
+}
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Setting-logging-and-handling-the-output">
+<h2>Setting logging and handling the output<a class="headerlink" href="#Setting-logging-and-handling-the-output" title="Permalink to this headline">¶</a></h2>
+<p>On default, binary_c will not output anything (except for ‘SINGLE STAR LIFETIME’). It is up to us to determine what will be printed. We can either do that by hardcoding the print statements into <code class="docutils literal notranslate"><span class="pre">binary_c</span></code> (see documentation binary_c). Or, we can use the custom logging functionality of binarycpython (see notebook <code class="docutils literal notranslate"><span class="pre">notebook_custom_logging.ipynb</span></code>), which is faster to set up and requires no recompilation of binary_c, but is somewhat more limited in its functionality.</p>
+<p>After configuring what will be printed, we need to make a function to parse the output. This can be done by setting the parse_function parameter in the population object (see also notebook <code class="docutils literal notranslate"><span class="pre">notebook_individual_systems.ipynb</span></code>).</p>
+<p>In the code below we will set up both the custom logging, and a parse function to handle that output</p>
 <div class="nbinput docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="n">example_pop</span><span class="o">.</span><span class="n">export_all_info</span><span class="p">()</span>
+<span></span><span class="c1"># Create custom logging statement: in this case we will log when the star turns into a compact object, and then terminate the evolution.</span>
+<span class="n">custom_logging_statement</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">if(stardata-&gt;star[0].stellar_type &gt;= 13)</span>
+<span class="s2">{</span>
+<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
+<span class="s2">    {</span>
+<span class="s2">        Printf(&quot;EXAMPLE_COMPACT_OBJECT </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">            //</span>
+<span class="s2">            stardata-&gt;model.time, // 1</span>
+<span class="s2">            stardata-&gt;star[0].mass, // 2</span>
+<span class="s2">            stardata-&gt;common.zero_age.mass[0], // 3</span>
+<span class="s2">            stardata-&gt;model.probability, // 4</span>
+<span class="s2">            stardata-&gt;star[0].stellar_type // 5</span>
+<span class="s2">      );</span>
+<span class="s2">    };</span>
+<span class="s2">    /* Kill the simulation to save time */</span>
+<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
+<span class="s2">};</span>
+<span class="s2">&quot;&quot;&quot;</span>
+
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">C_logging_code</span><span class="o">=</span><span class="n">custom_logging_statement</span>
+<span class="p">)</span>
 </pre></div>
 </div>
 </div>
 <div class="nboutput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
-</pre></div>
+<div class="prompt empty docutils container">
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&#39;/tmp/binary_c_python/example_python_population_result/example_pop_settings.json&#39;
+adding: C_logging_code=
+if(stardata-&gt;star[0].stellar_type &gt;= 13)
+{
+    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)
+    {
+        Printf(&#34;EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\n&#34;,
+            //
+            stardata-&gt;model.time, // 1
+            stardata-&gt;star[0].mass, // 2
+            stardata-&gt;common.zero_age.mass[0], // 3
+            stardata-&gt;model.probability, // 4
+            stardata-&gt;star[0].stellar_type // 5
+      );
+    };
+    /* Kill the simulation to save time */
+    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;
+};
+ to grid_options
 </pre></div></div>
 </div>
-<p>Executing a single system This uses the M_1 orbital period etc set with the set function</p>
+<p>The parse function must now catch lines that start with “EXAMPLE_COMPACT_OBJECT”, and write that line to a file</p>
 <div class="nbinput docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="n">output</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">evolve_single</span><span class="p">()</span>
-<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+<span></span><span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Example parse function</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># get info from the population instance</span>
+    <span class="n">data_dir</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">]</span>
+    <span class="n">base_filename</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;base_filename&quot;</span><span class="p">]</span>
+
+    <span class="c1"># Check directory, make if necessary</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+
+    <span class="n">seperator</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span>
+
+    <span class="c1"># Create filename</span>
+    <span class="n">outfilename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">base_filename</span><span class="p">)</span>
+
+    <span class="n">parameters</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;mass&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass&quot;</span><span class="p">,</span> <span class="s2">&quot;probability&quot;</span><span class="p">,</span> <span class="s2">&quot;stellar_type&quot;</span><span class="p">]</span>
+
+    <span class="c1"># Go over the output.</span>
+    <span class="k">for</span> <span class="n">line</span> <span class="ow">in</span> <span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">():</span>
+        <span class="n">headerline</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
+
+        <span class="c1"># CHeck the header and act accordingly</span>
+        <span class="k">if</span> <span class="n">headerline</span> <span class="o">==</span> <span class="s2">&quot;EXAMPLE_COMPACT_OBJECT&quot;</span><span class="p">:</span>
+            <span class="n">values</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">1</span><span class="p">:]</span>
+            <span class="nb">print</span><span class="p">(</span><span class="n">line</span><span class="p">)</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">):</span>
+                <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Amount of column names isnt equal to amount of columns&quot;</span><span class="p">)</span>
+                <span class="k">raise</span> <span class="ne">ValueError</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">outfilename</span><span class="p">):</span>
+                <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                    <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">values</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="c1"># Add the parsing function</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">,</span>
+<span class="p">)</span>
 </pre></div>
 </div>
 </div>
@@ -677,30 +872,134 @@ parameters), turn off with include_binary_c_version_info=False include_binary_c_
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Creating the code for the shared library for the custom logging
-[&#39;2.773586668293e+01&#39;, &#39;1.33526&#39;, &#39;10&#39;, &#39;1&#39;, &#39;1.72498e-05&#39;, &#39;13&#39;]
-None
+adding: parse_function=&lt;function parse_function at 0x7ff3bdf79620&gt; to grid_options
 </pre></div></div>
 </div>
-<div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</div>
+<div class="section" id="Evolving-the-grid">
+<h2>Evolving the grid<a class="headerlink" href="#Evolving-the-grid" title="Permalink to this headline">¶</a></h2>
+<p>Now that we configured all the main parts of the population object, we can actually run the population! Doing this is straightforward: <code class="docutils literal notranslate"><span class="pre">example_pop.evolve()</span></code></p>
+<p>This will start up the processing of all the systems. We can control how many cores are used by settings <code class="docutils literal notranslate"><span class="pre">amt_cores</span></code>. By setting the <code class="docutils literal notranslate"><span class="pre">verbosity</span></code> of the population object to a higher value we can get a lot of verbose information about the run, but for now we will set it to 0.</p>
+<p>There are many grid_options that can lead to different behaviour of the evolution of the grid. Please do have a look at those: <a class="reference external" href="https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html">grid options docs</a>, and try</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="c1">## Executing a population</span>
+<span></span><span class="c1"># change verbosity</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbosity</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1">## Executing a population</span>
 <span class="c1">## This uses the values generated by the grid_variables</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">evolve</span><span class="p">()</span>  <span class="c1"># TODO: update this function call</span>
+<span class="n">analytics</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">evolve</span><span class="p">()</span>  <span class="c1"># TODO: update this function call</span>
 </pre></div>
 </div>
 </div>
-<p>Wrapping up the results to an hdf5 file can be done by using the create_hdf5 () This function takes the settings file (ending in _settings.json) and the data files (ending in .dat) from the data_dir and packing them into an hdf5 file, which is then written into the same data_dir directory</p>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+adding: verbosity=0 to grid_options
+Generating grid code
+Constructing/adding: lnm1
+Grid has handled 20 stars
+with a total probability of 0.05150046619238192
+Total starcount for this run will be: 20
+EXAMPLE_COMPACT_OBJECT             2.867655467480e+01 1.33079 9.81391 0.00167028 13
+Generating grid code
+Constructing/adding: lnm1
+EXAMPLE_COMPACT_OBJECT             1.931266944719e+01 1.3933 12.3177 0.00124307 13
+EXAMPLE_COMPACT_OBJECT             4.439623364590e+01 1.38004 7.81906 0.00224431 13
+EXAMPLE_COMPACT_OBJECT             1.364277535630e+01 1.47961 15.4603 0.000925128 13
+EXAMPLE_COMPACT_OBJECT             1.017435498578e+01 1.59052 19.4046 0.000688507 13
+EXAMPLE_COMPACT_OBJECT             8.294870923827e+00 1.7197 24.3552 0.000512406 13
+EXAMPLE_COMPACT_OBJECT             6.802132608769e+00 1.84162 30.5689 0.000381347 13
+EXAMPLE_COMPACT_OBJECT             5.723570798020e+00 1.99471 38.3678 0.00028381 13
+EXAMPLE_COMPACT_OBJECT             4.933751523833e+00 2.15875 48.1564 0.000211219 13
+EXAMPLE_COMPACT_OBJECT             4.337250536639e+00 2.35209 60.4424 0.000157195 14
+EXAMPLE_COMPACT_OBJECT             3.862081089332e+00 2.56776 75.8628 0.000116989 14
+EXAMPLE_COMPACT_OBJECT             3.449960890183e+00 2.80457 95.2174 8.70668e-05 14
+EXAMPLE_COMPACT_OBJECT             3.172196856333e+00 3.05193 119.51 6.47976e-05 14
+EXAMPLE_COMPACT_OBJECT             3.069627290216e+00 3.27563 150 4.82242e-05 14
+Population-2a7732d03e594ef4b5dfe9051b41d9c0 finished! The total probability was: 0.05150046619238191. It took a total of 0.7797017097473145s to run 20 systems on 2 cores
+There were no errors found in this run.
+</pre></div></div>
+</div>
+<p>After the run is complete, some technical report on the run is returned. I stored that in <code class="docutils literal notranslate"><span class="pre">analytics</span></code>. As we can see below, this dictionary is like a status report of the evolution. Useful for e.g. debugging.</p>
 <div class="nbinput docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="nb">print</span><span class="p">(</span><span class="n">analytics</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{&#39;population_name&#39;: &#39;2a7732d03e594ef4b5dfe9051b41d9c0&#39;, &#39;evolution_type&#39;: &#39;grid&#39;, &#39;failed_count&#39;: 0, &#39;failed_prob&#39;: 0, &#39;failed_systems_error_codes&#39;: [], &#39;errors_exceeded&#39;: False, &#39;errors_found&#39;: False, &#39;total_probability&#39;: 0.05150046619238191, &#39;total_count&#39;: 20, &#39;start_timestamp&#39;: 1628444120.234709, &#39;end_timestamp&#39;: 1628444121.0144107, &#39;total_mass_run&#39;: 730.1048014407228, &#39;total_probability_weighted_mass_run&#39;: 0.2983275843337705, &#39;zero_prob_stars_skipped&#39;: 0}
+</pre></div></div>
+</div>
+</div>
+<div class="section" id="Noteworthy-functionality">
+<h2>Noteworthy functionality<a class="headerlink" href="#Noteworthy-functionality" title="Permalink to this headline">¶</a></h2>
+<p>Some extra features that are available from via the population object are: - write_binary_c_calls_to_file: Function to write the calls that would be passed to binary_c to a file</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="n">help</span><span class="p">(</span><span class="n">example_pop</span><span class="o">.</span><span class="n">write_binary_c_calls_to_file</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Help on method write_binary_c_calls_to_file in module binarycpython.utils.grid:
+
+write_binary_c_calls_to_file(output_dir:Union[str, NoneType]=None, output_filename:Union[str, NoneType]=None, include_defaults:bool=False) -&gt; None method of binarycpython.utils.grid.Population instance
+    Function that loops over the grid code and writes the generated parameters to a file.
+    In the form of a command line call
+
+    Only useful when you have a variable grid as system_generator. MC wouldn&#39;t be that useful
+
+    Also, make sure that in this export there are the basic parameters
+    like m1,m2,sep, orb-per, ecc, probability etc.
+
+    On default this will write to the datadir, if it exists
+
+    Tasks:
+        - TODO: test this function
+        - TODO: make sure the binary_c_python .. output file has a unique name
+
+    Args:
+        output_dir: (optional, default = None) directory where to write the file to. If custom_options[&#39;data_dir&#39;] is present, then that one will be used first, and then the output_dir
+        output_filename: (optional, default = None) filename of the output. If not set it will be called &#34;binary_c_calls.txt&#34;
+        include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.
+
+    Returns:
+        filename: filename that was used to write the calls to
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span><span class="n">create_hdf5</span><span class="p">(</span><span class="n">data_dir</span><span class="o">=</span><span class="n">example_pop</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">],</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;example_pop.hdf5&quot;</span><span class="p">)</span>
+<span></span><span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbosity</span><span class="o">=</span><span class="mi">10</span><span class="p">)</span>
+<span class="n">calls_filename</span> <span class="o">=</span> <span class="n">example_pop</span><span class="o">.</span><span class="n">write_binary_c_calls_to_file</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">calls_filename</span><span class="p">)</span>
 
+<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">calls_filename</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="o">.</span><span class="n">splitlines</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]))</span>
 </pre></div>
 </div>
 </div>
@@ -709,20 +1008,508 @@ None
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Creating /tmp/binary_c_python/example_python_population_result/example_pop.hdf5
-Adding settings to HDF5 file
-Adding data to HDF5 file
+Generating grid code
+Generating grid code
+Constructing/adding: lnm1
+Saving grid code to grid_options
+Writing grid code to /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py
+Loading grid code function from /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py
+Grid code loaded
+Writing binary_c calls to /tmp/binary_c_python/example_python_population_result/binary_c_calls.txt
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.
+Grid has handled 20 stars
+with a total probability of 0.05150046619238192
+/tmp/binary_c_python/example_python_population_result/binary_c_calls.txt
+binary_c M_1 2.0 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.013208238029791246
+binary_c M_1 2.5102526289471614 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.009829948023831718
+binary_c M_1 3.1506841305680684 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.0073157281034221516
+binary_c M_1 3.9545065608702976 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.005444573822104362
 </pre></div></div>
 </div>
-<div class="nbinput nblast docutils container">
-<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</div>
+<div class="section" id="Full-examples-of-population-scripts">
+<h2>Full examples of population scripts<a class="headerlink" href="#Full-examples-of-population-scripts" title="Permalink to this headline">¶</a></h2>
+<p>Below is a full setup for a population of single stars</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[13]:
 </pre></div>
 </div>
 <div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
-<span></span>
+<span></span><span class="kn">import</span> <span class="nn">os</span>
+
+<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">temp_dir</span>
+
+<span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Example parsing function</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># extract info from the population instance</span>
+
+    <span class="c1"># Get some information from the</span>
+    <span class="n">data_dir</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">]</span>
+    <span class="n">base_filename</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;base_filename&quot;</span><span class="p">]</span>
+
+    <span class="c1"># Check directory, make if necessary</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+
+    <span class="c1">#</span>
+    <span class="n">seperator</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span>
+
+    <span class="c1"># Create filename</span>
+    <span class="n">outfilename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">base_filename</span><span class="p">)</span>
+
+    <span class="c1"># The header columns matching this</span>
+    <span class="n">parameters</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;mass&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass&quot;</span><span class="p">,</span> <span class="s2">&quot;probability&quot;</span><span class="p">,</span> <span class="s2">&quot;radius&quot;</span><span class="p">,</span> <span class="s2">&quot;stellar_type&quot;</span><span class="p">]</span>
+
+    <span class="c1"># Go over the output.</span>
+    <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">():</span>
+        <span class="n">headerline</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
+
+        <span class="c1"># CHeck the header and act accordingly</span>
+        <span class="k">if</span> <span class="n">headerline</span> <span class="o">==</span> <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span>
+            <span class="n">values</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">1</span><span class="p">:]</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">):</span>
+                <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Amount of column names isnt equal to amount of columns&quot;</span><span class="p">)</span>
+                <span class="k">raise</span> <span class="ne">ValueError</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">outfilename</span><span class="p">):</span>
+                <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                    <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">values</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Create population object</span>
+<span class="n">example_pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
+
+<span class="c1"># If you want verbosity, set this before other things</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbosity</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1"># Setting values can be done via .set(&lt;parameter_name&gt;=&lt;value&gt;)</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="c1"># binary_c physics options</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="mi">45000000080</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+
+    <span class="c1"># grid_options</span>
+    <span class="n">amt_cores</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>  <span class="c1"># grid_options</span>
+
+    <span class="c1"># Custom options: the data directory and the output filename</span>
+    <span class="n">data_dir</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+        <span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span>
+    <span class="p">),</span>  <span class="c1"># custom_options</span>
+    <span class="n">base_filename</span><span class="o">=</span><span class="s2">&quot;example_pop.dat&quot;</span><span class="p">,</span>  <span class="c1"># custom_options</span>
+<span class="p">)</span>
+
+<span class="c1"># Creating a parsing function</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">,</span>  <span class="c1"># Setting the parse function thats used in the evolve_population</span>
+<span class="p">)</span>
+
+<span class="c1">### Custom logging</span>
+<span class="c1"># Log the moment when the star turns into neutron</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">C_logging_code</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">if(stardata-&gt;star[0].stellar_type &gt;= 13)</span>
+<span class="s2">{</span>
+<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
+<span class="s2">    {</span>
+<span class="s2">        Printf(&quot;MY_STELLAR_DATA </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
+<span class="s2">            //</span>
+<span class="s2">            stardata-&gt;model.time, // 1</span>
+<span class="s2">            stardata-&gt;star[0].mass, // 2</span>
+<span class="s2">            stardata-&gt;common.zero_age.mass[0], // 4</span>
+<span class="s2">            stardata-&gt;model.probability, // 5</span>
+<span class="s2">            stardata-&gt;star[0].radius, // 6</span>
+<span class="s2">            stardata-&gt;star[0].stellar_type // 7</span>
+<span class="s2">      );</span>
+<span class="s2">    };</span>
+<span class="s2">    /* Kill the simulation to save time */</span>
+<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
+<span class="s2">};</span>
+<span class="s2">&quot;&quot;&quot;</span>
+<span class="p">)</span>
+
+<span class="c1"># Add grid variables</span>
+<span class="n">resolution</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;M_1&quot;</span><span class="p">:</span> <span class="mi">20</span><span class="p">}</span>
+
+<span class="c1"># Mass</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">(</span>
+    <span class="n">name</span><span class="o">=</span><span class="s2">&quot;lnm1&quot;</span><span class="p">,</span>
+    <span class="n">longname</span><span class="o">=</span><span class="s2">&quot;Primary mass&quot;</span><span class="p">,</span>
+    <span class="n">valuerange</span><span class="o">=</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">150</span><span class="p">],</span>
+    <span class="n">resolution</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
+    <span class="n">spacingfunc</span><span class="o">=</span><span class="s2">&quot;const(math.log(2), math.log(150), </span><span class="si">{}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
+    <span class="n">precode</span><span class="o">=</span><span class="s2">&quot;M_1=math.exp(lnm1)&quot;</span><span class="p">,</span>
+    <span class="n">probdist</span><span class="o">=</span><span class="s2">&quot;three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1&quot;</span><span class="p">,</span>
+    <span class="n">dphasevol</span><span class="o">=</span><span class="s2">&quot;dlnm1&quot;</span><span class="p">,</span>
+    <span class="n">parameter_name</span><span class="o">=</span><span class="s2">&quot;M_1&quot;</span><span class="p">,</span>
+    <span class="n">condition</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+
+<span class="c1"># Exporting of all the settings can be done with .export_all_info()</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">export_all_info</span><span class="p">()</span>
+
+<span class="c1"># remove the result file if it exists</span>
+<span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">)):</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">))</span>
+
+
+<span class="c1"># Evolve the population</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">evolve</span><span class="p">()</span>
+
+<span class="c1">#</span>
+<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">),</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+    <span class="n">output</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Generating grid code
+Constructing/adding: lnm1
+Grid has handled 20 stars
+with a total probability of 0.05150046619238192
+Total starcount for this run will be: 20
+Generating grid code
+Constructing/adding: lnm1
+Population-3680f3882c0a449c944462abffea2447 finished! The total probability was: 0.05150046619238191. It took a total of 0.6246354579925537s to run 20 systems on 2 cores
+There were no errors found in this run.
+
+
+time mass zams_mass probability radius stellar_type
+2.867655467480e+01 1.33079 9.81391 0.00167028 1.72498e-05 13
+1.931266944719e+01 1.3933 12.3177 0.00124307 1.72498e-05 13
+4.439623364590e+01 1.38004 7.81906 0.00224431 1.72498e-05 13
+1.364277535630e+01 1.47961 15.4603 0.000925128 1.72498e-05 13
+1.017435498578e+01 1.59052 19.4046 0.000688507 1.72498e-05 13
+8.294870923827e+00 1.7197 24.3552 0.000512406 1.72498e-05 13
+6.802132608769e+00 1.84162 30.5689 0.000381347 1.72498e-05 13
+5.723570798020e+00 1.99471 38.3678 0.00028381 1.72498e-05 13
+4.933751523833e+00 2.15875 48.1564 0.000211219 1.72498e-05 13
+4.337250536639e+00 2.35209 60.4424 0.000157195 9.97286e-06 14
+3.862081089332e+00 2.56776 75.8628 0.000116989 1.08873e-05 14
+3.449960890183e+00 2.80457 95.2174 8.70668e-05 1.18914e-05 14
+3.172196856333e+00 3.05193 119.51 6.47976e-05 1.29402e-05 14
+3.069627290216e+00 3.27563 150 4.82242e-05 1.38887e-05 14
+
+</pre></div></div>
+</div>
+<p>We can also set up a population that samples biinary systems, by adding extra grid variables. Below is an example of a full script that runs a binary population and registers when a double compact object is formed. The logging is rather compact and should be expanded top be more useful</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[14]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre>
+<span></span><span class="kn">import</span> <span class="nn">os</span>
+
+<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
+<span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">temp_dir</span>
+
+<span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
+    <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Example parsing function</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># extract info from the population instance</span>
+
+    <span class="c1"># Get some information from the</span>
+    <span class="n">data_dir</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">]</span>
+    <span class="n">base_filename</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;base_filename&quot;</span><span class="p">]</span>
+
+    <span class="c1"># Check directory, make if necessary</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+
+    <span class="c1">#</span>
+    <span class="n">seperator</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span>
+
+    <span class="c1"># Create filename</span>
+    <span class="n">outfilename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">base_filename</span><span class="p">)</span>
+
+    <span class="c1"># The header columns matching this</span>
+    <span class="n">parameters</span> <span class="o">=</span> <span class="p">[</span>
+        <span class="s2">&quot;time&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;mass_1&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass_1&quot;</span><span class="p">,</span> <span class="s2">&quot;mass_2&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass_2&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;stellar_type_1&quot;</span><span class="p">,</span> <span class="s2">&quot;prev_stellar_type_1&quot;</span><span class="p">,</span> <span class="s2">&quot;stellar_type_2&quot;</span><span class="p">,</span> <span class="s2">&quot;prev_stellar_type_2&quot;</span><span class="p">,</span>
+        <span class="s2">&quot;metallicity&quot;</span><span class="p">,</span> <span class="s2">&quot;probability&quot;</span>
+    <span class="p">]</span>
+
+    <span class="c1"># Go over the output.</span>
+    <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">output</span><span class="o">.</span><span class="n">splitlines</span><span class="p">():</span>
+        <span class="n">headerline</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
+
+        <span class="c1"># CHeck the header and act accordingly</span>
+        <span class="k">if</span> <span class="n">headerline</span> <span class="o">==</span> <span class="s2">&quot;EXAMPLE_DCO&quot;</span><span class="p">:</span>
+            <span class="n">values</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">1</span><span class="p">:]</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">):</span>
+                <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Amount of column names isnt equal to amount of columns&quot;</span><span class="p">)</span>
+                <span class="k">raise</span> <span class="ne">ValueError</span>
+
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">outfilename</span><span class="p">):</span>
+                <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                    <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">values</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Create population object</span>
+<span class="n">example_pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
+
+<span class="c1"># If you want verbosity, set this before other things</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbosity</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1"># Setting values can be done via .set(&lt;parameter_name&gt;=&lt;value&gt;)</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="c1"># binary_c physics options</span>
+    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">orbital_period</span><span class="o">=</span><span class="mi">45000000080</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>  <span class="c1"># bse_options</span>
+
+    <span class="c1"># grid_options</span>
+    <span class="n">amt_cores</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>  <span class="c1"># grid_options</span>
+
+    <span class="c1"># Custom options: the data directory and the output filename</span>
+    <span class="n">data_dir</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+        <span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span>
+    <span class="p">),</span>  <span class="c1"># custom_options</span>
+    <span class="n">base_filename</span><span class="o">=</span><span class="s2">&quot;example_pop.dat&quot;</span><span class="p">,</span>  <span class="c1"># custom_options</span>
+<span class="p">)</span>
+
+<span class="c1"># Creating a parsing function</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">,</span>  <span class="c1"># Setting the parse function thats used in the evolve_population</span>
+<span class="p">)</span>
+
+<span class="c1">### Custom logging</span>
+<span class="c1"># Log the moment when the star turns into neutron</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
+    <span class="n">C_logging_code</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;</span>
+<span class="s2">// logger to find gravitational wave progenitors</span>
+<span class="s2">if(stardata-&gt;star[0].stellar_type&gt;=NS &amp;&amp; stardata-&gt;star[1].stellar_type&gt;=NS)</span>
+<span class="s2">{</span>
+<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
+<span class="s2">    {</span>
+<span class="s2">        Printf(&quot;EXAMPLE_DCO </span><span class="si">%30.12e</span><span class="s2"> &quot; // 1</span>
+<span class="s2">            &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> &quot; // 2-5</span>
+<span class="s2">            &quot;</span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> </span><span class="si">%d</span><span class="s2"> &quot; // 6-9</span>
+<span class="s2">            &quot;</span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="se">\\</span><span class="s2">n&quot;, // 10-11</span>
+
+<span class="s2">            stardata-&gt;model.time, // 1</span>
+
+<span class="s2">            stardata-&gt;star[0].mass, //2</span>
+<span class="s2">            stardata-&gt;common.zero_age.mass[0], //3</span>
+<span class="s2">            stardata-&gt;star[1].mass, //4</span>
+<span class="s2">            stardata-&gt;common.zero_age.mass[1], //5</span>
+
+<span class="s2">            stardata-&gt;star[0].stellar_type, //6</span>
+<span class="s2">            stardata-&gt;previous_stardata-&gt;star[0].stellar_type, //7</span>
+<span class="s2">            stardata-&gt;star[1].stellar_type, //8</span>
+<span class="s2">            stardata-&gt;previous_stardata-&gt;star[1].stellar_type, //9</span>
+
+<span class="s2">            // model stuff</span>
+<span class="s2">            stardata-&gt;common.metallicity, //10</span>
+<span class="s2">            stardata-&gt;model.probability //11</span>
+<span class="s2">        );</span>
+<span class="s2">    }</span>
+<span class="s2">    /* Kill the simulation to safe time */</span>
+<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
+<span class="s2">}</span>
+<span class="s2">&quot;&quot;&quot;</span>
+<span class="p">)</span>
+
+<span class="c1"># Add grid variables</span>
+<span class="n">resolution</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;M_1&quot;</span><span class="p">:</span> <span class="mi">5</span><span class="p">,</span> <span class="s2">&quot;q&quot;</span><span class="p">:</span> <span class="mi">5</span><span class="p">,</span> <span class="s2">&quot;per&quot;</span><span class="p">:</span> <span class="mi">5</span><span class="p">}</span>
+
+<span class="c1"># Mass</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">(</span>
+    <span class="n">name</span><span class="o">=</span><span class="s2">&quot;lnm1&quot;</span><span class="p">,</span>
+    <span class="n">longname</span><span class="o">=</span><span class="s2">&quot;Primary mass&quot;</span><span class="p">,</span>
+    <span class="n">valuerange</span><span class="o">=</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">150</span><span class="p">],</span>
+    <span class="n">resolution</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
+    <span class="n">spacingfunc</span><span class="o">=</span><span class="s2">&quot;const(math.log(2), math.log(150), </span><span class="si">{}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
+    <span class="n">precode</span><span class="o">=</span><span class="s2">&quot;M_1=math.exp(lnm1)&quot;</span><span class="p">,</span>
+    <span class="n">probdist</span><span class="o">=</span><span class="s2">&quot;three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1&quot;</span><span class="p">,</span>
+    <span class="n">dphasevol</span><span class="o">=</span><span class="s2">&quot;dlnm1&quot;</span><span class="p">,</span>
+    <span class="n">parameter_name</span><span class="o">=</span><span class="s2">&quot;M_1&quot;</span><span class="p">,</span>
+    <span class="n">condition</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>  <span class="c1"># Impose a condition on this grid variable. Mostly for a check for yourself</span>
+<span class="p">)</span>
+
+<span class="c1"># Mass ratio</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">(</span>
+    <span class="n">name</span><span class="o">=</span><span class="s2">&quot;q&quot;</span><span class="p">,</span>
+    <span class="n">longname</span><span class="o">=</span><span class="s2">&quot;Mass ratio&quot;</span><span class="p">,</span>
+    <span class="n">valuerange</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;0.1/M_1&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span>
+    <span class="n">resolution</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s1">&#39;q&#39;</span><span class="p">]),</span>
+    <span class="n">spacingfunc</span><span class="o">=</span><span class="s2">&quot;const(0.1/M_1, 1, </span><span class="si">{}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s1">&#39;q&#39;</span><span class="p">]),</span>
+    <span class="n">probdist</span><span class="o">=</span><span class="s2">&quot;flatsections(q, [{&#39;min&#39;: 0.1/M_1, &#39;max&#39;: 1.0, &#39;height&#39;: 1}])&quot;</span><span class="p">,</span>
+    <span class="n">dphasevol</span><span class="o">=</span><span class="s2">&quot;dq&quot;</span><span class="p">,</span>
+    <span class="n">precode</span><span class="o">=</span><span class="s2">&quot;M_2 = q * M_1&quot;</span><span class="p">,</span>
+    <span class="n">parameter_name</span><span class="o">=</span><span class="s2">&quot;M_2&quot;</span><span class="p">,</span>
+    <span class="n">condition</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>  <span class="c1"># Impose a condition on this grid variable. Mostly for a check for yourself</span>
+<span class="p">)</span>
+
+<span class="c1">#</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">(</span>
+   <span class="n">name</span><span class="o">=</span><span class="s2">&quot;log10per&quot;</span><span class="p">,</span> <span class="c1"># in days</span>
+   <span class="n">longname</span><span class="o">=</span><span class="s2">&quot;log10(Orbital_Period)&quot;</span><span class="p">,</span>
+   <span class="n">valuerange</span><span class="o">=</span><span class="p">[</span><span class="mf">0.15</span><span class="p">,</span> <span class="mf">5.5</span><span class="p">],</span>
+   <span class="n">resolution</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;per&quot;</span><span class="p">]),</span>
+   <span class="n">spacingfunc</span><span class="o">=</span><span class="s2">&quot;const(0.15, 5.5, </span><span class="si">{}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;per&quot;</span><span class="p">]),</span>
+   <span class="n">precode</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;orbital_period = 10** log10per</span>
+<span class="s2">sep = calc_sep_from_period(M_1, M_2, orbital_period)</span>
+<span class="s2">sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)</span>
+<span class="s2">sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)&quot;&quot;&quot;</span><span class="p">,</span>
+   <span class="n">probdist</span><span class="o">=</span><span class="s2">&quot;sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)&quot;</span><span class="p">,</span>
+   <span class="n">parameter_name</span><span class="o">=</span><span class="s2">&quot;orbital_period&quot;</span><span class="p">,</span>
+   <span class="n">dphasevol</span><span class="o">=</span><span class="s2">&quot;dlog10per&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+
+<span class="c1"># Exporting of all the settings can be done with .export_all_info()</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">export_all_info</span><span class="p">()</span>
+
+<span class="c1"># remove the result file if it exists</span>
+<span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">)):</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">))</span>
+
+<span class="c1"># Evolve the population</span>
+<span class="n">example_pop</span><span class="o">.</span><span class="n">evolve</span><span class="p">()</span>
+
+<span class="c1">#</span>
+<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span><span class="p">,</span> <span class="s2">&quot;example_pop.dat&quot;</span><span class="p">),</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+    <span class="n">output</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
 </pre></div>
 </div>
 </div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Generating grid code
+Constructing/adding: lnm1
+Constructing/adding: q
+Constructing/adding: log10per
+Grid has handled 125 stars
+with a total probability of 0.0862478164626921
+Total starcount for this run will be: 125
+Generating grid code
+Constructing/adding: lnm1
+Constructing/adding: q
+Constructing/adding: log10per
+Population-d20a4c74d20a43b881c0c9e5def5f76c finished! The total probability was: 0.08624781646269201. It took a total of 8.561265707015991s to run 125 systems on 2 cores
+There were no errors found in this run.
+
+
+time mass_1 zams_mass_1 mass_2 zams_mass_2 stellar_type_1 prev_stellar_type_1 stellar_type_2 prev_stellar_type_2 metallicity probability
+8.863377990313e+01 1.29444 5.88566 0 2.99283 13 5 15 15 0.02 0.000627913
+1.146421815741e+02 0 5.88566 1.33062 4.43925 15 15 13 5 0.02 0.000627913
+7.222715508467e+01 1.34922 5.88566 0 5.88566 13 5 15 15 0.02 0.000627913
+1.350021848285e+01 1.48488 17.3205 0 0.1 13 5 15 15 0.02 0.000154349
+1.171108213270e+01 1.53113 17.3205 0 0.1 13 5 15 15 0.02 0.000154349
+1.171086983243e+01 1.53177 17.3205 0 0.1 13 9 15 15 0.02 0.000154349
+1.170770599495e+01 1.53176 17.3205 0 4.40513 13 5 15 15 0.02 0.000172877
+1.230407246199e+01 1.59499 17.3205 0 4.40513 13 5 15 15 0.02 0.000610573
+1.108751340926e+01 1.70319 17.3205 0 8.71025 13 4 15 15 0.02 0.000610573
+1.941017702765e+01 1.34903 17.3205 1.65097 8.71025 13 13 13 5 0.02 0.000172877
+1.980988739731e+01 1.36979 17.3205 1.60808 8.71025 13 13 13 5 0.02 0.000121486
+3.571858031651e+01 1.53174 17.3205 1.30504 8.71025 13 13 13 5 0.02 8.42148e-05
+3.459153942631e+01 1.53176 17.3205 1.31004 8.71025 13 13 13 5 0.02 9.8162e-05
+1.687368550125e+01 1.34937 17.3205 1.73856 13.0154 13 13 13 8 0.02 0.000172877
+1.194842917007e+01 1.78096 17.3205 0 13.0154 13 8 15 15 0.02 0.000610573
+1.733614170983e+01 1.53184 17.3205 1.42375 13.0154 13 13 13 5 0.02 9.8162e-05
+1.723547465714e+01 1.38403 17.3205 1.71288 13.0154 13 13 13 8 0.02 0.000121486
+1.764340254985e+01 1.53174 17.3205 1.41264 13.0154 13 13 13 5 0.02 8.42148e-05
+1.170425790780e+01 1.52963 17.3205 0 17.3205 13 5 15 15 0.02 0.000172877
+8.922967341481e+00 1.85486 17.3205 0 17.3205 13 8 15 15 0.02 0.000610573
+1.232906623449e+01 1.41074 17.3205 1.34281 17.3205 13 13 13 8 0.02 0.000121486
+1.170775828562e+01 1.53183 17.3205 1.53183 17.3205 13 5 13 5 0.02 9.8162e-05
+1.170770422321e+01 1.53175 17.3205 1.53175 17.3205 13 5 13 5 0.02 8.42148e-05
+5.075844624794e+00 2.12303 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05
+4.766606588165e+00 2.20484 50.9713 0 0.1 14 8 15 15 0.02 3.79411e-05
+4.768305081494e+00 2.18838 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05
+4.458869865939e+00 2.29864 50.9713 0 12.8178 14 8 15 15 0.02 0.000150087
+1.806014211040e+01 2.10446 50.9713 1.40749 12.8178 13 13 13 5 0.02 2.9863e-05
+4.797342083485e+00 2.10328 50.9713 0 12.8178 13 13 15 1 0.02 4.24954e-05
+1.721374713429e+01 2.21673 50.9713 1.42212 12.8178 14 14 13 5 0.02 2.41295e-05
+4.055645404546e+00 2.47276 50.9713 0 25.5357 14 7 15 15 0.02 0.000150087
+1.806123543037e+01 2.21893 50.9713 1.40745 12.8178 14 14 13 5 0.02 2.07011e-05
+8.117519147635e+00 2.10433 50.9713 2.21473 25.5357 13 13 14 8 0.02 4.24954e-05
+8.315554923168e+00 2.15343 50.9713 2.08519 25.5357 13 13 13 8 0.02 2.9863e-05
+7.917420996633e+00 2.21892 50.9713 1.7431 25.5357 14 14 13 8 0.02 2.07011e-05
+7.693213405973e+00 2.21805 50.9713 1.78384 25.5357 14 14 13 8 0.02 2.41295e-05
+3.753837732894e+00 2.62517 50.9713 0 38.2535 14 7 15 15 0.02 0.000150087
+7.087296558990e+00 2.10417 50.9713 2.40935 38.2535 13 13 14 8 0.02 4.24954e-05
+7.007109286263e+00 2.15854 50.9713 2.28672 38.2535 13 13 14 8 0.02 2.9863e-05
+5.653200958306e+00 2.21878 50.9713 2.0587 38.2535 14 14 13 8 0.02 2.41295e-05
+5.733794947644e+00 2.21892 50.9713 1.99255 38.2535 14 14 13 8 0.02 2.07011e-05
+3.513216011269e+00 2.76647 50.9713 0 50.9713 14 7 15 15 0.02 0.000150087
+4.750574783854e+00 2.27442 50.9713 0 50.9713 14 8 15 15 0.02 4.24954e-05
+7.278384712062e+00 1.29678 50.9713 2.09216 50.9713 13 8 13 13 0.02 2.9863e-05
+4.765996194699e+00 2.20787 50.9713 2.20787 50.9713 14 8 14 8 0.02 2.07011e-05
+4.765535914728e+00 2.21331 50.9713 2.21331 50.9713 14 8 14 8 0.02 2.41295e-05
+3.104706358826e+00 3.17639 150 0 0.1 14 7 15 15 0.02 9.32641e-06
+3.069363482023e+00 3.27572 150 0 0.1 14 7 15 15 0.02 9.32641e-06
+3.047074050271e+00 3.3836 150 0 37.575 14 7 15 15 0.02 3.68933e-05
+5.974759306305e+00 3.23604 150 2.53922 37.575 14 14 14 7 0.02 1.04459e-05
+6.074084349384e+00 3.30145 150 2.13876 37.575 14 14 13 8 0.02 7.34071e-06
+5.733865371895e+00 3.29994 150 2.00498 37.575 14 14 13 8 0.02 5.93135e-06
+3.027099358410e+00 3.53631 150 0 75.05 14 7 15 15 0.02 3.68933e-05
+5.807147339697e+00 3.30197 150 1.9791 37.575 14 14 13 8 0.02 5.08861e-06
+4.862942347290e+00 3.25294 150 2.97823 75.05 14 14 14 7 0.02 1.04459e-05
+4.556479830908e+00 3.29942 150 2.73221 75.05 14 14 14 7 0.02 7.34071e-06
+3.853070305680e+00 3.29977 150 2.62486 75.05 14 14 14 7 0.02 5.93135e-06
+3.881529045940e+00 3.30149 150 2.55924 75.05 14 14 14 7 0.02 5.08861e-06
+3.015033359333e+00 3.64419 150 0 112.525 14 7 15 15 0.02 3.68933e-05
+4.126828648362e+00 3.32047 150 0 112.525 14 14 15 3 0.02 1.04459e-05
+3.990017992944e+00 3.3032 150 2.94027 112.525 14 14 14 7 0.02 7.34071e-06
+3.206771867883e+00 3.07671 150 3.11282 112.525 14 14 14 7 0.02 5.93135e-06
+3.006827156705e+00 3.72638 150 0 150 14 7 15 15 0.02 3.68933e-05
+3.218786094847e+00 3.30337 150 3.01344 112.525 14 14 14 7 0.02 5.08861e-06
+4.527722847382e+00 1.42238 150 0 150 13 5 15 15 0.02 1.04459e-05
+3.069567332611e+00 3.27804 150 3.27804 150 14 7 14 7 0.02 5.93135e-06
+5.726405299909e+00 1.29746 150 3.22759 150 13 8 14 14 0.02 7.34071e-06
+3.069626478211e+00 3.27565 150 3.27565 150 14 7 14 7 0.02 5.08861e-06
+
+</pre></div></div>
+</div>
+</div>
 </div>
 
 
@@ -733,10 +1520,10 @@ Adding data to HDF5 file
   
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
       
-        <a href="binary_c_parameters.html" class="btn btn-neutral float-right" title="Binary_c parameters" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="notebook_extra_features.html" class="btn btn-neutral float-right" title="Extra features and functionality of binarycpython" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
       
       
-        <a href="notebooks.html" class="btn btn-neutral float-left" title="Notebooks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+        <a href="notebook_custom_logging.html" class="btn btn-neutral float-left" title="Notebook custom logging" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
       
     </div>
   
@@ -759,9 +1546,9 @@ Adding data to HDF5 file
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/notebook_population.ipynb b/docs/build/html/notebook_population.ipynb
index 8d2bdbf98..56f3b153c 100644
--- a/docs/build/html/notebook_population.ipynb
+++ b/docs/build/html/notebook_population.ipynb
@@ -5,44 +5,82 @@
    "id": "bbbaafbb-fd7d-4b73-a970-93506ba35d71",
    "metadata": {},
    "source": [
-    "# Title page\n"
+    "# Running populations with binarycpython\n",
+    "This notebook will show you how to evolve a population of stars\n",
+    "\n",
+    "Much of the code in the binarycpython package is written to evolve a population of stars through the Population object, rather than running a single system. Let's go through the functionality of this object step by step and set up some example populations. \n",
+    "\n",
+    "At the bottom of this notebook there are some complete example scripts"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "bf6b8673-a2b5-4b50-ad1b-e90671f57470",
    "metadata": {},
    "outputs": [],
    "source": [
     "import os\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
     "from binarycpython.utils.grid import Population\n",
-    "from binarycpython.utils.functions import (\n",
-    "    get_help_all,\n",
-    "    get_help,\n",
-    "    create_hdf5,\n",
-    "    output_lines,\n",
-    ")\n",
-    "from binarycpython.utils.custom_logging_functions import temp_dir\n"
+    "\n",
+    "# help(Population) # Uncomment to see the public functions of this object"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a081ab23-7822-4971-aa82-991548534714",
+   "metadata": {},
+   "source": [
+    "- running ensemble\n",
+    "- using M&S grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f268eff3-4e08-4f6b-8b59-f22dba4d2074",
+   "metadata": {},
+   "source": [
+    "## Setting up the Population object\n",
+    "To set up and configure the population object we need to make an object instance of the `Population` object, and add configuration via the `.set()` function.\n",
+    "\n",
+    "There are three categories of options that the Population object can set:\n",
+    "- BSE options: these options will be used for the binary_c calls, and are recognized by comparing the arguments to a known list of available arguments of binary_c. To see which options are available, see section [`binary_c parameters` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html). You can access these through `population.bse_options['<bse option name>']` after you have set them. \n",
+    "\n",
+    "- Grid options: these options will be used to configure the behaviour of the Population object. To see which options are available, see section [`Population grid code options` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html). They can be accessed via `population.grid_options['<grid option name>']` after you have set them. \n",
+    "\n",
+    "- Custom options: these options are not recognized as either of the above, so they will be stored in the custom_options, and can be accessed via `population.custom_options['<custom option name>']`"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "79ab50b7-591f-4883-af09-116d1835a751",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "adding: orbital_period=45000000080 to BSE_options\n",
+      "adding: max_evolution_time=15000 to BSE_options\n",
+      "adding: eccentricity=0.02 to BSE_options\n",
+      "adding: amt_cores=2 to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: data_dir=/tmp/binary_c_python/example_python_population_result to custom_options >>>>\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: base_filename=example_pop.dat to custom_options >>>>\n",
+      "1\n",
+      "example_pop.dat\n",
+      "10\n"
+     ]
+    }
+   ],
    "source": [
-    "#########################################################\n",
-    "# This file serves as an example for running a population.\n",
-    "# The use of help(<function>) is a good way to inspect what parameters are there to use\n",
-    "#########################################################\n",
-    "\n",
     "# Create population object\n",
     "example_pop = Population()\n",
     "\n",
     "# If you want verbosity, set this before other things\n",
-    "example_pop.set(verbose=1)\n",
+    "example_pop.set(verbosity=1)\n",
     "\n",
     "# Setting values can be done via .set(<parameter_name>=<value>)\n",
     "# Values that are known to be binary_c_parameters are loaded into bse_options.\n",
@@ -51,115 +89,244 @@
     "example_pop.set(\n",
     "    # binary_c physics options\n",
     "    M_1=10,  # bse_options\n",
-    "    separation=0,  # bse_options\n",
     "    orbital_period=45000000080,  # bse_options\n",
     "    max_evolution_time=15000,  # bse_options\n",
     "    eccentricity=0.02,  # bse_options\n",
-    "    # Set companion to low mass\n",
-    "    M_2=0.08,  # Since in the example we run a single system, we should set the companion mass here. If we donm't do this, the code will complain.\n",
+    "\n",
+    "\n",
     "    # grid_options\n",
     "    amt_cores=2,  # grid_options\n",
-    "    verbose=1,  # verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff\n",
+    "    \n",
     "    # Custom options # TODO: need to be set in grid_options probably\n",
     "    data_dir=os.path.join(\n",
     "        temp_dir(), \"example_python_population_result\"\n",
     "    ),  # custom_options\n",
     "    base_filename=\"example_pop.dat\",  # custom_options\n",
-    ")"
+    ")\n",
+    "\n",
+    "# We can use the options through\n",
+    "print(example_pop.grid_options['verbosity'])\n",
+    "print(example_pop.custom_options['base_filename'])\n",
+    "print(example_pop.bse_options['M_1'])"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
+   "cell_type": "markdown",
+   "id": "f8d46d19-633d-4911-821d-a59daed31816",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "def parse_function(self, output):\n",
-    "    # EXAMPLE PARSE_FUNCTION\n",
-    "\n",
-    "    # extract info from the population instance\n",
-    "\n",
-    "    # Get some information from the\n",
-    "    data_dir = self.custom_options[\"data_dir\"]\n",
-    "    base_filename = self.custom_options[\"base_filename\"]\n",
-    "\n",
-    "    # Check directory, make if necessary\n",
-    "    os.makedirs(data_dir, exist_ok=True)\n",
-    "\n",
-    "    seperator = \" \"\n",
-    "\n",
-    "    # Create filename\n",
-    "    outfilename = os.path.join(data_dir, base_filename)\n",
-    "\n",
-    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "After configuring the population, but before running the actual population, its usually a good idea to export the full configuration (including version info of binary_c and all the parameters) to a file. To do this we use `example_pop.export_all_info()`.\n",
     "\n",
-    "    # Go over the output.\n",
-    "    for el in output_lines(output):\n",
-    "        headerline = el.split()[0]\n",
-    "\n",
-    "        # CHeck the header and act accordingly\n",
-    "        if headerline == \"MY_STELLAR_DATA\":\n",
-    "            values = el.split()[1:]\n",
-    "            print(values)\n",
-    "\n",
-    "            if not len(parameters) == len(values):\n",
-    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
-    "                raise ValueError\n",
+    "On default this exports everything, each of the sections can be disabled:\n",
+    "  - population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
+    "      settings=False\n",
+    "  - binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
+    "      turn off with include_binary_c_defaults=False\n",
+    "  - include_binary_c_version_info (all the compilation info, and information about the compiled\n",
+    "      parameters), turn off with include_binary_c_version_info=False\n",
+    "  - include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
+    "      turn off with include_binary_c_help_all=Fase\n",
+    "      \n",
+    "On default it will write this to the custom_options['data_dir'], but that can be overriden by setting use_datadir=False and providing an outfile=<>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "b9c2471a-a5b0-48b7-a50b-2f0d22100926",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Writing settings to /tmp/binary_c_python/example_python_population_result/example_pop_settings.json\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "example_pop.export_all_info()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f9a65554-36ab-4a04-96ca-9f1422c307fd",
+   "metadata": {},
+   "source": [
+    "## Adding grid variables\n",
+    "The main purpose of the Population object is to handle the population synthesis side of running a set of stars. The main method to do this with binarycpython, as is the case with Perl binarygrid, is to use grid variables. These are loops over a predefined range of values, where a probability will be assigned to the systems based on the chosen probability distributions.\n",
     "\n",
-    "            if not os.path.exists(outfilename):\n",
-    "                with open(outfilename, \"w\") as f:\n",
-    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "Usually we use either 1 mass grid variable, or a trio of mass, mass ratio and period (See below for full examples of all of these). We can, however, also add grid sampling for e.g. eccentricity, metallicity or other parameters. \n",
     "\n",
-    "            with open(outfilename, \"a\") as f:\n",
-    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "In some cases it could be easier to set up a for loop that sets that parameter and calls the evolve function several times, e.g. when you want to vary a prescription (usually a discrete, unweighted parameter) \n",
     "\n",
     "\n",
+    "A notable special type of grid variable is that of the Moe & di Stefano 2017 dataset (see further down in the notebook).\n",
     "\n",
-    "# Creating a parsing function\n",
-    "example_pop.set(\n",
-    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
-    ")"
+    "To add a grid variable to the population object we use `example_pop.add_grid_variable` (see next cell)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "2fa5188e-312f-4a05-aeda-0bd4c00629c8",
+   "execution_count": 4,
+   "id": "68c84521-9ae8-4020-af7a-5334173db969",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method add_grid_variable in module binarycpython.utils.grid:\n",
+      "\n",
+      "add_grid_variable(name:str, longname:str, valuerange:Union[list, str], resolution:str, spacingfunc:str, probdist:str, dphasevol:Union[str, int], parameter_name:str, gridtype:str='edge', branchpoint:int=0, precode:Union[str, NoneType]=None, condition:Union[str, NoneType]=None) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function to add grid variables to the grid_options.\n",
+      "    \n",
+      "    The execution of the grid generation will be through a nested for loop.\n",
+      "    Each of the grid variables will get create a deeper for loop.\n",
+      "    \n",
+      "    The real function that generates the numbers will get written to a new file in the TMP_DIR,\n",
+      "    and then loaded imported and evaluated.\n",
+      "    beware that if you insert some destructive piece of code, it will be executed anyway.\n",
+      "    Use at own risk.\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: Fix this complex function.\n",
+      "    \n",
+      "    Args:\n",
+      "        name:\n",
+      "            name of parameter. This is evaluated as a parameter and you can use it throughout\n",
+      "            the rest of the function\n",
+      "            \n",
+      "            Examples:\n",
+      "                name = 'lnm1'\n",
+      "        longname:\n",
+      "            Long name of parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                longname = 'Primary mass'\n",
+      "        range:\n",
+      "            Range of values to take. Does not get used really, the spacingfunction is used to\n",
+      "            get the values from\n",
+      "            \n",
+      "            Examples:\n",
+      "                range = [math.log(m_min), math.log(m_max)]\n",
+      "        resolution:\n",
+      "            Resolution of the sampled range (amount of samples).\n",
+      "            TODO: check if this is used anywhere\n",
+      "    \n",
+      "            Examples: \n",
+      "                resolution = resolution[\"M_1\"]\n",
+      "        spacingfunction:\n",
+      "            Function determining how the range is sampled. You can either use a real function,\n",
+      "            or a string representation of a function call. Will get written to a file and\n",
+      "            then evaluated.\n",
+      "    \n",
+      "            Examples:\n",
+      "                spacingfunction = \"const(math.log(m_min), math.log(m_max), {})\".format(resolution['M_1'])\n",
+      "    \n",
+      "        precode:\n",
+      "            Extra room for some code. This code will be evaluated within the loop of the\n",
+      "            sampling function (i.e. a value for lnm1 is chosen already)\n",
+      "            \n",
+      "            Examples:\n",
+      "                precode = 'M_1=math.exp(lnm1);'\n",
+      "        probdist:\n",
+      "            Function determining the probability that gets assigned to the sampled parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                probdist = 'Kroupa2001(M_1)*M_1'\n",
+      "        dphasevol:\n",
+      "            part of the parameter space that the total probability is calculated with. Put to -1\n",
+      "            if you want to ignore any dphasevol calculations and set the value to 1\n",
+      "            Examples:\n",
+      "                dphasevol = 'dlnm1'\n",
+      "        condition:\n",
+      "            condition that has to be met in order for the grid generation to continue\n",
+      "            Examples:\n",
+      "                condition = 'self.grid_options['binary']==1'\n",
+      "        gridtype:\n",
+      "            Method on how the value range is sampled. Can be either 'edge' (steps starting at\n",
+      "            the lower edge of the value range) or 'center'\n",
+      "            (steps starting at lower edge + 0.5 * stepsize).\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.add_grid_variable)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bd75cebe-2152-4025-b680-dc020b80889b",
    "metadata": {},
+   "source": [
+    "All the distribution functions that we can use are stored in the `binarycpython.utils.distribution_functions` or `binarycpython/utils/distribution_functions.py` on git. If you uncomment the help statement below you can see which functions are available now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "048db541-3e92-4c5d-a25c-9c5a34b9c857",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
    "outputs": [],
    "source": [
-    "### Custom logging\n",
-    "# Log the moment when the star turns into neutron\n",
-    "example_pop.set(\n",
-    "    C_logging_code=\"\"\"\n",
-    "if(stardata->star[0].stellar_type >= 13)    \n",
-    "{\n",
-    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
-    "    {\n",
-    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
-    "            // \n",
-    "            stardata->model.time, // 1\n",
-    "            stardata->star[0].mass, // 2\n",
-    "            stardata->common.zero_age.mass[0], // 4\n",
-    "            stardata->model.probability, // 5\n",
-    "            stardata->star[0].radius, // 6\n",
-    "            stardata->star[0].stellar_type // 7\n",
-    "      );\n",
-    "    };\n",
-    "    /* Kill the simulation to save time */\n",
-    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
-    "};\n",
-    "\"\"\"\n",
-    ")"
+    "# import binarycpython.utils.distribution_functions\n",
+    "# help(binarycpython.utils.distribution_functions)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b3a007b-5c17-42a7-a981-7e268e6f545c",
+   "metadata": {},
+   "source": [
+    "The next cell contains an example of adding the mass grid variable, but sampling in log mass. The commented grid variables are examples of the mass ratio sampling and the period sampling."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "fd197154-a8ce-4865-8929-008d3483101a",
+   "execution_count": 6,
+   "id": "47979841-2c26-4b26-8945-603d013dc93a",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added grid variable: {\n",
+      "    \"name\": \"lnm1\",\n",
+      "    \"longname\": \"Primary mass\",\n",
+      "    \"valuerange\": [\n",
+      "        2,\n",
+      "        150\n",
+      "    ],\n",
+      "    \"resolution\": \"20\",\n",
+      "    \"spacingfunc\": \"const(math.log(2), math.log(150), 20)\",\n",
+      "    \"precode\": \"M_1=math.exp(lnm1)\",\n",
+      "    \"probdist\": \"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+      "    \"dphasevol\": \"dlnm1\",\n",
+      "    \"parameter_name\": \"M_1\",\n",
+      "    \"condition\": \"\",\n",
+      "    \"gridtype\": \"edge\",\n",
+      "    \"branchpoint\": 0,\n",
+      "    \"grid_variable_number\": 0\n",
+      "}\n"
+     ]
+    }
+   ],
    "source": [
     "# Add grid variables\n",
     "resolution = {\"M_1\": 20, \"q\": 20, \"per\": 40}\n",
@@ -211,128 +378,815 @@
   },
   {
    "cell_type": "markdown",
-   "id": "8c96b151-8c3b-4479-969f-6c2f898497a5",
+   "id": "163f13ae-fec1-4ee8-b9d4-c1b75c19ff39",
    "metadata": {},
    "source": [
-    "Exporting of all the settings can be done with .export_all_info()\n",
-    "on default it exports everything, but can be supressed by turning it off:\n",
-    "  population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
-    "      settings=False\n",
-    "  binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
-    "      turn off with include_binary_c_defaults=False\n",
-    "  include_binary_c_version_info (all the compilation info, and information about the compiled\n",
-    "      parameters), turn off with include_binary_c_version_info=False\n",
-    "  include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
-    "      turn off with include_binary_c_help_all=Fase\n",
-    "On default it will write this to the custom_options['data_dir'], but that can be overriden by\n",
-    "  setting use_datadir=False and providing an outfile=<>"
+    "## Setting logging and handling the output\n",
+    "On default, binary_c will not output anything (except for 'SINGLE STAR LIFETIME'). It is up to us to determine what will be printed. We can either do that by hardcoding the print statements into `binary_c` (see documentation binary_c). Or, we can use the custom logging functionality of binarycpython (see notebook `notebook_custom_logging.ipynb`), which is faster to set up and requires no recompilation of binary_c, but is somewhat more limited in its functionality. \n",
+    "\n",
+    "After configuring what will be printed, we need to make a function to parse the output. This can be done by setting the parse_function parameter in the population object (see also notebook `notebook_individual_systems.ipynb`). \n",
+    "\n",
+    "In the code below we will set up both the custom logging, and a parse function to handle that output"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
-   "id": "ba83443c-64b4-4126-90b3-b1ca76c0f73d",
+   "execution_count": 7,
+   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
    "metadata": {},
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "if(stardata->star[0].stellar_type >= 13)    \n",
+      "{\n",
+      "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+      "    {\n",
+      "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\n\",\n",
+      "            // \n",
+      "            stardata->model.time, // 1\n",
+      "            stardata->star[0].mass, // 2\n",
+      "            stardata->common.zero_age.mass[0], // 3\n",
+      "            stardata->model.probability, // 4\n",
+      "            stardata->star[0].stellar_type // 5\n",
+      "      );\n",
+      "    };\n",
+      "    /* Kill the simulation to save time */\n",
+      "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+      "};\n",
+      " to grid_options\n"
+     ]
     }
    ],
    "source": [
-    "example_pop.export_all_info()"
+    "# Create custom logging statement: in this case we will log when the star turns into a compact object, and then terminate the evolution.\n",
+    "custom_logging_statement = \"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 3\n",
+    "            stardata->model.probability, // 4\n",
+    "            stardata->star[0].stellar_type // 5\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "example_pop.set(\n",
+    "    C_logging_code=custom_logging_statement\n",
+    ")"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "ef5b51a1-e56d-4bec-a5c7-b9d5bceeceba",
+   "id": "ae1f1f0c-1f8b-42d8-b051-cbf8c6b51514",
    "metadata": {},
    "source": [
-    "Executing a single system\n",
-    "This uses the M_1 orbital period etc set with the set function"
+    "The parse function must now catch lines that start with \"EXAMPLE_COMPACT_OBJECT\", and write that line to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
-   "id": "c0a9aed7-1fc9-4fe3-8bcf-4e987bfc00a9",
+   "execution_count": 8,
+   "id": "fd197154-a8ce-4865-8929-008d3483101a",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating the code for the shared library for the custom logging\n",
-      "['2.773586668293e+01', '1.33526', '10', '1', '1.72498e-05', '13']\n",
-      "None\n"
+      "adding: parse_function=<function parse_function at 0x7ff3bdf79620> to grid_options\n"
      ]
     }
    ],
    "source": [
-    "output = example_pop.evolve_single()\n",
-    "print(output)"
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # get info from the population instance\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for line in output.splitlines():\n",
+    "        headerline = line.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_COMPACT_OBJECT\":\n",
+    "            values = line.split()[1:]\n",
+    "            print(line)\n",
+    "            \n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "# Add the parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,\n",
+    ")"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
-   "metadata": {
-    "tags": []
-   },
-   "outputs": [],
+   "cell_type": "markdown",
+   "id": "91509ce5-ffe7-4937-aa87-6d7baac9ac04",
+   "metadata": {},
    "source": [
-    "## Executing a population\n",
-    "## This uses the values generated by the grid_variables\n",
-    "example_pop.evolve()  # TODO: update this function call"
+    "## Evolving the grid\n",
+    "Now that we configured all the main parts of the population object, we can actually run the population! Doing this is straightforward: `example_pop.evolve()`\n",
+    "\n",
+    "This will start up the processing of all the systems. We can control how many cores are used by settings `amt_cores`. By setting the `verbosity` of the population object to a higher value we can get a lot of verbose information about the run, but for now we will set it to 0.\n",
+    "\n",
+    "There are many grid_options that can lead to different behaviour of the evolution of the grid. Please do have a look at those: [grid options docs](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html), and try  "
    ]
   },
   {
-   "cell_type": "markdown",
-   "id": "ce937b07-7292-4bb1-b2e7-d69e51bdff6e",
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
    "metadata": {
     "tags": []
    },
-   "source": [
-    "Wrapping up the results to an hdf5 file can be done by using the create_hdf5\n",
-    "(<directory containing data and settings>) This function takes the settings file\n",
-    "(ending in _settings.json) and the data files (ending in .dat) from the data_dir\n",
-    "and packing them into an hdf5 file, which is then written into the same data_dir directory"
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: verbosity=0 to grid_options\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "EXAMPLE_COMPACT_OBJECT             2.867655467480e+01 1.33079 9.81391 0.00167028 13\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "EXAMPLE_COMPACT_OBJECT             1.931266944719e+01 1.3933 12.3177 0.00124307 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.439623364590e+01 1.38004 7.81906 0.00224431 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.364277535630e+01 1.47961 15.4603 0.000925128 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.017435498578e+01 1.59052 19.4046 0.000688507 13\n",
+      "EXAMPLE_COMPACT_OBJECT             8.294870923827e+00 1.7197 24.3552 0.000512406 13\n",
+      "EXAMPLE_COMPACT_OBJECT             6.802132608769e+00 1.84162 30.5689 0.000381347 13\n",
+      "EXAMPLE_COMPACT_OBJECT             5.723570798020e+00 1.99471 38.3678 0.00028381 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.933751523833e+00 2.15875 48.1564 0.000211219 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.337250536639e+00 2.35209 60.4424 0.000157195 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.862081089332e+00 2.56776 75.8628 0.000116989 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.449960890183e+00 2.80457 95.2174 8.70668e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.172196856333e+00 3.05193 119.51 6.47976e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.069627290216e+00 3.27563 150 4.82242e-05 14\n",
+      "Population-2a7732d03e594ef4b5dfe9051b41d9c0 finished! The total probability was: 0.05150046619238191. It took a total of 0.7797017097473145s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# change verbosity\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "## Executing a population\n",
+    "## This uses the values generated by the grid_variables\n",
+    "analytics = example_pop.evolve()  # TODO: update this function call"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "91ab45c7-7d31-4543-aee4-127ab58e891f",
+   "metadata": {},
+   "source": [
+    "After the run is complete, some technical report on the run is returned. I stored that in `analytics`. As we can see below, this dictionary is like a status report of the evolution. Useful for e.g. debugging."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
-   "id": "ad444138-f854-4fdb-8e18-49e35ac9c7e2",
+   "execution_count": 10,
+   "id": "e1f0464b-0424-4022-b34b-5b744bc2c59d",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating /tmp/binary_c_python/example_python_population_result/example_pop.hdf5\n",
-      "Adding settings to HDF5 file\n",
-      "Adding data to HDF5 file\n"
+      "{'population_name': '2a7732d03e594ef4b5dfe9051b41d9c0', 'evolution_type': 'grid', 'failed_count': 0, 'failed_prob': 0, 'failed_systems_error_codes': [], 'errors_exceeded': False, 'errors_found': False, 'total_probability': 0.05150046619238191, 'total_count': 20, 'start_timestamp': 1628444120.234709, 'end_timestamp': 1628444121.0144107, 'total_mass_run': 730.1048014407228, 'total_probability_weighted_mass_run': 0.2983275843337705, 'zero_prob_stars_skipped': 0}\n"
      ]
     }
    ],
    "source": [
-    "create_hdf5(data_dir=example_pop.custom_options[\"data_dir\"], name=\"example_pop.hdf5\")\n"
+    "print(analytics)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6460df56-9fba-4817-9a1e-593ef15d98c1",
+   "metadata": {},
+   "source": [
+    "## Noteworthy functionality\n",
+    "Some extra features that are available from via the population object are:\n",
+    "- write_binary_c_calls_to_file: Function to write the calls that would be passed to binary_c to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "34da69bc-fe60-4a9d-b07a-f6cd2f216964",
+   "execution_count": 11,
+   "id": "83f8e519-4f7c-474a-ad95-f175a34fae81",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method write_binary_c_calls_to_file in module binarycpython.utils.grid:\n",
+      "\n",
+      "write_binary_c_calls_to_file(output_dir:Union[str, NoneType]=None, output_filename:Union[str, NoneType]=None, include_defaults:bool=False) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function that loops over the grid code and writes the generated parameters to a file.\n",
+      "    In the form of a command line call\n",
+      "    \n",
+      "    Only useful when you have a variable grid as system_generator. MC wouldn't be that useful\n",
+      "    \n",
+      "    Also, make sure that in this export there are the basic parameters\n",
+      "    like m1,m2,sep, orb-per, ecc, probability etc.\n",
+      "    \n",
+      "    On default this will write to the datadir, if it exists\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: test this function\n",
+      "        - TODO: make sure the binary_c_python .. output file has a unique name\n",
+      "    \n",
+      "    Args:\n",
+      "        output_dir: (optional, default = None) directory where to write the file to. If custom_options['data_dir'] is present, then that one will be used first, and then the output_dir\n",
+      "        output_filename: (optional, default = None) filename of the output. If not set it will be called \"binary_c_calls.txt\"\n",
+      "        include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.\n",
+      "    \n",
+      "    Returns:\n",
+      "        filename: filename that was used to write the calls to\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.write_binary_c_calls_to_file)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "dacfed75-dfe3-4afd-a0ff-a4be17746021",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Saving grid code to grid_options\n",
+      "Writing grid code to /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Loading grid code function from /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Grid code loaded\n",
+      "Writing binary_c calls to /tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "/tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "binary_c M_1 2.0 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.013208238029791246\n",
+      "binary_c M_1 2.5102526289471614 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.009829948023831718\n",
+      "binary_c M_1 3.1506841305680684 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.0073157281034221516\n",
+      "binary_c M_1 3.9545065608702976 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.005444573822104362\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(verbosity=10)\n",
+    "calls_filename = example_pop.write_binary_c_calls_to_file()\n",
+    "print(calls_filename)\n",
+    "\n",
+    "with open(calls_filename, 'r') as f:\n",
+    "    print('\\n'.join(f.read().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "60359eb1-4d0c-4d2d-8265-ec5171b944a2",
+   "metadata": {},
+   "source": [
+    "## Full examples of population scripts\n",
+    "Below is a full setup for a population of single stars"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "7212b6be-9787-4122-a7f1-86538cf38179",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Population-3680f3882c0a449c944462abffea2447 finished! The total probability was: 0.05150046619238191. It took a total of 0.6246354579925537s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass zams_mass probability radius stellar_type\n",
+      "2.867655467480e+01 1.33079 9.81391 0.00167028 1.72498e-05 13\n",
+      "1.931266944719e+01 1.3933 12.3177 0.00124307 1.72498e-05 13\n",
+      "4.439623364590e+01 1.38004 7.81906 0.00224431 1.72498e-05 13\n",
+      "1.364277535630e+01 1.47961 15.4603 0.000925128 1.72498e-05 13\n",
+      "1.017435498578e+01 1.59052 19.4046 0.000688507 1.72498e-05 13\n",
+      "8.294870923827e+00 1.7197 24.3552 0.000512406 1.72498e-05 13\n",
+      "6.802132608769e+00 1.84162 30.5689 0.000381347 1.72498e-05 13\n",
+      "5.723570798020e+00 1.99471 38.3678 0.00028381 1.72498e-05 13\n",
+      "4.933751523833e+00 2.15875 48.1564 0.000211219 1.72498e-05 13\n",
+      "4.337250536639e+00 2.35209 60.4424 0.000157195 9.97286e-06 14\n",
+      "3.862081089332e+00 2.56776 75.8628 0.000116989 1.08873e-05 14\n",
+      "3.449960890183e+00 2.80457 95.2174 8.70668e-05 1.18914e-05 14\n",
+      "3.172196856333e+00 3.05193 119.51 6.47976e-05 1.29402e-05 14\n",
+      "3.069627290216e+00 3.27563 150 4.82242e-05 1.38887e-05 14\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"MY_STELLAR_DATA\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 4\n",
+    "            stardata->model.probability, // 5\n",
+    "            stardata->star[0].radius, // 6\n",
+    "            stardata->star[0].stellar_type // 7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 20}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2ab0979-6575-481d-9c1c-ca98517b2437",
+   "metadata": {},
+   "source": [
+    "We can also set up a population that samples biinary systems, by adding extra grid variables. Below is an example of a full script that runs a binary population and registers when a double compact object is formed. The logging is rather compact and should be expanded top be more useful"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "79acdbb2-7dd6-45c4-9609-80994f03619a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Grid has handled 125 stars\n",
+      "with a total probability of 0.0862478164626921\n",
+      "Total starcount for this run will be: 125\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Population-d20a4c74d20a43b881c0c9e5def5f76c finished! The total probability was: 0.08624781646269201. It took a total of 8.561265707015991s to run 125 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass_1 zams_mass_1 mass_2 zams_mass_2 stellar_type_1 prev_stellar_type_1 stellar_type_2 prev_stellar_type_2 metallicity probability\n",
+      "8.863377990313e+01 1.29444 5.88566 0 2.99283 13 5 15 15 0.02 0.000627913\n",
+      "1.146421815741e+02 0 5.88566 1.33062 4.43925 15 15 13 5 0.02 0.000627913\n",
+      "7.222715508467e+01 1.34922 5.88566 0 5.88566 13 5 15 15 0.02 0.000627913\n",
+      "1.350021848285e+01 1.48488 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171108213270e+01 1.53113 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171086983243e+01 1.53177 17.3205 0 0.1 13 9 15 15 0.02 0.000154349\n",
+      "1.170770599495e+01 1.53176 17.3205 0 4.40513 13 5 15 15 0.02 0.000172877\n",
+      "1.230407246199e+01 1.59499 17.3205 0 4.40513 13 5 15 15 0.02 0.000610573\n",
+      "1.108751340926e+01 1.70319 17.3205 0 8.71025 13 4 15 15 0.02 0.000610573\n",
+      "1.941017702765e+01 1.34903 17.3205 1.65097 8.71025 13 13 13 5 0.02 0.000172877\n",
+      "1.980988739731e+01 1.36979 17.3205 1.60808 8.71025 13 13 13 5 0.02 0.000121486\n",
+      "3.571858031651e+01 1.53174 17.3205 1.30504 8.71025 13 13 13 5 0.02 8.42148e-05\n",
+      "3.459153942631e+01 1.53176 17.3205 1.31004 8.71025 13 13 13 5 0.02 9.8162e-05\n",
+      "1.687368550125e+01 1.34937 17.3205 1.73856 13.0154 13 13 13 8 0.02 0.000172877\n",
+      "1.194842917007e+01 1.78096 17.3205 0 13.0154 13 8 15 15 0.02 0.000610573\n",
+      "1.733614170983e+01 1.53184 17.3205 1.42375 13.0154 13 13 13 5 0.02 9.8162e-05\n",
+      "1.723547465714e+01 1.38403 17.3205 1.71288 13.0154 13 13 13 8 0.02 0.000121486\n",
+      "1.764340254985e+01 1.53174 17.3205 1.41264 13.0154 13 13 13 5 0.02 8.42148e-05\n",
+      "1.170425790780e+01 1.52963 17.3205 0 17.3205 13 5 15 15 0.02 0.000172877\n",
+      "8.922967341481e+00 1.85486 17.3205 0 17.3205 13 8 15 15 0.02 0.000610573\n",
+      "1.232906623449e+01 1.41074 17.3205 1.34281 17.3205 13 13 13 8 0.02 0.000121486\n",
+      "1.170775828562e+01 1.53183 17.3205 1.53183 17.3205 13 5 13 5 0.02 9.8162e-05\n",
+      "1.170770422321e+01 1.53175 17.3205 1.53175 17.3205 13 5 13 5 0.02 8.42148e-05\n",
+      "5.075844624794e+00 2.12303 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.766606588165e+00 2.20484 50.9713 0 0.1 14 8 15 15 0.02 3.79411e-05\n",
+      "4.768305081494e+00 2.18838 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.458869865939e+00 2.29864 50.9713 0 12.8178 14 8 15 15 0.02 0.000150087\n",
+      "1.806014211040e+01 2.10446 50.9713 1.40749 12.8178 13 13 13 5 0.02 2.9863e-05\n",
+      "4.797342083485e+00 2.10328 50.9713 0 12.8178 13 13 15 1 0.02 4.24954e-05\n",
+      "1.721374713429e+01 2.21673 50.9713 1.42212 12.8178 14 14 13 5 0.02 2.41295e-05\n",
+      "4.055645404546e+00 2.47276 50.9713 0 25.5357 14 7 15 15 0.02 0.000150087\n",
+      "1.806123543037e+01 2.21893 50.9713 1.40745 12.8178 14 14 13 5 0.02 2.07011e-05\n",
+      "8.117519147635e+00 2.10433 50.9713 2.21473 25.5357 13 13 14 8 0.02 4.24954e-05\n",
+      "8.315554923168e+00 2.15343 50.9713 2.08519 25.5357 13 13 13 8 0.02 2.9863e-05\n",
+      "7.917420996633e+00 2.21892 50.9713 1.7431 25.5357 14 14 13 8 0.02 2.07011e-05\n",
+      "7.693213405973e+00 2.21805 50.9713 1.78384 25.5357 14 14 13 8 0.02 2.41295e-05\n",
+      "3.753837732894e+00 2.62517 50.9713 0 38.2535 14 7 15 15 0.02 0.000150087\n",
+      "7.087296558990e+00 2.10417 50.9713 2.40935 38.2535 13 13 14 8 0.02 4.24954e-05\n",
+      "7.007109286263e+00 2.15854 50.9713 2.28672 38.2535 13 13 14 8 0.02 2.9863e-05\n",
+      "5.653200958306e+00 2.21878 50.9713 2.0587 38.2535 14 14 13 8 0.02 2.41295e-05\n",
+      "5.733794947644e+00 2.21892 50.9713 1.99255 38.2535 14 14 13 8 0.02 2.07011e-05\n",
+      "3.513216011269e+00 2.76647 50.9713 0 50.9713 14 7 15 15 0.02 0.000150087\n",
+      "4.750574783854e+00 2.27442 50.9713 0 50.9713 14 8 15 15 0.02 4.24954e-05\n",
+      "7.278384712062e+00 1.29678 50.9713 2.09216 50.9713 13 8 13 13 0.02 2.9863e-05\n",
+      "4.765996194699e+00 2.20787 50.9713 2.20787 50.9713 14 8 14 8 0.02 2.07011e-05\n",
+      "4.765535914728e+00 2.21331 50.9713 2.21331 50.9713 14 8 14 8 0.02 2.41295e-05\n",
+      "3.104706358826e+00 3.17639 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.069363482023e+00 3.27572 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.047074050271e+00 3.3836 150 0 37.575 14 7 15 15 0.02 3.68933e-05\n",
+      "5.974759306305e+00 3.23604 150 2.53922 37.575 14 14 14 7 0.02 1.04459e-05\n",
+      "6.074084349384e+00 3.30145 150 2.13876 37.575 14 14 13 8 0.02 7.34071e-06\n",
+      "5.733865371895e+00 3.29994 150 2.00498 37.575 14 14 13 8 0.02 5.93135e-06\n",
+      "3.027099358410e+00 3.53631 150 0 75.05 14 7 15 15 0.02 3.68933e-05\n",
+      "5.807147339697e+00 3.30197 150 1.9791 37.575 14 14 13 8 0.02 5.08861e-06\n",
+      "4.862942347290e+00 3.25294 150 2.97823 75.05 14 14 14 7 0.02 1.04459e-05\n",
+      "4.556479830908e+00 3.29942 150 2.73221 75.05 14 14 14 7 0.02 7.34071e-06\n",
+      "3.853070305680e+00 3.29977 150 2.62486 75.05 14 14 14 7 0.02 5.93135e-06\n",
+      "3.881529045940e+00 3.30149 150 2.55924 75.05 14 14 14 7 0.02 5.08861e-06\n",
+      "3.015033359333e+00 3.64419 150 0 112.525 14 7 15 15 0.02 3.68933e-05\n",
+      "4.126828648362e+00 3.32047 150 0 112.525 14 14 15 3 0.02 1.04459e-05\n",
+      "3.990017992944e+00 3.3032 150 2.94027 112.525 14 14 14 7 0.02 7.34071e-06\n",
+      "3.206771867883e+00 3.07671 150 3.11282 112.525 14 14 14 7 0.02 5.93135e-06\n",
+      "3.006827156705e+00 3.72638 150 0 150 14 7 15 15 0.02 3.68933e-05\n",
+      "3.218786094847e+00 3.30337 150 3.01344 112.525 14 14 14 7 0.02 5.08861e-06\n",
+      "4.527722847382e+00 1.42238 150 0 150 13 5 15 15 0.02 1.04459e-05\n",
+      "3.069567332611e+00 3.27804 150 3.27804 150 14 7 14 7 0.02 5.93135e-06\n",
+      "5.726405299909e+00 1.29746 150 3.22759 150 13 8 14 14 0.02 7.34071e-06\n",
+      "3.069626478211e+00 3.27565 150 3.27565 150 14 7 14 7 0.02 5.08861e-06\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\n",
+    "        \"time\", \n",
+    "        \"mass_1\", \"zams_mass_1\", \"mass_2\", \"zams_mass_2\",\n",
+    "        \"stellar_type_1\", \"prev_stellar_type_1\", \"stellar_type_2\", \"prev_stellar_type_2\", \n",
+    "        \"metallicity\", \"probability\"\n",
+    "    ]\n",
+    "    \n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_DCO\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "// logger to find gravitational wave progenitors\n",
+    "if(stardata->star[0].stellar_type>=NS && stardata->star[1].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_DCO %30.12e \" // 1\n",
+    "            \"%g %g %g %g \" // 2-5\n",
+    "            \"%d %d %d %d \" // 6-9\n",
+    "            \"%g %g\\\\n\", // 10-11\n",
+    "\n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->common.zero_age.mass[0], //3\n",
+    "            stardata->star[1].mass, //4\n",
+    "            stardata->common.zero_age.mass[1], //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "            stardata->star[1].stellar_type, //8\n",
+    "            stardata->previous_stardata->star[1].stellar_type, //9\n",
+    "\n",
+    "            // model stuff\n",
+    "            stardata->common.metallicity, //10\n",
+    "            stardata->model.probability //11\n",
+    "        );\n",
+    "    }\n",
+    "    /* Kill the simulation to safe time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "}\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 5, \"q\": 5, \"per\": 5}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "# Mass ratio\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"q\",\n",
+    "    longname=\"Mass ratio\",\n",
+    "    valuerange=[\"0.1/M_1\", 1],\n",
+    "    resolution=\"{}\".format(resolution['q']),\n",
+    "    spacingfunc=\"const(0.1/M_1, 1, {})\".format(resolution['q']),\n",
+    "    probdist=\"flatsections(q, [{'min': 0.1/M_1, 'max': 1.0, 'height': 1}])\",\n",
+    "    dphasevol=\"dq\",\n",
+    "    precode=\"M_2 = q * M_1\",\n",
+    "    parameter_name=\"M_2\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "example_pop.add_grid_variable(\n",
+    "   name=\"log10per\", # in days\n",
+    "   longname=\"log10(Orbital_Period)\",\n",
+    "   valuerange=[0.15, 5.5],\n",
+    "   resolution=\"{}\".format(resolution[\"per\"]),\n",
+    "   spacingfunc=\"const(0.15, 5.5, {})\".format(resolution[\"per\"]),\n",
+    "   precode=\"\"\"orbital_period = 10** log10per\n",
+    "sep = calc_sep_from_period(M_1, M_2, orbital_period)\n",
+    "sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)\n",
+    "sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)\"\"\",\n",
+    "   probdist=\"sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)\",\n",
+    "   parameter_name=\"orbital_period\",\n",
+    "   dphasevol=\"dlog10per\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
   }
  ],
  "metadata": {
diff --git a/docs/build/html/notebooks.html b/docs/build/html/notebooks.html
deleted file mode 100644
index ab64c80a4..000000000
--- a/docs/build/html/notebooks.html
+++ /dev/null
@@ -1,269 +0,0 @@
-
-
-<!DOCTYPE html>
-<html class="writer-html5" lang="en" >
-<head>
-  <meta charset="utf-8">
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <title>Notebooks &mdash; binary_c-python  documentation</title>
-  
-
-  
-  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
-  
-  
-  
-  
-
-  
-  <!--[if lt IE 9]>
-    <script src="_static/js/html5shiv.min.js"></script>
-  <![endif]-->
-  
-    
-      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
-        <script src="_static/jquery.js"></script>
-        <script src="_static/underscore.js"></script>
-        <script src="_static/doctools.js"></script>
-        <script src="_static/language_data.js"></script>
-        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
-        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
-    
-    <script type="text/javascript" src="_static/js/theme.js"></script>
-
-    
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Title page" href="notebook_population.html" />
-    <link rel="prev" title="Example of population script" href="population_example.html" /> 
-</head>
-
-<body class="wy-body-for-nav">
-
-   
-  <div class="wy-grid-for-nav">
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
-      <div class="wy-side-scroll">
-        <div class="wy-side-nav-search" >
-          
-
-          
-            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
-          
-
-          
-          </a>
-
-          
-            
-            
-          
-
-          
-<div role="search">
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
-    <input type="text" name="q" placeholder="Search docs" />
-    <input type="hidden" name="check_keywords" value="yes" />
-    <input type="hidden" name="area" value="default" />
-  </form>
-</div>
-
-          
-        </div>
-
-        
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
-<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="general_examples.html">Examples</a></li>
-<li class="toctree-l2"><a class="reference internal" href="population_example.html">Example of population script</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Notebooks</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="notebook_population.html">Title page</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
-</ul>
-
-            
-          
-        </div>
-        
-      </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" aria-label="top navigation">
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href="index.html">binary_c-python</a>
-        
-      </nav>
-
-
-      <div class="wy-nav-content">
-        
-        <div class="rst-content">
-        
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<div role="navigation" aria-label="breadcrumbs navigation">
-
-  <ul class="wy-breadcrumbs">
-    
-      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
-        
-          <li><a href="examples.html">Examples</a> &raquo;</li>
-        
-      <li>Notebooks</li>
-    
-    
-      <li class="wy-breadcrumbs-aside">
-        
-            
-            <a href="_sources/notebooks.rst.txt" rel="nofollow"> View page source</a>
-          
-        
-      </li>
-    
-  </ul>
-
-  
-  <hr/>
-</div>
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-           <div itemprop="articleBody">
-            
-  
-<style>
-/* CSS overrides for sphinx_rtd_theme */
-
-/* 24px margin */
-.nbinput.nblast.container,
-.nboutput.nblast.container {
-    margin-bottom: 19px;  /* padding has already 5px */
-}
-
-/* ... except between code cells! */
-.nblast.container + .nbinput.container {
-    margin-top: -19px;
-}
-
-.admonition > p:before {
-    margin-right: 4px;  /* make room for the exclamation icon */
-}
-
-/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
-.math {
-    text-align: unset;
-}
-</style>
-<div class="section" id="notebooks">
-<h1>Notebooks<a class="headerlink" href="#notebooks" title="Permalink to this headline">¶</a></h1>
-<p>The notebooks.</p>
-<div class="toctree-wrapper compound">
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="notebook_population.html">Title page</a></li>
-</ul>
-</div>
-</div>
-
-
-           </div>
-           
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
-        <a href="notebook_population.html" class="btn btn-neutral float-right" title="Title page" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
-      
-      
-        <a href="population_example.html" class="btn btn-neutral float-left" title="Example of population script" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
-      
-    </div>
-  
-
-  <hr/>
-
-  <div role="contentinfo">
-    <p>
-        
-        &copy; Copyright 2021, David Hendriks, Robert Izzard
-
-    </p>
-  </div>
-    
-    
-    
-    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
-    
-    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
-    
-    provided by <a href="https://readthedocs.org">Read the Docs</a>.
-<br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
-<br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
-
-
-
-</footer>
-
-        </div>
-      </div>
-
-    </section>
-
-  </div>
-  
-
-  <script type="text/javascript">
-      jQuery(function () {
-          SphinxRtdTheme.Navigation.enable(true);
-      });
-  </script>
-
-  
-  
-    
-   
-
-</body>
-</html>
\ No newline at end of file
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
index 4cb6e0762a38b40838d01448dffae4e83435d428..64b1bdec6107c14e1aaf414394169a9a20c202b8 100644
GIT binary patch
delta 5271
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

delta 4661
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

diff --git a/docs/build/html/plot_functions.html b/docs/build/html/plot_functions.html
index b6caf948e..d8955d789 100644
--- a/docs/build/html/plot_functions.html
+++ b/docs/build/html/plot_functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -473,9 +473,9 @@ This is not included in all the plotting routines.</p></li>
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/population_example.html b/docs/build/html/population_example.html
deleted file mode 100644
index 354a84148..000000000
--- a/docs/build/html/population_example.html
+++ /dev/null
@@ -1,665 +0,0 @@
-
-
-<!DOCTYPE html>
-<html class="writer-html5" lang="en" >
-<head>
-  <meta charset="utf-8">
-  
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <title>Example of population script &mdash; binary_c-python  documentation</title>
-  
-
-  
-  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
-  
-  
-  
-  
-
-  
-  <!--[if lt IE 9]>
-    <script src="_static/js/html5shiv.min.js"></script>
-  <![endif]-->
-  
-    
-      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
-        <script src="_static/jquery.js"></script>
-        <script src="_static/underscore.js"></script>
-        <script src="_static/doctools.js"></script>
-        <script src="_static/language_data.js"></script>
-        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-        <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
-        <script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
-    
-    <script type="text/javascript" src="_static/js/theme.js"></script>
-
-    
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Notebooks" href="notebooks.html" />
-    <link rel="prev" title="Examples" href="general_examples.html" /> 
-</head>
-
-<body class="wy-body-for-nav">
-
-   
-  <div class="wy-grid-for-nav">
-    
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
-      <div class="wy-side-scroll">
-        <div class="wy-side-nav-search" >
-          
-
-          
-            <a href="index.html" class="icon icon-home" alt="Documentation Home"> binary_c-python
-          
-
-          
-          </a>
-
-          
-            
-            
-          
-
-          
-<div role="search">
-  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
-    <input type="text" name="q" placeholder="Search docs" />
-    <input type="hidden" name="check_keywords" value="yes" />
-    <input type="hidden" name="area" value="default" />
-  </form>
-</div>
-
-          
-        </div>
-
-        
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-          
-            
-            
-              
-            
-            
-              <p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
-<li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="examples.html">Examples</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="general_examples.html">Examples</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Example of population script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="notebooks.html">Notebooks</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/issues/new">Submit an issue</a></li>
-</ul>
-
-            
-          
-        </div>
-        
-      </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" aria-label="top navigation">
-        
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href="index.html">binary_c-python</a>
-        
-      </nav>
-
-
-      <div class="wy-nav-content">
-        
-        <div class="rst-content">
-        
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<div role="navigation" aria-label="breadcrumbs navigation">
-
-  <ul class="wy-breadcrumbs">
-    
-      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
-        
-          <li><a href="examples.html">Examples</a> &raquo;</li>
-        
-      <li>Example of population script</li>
-    
-    
-      <li class="wy-breadcrumbs-aside">
-        
-            
-            <a href="_sources/population_example.rst.txt" rel="nofollow"> View page source</a>
-          
-        
-      </li>
-    
-  </ul>
-
-  
-  <hr/>
-</div>
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-           <div itemprop="articleBody">
-            
-  
-<style>
-/* CSS overrides for sphinx_rtd_theme */
-
-/* 24px margin */
-.nbinput.nblast.container,
-.nboutput.nblast.container {
-    margin-bottom: 19px;  /* padding has already 5px */
-}
-
-/* ... except between code cells! */
-.nblast.container + .nbinput.container {
-    margin-top: -19px;
-}
-
-.admonition > p:before {
-    margin-right: 4px;  /* make room for the exclamation icon */
-}
-
-/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
-.math {
-    text-align: unset;
-}
-</style>
-<div class="section" id="example-of-population-script">
-<h1>Example of population script<a class="headerlink" href="#example-of-population-script" title="Permalink to this headline">¶</a></h1>
-<p>The source code of a script to run a population of stars.</p>
-<div class="highlight-python notranslate"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>  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
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
-100
-101
-102
-103
-104
-105
-106
-107
-108
-109
-110
-111
-112
-113
-114
-115
-116
-117
-118
-119
-120
-121
-122
-123
-124
-125
-126
-127
-128
-129
-130
-131
-132
-133
-134
-135
-136
-137
-138
-139
-140
-141
-142
-143
-144
-145
-146
-147
-148
-149
-150
-151
-152
-153
-154
-155
-156
-157
-158
-159
-160
-161
-162
-163
-164
-165
-166
-167
-168
-169
-170
-171
-172
-173
-174
-175
-176
-177
-178
-179
-180
-181
-182
-183
-184
-185
-186
-187
-188
-189
-190
-191
-192
-193
-194
-195
-196
-197
-198
-199
-200
-201
-202</pre></div></td><td class="code"><div class="highlight"><pre><span></span>
-
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.grid</span> <span class="kn">import</span> <span class="n">Population</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.functions</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">get_help_all</span><span class="p">,</span>
-    <span class="n">get_help</span><span class="p">,</span>
-    <span class="n">create_hdf5</span><span class="p">,</span>
-    <span class="n">output_lines</span><span class="p">,</span>
-<span class="p">)</span>
-<span class="kn">from</span> <span class="nn">binarycpython.utils.custom_logging_functions</span> <span class="kn">import</span> <span class="n">temp_dir</span>
-
-<span class="c1">#########################################################</span>
-<span class="c1"># This file serves as an example for running a population.</span>
-<span class="c1"># The use of help(&lt;function&gt;) is a good way to inspect what parameters are there to use</span>
-<span class="c1">#########################################################</span>
-
-
-<span class="k">def</span> <span class="nf">parse_function</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output</span><span class="p">):</span>
-    <span class="c1"># EXAMPLE PARSE_FUNCTION</span>
-
-    <span class="c1"># extract info from the population instance</span>
-
-    <span class="c1"># Get some information from the</span>
-    <span class="n">data_dir</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">]</span>
-    <span class="n">base_filename</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;base_filename&quot;</span><span class="p">]</span>
-
-    <span class="c1"># Check directory, make if necessary</span>
-    <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-    <span class="n">seperator</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span>
-
-    <span class="c1"># Create filename</span>
-    <span class="n">outfilename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data_dir</span><span class="p">,</span> <span class="n">base_filename</span><span class="p">)</span>
-
-    <span class="n">parameters</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;mass&quot;</span><span class="p">,</span> <span class="s2">&quot;zams_mass&quot;</span><span class="p">,</span> <span class="s2">&quot;probability&quot;</span><span class="p">,</span> <span class="s2">&quot;radius&quot;</span><span class="p">,</span> <span class="s2">&quot;stellar_type&quot;</span><span class="p">]</span>
-
-    <span class="c1"># Go over the output.</span>
-    <span class="k">for</span> <span class="n">el</span> <span class="ow">in</span> <span class="n">output_lines</span><span class="p">(</span><span class="n">output</span><span class="p">):</span>
-        <span class="n">headerline</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
-
-        <span class="c1"># CHeck the header and act accordingly</span>
-        <span class="k">if</span> <span class="n">headerline</span> <span class="o">==</span> <span class="s2">&quot;MY_STELLAR_DATA&quot;</span><span class="p">:</span>
-            <span class="n">values</span> <span class="o">=</span> <span class="n">el</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">1</span><span class="p">:]</span>
-            <span class="nb">print</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-
-            <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">):</span>
-                <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Amount of column names isnt equal to amount of columns&quot;</span><span class="p">)</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span>
-
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">outfilename</span><span class="p">):</span>
-                <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-                    <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parameters</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-
-            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">outfilename</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">seperator</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">values</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-
-
-<span class="c1"># Create population object</span>
-<span class="n">example_pop</span> <span class="o">=</span> <span class="n">Population</span><span class="p">()</span>
-
-<span class="c1"># If you want verbosity, set this before other things</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">verbose</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
-
-<span class="c1"># Setting values can be done via .set(&lt;parameter_name&gt;=&lt;value&gt;)</span>
-<span class="c1"># Values that are known to be binary_c_parameters are loaded into bse_options.</span>
-<span class="c1"># Those that are present in the default grid_options are set in grid_options</span>
-<span class="c1"># All other values that you set are put in a custom_options dict</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
-    <span class="c1"># binary_c physics options</span>
-    <span class="n">M_1</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="n">separation</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="n">orbital_period</span><span class="o">=</span><span class="mi">45000000080</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="n">max_evolution_time</span><span class="o">=</span><span class="mi">15000</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="n">eccentricity</span><span class="o">=</span><span class="mf">0.02</span><span class="p">,</span>  <span class="c1"># bse_options</span>
-    <span class="c1"># Set companion to low mass</span>
-    <span class="n">M_2</span><span class="o">=</span><span class="mf">0.08</span><span class="p">,</span>  <span class="c1"># Since in the example we run a single system, we should set the companion mass here. If we donm&#39;t do this, the code will complain.</span>
-    <span class="c1"># grid_options</span>
-    <span class="n">amt_cores</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>  <span class="c1"># grid_options</span>
-    <span class="n">verbose</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>  <span class="c1"># verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff</span>
-    <span class="c1"># Custom options # TODO: need to be set in grid_options probably</span>
-    <span class="n">data_dir</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
-        <span class="n">temp_dir</span><span class="p">(),</span> <span class="s2">&quot;example_python_population_result&quot;</span>
-    <span class="p">),</span>  <span class="c1"># custom_options</span>
-    <span class="n">base_filename</span><span class="o">=</span><span class="s2">&quot;example_pop.dat&quot;</span><span class="p">,</span>  <span class="c1"># custom_options</span>
-<span class="p">)</span>
-
-<span class="c1"># Creating a parsing function</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
-    <span class="n">parse_function</span><span class="o">=</span><span class="n">parse_function</span><span class="p">,</span>  <span class="c1"># Setting the parse function thats used in the evolve_population</span>
-<span class="p">)</span>
-
-<span class="c1">### Custom logging</span>
-
-<span class="c1">## Below example requires changing the parse function</span>
-<span class="c1">## very simple example of custom logging. Will work but need to change the parse function to handle that nicely.</span>
-<span class="c1"># example_pop.set(</span>
-<span class="c1">#     C_auto_logging={</span>
-<span class="c1">#         &quot;MY_HEADER_LINE&quot;: [&quot;star[0].mass&quot;, &quot;star[1].mass&quot;, &quot;model.probability&quot;]</span>
-<span class="c1">#     }</span>
-<span class="c1"># )</span>
-
-
-<span class="c1"># Log the moment when the star turns into neutron</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">set</span><span class="p">(</span>
-    <span class="n">C_logging_code</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;</span>
-<span class="s2">if(stardata-&gt;star[0].stellar_type &gt;= 13)    </span>
-<span class="s2">{</span>
-<span class="s2">    if (stardata-&gt;model.time &lt; stardata-&gt;model.max_evolution_time)</span>
-<span class="s2">    {</span>
-<span class="s2">        Printf(&quot;MY_STELLAR_DATA </span><span class="si">%30.12e</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%g</span><span class="s2"> </span><span class="si">%d</span><span class="se">\\</span><span class="s2">n&quot;,</span>
-<span class="s2">            // </span>
-<span class="s2">            stardata-&gt;model.time, // 1</span>
-<span class="s2">            stardata-&gt;star[0].mass, // 2</span>
-<span class="s2">            stardata-&gt;common.zero_age.mass[0], // 4</span>
-<span class="s2">            stardata-&gt;model.probability, // 5</span>
-<span class="s2">            stardata-&gt;star[0].radius, // 6</span>
-<span class="s2">            stardata-&gt;star[0].stellar_type // 7</span>
-<span class="s2">      );</span>
-<span class="s2">    };</span>
-<span class="s2">    /* Kill the simulation to save time */</span>
-<span class="s2">    stardata-&gt;model.max_evolution_time = stardata-&gt;model.time - stardata-&gt;model.dtm;</span>
-<span class="s2">};</span>
-<span class="s2">&quot;&quot;&quot;</span>
-<span class="p">)</span>
-
-<span class="c1"># Add grid variables</span>
-<span class="n">resolution</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;M_1&quot;</span><span class="p">:</span> <span class="mi">20</span><span class="p">,</span> <span class="s2">&quot;q&quot;</span><span class="p">:</span> <span class="mi">20</span><span class="p">,</span> <span class="s2">&quot;per&quot;</span><span class="p">:</span> <span class="mi">40</span><span class="p">}</span>
-
-<span class="c1"># Mass</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">add_grid_variable</span><span class="p">(</span>
-    <span class="n">name</span><span class="o">=</span><span class="s2">&quot;lnm1&quot;</span><span class="p">,</span>
-    <span class="n">longname</span><span class="o">=</span><span class="s2">&quot;Primary mass&quot;</span><span class="p">,</span>
-    <span class="n">valuerange</span><span class="o">=</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">150</span><span class="p">],</span>
-    <span class="n">resolution</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
-    <span class="n">spacingfunc</span><span class="o">=</span><span class="s2">&quot;const(math.log(2), math.log(150), </span><span class="si">{}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">resolution</span><span class="p">[</span><span class="s2">&quot;M_1&quot;</span><span class="p">]),</span>
-    <span class="n">precode</span><span class="o">=</span><span class="s2">&quot;M_1=math.exp(lnm1)&quot;</span><span class="p">,</span>
-    <span class="n">probdist</span><span class="o">=</span><span class="s2">&quot;three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1&quot;</span><span class="p">,</span>
-    <span class="n">dphasevol</span><span class="o">=</span><span class="s2">&quot;dlnm1&quot;</span><span class="p">,</span>
-    <span class="n">parameter_name</span><span class="o">=</span><span class="s2">&quot;M_1&quot;</span><span class="p">,</span>
-    <span class="n">condition</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>  <span class="c1"># Impose a condition on this grid variable. Mostly for a check for yourself</span>
-<span class="p">)</span>
-
-<span class="c1"># # Mass ratio</span>
-<span class="c1"># test_pop.add_grid_variable(</span>
-<span class="c1">#     name=&quot;q&quot;,</span>
-<span class="c1">#     longname=&quot;Mass ratio&quot;,</span>
-<span class="c1">#     valuerange=[&quot;0.1/M_1&quot;, 1],</span>
-<span class="c1">#     resolution=&quot;{}&quot;.format(resolution[&#39;q&#39;]),</span>
-<span class="c1">#     spacingfunc=&quot;const(0.1/M_1, 1, {})&quot;.format(resolution[&#39;q&#39;]),</span>
-<span class="c1">#     probdist=&quot;flatsections(q, [{&#39;min&#39;: 0.1/M_1, &#39;max&#39;: 1.0, &#39;height&#39;: 1}])&quot;,</span>
-<span class="c1">#     dphasevol=&quot;dq&quot;,</span>
-<span class="c1">#     precode=&quot;M_2 = q * M_1&quot;,</span>
-<span class="c1">#     parameter_name=&quot;M_2&quot;,</span>
-<span class="c1">#     condition=&quot;&quot;,  # Impose a condition on this grid variable. Mostly for a check for yourself</span>
-<span class="c1"># )</span>
-
-<span class="c1"># #</span>
-<span class="c1"># test_pop.add_grid_variable(</span>
-<span class="c1">#    name=&quot;log10per&quot;, # in days</span>
-<span class="c1">#    longname=&quot;log10(Orbital_Period)&quot;,</span>
-<span class="c1">#    valuerange=[0.15, 5.5],</span>
-<span class="c1">#    resolution=&quot;{}&quot;.format(resolution[&quot;per&quot;]),</span>
-<span class="c1">#    spacingfunc=&quot;const(0.15, 5.5, {})&quot;.format(resolution[&quot;per&quot;]),</span>
-<span class="c1">#    precode=&quot;&quot;&quot;orbital_period = 10** log10per</span>
-<span class="c1"># sep = calc_sep_from_period(M_1, M_2, orbital_period)</span>
-<span class="c1"># sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)</span>
-<span class="c1"># sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)&quot;&quot;&quot;,</span>
-<span class="c1">#    probdist=&quot;sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)&quot;,</span>
-<span class="c1">#    parameter_name=&quot;orbital_period&quot;,</span>
-<span class="c1">#    dphasevol=&quot;dlog10per&quot;,</span>
-<span class="c1"># )</span>
-
-
-<span class="c1"># Exporting of all the settings can be done with .export_all_info()</span>
-<span class="c1"># on default it exports everything, but can be supressed by turning it off:</span>
-<span class="c1">#   population settings (bse_options, grid_options, custom_options), turn off with include_population</span>
-<span class="c1">#       settings=False</span>
-<span class="c1">#   binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).</span>
-<span class="c1">#       turn off with include_binary_c_defaults=False</span>
-<span class="c1">#   include_binary_c_version_info (all the compilation info, and information about the compiled</span>
-<span class="c1">#       parameters), turn off with include_binary_c_version_info=False</span>
-<span class="c1">#   include_binary_c_help_all (all the help information for all the binary_c parameters),</span>
-<span class="c1">#       turn off with include_binary_c_help_all=Fase</span>
-<span class="c1"># On default it will write this to the custom_options[&#39;data_dir&#39;], but that can be overriden by</span>
-<span class="c1">#   setting use_datadir=False and providing an outfile=&lt;&gt;</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">export_all_info</span><span class="p">()</span>
-
-<span class="c1">## Executing a single system</span>
-<span class="c1">## This uses the M_1 orbital period etc set with the set function</span>
-<span class="c1"># output = example_pop.evolve_single()</span>
-<span class="c1"># print(output)</span>
-
-<span class="c1">## Executing a population</span>
-<span class="c1">## This uses the values generated by the grid_variables</span>
-<span class="n">example_pop</span><span class="o">.</span><span class="n">evolve</span><span class="p">()</span>  <span class="c1"># TODO: update this function call</span>
-
-<span class="c1"># Wrapping up the results to an hdf5 file can be done by using the create_hdf5</span>
-<span class="c1"># (&lt;directory containing data and settings&gt;) This function takes the settings file</span>
-<span class="c1"># (ending in _settings.json) and the data files (ending in .dat) from the data_dir</span>
-<span class="c1"># and packing them into an hdf5 file, which is then written into the same data_dir directory</span>
-<span class="n">create_hdf5</span><span class="p">(</span><span class="n">data_dir</span><span class="o">=</span><span class="n">example_pop</span><span class="o">.</span><span class="n">custom_options</span><span class="p">[</span><span class="s2">&quot;data_dir&quot;</span><span class="p">],</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;example_pop.hdf5&quot;</span><span class="p">)</span>
-</pre></div>
-</td></tr></table></div>
-</div>
-
-
-           </div>
-           
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
-        <a href="notebooks.html" class="btn btn-neutral float-right" title="Notebooks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
-      
-      
-        <a href="general_examples.html" class="btn btn-neutral float-left" title="Examples" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
-      
-    </div>
-  
-
-  <hr/>
-
-  <div role="contentinfo">
-    <p>
-        
-        &copy; Copyright 2021, David Hendriks, Robert Izzard
-
-    </p>
-  </div>
-    
-    
-    
-    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
-    
-    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
-    
-    provided by <a href="https://readthedocs.org">Read the Docs</a>.
-<br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
-<br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
-
-
-
-</footer>
-
-        </div>
-      </div>
-
-    </section>
-
-  </div>
-  
-
-  <script type="text/javascript">
-      jQuery(function () {
-          SphinxRtdTheme.Navigation.enable(true);
-      });
-  </script>
-
-  
-  
-    
-   
-
-</body>
-</html>
\ No newline at end of file
diff --git a/docs/build/html/py-modindex.html b/docs/build/html/py-modindex.html
index eb74bf0b4..43da11415 100644
--- a/docs/build/html/py-modindex.html
+++ b/docs/build/html/py-modindex.html
@@ -90,7 +90,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -255,9 +255,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/readme_link.html b/docs/build/html/readme_link.html
index e97273eb0..b846653c6 100644
--- a/docs/build/html/readme_link.html
+++ b/docs/build/html/readme_link.html
@@ -105,7 +105,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -334,9 +334,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/run_system_wrapper.html b/docs/build/html/run_system_wrapper.html
index 6a5470eb0..eb8f48aba 100644
--- a/docs/build/html/run_system_wrapper.html
+++ b/docs/build/html/run_system_wrapper.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -283,9 +283,9 @@ and returns what the parse_function returns</p>
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/search.html b/docs/build/html/search.html
index fe5703366..e620701e4 100644
--- a/docs/build/html/search.html
+++ b/docs/build/html/search.html
@@ -89,7 +89,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="readme_link.html">Python module for binary_c</a></li>
 <li class="toctree-l1"><a class="reference internal" href="modules.html">Binarycpython code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -194,9 +194,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js
index e8f9060ba..f40eeb8bc 100644
--- a/docs/build/html/searchindex.js
+++ b/docs/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["binary_c_parameters","custom_logging_functions","distribution_functions","examples","functions","general_examples","grid","grid_options_defaults","grid_options_descriptions","hpc_functions","index","modules","notebook_population","notebooks","plot_functions","population_example","readme_link","run_system_wrapper","spacing_functions","stellar_types","useful_funcs"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,"sphinx.ext.viewcode":1,nbsphinx:3,sphinx:56},filenames:["binary_c_parameters.rst","custom_logging_functions.rst","distribution_functions.rst","examples.rst","functions.rst","general_examples.rst","grid.rst","grid_options_defaults.rst","grid_options_descriptions.rst","hpc_functions.rst","index.rst","modules.rst","notebook_population.ipynb","notebooks.rst","plot_functions.rst","population_example.rst","readme_link.rst","run_system_wrapper.rst","spacing_functions.rst","stellar_types.rst","useful_funcs.rst"],objects:{"binarycpython.utils":{custom_logging_functions:[1,0,0,"-"],distribution_functions:[2,0,0,"-"],functions:[4,0,0,"-"],grid:[6,0,0,"-"],grid_options_defaults:[7,0,0,"-"],hpc_functions:[9,0,0,"-"],plot_functions:[14,0,0,"-"],run_system_wrapper:[17,0,0,"-"],spacing_functions:[18,0,0,"-"],stellar_types:[19,0,0,"-"],useful_funcs:[20,0,0,"-"]},"binarycpython.utils.custom_logging_functions":{autogen_C_logging_code:[1,1,1,""],binary_c_log_code:[1,1,1,""],binary_c_write_log_code:[1,1,1,""],compile_shared_lib:[1,1,1,""],create_and_load_logging_function:[1,1,1,""],from_binary_c_config:[1,1,1,""],return_compilation_dict:[1,1,1,""]},"binarycpython.utils.distribution_functions":{"const":[2,1,1,""],Arenou2010_binary_fraction:[2,1,1,""],Izzard2012_period_distribution:[2,1,1,""],Kroupa2001:[2,1,1,""],Moe_di_Stefano_2017_multiplicity_fractions:[2,1,1,""],Moe_di_Stefano_2017_pdf:[2,1,1,""],build_q_table:[2,1,1,""],calc_P_integral:[2,1,1,""],calc_e_integral:[2,1,1,""],calc_total_probdens:[2,1,1,""],calculate_constants_three_part_powerlaw:[2,1,1,""],cosmic_SFH_madau_dickinson2014:[2,1,1,""],duquennoy1991:[2,1,1,""],fill_data:[2,1,1,""],flat:[2,1,1,""],flatsections:[2,1,1,""],gaussian:[2,1,1,""],gaussian_func:[2,1,1,""],gaussian_normalizing_const:[2,1,1,""],get_integration_constant_q:[2,1,1,""],get_max_multiplicity:[2,1,1,""],imf_chabrier2003:[2,1,1,""],imf_scalo1986:[2,1,1,""],imf_scalo1998:[2,1,1,""],imf_tinsley1980:[2,1,1,""],interpolate_in_mass_izzard2012:[2,1,1,""],ktg93:[2,1,1,""],linear_extrapolation_q:[2,1,1,""],merge_multiplicities:[2,1,1,""],normalize_dict:[2,1,1,""],number:[2,1,1,""],poisson:[2,1,1,""],powerlaw:[2,1,1,""],powerlaw_constant:[2,1,1,""],powerlaw_extrapolation_q:[2,1,1,""],prepare_dict:[2,1,1,""],raghavan2010_binary_fraction:[2,1,1,""],sana12:[2,1,1,""],set_opts:[2,1,1,""],three_part_powerlaw:[2,1,1,""]},"binarycpython.utils.functions":{BinaryCEncoder:[4,2,1,""],Capturing:[4,2,1,""],binarycDecoder:[4,2,1,""],binaryc_json_serializer:[4,1,1,""],call_binary_c_config:[4,1,1,""],catchtime:[4,2,1,""],convert_bytes:[4,1,1,""],count_keys_recursive:[4,1,1,""],create_arg_string:[4,1,1,""],create_hdf5:[4,1,1,""],custom_sort_dict:[4,1,1,""],example_parse_output:[4,1,1,""],extract_ensemble_json_from_string:[4,1,1,""],filter_arg_dict:[4,1,1,""],get_arg_keys:[4,1,1,""],get_defaults:[4,1,1,""],get_help:[4,1,1,""],get_help_all:[4,1,1,""],get_help_super:[4,1,1,""],get_moe_di_stefano_dataset:[4,1,1,""],get_size:[4,1,1,""],handle_ensemble_string_to_json:[4,1,1,""],imports:[4,1,1,""],inspect_dict:[4,1,1,""],is_capsule:[4,1,1,""],load_logfile:[4,1,1,""],make_build_text:[4,1,1,""],merge_dicts:[4,1,1,""],multiply_values_dict:[4,1,1,""],output_lines:[4,1,1,""],parse_binary_c_version_info:[4,1,1,""],recursive_change_key_to_float:[4,1,1,""],recursive_change_key_to_string:[4,1,1,""],remove_file:[4,1,1,""],return_binary_c_version_info:[4,1,1,""],subtract_dicts:[4,1,1,""],temp_dir:[4,1,1,""],update_dicts:[4,1,1,""],verbose_print:[4,1,1,""],write_binary_c_parameter_descriptions_to_rst_file:[4,1,1,""]},"binarycpython.utils.functions.BinaryCEncoder":{"default":[4,3,1,""]},"binarycpython.utils.functions.Capturing":{__enter__:[4,3,1,""],__exit__:[4,3,1,""]},"binarycpython.utils.functions.binarycDecoder":{decode:[4,3,1,""]},"binarycpython.utils.functions.catchtime":{__enter__:[4,3,1,""],__exit__:[4,3,1,""]},"binarycpython.utils.grid":{Population:[6,2,1,""]},"binarycpython.utils.grid.Population":{Moe_di_Stefano_2017:[6,3,1,""],add_grid_variable:[6,3,1,""],evolve:[6,3,1,""],evolve_population:[6,3,1,""],evolve_single:[6,3,1,""],export_all_info:[6,3,1,""],format_ensemble_results:[6,3,1,""],get_stream_logger:[6,3,1,""],last_grid_variable:[6,3,1,""],parse_cmdline:[6,3,1,""],return_all_info:[6,3,1,""],return_population_settings:[6,3,1,""],set:[6,3,1,""],set_moe_di_stefano_settings:[6,3,1,""],system_queue_filler:[6,3,1,""],write_binary_c_calls_to_file:[6,3,1,""]},"binarycpython.utils.grid_options_defaults":{grid_options_description_checker:[7,1,1,""],grid_options_help:[7,1,1,""],print_option_descriptions:[7,1,1,""],write_grid_options_to_rst_file:[7,1,1,""]},"binarycpython.utils.plot_functions":{color_by_index:[14,1,1,""],dummy:[14,1,1,""],parse_function_hr_diagram:[14,1,1,""],parse_function_masses:[14,1,1,""],parse_function_orbit:[14,1,1,""],plot_HR_diagram:[14,1,1,""],plot_masses:[14,1,1,""],plot_orbit:[14,1,1,""],plot_system:[14,1,1,""]},"binarycpython.utils.run_system_wrapper":{run_system:[17,1,1,""]},"binarycpython.utils.spacing_functions":{"const":[18,1,1,""]},"binarycpython.utils.useful_funcs":{calc_period_from_sep:[20,1,1,""],calc_sep_from_period:[20,1,1,""],maximum_mass_ratio_for_RLOF:[20,1,1,""],minimum_period_for_RLOF:[20,1,1,""],minimum_separation_for_RLOF:[20,1,1,""],ragb:[20,1,1,""],roche_lobe:[20,1,1,""],rzams:[20,1,1,""],zams_collision:[20,1,1,""]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"],"2":["py","class","Python class"],"3":["py","method","Python method"]},objtypes:{"0":"py:module","1":"py:function","2":"py:class","3":"py:method"},terms:{"0001":20,"0007":2,"001":0,"002":5,"054":2,"0820":0,"08msun":0,"0902":0,"100":[0,2],"1000":[5,8],"100000000000":5,"115":2,"125":0,"12500":0,"12e":[1,12,15],"13e3":0,"1403":2,"150":[12,15],"15000":[0,5,12,15],"15msun":2,"190":0,"1951":0,"1972":0,"1975":0,"197x":0,"1980":2,"1983":20,"1986":[0,2],"1989":0,"1991":2,"1993":0,"1996":20,"1998":[0,2],"1999":0,"1ckzg0p9":[10,16],"1e2":0,"1e9":0,"200":0,"2000":0,"2001":2,"2002":0,"2003":[0,2],"2004":0,"2005":0,"2009":0,"2010":[0,2,8],"2012":[0,2],"2013":0,"2014":[0,2],"2015":0,"2016":0,"2017":[0,8],"2018":[0,1],"2019":0,"2020":0,"2021":0,"20210727":0,"257":20,"25msun":0,"281":20,"2969346":2,"2msun":0,"3000":0,"30e4":0,"33526":12,"3msun":2,"4000":0,"42msun":0,"44msun":0,"45000000080":[12,15],"4530":5,"45msun":0,"4e3":0,"500":0,"5msun":0,"600000":0,"6068":0,"625":0,"6944":0,"6e1":2,"6e5":0,"6msun":0,"72498e":12,"7619":0,"763":2,"773586668293e":12,"78125":0,"795":2,"80msol":2,"8955b541d":0,"boolean":[0,4,6,8,14,20],"break":0,"case":[0,4,8],"catch":[4,5,8],"char":8,"class":[4,6],"const":[2,6,12,15,18],"default":[0,1,2,4,5,6,7,8,12,15,17],"export":[4,6,12,15],"float":[0,2,4,18,20],"function":[0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,20],"import":[4,5,6,12,15],"int":[0,1,2,4,6,7,8,18,20],"long":[0,4,6,8,19],"new":[0,2,4,6],"null":[0,4],"paczy\u0144ski":0,"public":[7,10],"return":[1,2,4,6,7,8,14,17,18,20],"short":[0,19],"super":0,"switch":0,"throw":[10,16],"true":[0,4,6,7,8,12,14,15],"try":[0,6,10,16],"while":0,Adding:12,And:[7,10,16,20],For:[0,4,10,14,16],Gas:0,Its:8,NOT:[0,6,17],Not:[8,12,15],One:0,Pms:14,That:0,The:[0,1,2,4,5,6,8,10,12,13,14,15,16,17],Then:[4,10,16],There:[2,5,6,7,8,14],These:[4,8,14],Use:[0,5,6],Used:[0,8,14],Useful:[0,6,7],Uses:[0,18],Was:0,Will:[0,4,6,15,17],With:7,__enter__:4,__exit__:4,_actually_evolve_system:8,_binary_c_bind:[4,5,20],_binary_c_config_execut:8,_binary_c_dir:8,_binary_c_execut:8,_binary_c_shared_librari:8,_commandline_input:8,_count:8,_custom_logging_shared_library_fil:8,_end_time_evolut:8,_errors_exceed:8,_errors_found:8,_evolution_type_opt:8,_failed_count:8,_failed_prob:8,_failed_systems_error_cod:8,_generate_grid_cod:8,_grid_vari:8,_loaded_ms_data:8,_main_pid:8,_population_id:8,_probtot:8,_process_run_population_grid:8,_repeat:8,_set:[6,12,15],_set_ms_grid:8,_start_time_evolut:8,_store_memaddr:8,_system_gener:8,_total_mass_run:8,_total_probability_weighted_mass_run:8,_total_starcount:8,_zero_prob_stars_skip:8,abat:0,abbrevi:19,about:[4,6,7,12,15,20],abov:[0,2,4,5,6],absolut:0,abund:0,acceler:0,accept:[4,12,15],access:[2,8],accord:[0,2],accordingli:[12,15],account:[0,8],accret:0,accretion_limit_dynamical_multipli:0,accretion_limit_eddington_lmms_multipli:0,accretion_limit_eddington_steady_multipli:0,accretion_limit_eddington_wd_to_remnant_multipli:0,accretion_limit_thermal_multipli:0,accretor:[0,20],act:[0,8,12,15],activ:[0,10,16],actual:[0,4,6,8,10,14,16],adam:0,adapt:0,add:[2,4,6,8,12,14,15,18,20],add_grid_vari:[6,12,15],added:4,address:[1,8,20],admittedli:14,adress:[5,20],affect:0,after:[0,6,8],ag89:0,again:[4,6,8,10,16],against:14,agb:0,agb_3dup_algorithm:0,agb_core_algorithm:0,agb_core_algorithm_default:0,agb_core_algorithm_hurlei:0,agb_core_algorithm_karaka:0,agb_luminosity_algorithm:0,agb_luminosity_algorithm_default:0,agb_luminosity_algorithm_hurlei:0,agb_luminosity_algorithm_karaka:0,agb_radius_algorithm:0,agb_radius_algorithm_default:0,agb_radius_algorithm_hurlei:0,agb_radius_algorithm_karaka:0,agb_third_dredge_up_algorithm_default:0,agb_third_dredge_up_algorithm_hurlei:0,agb_third_dredge_up_algorithm_karaka:0,agb_third_dredge_up_algorithm_stancliff:0,age:0,aging:0,albedo:0,algorithm:10,algothim:0,all:[0,1,2,4,5,6,7,8,10,11,12,14,15,16,17],all_info:6,allow:[0,2,4,5,8],allow_nan:4,along:[0,7,8],alot:[12,15],alpha:0,alpha_c:0,alphacb:0,alreadi:6,also:[0,4,5,6,7,10,16,20],altern:[0,8],alwai:[0,2,8],amanda:0,amax:2,amin:2,amount:[0,4,6,7,8,12,15,18],amt_cor:[6,8,12,15],analys:17,analyt:6,andrew:[10,16],andronov:0,angelou_lithium_cheb_decay_tim:0,angelou_lithium_cheb_massfrac:0,angelou_lithium_cheb_tim:0,angelou_lithium_decay_funct:0,angelou_lithium_decay_tim:0,angelou_lithium_eagb_decay_tim:0,angelou_lithium_eagb_massfrac:0,angelou_lithium_eagb_tim:0,angelou_lithium_gb_decay_tim:0,angelou_lithium_gb_massfrac:0,angelou_lithium_gb_tim:0,angelou_lithium_hg_decay_tim:0,angelou_lithium_hg_massfrac:0,angelou_lithium_hg_tim:0,angelou_lithium_lmms_decay_tim:0,angelou_lithium_lmms_massfrac:0,angelou_lithium_lmms_tim:0,angelou_lithium_ms_decay_tim:0,angelou_lithium_ms_massfrac:0,angelou_lithium_ms_tim:0,angelou_lithium_tpagb_decay_tim:0,angelou_lithium_tpagb_massfrac:0,angelou_lithium_tpagb_tim:0,angelou_lithium_vrot_trigg:0,angelou_lithium_vrotfrac_trigg:0,angular:[0,14],ani:[0,2,4,6,10,16],anoth:0,ansi:0,anyth:[0,8],anywai:6,anywher:6,api:[0,4],api_log_filename_prefix:0,append:[1,4],appli:0,approach:5,appropri:[0,8],approxim:0,aren:[2,8],arenou2010_binary_fract:2,arg:[2,4,14],arg_dict:4,argopt:0,argpair:4,argstr:5,argument:[0,2,4,5,6,8,12,15,17],argument_of_periastron:0,argument_of_periastron_quadrupl:0,argument_of_periastron_tripl:0,around:[0,5],arrai:[2,4,5,8],artifici:0,artificial_accretion_end_tim:0,artificial_accretion_ignor:0,artificial_accretion_start_tim:0,artificial_angular_momentum_accretion_r:0,artificial_mass_accretion_r:0,artificial_orbital_angular_momentum_accretion_r:0,arxiv:[0,2],asarrai:5,ask:[0,20],asplund:0,assign:6,assum:[0,14],ast871:0,astronomi:0,astropi:[10,14,16],atom:4,attempt:[4,6],auto:[1,11],autogen_c_logging_cod:[1,5],autogener:5,automat:[0,1,5,7,10,16],avaibl:[10,16],avail:[0,4,8,14],awai:0,axi:[0,14],b_1:0,b_2:0,b_3:0,b_4:0,b_inclination1:0,b_inclination2:0,b_inclination3:0,b_inclination4:0,back:[0,4],background:5,backward:0,bagb:0,barn:0,base:[0,2,4,5,6,10,14,16,20],base_filenam:[6,12,15],basic:[5,6],batchmod:0,beasor:0,becaus:[0,2,5,6,8,10,16],becom:[0,1,2,4],been:[0,6,8],befor:[0,6,8,10,12,15,16],behaviour:[4,17],behind:5,belczynski:0,below:[0,8,15],berro:0,bertolami:0,best:[6,8,10,16],beta:0,beta_reverse_nova:0,beta_reverse_novae_geometri:0,better:[0,4,6],between:[0,2,18],bewar:6,bh_belczynski:0,bh_fryer12_delai:0,bh_fryer12_rapid:0,bh_hurley2002:0,bh_prescript:0,bh_spera2015:0,big:[0,8],bin:[0,5,10,16],binari:[2,5,6,8,10,12,14,15,16,20],binary_c2:[10,16],binary_c:[1,2,4,5,6,8,12,14,15,17],binary_c_cal:6,binary_c_default:[12,15],binary_c_inline_config:1,binary_c_log_cod:[1,5],binary_c_macro:0,binary_c_output:4,binary_c_paramet:[0,12,15],binary_c_python:[4,6,12],binary_c_task_:0,binary_c_write_log_cod:1,binary_grid:0,binary_star:20,binaryc:[1,4,17],binaryc_config:1,binaryc_json_seri:4,binarycdecod:4,binarycencod:4,binarycpython:[1,2,4,5,6,7,10,12,14,15,16,17,18,20],bind:0,birth:0,bit:2,bivari:0,black:0,black_hol:0,bloecker:0,blog:1,boltzman:14,boltzmann:0,bondi:0,bondi_hoyle_accretion_factor:0,bool:[4,6,7,14],born:0,bosswissam:4,both:[0,4],bottom:0,bound:[2,18],boundari:2,brake:0,branch:[0,4],branch_david:0,branchpoint:6,breakup:0,broken:0,bse:[0,2],bse_opt:[6,12,15],bsf:0,buffer:0,build:[0,1,4],build_q_tabl:2,built:[0,1,4,10,16],burn:0,busso:0,bye:0,c13_eff:0,c_auto_log:[8,15],c_log:0,c_logging_cod:[8,12,15],calc_e_integr:2,calc_p_integr:2,calc_period_from_sep:20,calc_sep_from_period:[12,15,20],calc_total_probden:2,calcul:[0,2,4,6,8,20],calculate_constants_three_part_powerlaw:2,call:[0,1,4,6,8,12,14,15,17],call_binary_c_config:4,can:[0,1,2,4,5,6,8,10,12,14,15,16,17],cannot:6,canon:8,cap:0,capsul:[1,4],captur:[0,4],carbon:0,carbon_oxygen_white_dwarf:0,carlo:[0,8],carrasco:0,carri:0,cast:[4,5],catchtim:4,categoris:4,caught:4,caus:20,cbdisc:0,cbdisc_albedo:0,cbdisc_alpha:0,cbdisc_eccentricity_pumping_dermin:0,cbdisc_eccentricity_pumping_method:0,cbdisc_eccentricity_pumping_non:0,cbdisc_end_evolution_after_disc:0,cbdisc_fail_ring_inside_separ:0,cbdisc_gamma:0,cbdisc_init_djdm:0,cbdisc_init_dm:0,cbdisc_inner_edge_strip:0,cbdisc_inner_edge_stripping_timescal:0,cbdisc_kappa:0,cbdisc_mass_loss_constant_r:0,cbdisc_mass_loss_fuv_multipli:0,cbdisc_mass_loss_inner_l2_cross_multipli:0,cbdisc_mass_loss_inner_viscous_accretion_method:0,cbdisc_mass_loss_inner_viscous_accretion_method_equ:0,cbdisc_mass_loss_inner_viscous_accretion_method_gerosa_2015:0,cbdisc_mass_loss_inner_viscous_accretion_method_non:0,cbdisc_mass_loss_inner_viscous_accretion_method_young_clarke_2015:0,cbdisc_mass_loss_inner_viscous_angular_momentum_multipli:0,cbdisc_mass_loss_inner_viscous_multipli:0,cbdisc_mass_loss_ism_pressur:0,cbdisc_mass_loss_ism_ram_pressure_multipli:0,cbdisc_mass_loss_xray_multipli:0,cbdisc_max_lifetim:0,cbdisc_minimum_evaporation_timescal:0,cbdisc_minimum_fr:0,cbdisc_minimum_luminos:0,cbdisc_minimum_mass:0,cbdisc_no_wind_if_cbdisc:0,cbdisc_outer_edge_strip:0,cbdisc_outer_edge_stripping_timescal:0,cbdisc_resonance_damp:0,cbdisc_resonance_multipli:0,cbdisc_torquef:0,cbdisc_viscous_l2_coupl:0,cbdisc_viscous_photoevaporative_coupl:0,cbdisc_viscous_photoevaporative_coupling_inst:0,cbdisc_viscous_photoevaporative_coupling_non:0,cbdisc_viscous_photoevaporative_coupling_visc:0,cee:0,cemp:0,cemp_cfe_minimum:0,center:6,central_object:0,certain:[3,8,10,16],cf_amanda_log:0,cflag:[10,16],chabrier:2,chandrasekhar:0,chandrasekhar_mass:0,chang:[0,1,2,4,6,7,8,10,15,16],chapter:[0,3,8,11],cheb:0,check:[0,2,4,6,7,12,15,20],check_circular:4,chemic:0,chen:0,child:4,choic:[0,2,6,14],choos:[0,5,14],chosen:6,circular:0,circumbinari:0,circumstanti:0,claei:0,clark:0,clean:[1,6,10,16],clean_up_custom_logging_fil:6,clear:4,clock:4,clone:[10,16],close:0,cloud:0,cls:4,cluster:9,cmdline:6,code:[0,1,3,5,6,7,10,12,14,15,16,17],collaps:0,collapsar:0,collect:20,collid:20,color:14,color_by_index:14,colour:0,colour_log:0,column:[5,12,14,15],com:[1,4],combin:[1,4,6,8],combine_ensemble_with_thread_join:8,come:[2,10,16,18],comenv_bs:0,comenv_disc_angmom_fract:0,comenv_disc_mass_fract:0,comenv_ejection_spin_method:0,comenv_ejection_spin_method_do_noth:0,comenv_ejection_spin_method_sychron:0,comenv_ejection_spin_method_synchron:0,comenv_merger_spin_method:0,comenv_merger_spin_method_breakup:0,comenv_merger_spin_method_conserve_angmom:0,comenv_merger_spin_method_conserve_omega:0,comenv_merger_spin_method_specif:0,comenv_ms_accret:0,comenv_ms_accretion_fract:0,comenv_ms_accretion_mass:0,comenv_nandez2016:0,comenv_nelemans_tout:0,comenv_ns_accret:0,comenv_ns_accretion_fract:0,comenv_ns_accretion_mass:0,comenv_post_eccentr:0,comenv_prescript:0,comenv_splitmass:0,comenv_undef:0,command:[0,1,6,8,10,16],commandlin:[12,15],commit:4,common:[0,12,15],companion:[0,12,15],compar:[0,8],compil:[1,5,10,12,15,16],compile_shared_lib:1,complain:[12,15],complex:[5,6,8,14],compon:[4,14],comput:[0,9],condit:[5,6,12,15],condor:[6,8,9],condor_grid:6,config:[1,4,8,10,16],config_fil:1,configur:[2,5,6,12,15],conserv:0,consid:[0,1,2,4,6,8,14],constant:[0,2,14],construct:[0,1,5],contain:[0,1,2,3,4,6,7,8,9,10,11,14,15,16,17,18,19],content:[4,10,13],context:4,continu:6,control:0,convect:0,converg:0,convert:[2,4,6],convert_byt:4,cool:0,copi:[0,6,20],core:[0,6,8,14],core_helium_burn:0,core_mass:0,correct:[2,6,14,20],correctli:[5,10,12,14,15,16],correspond:14,corretor:0,cosmic:2,cosmic_sfh_madau_dickinson2014:2,could:[0,4],count:[4,8],count_keys_recurs:4,counter:8,coupl:0,cours:14,coverag:[10,16],cowd:0,cpu:0,crap_paramet:0,creat:[2,4,6,12,15],create_and_load_logging_funct:[1,5],create_arg_str:4,create_hdf5:[4,12,15],critic:0,cross:0,ctype:1,cuntz:0,current:[0,4,10,16],custom:[0,1,4,5,6,8,12,14,15,17],custom_log:[5,6,8],custom_logging_cod:[1,5,17],custom_logging_func_memaddr:[5,8],custom_logging_funct:[5,8,10,11,12,15],custom_logging_info:6,custom_opt:[6,12,15],custom_sort_dict:4,custom_tmp_dir:1,customis:14,cut:5,cvode:0,dai:[0,2,5,12,15,20],damp:0,dat:[0,4,12,15],data:[0,4,5,6,8,12,15,17],data_dict:2,data_dir:[4,6,8,12,15],datadir:6,datafram:[5,14],dataset:4,date:6,david:[0,10,16],david_logging_funct:0,dd7:0,deactiv:0,deal:4,death:0,debug:[0,8],decai:0,decid:[0,4,5],decod:4,decreas:0,deeper:6,def:[5,12,15],default_to_metal:0,defaultdict:4,defer:0,defin:[0,1,2,6,14],definit:[1,20],degener:0,degre:0,delta_mcmin:0,den:0,densiti:2,depend:[0,2,10,14,16],deprec:0,dermin:0,describ:[0,2,5,8],descript:[0,2,4,8,10,11],design:[6,14],desir:0,destruct:6,detail:[0,4],detect:0,determin:[0,6,20],deton:0,dev:0,develop:1,deviat:2,dewi:0,dex:0,df2:5,diagnost:8,diagram:[0,14],dickonson:2,dict2:4,dict:[1,2,4,6,7,12,15,19],dict_1:4,dict_2:4,dictionari:[1,2,4,6,7,8,14,19],did:[4,10,16],differ:[0,4,6,10,14,16],dimmer:0,dir:[10,16],direct:[0,6],directli:[4,5,8],director:8,directori:[0,4,6,8,10,12,15,16],disabl:0,disable_debug:0,disable_end_log:0,disable_ev:0,disc:0,disc_legacy_log:0,disc_log2d:0,disc_log:0,disc_log_directori:0,disc_log_dt:0,disc_log_level_non:0,disc_log_level_norm:0,disc_log_level_normal_first_disc_onli:0,disc_log_level_subtimestep:0,disc_log_level_subtimestep_first_disc_onli:0,disc_n_monte_carlo_guess:0,disc_stripping_timescale_infinit:0,disc_stripping_timescale_inst:0,disc_stripping_timescale_orbit:0,disc_stripping_timescale_visc:0,disc_timestep_factor:0,discs_circumbinary_from_comenv:0,discs_circumbinary_from_wind:0,disk:[0,6],dispers:0,displai:0,dist:[10,16],distefano:2,distribut:[0,2,6,9],distribution_funct:[10,11],divid:9,dlnm1:[6,12,15],dlog10per:[12,15],dlogp:2,do_dry_run:8,doc:[4,7,10,16],doc_fetch:2,docstr:[10,14,16],document:[4,7,8,11],doe:[0,2,4,6,8,20],doesn:[6,8],doesnt:[5,7],doing:[0,1,6,7,10,16],don:[2,4,8],done:[0,4,5,6,10,12,15,16],donm:[12,15],donor:[0,20],donor_limit_dynamical_multipli:0,donor_limit_envelope_multipli:0,donor_limit_thermal_multipli:0,donor_rate_algorithm_bs:0,donor_rate_algorithm_claeys2014:0,dont:5,dphasevol:[6,12,15],dr2:0,dr3:0,drai:0,dredg:0,dry:8,dstep:2,dtfac:0,dtlimit:4,dtm:[1,12,15],dtype:5,due:[10,16],dummi:[2,14],dump:[0,4],dumpvers:0,duquennoi:2,duquennoy1991:2,dure:0,dust:0,dwarf:0,dynam:0,e2_hurley_2002:0,e2_izzard:0,e2_mint:0,e2_prescript:0,each:[0,2,4,6,8],eagb:0,eagb_wind_beasor_etal_2020:0,eagb_wind_bs:0,eagb_wind_goldman_etal_2017:0,eagbwind:0,eagbwindfac:0,earli:0,early_asymptotic_giant_branch:0,easi:4,easier:[4,5],ecc2:2,ecc3:2,ecc:[2,5,6],eccentr:[0,2,5,12,14,15,20],eccentric_rlof_model:0,eccentricity_quadrupl:0,eccentricity_tripl:0,echo:0,eddington:0,edg:[0,6],edu:0,effect:[0,2,8],effective_metal:0,effici:0,egg:[10,16],eggleton:[0,20],either:[0,4,5,6,8,10,16,17],eject:0,eld:0,eldridg:0,electon:0,electron:0,element:[0,1,4,8,14],email:4,emp:0,emp_feh_maximum:0,emp_logg_maximum:0,emp_minimum_ag:0,empti:[4,7],enabl:0,encod:4,encount:8,end:[0,2,4,8,12,15],end_index:2,energi:0,enhanc:0,enlarg:0,enough:2,ensembl:[0,4,6,8],ensemble_def:0,ensemble_dictionari:6,ensemble_dt:0,ensemble_factor_in_probability_weighted_mass:8,ensemble_filter_:0,ensemble_filters_off:0,ensemble_json:4,ensemble_legacy_ensembl:0,ensemble_list:6,ensemble_logdt:0,ensemble_logtim:0,ensemble_macro:0,ensemble_output_:8,ensemble_startlogtim:0,ensure_ascii:4,enter:[0,10,16],enthalpi:0,entir:5,entri:[4,6],env:[10,14,16],envelop:0,equal:[4,12,15],equat:0,equation_of_state_algorithm:0,equation_of_state_paczynski:0,equatori:0,equival:8,errno:[10,16],error:[0,4,8,10,16],esa:2,escap:0,escape_fract:0,escape_veloc:0,eta:0,etal:0,etc:[0,4,6,9,10,12,14,15,16,17],euler:0,evalu:[2,6,20],evan:0,evapor:0,evaporate_escaped_orbiting_object:0,event:0,everi:[0,10,16],everyth:[6,8,12,15],everytim:[10,16],evid:0,evolut:[0,1,5,6,8,14],evolution_split:0,evolution_splitting_maxdepth:0,evolution_splitting_sn_eccentricity_threshold:0,evolution_splitting_sn_n:0,evolution_typ:8,evolutionari:0,evolv:[0,6,8,12,15],evolve_popul:[6,12,15],evolve_singl:[6,12,15],exact:[1,4,8],exactli:0,exampl:[1,2,4,6,12,17],example_head:4,example_header_1:5,example_header_2:5,example_log:17,example_log_co:1,example_parse_output:[4,5],example_pop:[12,15],example_pop_set:12,example_python_population_result:[12,15],exce:[0,8],except:[4,6,7,8,14],execut:[0,6,8,10,12,15,16],exist:[0,6,7,12,15],exist_ok:[4,12,15],exit:[0,4],exp:[6,12,15],expand:17,expect:[10,16],experiment:[0,4],explain:4,explicitli:[0,1],explod:0,explos:0,expoenti:0,expon:0,export_all_info:[6,12,15],express:0,extend:[10,16],extern:0,extra:[0,6,8,17],extra_text:7,extract:[4,12,15],extract_ensemble_json_from_str:4,extrapol:[2,8],fabian:0,fabian_imf_log:0,fabian_imf_log_tim:0,fabian_imf_log_timestep:0,factor:[0,2,4,8],fade:0,fail:[0,4,8,10,16],fail_sil:4,failed_system:8,failed_system_log:8,failed_systems_threshold:8,failur:0,fals:[0,4,6,8,12,14,15],fancy_parsing_funct:17,far:0,farmer:0,fase:[12,15],fast:0,feed:8,ferguson:0,few:0,field:0,fig:[0,2],figur:[8,14],file:[0,1,4,6,7,8,9,10,12,14,15,16,17],file_log:0,filehandl:7,filenam:[0,1,4,5,6,8,12,15,17],filenotfounderror:[10,16],filepath:1,fill:6,fill_data:2,filter:[0,4],filter_arg_dict:4,filter_valu:4,fin:0,find:[4,6,8,10,16],finish:[4,14],first:[0,2,4,6,10,16,20],first_giant_branch:0,fishlock:0,fit:[0,2,4,6,20],fix:[0,2,4,6,14],flag:[0,1,4,8],flash:0,flat:[2,8],flatsect:[2,12,15],flaw:6,float64:5,float_overflow_check:0,flto:[10,16],fold:2,follow:[0,2,4,8,10,14,16],forc:[0,10,16],force_circularization_on_rlof:0,force_corotation_of_primary_and_orbit:0,form:[0,4,6,7],formal:0,format:[0,2,4,5,6,12,15],format_ensemble_result:6,formula:0,forward:0,found:[2,10,16],four:0,fpic:1,fraction:[0,2,8],frequenc:0,friction:0,fring:0,from:[0,2,4,5,6,8,12,14,15,20],from_binary_c_config:1,from_dict:5,ftz:[10,16],full:[4,6,8],full_path:4,fulli:[12,15],func_memaddr:5,further:2,fuv:0,gaia:[0,2],gaia_colour_transform_method:0,gaia_conversion_ubvri_bivariate_jordi2010:0,gaia_conversion_ubvri_riello2020:0,gaia_conversion_ubvri_univariate_evans2018:0,gaia_conversion_ubvri_univariate_jordi2010:0,gaia_conversion_ugriz_bivariate_jordi2010:0,gaia_conversion_ugriz_riello2020:0,gaia_conversion_ugriz_univariate_evans2018:0,gaia_conversion_ugriz_univariate_jordi2010:0,gaia_l_binwidth:0,gaia_teff_binwidth:0,gain:8,galact:0,gallino:0,gamma:0,gap:0,garcia:0,gauss:0,gaussian:2,gaussian_func:2,gaussian_normalizing_const:2,gb_reimers_eta:0,gb_wind_beasor_etal_2020:0,gb_wind_goldman_etal_2017:0,gb_wind_reim:0,gb_wind_schroeder_cuntz_2005:0,gbwind:0,gbwindfac:0,gcc:[1,10,16],gce:0,gener:[0,1,2,4,5,6,7,8,12,14,15],general_info:4,generalis:2,geometr:0,gerosa:0,get:[0,2,4,5,6,7,10,12,15,16,17,20],get_arg_kei:4,get_default:4,get_help:[4,12,15],get_help_al:[4,6,12,15],get_help_sup:4,get_integration_constant_q:2,get_max_multipl:2,get_moe_di_stefano_dataset:4,get_siz:4,get_stream_logg:6,gettempdir:5,giant:0,giant_branch:0,git:[0,4],git_branch:4,git_build:4,github:4,gitlab:10,give:[0,2,4,5,20],given:[0,1,2,4,5,6,8,17,20],global:[0,2],global_dict:2,gmax:2,gmin:2,goe:[0,4,6,14],gogo:0,going:[10,16],goldman:0,gonna:2,good:[0,8,12,15,20],gov:0,gravit:0,gravitational_radiation_bs:0,gravitational_radiation_bse_when_no_rlof:0,gravitational_radiation_landau_lifshitz:0,gravitational_radiation_landau_lifshitz_when_no_rlof:0,gravitational_radiation_model:0,gravitational_radiation_modulator_:0,gravitational_radiation_modulator_j:0,gravitational_radiation_non:0,grb:0,great:0,greater:0,grevess:0,grid:[0,4,6,10,11,12,15],grid_class:[10,11],grid_cod:6,grid_opt:[6,8,12,15],grid_options_default:7,grid_options_defaults_dict:7,grid_options_descript:7,grid_options_description_check:7,grid_options_help:7,grid_vari:[8,12,15],grid_variable_numb:6,gridcode_filenam:8,gridtyp:6,group:4,gsl:[10,16],gsl_dir:[10,16],guess:[0,2],h5py:[10,16],hachisu:0,hachisu_disk_wind:0,hachisu_ignore_qcrit:0,hachisu_qcrit:0,hack:7,had:6,half:0,hall:0,handi:0,handl:[0,4,6,8,15,17,20],handle_ensemble_string_to_json:4,happen:0,has:[0,1,4,5,6,8],have:[0,2,4,5,6,7,8,10,12,14,15,16],hbb:0,hbbtfac:0,hdf5:[4,12,15],hdf5file:4,header:[1,4,5,12,15],headerlin:[12,15],headlin:8,hegb:0,hehg:0,height:[2,12,15],helium:0,helium_flash_mass_loss:0,helium_white_dwarf:0,help:[0,4,7,12,15],help_al:0,hem:0,henc:0,hendrik:[10,16],here:[1,4,5,6,8,12,14,15],hertzsprung:0,hertzsprung_gap:0,hertzstrpung:0,heuvel:0,hewd:0,hewd_hewd_ignition_mass:0,hex:8,high:[0,2],higher:[0,2,4,8,10,16],highest:6,his:2,histori:2,hold:8,hole:0,homogen:0,hopefulli:0,hot:0,how:[0,4,5,6,8],howev:0,hoyl:0,hpc:[6,9],hpc_function:[10,11],hr_diagram:14,hrd:0,hrdiag:0,hrdiag_output:0,html:[10,16],http:[0,1,2,4],hurlei:0,hut:0,hybrid:0,hydro:0,hydrogen:0,ibc:0,idea:14,idum:0,ignit:0,ignor:[0,5,6,8,10,16],iia:0,imf:[0,2],imf_chabrier2003:2,imf_scalo1986:2,imf_scalo1998:2,imf_tinsley1980:2,immedi:0,implement:[0,6,8],impli:0,impos:[12,15],improv:2,inclin:0,inclination1:0,inclination2:0,inclination3:0,inclination4:0,inclini:0,incliniation_quadrupl:0,incliniation_tripl:0,includ:[0,1,2,4,5,6,10,14,16],include_binary_c_default:[6,12,15],include_binary_c_help_al:[6,12,15],include_binary_c_version_info:[6,12,15],include_default:6,include_popul:[12,15],include_population_set:6,incom:0,increas:0,inde:0,indent:4,index:[0,2,10],indic:[0,2],individual_nova:0,induc:0,inertia:0,info:[4,6,10,12,14,15,16],inform:[0,1,4,6,7,12,14,15],init:6,init_abund:0,init_abund_dex:0,init_abund_mult:0,init_abunds_onli:0,initi:[0,2,6],initial_abundance_hash:6,initial_abundance_mix:0,initial_abunds_onli:0,inlin:5,inner:0,input:[1,2,4,6,8,10,14,20],input_dict:4,insert:6,insid:0,inspect:[4,12,14,15],inspect_dict:4,inspir:[1,5,14,20],instabl:0,instanc:[4,12,15],instant:0,instantli:0,instead:[0,4,8],integ:[0,6,8,20],integr:2,integrals_str:2,interact:[0,7],interfac:[4,10,16],interfer:[10,16],intern:[0,8],internal_buff:0,internal_buffering_off:0,internal_buffering_print:0,internal_buffering_stor:0,interpol:[2,6],interpolate_in_mass_izzard2012:2,interpolator_nam:2,intershel:0,interstellar:0,intger:0,intro:0,invers:20,involv:0,inward:0,is_capsul:4,isn:[4,6],isnt:[12,15],isotop:[0,4],isotope_hash:6,isotope_list:6,item:1,iter:4,its:[0,4,6,7,10,14,16,17],itself:[4,8,10,16],iwamoto:0,izzard2012_period_distribut:2,izzard:[0,10,16],jager:0,jaschek:2,jeff:[10,16],jia:0,job_queu:6,john:0,join:[12,15],jordi:0,json:[4,6,8,12,15],jsondecod:4,jsonencod:4,jul:0,jupyt:[10,16],just:[0,2,4,5,6,8,20],kap:0,kappa:0,kaps_rentrop:0,karaka:0,keep:6,kei:[1,2,4,6,7,8,14],kelvin:0,keplerian:0,keyword:[14,17],kick:[0,8],kick_backward:0,kick_forward:0,kick_inward:0,kick_outward:0,kick_random:0,kick_straight_up:0,kick_velocity_custom:0,kick_velocity_fix:0,kick_velocity_maxwellian:0,kill:[1,12,15],kim:0,kind:0,kippenhahn:0,know:[0,1,6,7],known:[0,2,6,12,15,17],kroupa2001:[2,6],kroupa:2,ktg93:2,kwarg:[6,14,17],lambda:0,lambda_c:0,lambda_ce_dewi_tauri:0,lambda_ce_klencki_2020:0,lambda_ce_polytrop:0,lambda_ce_wang_2016:0,lambda_enthalpi:0,lambda_ionis:0,lambda_min:0,lambda_mult:0,lambda_multipli:0,lambda_v:2,lamer:0,landau:0,langer:0,larger:0,last:[2,6],last_grid_vari:6,late:5,latter:0,law:2,law_const:2,lbv:0,ld_library_path:[10,16],lead:[0,20],least:[10,16],leav:0,left:0,legaci:0,legacy_yield:0,len:[12,15],lengthen:0,less:[0,1,2],let:6,level:[1,4,6],li7:0,lib:[5,10,16],libbinary_c:8,libgsl:[10,16],libmemo:[10,16],librari:[0,1,5,6,8,12,17],library_path:[10,16],librinterpol:[10,16],lies:0,lifetim:0,lifshitz:0,like:[0,1,4,5,6,8,10,14,16,18],limit:[0,14],line:[1,4,5,6,8,10,14,16],linear2:8,linear:[0,2,8],linear_extrapolation_q:2,linearli:[6,18],linker:1,linspac:18,list:[0,1,2,4,8,17,18],list_arg:0,list_of_sub_kei:2,lit:0,lithium:0,lithium_gb_post_1dup:0,lithium_gb_post_heflash:0,lithium_hbb_multipli:0,lithium_t:0,littleton:0,liu:0,llnl:0,lnm1:[6,12,15],load:[0,1,4,5,6,8,12,14,15],load_logfil:4,lobe:[0,20],local:2,locat:[0,2,8,10,16],lodder:0,log10:[0,2,12,15],log10m1:8,log10p:2,log10per:[12,15],log10pmin:2,log:[0,1,2,4,5,6,8,10,12,14,15,16,17,20],log_arg:8,log_args_dir:8,log_fil:8,log_filenam:[0,5,17],log_runtime_system:8,logarithm:2,logensembletim:0,logfil:[4,10,16],logg:0,logger:6,logging_dict:1,logging_lin:5,logic:[1,6,8],logmass:2,logp:2,logper:2,logperiod:2,long_spectral_typ:2,longer:0,longnam:[6,12,15],look:[1,4,10,16],lookback:0,loon:0,loop:6,loos:14,lose:0,loss:0,lost:0,lot:[4,8,17],low:[0,2,12,15],low_mass_m:0,low_mass_main_sequ:0,lower:[0,2,6,18],lsoda:0,lsun:[0,14],lugaro:0,luminos:[0,14],luminosity_1:14,luminosity_2:14,lynnett:0,m_1:[0,5,6,12,15,17],m_2:[0,5,12,15],m_3:0,m_4:0,m_max:[2,6],m_min:6,m_re:5,maccretor:0,machin:[8,10,16],macro:[0,4],madau:2,maeder:0,magellan:0,magnet:0,magnetic_braking_algorithm:0,magnetic_braking_algorithm_andronov_2003:0,magnetic_braking_algorithm_barnes_2010:0,magnetic_braking_algorithm_hurley_2002:0,magnetic_braking_algorithm_rappaport_1983:0,magnetic_braking_factor:0,magnetic_braking_gamma:0,magnitud:4,mai:0,main:[0,1,8,10,16],main_sequ:0,mainli:9,major:0,make:[0,1,2,4,5,6,8,10,12,14,15,16,17],make_build_text:4,makedir:[4,12,15],manag:[4,10,16],mani:[0,6,8],manufactur:0,map:8,maria:0,mass:[0,1,2,4,5,6,8,12,14,15,17,20],mass_1:[5,14],mass_2:[5,14],mass_accretion_for_eld:0,mass_accretor:20,mass_donor:20,mass_evolut:14,mass_for_hestar_ia_low:0,mass_for_hestar_ia_upp:0,mass_of_pmz:0,mass_str:2,massiv:[0,2],massless:0,massless_remn:0,master:[8,14],match:[0,4,14],materi:0,math:[6,12,15],matplotlib:[10,14,16],matter:0,mattsson:0,mattsson_mass_loss:0,mattsson_orich_tpagbwind:0,max:[0,2,12,15],max_bound:[2,18],max_evolution_tim:[0,1,5,12,15],max_hewd_mass:0,max_model_numb:0,max_multipl:2,max_neutron_star_mass:0,max_queue_s:8,max_stellar_angmom_chang:0,max_stellar_type_1:0,max_stellar_type_2:0,max_stellar_type_3:0,max_stellar_type_4:0,max_val:2,maximum:[0,2,8,20],maximum_mass_ratio_for_instant_rlof:0,maximum_mass_ratio_for_rlof:20,maximum_mcbagb_for_degenerate_carbon_ignit:0,maximum_nuclear_burning_timestep:0,maximum_timestep:0,maximum_timestep_factor:0,maxmimum:0,maxwellian:0,mayb:14,mayor:2,mc13_pocket_multipli:0,mch:0,mcmin:0,mdonor:0,mean:[0,2,4,6,8,10,16],meant:8,measur:4,medium:0,mega:2,memaddr:5,memori:[1,5,6,8,20],menv:0,merg:[0,2,4,8],merge_dict:4,merge_multipl:2,merger:0,merger_angular_momentum_factor:0,merger_mass_loss_fract:0,mesa:[10,16],mesasdk_init:[10,16],mesasdk_root:[10,16],messag:4,mestel:0,met:6,metal:[0,2,5,20],method:[0,5,6,8],meynet:0,might:[4,6,10,16],milki:0,miller:0,min:[2,12,15],min_bound:[2,18],min_p:2,min_per:2,min_val:2,mind:5,minimal_verbos:4,minimum:[0,2,4,8,20],minimum_co_core_mass_for_carbon_ignit:0,minimum_co_core_mass_for_neon_ignit:0,minimum_donor_menv_for_comenv:0,minimum_envelope_mass_for_third_dredgeup:0,minimum_helium_ignition_core_mass:0,minimum_mcbagb_for_nondegenerate_carbon_ignit:0,minimum_orbital_period_for_instant_rlof:0,minimum_period_for_rlof:20,minimum_separation_for_instant_rlof:0,minimum_separation_for_rlof:20,minimum_time_between_pn:0,minimum_timestep:0,mint:0,mint_data_cleanup:0,mint_dir:0,mint_disable_grid_load_warn:0,mint_kippenhahn:0,mint_kippenhahn_companion_stellar_typ:0,mint_kippenhahn_stellar_typ:0,mint_maximum_shell_mass:0,mint_metal:0,mint_minimum_shell_mass:0,mint_ms_rejuven:0,mint_nuclear_burn:0,mint_remesh:0,mint_use_zams_profil:0,mira:0,misc:10,miscellan:4,miss:[0,4,7],mix:[0,4,8],mixtur:0,mmax:2,mmin:[2,8],mnra:20,model:[0,1,5,8,12,15],modifi:0,modul:[0,7,8,11],modulo:8,moe:[2,4,6,10],moe_di_stefano_2017:6,moe_di_stefano_2017_multiplicity_fract:2,moe_di_stefano_2017_pdf:2,moment:[0,12,15,18],momenta:[0,14],momentum:0,mont:[0,8],monte_carlo_kick:0,more:[0,1,4,5,6,8,10,14,16,18],most:4,mostli:[4,5,7,8,12,14,15,17],move:0,msun:[0,2,5],much:[0,4],multi:8,multipl:[0,2,4,8],multiplc:0,multipli:[0,4,8],multiplicity_arrai:2,multiplicity_fraction_funct:8,multiplicity_model:8,multiplicity_modul:8,multiply_values_dict:4,multiprocess:[6,8],must:[0,2],my_header_lin:15,my_sss2:5,my_stellar_data:[1,5,12,15],myr:[0,5],n100:0,n100_z0:0,n100h:0,n100l:0,n10:0,n150:0,n1600:0,n1600c:0,n200:0,n20:0,n300c:0,n40:0,naked_helium_star_giant_branch:0,naked_helium_star_hertzsprung_gap:0,naked_main_sequence_helium_star:0,name:[1,4,5,6,7,12,15,17,19],natur:0,nauenberg:0,nearer:0,nebula:0,necessari:[4,5,6,12,15],need:[0,2,5,6,10,12,15,16],neg:[0,4],neither:[0,6],neleman:0,nelemans_gamma:0,nelemans_max_frac_j_chang:0,nelemans_minq:0,nelemans_n_comenv:0,nelemans_recalc_eccentr:0,nemp:0,nemp_cfe_minimum:0,nemp_nfe_minimum:0,nenamg:0,neon:0,nest:[4,6],network:0,neutrn:0,neutron:[0,12,15],neutron_star:0,never:0,newer:[0,2],newli:0,newopt:2,newton:0,next:4,nice:[1,6,14,15],nieuwenhuijzen:0,nieuwenhuijzen_windfac:0,nmax:2,no_thermohaline_mix:0,noecho:0,noechonow:0,noel:0,nolowq:8,nomin:0,non:[0,8],nonconservative_angmom_gamma:0,none:[0,1,2,4,5,6,7,8,12,20],nonzero:8,nor:0,norm:8,normal:[0,4],normalis:[2,8],normalize_dict:2,normalize_multipl:8,note:[0,5,8],notebook:[10,16],noth:[6,8],notifi:17,nova:0,nova_faml_multipli:0,nova_irradiation_multipli:0,nova_retention_algorithm_claeys2014:0,nova_retention_algorithm_const:0,nova_retention_algorithm_hillman2015:0,nova_retention_fract:0,nova_retention_method:0,nova_timestep_accelerator_index:0,nova_timestep_accelerator_max:0,nova_timestep_accelerator_num:0,now:[0,2,4,5],nuclear:0,nuclear_mass_hash:6,nuclear_mass_list:6,nucleosynthesi:[0,4],nucleosynthesis_sourc:4,nucreacmult:0,nucsyn:10,nucsyn_angelou_lithium:0,nucsyn_gce_outflow_check:0,nucsyn_hbb:0,nucsyn_metal:0,nucsyn_network:0,nucsyn_network_error:0,nucsyn_s_process:0,nucsyn_solv:0,nucsyn_third_dredge_up:0,nugi:0,number:[0,2,4,5,6,8,10,16],numer:4,numpi:[4,5,10,16,18],obj:4,object:[0,4,6,8,9,12,14,15],object_hook:4,object_pairs_hook:4,obtain:0,occur:[0,20],off:[0,5,12,15],offset:0,ohio:0,old:8,old_solut:[10,16],omega:0,onc:0,one:[0,4,5,6,8,14],onewd:0,onli:[0,4,5,6,8,20],onset:0,onto:[0,2],opac:0,opacity_algorithm:0,opacity_algorithm_ferguson_op:0,opacity_algorithm_paczynski:0,opacity_algorithm_star:0,opal:0,open:[12,15],opm:2,opt:[2,4],option:[0,1,2,4,5,6,10,11,12,15,16,20],orb:6,orbit:[0,2,12,14,15,20],orbit_evolut:14,orbital_inclin:0,orbital_inclinationi:0,orbital_period:[0,5,12,15,20],orbital_period_quadrupl:0,orbital_period_tripl:0,orbital_phas:0,orbital_phase_quadrupl:0,orbital_phase_tripl:0,orbiting_object:0,orbiting_objects_close_pc_threshold:0,orbiting_objects_log:0,orbiting_objects_tides_multipli:0,orbiting_objects_wind_accretion_multipli:0,order:[4,5,6],ordereddict:4,org:[0,2],origin:[10,16],other:[0,1,2,4,7,8,10,12,14,15,16],otherwis:[0,6,7,8],out:[4,7,8],outcom:0,outer:0,outfil:[6,12,15],outfile_nam:1,outfilenam:[12,15],output:[1,4,5,6,8,10,12,14,15,16,17,20],output_dir:6,output_fil:[4,7],output_filenam:6,output_lin:[4,12,15],outsid:[0,2],outward:0,over:[4,6,12,15],overflow:0,overlap:4,overrid:[2,5],overriden:[12,15],overshoot:0,overspin_algorithm:0,overspin_bs:0,overspin_massloss:0,own:[5,6,8,10,16],oxygen:0,oxygen_neon_white_dwarf:0,pack:[12,15],packag:[4,10,16,18],paczynski:0,page:[0,10,13,16],pair:[0,4],panda:[4,5,10,14,16],pane:14,panel:0,paper:0,param_nam:4,paramet:[1,2,4,6,7,8,10,12,14,15,17,18,20],parameter_nam:[4,6,12,15],parameter_value_input_typ:4,pars:[4,5,6,12,14,15,17],parse_binary_c_version_info:4,parse_cmdlin:6,parse_const:4,parse_float:4,parse_funct:[6,8,12,15,17],parse_function_hr_diagram:14,parse_function_mass:14,parse_function_orbit:14,parse_int:4,parse_output:5,parsec:2,part:[2,5,6,20],partial:0,particularli:0,pasp:2,pass:[5,6,8,10,14,16,17],path:[4,8,10,12,15,16],patho:[10,16],pdf:[0,2,10,16],pend:0,per:[0,4,6,8,12,15,20],percentag:0,peret:0,perform:0,perhap:0,periastron:0,pericent:20,period:[0,2,5,12,14,15,20],period_str:2,perl:1,pgo:0,phase:0,phasevol:0,phdi:0,photoevapor:0,php:2,physic:[12,15],pick:14,piec:[5,6],pinnsonneault:0,pisn:0,pkg:[10,16],place:0,placehold:14,plai:[0,6],plan:8,planetari:0,plaw2:8,pleas:[0,4],plot:[0,5,14],plot_funct:[10,11],plot_hr_diagram:14,plot_hr_diagram_singl:14,plot_mass:14,plot_orbit:14,plot_system:14,plot_typ:14,pls:6,plu:0,pms:14,pms_mass_1:14,pms_mass_2:14,pn_comenv_transition_tim:0,pn_fast_wind:0,pn_fast_wind_dm_agb:0,pn_fast_wind_dm_gb:0,pn_fast_wind_mdot_agb:0,pn_fast_wind_mdot_gb:0,pn_hall_fading_time_algorithm:0,pn_hall_fading_time_algorithm_maximum:0,pn_hall_fading_time_algorithm_minimum:0,pn_resolv:0,pn_resolve_maximum_envelope_mass:0,pn_resolve_minimum_effective_temperatur:0,pn_resolve_minimum_luminos:0,pne:0,pogg:0,point:[0,2,4,6,10,16],poisson:[2,8],pol:0,polytrop:0,popul:[0,2,6,7,9,10,12,16,18],population_id:8,population_set:6,posit:[0,2],possibl:[0,1,2,4,7,10,16],post:0,post_ce_adaptive_menv:0,post_ce_envelope_dm_eagb:0,post_ce_envelope_dm_gb:0,post_ce_envelope_dm_tpagb:0,post_ce_objects_have_envelop:0,post_sn_orbit_bs:0,post_sn_orbit_method:0,post_sn_orbit_tt98:0,postagb_legacy_log:0,potenti:0,power:[0,2],powerlaw:2,powerlaw_const:2,powerlaw_extrapolation_q:2,ppisn:0,ppisn_farmer19:0,ppisn_non:0,ppisn_prescript:0,ppn_envelope_mass:0,pre:[0,14],pre_events_stardata:0,pre_main_sequ:0,pre_main_sequence_fit_lob:0,precis:4,precod:[6,12,15],predefin:2,predict:8,predictor:0,prefer:[0,6],prefix:0,prepar:2,prepare_dict:2,prescript:0,prescrit:0,present:[2,4,6,12,15],preserv:0,preset:14,pressur:0,prevent:[0,8],previou:4,previous_stardata:1,primari:[1,2,6,12,15,20],print:[4,5,7,8,12,15],print_help:4,print_info:7,print_option_descript:7,print_structur:4,printf:[1,5,12,15],prior:0,privat:[6,7,10],prob_dict:2,probability_weighted_mass:8,probabl:[0,1,2,6,7,8,12,14,15],probdist:[6,12,15],problem:0,process:[0,4,5,6,8],profil:0,progenitor:0,program:[10,16],project:0,proper:7,properli:0,properti:[0,4,8,14],prot1:0,prot2:0,prot3:0,prot4:0,provid:[0,2,6,8,12,15,17],pseudorandom:0,puls:[0,20],pulsat:0,pump:0,purpos:[8,14],put:[1,4,5,6,8,12,14,15],py_rinterpol:[10,16],pyenv:[10,16],pysiz:4,pytest:[10,16],python3:[5,10,16],python:[4,5],q_high_extrapolation_method:8,q_interpol:2,q_low_extrapolation_method:8,qcrit_bh:0,qcrit_bs:0,qcrit_cheb:0,qcrit_chen_han_formula:0,qcrit_chen_han_t:0,qcrit_cowd:0,qcrit_degenerate_bh:0,qcrit_degenerate_cheb:0,qcrit_degenerate_cowd:0,qcrit_degenerate_eagb:0,qcrit_degenerate_gb:0,qcrit_degenerate_hegb:0,qcrit_degenerate_hehg:0,qcrit_degenerate_hem:0,qcrit_degenerate_hewd:0,qcrit_degenerate_hg:0,qcrit_degenerate_lmm:0,qcrit_degenerate_m:0,qcrit_degenerate_n:0,qcrit_degenerate_onewd:0,qcrit_degenerate_tpagb:0,qcrit_eagb:0,qcrit_gb:0,qcrit_gb_bs:0,qcrit_gb_chen_han_formula:0,qcrit_gb_chen_han_t:0,qcrit_gb_ge2015:0,qcrit_gb_hjellming_webbink:0,qcrit_gb_q_no_comenv:0,qcrit_gb_temmink2021:0,qcrit_gb_vos2018:0,qcrit_ge2015:0,qcrit_hegb:0,qcrit_hehg:0,qcrit_hem:0,qcrit_hewd:0,qcrit_hg:0,qcrit_hjellming_webbink:0,qcrit_lmm:0,qcrit_m:0,qcrit_n:0,qcrit_onewd:0,qcrit_q_no_comenv:0,qcrit_temmink2021:0,qcrit_tpagb:0,qcrit_vos2018:0,qcrits_:0,qcrits_degenerate_:0,qdata:2,qlimit:2,quad:8,quadrat:0,quadrulpl:0,quadrupl:[0,2,8],quantiti:14,queue:[6,8],quit:[0,4],r_l:20,radi:0,radiat:0,radii:[0,20],radiu:[0,1,12,14,15,20],radius_1:14,radius_2:14,ragb:20,raghavan2010_binary_fract:2,raghavan:2,rai:0,railton:0,rais:[0,4,8,12,15],ram:0,ran:8,random:[0,8],random_se:0,random_skip:0,random_system:0,random_systems_se:0,rang:[0,2,6,8,18],rapidli:0,rappaport:0,rate:[0,2],rather:[0,4,6,8,10,16],ratio:[0,2,12,15,20],raw:[4,5,6,8,14,17],raw_output:4,reach:0,reaction:0,read:4,real:6,realli:[0,6,7,8],reason:0,rebuild:[0,10,16],rebuilt:[10,16],recalcul:0,receiv:4,recombin:0,recommend:[1,6],recompil:[10,16],recurs:[4,6],recursive_change_key_to_float:4,recursive_change_key_to_str:4,red:0,redhat:1,redshift:2,reduc:0,reduct:8,regardless:14,region:0,reignit:0,reimer:0,reinstal:[10,16],reject:0,rejects_in_log:0,rejuven:0,rel:0,relat:0,releas:[4,10,16],remain:0,remesh:0,remnant:0,remov:[0,4,6],remove_fil:4,renormalis:2,rentrop:0,repeat:[0,8],repo:[10,16],report:0,repres:8,represent:[4,6],reproduc:0,requir:[0,2,4,5,14,15,17],reset:0,reset_pref:0,reset_star:0,reset_stars_default:0,resolut:[0,6,8,12,15],resolv:0,reson:0,respect:[0,2],respons:6,rest:[2,6],restructuredtext:4,result:[0,1,2,4,5,6,8,10,12,15,16],result_arrai:2,result_dict:2,result_example_head:5,result_example_header_1:5,result_example_header_2:5,retain:0,rethink:4,return_all_info:6,return_binary_c_version_info:[4,6],return_compilation_dict:1,return_help_al:4,return_maximum_mass_ratio_for_rlof:20,return_minimum_orbit_for_rlof:20,return_population_set:6,return_version_info:4,revap_in:0,revap_out:0,revers:[0,14],reverse_tim:0,revis:[0,4],rewrit:6,rhagavan:8,rich:0,riello:0,rin:0,ring:0,risk:6,ritter:0,rk2:0,rk4:0,rlof:[0,20],rlof_angular_momentum_transfer_model:0,rlof_angular_momentum_transfer_model_bs:0,rlof_angular_momentum_transfer_model_conserv:0,rlof_eccentric_as_circular:0,rlof_entry_threshold:0,rlof_f:0,rlof_interpolation_binary_c:0,rlof_interpolation_bs:0,rlof_interpolation_method:0,rlof_mdot_factor:0,rlof_mdot_modul:0,rlof_method:0,rlof_method_adapt:0,rlof_method_adaptive2:0,rlof_method_bs:0,rlof_method_claei:0,rlof_method_ritt:0,rlof_nonconservative_gamma_donor:0,rlof_nonconservative_gamma_isotrop:0,rlof_radiation_correct:0,rlof_transition_objects_escap:0,rob:[0,2,20],robert:[10,16],roch:[0,20],roche_lob:20,rochelob:20,room:6,root:[10,16],rotat:[0,2],rotation:0,rotationally_enhanced_expon:0,rotationally_enhanced_mass_loss:0,rotationally_enhanced_massloss:0,rotationally_enhanced_massloss_angmom:0,rotationally_enhanced_massloss_langer_formula:0,rotationally_enhanced_massloss_langer_formula_and_angmom:0,rotationally_enhanced_massloss_non:0,rout:0,routin:[0,5,6,14],row:14,rring:0,rssd:2,rst:[4,7],rsun:14,rubric:6,run:[0,1,4,5,6,8,10,12,15,16,17],run_example_binari:5,run_example_binary_with_custom_log:5,run_example_binary_with_run_system:5,run_example_binary_with_writing_logfil:5,run_example_custom_logging_autogener:5,run_system:[5,14,17],run_system_wrapp:[5,10,11],run_zero_probability_system:8,runtim:[1,8],russel:0,rzam:20,s_option:8,sai:0,said:0,same:[0,4,5,8,10,12,15,16],sampl:[0,2,6,18],sample_valu:2,sampler:10,sana12:[2,12,15],sana:2,save:[0,1,2,12,15],save_pre_events_stardata:0,scalo:2,scanf:0,scene:5,scheme:0,schneider:0,schroeder:0,script:[3,5,10,16],sdb:0,sdist:[10,16],sdo:0,search:10,second:[0,2,4,14],secondari:[2,20],section:[2,4,9,10,16],see:[0,5,6,10,14,16],seed:0,seem:[10,14,16],seen:4,segment:18,seitenzahl2013_model:0,seitenzahl:0,select:[0,4,5],selected_head:[4,5],selector:0,self:[6,8,12,15],semi:0,sent:0,sentenc:1,sep:[2,5,6,12,15,20],sep_max:[12,15],sep_min:[12,15],separ:[0,2,4,5,6,7,12,14,15,20],separation_quadrupl:0,separation_tripl:0,separta:0,seper:[12,15],sequenc:0,seri:0,serialis:[4,6],serv:[4,5,12,15],server:6,set:[0,1,2,4,6,7,8,10,12,14,15,16],set_moe_di_stefano_set:6,set_opt:2,setup:[10,16,17],sever:[5,7,8,14,17],sfh:2,shara:0,share:[1,5,8,12,17],shared_lib_filenam:5,shell:0,shorten:0,should:[0,1,2,5,6,7,8,10,12,14,15,16,17],shouldn:[0,4],show:[0,3,8,14],show_plot:14,show_stellar_typ:14,shown:[0,14],siess:0,sigma:2,silent:4,sill:0,simpl:15,simpli:0,simul:[0,1,12,15],simulation_:6,sinc:[4,12,14,15],singl:[0,2,6,8,12,14,15],sit:0,size:[4,6,8],skip:[0,4,8,10,16],skipkei:4,sliced_df:5,slope:2,slow:0,slower:0,slurm:[6,8,9],slurm_grid:6,small:0,small_envelope_method:0,small_envelope_method_bs:0,small_envelope_method_miller_bertolami:0,smaller:0,sn_impulse_liu2015:0,sn_impulse_non:0,sn_impulse_wheeler1975:0,sn_kick_companion_a:0,sn_kick_companion_aic_bh:0,sn_kick_companion_bh_bh:0,sn_kick_companion_bh_n:0,sn_kick_companion_ecap:0,sn_kick_companion_grb_collapsar:0,sn_kick_companion_hestaria:0,sn_kick_companion_ia_chand:0,sn_kick_companion_ia_chand_co:0,sn_kick_companion_ia_eld:0,sn_kick_companion_ia_h:0,sn_kick_companion_ia_he_co:0,sn_kick_companion_ia_hybrid_hecowd:0,sn_kick_companion_ia_hybrid_hecowd_sublumin:0,sn_kick_companion_ibc:0,sn_kick_companion_ii:0,sn_kick_companion_iia:0,sn_kick_companion_ns_n:0,sn_kick_companion_phdi:0,sn_kick_companion_pisn:0,sn_kick_companion_ppisn:0,sn_kick_companion_tz:0,sn_kick_companion_wdkick:0,sn_kick_dispersion_aic_bh:0,sn_kick_dispersion_bh_bh:0,sn_kick_dispersion_bh_n:0,sn_kick_dispersion_ecap:0,sn_kick_dispersion_grb_collapsar:0,sn_kick_dispersion_ia_hybrid_hecowd:0,sn_kick_dispersion_ia_hybrid_hecowd_sublumin:0,sn_kick_dispersion_ibc:0,sn_kick_dispersion_ii:0,sn_kick_dispersion_ns_n:0,sn_kick_dispersion_phdi:0,sn_kick_dispersion_pisn:0,sn_kick_dispersion_ppisn:0,sn_kick_dispersion_tz:0,sn_kick_distribution_aic_bh:0,sn_kick_distribution_bh_bh:0,sn_kick_distribution_bh_n:0,sn_kick_distribution_ecap:0,sn_kick_distribution_grb_collapsar:0,sn_kick_distribution_ia_hybrid_hecowd:0,sn_kick_distribution_ia_hybrid_hecowd_sublumin:0,sn_kick_distribution_ibc:0,sn_kick_distribution_ii:0,sn_kick_distribution_ns_n:0,sn_kick_distribution_phdi:0,sn_kick_distribution_pisn:0,sn_kick_distribution_ppisn:0,sn_kick_distribution_tz:0,sneia:0,snia:0,solar:[0,2,20],solver:0,solver_forward_eul:0,solver_predictor_corrector:0,solver_rk2:0,solver_rk4:0,some:[0,1,2,5,6,8,10,12,14,15,16],someth:[0,6],soon:18,sort:4,sort_kei:4,sourc:[1,2,3,4,5,6,7,8,11,14,15,17,18,20],source_file_filenam:8,source_list:6,sourcecod:[10,16],sourcefile_nam:1,space:[0,6,18],spacing_funct:[10,11],spacingfunc:[6,12,15],spacingfunct:6,special:0,specif:[0,4,14],specifi:[0,8],spectral:2,speed:[0,8],speedtest:0,spent:4,spheric:0,spin:0,spinrat:0,split:[0,8,12,15],splitpoint:0,spread:6,sqrt:0,src:[10,16],st1:5,st2:5,stabil:0,stabl:0,stancliff:0,standard:[0,2],star:[1,2,5,6,8,10,12,14,15,20],star_with_no_mass:0,stardata:[0,1,5,12,15],stardata_dump_filenam:0,stardata_load_filenam:0,start:[0,1,4,5,6,7,8],start_tim:0,state:0,statement:[1,5],statist:0,statu:[0,1],stderr:0,stdout:4,steadi:0,stefan:14,stefano:[4,6,10],stellar:[0,2,8,14,19],stellar_structure_algorithm:0,stellar_structure_algorithm_external_funct:0,stellar_structure_algorithm_mint:0,stellar_structure_algorithm_modified_bs:0,stellar_structure_algorithm_non:0,stellar_typ:[1,10,11,12,14,15],stellar_type_1:[0,14],stellar_type_2:[0,14],stellar_type_3:0,stellar_type_4:0,stellar_type_dict:19,stellar_type_dict_short:19,step:[6,14,18],stepsiz:6,stick:8,stiff:0,still:[1,8],stop:[0,4],stopfil:0,storag:0,store:[0,2,4,6,8,10,16,20],store_memaddr:20,str:[1,4,6,7,14],straight:6,straniero:0,streamhandl:6,strength:0,strict:4,string:[0,1,4,6,7,8,14,17],strip:0,stronger:0,struct:0,structur:[0,4,8,14],stuff:[4,8,12,14,15],style:0,sub:[0,4],subdict:4,subject:0,sublumin:0,submit:10,subroutin:9,subsequ:0,subtract:4,subtract_dict:4,succe:0,suggest:[0,10,16],suit:[10,16],sum:0,sundial:0,supercrit:0,supernova:[0,8],superwind:0,superwind_mira_switchon:0,supress:[12,15],sure:[2,6,8,10,14,16,17],surfac:0,surviv:0,survivor:0,switcher:0,symmetr:0,synchron:0,synonym:0,synthesi:[8,10,16],sys:5,system:[0,4,5,6,8,10,12,14,15,16,17],system_gener:6,system_queue_fil:6,t_re:5,tabl:[0,2],take:[0,2,4,5,6,8,12,15,17],taken:[0,4],tar:[10,16],target:[1,7],task:[0,2,4,5,6,7,9,14,17,18,20],tauri:0,tbse:0,teff:[0,2],teff_1:14,teff_2:14,tell:4,temp_dir:[4,12,15],temperatur:[0,2,14],tempfil:5,termin:[1,10,16],test:[0,4,6,8,10,16,20],test_log:5,test_pop:[12,15],text:[4,7],than:[0,2,4,8,10,16],thats:[12,15],thei:[0,2,4,6,8,14],thelog:0,them:[2,4,5,6,12,15],themselv:[2,4],thermal:[0,2,20],thermally_pulsing_asymptotic_giant_branch:0,thermohalin:0,thesi:0,thi:[0,1,2,3,4,5,6,7,8,10,11,12,14,15,16,17,18,20],thick:0,thick_disc_end_ag:0,thick_disc_logg_max:0,thick_disc_logg_min:0,thick_disc_start_ag:0,thin:0,thing:[0,2,4,5,6,7,12,15,17],think:[0,4,6],third:[0,2],third_dup:0,third_dup_multipli:0,thorn:0,those:[4,5,6,10,12,15,16],thread:8,thread_id:8,three:[0,2],three_part_powerlaw:[2,12,15],threshold:[0,4,8],through:[6,14,17],throughout:6,tidal:0,tidal_strength_factor:0,tide:0,tides_convective_damp:0,tides_hurley2002:0,tides_zahn1989:0,time:[0,1,2,4,5,6,8,10,12,14,15,16],timescal:0,timestamp:8,timestep:0,timestep_limit:0,timestep_log:0,timestep_modul:0,timestep_multipli:0,timestep_solver_factor:0,tinslei:2,titl:[7,13],tmp:[0,4,10,12,16],tmp_dir:[6,8],tmp_tabl:2,todo:[0,1,2,4,6,7,8,12,14,15,17,18,20],toler:0,too:[0,4,8,10,16,17],topic:0,torqu:0,total:[0,2,4,6,8,14],tout:[0,20],tpagb:0,tpagb_reimers_eta:0,tpagb_wind_beasor_etal_2020:0,tpagb_wind_bloeck:0,tpagb_wind_goldman_etal_2017:0,tpagb_wind_mattsson:0,tpagb_wind_reim:0,tpagb_wind_rob_cwind:0,tpagb_wind_van_loon:0,tpagb_wind_vw93_karaka:0,tpagb_wind_vw93_karakas_carbon_star:0,tpagb_wind_vw93_orig:0,tpagb_wind_vw93_orig_carbon_star:0,tpagbwind:0,tpagbwindfac:0,traceback:4,track:[8,14],trade:0,transfer:0,transform:[0,4],transit:0,treat:0,trigger:0,tripl:[0,2,8],truli:0,tupl:1,turn:[0,4,12,15],two:[0,4,19,20],txt:[5,6,17],type:[0,1,2,4,6,7,8,14,18,19,20],type_ia_mch_supernova_algorithm:0,type_ia_sub_mch_supernova_algorithm:0,typic:0,ubvri:0,ugriv:0,uncom:6,under:18,undergo:0,understand:6,undescrib:7,uniform:2,union:[2,4,6,18,20],uniqu:[4,6,8],unit:[0,20],univari:0,unknown:17,unless:[1,6,8],unload:6,unrecogn:[10,16],unsign:0,unstabl:0,until:[0,2,4,6],unus:[0,8],updat:[2,4,6,10,12,15,16],update_dict:4,upper:[0,2,18],usag:0,use:[0,2,4,5,6,8,9,10,12,14,15,16,17],use_astropy_valu:14,use_datadir:[6,12,15],use_fixed_timestep_:0,use_periastron_roche_radiu:0,use_tabular_intershell_abundances_karakas_2012:0,used:[0,1,2,4,6,8,12,14,15],useful:[0,4,6,8,10,16,17,20],useful_func:[10,11],user:[1,2,4,6,7,8,17],uses:[0,5,8,12,15],using:[0,1,3,5,6,10,12,15,16],usr:5,usual:[0,2,8],util:[1,2,4,5,6,7,12,14,15,17,18,20],val:2,valid:[0,2,4],valu:[0,1,2,4,5,6,7,8,12,14,15],valueerror:[12,15],valuerang:[6,12,15],van:0,vandenheuvel_log:0,vari:0,variabl:[0,4,6,8,12,15],variant:0,variou:0,vassiliadi:0,veloc:[0,2],verbos:[1,2,4,8,10,12,15,16],verbose_print:4,veri:[0,5,6,15,18],versa:20,version:[0,4,6,10,16],version_info:4,version_info_str:4,version_onli:0,via:[6,8,12,14,15],vice:20,vink:0,virtual:[10,16],virtualenviron:[10,16],viscos:0,viscou:0,visit:10,volum:0,vrot1:0,vrot2:0,vrot3:0,vrot4:0,vrot_breakup:0,vrot_bs:0,vrot_non_rot:0,vrot_sync:0,vw93:0,vw93_eagb_wind_spe:0,vw93_mira_shift:0,vw93_multipli:0,vw93_tpagb_wind_spe:0,vwind:0,vwind_beta:0,vwind_multipli:0,wai:[0,3,4,6,8,12,14,15],wang:0,want:[0,2,4,5,6,7,8,12,14,15],warmup_cpu:0,warn:0,wave:0,wd_accretion_rate_new_giant_envelope_lower_limit_helium_donor:0,wd_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor:0,wd_accretion_rate_new_giant_envelope_lower_limit_other_donor:0,wd_accretion_rate_novae_upper_limit_helium_donor:0,wd_accretion_rate_novae_upper_limit_hydrogen_donor:0,wd_accretion_rate_novae_upper_limit_other_donor:0,wd_kick:0,wd_kick_at_every_puls:0,wd_kick_at_given_puls:0,wd_kick_direct:0,wd_kick_end_agb:0,wd_kick_first_rlof:0,wd_kick_pulse_numb:0,wd_kick_when:0,wd_sigma:0,wdwd_merger_algorithm:0,wdwd_merger_algorithm_bs:0,wdwd_merger_algorithm_chen2016:0,wdwd_merger_algorithm_perets2019:0,weight:[0,8],well:[0,4,8,10,16],were:4,what:[0,1,2,4,5,6,7,8,10,12,15,16,17],whatev:[5,6,10,16],wheeler:0,when:[0,1,2,4,5,6,7,8,10,12,15,16,17],whenev:[10,16],where:[0,1,2,4,6,7,8,10,16],whether:[0,2,4,6,7,8,14,20],which:[0,1,2,3,4,5,6,7,8,10,12,15,16,17,20],whichev:8,white:0,white_dwarf_cooling_carrasco2014:0,white_dwarf_cooling_mestel:0,white_dwarf_cooling_mestel_modifi:0,white_dwarf_cooling_model:0,white_dwarf_radius_carrasco2014:0,white_dwarf_radius_model:0,white_dwarf_radius_mu:0,white_dwarf_radius_nauenberg1972:0,whole:[6,8],width:0,wind:0,wind_algorithm_binary_c_2020:0,wind_algorithm_hurley2002:0,wind_algorithm_non:0,wind_algorithm_schneider2018:0,wind_angmom_loss_bs:0,wind_angmom_loss_lw:0,wind_angmom_loss_lw_hybrid:0,wind_angmom_loss_spherically_symmetr:0,wind_angular_momentum_loss:0,wind_disc_angmom_fract:0,wind_disc_mass_fract:0,wind_djorb_fac:0,wind_gas_to_dust_ratio:0,wind_lbv_luminosity_lower_limit:0,wind_mass_loss:0,wind_multiplier_:0,wind_nieuwenhuijzen_luminosity_lower_limit:0,wind_type_multiplier_:0,within:[0,4,6,10,16],without:[2,6,8],won:0,wood:0,work:[0,4,5,10,14,15,16],would:[0,4,14],wouldn:6,wr_wind:0,wr_wind_bs:0,wr_wind_eldridg:0,wr_wind_fac:0,wr_wind_maeder_meynet:0,wr_wind_nugis_lam:0,wrap:[1,12,15],wrapper:[4,5,20],write:[1,4,5,6,7,8,12,15,17],write_binary_c_calls_to_fil:6,write_binary_c_parameter_descriptions_to_rst_fil:4,write_grid_options_to_rst_fil:7,written:[5,6,7,8,12,15,17],wrlof_mass_transf:0,wrlof_method:0,wrlof_non:0,wrlof_q_depend:0,wrlof_quadrat:0,wrong:[10,16],wrwindfac:0,wtts2:0,wtts_log:0,www:[0,2],year:[0,2],yet:[0,4,5,6,8,12,14,15],yield:0,you:[0,1,4,5,6,7,8,10,12,14,15,16,20],young:0,your:[5,8,10,16],yourself:[12,14,15],zahn:0,zam:[0,2,17,20],zams_collis:20,zams_mass:[12,15],zero:[0,1,8],zero_ag:[12,15],zone:0,zoom:0,zoomfac_multiplier_decreas:0,zoomfac_multiplier_increas:0,zsolar:2,zytkow:0},titles:["Binary_c parameters","custom_logging_functions module","distribution_functions module","Examples","functions module","Examples","grid_class module","Grid options and descriptions","Population grid code options","hpc_functions module","Welcome to binary_c-python\u2019s documentation!","Binarycpython code","Title page","Notebooks","plot_functions module","Example of population script","Python module for binary_c","run_system_wrapper module","spacing_functions module","stellar_types module","useful_funcs module"],titleterms:{"function":4,"public":8,after:[10,16],algorithm:0,binari:0,binary_c:[0,10,16],binarycpython:11,build:[10,16],code:[8,11],custom_logging_funct:1,descript:7,distribution_funct:2,document:[10,16],environ:[10,16],exampl:[3,5,10,15,16],faq:[10,16],from:[10,16],grid:[7,8],grid_class:6,hpc_function:9,indic:10,input:0,instal:[10,16],instruct:[10,16],issu:[10,16],misc:0,modul:[1,2,4,6,9,10,14,16,17,18,19,20],moe:8,note:[10,16],notebook:13,nucsyn:0,option:[7,8],output:0,page:12,paramet:0,pip:[10,16],plot_funct:14,popul:[8,15],privat:8,python:[10,16],requir:[10,16],run_system_wrapp:17,sampler:8,script:15,section:0,sourc:[10,16],spacing_funct:18,star:0,stefano:8,stellar_typ:19,tabl:10,titl:12,usag:[10,16],useful_func:20,variabl:[10,16],via:[10,16],welcom:10}})
\ No newline at end of file
+Search.setIndex({docnames:["binary_c_parameters","custom_logging_functions","distribution_functions","example_notebooks","functions","grid","grid_options_defaults","grid_options_descriptions","hpc_functions","index","modules","notebook_api_functionality","notebook_custom_logging","notebook_extra_features","notebook_individual_systems","notebook_population","plot_functions","readme_link","run_system_wrapper","spacing_functions","stellar_types","useful_funcs"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,"sphinx.ext.viewcode":1,nbsphinx:3,sphinx:56},filenames:["binary_c_parameters.rst","custom_logging_functions.rst","distribution_functions.rst","example_notebooks.rst","functions.rst","grid.rst","grid_options_defaults.rst","grid_options_descriptions.rst","hpc_functions.rst","index.rst","modules.rst","notebook_api_functionality.ipynb","notebook_custom_logging.ipynb","notebook_extra_features.ipynb","notebook_individual_systems.ipynb","notebook_population.ipynb","plot_functions.rst","readme_link.rst","run_system_wrapper.rst","spacing_functions.rst","stellar_types.rst","useful_funcs.rst"],objects:{"binarycpython.utils":{custom_logging_functions:[1,0,0,"-"],distribution_functions:[2,0,0,"-"],functions:[4,0,0,"-"],grid:[5,0,0,"-"],grid_options_defaults:[6,0,0,"-"],hpc_functions:[8,0,0,"-"],plot_functions:[16,0,0,"-"],run_system_wrapper:[18,0,0,"-"],spacing_functions:[19,0,0,"-"],stellar_types:[20,0,0,"-"],useful_funcs:[21,0,0,"-"]},"binarycpython.utils.custom_logging_functions":{autogen_C_logging_code:[1,1,1,""],binary_c_log_code:[1,1,1,""],binary_c_write_log_code:[1,1,1,""],compile_shared_lib:[1,1,1,""],create_and_load_logging_function:[1,1,1,""],from_binary_c_config:[1,1,1,""],return_compilation_dict:[1,1,1,""]},"binarycpython.utils.distribution_functions":{"const":[2,1,1,""],Arenou2010_binary_fraction:[2,1,1,""],Izzard2012_period_distribution:[2,1,1,""],Kroupa2001:[2,1,1,""],Moe_di_Stefano_2017_multiplicity_fractions:[2,1,1,""],Moe_di_Stefano_2017_pdf:[2,1,1,""],build_q_table:[2,1,1,""],calc_P_integral:[2,1,1,""],calc_e_integral:[2,1,1,""],calc_total_probdens:[2,1,1,""],calculate_constants_three_part_powerlaw:[2,1,1,""],cosmic_SFH_madau_dickinson2014:[2,1,1,""],duquennoy1991:[2,1,1,""],fill_data:[2,1,1,""],flat:[2,1,1,""],flatsections:[2,1,1,""],gaussian:[2,1,1,""],gaussian_func:[2,1,1,""],gaussian_normalizing_const:[2,1,1,""],get_integration_constant_q:[2,1,1,""],get_max_multiplicity:[2,1,1,""],imf_chabrier2003:[2,1,1,""],imf_scalo1986:[2,1,1,""],imf_scalo1998:[2,1,1,""],imf_tinsley1980:[2,1,1,""],interpolate_in_mass_izzard2012:[2,1,1,""],ktg93:[2,1,1,""],linear_extrapolation_q:[2,1,1,""],merge_multiplicities:[2,1,1,""],normalize_dict:[2,1,1,""],number:[2,1,1,""],poisson:[2,1,1,""],powerlaw:[2,1,1,""],powerlaw_constant:[2,1,1,""],powerlaw_extrapolation_q:[2,1,1,""],prepare_dict:[2,1,1,""],raghavan2010_binary_fraction:[2,1,1,""],sana12:[2,1,1,""],set_opts:[2,1,1,""],three_part_powerlaw:[2,1,1,""]},"binarycpython.utils.functions":{BinaryCEncoder:[4,2,1,""],Capturing:[4,2,1,""],binarycDecoder:[4,2,1,""],binaryc_json_serializer:[4,1,1,""],call_binary_c_config:[4,1,1,""],catchtime:[4,2,1,""],convert_bytes:[4,1,1,""],count_keys_recursive:[4,1,1,""],create_arg_string:[4,1,1,""],create_hdf5:[4,1,1,""],custom_sort_dict:[4,1,1,""],example_parse_output:[4,1,1,""],extract_ensemble_json_from_string:[4,1,1,""],filter_arg_dict:[4,1,1,""],get_arg_keys:[4,1,1,""],get_defaults:[4,1,1,""],get_help:[4,1,1,""],get_help_all:[4,1,1,""],get_help_super:[4,1,1,""],get_moe_di_stefano_dataset:[4,1,1,""],get_size:[4,1,1,""],handle_ensemble_string_to_json:[4,1,1,""],imports:[4,1,1,""],inspect_dict:[4,1,1,""],is_capsule:[4,1,1,""],load_logfile:[4,1,1,""],make_build_text:[4,1,1,""],merge_dicts:[4,1,1,""],multiply_values_dict:[4,1,1,""],output_lines:[4,1,1,""],parse_binary_c_version_info:[4,1,1,""],recursive_change_key_to_float:[4,1,1,""],recursive_change_key_to_string:[4,1,1,""],remove_file:[4,1,1,""],return_binary_c_version_info:[4,1,1,""],subtract_dicts:[4,1,1,""],temp_dir:[4,1,1,""],update_dicts:[4,1,1,""],verbose_print:[4,1,1,""],write_binary_c_parameter_descriptions_to_rst_file:[4,1,1,""]},"binarycpython.utils.functions.BinaryCEncoder":{"default":[4,3,1,""]},"binarycpython.utils.functions.Capturing":{__enter__:[4,3,1,""],__exit__:[4,3,1,""]},"binarycpython.utils.functions.binarycDecoder":{decode:[4,3,1,""]},"binarycpython.utils.functions.catchtime":{__enter__:[4,3,1,""],__exit__:[4,3,1,""]},"binarycpython.utils.grid":{Population:[5,2,1,""]},"binarycpython.utils.grid.Population":{Moe_di_Stefano_2017:[5,3,1,""],add_grid_variable:[5,3,1,""],evolve:[5,3,1,""],evolve_single:[5,3,1,""],export_all_info:[5,3,1,""],format_ensemble_results:[5,3,1,""],parse_cmdline:[5,3,1,""],return_all_info:[5,3,1,""],return_binary_c_defaults:[5,3,1,""],return_binary_c_version_info:[5,3,1,""],return_population_settings:[5,3,1,""],set:[5,3,1,""],set_moe_di_stefano_settings:[5,3,1,""],write_binary_c_calls_to_file:[5,3,1,""]},"binarycpython.utils.grid_options_defaults":{grid_options_description_checker:[6,1,1,""],grid_options_help:[6,1,1,""],print_option_descriptions:[6,1,1,""],write_grid_options_to_rst_file:[6,1,1,""]},"binarycpython.utils.plot_functions":{color_by_index:[16,1,1,""],dummy:[16,1,1,""],parse_function_hr_diagram:[16,1,1,""],parse_function_masses:[16,1,1,""],parse_function_orbit:[16,1,1,""],plot_HR_diagram:[16,1,1,""],plot_masses:[16,1,1,""],plot_orbit:[16,1,1,""],plot_system:[16,1,1,""]},"binarycpython.utils.run_system_wrapper":{run_system:[18,1,1,""]},"binarycpython.utils.spacing_functions":{"const":[19,1,1,""]},"binarycpython.utils.useful_funcs":{calc_period_from_sep:[21,1,1,""],calc_sep_from_period:[21,1,1,""],maximum_mass_ratio_for_RLOF:[21,1,1,""],minimum_period_for_RLOF:[21,1,1,""],minimum_separation_for_RLOF:[21,1,1,""],ragb:[21,1,1,""],roche_lobe:[21,1,1,""],rzams:[21,1,1,""],zams_collision:[21,1,1,""]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"],"2":["py","class","Python class"],"3":["py","method","Python method"]},objtypes:{"0":"py:module","1":"py:function","2":"py:class","3":"py:method"},terms:{"000":14,"0000":14,"000000000000e":14,"0001":[11,21],"000116989":15,"000121486":15,"000150087":15,"000154349":15,"000157195":15,"000172877":15,"000211219":15,"00028381":15,"000381347":15,"000512406":15,"000610573":15,"000627913":15,"000688507":15,"0007":2,"000925128":15,"001":[0,11],"00124307":15,"00167028":15,"00224431":15,"00498":15,"005444573822104362":15,"00632092":11,"006827156705e":15,"007109286263e":15,"0073157281034221516":15,"009829948023831718":15,"013208238029791246":15,"01344":15,"0141":11,"0144107":15,"015033359333e":15,"0154":15,"017435498578e":15,"027099358410e":15,"041660877905e":12,"041662558619e":12,"041662560111e":12,"041662564579e":12,"04459e":15,"047074050271e":15,"05150046619238191":15,"05150046619238192":15,"05193":15,"054":2,"055645404546e":15,"0587":15,"069363482023e":15,"069567332611e":15,"069626478211e":15,"069627290216e":15,"07011e":15,"074084349384e":15,"075844624794e":15,"07671":15,"0820":[0,11],"08519":15,"08624781646269201":15,"0862478164626921":15,"087296558990e":15,"08861e":15,"08873e":15,"08msun":[0,11],"0902":[0,11],"09216":15,"0x7f163859d0c0":11,"0x7f9265091598":14,"0x7ff3bdf79620":15,"100":[0,2,11],"1000":7,"10328":15,"10417":15,"10433":15,"10446":15,"104706358826e":15,"1048014407228":15,"1085":14,"108751340926e":15,"11003":14,"112":15,"11282":15,"115":2,"11582":14,"117519147635e":15,"119":15,"12303":15,"12325":14,"12457":14,"12460":14,"12461":14,"12462":14,"125":[0,11,15],"12500":0,"126828648362e":15,"12e":[1,12,14,15],"1300":14,"1302":14,"13462":14,"1357":12,"13876":15,"13e3":[0,11],"1403":2,"14057":12,"14059":12,"14462":14,"146421815741e":15,"150":15,"15000":[0,11,12,14,15],"1506841305680684":15,"15343":15,"1564":15,"15854":15,"15875":15,"15msun":2,"1612":14,"1613":14,"1614":14,"1615":14,"1616":14,"1628444120":15,"1628444121":15,"170425790780e":15,"170770422321e":15,"170770599495e":15,"170775828562e":15,"171086983243e":15,"171108213270e":15,"172196856333e":15,"17639":15,"18838":15,"18914e":15,"190":0,"19314":12,"194842917007e":15,"1951":[0,11],"1972":[0,11],"1975":[0,11],"197x":[0,11],"1980":2,"1983":21,"1986":[0,2,11],"1989":[0,11],"1991":2,"1993":[0,11],"1996":21,"1998":[0,2,11],"1999":[0,11],"1ckzg0p9":[9,17],"1e2":[0,11],"1e9":[0,11],"200":[0,11],"2000":[0,11],"2001":2,"2002":[0,11],"2003":[0,2,11],"2004":[0,11],"2005":[0,11],"2009":[0,11],"2010":[0,2,7,11],"2012":[0,2,11],"2013":[0,11],"2014":[0,2,11],"2015":[0,11],"2016":[0,11],"2017":[0,7,11,15],"2018":[0,1,11],"2019":[0,11],"2020":[0,11],"2021":0,"20210807":0,"20484":15,"206771867883e":15,"20787":15,"21331":15,"21473":15,"21673":15,"2174":15,"21805":15,"21878":15,"218786094847e":15,"21892":15,"21893":15,"222715508467e":15,"22723621650191106":15,"22759":15,"230407246199e":15,"232906623449e":15,"234709":15,"23604":15,"2383":14,"2424":14,"24954e":15,"25294":15,"2535":15,"257":21,"25msun":[0,11],"27442":15,"27563":15,"27565":15,"27572":15,"27804":15,"278384712062e":15,"281":21,"28672":15,"29402e":15,"29444":15,"294870923827e":15,"29678":15,"2969346":2,"29746":15,"2983275843337705":15,"29864":15,"29942":15,"29977":15,"29994":15,"2a7732d03e594ef4b5dfe9051b41d9c0":15,"2msun":[0,11],"3000":[0,11],"30145":15,"30149":15,"30197":15,"3032":15,"30337":15,"30504":15,"30e4":[0,11],"31004":15,"315554923168e":15,"3177":15,"32047":15,"3205":15,"32641e":15,"33062":15,"33079":15,"33524":12,"337250536639e":15,"34071e":15,"34281":15,"34903":15,"34922":15,"34937":15,"350021848285e":15,"35209":15,"3552":15,"364277535630e":15,"3678":15,"3680f3882c0a449c944462abffea2447":15,"36979":15,"36m":11,"38004":15,"38063":12,"3836":15,"38403":15,"38887e":15,"3933":15,"3msun":2,"4000":0,"4046":15,"40513":15,"40745":15,"40749":15,"40935":15,"41074":15,"41264":15,"41295e":15,"42148e":15,"42212":15,"42238":15,"42375":15,"42msun":[0,11],"43925":15,"439623364590e":15,"4424":15,"446":12,"449960890183e":15,"44msun":[0,11],"4500":11,"45000000080":15,"4530":[12,14],"458869865939e":15,"459153942631e":15,"45msun":[0,11],"4603":15,"47276":15,"47961":15,"47976e":15,"48488":15,"4e3":[0,11],"500":[0,11],"5102526289471614":15,"513216011269e":15,"522806":14,"523":14,"525":15,"527722847382e":15,"52963":15,"53113":15,"53174":15,"53175":15,"53176":15,"53177":15,"53183":15,"53184":15,"5357":15,"53631":15,"53922":15,"556479830908e":15,"55924":15,"561265707015991":15,"56776":15,"5689":15,"571858031651e":15,"575":15,"577754":14,"59052":15,"59499":15,"5msun":[0,11],"600000":0,"60808":15,"6101":0,"61349":12,"6246354579925537":15,"62486":15,"625":0,"62517":15,"64419":15,"65097":15,"653200958306e":15,"67365":14,"687368550125e":15,"68933e":15,"693213405973e":15,"6944":0,"6e1":2,"6e5":[0,11],"6msun":[0,11],"70319":15,"70668e":15,"71025":15,"71288":15,"7197":15,"721374713429e":15,"723547465714e":15,"723570798020e":15,"72498e":[12,15],"72638":15,"726405299909e":15,"730":[12,15],"73221":15,"733614170983e":15,"733794947644e":15,"733865371895e":15,"7358":[11,12,14],"73856":15,"74037":12,"7431":15,"750574783854e":15,"753837732894e":15,"7619":0,"763":2,"764340254985e":15,"765535914728e":15,"765996194699e":15,"76647":15,"766606588165e":15,"768305081494e":15,"773581245005e":12,"774":14,"7797017097473145":15,"78096":15,"78125":0,"783":14,"78384":15,"79411e":15,"795":2,"797342083485e":15,"802132608769e":15,"80457":15,"806014211040e":15,"806123543037e":15,"807147339697e":15,"80msol":2,"81391":15,"8162e":15,"817":14,"8178":15,"81906":15,"82242e":15,"84162":15,"853070305680e":15,"85486":15,"862081089332e":15,"8628":15,"862942347290e":15,"863377990313e":15,"867655467480e":15,"878236827680e":12,"881529045940e":15,"88566":15,"8955":14,"917420996633e":15,"92267":12,"922967341481e":15,"931266944719e":15,"93135e":15,"933751523833e":15,"94027":15,"941017702765e":15,"9514":14,"9545065608702976":15,"9713":15,"97286e":15,"974759306305e":15,"97823":15,"9791":15,"980988739731e":15,"9863e":15,"990017992944e":15,"99198":12,"99255":15,"99283":15,"99471":15,"boolean":[0,4,5,7,11,16,21],"break":[0,11],"case":[0,4,7,11,15],"catch":[4,7,14,15],"char":7,"class":[4,5],"const":[2,5,15,19],"default":[0,1,2,4,5,6,7,11,12,15,18],"export":[4,5,15],"float":[0,2,4,11,14,19,21],"function":[0,1,2,3,5,6,7,8,9,10,12,16,17,18,19,21],"import":[4,5,11,12,14,15],"int":[0,1,2,4,5,6,7,11,15,19,21],"long":[0,4,5,7,11,15,20],"new":[0,2,4,5,11,14,15],"null":[0,4,11,12],"paczy\u0144ski":[0,11],"public":[6,9,15],"return":[1,2,4,5,6,7,11,14,15,16,18,19,21],"short":[0,11,20],"super":[0,11],"switch":[0,11],"throw":[9,17],"true":[0,4,5,6,7,11,15,16],"try":[0,9,11,14,15,17],"void":12,"while":[0,11],Added:15,Adding:[3,14],And:[6,9,17,21],But:14,Doing:15,For:[0,4,9,11,12,14,16,17],Gas:[0,11],Its:7,NOT:[0,11,18],Not:7,One:[0,11],Pms:16,That:[0,11],The:[0,1,2,3,4,5,7,9,11,12,14,15,16,17,18],Then:[4,9,17],There:[2,5,6,7,11,12,14,15,16],These:[4,7,11,15,16],Use:[0,5,11,15],Used:[0,7,11,16],Useful:[0,5,6,11,15],Uses:[0,11,19],Using:[3,9],Was:[0,11],Will:[0,4,5,11,15,18],With:6,__arg_begin:11,__attribute__:12,__enter__:4,__exit__:4,_actually_evolve_system:7,_binary_c_bind:[4,11,12,14,21],_binary_c_config_execut:7,_binary_c_dir:7,_binary_c_execut:7,_binary_c_shared_librari:7,_calculate_multiplicity_fract:15,_commandline_input:7,_count:7,_custom_logging_shared_library_fil:7,_end_time_evolut:7,_errors_exceed:7,_errors_found:7,_evolution_type_opt:7,_failed_count:7,_failed_prob:7,_failed_systems_error_cod:7,_generate_grid_cod:7,_grid_vari:7,_loaded_ms_data:7,_main_pid:7,_population_id:7,_probtot:7,_process_run_population_grid:7,_repeat:7,_set:5,_set_ms_grid:7,_start_time_evolut:7,_store_memaddr:7,_system_gener:7,_total_mass_run:7,_total_probability_weighted_mass_run:7,_total_starcount:7,_zero_prob_stars_skip:7,abat:[0,11],abbrevi:20,abl:11,about:[4,5,6,15,21],abov:[0,2,4,5,11,12,14,15],abridg:[11,12],absolut:[0,11],abund:[0,11],acceler:[0,11],accept:[4,11,15],access:[2,7,12,14,15],accord:[0,2,11],accordingli:[14,15],account:[0,7,11],accret:[0,11],accretion_limit_dynamical_multipli:[0,11],accretion_limit_eddington_lmms_multipli:[0,11],accretion_limit_eddington_steady_multipli:[0,11],accretion_limit_eddington_wd_to_remnant_multipli:[0,11],accretion_limit_thermal_multipli:[0,11],accretor:[0,11,21],act:[0,7,11,15],activ:[0,9,11,17],actual:[0,4,5,7,9,11,12,14,15,16,17],adam:[0,11],adapt:[0,11],add:[2,4,5,7,12,14,15,16,19,21],add_grid_vari:[5,15],added:[4,14],adding:[14,15],address:[1,7,11,12,21],admittedli:16,adress:[11,12,21],advis:12,affect:[0,11],after:[0,5,7,11,12,15],ag89:[0,11],again:[4,5,7,9,14,17],against:16,agb:[0,11],agb_3dup_algorithm:[0,11],agb_core_algorithm:[0,11],agb_core_algorithm_default:0,agb_core_algorithm_hurlei:0,agb_core_algorithm_karaka:0,agb_luminosity_algorithm:[0,11],agb_luminosity_algorithm_default:0,agb_luminosity_algorithm_hurlei:0,agb_luminosity_algorithm_karaka:0,agb_radius_algorithm:[0,11],agb_radius_algorithm_default:0,agb_radius_algorithm_hurlei:0,agb_radius_algorithm_karaka:0,agb_third_dredge_up_algorithm_default:0,agb_third_dredge_up_algorithm_hurlei:0,agb_third_dredge_up_algorithm_karaka:0,agb_third_dredge_up_algorithm_stancliff:0,age:[0,11],aging:[0,11],albedo:[0,11],algorithm:[9,11],algothim:[0,11],all:[0,1,2,4,5,6,7,9,10,11,14,15,16,17,18],all_info:5,alloc:11,allow:[0,2,4,7,11,12],allow_nan:4,along:[0,6,7],alpha:[0,11],alpha_c:[0,11],alphacb:[0,11],alreadi:[5,15],also:[0,3,4,5,6,9,11,12,15,17,21],altern:[0,7,11],alwai:[0,2,7,11],amanda:[0,11],amax:2,amin:2,amount:[0,4,5,6,7,11,15,19],amp:11,amt_cor:[7,15],analys:18,analyt:[5,15],analyz:14,andrew:[9,17],andronov:[0,11],angelou_lithium_cheb_decay_tim:[0,11],angelou_lithium_cheb_massfrac:[0,11],angelou_lithium_cheb_tim:[0,11],angelou_lithium_decay_funct:[0,11],angelou_lithium_decay_tim:[0,11],angelou_lithium_eagb_decay_tim:[0,11],angelou_lithium_eagb_massfrac:[0,11],angelou_lithium_eagb_tim:[0,11],angelou_lithium_gb_decay_tim:[0,11],angelou_lithium_gb_massfrac:[0,11],angelou_lithium_gb_tim:[0,11],angelou_lithium_hg_decay_tim:[0,11],angelou_lithium_hg_massfrac:[0,11],angelou_lithium_hg_tim:[0,11],angelou_lithium_lmms_decay_tim:[0,11],angelou_lithium_lmms_massfrac:[0,11],angelou_lithium_lmms_tim:[0,11],angelou_lithium_ms_decay_tim:[0,11],angelou_lithium_ms_massfrac:[0,11],angelou_lithium_ms_tim:[0,11],angelou_lithium_tpagb_decay_tim:[0,11],angelou_lithium_tpagb_massfrac:[0,11],angelou_lithium_tpagb_tim:[0,11],angelou_lithium_vrot_trigg:[0,11],angelou_lithium_vrotfrac_trigg:[0,11],angular:[0,11,16],ani:[0,2,4,5,9,11,14,15,17],anoth:[0,11],ansi:[0,11],anyth:[0,7,11,15],anywai:[5,14,15],anywher:[5,15],api:[0,3,4,9],api_log_filename_prefix:[0,11],append:[1,4,14],appli:[0,11],appropri:[0,7,11],approxim:[0,11],aren:[2,7],arenou2010_binary_fract:2,arg:[2,4,11,15,16],arg_dict:4,argopt:[0,11],argpair:4,argstr:[11,12,14],argument:[0,2,4,5,7,11,14,15,18],argument_of_periastron:[0,11],argument_of_periastron_quadrupl:[0,11],argument_of_periastron_tripl:[0,11],around:[0,11,12,14],arrai:[2,4,7,14],artifici:[0,11],artificial_accretion_end_tim:[0,11],artificial_accretion_ignor:0,artificial_accretion_start_tim:[0,11],artificial_angular_momentum_accretion_r:[0,11],artificial_mass_accretion_r:[0,11],artificial_orbital_angular_momentum_accretion_r:[0,11],arxiv:[0,2,11],ask:[0,11,21],asplund:[0,11],assign:[5,15],assum:[0,11,16],ast871:[0,11],astronomi:[0,11],astropi:[9,16,17],atom:4,attempt:[4,5],aug:0,auto:[1,10],autogen_c_logging_cod:[1,12],automat:[0,1,6,9,11,12,17],avaibl:[9,17],avail:[0,4,7,11,12,15,16],avoid:11,awai:[0,11],axi:[0,11,16],b_1:[0,11],b_2:[0,11],b_3:[0,11],b_4:[0,11],b_inclination1:[0,11],b_inclination2:[0,11],b_inclination3:[0,11],b_inclination4:[0,11],back:[0,4,11],backward:[0,11],bagb:[0,11],barn:[0,11],base:[0,2,4,5,9,11,15,16,17,21],base_filenam:[5,15],basic:[5,15],batchmod:[0,11],beasor:[0,11],becaus:[0,2,5,7,9,11,14,17],becom:[0,1,2,4,11,12],been:[0,5,7,11],befor:[0,5,7,9,11,15,17],behaviour:[4,15,18],belczynski:[0,11],below:[0,3,7,11,12,15],berro:[0,11],bertolami:[0,11],best:[5,7,9,17],beta:[0,11],beta_reverse_nova:[0,11],beta_reverse_novae_geometri:0,better:[0,4,5,11,15],between:[0,2,11,19],bewar:[5,15],bh_belczynski:0,bh_fryer12_delai:0,bh_fryer12_rapid:0,bh_hurley2002:0,bh_prescript:[0,11],bh_spera2015:0,big:[0,7,11],biinari:15,bin:[0,9,11,17],binari:[2,5,7,9,11,14,15,16,17,21],binary_c2:[9,17],binary_c:[1,2,4,5,7,12,14,15,16,18],binary_c_api_funct:12,binary_c_cal:[5,15],binary_c_default:15,binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0:15,binary_c_inline_config:1,binary_c_log_cod:[1,12,14],binary_c_macro:[0,11],binary_c_output:4,binary_c_paramet:[0,11,15],binary_c_python:[4,5,11,14,15],binary_c_task_:[0,11],binary_c_write_log_cod:1,binary_grid:[0,11],binary_star:21,binaryc:[1,4,18],binaryc_config:1,binaryc_json_seri:4,binarycdecod:4,binarycencod:4,binarycpython3:11,binarycpython:[1,2,3,4,5,6,9,12,16,17,18,19,21],binarygrid:15,bind:[0,11,12,14],birth:[0,11],bit:2,bivari:[0,11],black:[0,11],black_hol:0,bloecker:[0,11],blog:1,boltzman:16,boltzmann:[0,11],bondi:[0,11],bondi_hoyle_accretion_factor:[0,11],bool:[4,5,6,15,16],born:[0,11],bosswissam:4,both:[0,4,11,15],bottom:[0,11,15],bound:[2,19],boundari:2,brake:[0,11],branch:[0,4,11],branch_david:0,branchpoint:[5,15],breakup:[0,11],broken:[0,11],bse:[0,2,11,12,15],bse_opt:[5,14,15],bsf:[0,11],buffer:[0,11],build:[0,1,4,11],build_q_tabl:2,built:[0,1,4,9,17],burn:[0,11],busso:[0,11],bye:[0,11],c13_eff:[0,11],c5232be5c:0,c_auto_log:7,c_log:0,c_logging_cod:[7,12,14,15],calc_e_integr:2,calc_p_integr:2,calc_period_from_sep:21,calc_sep_from_period:[15,21],calc_total_probden:2,calcul:[0,2,4,5,7,11,15,21],calculate_constants_three_part_powerlaw:2,call:[0,1,4,5,7,11,14,15,16,18],call_binary_c_config:4,calls_filenam:15,can:[0,1,2,4,5,7,9,11,12,14,15,16,17,18],cannot:[5,12],canon:7,cap:[0,11],capsul:[1,4,11],captur:[0,4,11],carbon:[0,11],carbon_oxygen_white_dwarf:0,carlo:[0,7,11],carrasco:[0,11],carri:[0,11],cast:4,catchtim:4,categor:11,categori:[11,15],categoris:4,caught:[4,14],caus:21,cbdisc:[0,11],cbdisc_albedo:[0,11],cbdisc_alpha:[0,11],cbdisc_eccentricity_pumping_dermin:0,cbdisc_eccentricity_pumping_method:[0,11],cbdisc_eccentricity_pumping_non:0,cbdisc_end_evolution_after_disc:[0,11],cbdisc_fail_ring_inside_separ:[0,11],cbdisc_gamma:[0,11],cbdisc_init_djdm:[0,11],cbdisc_init_dm:[0,11],cbdisc_inner_edge_strip:[0,11],cbdisc_inner_edge_stripping_timescal:[0,11],cbdisc_kappa:[0,11],cbdisc_mass_loss_constant_r:[0,11],cbdisc_mass_loss_fuv_multipli:[0,11],cbdisc_mass_loss_inner_l2_cross_multipli:[0,11],cbdisc_mass_loss_inner_viscous_accretion_method:[0,11],cbdisc_mass_loss_inner_viscous_accretion_method_equ:0,cbdisc_mass_loss_inner_viscous_accretion_method_gerosa_2015:0,cbdisc_mass_loss_inner_viscous_accretion_method_non:0,cbdisc_mass_loss_inner_viscous_accretion_method_young_clarke_2015:0,cbdisc_mass_loss_inner_viscous_angular_momentum_multipli:[0,11],cbdisc_mass_loss_inner_viscous_multipli:[0,11],cbdisc_mass_loss_ism_pressur:[0,11],cbdisc_mass_loss_ism_ram_pressure_multipli:[0,11],cbdisc_mass_loss_xray_multipli:[0,11],cbdisc_max_lifetim:[0,11],cbdisc_minimum_evaporation_timescal:[0,11],cbdisc_minimum_fr:[0,11],cbdisc_minimum_luminos:[0,11],cbdisc_minimum_mass:[0,11],cbdisc_no_wind_if_cbdisc:[0,11],cbdisc_outer_edge_strip:[0,11],cbdisc_outer_edge_stripping_timescal:[0,11],cbdisc_resonance_damp:[0,11],cbdisc_resonance_multipli:[0,11],cbdisc_torquef:[0,11],cbdisc_viscous_l2_coupl:[0,11],cbdisc_viscous_photoevaporative_coupl:[0,11],cbdisc_viscous_photoevaporative_coupling_inst:[0,11],cbdisc_viscous_photoevaporative_coupling_non:[0,11],cbdisc_viscous_photoevaporative_coupling_visc:[0,11],cee:[0,11],cell:[11,15],cemp:[0,11],cemp_cfe_minimum:[0,11],center:[5,15],central_object:[0,11],certain:[7,9,17],cf_amanda_log:[0,11],cflag:[9,17],chabrier:2,chandrasekhar:[0,11],chandrasekhar_mass:[0,11],chang:[0,1,2,4,5,6,7,9,11,12,15,17],chapter:[0,7,10],cheb:[0,11],check:[0,2,4,5,6,11,15,21],check_circular:4,chemic:[0,11],chen:[0,11],child:4,choic:[0,2,11,16],choos:[0,11,12,16],chose:14,chosen:[5,15],circular:[0,11],circumbinari:[0,11],circumstanti:[0,11],claei:[0,11],clark:[0,11],clean:[1,5,9,14,17],clean_up_custom_logging_fil:5,clear:4,clock:4,clone:[9,17],close:[0,11],cloud:[0,11],cls:4,cluster:8,cmdline:5,code:[0,1,5,6,9,11,12,14,15,16,17,18],collaps:[0,11],collapsar:[0,11],collect:21,collid:21,color:16,color_by_index:16,colour:[0,11],colour_log:[0,11],column:[14,15,16],column_nam:14,com:[1,4],combin:[1,4,5,7,12],combine_ensemble_with_thread_join:7,come:[2,9,17,19],comenv_bs:0,comenv_disc_angmom_fract:[0,11],comenv_disc_mass_fract:[0,11],comenv_ejection_spin_method:[0,11],comenv_ejection_spin_method_do_noth:[0,11],comenv_ejection_spin_method_sychron:[0,11],comenv_ejection_spin_method_synchron:0,comenv_merger_spin_method:[0,11],comenv_merger_spin_method_breakup:0,comenv_merger_spin_method_conserve_angmom:[0,11],comenv_merger_spin_method_conserve_omega:[0,11],comenv_merger_spin_method_specif:[0,11],comenv_ms_accret:[0,11],comenv_ms_accretion_fract:[0,11],comenv_ms_accretion_mass:[0,11],comenv_nandez2016:0,comenv_nelemans_tout:0,comenv_ns_accret:[0,11],comenv_ns_accretion_fract:[0,11],comenv_ns_accretion_mass:[0,11],comenv_post_eccentr:[0,11],comenv_prescript:[0,11],comenv_splitmass:[0,11],comenv_undef:0,command:[0,1,5,7,9,11,15,17],commandlin:15,comment:15,commit:4,common:[0,11,12,14,15],compact:15,companion:[0,11],compar:[0,7,11,15],compil:[1,9,12,15,17],compile_shared_lib:1,complet:15,complex:[5,7,12,15,16],compon:[4,16],comput:[0,8,11],condit:[5,12,15],condor:[5,7,8],condor_grid:5,config:[1,4,7,9,17],config_fil:1,configur:[2,5,14,15],conserv:[0,11],consid:[0,1,2,4,5,7,11,16],constant:[0,2,11,16],construct:[0,1,11,14,15],contain:[0,1,2,4,5,6,7,8,9,10,11,14,15,16,17,18,19,20],content:[3,4,9,11],context:4,continu:[5,15],control:[0,11,15],convect:[0,11],converg:[0,11],convert:[2,4,5],convert_byt:4,cool:[0,11],copi:[0,5,11,21],core:[0,5,7,11,15,16],core_co:12,core_h:12,core_helium_burn:0,core_mass:[0,11,12],correct:[2,5,14,16,21],correctli:[9,14,16,17],correspond:16,corretor:[0,11],cosmic:2,cosmic_sfh_madau_dickinson2014:2,could:[0,4,11,15],count:[4,7],count_keys_recurs:4,counter:7,coupl:[0,11],cours:16,cover:13,coverag:[9,17],cowd:[0,11],cpu:[0,11],cpython:11,crap_paramet:[0,11],creat:[2,4,5,12,14,15],create_and_load_logging_funct:[1,12],create_arg_str:4,create_hdf5:4,creation:11,critic:[0,11],cross:[0,11],ctype:1,cuntz:[0,11],current:[0,4,9,11,12,17],custom:[0,1,3,4,5,7,9,11,14,15,16,18],custom_log:[5,7,14],custom_logging_cod:[1,12,14,18],custom_logging_func_memaddr:[7,11,12],custom_logging_funct:[7,9,10,12,14,15],custom_logging_info:5,custom_logging_memaddr:12,custom_logging_print_stat:14,custom_logging_stat:15,custom_opt:[5,14,15],custom_output_funct:12,custom_sort_dict:4,custom_tmp_dir:1,customis:16,cvode:[0,11],d20a4c74d20a43b881c0c9e5def5f76c:15,dai:[0,2,11,12,14,15,21],damp:[0,11],dat:[0,4,15],data:[0,4,5,7,11,14,15,18],data_dict:2,data_dir:[4,5,7,15],datadir:[5,15],datafram:[14,16],dataset:[4,15],date:5,david:[0,9,11,17],david_logging_funct:[0,11],dd7:[0,11],deactiv:[0,11],deal:[4,14],death:[0,11],debug:[0,7,11,15],decai:[0,11],decid:[0,4,11,12],decod:4,decreas:[0,11],deeper:[5,15],def:[14,15],default_to_metal:[0,11],defaultdict:4,defer:[0,11],defin:[0,1,2,5,11,16],definit:[1,21],degener:[0,11],degre:[0,11],delta_mcmin:[0,11],den:[0,11],densiti:2,depend:[0,2,9,11,16,17],deprec:[0,11],dermin:[0,11],describ:[0,2,7,11],descript:[0,2,4,7,9,10,11],design:[5,16],desir:[0,11],destruct:[5,15],detail:[0,4,11,14],detect:[0,11],determin:[0,5,11,12,15,21],deton:[0,11],dev:[0,11],develop:1,deviat:2,dewi:[0,11],dex:[0,11],diagnost:7,diagram:[0,11,16],dickonson:2,dict2:4,dict:[1,2,4,5,6,14,15,20],dict_1:4,dict_2:4,dict_kei:14,dictionari:[1,2,4,5,6,7,15,16,20],did:[4,9,17],differ:[0,4,5,9,11,15,16,17],dimmer:[0,11],dir:[9,17],direct:[0,5,11],directli:[4,7,14],director:7,directori:[0,3,4,5,7,9,11,15,17],disabl:[0,11,15],disable_debug:[0,11],disable_end_log:[0,11],disable_ev:[0,11],disc:[0,11],disc_legacy_log:[0,11],disc_log2d:[0,11],disc_log:[0,11],disc_log_directori:[0,11],disc_log_dt:[0,11],disc_log_level_non:0,disc_log_level_norm:0,disc_log_level_normal_first_disc_onli:0,disc_log_level_subtimestep:0,disc_log_level_subtimestep_first_disc_onli:0,disc_n_monte_carlo_guess:[0,11],disc_stripping_timescale_infinit:0,disc_stripping_timescale_inst:0,disc_stripping_timescale_orbit:0,disc_stripping_timescale_visc:0,disc_timestep_factor:[0,11],discret:15,discs_circumbinary_from_comenv:[0,11],discs_circumbinary_from_wind:[0,11],disk:[0,5,11],dispers:[0,11],displai:[0,11],dist:[9,17],distefano:2,distribut:[0,2,5,8,11,15],distribution_funct:[9,10,15],divid:8,dlnm1:[5,15],dlog10per:15,dlogp:2,do_dry_run:7,doc:[4,6,9,15,17],doc_fetch:2,docstr:[9,14,16,17],document:[4,6,7,10,15],doe:[0,2,4,5,7,11,12,14,15,21],doesn:[5,7],doesnt:6,doing:[0,1,5,6,9,11,17],don:[2,4,7],done:[0,4,5,9,11,15,17],donor:[0,11,21],donor_limit_dynamical_multipli:[0,11],donor_limit_envelope_multipli:[0,11],donor_limit_thermal_multipli:[0,11],donor_rate_algorithm_bs:0,donor_rate_algorithm_claeys2014:0,dont:11,doubl:[12,15],down:15,dphasevol:[5,15],dr2:[0,11],dr3:[0,11],drai:[0,11],dredg:[0,11],drop:14,dry:7,dstep:2,dtfac:[0,11],dtlimit:4,dtm:[1,12,15],due:[9,17],dummi:[2,16],dump:[0,4,11,14],dumpvers:[0,11],duquennoi:2,duquennoy1991:2,dure:[0,11],dust:[0,11],dwarf:[0,11],dynam:[0,11],e2_hurley_2002:0,e2_izzard:0,e2_mint:0,e2_prescript:[0,11],each:[0,2,4,5,7,11,15],eagb:[0,11],eagb_wind_beasor_etal_2020:0,eagb_wind_bs:0,eagb_wind_goldman_etal_2017:0,eagbwind:[0,11],eagbwindfac:[0,11],earli:[0,11],early_asymptotic_giant_branch:0,easi:[4,14],easier:[4,15],ecc2:2,ecc3:2,ecc:[2,5,14,15],eccentr:[0,2,11,12,14,15,16,21],eccentric_rlof_model:[0,11],eccentricity_quadrupl:[0,11],eccentricity_tripl:[0,11],echo:[0,11],eddington:[0,11],edg:[0,5,11,15],edit:12,edu:[0,11],effect:[0,2,7,11,12],effective_metal:[0,11],effici:[0,11],egg:[9,17],eggleton:[0,11,21],either:[0,4,5,7,9,11,15,17,18],eject:[0,11],elabor:12,eld:[0,11],eldridg:[0,11],electon:[0,11],electron:[0,11],element:[0,1,4,7,11,16],els:12,email:4,emp:[0,11],emp_feh_maximum:[0,11],emp_logg_maximum:[0,11],emp_minimum_ag:[0,11],empti:[4,6,14],enabl:[0,11],encod:4,encount:7,end:[0,2,4,7,11],end_index:2,end_timestamp:15,energi:[0,11],enhanc:[0,11],enlarg:[0,11],enough:2,ensembl:[0,4,5,7,11,15],ensemble_def:[0,11],ensemble_dictionari:5,ensemble_dt:[0,11],ensemble_factor_in_probability_weighted_mass:7,ensemble_filter_:[0,11],ensemble_filters_off:[0,11],ensemble_json:4,ensemble_legacy_ensembl:[0,11],ensemble_list:5,ensemble_logdt:[0,11],ensemble_logtim:[0,11],ensemble_macro:[0,11],ensemble_output_:7,ensemble_startlogtim:[0,11],ensure_ascii:4,enter:[0,9,11,17],enthalpi:[0,11],entir:[12,14],entri:[4,5],env:[9,11,16,17],envelop:[0,11],equal:[4,15],equat:[0,11],equation_of_state_algorithm:[0,11],equation_of_state_paczynski:0,equatori:[0,11],equival:7,errno:[9,17],error:[0,4,7,9,11,15,17],errors_exceed:15,errors_found:15,esa:2,escap:[0,11],escape_fract:[0,11],escape_veloc:[0,11],eta:[0,11],etal:[0,11],etc:[0,4,5,8,9,11,14,15,16,17,18],euler:[0,11],evalu:[2,5,15,21],evan:[0,11],evapor:[0,11],evaporate_escaped_orbiting_object:[0,11],event:[0,11],everi:[0,9,11,17],everyth:[5,7,14,15],everytim:[9,17],evid:[0,11],evolut:[0,1,5,7,11,14,15,16],evolution_split:[0,11],evolution_splitting_maxdepth:[0,11],evolution_splitting_sn_eccentricity_threshold:[0,11],evolution_splitting_sn_n:[0,11],evolution_typ:[7,15],evolutionari:[0,11,14],evolv:[0,3,5,7,11,12],evolve_popul:15,evolve_singl:[5,12,14],exact:[1,4,7],exactli:[0,11],exampl:[1,2,4,5,14,18],example_above_m:12,example_compact_object:15,example_dco:15,example_df:14,example_head:4,example_log:18,example_log_co:[1,12],example_logging_string_co:12,example_logging_string_post_m:12,example_massloss:[12,14],example_output:14,example_parse_output:4,example_pop:[14,15],example_pop_set:15,example_python_population_result:15,example_sn:12,exce:[0,7,11],except:[4,5,6,7,11,15,16],execut:[0,5,7,9,11,15,17],exist:[0,5,6,11,15],exist_ok:[4,15],exit:[0,4,11],exp:[5,15],expand:[15,18],expect:[9,11,17],experiment:[0,4,11],explain:[3,4],explicitli:[0,1,11],explod:[0,11],explos:[0,11],expoenti:[0,11],expon:[0,11],export_all_info:[5,15],express:[0,11],extend:[9,17],extens:11,extern:[0,11],extra:[0,3,5,7,9,11,15,18],extra_text:6,extract:[4,15],extract_ensemble_json_from_str:4,extrapol:[2,7],fabian:[0,11],fabian_imf_log:[0,11],fabian_imf_log_tim:[0,11],fabian_imf_log_timestep:[0,11],factor:[0,2,4,7,11],fade:[0,11],fail:[0,4,7,9,11,17],fail_sil:4,failed_count:15,failed_prob:15,failed_system:7,failed_system_log:7,failed_systems_error_cod:15,failed_systems_threshold:7,failsaf:14,failur:[0,11],fallback:12,fallback_mass:12,fals:[0,4,5,7,11,15,16],fancy_parsing_funct:18,far:[0,11],farmer:[0,11],fase:15,fast:[0,11],faster:15,favorit:14,featur:[3,9,15],feed:7,ferguson:[0,11],fetch:14,few:[0,11],field:[0,11],fig:[0,2,11],figur:[7,16],file:[0,1,4,5,6,7,8,9,11,14,15,16,17,18],file_log:[0,11],filehandl:6,filenam:[0,1,4,5,7,11,14,15,18],filenotfounderror:[9,17],filepath:1,fill:14,fill_data:2,filter:[0,4,11],filter_arg_dict:4,filter_valu:4,fin:[0,11],find:[4,5,7,9,15,17],finish:[4,15,16],first:[0,2,4,5,9,11,14,15,17,21],first_giant_branch:0,fishlock:[0,11],fit:[0,2,4,5,11,14,21],fix:[0,2,4,5,11,14,15,16],flag:[0,1,4,7,11],flash:[0,11],flat:[2,7],flatsect:[2,15],flaw:5,float_overflow_check:[0,11],flto:[9,17],fold:2,follow:[0,2,4,7,9,11,12,16,17],forc:[0,9,11,17],force_circularization_on_rlof:[0,11],force_corotation_of_primary_and_orbit:[0,11],form:[0,4,5,6,11,15],formal:[0,11],format:[0,2,4,5,11,12,14,15],format_ensemble_result:5,formula:[0,11],forward:[0,11],found:[2,9,15,17],four:[0,11],fpic:1,fraction:[0,2,7,11,15],framework:11,free_persistent_data_memaddr_and_return_json_output:11,free_store_memaddr:11,frequenc:[0,11],friction:[0,11],fring:[0,11],from:[0,2,4,5,7,14,15,16,21],from_binary_c_config:1,ftz:[9,17],full:[3,4,7,12],full_path:4,further:[2,15],fuv:[0,11],gaia:[0,2,11],gaia_colour_transform_method:[0,11],gaia_conversion_ubvri_bivariate_jordi2010:[0,11],gaia_conversion_ubvri_riello2020:[0,11],gaia_conversion_ubvri_univariate_evans2018:[0,11],gaia_conversion_ubvri_univariate_jordi2010:[0,11],gaia_conversion_ugriz_bivariate_jordi2010:[0,11],gaia_conversion_ugriz_riello2020:[0,11],gaia_conversion_ugriz_univariate_evans2018:[0,11],gaia_conversion_ugriz_univariate_jordi2010:[0,11],gaia_l_binwidth:[0,11],gaia_teff_binwidth:[0,11],gain:7,galact:[0,11],gallino:[0,11],gamma:[0,11],gap:[0,11],garcia:[0,11],gauss:[0,11],gaussian:2,gaussian_func:2,gaussian_normalizing_const:2,gb_reimers_eta:[0,11],gb_wind_beasor_etal_2020:0,gb_wind_goldman_etal_2017:0,gb_wind_reim:0,gb_wind_schroeder_cuntz_2005:0,gbwind:[0,11],gbwindfac:[0,11],gcc:[1,9,17],gce:[0,11],gener:[0,1,2,4,5,6,7,11,12,14,15,16],general_info:4,generalis:2,geometr:[0,11],gerosa:[0,11],get:[0,2,4,5,6,9,12,14,15,17,18,21],get_arg_kei:4,get_default:4,get_help:4,get_help_al:[4,5],get_help_sup:4,get_integration_constant_q:2,get_max_multipl:2,get_moe_di_stefano_dataset:4,get_siz:4,giant:[0,11],giant_branch:0,git:[0,4,15],git_branch:4,git_build:4,github:4,gitlab:9,give:[0,2,4,11,21],given:[0,1,2,4,5,7,11,18,21],global:[0,2,11],global_dict:2,gmax:2,gmin:2,gnu:11,goe:[0,4,5,11,12,14,16],gogo:[0,11],going:[9,17],goldman:[0,11],gonna:2,good:[0,7,11,14,15,21],gov:[0,11],gravit:[0,11,15],gravitational_radiation_bs:0,gravitational_radiation_bse_when_no_rlof:0,gravitational_radiation_landau_lifshitz:0,gravitational_radiation_landau_lifshitz_when_no_rlof:0,gravitational_radiation_model:[0,11],gravitational_radiation_modulator_:[0,11],gravitational_radiation_modulator_j:[0,11],gravitational_radiation_non:0,grb:[0,11],great:[0,11],greater:[0,11],grevess:[0,11],grid:[0,3,4,5,9,10,11,12,14],grid_class:[9,10],grid_cod:5,grid_opt:[5,7,14,15],grid_options_default:6,grid_options_defaults_dict:6,grid_options_descript:[6,15],grid_options_description_check:6,grid_options_help:6,grid_vari:[7,15],grid_variable_numb:15,gridcode_filenam:7,gridtyp:[5,15],group:4,gsl:[9,17],gsl_dir:[9,17],guess:[0,2,11],h5py:[9,17],hachisu:[0,11],hachisu_disk_wind:[0,11],hachisu_ignore_qcrit:0,hachisu_qcrit:[0,11],hack:6,had:5,half:[0,11],hall:[0,11],handi:[0,11],handl:[0,3,4,5,7,11,14,18,21],handle_ensemble_string_to_json:4,happen:[0,11],hardcod:[12,15],has:[0,1,4,5,7,11,12,15],have:[0,2,3,4,5,6,7,9,11,12,14,15,16,17],hbb:[0,11],hbbtfac:[0,11],hdf5:4,hdf5file:4,header:[1,4,12,14,15],headerlin:15,headlin:7,hegb:0,hehg:0,height:[2,15],helium:[0,11],helium_flash_mass_loss:[0,11],helium_white_dwarf:0,help:[0,4,6,11,14,15],help_al:[0,11],hem:0,henc:[0,11],hendrik:[9,17],here:[1,4,5,7,11,12,14,16],hertzsprung:[0,11],hertzsprung_gap:0,hertzstrpung:[0,11],heuvel:[0,11],hewd:[0,11],hewd_hewd_ignition_mass:[0,11],hex:7,high:[0,2,11],higher:[0,2,4,7,9,11,15,17],his:2,histori:2,hold:7,hole:[0,11],home:11,homogen:[0,11],hood:14,hopefulli:[0,11],hot:[0,11],how:[0,4,5,7,11,12,14,15],howev:[0,11,12,15],hoyl:[0,11],hpc:[5,8],hpc_function:[9,10],hr_diagram:16,hrd:[0,11],hrdiag:[0,11],hrdiag_output:[0,11],html:[9,15,17],http:[0,1,2,4,11,15],hurlei:[0,11],hut:[0,11],hybrid:[0,11],hydro:[0,11],hydrogen:[0,11],ibc:[0,11],id_cor:12,idea:[15,16],idum:[0,11],ignit:[0,11],ignor:[0,5,7,9,11,12,14,15,17],iia:[0,11],iloc:14,imf:[0,2,11],imf_chabrier2003:2,imf_scalo1986:2,imf_scalo1998:2,imf_tinsley1980:2,immedi:[0,11],implement:[0,5,7,11],impli:[0,11],impos:15,improv:2,inclin:[0,11],inclination1:[0,11],inclination2:[0,11],inclination3:[0,11],inclination4:[0,11],inclini:[0,11],incliniation_quadrupl:[0,11],incliniation_tripl:[0,11],includ:[0,1,2,4,5,9,11,12,14,15,16,17],include_binary_c_default:[5,15],include_binary_c_help_al:[5,15],include_binary_c_version_info:[5,15],include_default:[5,15],include_popul:15,include_population_set:5,incom:[0,11],increas:[0,11],inde:[0,11],indent:[4,14],index:[0,2,9,11,14],indic:[0,2,11],individu:[3,9],individual_nova:[0,11],induc:[0,11],inertia:[0,11],info:[4,5,9,11,15,16,17],inform:[0,1,4,5,6,12,14,15,16],init:5,init_abund:[0,11],init_abund_dex:[0,11],init_abund_mult:[0,11],init_abunds_onli:[0,11],initi:[0,2,5,11,14],initial_abundance_hash:5,initial_abundance_mix:[0,11],initial_abunds_onli:[0,11],initial_mass:14,inner:[0,11],input:[1,2,4,5,7,9,11,14,16,21],input_dict:4,insert:[5,15],insid:[0,11],inspect:[4,14,16],inspect_dict:4,inspir:[1,16,21],instabl:[0,11],instanc:[4,14,15],instant:[0,11],instantli:[0,11],instead:[0,4,7,11],integ:[0,5,7,11,21],integr:2,integrals_str:2,interact:[0,6,11],interfac:[4,9,11,17],interfer:[9,17],intern:[0,7,11],internal_buff:[0,11],internal_buffering_off:0,internal_buffering_print:0,internal_buffering_stor:0,interpol:[2,5],interpolate_in_mass_izzard2012:2,interpolator_nam:2,intershel:[0,11],interstellar:[0,11],intger:[0,11],intro:[0,11],invers:21,involv:[0,11],inward:[0,11],ipynb:15,is_capsul:4,isfil:15,isn:[4,5],isnt:15,isotop:[0,4,11],isotope_hash:5,isotope_list:5,item:1,iter:4,its:[0,4,5,6,9,11,15,16,17,18],itself:[4,7,9,12,14,17],iwamoto:[0,11],izzard2012_period_distribut:2,izzard:[0,9,11,17],jager:[0,11],jaschek:2,jeff:[9,17],jia:[0,11],john:[0,11],join:[11,12,14,15],jordi:[0,11],json:[4,5,7,11,14,15],jsondecod:4,jsonencod:4,jupyt:[9,17],just:[0,2,4,5,7,11,15,21],kap:[0,11],kappa:[0,11],kaps_rentrop:[0,11],karaka:[0,11],keep:[5,15],kei:[1,2,4,5,6,7,14,15,16],kelvin:[0,11],keplerian:[0,11],keyword:[16,18],kick:[0,7,11],kick_backward:0,kick_forward:0,kick_inward:0,kick_outward:0,kick_random:0,kick_straight_up:0,kick_velocity_custom:0,kick_velocity_fix:0,kick_velocity_maxwellian:0,kill:[1,12,15],kim:[0,11],kind:[0,11],kippenhahn:[0,11],know:[0,1,5,6,11,14],known:[0,2,5,11,14,15,18],kroupa2001:[2,5,15],kroupa:2,ktg93:2,kwarg:[5,16,18],lambda:[0,11],lambda_c:[0,11],lambda_ce_dewi_tauri:0,lambda_ce_klencki_2020:0,lambda_ce_polytrop:0,lambda_ce_wang_2016:0,lambda_enthalpi:[0,11],lambda_ionis:[0,11],lambda_min:[0,11],lambda_mult:[0,11],lambda_multipli:[0,11],lambda_v:2,lamer:[0,11],landau:[0,11],langer:[0,11],larger:[0,11],last:2,lastli:[11,14],latter:[0,11],law:2,law_const:2,lbv:[0,11],ld_library_path:[9,17],lead:[0,11,15,21],learn:12,least:[9,17],leav:[0,11],left:[0,11],legaci:[0,11],legacy_yield:[0,11],len:[14,15],lengthen:[0,11],less:[0,1,2,3,11,14],let:[5,14,15],level:[1,4],li7:[0,11],lib:[9,11,14,17],libbinary_c:7,libcustom_logging_e9c2bec7f15541eb847fc6013e48e7:14,libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294:14,libgsl:[9,17],libmemo:[9,17],librari:[0,1,5,7,11,12,18],library_path:[9,17],librinterpol:[9,17],lies:[0,11],lifetim:[0,11,15],lifshitz:[0,11],like:[0,1,4,5,7,9,11,15,16,17,19],limit:[0,11,15,16],line:[1,4,5,7,9,12,14,15,16,17],linear2:7,linear:[0,2,7,11],linear_extrapolation_q:2,linearli:19,linker:1,linspac:19,linux:11,list:[0,1,2,4,7,11,14,15,18,19],list_arg:[0,11],list_of_sub_kei:2,lit:[0,11],lithium:[0,11],lithium_gb_post_1dup:[0,11],lithium_gb_post_heflash:[0,11],lithium_hbb_multipli:[0,11],lithium_t:[0,11],littleton:[0,11],liu:[0,11],llnl:[0,11],lnm1:[5,15],load:[0,1,4,5,7,11,12,14,15,16],load_logfil:4,lobe:[0,11,21],local:2,locat:[0,2,7,9,11,17],lodder:[0,11],log10:[0,2,11,15],log10m1:7,log10p:2,log10per:15,log10pmin:2,log:[0,1,2,3,4,5,7,9,11,14,16,17,18,21],log_arg:7,log_args_dir:7,log_every_timestep:[12,14],log_fil:7,log_filenam:[0,11,14,18],log_runtime_system:7,logarithm:2,logensembletim:[0,11],logfil:[4,9,14,17],logg:[0,11],logger:15,logging_dict:1,logging_lin:12,logic:[1,5,7,12],logmass:2,logp:2,logper:2,logperiod:2,long_spectral_typ:2,longer:[0,11],longnam:[5,15],look:[1,4,9,15,17],lookback:[0,11],loon:[0,11],loop:[5,14,15],loos:16,lose:[0,11],loss:[0,11,14],lost:[0,11],lot:[4,7,15,18],low:[0,2,11],low_mass_m:0,low_mass_main_sequ:0,lower:[0,2,5,11,15,19],lsoda:[0,11],lsun:[0,11,16],lugaro:[0,11],luminos:[0,11,16],luminosity_1:16,luminosity_2:16,lynnett:[0,11],m_1:[0,5,11,12,14,15,18],m_2:[0,11,12,14,15],m_3:[0,11],m_4:[0,11],m_max:[2,5,15],m_min:[5,15],maccretor:[0,11],machin:[7,9,17],macro:[0,4,11],madau:2,maeder:[0,11],magellan:[0,11],magnet:[0,11],magnetic_braking_algorithm:[0,11],magnetic_braking_algorithm_andronov_2003:0,magnetic_braking_algorithm_barnes_2010:0,magnetic_braking_algorithm_hurley_2002:0,magnetic_braking_algorithm_rappaport_1983:0,magnetic_braking_factor:[0,11],magnetic_braking_gamma:[0,11],magnitud:4,mai:[0,11],main:[0,1,7,9,11,12,15,17],main_sequ:[0,11],mainli:8,major:[0,11],make:[0,1,2,4,5,7,9,11,14,15,16,17,18],make_build_text:4,makedir:[4,15],manag:[4,9,17],mani:[0,5,7,11,15],manual:12,manufactur:[0,11],map:7,maria:[0,11],mass:[0,1,2,4,5,7,11,14,15,16,18,21],mass_1:[15,16],mass_2:[15,16],mass_accretion_for_eld:[0,11],mass_accretor:21,mass_donor:21,mass_evolut:16,mass_for_hestar_ia_low:[0,11],mass_for_hestar_ia_upp:[0,11],mass_of_pmz:[0,11],mass_str:2,massiv:[0,2,11],massless:[0,11],massless_remn:0,master:[7,16],match:[0,4,11,14,15,16],materi:[0,11],math:[5,15],matplotlib:[9,16,17],matter:[0,11],mattsson:[0,11],mattsson_mass_loss:[0,11],mattsson_orich_tpagbwind:[0,11],max:[0,2,11,12,15],max_bound:[2,19],max_evolution_tim:[0,1,11,12,14,15],max_hewd_mass:[0,11],max_model_numb:[0,11],max_multipl:2,max_neutron_star_mass:[0,11],max_queue_s:7,max_stellar_angmom_chang:[0,11],max_stellar_type_1:[0,11],max_stellar_type_2:[0,11],max_stellar_type_3:[0,11],max_stellar_type_4:[0,11],max_tim:14,max_val:2,maximum:[0,2,7,11,12,21],maximum_mass_ratio_for_instant_rlof:[0,11],maximum_mass_ratio_for_rlof:21,maximum_mcbagb_for_degenerate_carbon_ignit:[0,11],maximum_nuclear_burning_timestep:[0,11],maximum_timestep:[0,11],maximum_timestep_factor:[0,11],maxmimum:[0,11],maxwellian:[0,11],mayb:16,mayor:2,mc13_pocket_multipli:[0,11],mch:[0,11],mcmin:[0,11],mdonor:[0,11],mean:[0,2,4,5,7,9,11,17],meant:7,measur:4,medium:[0,11],mega:2,memaddr:[11,12],memori:[1,5,7,11,12,21],menv:[0,11],merg:[0,2,4,7,11],merge_dict:4,merge_multipl:2,merger:[0,11],merger_angular_momentum_factor:[0,11],merger_mass_loss_fract:[0,11],mesa:[9,17],mesasdk_init:[9,17],mesasdk_root:[9,17],messag:4,mestel:[0,11],met:[5,15],metal:[0,2,11,12,14,15,21],method:[0,5,7,11,12,14,15],meynet:[0,11],might:[4,5,9,15,17],milki:[0,11],miller:[0,11],min:[2,12,15],min_bound:[2,19],min_p:2,min_per:2,min_val:2,minimal_verbos:4,minimum:[0,2,4,7,11,21],minimum_co_core_mass_for_carbon_ignit:[0,11],minimum_co_core_mass_for_neon_ignit:[0,11],minimum_donor_menv_for_comenv:[0,11],minimum_envelope_mass_for_third_dredgeup:[0,11],minimum_helium_ignition_core_mass:[0,11],minimum_mcbagb_for_nondegenerate_carbon_ignit:[0,11],minimum_orbital_period_for_instant_rlof:[0,11],minimum_period_for_rlof:21,minimum_separation_for_instant_rlof:[0,11],minimum_separation_for_rlof:21,minimum_time_between_pn:[0,11],minimum_timestep:[0,11],mint:[0,11],mint_data_cleanup:[0,11],mint_dir:[0,11],mint_disable_grid_load_warn:[0,11],mint_kippenhahn:[0,11],mint_kippenhahn_companion_stellar_typ:[0,11],mint_kippenhahn_stellar_typ:[0,11],mint_maximum_shell_mass:[0,11],mint_metal:[0,11],mint_minimum_shell_mass:[0,11],mint_ms_rejuven:[0,11],mint_nuclear_burn:[0,11],mint_remesh:[0,11],mint_use_zams_profil:[0,11],mira:[0,11],misc:[9,11],miscellan:4,miss:[0,4,6,11],mix:[0,4,7,11],mixtur:[0,11],mmax:2,mmin:[2,7],mnra:21,model:[0,1,7,11,12,14,15],modifi:[0,11,12],modul:[0,6,7,10,11,15],modulo:7,moe:[2,4,5,9,15],moe_di_stefano_2017:5,moe_di_stefano_2017_multiplicity_fract:2,moe_di_stefano_2017_pdf:2,moment:[0,11,12,15,19],momenta:[0,11,16],momentum:[0,11],mont:[0,7,11],monte_carlo_kick:[0,11],more:[0,1,3,4,5,7,9,11,12,14,15,16,17,19],most:[4,11],mostli:[4,6,7,15,16,18],move:[0,11],msun:[0,2,11,12,14],much:[0,4,11,15],multi:7,multipl:[0,2,4,7,11,15],multiplc:[0,11],multipli:[0,4,7,11],multiplicity_arrai:2,multiplicity_fraction_funct:7,multiplicity_model:7,multiplicity_modul:7,multiply_values_dict:4,multiprocess:7,must:[0,2,11,14,15],my_stellar_data:[1,12,15],myr:[0,11,14],n100:[0,11],n100_z0:[0,11],n100h:[0,11],n100l:[0,11],n10:[0,11],n150:[0,11],n1600:[0,11],n1600c:[0,11],n200:[0,11],n20:[0,11],n300c:[0,11],n40:[0,11],naked_helium_star_giant_branch:0,naked_helium_star_hertzsprung_gap:0,naked_main_sequence_helium_star:0,name:[1,4,5,6,11,15,18,20],natur:[0,11],nauenberg:[0,11],nearer:[0,11],nebula:[0,11],necessari:[4,5,15],need:[0,2,5,9,11,12,14,15,17],neg:[0,4,11],neither:[0,5,11],neleman:[0,11],nelemans_gamma:[0,11],nelemans_max_frac_j_chang:[0,11],nelemans_minq:[0,11],nelemans_n_comenv:[0,11],nelemans_recalc_eccentr:[0,11],nemp:[0,11],nemp_cfe_minimum:[0,11],nemp_nfe_minimum:[0,11],nenamg:[0,11],neon:[0,11],nest:[4,5,15],network:[0,11],neutrn:[0,11],neutron:[0,11,15],neutron_star:0,never:[0,11],newer:[0,2,11],newli:[0,11],newopt:2,newton:[0,11],next:[4,15],nice:[1,5,16],nieuwenhuijzen:[0,11],nieuwenhuijzen_windfac:[0,11],nmax:2,no_thermohaline_mix:[0,11],noecho:[0,11],noechonow:[0,11],noel:[0,11],nolowq:7,nomin:[0,11],non:[0,7,11],nonconservative_angmom_gamma:[0,11],none:[0,1,2,4,5,6,7,11,15,21],nonetyp:15,nonzero:7,nor:[0,11],norm:7,normal:[0,4,11],normalis:[2,7],normalize_dict:2,normalize_multipl:7,notabl:15,note:[0,7,11],notebook:[9,11,13,14,15,17],notebook_api_funct:14,notebook_custom_log:[14,15],notebook_individual_system:[12,15],notebook_popul:14,noteworthi:3,noth:[5,7],notifi:18,nova:[0,11],nova_faml_multipli:[0,11],nova_irradiation_multipli:[0,11],nova_retention_algorithm_claeys2014:0,nova_retention_algorithm_const:0,nova_retention_algorithm_hillman2015:0,nova_retention_fract:[0,11],nova_retention_method:[0,11],nova_timestep_accelerator_index:[0,11],nova_timestep_accelerator_max:[0,11],nova_timestep_accelerator_num:[0,11],now:[0,2,4,11,12,14,15],nuclear:[0,11],nuclear_mass_hash:5,nuclear_mass_list:5,nucleosynthesi:[0,4,11],nucleosynthesis_sourc:4,nucreacmult:[0,11],nucsyn:[9,11],nucsyn_angelou_lithium:[0,11],nucsyn_gce_outflow_check:[0,11],nucsyn_hbb:[0,11],nucsyn_metal:[0,11],nucsyn_network:[0,11],nucsyn_network_error:[0,11],nucsyn_s_process:[0,11],nucsyn_solv:[0,11],nucsyn_third_dredge_up:[0,11],nugi:[0,11],number:[0,2,4,5,7,9,11,15,17],numer:4,numpi:[4,9,14,17,19],obj:4,object:[0,3,4,5,7,8,11,16],object_hook:4,object_pairs_hook:4,object_parse_funct:14,obtain:0,obvious:12,occur:[0,11,21],off:[0,11,15],off_m:14,offset:[0,11],ohio:[0,11],old:7,old_solut:[9,17],omega:[0,11],onc:[0,11],one:[0,4,5,7,11,15,16],onewd:0,onli:[0,4,5,7,11,12,15,21],onset:[0,11],onto:[0,2,11],opac:[0,11],opacity_algorithm:[0,11],opacity_algorithm_ferguson_op:0,opacity_algorithm_paczynski:0,opacity_algorithm_star:0,opal:[0,11],open:[14,15],opm:2,opt:[2,4,11],option:[0,1,2,4,5,9,10,11,15,17,21],orb:[5,15],orbit:[0,2,11,16,21],orbit_evolut:16,orbital_inclin:[0,11],orbital_inclinationi:[0,11],orbital_period:[0,11,12,14,15,21],orbital_period_quadrupl:[0,11],orbital_period_tripl:[0,11],orbital_phas:[0,11],orbital_phase_quadrupl:[0,11],orbital_phase_tripl:[0,11],orbiting_object:[0,11],orbiting_objects_close_pc_threshold:[0,11],orbiting_objects_log:[0,11],orbiting_objects_tides_multipli:[0,11],orbiting_objects_wind_accretion_multipli:[0,11],order:[3,4,5,15],ordereddict:4,org:[0,2,11],origin:[9,17],other:[0,1,2,4,6,7,9,11,13,14,15,16,17],otherwis:[0,5,6,7,11],out:[4,6,7,12],outcom:[0,11],outer:[0,11],outfil:[5,15],outfile_nam:1,outfilenam:15,output:[1,3,4,5,7,9,11,12,14,16,17,18,21],output_dict:14,output_dir:[5,14,15],output_fil:[4,6,14],output_filenam:[5,15],output_lin:4,outsid:[0,2,11],outward:[0,11],over:[4,5,13,14,15],overflow:[0,11],overlap:4,overrid:2,overriden:15,overshoot:[0,11],overspin_algorithm:[0,11],overspin_bs:[0,11],overspin_massloss:[0,11],overview:11,own:[5,7,9,12,14,15,17],oxygen:[0,11],oxygen_neon_white_dwarf:0,packag:[4,9,11,15,17,19],paczynski:[0,11],page:[0,9,11,15,17],pair:[0,4,11],panda:[4,9,14,16,17],pane:16,panel:[0,11],paper:[0,11],param_nam:4,paramet:[1,2,4,5,6,7,9,11,12,14,15,16,18,19,21],parameter_nam:[4,5,11,15],parameter_value_input_typ:4,pars:[4,5,14,15,16,18],parse_binary_c_version_info:4,parse_cmdlin:5,parse_const:4,parse_float:4,parse_funct:[5,7,14,15,18],parse_function_hr_diagram:16,parse_function_mass:16,parse_function_orbit:16,parse_int:4,parsec:2,part:[2,5,11,14,15,21],partial:[0,11],particularli:[0,11],pasp:2,pass:[5,7,9,11,12,14,15,16,17,18],path:[4,7,9,14,15,17],patho:[9,17],pdf:[0,2,9,11,17],pend:[0,11],per:[0,4,5,7,11,15,21],percentag:[0,11],peret:[0,11],perform:[0,11],perhap:[0,11],periastron:[0,11],pericent:21,period:[0,2,11,12,14,15,16,21],period_str:2,perl:[1,15],persist:11,persistent_data:11,pgo:[0,11],phase:[0,11],phasevol:[0,11,15],phdi:[0,11],photoevapor:[0,11],php:2,physic:15,pick:16,piec:[5,15],pinnsonneault:[0,11],pisn:[0,11],pkg:[9,17],place:[0,11],placehold:16,plai:[0,11],plan:7,planetari:[0,11],plaw2:7,pleas:[0,4,11,15],plot:[0,11,14,16],plot_funct:[9,10],plot_hr_diagram:16,plot_hr_diagram_singl:16,plot_mass:16,plot_orbit:16,plot_system:16,plot_typ:16,pls:5,plu:[0,11],pms:16,pms_mass_1:16,pms_mass_2:16,pn_comenv_transition_tim:[0,11],pn_fast_wind:[0,11],pn_fast_wind_dm_agb:[0,11],pn_fast_wind_dm_gb:[0,11],pn_fast_wind_mdot_agb:[0,11],pn_fast_wind_mdot_gb:[0,11],pn_hall_fading_time_algorithm:[0,11],pn_hall_fading_time_algorithm_maximum:[0,11],pn_hall_fading_time_algorithm_minimum:[0,11],pn_resolv:[0,11],pn_resolve_maximum_envelope_mass:[0,11],pn_resolve_minimum_effective_temperatur:[0,11],pn_resolve_minimum_luminos:[0,11],pne:[0,11],pogg:[0,11],point:[0,2,4,5,9,11,17],poisson:[2,7],pol:[0,11],polytrop:[0,11],pop:12,pop_macro:12,popul:[0,2,3,5,6,8,9,11,17,19],population_id:7,population_nam:15,population_set:5,posit:[0,2,11],possibl:[0,1,2,4,6,9,11,14,17],post:[0,11,12],post_ce_adaptive_menv:[0,11],post_ce_envelope_dm_eagb:[0,11],post_ce_envelope_dm_gb:[0,11],post_ce_envelope_dm_tpagb:[0,11],post_ce_objects_have_envelop:[0,11],post_sn_orbit_bs:0,post_sn_orbit_method:[0,11],post_sn_orbit_tt98:0,postagb_legacy_log:[0,11],potenti:[0,11],power:[0,2,11],powerlaw:2,powerlaw_const:2,powerlaw_extrapolation_q:2,ppisn:[0,11],ppisn_farmer19:0,ppisn_non:0,ppisn_prescript:[0,11],ppn_envelope_mass:[0,11],pragma:12,pre:[0,11,16],pre_events_stardata:[0,11,12],pre_main_sequ:[0,11],pre_main_sequence_fit_lob:[0,11],precis:4,precod:[5,15],predefin:[2,15],predict:7,predictor:[0,11],prefer:[0,5,11],prefix:[0,11],prepar:2,prepare_dict:2,prescript:[0,11,15],prescrit:[0,11],present:[2,4,5,15],preserv:[0,11],preset:16,pressur:[0,11],prev_stellar_type_1:15,prev_stellar_type_2:15,prevent:[0,7,11],previou:4,previous:[14,15],previous_stardata:[1,12,14,15],primari:[1,2,5,15,21],print:[4,6,7,11,12,14,15],print_help:4,print_info:6,print_option_descript:6,print_structur:4,printf:[1,12,14,15],prior:[0,11],privat:[5,6,9],prob_dict:2,probability_weighted_mass:7,probabl:[0,1,2,5,6,7,11,12,15,16],probdist:[5,15],problem:[0,11],process:[0,4,5,7,11,15],profil:[0,11],progenitor:[0,11,15],program:[9,17],project:[0,11],proper:[6,12],properli:[0,11],properti:[0,4,7,16],prot1:[0,11],prot2:[0,11],prot3:[0,11],prot4:[0,11],provid:[0,2,5,7,11,15,18],pseudorandom:[0,11],publicli:12,puls:[0,11,21],pulsat:[0,11],pump:[0,11],purpos:[7,15,16],push_macro:12,put:[1,4,5,7,15,16],py_rinterpol:[9,17],pyenv:[9,11,17],pysiz:4,pytest:[9,17],python3:[9,11,17],python:[4,11,12,15],q_high_extrapolation_method:7,q_interpol:2,q_low_extrapolation_method:7,qcrit_bh:[0,11],qcrit_bs:0,qcrit_cheb:[0,11],qcrit_chen_han_formula:0,qcrit_chen_han_t:0,qcrit_cowd:[0,11],qcrit_degenerate_bh:[0,11],qcrit_degenerate_cheb:[0,11],qcrit_degenerate_cowd:[0,11],qcrit_degenerate_eagb:[0,11],qcrit_degenerate_gb:[0,11],qcrit_degenerate_hegb:[0,11],qcrit_degenerate_hehg:[0,11],qcrit_degenerate_hem:[0,11],qcrit_degenerate_hewd:[0,11],qcrit_degenerate_hg:[0,11],qcrit_degenerate_lmm:[0,11],qcrit_degenerate_m:[0,11],qcrit_degenerate_n:[0,11],qcrit_degenerate_onewd:[0,11],qcrit_degenerate_tpagb:[0,11],qcrit_eagb:[0,11],qcrit_gb:[0,11],qcrit_gb_bs:0,qcrit_gb_chen_han_formula:0,qcrit_gb_chen_han_t:0,qcrit_gb_ge2015:0,qcrit_gb_hjellming_webbink:0,qcrit_gb_q_no_comenv:0,qcrit_gb_temmink2021:0,qcrit_gb_vos2018:0,qcrit_ge2015:0,qcrit_hegb:[0,11],qcrit_hehg:[0,11],qcrit_hem:[0,11],qcrit_hewd:[0,11],qcrit_hg:[0,11],qcrit_hjellming_webbink:0,qcrit_lmm:[0,11],qcrit_m:[0,11],qcrit_n:[0,11],qcrit_onewd:[0,11],qcrit_q_no_comenv:0,qcrit_temmink2021:0,qcrit_tpagb:[0,11],qcrit_vos2018:0,qcrits_:[0,11],qcrits_degenerate_:[0,11],qdata:2,qlimit:2,quad:7,quadrat:[0,11],quadrulpl:[0,11],quadrupl:[0,2,7,11],quantiti:16,queri:14,queue:7,quickli:14,quit:[0,4,11],r_l:21,radi:[0,11],radiat:[0,11],radii:[0,11,21],radiu:[0,1,11,12,15,16,21],radius_1:16,radius_2:16,ragb:21,raghavan2010_binary_fract:2,raghavan:2,rai:[0,11],railton:[0,11],rais:[0,4,7,11,15],ram:[0,11],ran:7,random:[0,7,11],random_count:14,random_se:[0,11,14],random_skip:[0,11],random_system:[0,11],random_systems_se:[0,11],rang:[0,2,5,7,11,14,15,19],rapidli:[0,11],rappaport:[0,11],rate:[0,2,11],rather:[0,4,5,7,9,11,12,14,15,17],ratio:[0,2,11,15,21],raw:[4,5,7,11,16,18],raw_output:4,reach:[0,11],reaction:[0,11],read:[3,4,14,15],real:[5,15],realli:[0,5,6,7,11,15],reason:[0,11],rebuild:[0,9,11,17],rebuilt:[9,17],recalcul:[0,11],receiv:4,recogn:15,recombin:[0,11],recommend:[1,3,5],recompil:[9,15,17],recurs:[4,5],recursive_change_key_to_float:4,recursive_change_key_to_str:4,red:[0,11],redhat:1,redshift:2,reduc:[0,11],reduct:7,regardless:16,region:[0,11],regist:15,reignit:[0,11],reimer:[0,11],reinstal:[9,17],reject:[0,11],rejects_in_log:[0,11],rejuven:[0,11],rel:[0,11],relat:[0,11],releas:[4,9,17],reliabl:11,remain:[0,11],remesh:[0,11],remnant:[0,11],remov:[0,4,5,11,14,15],remove_fil:4,renormalis:2,rentrop:[0,11],repeat:[0,7,11],repo:[9,17],report:[0,11,15],repositori:3,repres:7,represent:[4,5,15],reproduc:[0,11],requir:[0,2,4,11,14,15,16,18],reset:[0,11],reset_pref:[0,11],reset_star:[0,11],reset_stars_default:[0,11],resolut:[0,5,7,11,15],resolv:[0,11],reson:[0,11],respect:[0,2,11],rest:[2,5,15],restructuredtext:4,result:[0,1,2,4,5,7,9,11,14,15,17],result_arrai:2,result_dict:2,retain:[0,11],rethink:4,return_all_info:5,return_arglin:11,return_binary_c_default:5,return_binary_c_version_info:[4,5],return_compilation_dict:1,return_help:11,return_help_al:[4,11],return_maximum_mass_ratio_for_rlof:[11,21],return_minimum_orbit_for_rlof:[11,21],return_persistent_data_memaddr:11,return_population_set:5,return_store_memaddr:11,return_version_info:[4,11],revap_in:[0,11],revap_out:[0,11],revers:[0,11,16],reverse_tim:[0,11],revis:[0,4],rewrit:5,rhagavan:7,ri0005:15,rich:[0,11],riello:[0,11],rin:[0,11],ring:[0,11],risk:[5,15],ritter:[0,11],rk2:[0,11],rk4:[0,11],rlof:[0,11,21],rlof_angular_momentum_transfer_model:[0,11],rlof_angular_momentum_transfer_model_bs:0,rlof_angular_momentum_transfer_model_conserv:0,rlof_eccentric_as_circular:[0,11],rlof_entry_threshold:[0,11],rlof_f:[0,11],rlof_interpolation_binary_c:0,rlof_interpolation_bs:0,rlof_interpolation_method:[0,11],rlof_mdot_factor:[0,11],rlof_mdot_modul:[0,11],rlof_method:[0,11],rlof_method_adapt:0,rlof_method_adaptive2:0,rlof_method_bs:0,rlof_method_claei:0,rlof_method_ritt:0,rlof_nonconservative_gamma_donor:0,rlof_nonconservative_gamma_isotrop:0,rlof_radiation_correct:[0,11],rlof_transition_objects_escap:[0,11],rob:[0,2,11,21],robert:[9,17],roch:[0,11,21],roche_lob:21,rochelob:21,rol1:14,rol2:14,room:[5,15],root:[9,17],rotat:[0,2,11],rotation:[0,11],rotationally_enhanced_expon:[0,11],rotationally_enhanced_mass_loss:[0,11],rotationally_enhanced_massloss:[0,11],rotationally_enhanced_massloss_angmom:0,rotationally_enhanced_massloss_langer_formula:[0,11],rotationally_enhanced_massloss_langer_formula_and_angmom:0,rotationally_enhanced_massloss_non:0,rout:[0,11],routin:[0,5,11,12,16],row:[14,16],rring:[0,11],rssd:2,rst:[4,6],rsun:16,rubric:5,run:[0,1,3,4,5,7,9,11,17,18],run_popul:11,run_system:[11,12,14,16,18],run_system_wrapp:[9,10,12,14],run_wrapp:3,run_zero_probability_system:7,runtim:[1,7],russel:[0,11],rzam:21,s_option:7,safe:15,sai:[0,11],said:[0,11],same:[0,4,7,9,11,14,17],sampl:[0,2,5,11,15,19],sample_valu:2,sampler:9,sana12:[2,15],sana:2,save:[0,1,2,11,12,15],save_pre_events_stardata:[0,11],scalo:2,scanf:0,scheme:[0,11],schneider:[0,11],schroeder:[0,11],script:[3,9,12,17],sdb:[0,11],sdist:[9,17],sdo:[0,11],search:9,second:[0,2,4,11,16],secondari:[2,21],section:[2,4,8,9,11,15,17],see:[0,5,9,11,12,14,15,16,17],seed:[0,11],seem:[9,16,17],seen:4,segment:19,seitenzahl2013_model:[0,11],seitenzahl:[0,11],select:[0,4,11,14],selected_head:4,selector:[0,11],self:[5,7,14,15],semi:[0,11],sent:[0,11],sentenc:1,sep:[2,5,14,15,21],sep_max:15,sep_min:15,separ:[0,2,4,5,6,11,12,14,15,16,21],separation_quadrupl:[0,11],separation_tripl:[0,11],separta:[0,11],seper:15,sequenc:[0,11,12],seri:[0,11],serialis:[4,5],serv:4,server:5,set:[0,1,2,3,4,5,6,7,9,12,14,16,17],set_moe_di_stefano_set:5,set_opt:2,setup:[9,15,17,18],sever:[6,7,15,16,18],sfh:2,shara:[0,11],share:[1,7,14,18],shared_lib_filenam:12,shell:[0,11],shorten:[0,11],should:[0,1,2,5,6,7,9,11,14,15,16,17,18],shouldn:[0,4,11],show:[0,3,7,11,14,15,16],show_plot:16,show_stellar_typ:16,shown:[0,11,16],shrinkagb:14,side:15,siess:[0,11],sigma:2,silent:4,sill:[0,11],simplest:14,simpli:[0,11],simul:[0,1,11,12,15],simulation_:5,sinc:[4,16],singl:[0,2,3,5,7,11,15,16],single_star_lifetim:[11,12,14],sit:[0,11],site:11,situat:11,size:[4,7],skip:[0,4,7,9,11,17],skipkei:4,slightli:11,slope:2,slow:[0,11],slower:[0,11],slurm:[5,7,8],slurm_grid:5,small:[0,11],small_envelope_method:[0,11],small_envelope_method_bs:0,small_envelope_method_miller_bertolami:0,smaller:[0,11],sn_impulse_liu2015:0,sn_impulse_non:0,sn_impulse_wheeler1975:0,sn_kick_companion_a:[0,11],sn_kick_companion_aic_bh:[0,11],sn_kick_companion_bh_bh:[0,11],sn_kick_companion_bh_n:[0,11],sn_kick_companion_ecap:[0,11],sn_kick_companion_grb_collapsar:[0,11],sn_kick_companion_hestaria:[0,11],sn_kick_companion_ia_chand:[0,11],sn_kick_companion_ia_chand_co:[0,11],sn_kick_companion_ia_eld:[0,11],sn_kick_companion_ia_h:[0,11],sn_kick_companion_ia_he_co:[0,11],sn_kick_companion_ia_hybrid_hecowd:[0,11],sn_kick_companion_ia_hybrid_hecowd_sublumin:[0,11],sn_kick_companion_ibc:[0,11],sn_kick_companion_ii:[0,11],sn_kick_companion_iia:[0,11],sn_kick_companion_ns_n:[0,11],sn_kick_companion_phdi:[0,11],sn_kick_companion_pisn:[0,11],sn_kick_companion_ppisn:[0,11],sn_kick_companion_tz:[0,11],sn_kick_companion_wdkick:[0,11],sn_kick_dispersion_aic_bh:[0,11],sn_kick_dispersion_bh_bh:[0,11],sn_kick_dispersion_bh_n:[0,11],sn_kick_dispersion_ecap:[0,11],sn_kick_dispersion_grb_collapsar:[0,11],sn_kick_dispersion_ia_hybrid_hecowd:[0,11],sn_kick_dispersion_ia_hybrid_hecowd_sublumin:[0,11],sn_kick_dispersion_ibc:[0,11],sn_kick_dispersion_ii:[0,11],sn_kick_dispersion_ns_n:[0,11],sn_kick_dispersion_phdi:[0,11],sn_kick_dispersion_pisn:[0,11],sn_kick_dispersion_ppisn:[0,11],sn_kick_dispersion_tz:[0,11],sn_kick_distribution_aic_bh:[0,11],sn_kick_distribution_bh_bh:[0,11],sn_kick_distribution_bh_n:[0,11],sn_kick_distribution_ecap:[0,11],sn_kick_distribution_grb_collapsar:[0,11],sn_kick_distribution_ia_hybrid_hecowd:[0,11],sn_kick_distribution_ia_hybrid_hecowd_sublumin:[0,11],sn_kick_distribution_ibc:[0,11],sn_kick_distribution_ii:[0,11],sn_kick_distribution_ns_n:[0,11],sn_kick_distribution_phdi:[0,11],sn_kick_distribution_pisn:[0,11],sn_kick_distribution_ppisn:[0,11],sn_kick_distribution_tz:[0,11],sn_none:12,sn_type:12,sneia:[0,11],snia:[0,11],snippet:[11,14],solar:[0,2,11,21],solver:[0,11],solver_forward_eul:0,solver_predictor_corrector:0,solver_rk2:0,solver_rk4:0,some:[0,1,2,5,7,9,11,12,13,14,15,16,17],someth:[0,5,11,14],somewhat:15,soon:19,sort:4,sort_kei:4,sourc:[1,2,4,5,6,7,10,16,18,19,21],source_file_filenam:7,source_list:5,sourcecod:[9,11,12,17],sourcefile_nam:1,space:[0,5,11,15,19],spacing_funct:[9,10],spacingfunc:[5,15],spacingfunct:[5,15],special:[0,11,15],specif:[0,4,11,14,16],specifi:[0,7,11],spectral:2,speed:[0,7,11],speedtest:[0,11],spent:4,spheric:[0,11],spin:[0,11],spinrat:[0,11],split:[0,7,11,14,15],split_lin:14,splitlin:[11,12,14,15],splitpoint:[0,11],spread:5,sqrt:[0,11],src:[9,11,12,17],stabil:[0,11],stabl:[0,11],stancliff:[0,11],standard:[0,2,11],star:[1,2,7,9,11,12,14,15,16,21],star_with_no_mass:0,starcount:15,stardata:[0,1,11,12,14,15],stardata_dump_filenam:[0,11],stardata_load_filenam:[0,11],stardata_t:12,start:[0,1,4,5,6,7,11,14,15],start_tim:[0,11],start_timestamp:15,startswith:14,state:[0,11],statement:[1,12,14,15],statist:[0,11],statu:[0,1,11,15],stderr:[0,11],stdout:4,steadi:[0,11],stefan:16,stefano:[4,5,9,15],stellar:[0,2,7,11,16,20],stellar_structure_algorithm:[0,11],stellar_structure_algorithm_external_funct:0,stellar_structure_algorithm_mint:0,stellar_structure_algorithm_modified_bs:0,stellar_structure_algorithm_non:0,stellar_typ:[1,9,10,12,14,15,16],stellar_type_1:[0,11,15,16],stellar_type_2:[0,11,15,16],stellar_type_3:[0,11],stellar_type_4:[0,11],stellar_type_dict:20,stellar_type_dict_short:20,step:[5,12,14,15,16,19],stepsiz:[5,15],stick:7,stiff:[0,11],still:[1,7,12],stop:[0,4,11],stopfil:[0,11],storag:[0,11],store:[0,2,3,4,5,7,9,14,15,17,21],store_capsul:11,store_memaddr:[11,21],str:[1,4,5,6,15,16],straight:5,straightforward:15,straniero:[0,11],strength:[0,11],strict:4,string:[0,1,3,4,5,6,7,11,14,15,16,18],strip:[0,11,14],stronger:[0,11],struct:[0,11,12],structur:[0,4,7,11,16],stuff:[4,7,14,15,16],style:[0,11],sub:[0,4,11],subdict:4,subject:[0,11],sublumin:[0,11],submit:9,subroutin:8,subsequ:[0,11],subtract:4,subtract_dict:4,succe:[0,11],suggest:[0,9,11,17],suit:[9,17],sum:[0,11],sundial:[0,11],supercrit:[0,11],supernova:[0,7,11],superwind:[0,11],superwind_mira_switchon:[0,11],sure:[2,5,7,9,14,15,16,17,18],surfac:[0,11],surrei:15,surviv:[0,11],survivor:[0,11],switcher:[0,11],symmetr:[0,11],synchron:[0,11],synonym:[0,11],synthesi:[7,9,15,17],system:[0,3,4,5,7,9,11,12,15,16,17,18],system_gener:[5,15],tabl:[0,2,11],take:[0,2,4,5,7,11,15,18],taken:[0,4,11,12],tar:[9,17],target:[1,6],task:[0,2,4,5,6,8,11,15,16,18,19,21],tauri:[0,11],tbse:[0,11],technic:[12,15],teff:[0,2,11],teff_1:16,teff_2:16,tell:4,temp_dir:[4,15],temperatur:[0,2,11,16],termin:[1,9,12,15,17],test:[0,4,5,7,9,11,14,15,17,21],test_func:11,test_logfil:14,test_pop:15,text:[4,6],than:[0,2,4,7,9,11,15,17],thats:15,thei:[0,2,4,5,7,11,15,16],thelog:[0,11],them:[2,4,5,11,15],themselv:[2,4],thermal:[0,2,11,21],thermally_pulsing_asymptotic_giant_branch:0,thermohalin:[0,11],thesi:[0,11],thi:[0,1,2,4,5,6,7,9,10,11,12,13,14,15,16,17,18,19,21],thick:[0,11],thick_disc_end_ag:[0,11],thick_disc_logg_max:[0,11],thick_disc_logg_min:[0,11],thick_disc_start_ag:[0,11],thin:[0,11],thing:[0,2,4,5,6,11,15,18],think:[0,4,5,11],third:[0,2,11],third_dup:[0,11],third_dup_multipli:[0,11],thorn:[0,11],those:[4,5,9,15,17],thread:7,thread_id:7,three:[0,2,11,15],three_part_powerlaw:[2,15],threshold:[0,4,7,11],through:[5,11,14,15,16,18],throughout:[5,15],tidal:[0,11],tidal_strength_factor:[0,11],tide:[0,11],tides_convective_damp:[0,11],tides_hurley2002:[0,11],tides_zahn1989:[0,11],time:[0,1,2,4,5,7,9,11,12,14,15,16,17],timescal:[0,11],timestamp:7,timestep:[0,11,12,14],timestep_limit:[0,11],timestep_log:[0,11],timestep_modul:[0,11],timestep_multipli:[0,11],timestep_solver_factor:[0,11],tinslei:2,titl:6,tmp:[0,4,9,11,14,15,17],tmp_dir:[5,7,15],tmp_tabl:2,todo:[0,1,2,4,5,6,7,11,13,15,16,18,19,21],toler:[0,11],too:[0,4,7,9,11,17,18],took:15,top:15,topic:[0,11],torqu:[0,11],total:[0,2,4,5,7,11,15,16],total_count:15,total_mass_run:15,total_prob:15,total_probability_weighted_mass_run:15,tout:[0,11,21],tpagb:[0,11],tpagb_reimers_eta:[0,11],tpagb_wind_beasor_etal_2020:0,tpagb_wind_bloeck:0,tpagb_wind_goldman_etal_2017:0,tpagb_wind_mattsson:0,tpagb_wind_reim:0,tpagb_wind_rob_cwind:0,tpagb_wind_van_loon:0,tpagb_wind_vw93_karaka:0,tpagb_wind_vw93_karakas_carbon_star:0,tpagb_wind_vw93_orig:0,tpagb_wind_vw93_orig_carbon_star:0,tpagbwind:[0,11],tpagbwindfac:[0,11],traceback:4,track:[7,16],trade:[0,11],transfer:[0,11],transform:[0,4,11],transit:[0,11],treat:[0,11],trigger:[0,11],trio:15,tripl:[0,2,7,11],truli:[0,11],tupl:1,turn:[0,4,11,14,15],two:[0,4,11,12,20,21],txt:[5,14,15,18],type:[0,1,2,4,5,6,7,11,14,15,16,19,20,21],type_chng:14,type_ia_mch_supernova_algorithm:[0,11],type_ia_sub_mch_supernova_algorithm:[0,11],typic:[0,11],ubvri:[0,11],ugriv:[0,11],uncom:[5,14,15],undef:12,under:[14,19],undergo:[0,11],understand:5,undescrib:6,uniform:2,union:[2,4,5,15,19,21],uniqu:[4,5,7,15],unit:[0,11,21],univari:[0,11],unknown:18,unless:[1,5,7],unload:5,unpars:11,unrecogn:[9,17],unsign:0,unstabl:[0,11],until:[0,2,4,11],unus:[0,7,11],unweight:15,updat:[2,4,5,9,15,17],update_dict:4,upper:[0,2,11,19],usag:[0,3],use:[0,2,4,5,7,8,9,11,12,14,15,16,17,18],use_astropy_valu:16,use_datadir:[5,15],use_fixed_timestep_:[0,11],use_periastron_roche_radiu:[0,11],use_tabular_intershell_abundances_karakas_2012:[0,11],used:[0,1,2,4,5,7,11,12,14,15,16],useful:[0,4,5,7,9,11,14,15,17,18,21],useful_func:[9,10],user:[1,2,4,5,6,7,12,18],uses:[0,7,11,12,15],using:[0,1,5,9,12,14,15,17],usual:[0,2,7,11,15],util:[1,2,4,5,6,11,12,14,15,16,18,19,21],val:2,valid:[0,2,4,11,12],valu:[0,1,2,4,5,6,7,11,14,15,16],value_lin:14,valueerror:15,valuerang:[5,15],values_arrai:14,van:[0,11],vandenheuvel_log:[0,11],vari:[0,11,15],variabl:[0,3,4,5,7,11],variant:[0,11],variou:[0,11],vassiliadi:[0,11],veloc:[0,2,11],verbos:[1,2,4,7,9,14,15,17],verbose_print:4,veri:[0,5,11,12,14,15,19],versa:21,version:[0,4,5,9,11,15,17],version_info:4,version_info_str:4,version_onli:[0,11],via:[3,5,7,11,12,15,16],vice:21,vink:[0,11],virtual:[9,17],virtualenviron:[9,17],viscos:[0,11],viscou:[0,11],visibl:12,visit:9,volum:[0,11],vrot1:[0,11],vrot2:[0,11],vrot3:[0,11],vrot4:[0,11],vrot_breakup:0,vrot_bs:0,vrot_non_rot:0,vrot_sync:0,vw93:[0,11],vw93_eagb_wind_spe:[0,11],vw93_mira_shift:[0,11],vw93_multipli:[0,11],vw93_tpagb_wind_spe:[0,11],vwind:[0,11],vwind_beta:[0,11],vwind_multipli:[0,11],wai:[0,4,5,7,11,14,16],wang:[0,11],want:[0,2,4,5,6,7,11,12,15,16],warmup_cpu:[0,11],warn:[0,11,14,15],wave:[0,11,15],wd_accretion_rate_new_giant_envelope_lower_limit_helium_donor:[0,11],wd_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor:[0,11],wd_accretion_rate_new_giant_envelope_lower_limit_other_donor:[0,11],wd_accretion_rate_novae_upper_limit_helium_donor:[0,11],wd_accretion_rate_novae_upper_limit_hydrogen_donor:[0,11],wd_accretion_rate_novae_upper_limit_other_donor:[0,11],wd_kick:[0,11],wd_kick_at_every_puls:0,wd_kick_at_given_puls:0,wd_kick_direct:[0,11],wd_kick_end_agb:0,wd_kick_first_rlof:0,wd_kick_pulse_numb:[0,11],wd_kick_when:[0,11],wd_sigma:[0,11],wdwd_merger_algorithm:[0,11],wdwd_merger_algorithm_bs:0,wdwd_merger_algorithm_chen2016:0,wdwd_merger_algorithm_perets2019:0,weight:[0,7,11],well:[0,4,7,9,11,12,14,17],were:[4,15],what:[0,1,2,4,5,6,7,9,11,12,14,15,17,18],whatev:[5,9,12,17],wheeler:[0,11],when:[0,1,2,4,5,6,7,9,11,14,15,17,18],whenev:[9,17],where:[0,1,2,4,5,6,7,9,11,15,17],whether:[0,2,4,5,6,7,11,15,16,21],which:[0,1,2,4,5,6,7,9,11,12,14,15,17,18,21],whichev:7,white:[0,11],white_dwarf_cooling_carrasco2014:[0,11],white_dwarf_cooling_mestel:[0,11],white_dwarf_cooling_mestel_modifi:[0,11],white_dwarf_cooling_model:[0,11],white_dwarf_radius_carrasco2014:[0,11],white_dwarf_radius_model:[0,11],white_dwarf_radius_mu:[0,11],white_dwarf_radius_nauenberg1972:[0,11],whole:[5,7,12],width:[0,11],wind:[0,11],wind_algorithm_binary_c_2020:0,wind_algorithm_hurley2002:0,wind_algorithm_non:0,wind_algorithm_schneider2018:0,wind_angmom_loss_bs:0,wind_angmom_loss_lw:0,wind_angmom_loss_lw_hybrid:0,wind_angmom_loss_spherically_symmetr:0,wind_angular_momentum_loss:[0,11],wind_disc_angmom_fract:[0,11],wind_disc_mass_fract:[0,11],wind_djorb_fac:[0,11],wind_gas_to_dust_ratio:[0,11],wind_lbv_luminosity_lower_limit:[0,11],wind_mass_loss:[0,11],wind_multiplier_:[0,11],wind_nieuwenhuijzen_luminosity_lower_limit:[0,11],wind_type_multiplier_:[0,11],within:[0,4,5,9,11,12,15,17],without:[2,5,7,12,14],won:[0,11,14],wood:[0,11],work:[0,4,9,11,12,14,16,17],would:[0,4,11,15,16],wouldn:[5,15],wr_wind:[0,11],wr_wind_bs:0,wr_wind_eldridg:0,wr_wind_fac:[0,11],wr_wind_maeder_meynet:0,wr_wind_nugis_lam:0,wrap:[1,12],wrapper:[4,11,12,14,21],write:[1,4,5,6,7,11,12,14,15,18],write_binary_c_calls_to_fil:[5,15],write_binary_c_parameter_descriptions_to_rst_fil:4,write_grid_options_to_rst_fil:6,write_logfil:11,written:[5,6,7,11,14,15,18],written_data:14,wrlof_mass_transf:[0,11],wrlof_method:[0,11],wrlof_non:0,wrlof_q_depend:0,wrlof_quadrat:0,wrong:[9,17],wrwindfac:[0,11],wtts2:[0,11],wtts_log:[0,11],www:[0,2,11],x86_64:11,year:[0,2,11],yet:[0,4,7,11,16],yield:[0,11],you:[0,1,4,5,6,7,9,11,12,14,15,16,17,21],young:[0,11],your:[7,9,12,14,17],yourself:[15,16],zahn:[0,11],zam:[0,2,11,18,21],zams_collis:21,zams_mass:15,zams_mass_1:15,zams_mass_2:15,zero:[0,1,7,11],zero_ag:[12,14,15],zero_prob_stars_skip:15,zone:[0,11],zoom:[0,11],zoomfac_multiplier_decreas:[0,11],zoomfac_multiplier_increas:[0,11],zsolar:2,zytkow:[0,11]},titles:["Binary_c parameters","custom_logging_functions module","distribution_functions module","Example notebooks","functions module","grid_class module","Grid options and descriptions","Population grid code options","hpc_functions module","Welcome to binary_c-python\u2019s documentation!","Binarycpython code","Using the API functionality of binarycpython","Notebook custom logging","Extra features and functionality of binarycpython","Running individual systems with binarycpython","Running populations with binarycpython","plot_functions module","Python module for binary_c","run_system_wrapper module","spacing_functions module","stellar_types module","useful_funcs module"],titleterms:{"function":[4,11,13,14,15],"public":7,Adding:15,Using:[11,12],after:[9,17],algorithm:0,api:[11,12,14],binari:0,binary_c:[0,9,11,17],binarycpython:[10,11,13,14,15],build:[9,17],code:[7,10],compact:12,custom:12,custom_logging_funct:1,descript:6,directli:12,distribution_funct:2,document:[9,17],environ:[9,17],evolut:12,evolv:15,exampl:[3,9,11,12,15,17],extra:13,faq:[9,17],featur:13,free:11,from:[9,11,12,17],full:15,get:11,grid:[6,7,15],grid_class:5,handl:15,hpc_function:8,indic:9,individu:14,inform:11,input:0,instal:[9,17],instruct:[9,17],issu:[9,17],log:[12,15],mass:12,misc:0,modul:[1,2,4,5,8,9,16,17,18,19,20,21],moe:7,note:[9,17],notebook:[3,12],noteworthi:15,nucsyn:0,object:[12,14,15],option:[6,7],output:[0,15],paramet:0,pip:[9,17],plot_funct:16,popul:[7,12,14,15],privat:7,python:[9,17],requir:[9,17],run:[12,14,15],run_system_wrapp:18,run_wrapp:14,sampler:7,script:15,section:0,set:[11,15],singl:14,sourc:[9,17],spacing_funct:19,star:0,stefano:7,stellar_typ:20,store:11,string:12,supernova:12,system:14,tabl:9,usag:[9,11,12,17],useful_func:21,using:11,variabl:[9,15,17],via:[9,14,17],welcom:9,when:12}})
\ No newline at end of file
diff --git a/docs/build/html/spacing_functions.html b/docs/build/html/spacing_functions.html
index edc139099..5543b73f8 100644
--- a/docs/build/html/spacing_functions.html
+++ b/docs/build/html/spacing_functions.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -262,9 +262,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/stellar_types.html b/docs/build/html/stellar_types.html
index 193b7a074..5b735e30f 100644
--- a/docs/build/html/stellar_types.html
+++ b/docs/build/html/stellar_types.html
@@ -102,7 +102,7 @@
 <li class="toctree-l2"><a class="reference internal" href="useful_funcs.html">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -243,9 +243,9 @@
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/build/html/useful_funcs.html b/docs/build/html/useful_funcs.html
index 45b51577f..2b0dd6dc5 100644
--- a/docs/build/html/useful_funcs.html
+++ b/docs/build/html/useful_funcs.html
@@ -39,7 +39,7 @@
     
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />
-    <link rel="next" title="Examples" href="examples.html" />
+    <link rel="next" title="Example notebooks" href="example_notebooks.html" />
     <link rel="prev" title="stellar_types module" href="stellar_types.html" /> 
 </head>
 
@@ -102,7 +102,7 @@
 <li class="toctree-l2 current"><a class="current reference internal" href="#">useful_funcs module</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
+<li class="toctree-l1"><a class="reference internal" href="example_notebooks.html">Example notebooks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="binary_c_parameters.html">Binary_c parameters</a></li>
 <li class="toctree-l1"><a class="reference internal" href="grid_options_descriptions.html">Population grid code options</a></li>
 <li class="toctree-l1"><a class="reference external" href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python">Visit the GitLab repo</a></li>
@@ -415,7 +415,7 @@ determine if two stars collide on the ZAMS</p>
   
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
       
-        <a href="examples.html" class="btn btn-neutral float-right" title="Examples" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="example_notebooks.html" class="btn btn-neutral float-right" title="Example notebooks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
       
       
         <a href="stellar_types.html" class="btn btn-neutral float-left" title="stellar_types module" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -441,9 +441,9 @@ determine if two stars collide on the ZAMS</p>
     
     provided by <a href="https://readthedocs.org">Read the Docs</a>.
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 
 
diff --git a/docs/source/_templates/footer.html b/docs/source/_templates/footer.html
index 6eb6edade..8651c6d1e 100644
--- a/docs/source/_templates/footer.html
+++ b/docs/source/_templates/footer.html
@@ -2,8 +2,8 @@
 
 {%- block extrafooter %}
 <br><br>
-Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision 9da0c3480c4b6b62e6d4edc2d3e8b8a16079b020 url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
+Generated on binarycpython git branch: feature/binaryc_notebook_docs git revision ea5125892022d4b75619193546b5462398ba903b url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/feature/binaryc_notebook_docs">git url</a>.
 <br><br>
-Using binary_c with bit branch branch_david: git revision: "6068:20210727:8955b541d" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
+Using binary_c with bit branch branch_david: git revision: "6101:20210807:c5232be5c" url: <a href="https://gitlab.eps.surrey.ac.uk/ri0005/binary_c/-/tree/branch_david">git url</a>.
 
 {% endblock %}
\ No newline at end of file
diff --git a/docs/source/binary_c_parameters.rst b/docs/source/binary_c_parameters.rst
index 0c1a4dd88..96a16995f 100644
--- a/docs/source/binary_c_parameters.rst
+++ b/docs/source/binary_c_parameters.rst
@@ -4,7 +4,7 @@ The following chapter contains all the parameters that the current version of bi
 
 
 This information was obtained by the following binary_c build:
-	**binary_c git branch**: branch_david	**binary_c git revision**: 6068:20210727:8955b541d	**Built on**: Jul 27 2021 22:36:46
+	**binary_c git branch**: branch_david	**binary_c git revision**: 6101:20210807:c5232be5c	**Built on**: Aug  7 2021 17:32:06
 
 
 Section: stars
diff --git a/docs/source/example_notebooks.rst b/docs/source/example_notebooks.rst
new file mode 100644
index 000000000..7e2eef403
--- /dev/null
+++ b/docs/source/example_notebooks.rst
@@ -0,0 +1,15 @@
+Example notebooks
+=================
+We have a set of notebooks that explain and show the usage of the binarycpython features. The notebooks are also stored in the examples/ directory in the `repository <https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python/-/tree/master/examples>`_
+
+The order of the notebooks below is more or less the recommended order to read.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Contents:
+    
+    notebook_individual_systems.ipynb
+    notebook_custom_logging.ipynb
+    notebook_population.ipynb
+    notebook_extra_features.ipynb
+    notebook_api_functionality.ipynb
\ No newline at end of file
diff --git a/docs/source/examples.rst b/docs/source/examples.rst
deleted file mode 100644
index 16e4dc3a0..000000000
--- a/docs/source/examples.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Examples
-========
-This chapter contains the source code of example scripts which show the way of using certain functions
-
-.. toctree::                                                                    
-   :hidden:                                                                     
-
-   general_examples
-   population_example
-   notebooks
\ No newline at end of file
diff --git a/docs/source/general_examples.rst b/docs/source/general_examples.rst
deleted file mode 100644
index 8509de5b7..000000000
--- a/docs/source/general_examples.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Examples
-========
-The source code of the general examples.
-
-.. literalinclude:: ../../examples/examples.py
-    :language: python
-    :linenos:
\ No newline at end of file
diff --git a/docs/source/index.rst b/docs/source/index.rst
index b07d6ec3c..dd3e4bb0c 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -14,7 +14,7 @@ Welcome to binary_c-python's documentation!
 
    readme_link
    modules
-   examples
+   example_notebooks
    binary_c_parameters
    grid_options_descriptions
    Visit the GitLab repo <https://gitlab.eps.surrey.ac.uk/ri0005/binary_c-python>
diff --git a/docs/source/notebook_api_functionality.ipynb b/docs/source/notebook_api_functionality.ipynb
new file mode 100644
index 000000000..d81c31711
--- /dev/null
+++ b/docs/source/notebook_api_functionality.ipynb
@@ -0,0 +1,951 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "cb9d00f5-9613-471e-a4bb-6181311bf73b",
+   "metadata": {},
+   "source": [
+    "# Using the API functionality of binarycpython\n",
+    "This notebook shows how to use the API functions that interface with binary_c. It usually is better to use wrapper functions that internally use these API functions, because most of the output here is very raw\n",
+    "\n",
+    "Binarycpython uses the Python-C extension framework to interface Python with C. The sourcecode for this is contained in `src/binary_c_python.c`, and the functions are available via `from binarycpython import _binary_c_bindings`.\n",
+    "\n",
+    "The following functions are available through the API: (run cell below)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "ded7eaf6-e1ba-46c2-9f6f-9ebcb14a264d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on module binarycpython._binary_c_bindings in binarycpython:\n",
+      "\n",
+      "NAME\n",
+      "    binarycpython._binary_c_bindings - Module to interface the Binary_c API with python.\n",
+      "\n",
+      "FUNCTIONS\n",
+      "    free_persistent_data_memaddr_and_return_json_output(...)\n",
+      "        Frees the persistent_data memory and returns the json output\n",
+      "    \n",
+      "    free_store_memaddr(...)\n",
+      "        Frees the store memaddr\n",
+      "    \n",
+      "    return_arglines(...)\n",
+      "        Return the default args for a binary_c system\n",
+      "    \n",
+      "    return_help(...)\n",
+      "        Return the help info for a given parameter\n",
+      "    \n",
+      "    return_help_all(...)\n",
+      "        Return an overview of all the parameters, their description, categorized in sections\n",
+      "    \n",
+      "    return_maximum_mass_ratio_for_RLOF(...)\n",
+      "        Returns a string containing the maximum mass ratio for which a binary system does not RLOF at zams. Optionally accepts a store_capsule. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_minimum_orbit_for_RLOF(...)\n",
+      "        Returns a string containing the minimum orbit and separation for which a binary system does not RLOF at zams. Please use the wrapper functions in utils for this except when you know what you're doing\n",
+      "    \n",
+      "    return_persistent_data_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_store_memaddr(...)\n",
+      "        Return the store memory adress that will be passed to run_population\n",
+      "    \n",
+      "    return_version_info(...)\n",
+      "        Return the version information of the used binary_c build\n",
+      "    \n",
+      "    run_system(...)\n",
+      "        Function to run a system. This is a general function that will be able to handle different kinds of situations: single system run with different settings, population run with different settings, etc. To avoid having too many functions doing slightly different things. \n",
+      "        \n",
+      "        Arguments:\n",
+      "                argstring: argument string for binary_c\n",
+      "                (opt) custom_logging_func_memaddr: memory address value for custom logging function. Default = -1 (None)\n",
+      "                (opt) store_memaddr: memory adress of the store. Default = -1 (None)\n",
+      "                (opt) write_logfile: Boolean (in int form) for whether to enable the writing of the log function. Default = 0\n",
+      "                (opt) population: Boolean (in int form) for whether this system is part of a population run. Default = 0.\n",
+      "    \n",
+      "    test_func(...)\n",
+      "        Function that contains random snippets. Do not expect this to remain available, or reliable. i.e. dont use it.\n",
+      "\n",
+      "FILE\n",
+      "    /home/david/.pyenv/versions/3.6.4/envs/dev-binarycpython3.6.4/lib/python3.6/site-packages/binarycpython/_binary_c_bindings.cpython-36m-x86_64-linux-gnu.so\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "help(_binary_c_bindings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7ddede71-ffaa-4b24-aece-e94128a60d7f",
+   "metadata": {},
+   "source": [
+    "There are three main categories of functions:\n",
+    "\n",
+    "- Functions to get information from binary_c: these can be used to evolve systems, and get utility information from binary_c.\n",
+    "    - run_system\n",
+    "    - return_minimum_orbit_for_RLOF\n",
+    "    - return_maximum_mass_ratio_for_RLOF\n",
+    "    - return_help\n",
+    "    - return_help_all\n",
+    "    - return_arglines\n",
+    "\n",
+    "- Memory creation functions: these can be used to have binary_c allocate memory which is used or written to by binary_c\n",
+    "    - return_persistent_data_memaddr\n",
+    "    - return_store_memaddr\n",
+    "\n",
+    "- Memory freeing functions: These can be used to free the allocated memory, and in the case of persistent memory it will also return the contents of the ensemble\n",
+    "    - free_persistent_data_memaddr_and_return_json_output\n",
+    "    - free_store_memaddr"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0dd3e115-1571-42f7-9ab9-cf7688fa28c1",
+   "metadata": {},
+   "source": [
+    "## Example usage:"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5015daa-35ab-4736-a04d-f3cbe661638c",
+   "metadata": {},
+   "source": [
+    "### Setting up, using and freeing store"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "10a74d5a-a3d5-4543-a5bc-20d1fe885bb4",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<capsule object \"STORE\" at 0x7f163859d0c0>\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# allocating store memory\n",
+    "store_memaddr = _binary_c_bindings.return_store_memaddr()\n",
+    "print(store_memaddr)\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.run_system(argstring, store_memaddr=store_memaddr)\n",
+    "print(output)\n",
+    "\n",
+    "# Freeing store\n",
+    "_binary_c_bindings.free_store_memaddr(store_memaddr)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e9da5fc6-e680-483c-982e-4819767ed5b2",
+   "metadata": {},
+   "source": [
+    "### Getting information from binary_c"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "24f7ffe5-0076-459d-a37f-254e10d0d9f9",
+   "metadata": {},
+   "source": [
+    "We can get information for a parameter via return_help(parameter_name):\n",
+    "This will return an unparsed output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "318874f6-7acf-49bb-9786-299d4dffc0b3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "binary_c help for variable : M_1 <Float>\n",
+      "\n",
+      "The initial mass of star one (in solar units, internally this is star index 0).\n",
+      "\n",
+      "Default : 0\n",
+      "\n",
+      "\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help('M_1'))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f7fafce6-a522-43ac-a0c2-15a3db393b49",
+   "metadata": {},
+   "source": [
+    "We can get information on all available parameters via return_help(parameter_name):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "d7e757ae-579c-42a2-a310-f0401b7800e8",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "############################################################\n",
+      "##### Section Stars\n",
+      "############################################################\n",
+      "metallicity : This sets the metallicity of the stars, i.e. the amount (by mass) of matter which is not hydrogen or helium. If you are using the BSE algorithm, this must be 1e-4 <= metallicity <= 0.03. See also nucsyn_metallicity and effective_metallicity. : (null)\n",
+      "effective_metallicity : This sets effective metallicity of stars as used in routines like the Schneider wind loss. If not set, or set to DEFAULT_TO_METALLICITY (==-1, the default), this is just the same as metallicity. The main difference between effective_metallicity and metallicity is the range of validity: 0 <= effective_metallicity <= 1, while metallicity's range of validity is limited by the stellar evolution algorithm (so, for BSE, is 1e-4 <= metallicity <= 0.03). : (null)\n",
+      "M_1 : The initial mass of star one (in solar units, internally this is star index 0). : (null)\n",
+      "M_2 : The initial mass of star two (in solar units, internally this is star index 1). : (null)\n",
+      "M_3 : The initial mass of star three (in solar units, internally this is star index 2). : (null)\n",
+      "M_4 : The initial mass of star four (in solar units, internally this is star index 3). : (null)\n",
+      "vrot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot2,3,4. : (null)\n",
+      "vrot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,3,4. : (null)\n",
+      "vrot3 : The initial equatorial rotational velocity of star three (in km/s, internally this is star index 2). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,4. : (null)\n",
+      "vrot4 : The initial equatorial rotational velocity of star four (in km/s, internally this is star index 3). If 0.0, the Hurley et al 2000/2002 prescription is used to set the main-sequence velocity, so for a truly non-rotating star, set to something small (e.g. 0.001). See also vrot1,2,3. : (null)\n",
+      "Prot1 : The initial equatorial rotational velocity of star one (in km/s, internally this is star index 0). See also Prot2,3,4. : (null)\n",
+      "Prot2 : The initial equatorial rotational velocity of star two (in km/s, internally this is star index 1). See also Prot1,3,4. : (null)\n",
+      "Prot3 : The initial equatorial rotational period of star three (in days, internally this is star index 2). See also Prot1,2,4. : (null)\n",
+      "Prot4 : The initial equatorial rotational period of star four (in days, internally this is star index 3). See also Prot1,2,3. : (null)\n",
+      "inclination1 : The initial inclination of star one (in degrees). : (null)\n",
+      "inclination2 : The initial inclination of star two (in degrees). : (null)\n",
+      "inclination3 : The initial inclination of star three (in degrees). : (null)\n",
+      "inclination4 : The initial inclination of star four (in degrees). : (null)\n",
+      "B_1 : The initial magnetic field of star one (in Gauss, internally this is star index 0). : (null)\n",
+      "B_2 : The initial magnetic field of star two (in Gauss, internally this is star index 1). : (null)\n",
+      "B_3 : The initial magnetic field of star three (in Gauss, internally this is star index 2). : (null)\n",
+      "B_4 : The initial magnetic field of star four (in Gauss, internally this is star index 3). : (null)\n",
+      "B_inclination1 : The initial inclination of the magnetic field of star one (in degrees). : (null)\n",
+      "B_inclination2 : The initial inclination of the magnetic field of star two (in degrees). : (null)\n",
+      "B_inclination3 : The initial inclination of the magnetic field of star three (in degrees). : (null)\n",
+      "B_inclination4 : The initial inclination of the magnetic field of star four (in degrees). : (null)\n",
+      "stellar_type_1 : Set the stellar type of star 1 (internal index 0), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_2 : Set the stellar type of star 2 (internal index 1), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_3 : Set the stellar type of star 3 (internal index 2), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "stellar_type_4 : Set the stellar type of star 4 (internal index 3), usually MAIN_SEQUENCE (main sequence). Note that setting the stellar type only works for stars with both age=0 and core_mass=0, i.e. main sequence (hydrogen or helium), white dwarfs, black holes and neutrn stars. : (null)\n",
+      "max_stellar_type_1 : The maximum stellar type of star 1 (internal index 0). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value. \n",
+      " : (null)\n",
+      "max_stellar_type_2 : The maximum stellar type of star 2 (internal index 1). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_3 : The maximum stellar type of star 3 (internal index 2). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "max_stellar_type_4 : The maximum stellar type of star 4 (internal index 3). Evolution is stopped when the star reaches this stellar type. If this is negative, massless remnants are allowed, and the maximum stellar type is the absolute value.\n",
+      " : (null)\n",
+      "probability : The probability is a weighting applied to the star based on, say, the initial mass function. When running a grid of stars to simulate *all* stars, the summed probability of all the stars should be 1.0. : (null)\n",
+      "phasevol : The system's phase volume, used by binary_grid. : (null)\n",
+      "stellar_structure_algorithm : Set the stellar structure algorithm. 0=modified BSE (default), 1=none, 2=external function (must be defined by the calling code), 3=binary_c (not yet implemented). : (null)\n",
+      "solver : The type of solver. Default is the Forward-Euler (0), but could be RK2 (1), RK4 (2) or a predictor-corretor (3). : (null)\n",
+      "max_evolution_time : Set the maximum age for the stars (Myr). : (null)\n",
+      "max_model_number : Set the maximum number of models, ignored if 0 (default is 0). : (null)\n",
+      "monte_carlo_kicks : Turn on Monte-Carlo SN kicks. On (True) by default, and indeed other algorithms are probably broken. : (null)\n",
+      "disable_debug : Disables debug output. Only has an effect when DEBUG is 1, which probably requires a rebuild. Default FALSE. : (null)\n",
+      "timestep_logging : Turn on timestep logging (default is False). : (null)\n",
+      "rejects_in_log : Show timestep rejections in the main log (default is False). : (null)\n",
+      "vandenHeuvel_logging : Turn on van den Heuvel logging (default is False). : (null)\n",
+      "evolution_splitting : If True, turn on splitting of an evolutionary run if splitpoint (e.g. supernova) occurs. : (null)\n",
+      "disable_events : Whether to disable the new events code (defaults to False, so we use events by default)\n",
+      " : (null)\n",
+      "evolution_splitting_sn_eccentricity_threshold : Threshold eccentricity above which evolution splitting happens in a system with no SN kick. (0.01) : (null)\n",
+      "evolution_splitting_sn_n : Number of runs to split into when a SN occurs. : (null)\n",
+      "evolution_splitting_maxdepth : Max number of splits in an evolutionary run. : (null)\n",
+      "equation_of_state_algorithm : Set the equation of state algorithm. 0 = Paczynski. : (null)\n",
+      "opacity_algorithm : Set the opacity algorithm. 0 = Paczynski, 1 = Ferguson/Opal. : (null)\n",
+      "wind_mass_loss : Defines the algorithm used for stellar winds. 0 = none, 1 = Hurley et al. (2002), 2 = Schneider (2018). : 0\n",
+      "gbwind : Wind prescription for first red giant branch stars.  0=Reimers (Hurley et al 2000/2002; choose gb_reimers_eta=0.5 for their mass loss rate), 1=Schroeder+Cuntz 2005 (set gb_reimers_eta=1.0 for their mass loss rate). : (null)\n",
+      "mattsson_Orich_tpagbwind : Experimental : turns on Mattsson's TPAGB wind when the star is oxygen rich. Requires MATTSSON_MASS_LOSS. : (null)\n",
+      "magnetic_braking_factor : Multiplier for the magnetic braking angular momentum loss rate. : (null)\n",
+      "magnetic_braking_gamma : gamma factor in Rappaport style magnetic braking expression. : (null)\n",
+      "magnetic_braking_algorithm : Algorithm for the magnetic braking angular momentum loss rate. 0 = Hurley et al. 2002, 1 = Andronov, Pinnsonneault and Sills 2003, 2 = Barnes and Kim 2010  : (null)\n",
+      "helium_flash_mass_loss : Mass to be lost at the helium flash. : (null)\n",
+      "gb_reimers_eta : First red giant branch wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) : (null)\n",
+      "gbwindfac : Multiplier for the giant branch wind mass loss rate : (null)\n",
+      "tpagbwindfac : Multiplier for the TPAGB wind mass loss rate : (null)\n",
+      "eagbwindfac : Multiplier for the EAGB wind mass loss rate : (null)\n",
+      "nieuwenhuijzen_windfac : Multiplier for the Nieuwenhuijzen & de Jager wind mass loss rate : (null)\n",
+      "tpagbwind : Wind prescription during the TPAGB. 0=Karakas 2002 (a modified Vassiliadis and Wood 1993), 1=Hurley et al 2000/2002 (Vassiliadis and Wood 1993), 2=Reimers, 3=Bloecker, 4=Van Loon,  5=Rob's C-wind (broken?), 6,7=Vassiliadis and Wood 1993 (Karakas,Hurley variants respectively) when C/O>1, 8=Mattsson, 9 = Goldman et al. (2017), 10 = Beasor et al. (2020). : (null)\n",
+      "eagbwind : Wind prescription during the EAGB. 0=BSE (Hurley+2002, based on VW93), 1 = Goldman et al. (2017), 2 = Beasor et al. (2020). : (null)\n",
+      "wind_gas_to_dust_ratio : Gas to dust ratio used in wind calculations (e.g. Goldman et al. 2017). Typically 200 (Milky Way)-500 (Magellanic Clouds). Default is 200, approximately as in MW stars. : (null)\n",
+      "vwind_multiplier : Multiplier for the stellar wind velocity. : (null)\n",
+      "vwind_beta : Beta for stellar wind speed calculations, where vwind=sqrt(beta) * escape velocity. Default 0.125 (from BSE, Hurley et al. 2002).  : (null)\n",
+      "superwind_mira_switchon : In the Vassiliadis and Wood (1993) AGB wind prescription, the superwind is turned on at a given Mira period, usually 500 days. You can vary when this switch-on happens with this parameter. : (null)\n",
+      "vw93_mira_shift : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate depends on the Mira period plus this offset. Requires VW93_MIRA_SHIFT. : (null)\n",
+      "vw93_multiplier : In the Vassiliadis and Wood (1993) AGB wind prescription, the wind loss rate is multiplied by this factor. Requires VW93_MULTIPLIER. : (null)\n",
+      "tpagb_reimers_eta : TPAGB Reimers wind multiplication factor, cf. eta in Reimers' mass loss formula. (This multiplies the 4e-13 in Reimers' formula, or the 8e-14 in Schroeder and Cuntz.) Note that Reimers is not the default TPAGB wind prescription. See also tpagbwind. : (null)\n",
+      "artificial_mass_accretion_rate%d : Constant mass accretion rate for star <n>. : (null)\n",
+      "artificial_angular_momentum_accretion_rate%d : Constant angular momentum accretion for star <n>. : (null)\n",
+      "artificial_orbital_angular_momentum_accretion_rate : Constant angular momentum accretion rate on the orbit. : (null)\n",
+      "artificial_accretion_start_time : Time at which artificial accretion stars. Ignored if <0 (default is -1). : (null)\n",
+      "artificial_accretion_end_time : Time at which artificial accretion ends. Ignored if <0 (default is -1). : (null)\n",
+      "wr_wind : Massive-star (WR) wind prescription. 0 = Hurley et al 2000/2002, 1=Maeder and Meynet, 2=Nugis and Lamers, 3=John Eldridge's version of Vink's early-2000s wind (See Lynnette Dray's thesis, or John Eldridge's thesis) : (null)\n",
+      "wr_wind_fac : Massive-star (WR) wind multiplication factor. : (null)\n",
+      "wrwindfac : Massive-star (WR) wind multiplication factor. Synonymous with wr_wind_fac (which you should use instead). : (null)\n",
+      "BH_prescription : Black hole mass prescrition: relates the mass of a newly formed black hole to its progenitor's (CO) core mass. 0=Hurley et al 2000/2002, 1=Belczynski (early 2000s). : (null)\n",
+      "PPISN_prescription : (Pulsational) Pair-Instability Supernova prescription: Relates initial helium core mass of star to whether the star undergoes PPISN or PISN. Requires PPISN flag to be True (see binary_c_parameters.h). 0=no ppisn, 1=Farmer et al 2019. : Ignore\n",
+      "sn_kick_distribution_II : Set the distribution of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_ECAP : Set the distribution of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_NS_NS : Set the distribution of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IBC : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_GRB_COLLAPSAR : Set the distribution of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_TZ : Set the distribution of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_AIC_BH : Set the distribution of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_BH : Set the distribution of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_BH_NS : Set the distribution of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD : Set the distribution of speeds applied to any survivor of a hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_IA_Hybrid_HeCOWD_subluminous : Set the distribution of speeds applied to any survivor of a subluminous hybrid He-COWD SNIa explosion. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PPISN : Set the distribution of speeds applied to PPISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PISN : Set the distribution of speeds applied to PISN supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_distribution_PHDIS : Set the distribution of speeds applied to PHDIS supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_II : Set the dispersion of speeds applied to kick type II core collapse supernova systems. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_ECAP : Set the dispersion of speeds applied to the remnants of electron-capture supernovae. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_NS_NS : Set the dispersion of speeds applied to kick neutron stars and black holes that survive a NS-NS merger. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IBC : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_GRB_COLLAPSAR : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes after a type Ib/c core-collapse supernova which is also a collapsar. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_TZ : Set the dispersion of speeds applied to kick newly-born neutron stars and black holes at the death of a Thorne-Zytkow object. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_AIC_BH : Set the dispersion of speeds applied to kick newly-born neutron stars black holes after accretion induced collapse of a neutron star. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_BH : Set the dispersion of speeds applied to black holes formed by the merger of two black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_BH_NS : Set the dispersion of speeds applied to black holes formed by the merger of a neutron star and a black holes. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD : Set the dispersion of speeds applied to the survivor of a SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_IA_Hybrid_HeCOWD_subluminous : Set the dispersion of speeds applied to the survivor of a subluminous SNIa explosion of a hybrid He-COWD. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PPISN : Set the dispersion of speeds applied to the survivor of a PPISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PISN : Set the dispersion of speeds applied to the survivor of a PISN supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_dispersion_PHDIS : Set the dispersion of speeds applied to the survivor of a PHDIS supernova. 0=fixed, 1=maxwellian (hurley/BSE), 2=custom function (see monte_carlo_kicks.c). : (null)\n",
+      "sn_kick_companion_IA_He : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia He supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_ELD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia ELD (sub-Mch) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an accretion induced collapse (supernova) occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_ECAP : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when an electron capture supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_He_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia helium merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_CHAND_Coal : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Ia Mch merger supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_NS_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron-star neutron-star merger. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_GRB_COLLAPSAR : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a GRB Collapsar (rapidly rotating SN Ibc) supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_HeStarIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a He-star Ia supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IBC : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type Ib/c supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_II : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type II supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IIa : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a type IIa supernova occurs. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_WDKICK : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a WD is kicked. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_TZ : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a Thorne-Zytkow object is formed. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_AIC_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a neutron star collapses to a black hole. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_BH : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when two black holes merge. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_BH_NS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the, kick on the companion when a black hole merges with a neutron star. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_IA_Hybrid_HeCOWD_subluminous : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a subluminous hybrid He-COWD type Ia explosion. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PPISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PPISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PISN : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PISN supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "sn_kick_companion_PHDIS : Set the speed (if >=0) of, or the algothim (if <0) used to calculate the kick on the companion, if it survives, in a PHDIS supernova. 0 = none, 1 = Liu+2015, 2 = Wheeler+ 1975. : (null)\n",
+      "wd_sigma : Set the speed at which white dwarfs are kicked when they form, in km/s. Default is zero (i.e. no kick). Requires WD_KICKS. : (null)\n",
+      "wd_kick_direction : Set the direction of white dwarf kicks. 0 = random, 1 = up, 2 = forward, 3 = backward, 4 = inward, 5 = outward. Requires WD_KICKS. : (null)\n",
+      "wd_kick_when : Decide when to kick a white dwarf. 0=at birth, 1=at first RLOF, 2=at given pulse number (see wd_kick_pulse_number), 3 at every pulse Requires WD_KICKS. : (null)\n",
+      "wd_kick_pulse_number : Apply a kick to a star at a desired pulse number on the TPAGB (i.e. pre-WD). Requires WD_KICKS. : (null)\n",
+      "minimum_helium_ignition_core_mass : Minimum helium core mass required to ignite helium in the case that the hydrogen envelope is stripped on the giant branch, e.g. to make an sdB or sdO star. Typically 0.4, if 0.0 then the BSE algorithm (based on the total mass) is used. : (null)\n",
+      "minimum_CO_core_mass_for_carbon_ignition : Minimum CO core mass for carbon ignition, assuming Mc,bagb>1.6Msun. Typically around 1.08Msun (Pols+1998). : (null)\n",
+      "minimum_CO_core_mass_for_neon_ignition : Minimum CO core mass for neon ignition. Typically around 1.42Msun. Stars that have cores that ignite carbon, but not neon explode in electon-capture supernovae. : (null)\n",
+      "minimum_mcbagb_for_nondegenerate_carbon_ignition : Minimum Mc,bagb (core mass at the base of the AGB) for non-degenerate carbon ignition. Typically around 2.25Msun (Pols+1998). : (null)\n",
+      "maximum_mcbagb_for_degenerate_carbon_ignition : Maximum Mc,bagb (core mass at the base of the AGB) for degenerate carbon ignition. Typically around 1.6Msun (Pols+1998). : (null)\n",
+      "max_neutron_star_mass : Maximum mass of a neutron star before it collapses to a black hole. Typically around 2Msun. : (null)\n",
+      "chandrasekhar_mass : The Chandrasekhar mass, usually 1.44Msun : (null)\n",
+      "delta_mcmin : A parameter to reduce the minimum core mass for third dredge up to occur on the TPAGB. As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "lambda_min : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. See also lambda_multiplier. : (null)\n",
+      "lambda_multiplier : A parameter to increase the efficiency of third dredge up on the TPAGB. The efficiency is lambda * lambda_mult, and setting lambda_min>0 implies that, once Mc>Mcmin (see delta_mcmin) lambda=Max(lambda(fit to Karakas), lambda_min). As used by Izzard and Tout (2004) to increase the amount of dredge up, hence carbon, in Magellanic cloud stars. : (null)\n",
+      "minimum_envelope_mass_for_third_dredgeup : The minimum envelope mass for third dredge up on the TPAGB. Early, solar metallicity models by Straniero et al suggested 0.5Msun is typical. However, circumstantial evidence (Izzard et al 2009) as well as newer models by Stancliffe and Karakas suggest that at low metallicity a value nearer zero is more appropriate. : (null)\n",
+      "mass_of_pmz : The mass in the partial mixing zone of a TPAGB star, using the Karakas 2012 tables. Ask Carlo Abate for more details, or see the series of papers Abate et al 2012, 2013, 2014. Requires NUCSYN and USE_TABULAR_INTERSHELL_ABUNDANCES_KARAKAS_2012. : (null)\n",
+      "c13_eff : The \"efficiency\" of partial mixing in a TPAGB star intershell region, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "mc13_pocket_multiplier : Multiplies the mass in the partial mixing zone of a TPAGB star, when using the s-process tables of Gallino, Busso, Lugaro et al. as provided by Maria Lugaro for the Izzard et al. 2009 paper. Requires NUCSYN and NUCSYN_S_PROCESS. : (null)\n",
+      "tides_convective_damping : Tidal convective damping algorithm. 0=TIDES_HURLEY2002 Zahn 197x timescales + Hut, as in Hurley et al (2002), 1 = TIDES_ZAHN1989 : Zahn 1989 lambdas + Hut. : (null)\n",
+      "E2_prescription : Choose how to calculate the E2 structural parameter (used in tidal timescale calculations). 0=Hurley 1=Izzard (see Siess et al 2013). : (null)\n",
+      "dtfac : A parameter to decrease the timestep ONLY during the TPAGB phase. : (null)\n",
+      "hbbtfac : A parameter to modulate the temperature at the base of the hot-bottom burning zone in TPAGB stars. (Works only if NUCSYN is defined) : (null)\n",
+      "wind_multiplier_%d : Wind multiplier for the stellar type specified by the intger %d. By default these are all 1.0. : (null)\n",
+      "wind_type_multiplier_%d : Wind multiplier for different types of wind (MS, GB, AGB, WR, LBV, OTHER), given by the integer %d. By default these are all 1.0. : (null)\n",
+      "pre_main_sequence : Set to True to turn on pre-main sequence evolution. Currently this is not a special stellar type, rather the first (small) fraction of the main sequence has increased radii to match the Railton et al 2014 fits to Tout's pre-main sequence stars. Requires PRE_MAIN_SEQUENCE. See also pre_main_sequence_fit_lobes. : (null)\n",
+      "pre_main_sequence_fit_lobes : Set to True force a pre-main sequence star into its Roche lobe. This is done by artificially aging it. Requires PRE_MAIN_SEQUENCE : (null)\n",
+      "small_envelope_method : Choose the method used to determine the stellar radius when the envelope mass is very thin. 0 = Hurley et al. (2002), 1 = Miller Bertolami et al. (2016+) for GB and AGB stars only. : (null)\n",
+      "timestep_modulator : Multiplier applied to the global timestep. Requires TIMESTEP_MODULATION. : (null)\n",
+      "timestep_multiplier%d : Multiplier applied to timestep limit <n>. : (null)\n",
+      "maximum_timestep : The maximum timestep (MYr). : (null)\n",
+      "zoomfac_multiplier_decrease : When a timestep is rejected, decrease the timestep by this factor (0.5). : (null)\n",
+      "zoomfac_multiplier_increase : When a timestep is rejected, zooms, then succeeds, increase the timestep by this factor (1.2). : (null)\n",
+      "maximum_timestep_factor : The maximum factor between two subsequent timesteps (1.2). : (null)\n",
+      "maximum_nuclear_burning_timestep : The maximum timestep (MYr) in any nuclear burning phase. : (null)\n",
+      "nova_retention_method : Algorithm used to calculate the amount of mass retained during a nova explosion. 0=use nova_retention_fraction. (other methods pending) : (null)\n",
+      "MINT_metallicity : This sets the metallicity for MINT. It is ignored if set to -1.0, the default, in which case the normal metallicity parameter is used. : (null)\n",
+      "gaia_Teff_binwidth : log10(Effective temperature) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_L_binwidth : log10(luminosity) bin width used to make Gaia-like HRDs\n",
+      " : (null)\n",
+      "gaia_colour_transform_method : Use this to select the method used to transform to Gaia colours from other colour schemes. GAIA_CONVERSION_UBVRI_UNIVARIATE_JORDI2010 = 0 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_UBVRI_BIVARIATE_JORDI2010 = 1 Jordi et al.'s bivariate UBVRI fits, GAIA_CONVERSION_ugriz_UNIVARIATE_JORDI2010 = 2 Jordi et al.'s univariate UBVRI fits, GAIA_CONVERSION_ugriz_BIVARIATE_JORDI2010 = 3 Jordi et al.'s univariate ugriv fits, GAIA_CONVERSION_UBVRI_UNIVARIATE_EVANS2018 = 4 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_ugriz_UNIVARIATE_EVANS2018 = 5 Evans et al. (2018, DR2) fits, GAIA_CONVERSION_UBVRI_RIELLO2020 = 6 Riello et al. (2020, DR3) fits, GAIA_CONVERSION_ugriz_RIELLO2020 = 7 Riello et al. (2020, DR3) fits. : (null)\n",
+      "rotationally_enhanced_mass_loss : Set to 1 to enable rotationally enhanced mass loss rate algorithms: 0= none, 1=formula cf. Langer models (=ROTATIONALLY_ENHANCED_MASSLOSS_LANGER_FORMULA), 2=limit accretion rate before wind loss is applied, 3 = both 1 and 2. See also rotationally_enhanced_exponent : (null)\n",
+      "AGB_core_algorithm : Algorithm to use for calculating AGB core masses. 0=Hurley et al. 2002 if no NUCSYN, Karakas 2002 if NUCSYN is defined; 1=Hurley et al. 2002 (overshooting models); 1=Karakas 2002 (non-overshooting models). : (null)\n",
+      "AGB_radius_algorithm : Algorithm to use for calculating radii on the TPAGB. : (null)\n",
+      "AGB_luminosity_algorithm : Algorithm to use for calculating luminosities on the TPAGB. : (null)\n",
+      "AGB_3dup_algorithm : Algorithm to use for calculating third dredge up efficiency on the TPAGB. : (null)\n",
+      "overspin_algorithm : Algorithm to determine what we do when a star is rotating at its breakup velocity. OVERSPIN_BSE (0) conservatively transfers the angular momentum back to the orbit. OVERSPIN_MASSLOSS uses the rotationally_enhanced_massloss parameter to lose mass which carries away the angular momentum. : (null)\n",
+      "rotationally_enhanced_exponent : The exponent (power) by which rotationally enhanced mass loss is raised. Requires ROTATIONALLY_ENHANCED_MASS_LOSS. See also rotationally_enhanced_mass_loss. : (null)\n",
+      "batchmode : Set the batchmode control variable. Use only if you know what you are doing! : (null)\n",
+      "speedtests : If True, turns on speedtests during version information (off by default). : (null)\n",
+      "use_fixed_timestep_%d : Set to True to use fixed timestep <n>, False to turn off. Fixed timesteps are on (this is True) by default. : (null)\n",
+      "task%d : Control tasks to be performed by binary_c. By default, these are all TRUE. For more information see binary_c_macros.h, particularly the BINARY_C_TASK_* macros. : (null)\n",
+      "orbiting_object : Usage: --orbiting_object mass,spinrate,central_object,period. : 1.0\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_log : If True, turn on orbiting-object log. : (null)\n",
+      "orbiting_objects_wind_accretion_multiplier : Multiplier for wind accretion on orbiting objects. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "orbiting_objects_close_pc_threshold : How close are orbiting objects allowed to be? Set this to be the absolute percentage difference minimum. : (null)\n",
+      "orbiting_objects_tides_multiplier : Multiplier for tidal torques on orbiting objects. : (null)\n",
+      "evaporate_escaped_orbiting_objects : If True, evaporate orbiting objects that have escaped the system. : (null)\n",
+      "RLOF_transition_objects_escape : If True, objects that escape their Roche lobe are ejected from the system, otherwise they are placed just outside the minimum stable orbit. : (null)\n",
+      "PN_resolve : If True, the timestep will be shortened to resolve better the PN phase (FALSE). : (null)\n",
+      "PN_resolve_minimum_luminosity : The luminosity above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_maximum_envelope_mass : The envelope mass below which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_resolve_minimum_effective_temperature : The minimum effective temperature above which extra time resolution for PNe is applied (see PN_resolve). : (null)\n",
+      "PN_fast_wind : If True, thin-envelope PNe will have fast winds (FALSE). : (null)\n",
+      "PN_fast_wind_dm_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_mdot_GB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_GB) : (null)\n",
+      "PN_fast_wind_dm_AGB : The envelope mass below which fast wind used during the AGB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "PN_fast_wind_mdot_AGB : The envelope mass below which fast wind used during the GB if PN_fast_wind is TRUE. (See also PN_fast_wind, PN_fast_wind_mdot_AGB) : (null)\n",
+      "HeWD_HeWD_ignition_mass : HeWD-HeWD mergers above this mass reignite helium. (0.3) : (null)\n",
+      "wind_Nieuwenhuijzen_luminosity_lower_limit : Above this luminosity we activate the Nieuwenhuijzen and de Jager wind (4e3 Lsun). : (null)\n",
+      "wind_LBV_luminosity_lower_limit : Above this luminosity we activate the LBV wind (6e5 Lsun). : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Binary\n",
+      "############################################################\n",
+      "separation : Set the orbital separation (actually the semi-major axis) of the binary (internal index 0, stellar indices 0 and 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_triple : Set the orbital separation (actually the semi-major axis) of the triple (internal index 1) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "separation_quadruple : Set the orbital separation (actually the semi-major axis) of the quadruple (internal index 2) in solar radii. Note that if the orbital period is given, it is used to calculate the separation. So if you want to set the separation instead, either do not set the orbital period or set the orbital period to zero (0.0). : (null)\n",
+      "orbital_period : Set the initial orbital period of the binary, stars 1 and 2 (internal indices 0 and 1) in days. See also separation. : (null)\n",
+      "orbital_period_triple : Set the initial orbital period of the triple in days. See also separation. : (null)\n",
+      "orbital_period_quadruple : Set the orbital period of the outer binary in a quadrulple (stars 3 and 4, internal indices 2 and 3) in days. See also separation. : (null)\n",
+      "eccentricity : Set the initial eccentricity of the binary orbit (stars 1 and 2, internal indices 0 and 1). : (null)\n",
+      "eccentricity_triple : Set the initial eccentricity of the triple orbit. : (null)\n",
+      "eccentricity_quadruple : Set the initial eccentricity of the outer binary of a quadruple (stars 3 and 4, internal indices 2 and 3). : (null)\n",
+      "incliniation : Set the initial orbital_inclination of the binary relative to zero. : (null)\n",
+      "incliniation_triple : Set the initial orbital_inclination of the triple orbit relative to zero. : (null)\n",
+      "incliniation_quadruple : Set the initial orbital_inclinationy of the quadruple orbit relative to zero. : (null)\n",
+      "orbital_phase : Set the initial orbital phase of the binary orbit. : (null)\n",
+      "orbital_phase_triple : Set the initial orbital phase of the triple orbit. : (null)\n",
+      "orbital_phase_quadruple : Set the initial orbital phase of the quadruple orbit. : (null)\n",
+      "argument_of_periastron : Set the initial argument of periastron of the binary orbit. : (null)\n",
+      "argument_of_periastron_triple : Set the initial argument of periastron of the triple orbit. : (null)\n",
+      "argument_of_periastron_quadruple : Set the initial argument of periastron of the quadruple orbit. : (null)\n",
+      "disc_timestep_factor : Factor that multiplies the natural timestep of a disc. : (null)\n",
+      "white_dwarf_cooling_model : White dwarf cooling model, relates age to luminosity. WHITE_DWARF_COOLING_MESTEL = 0 is Mestel's model, WHITE_DWARF_COOLING_MESTEL_MODIFIED = 1 is Hurley's modified Mestel model, WHITE_DWARF_COOLING_CARRASCO2014 = 2 is based on Carrasco (2014) tables.   : (null)\n",
+      "white_dwarf_radius_model : White dwarf radius model, radius to mass (and perhaps age). WHITE_DWARF_RADIUS_NAUENBERG1972 = 0 Nauenberg (1972), WHITE_DWARF_RADIUS_MU = 1 mu-dependent variant, WHITE_DWARF_RADIUS_CARRASCO2014 = 2 is based on Carrasco (2014) tables. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_accretion_method : Chooses where the mass that is accreted from the inner edge of a circumbinary disc goes, i.e. to which star. 0 = Young and Clarke 2015, 1 = Gerosa et al 2015, 2 = 50:50 (i.e. not dependence on mass). : (null)\n",
+      "cbdisc_inner_edge_stripping : If True, allow inner edge mass stripping. : (null)\n",
+      "cbdisc_end_evolution_after_disc : If True, stop evolution when a disc evaporates. : (null)\n",
+      "cbdisc_no_wind_if_cbdisc : If True, disable stellar winds when there is a circumbinary disc. : (null)\n",
+      "cbdisc_outer_edge_stripping : If True, allow outer edge mass stripping. : (null)\n",
+      "disc_n_monte_carlo_guesses : Number of monte carlo guesses to try in the disc solver if the normal list of guesses fails (0). : (null)\n",
+      "disc_log : If 1, turn on the disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log2d : If 1, turn on the 2d disc log. Requires DISC_LOG to be defined on build. : (null)\n",
+      "disc_log_dt : If non-zero, only allows disc log output every disc_log_dt Myr. : (null)\n",
+      "disc_log_directory : Directory into which disc logging is sent (must exist!). : /tmp/\n",
+      "post_ce_adaptive_menv : If TRUE, and if post_ce_objects_have_envelopes is TRUE, then the envelope mass of a post-CE star is such that it sits just inside its Roche lobe. If FALSE then a fixed (thin) envelope mass is applied that depends on the stellar type (see macros POST_CE_ENVELOPE_DM_GB, POST_CE_ENVELOPE_DM_EAGB and POST_CE_ENVELOPE_DM_TPAGB). : (null)\n",
+      "post_ce_objects_have_envelopes : If TRUE then post-common-envelope objects have thin envelopes. You need this if you are to have post-CE post-AGB stars. Note that this *may* be unstable, i.e. you may end up having many CEEs. The mass in the envelope is controlled by post_ce_adaptive_menv. TRUE by default. : (null)\n",
+      "PN_comenv_transition_time : post-common envelope transition time in years (1e2).  This is the time taken to move from CEE ejection to Teff > 30e4 K. Hall et al. (2013) suggest ~100 years. : (null)\n",
+      "minimum_time_between_PNe : The minimum time (Myr) between planetary nebula detections. This prevents multiple, fast common envelopes triggering two PNe (0.1). : (null)\n",
+      "PN_Hall_fading_time_algorithm : In stars with low mass (<0.45Msun) cores, you can choose to set the PN fading time to either the minimum (PN_HALL_FADING_TIME_ALGORITHM_MINIMUM) or maximum (PN_HALL_FADING_TIME_ALGORITHM_MAXIMUM) as shown in Fig. 6 of Hall et al. (2013). : (null)\n",
+      "PPN_envelope_mass : Desired pre-planetary nebula (post-AGB) envelope mass. : (null)\n",
+      "cbdisc_eccentricity_pumping_method : Select from various eccentricity-pumping methods when there is a circumbinary disc. Requires DISCS. 0 = off. : (null)\n",
+      "cbdisc_viscous_photoevaporative_coupling : Set to 1 to turn on viscous-photoevaporative coupling in circumbinary discs. Requires DISCS. 0 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_NONE = off, 1 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_INSTANT instant, 2 = CBDISC_VISCOUS_PHOTOEVAPORATIVE_COUPLING_VISCOUS slow, viscous wind. : (null)\n",
+      "cbdisc_inner_edge_stripping_timescale : Defines the timescale for mass loss from by inner edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_in. : (null)\n",
+      "cbdisc_outer_edge_stripping_timescale : Defines the timescale for mass loss from by outer edge stripping. 0 = instant, 1 = very long, 2 = viscous at Revap_in, 3 = orbital at Revap_out. : (null)\n",
+      "cbdisc_viscous_L2_coupling : Set to 1 to turn on viscous-L2-loss coupling in circumbinary discs. Requires DISCS. 0 = off. : (null)\n",
+      "gravitational_radiation_model : Model for gravitational radiation from the system. 0=Hurley et al 2002 (Landau and Lifshitz 1951). 1 = as 0 but only when there is no RLOF. 2 = none. : (null)\n",
+      "nova_irradiation_multiplier : Multiplier for nova-radiative induced mass loss. (Shara+1986) : (null)\n",
+      "gravitational_radiation_modulator_J : Modulator for gravitational wave radiation angular momentum loss rate (1.0). : (null)\n",
+      "gravitational_radiation_modulator_e : Modulator for gravitational wave radiation eccentricity pumping rate (1.0). : (null)\n",
+      "nova_faml_multiplier : Nova friction-induced angular momentum loss multiplier. (Shara+1986) : (null)\n",
+      "RLOF_angular_momentum_transfer_model : Choose angular momentum transfer model in RLOF. 0=BSE (with discs), 1=conservative : (null)\n",
+      "post_SN_orbit_method : Method by which the post-SN orbit is calculated. 0=BSE, 1=Tauris&Taken 1998. : (null)\n",
+      "multiplicity : Multiplicity: 1=single star, 2=binary, 3=triple, 4=quadruple. : (null)\n",
+      "accretion_limit_eddington_steady_multiplier : Steady accretion is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_steady_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_LMMS_multiplier : Accretion from a low-mass, convective, main_sequence star is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_LMMS_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_eddington_WD_to_remnant_multiplier : Accretion from a WD onto a remnant star (e.g. another white dwarf, neutron star or black hole) is limited by the Eddington instability, with limiting rate given by the accretion_limit_eddington_WD_to_remnant_multiplier * the normal (spherically symmetric) Eddington rate. This is known in the trade as the Eddington factor, and anything greater than 1.0 potentially gives you super-Eddington accretion. : (null)\n",
+      "accretion_limit_thermal_multiplier : Mass transfer onto a MS, HG or CHeB star is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "accretion_limit_dynamical_multiplier : Mass transfer is limited by the accretor's dynamical rate times this multiplier. : (null)\n",
+      "donor_limit_envelope_multiplier : Mass transfer by RLOF is limited by this fraction of the donor's envelope mass per timestep : (null)\n",
+      "donor_limit_thermal_multiplier : Mass transfer by RLOF is limited by the accretor's thermal rate times this multiplier. : (null)\n",
+      "donor_limit_dynamical_multiplier : Mass transfer by RLOF is limited by the donor's dynamical rate times this multiplier. : (null)\n",
+      "Bondi_Hoyle_accretion_factor : Wind accretion rate, as calculated by the Bondi-Hoyle-Littleton formula, multiplcation factor. Hurley et al 2002 use 1.5, which is the default. : (null)\n",
+      "tidal_strength_factor : A modulator for the tidal strength. If this factor > 1 then tides are stronger, i.e. tidal timescales are reduced. : (null)\n",
+      "hachisu_qcrit : Critical q=Maccretor/Mdonor above which Hachisu's disk wind turns on. : (null)\n",
+      "hachisu_disk_wind : Set to True to turn on Hachisu's disk wind when material accretes too fast onto a white dwarf. This helps to make more SNeIa. See also hachisu_qcrit. : (null)\n",
+      "mass_accretion_for_eld : The mass that must be accreted onto a COWD for it to ignite as an edge-lit detonation SNIa. : (null)\n",
+      "WDWD_merger_algorithm : Algorithm to be used when merging two white dwarfs. 0 = Hurley et al. (2002), 1 = Perets+ (2019), 2 = Chen+ (2016, todo)  : (null)\n",
+      "type_Ia_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from Chandrasekhar-mass exploders. 0 = DD7 (Iwamoto 1999), 1 = Seitenzahl 2013 3D hydro yields (you must also set Seitenzahl2013_model)  : (null)\n",
+      "Seitenzahl2013_model : Which of Seitenzahl et al. 2013's models to use? One of N1,N3,N5,N10,N20,N40,N100L,N100,N100H,N150,N200,N300C,N1600,N1600C,N100_Z0.5,N100_Z0.1,N100_Z0.01 (defaults to N100). : N1\n",
+      "type_Ia_sub_MCh_supernova_algorithm : Algorithm to be used when calculating type Ia yields from sub-Chandrasekhar-mass exploders. (Currently unused.) : (null)\n",
+      "max_HeWD_mass : The maximum mass a HeWD can have before it ignites helium (0.7). : (null)\n",
+      "merger_mass_loss_fraction : Fraction of the total mass which is lost when stars merge. : (null)\n",
+      "merger_angular_momentum_factor : When two stars merge the resulting single star retains a fraction of the total system angular momentum (or the critical spin angular momentum, if it is smaller) multiplied by this factor. : (null)\n",
+      "wind_angular_momentum_loss : Prescription for losing angular momentum in a stellar wind. 0=Hurley et al 2002 ('Tout') prescription, 1=lw i.e. a factor multiplying the specific orbital angular momentum, 2=lw hybrid for fast winds. Set wind_djorb_fac to the desired factor.. : (null)\n",
+      "wind_djorb_fac : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=0 (the Tout/Hurley et al 2002 prescription). See wind_angular_momentum_loss. : (null)\n",
+      "lw : Factor multiplying angular momentum loss in a stellar wind when wind_angular_momentum_loss=1,2 (the 'lw' prescription). See wind_angular_momentum_loss. : (null)\n",
+      "VW93_EAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "VW93_TPAGB_wind_speed : Activate this to use Vassiliadis and Wood (1993) wind speed during the EAGB. : (null)\n",
+      "use_periastron_Roche_radius : Set this to True to use the Roche lobe radius at periastron, rather than (the default to) assume a circular orbit. This will be useful one day when we treat RLOF in eccentric orbits properly, hopefully. : (null)\n",
+      "qcrit_LMMS : Apply critical q=Mdonor/Maccretor value for low-mass main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for non-degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_LMMS : Apply critical q=Mdonor/Maccretor value for (low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_MS : Apply critical q=Mdonor/Maccretor value for (non-low mass) main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HG : Apply critical q=Mdonor/Maccretor value for Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_GB : Apply critical q=Mdonor/Maccretor value for first red giant branch stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_CHeB : Apply critical q=Mdonor/Maccretor value for core helium burning stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_EAGB : Apply critical q=Mdonor/Maccretor value for early-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_TPAGB : Apply critical q=Mdonor/Maccretor value for TP-AGB stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeMS : Apply critical q=Mdonor/Maccretor value for helium main sequence stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeHG : Apply critical q=Mdonor/Maccretor value for helium Hertzsprung gap stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeGB : Apply critical q=Mdonor/Maccretor value for helium red giant stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_HeWD : Apply critical q=Mdonor/Maccretor value for helium white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_COWD : Apply critical q=Mdonor/Maccretor value for carbon-oxygen white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_ONeWD : Apply critical q=Mdonor/Maccretor value for oxygen-neon white dwarf stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_NS : Apply critical q=Mdonor/Maccretor value for neutron stars to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "qcrit_degenerate_BH : Apply critical q=Mdonor/Maccretor value for black holes to determine the stability of Roche-lobe overflow for degenerate accretors. See also qcrits_*, qcrits_degenerate_*. : (null)\n",
+      "mass_for_Hestar_Ia_upper : Only helium stars below this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_lower. : (null)\n",
+      "mass_for_Hestar_Ia_lower : Only helium stars above this mass can explode as SNIa. Default is zero, i.e. it never happens. See also mass_for_Hestar_Ia_upper. : (null)\n",
+      "alphaCB : Circumbinary disk viscosity parameter, alpha. : (null)\n",
+      "minimum_donor_menv_for_comenv : Minimum donor envelope mass for common envelope evolution to be triggered (Msun). Default 0. : (null)\n",
+      "comenv_prescription : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_prescription%d : Use this to choose which common envelope prescription you should use. 0=Hurley et al 2002 (based on the Paczyński energy model) or 1=Nelemans and Tout (angular momentum model). See also alpha_ce, comenv_ms_accretion_mass, comenv_ms_accretion_fraction, comenv_ns_accretion_fraction, comenv_ns_accretion_mass, nelemans_gamma, nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs, lambda_ce, lambda_ionisation. : (null)\n",
+      "comenv_ejection_spin_method : When a common envelope is ejected, we need to decide how fast the stars are left spinning. COMENV_EJECTION_SPIN_METHOD_DO_NOTHING (0) is the default, this just leaves the stars/stellar cores spinning with the same spin rate (omega = angular velocity) with which they entered the common envelope phase. COMENV_EJECTION_SPIN_METHOD_SYCHRONIZE instead tidally synchronizes the stars with their new orbital angular velocity. : (null)\n",
+      "comenv_merger_spin_method : When a common envelope binary merges, we need to decide how fast the resulting single star is left spinning. COMENV_MERGER_SPIN_METHOD_SPECIFIC (0) is the default, this preserves angular momentum but limits the specific angular momentum of the merged star to the specific angular momentum of the system at the onset of common envelope evolution. COMENV_MERGER_SPIN_METHOD_CONSERVE_ANGMOM (1) sets the merger's angular momentum to be that of the system at the onset of common envelope evolution (which means the star may be rotating supercritically). COMENV_MERGER_SPIN_METHOD_CONSERVE_OMEGA (2) sets the spin rate (angular frequency = omega) of the merged star to be that of the orbit just at the onset of common envelope evolution. : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "comenv_ms_accretion_fraction : Experimental. During common envelope evolution, a main sequence may accrete a fraction of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_mass. : (null)\n",
+      "comenv_ns_accretion_mass : Experimental. During common envelope evolution, a neutron star may accrete some of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_fraction. : (null)\n",
+      "comenv_ns_accretion_fraction : Experimental. During common envelope evolution, a neutron star may accrete a fraction of the envelope's mass. Requires COMENV_NS_ACCRETION. See also comenv_ns_accretion_mass. : (null)\n",
+      "alpha_ce : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "alpha_ce%d : Common envelope energy formalism parameter. A fraction alpha of the orbital energy is used to eject the envelope. See Hurley et al 2002 for details. : (null)\n",
+      "lambda_ce : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "lambda_ce%d : Common envelope parameter. The binding energy of the common envelope is G*M*Menv/(lambda*R). Typically this is taken to be 0.5, but if set to -1 binary_c uses the Dewi and Tauris fits instead, -2 uses the formalism of Wang, Jia and Li (2016) and if -3 then a polytropic formalism is used (see also comenv_splitmass). : (null)\n",
+      "comenv_splitmass : When lambda_ce=-2, the envelope binding energy, lambda, is calculated using a polytropic formalism. The comenv_splitmass defines the point, in the units of the core mass, above which material is ejected. : (null)\n",
+      "nelemans_recalc_eccentricity : If True, recalculate the eccentricity after angular momentum is removed.  : (null)\n",
+      "comenv_post_eccentricity : Eccentricity remaining after common envelope ejection. : (null)\n",
+      "nelemans_gamma : Set the fraction of the orbital specific angular momentum that is used to eject the common envelope according to the Nelemans and Tout prescription. See also nelemans_minq, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_minq : Only activate the Nelemans and Tout common envelope prescription for q>nelemans_minq. See also nelemans_gamma, nelemans_max_frac_j_change, nelemans_n_comenvs. : (null)\n",
+      "nelemans_max_frac_j_change : Maximum fractional angular momentum change in the Nelemans and Tout common envelope prescription. See also nelemans_gamma, nelemans_minq, nelemans_n_comenvs. : (null)\n",
+      "nelemans_n_comenvs : Set the maximum number of common envelope ejections allowed to follow the Nelemans and Tout prescription, after which the standard alpha prescription is used. : (null)\n",
+      "lambda_ionisation : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_ionisation%d : A fraction lambda_ionisation of the recombination energy in the common envelope goes into ejecting the envelope. This is usually 0.0, but a positive value can make a big difference to the outcome of common envelope evolution. : (null)\n",
+      "lambda_enthalpy : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "lambda_enthalpy%d : A fraction of the enthalpy to be included in the common envelope evolution binding energy. Only used for the Wang 2016 prescription (so far). : (null)\n",
+      "cbdisc_albedo : Circumbinary-disc albedo. Requires DISCS. : (null)\n",
+      "cbdisc_gamma : Circumbinary disc gamma (equation of state) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_alpha : Circumbinary disc alpha (viscosity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_kappa : Circumbinary disc kappa (opacity) parameter. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_evaporation_timescale : Circumbinary disc minimum evaporation timescale (years). If (slow, not edge stripped) mass loss would evaporate the disc on a timescale less than this, simply evaporate the disc immediated. Usually set to 1y, ignore if zero. Requires DISCS. : (null)\n",
+      "cbdisc_torquef : Circumbinary disc binary torque multiplier. Requires DISCS. : (null)\n",
+      "cbdisc_max_lifetime : Circumbinary disc maximum lifetime (years, ignored if 0). Requires DISCS. : (null)\n",
+      "cbdisc_init_dM : On cbdisc start, reduce mass by a fraction dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_init_dJdM : On cbdisc start, reduce angular momentum by a fraction dJ/dM*dM if it won't converge. Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_constant_rate : Circumbinary disc constant mass loss rate (Msun/year). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_FUV_multiplier : Circumbinary disc FUV mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_Xray_multiplier : Circumbinary disc X-ray mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_ram_pressure_multiplier : Circumbinary disc interstellar medium ram pressure stripping mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_ISM_pressure : Circumbinary disc interstellar medium ram pressure in units of Boltzmann constant per Kelvin (I think...). Requires DISCS. Typically 3000.0. See e.g. http://www.astronomy.ohio-state.edu/~pogge/Ast871/Notes/Intro.pdf page 15 or https://arxiv.org/pdf/0902.0820.pdf Fig. 1 (left panel). : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_multiplier : Circumbinary disc inner edge viscous mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_mass_loss_inner_viscous_angular_momentum_multiplier : Circumbinary disc inner edge viscous angular momentum multiplier (no units). The inner edge angular momentum Requires DISCS. : (null)\n",
+      "cbdisc_resonance_multiplier : Circumbinary disc resonant interaction multiplier, affects eccentricity pumping and angular momentum rates. Requires DISCS. : (null)\n",
+      "cbdisc_resonance_damping : Circumbinary disc resonant interaction damping: should be on (True) to damp the l=1, m=2 resonance when the disc inner edge lies outside the resonance location. Requires DISCS. : (null)\n",
+      "cbdisc_fail_ring_inside_separation : If True, while converging on a structure, circumbinary discs with Rring < the binary separation are immediately failed. : (null)\n",
+      "cbdisc_mass_loss_inner_L2_cross_multiplier : Circumbinary disc inner edge L2-crossing mass loss rate multiplier (no units). Requires DISCS. : (null)\n",
+      "cbdisc_minimum_luminosity : Circumbinary disc minimum luminosity. If the disc becomes dimmer than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_mass : Circumbinary disc minimum mass. If the disc becomes less massive than this, the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "cbdisc_minimum_fRing : Circumbinary disc minimum fRing. If the disc becomes a ring, and fRing = |Rout/Rin-1| < this value (and this value is non-zero), the disc is evaporated instantly. Requires DISCS. : (null)\n",
+      "comenv_disc_angmom_fraction : If >0 Fraction of the common envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the moments of inertia to calculate (deprecated), if -2 use the common envelope's specific angular momentum, if -3 uses the L2 point at the end of the common envelope to set the angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "comenv_disc_mass_fraction : Fraction of the common envelope's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_COMENV. : (null)\n",
+      "wind_disc_angmom_fraction : If >0 Fraction of the wind envelope's angular momentum that goes into the circumbinary disc. If -1 then uses the L2 point's specific angular momentum. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "wind_disc_mass_fraction : Fraction of the stellar wind's mass that goes into the circumbinary disc. Requires DISCS and DISCS_CIRCUMBINARY_FROM_WIND. : (null)\n",
+      "WRLOF_method : Choose whether and how to apply wind-Roche-lobe-overflow. 0=none, 1=q-dependent, 2=quadratic See Abate et al 2013/14 for details. Requires WRLOF_MASS_TRANSFER. : (null)\n",
+      "minimum_timestep : The minimum timestep (Myr). : (null)\n",
+      "timestep_solver_factor : Factor applied in timestep_limits, e.g. to prevent X changing too fast by comparing to X/dX/dt, which is usually 1 but can be higher to lengthen timesteps when using an alternative solver. : (null)\n",
+      "RLOF_mdot_factor : Multiplier applied to the mass transfer rate during Roche-lobe overflow. Requires RLOF_MDOT_MODULATION. : (null)\n",
+      "RLOF_f : Factor to enlarge a Roche lobe, nominally because of radiation pressure (see Dermine et al paper). Requires RLOF_RADIATION_CORRECTION. : (null)\n",
+      "minimum_separation_for_instant_RLOF : If True, instead of evolving the system just report the minimum separation (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_orbital_period_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "minimum_orbital_period_for_instant_RLOF : If True, instead of evolving the system just report the minimum orbital period (on the zero-age main sequence) that would lead to instant RLOF. Used by binary_grid. See also minimum_separation_for_instant_RLOF and maximum_mass_ratio_for_instant_RLOF. : (null)\n",
+      "maximum_mass_ratio_for_instant_RLOF : If True, instead of evolving the system just report the maximum mass ratio (on the zero-age main sequence) that would lead to instant RLOF, given M1 and orbital period. Used by binary_grid. See also minimum_separation_for_instant_RLOF and minimum_orbital_period_for_instant_RLOF. : (null)\n",
+      "RLOF_method : Use RLOF_method to choose the algorithm you use for Roche-lobe overflow mass loss rate calculations. 0=Hurley et al 2002, 1=Adaptive (for radiative stars) R=RL method, 2=Ritter (probably broken), 3=Claeys etal 2014 variant on Hurley et al 2002. : (null)\n",
+      "RLOF_interpolation_method : When a star overflows its Roche lobe, it always has R>RL because of the limited time resolution of the simulation. Binary_c then uses an algorithm to get back to when R~RL (within a desired tolerance, set in RLOF_ENTRY_THRESHOLD which is usually 1.02, i.e. overflow of 2%). You can choose algorithm 0, the Hurley et al 2002 method which reverses time (i.e. uses a Newton-like scheme), or 1 to use the binary_c method which rejects a timestep (and hence does no logging on that timestep) and repeats with half the timestep until R~RL. The latter is now the default, because this means there are no negative timesteps which break various other algorithms (e.g. nucleosynthesis). : (null)\n",
+      "nova_retention_fraction : The mass accreted during a nova as fraction of mass transferred : (null)\n",
+      "beta_reverse_nova : The fraction of mass ejected in a nova explosion which is accreted back onto the companion star. Set to -1 to automatically calculate based on a geometric argument, or 0 or positive to set the value. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_hydrogen_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is hydrogen rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_helium_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_novae_upper_limit_other_donor : Upper limit of the stable mass transfer rate onto a white dwarf that leads to novae when the donor is neither hydrogen nor helium rich : above this rate the mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_hydrogen_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a hydrogen-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_helium_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope with a helium-rich donor. Below this mass transfer leads to stable burning. : (null)\n",
+      "WD_accretion_rate_new_giant_envelope_lower_limit_other_donor : Lower limit of the mass transfer rate onto a white dwarf that leads to a the formation of a new giant envelope when the donor is neither hydrogen nor helium rich. Below this mass transfer leads to stable burning. : (null)\n",
+      "CRAP_parameter : Tidally enhanced mass loss parameter. See Tout and Eggleton's paper on the subject. (Was the parameter bb). : (null)\n",
+      "individual_novae : If individual_novae is True, novae are resolved such that each explosion is performed separtaely. : (null)\n",
+      "nova_timestep_accelerator_num : The nova timestep is accelerated if the nova number exceeds nova_timestep_accelerator_num. If zero or negative, acceleration is off. See also nova_timestep_accelerator_index and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_index : The index at which the nova timestep is accelerated. A larger value gives longer timesteps. See also nova_timestep_accelerator_num and nova_timestep_accelerator_max. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nova_timestep_accelerator_max : The nova timestep is accelerated by a factor that is capped at nova_timestep_accelerator_max. This parameter is ignored if it is zero or negative. See also nova_timestep_accelerator_num and nova_timestep_accelerator_index. Only used if individual_novae is on.\n",
+      " : (null)\n",
+      "nonconservative_angmom_gamma : Mass lost from the system (but NOT from a stellar wind) takes a fraction gamma of the orbital angular momentum with it. Set to -1 to take the specific angular momentum of the donor star. Set to -2 to take super-Eddington, nova and disk-wind angular momenta as if a wind from the accretor. : (null)\n",
+      "max_stellar_angmom_change : Maxmimum fractional change in stellar angular momentum allowed before a timestep is rejected (0.05). : (null)\n",
+      "comenv_ms_accretion_mass : Experimental. During common envelope evolution, a main sequence star may accrete some of the envelope's mass. Requires COMENV_MS_ACCRETION. See also comenv_ms_accretion_fraction. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Nucsyn\n",
+      "############################################################\n",
+      "third_dup : If True, enables third dredge up. Requires NUCSYN and NUCSYN_THIRD_DREDGE_UP. : (null)\n",
+      "third_dup_multiplier : Usage: --third_dup_multiplier <i> <f>. Multiplies the abundance of element <i> by <f> during third dredge up. : 1.0\n",
+      "NeNaMgAl : Enables NeNaMgAl reaction network. Requires NUCSYN and NUCSYN_HBB. : Ignore\n",
+      "nucsyn_network%d : Usage: --nucsyn_network%d <boolean>. Turn a nuclear network on or off. : (null)\n",
+      "nucsyn_network_error%d : Usage: --nucsyn_network_error%d <f>. Threshold error in nuclear network solver for network %d. : (null)\n",
+      "nucreacmult%d : Usage: --nucreacmult%d <f>. Multiply nuclear reaction given by the integer %d (integer) by f (float).  : (null)\n",
+      "nucsyn_metallicity : This sets the metallicity of the nucleosynthesis algorithms, i.e. the amount (by mass) of matter which is not hydrogen or helium. Usually you'd just set this with the metallicity parameter, but if you want the nucleosynthesis to be outside the range of the stellar evolution algorithm (e.g. Z=0 or Z=0.04) then you need to use nucsyn_metallicity. That said, it's also outside the range of some of the nucleosynthesis algorithms as well, so you have been warned! : (null)\n",
+      "nucsyn_solver : Choose the solver used in nuclear burning. 0 = KAPS_RENTROP is a Kaps-Rentrop scheme (fast, not great for stiff problems), 1 = LSODA (Adams/BSF switcher), 2 = CVODE library (https://computing.llnl.gov/projects/sundials. Default 0.  : 0\n",
+      "initial_abundance_mix : initial abundance mixture: 0=AG89, 1=Karakas 2002, 2=Lodders 2003, 3=Asplund 2005 (not available?), 4=Garcia Berro, 5=Grevesse Noels 1993 : 0\n",
+      "init_abund : Usage: --init_abund <i> <X>. Sets the initial abundance of isotope number <i> to mass fraction <X>. : 0.02\n",
+      "init_abund_mult : Usage: --init_abund_mult <i> <f>. Multiplies the initial abundance of isotope number <i> by <f>. : 1.0\n",
+      "init_abund_dex : Usage: --init_abund_dex <i> <f>. Changes the initial abundance of isotope number <i> by <f> dex. : 0.0\n",
+      "init_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "initial_abunds_only : If True, outputs only the initial abundances, then exits. : (null)\n",
+      "no_thermohaline_mixing : If True, disables thermohaline mixing. : (null)\n",
+      "lithium_GB_post_Heflash : Sets the lithium abundances after the helium flash. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_GB_post_1DUP : Sets the lithium abundance after first dredge up. Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "lithium_hbb_multiplier : Multiplies the lithium abundances on the AGB during HBB (based on Karakas/Fishlock et al models).Requires NUCSYN and LITHIUM_TABLES. : (null)\n",
+      "angelou_lithium_decay_function : Functional form which describes Li7 decay. Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Choices are : 0 expoential (see angelou_lithium_decay_time). : (null)\n",
+      "angelou_lithium_LMMS_time : Time at which lithium manufacture is triggered in a low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_time : Time at which lithium manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_time : Time at which lithium manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_time : Time at which lithium manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_time : Time at which lithium manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_time : Time at which lithium manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_time : Time at which lithium manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_decay_time : Decay time for surface lithium abundance during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_decay_time : Decay time for surface lithium abundance on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_decay_time : Decay time for surface lithium abundance on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_decay_time : Decay time for surface lithium abundance on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_decay_time : Decay time for surface lithium abundance during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_decay_time : Decay time for surface lithium abundance on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_decay_time : Decay time for surface lithium abundance on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_LMMS_massfrac : Lithium mass fraction when its manufacture is triggered during the low-mass (convective) main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_MS_massfrac : Lithium mass fraction when its manufacture is triggered on the main sequence (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_HG_massfrac : Lithium mass fraction when its manufacture is triggered on the Hertzsprung gap (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_GB_massfrac : Lithium mass fraction when its manufacture is triggered on the giant branch (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_CHeB_massfrac : Lithium mass fraction when its manufacture is triggered during core helium burning (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_EAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the early AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_TPAGB_massfrac : Lithium mass fraction when its manufacture is triggered on the thermally pulsing AGB (Myr). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0 (for the start, use 1e-6).\n",
+      " : (null)\n",
+      "angelou_lithium_vrot_trigger : Equatorial rotational velocity at which lithium manufacture is triggered (km/s). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "angelou_lithium_vrotfrac_trigger : Fraction of Keplerian (breakup) equatorial rotational velocity at which lithium manufacture is triggered (must be <1, ignored if 0). Requires NUCSYN and NUCSYN_ANGELOU_LITHIUM. Ignored if 0.\n",
+      " : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Output\n",
+      "############################################################\n",
+      "david_logging_function : Function to choose which kind of information gets logged Requires DAVID. Choices are: 0= None, >0 for custom logging functions : Ignore\n",
+      "cf_amanda_log : Enable logging to compare to Amanda's models. : (null)\n",
+      "float_overflow_checks : Turn on to enable floating-point overflow checks at the end of each timestep, if they are available. 0=off, 1=warn (stderr) on failure, 2=exit on failure (0) : (null)\n",
+      "save_pre_events_stardata : Enable this to save a copy of stardata to stardata->pre_events_stardata just before an event. : (null)\n",
+      "disable_end_logging : Disable the logging that happens at the end of the evolution. : (null)\n",
+      "ensemble : Turn on ensemble calculations and output. : (null)\n",
+      "ensemble_filters_off : Sets all ensemble filters to be off (FALSE) - these can then be enabled one-by-one with --ensemble_filter_[...] TRUE. : (null)\n",
+      "ensemble_filter_%d : Turn on or off ensemble filter <n>. For a list of filters, see ensemble_macros.h. : (null)\n",
+      "ensemble_legacy_ensemble : Turn on ensemble legacy population output. : (null)\n",
+      "legacy_yields : Turn on ensemble legacy yield output. : (null)\n",
+      "ensemble_defer : Defer ensemble output. : (null)\n",
+      "ensemble_dt : When doing ensemble calculations, data are stored and/or output every ensemble_dt Myr. See also ensemble, ensemble_logdt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logdt : When doing ensemble calculations, and when logensembletimes is set, the ensemble is stored/output every ensemble_logdt Myr. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_startlogtime : Start log ensemble data storage/calculations/output at ensemble_startlogtime. See also ensemble, ensemble_dt, ensemble_startlogtime. : (null)\n",
+      "ensemble_logtimes : When doing ensemble calculations/output, set this to act at log times rather than linear times. : (null)\n",
+      "postagb_legacy_logging : Turn on post-AGB legacy logging. : (null)\n",
+      "disc_legacy_logging : Turn on disc legacy logging. : (null)\n",
+      "EMP_logg_maximum : Maximum logg that EMP stars are allowed to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_minimum_age. : (null)\n",
+      "EMP_minimum_age : Minimum age that EMP stars are required to have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum. : (null)\n",
+      "EMP_feh_maximum : Maximum [Fe/H] that an EMP stars may have. See Izzard et al 2009. See also CEMP_cfe_minimum, NEMP_nfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default -2.0. : (null)\n",
+      "CEMP_cfe_minimum : Minimum [C/Fe] that CEMP stars are required to have. See Izzard et al 2009. See also NEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 0.7. : (null)\n",
+      "NEMP_cfe_minimum : Minimum [N/Fe] that NEMP stars are required to have. See Izzard et al 2009, Pols et al. 2012. See also CEMP_cfe_minimum, EMP_logg_maximum, EMP_minimum_age. Default 1.0. : (null)\n",
+      "thick_disc_start_age : Lookback time for the start of the thick disc star formation, e.g. 13e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_end_age : Lookback time for the end of the thick disc star formation, e.g. 4e3 Myr. Units = Myr. : (null)\n",
+      "thick_disc_logg_min : Minimum logg for thick disc giants to be logged. : (null)\n",
+      "thick_disc_logg_max : Maximum logg for thick disc giants to be logged. : (null)\n",
+      "escape_velocity : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 1e9 km/s. See also escape_fraction. : (null)\n",
+      "escape_fraction : A parameter used in constructing galactic chemical evolution (GCE) models. If the stellar wind velocity exceeds this value, any chemical yield from the wind is ignored, i.e. assumed lost. (km/s) Requires NUCSYN_GCE_OUTFLOW_CHECKS. Default 0.0. See also escape_velocity. : (null)\n",
+      "colour_log : If set to True, thelog is coloured with ANSI colour formatting. Requires FILE_LOG to be defined. : \n",
+      "log_filename : Location of the output logging filename. If set to \"/dev/null\" then there is no logging. : \n",
+      "stopfile : File which, when it exists, will stop the current binary_c repeat run. : \n",
+      "stardata_dump_filename : Location of the stardata dump file. : \n",
+      "stardata_load_filename : Location of the stardata file to load. : \n",
+      "api_log_filename_prefix : Location of the output logging filename prefix for the API. If set to \"/dev/null\" then there is no logging. : 0\n",
+      "hrdiag_output : Set to True to output high time-resolution Hertzstrpung-Russell diagram information. Requires HRDIAG. : (null)\n",
+      "internal_buffering : Experimental. Set to non-zero values to implement internal buffering prior to output. For use with binary_grid, you shouldn't really be playing with this. : (null)\n",
+      "eccentric_RLOF_model : Chooses which model is used to handle eccentric RLOF. Default is RLOF_ECCENTRIC_AS_CIRCULAR, i.e. ignore the eccentricity. Note: requires force_corotation_of_primary_and_orbit to be FALSE.\n",
+      " : (null)\n",
+      "force_circularization_on_RLOF : If True forces circularization of stars and orbit when RLOF starts, this is as in the BSE algorithm. (True) : (null)\n",
+      "wtts_log : If True, enables log file output for WTTS2. : (null)\n",
+      "fabian_imf_log_time : Time at which to output for Fabian Schneider's IMF project. Requires FABIAN_IMF_LOG : Ignore\n",
+      "fabian_imf_log_timestep : Timestep for Fabian Schneider's IMF project logging. Requires FABIAN_IMF_LOG : Ignore\n",
+      "version : Display binary_c version and build information. Also performs timing tests. : Ignore\n",
+      "dumpversion : Display binary_c version number (short format). : Ignore\n",
+      "version_only : Display binary_c version number and build information, but do not perform timing tests or anything that requires stardata to be non-NULL. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Input\n",
+      "############################################################\n",
+      "MINT_dir : Location of MINT algorithm data. : \n",
+      "MINT_data_cleanup : Activate checks on incoming data to try to account for problems. Will make data-loading slower, but may fix a few things. : \n",
+      "MINT_MS_rejuvenation : Turn on or off (hydrogen) main-sequence rejuvenation. : \n",
+      "MINT_remesh : Turn on or off MINT's remeshing. : \n",
+      "MINT_use_ZAMS_profiles : Use chemical profiles at the ZAMS if MINT_use_ZAMS_profiles is TRUE, otherwise set homogeneous abundances. (Default is TRUE, so we use the profiles if they are available.) : \n",
+      "MINT_disable_grid_load_warnings : Use this to explicitly disable MINT's warnings when loading a grid with, e.g., missing or too much data. : \n",
+      "MINT_Kippenhahn : Turn on or off MINT's Kippenhahn diagrams. If 0, off, if 1, output star 1 (index 0), if 2 output star 2 (index 1). Default 0. : \n",
+      "MINT_Kippenhahn_stellar_type : Stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for which Kippenhahn plot data should be output. : \n",
+      "MINT_Kippenhahn_companion_stellar_type : Companion stellar type selector for Kippenhahn plots. Set to -1 to ignore, otherwise the stellar type number for the companion for which Kippenhahn plot data should be output. : \n",
+      "MINT_nuclear_burning : Turn on or off MINT's nuclear burning algorithm. : \n",
+      "MINT_minimum_shell_mass : Minimum shell mass in MINT's nuclear burning routines. : \n",
+      "MINT_maximum_shell_mass : Maximum shell mass in MINT's nuclear burning routines. : \n",
+      "\n",
+      "############################################################\n",
+      "##### Section I/O\n",
+      "############################################################\n",
+      "go : batchmode control command : Ignore\n",
+      "gogo : batchmode control command : Ignore\n",
+      "reset_stars : Reset the star structures. Used in batchmode : Ignore\n",
+      "reset_stars_defaults : Reset the star structures and set defaults. Used in batchmode : Ignore\n",
+      "defaults : Reset all defaults. Used in batchmode : Ignore\n",
+      "echo : Activate batchmode command echoing, i.e. when you enter a command, binary_c repeats the command then executes it. : Ignore\n",
+      "noecho : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "noechonow : Deactivate batchmode command echoing. See 'echo'. : Ignore\n",
+      "bye : Quit binary_c. Used in batchmode. : Ignore\n",
+      "fin : batchmode control command : Ignore\n",
+      "reset_prefs : Reset preferences struct. Used in batchmode : Ignore\n",
+      "status : Output batchmode status information. : Ignore\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Algorithms\n",
+      "############################################################\n",
+      "repeat : If > 1, repeats the system as many times as required. Handy if you're using Monte-Carlo kicks and want to sample the parameter space well. Also, if you are running speed tests this is good to give a statistically more reasonable result. (See e.g. 'tbse pgo'). : (null)\n",
+      "random_systems : Experimental. Use this to apply random initial system parameters (masses, separations, etc.). Useful for testing only. : (null)\n",
+      "\n",
+      "############################################################\n",
+      "##### Section Misc\n",
+      "############################################################\n",
+      "random_seed : Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "random_systems_seed : Random number seed for the generation of random systems. See random_systems and random_seed. : (null)\n",
+      "random_skip : Skip the first <random_seed> random numbers that are generated. Usually this is 0 so they are all used. : (null)\n",
+      "idum : [NB: deprecated, please use 'random_seed' instead.] Random number seed, usually a (possibly negative) integer. Useful for exactly reproducing the evolution of a system which involves a kick (which is a Monte-Carlo, i.e. pseudorandom, process). : (null)\n",
+      "reverse_time : Make time go backwards. To be considered very experimental! : (null)\n",
+      "start_time : Start time for the simulation. : (null)\n",
+      "warmup_cpu : Uses the CPU at maximum power the given number of seconds, prior to running normal stellar evolution. : Ignore\n",
+      "help : Display help pages. Usage: --help <help topic>. : Ignore\n",
+      "argopts : Display argument options. Usage: --argopts <argument>. : Ignore\n",
+      "help_all : Display all help pages. : Ignore\n",
+      "list_args : Display list of arguments with their default values. Useful for batchmode. : Ignore\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(_binary_c_bindings.return_help_all())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bfec32cf-7240-4a82-ac30-b3d99a018a28",
+   "metadata": {},
+   "source": [
+    "We can get all the parameter names and their default values with return_arglines(): (abridged output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "3d29ca9d-ac66-4f9e-81cf-2edd14a98b79",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "__ARG_BEGIN\n",
+      "metallicity = 0.02\n",
+      "effective_metallicity = -1\n",
+      "M_1 = 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print('\\n'.join(_binary_c_bindings.return_arglines().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e8b1c8b6-a878-43f4-bc36-1b20b3e66c6f",
+   "metadata": {},
+   "source": [
+    "Lastly, we can ask binary_c to determine the minimum period or maximum mass for RLOF at the ZAMS: Both of them need an argstring as input"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "e517f561-09c6-419d-ba89-d9cb61e6ebab",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MINIMUM SEPARATION 0.31\n",
+      "MINIMUM PERIOD 0.00632092\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=10,\n",
+    "    orbital_period=4500,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_minimum_orbit_for_RLOF(argstring, store_capsule=store_memaddr)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 46,
+   "id": "7da75a95-8831-4346-a584-e042ced75249",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MAXIMUM MASS RATIO 0.0141\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=5,\n",
+    "    M_2=1,\n",
+    "    orbital_period=0.0001,\n",
+    "    eccentricity=0.0,\n",
+    "    metallicity=0.02,\n",
+    "    max_evolution_time=15000,\n",
+    ").strip()\n",
+    "\n",
+    "#\n",
+    "output = _binary_c_bindings.return_maximum_mass_ratio_for_RLOF(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5fe52d8e-1721-4796-a856-002cf4525d96",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/source/notebook_custom_logging.ipynb b/docs/source/notebook_custom_logging.ipynb
new file mode 100644
index 000000000..e84895375
--- /dev/null
+++ b/docs/source/notebook_custom_logging.ipynb
@@ -0,0 +1,517 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "879b596b-d70c-4f90-b668-563b4ad93ffc",
+   "metadata": {},
+   "source": [
+    "# Notebook custom logging\n",
+    "In this notebook you'll learn how to use the custom logging functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "696ecbb9-1efd-48f4-a57e-2cf6dfe416f1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython import _binary_c_bindings\n",
+    "from binarycpython.utils.custom_logging_functions import (\n",
+    "    autogen_C_logging_code,\n",
+    "    binary_c_log_code,\n",
+    "    create_and_load_logging_function,\n",
+    ")\n",
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "from binarycpython.utils.grid import Population"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d4d721cc-df4f-4ac2-b6f9-62e85ca0c1e5",
+   "metadata": {},
+   "source": [
+    "The custom logging functionality allows us to decide the output of binary_c _without_ modifying the actual sourcecode of binary_c (i.e. editing `src/logging/log_every_timestep` in binary_c). Rather, we can create a logging routine from within python.\n",
+    "\n",
+    "Technically, the following steps are taken:\n",
+    "- User creates a logging print statement from within python\n",
+    "- The logging print statement string gets wrapped into a proper c-function by `binary_c_log_code`\n",
+    "- The c-function string gets compiled and loaded into memory by `create_and_load_logging_function`\n",
+    "- The memory adress of the compiled and loaded print function can now be passed to C\n",
+    "- binary_c uses the custom print function \n",
+    "\n",
+    "The custom logging functionality can be used when running systems via `run_system()`, via `Population.evolve()` and `Population.evolve_single()`, and directly via the API\n",
+    "\n",
+    "Within the logging statement we can access information from the stardata object, as well as use logical statements to determine when to log information. What we cannot do, however, is access functions that are not _publicly available_. For very elaborate printing routines it is still advised to actually hardcode the print statement into binary_c itself."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "be137151-bb57-43d7-bab1-0167512ac727",
+   "metadata": {},
+   "source": [
+    "## Usage"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac4e5f4c-81e6-4980-b852-aca84ca74f4c",
+   "metadata": {},
+   "source": [
+    "There are two methods to create the C-code that will be compiled:\n",
+    "- Automatically generate the print statement and use the wrapper to generate the full function string, by using `autogen_C_logging_code`\n",
+    "- Create your custom print statement and use the wrapper to generate the full function string, by writing out the print statement. Here the logging statement obviously has to be valid C code"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "236cf821-09ac-4237-9b8f-6e36d2edf446",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA %g %g\\n\",((double)stardata->model.time),((double)stardata->star[0].mass));\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines. Here you can choose whatever you want to have logged, and with what header\n",
+    "# this generates working print statements\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "feb423d5-5cc3-433c-9801-f8017abbc03a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# You can also decide to `write` your own logging_line, which allows you to write a more complex logging statement with conditionals.\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "print(logging_line)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "2f5defbf-c623-49ed-a238-fba52a563a58",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "#pragma push_macro(\"Max\")\n",
+      "#pragma push_macro(\"Min\")\n",
+      "#undef Max\n",
+      "#undef Min\n",
+      "#include \"binary_c.h\"\n",
+      "\n",
+      "// add visibility __attribute__ ((visibility (\"default\"))) to it \n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata);\n",
+      "void binary_c_API_function custom_output_function(struct stardata_t * stardata)\n",
+      "{\n",
+      "    // struct stardata_t * stardata = (struct stardata_t *)x;\n",
+      "    Printf(\"MY_STELLAR_DATA time=%g mass=%g\\n\", stardata->model.time, stardata->star[0].mass);\n",
+      "}\n",
+      "\n",
+      "#undef Max \n",
+      "#undef Min\n",
+      "#pragma pop_macro(\"Min\")\n",
+      "#pragma pop_macro(\"Max\")    \n"
+     ]
+    }
+   ],
+   "source": [
+    "# Generate the entire 'script' by wrapping the logging line\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "print(custom_logging_code)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "efa7f1e9-247e-4196-a883-bcff05265d02",
+   "metadata": {},
+   "source": [
+    "Combining the above with e.g. run_system() (see notebook_individual_systems for more examples):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "dcd74bbc-478b-43e4-b495-8c456e8d1d88",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=0 mass=2\n",
+      "MY_STELLAR_DATA time=1e-06 mass=2\n",
+      "MY_STELLAR_DATA time=2e-06 mass=2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# logging statement\n",
+    "logging_line = 'Printf(\"MY_STELLAR_DATA time=%g mass=%g\\\\n\", stardata->model.time, stardata->star[0].mass)'\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=2, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1998ee8f-8c0a-462b-b1e0-54f5963902cc",
+   "metadata": {},
+   "source": [
+    "### Using custom logging with the population object\n",
+    "Custom logging can be used for a whole population by setting the print statement (so not the entire logging script) in `C_logging_code`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "77bd09b0-1a94-499d-97db-a1f991c67c12",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_ABOVE_MS             1.041660877905e+02 4.99198 4.99198 6.1357 6.1357 2 1\n",
+      "EXAMPLE_ABOVE_MS             1.041662558619e+02 4.99198 4.99198 6.14057 6.1357 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662560111e+02 4.99198 4.99198 6.14057 6.14057 2 2\n",
+      "EXAMPLE_ABOVE_MS             1.041662564579e+02 4.99198 4.99198 6.14059 6.14057 2 2\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Set up population\n",
+    "pop = Population()\n",
+    "\n",
+    "# Set some BSE parameters\n",
+    "pop.set(\n",
+    "    M_1=5\n",
+    ")\n",
+    "\n",
+    "# Example logging that prints only if the star is post main-sequence\n",
+    "example_logging_string_post_MS = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>MS)\n",
+    "{\n",
+    "    Printf(\"EXAMPLE_ABOVE_MS %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "        // \n",
+    "        stardata->model.time, // 1\n",
+    "\n",
+    "        stardata->star[0].mass, //2\n",
+    "        stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "        stardata->star[0].radius, //4\n",
+    "        stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "        stardata->star[0].stellar_type, //6\n",
+    "        stardata->previous_stardata->star[0].stellar_type //7\n",
+    "  );\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Set the logging\n",
+    "pop.set(\n",
+    "    C_logging_code=example_logging_string_post_MS\n",
+    ")\n",
+    "out = pop.evolve_single()\n",
+    "\n",
+    "# Print (abridged) output\n",
+    "print('\\n'.join(out.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93397ff3-9b71-470d-8bc4-08fe5b1a5dca",
+   "metadata": {},
+   "source": [
+    "### Using custom logging when running directly from the API\n",
+    "When running a system directly with the API we need to manually load the custom logging into memory (via `create_and_load_logging_function`) and pass the memory address to the binary_c binding via `_binary_c_bindings.run_system(argstring, custom_logging_func_memaddr=custom_logging_memaddr)`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "id": "30142286-34ce-433e-82c8-565e2160ff5b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 0 15\n",
+      "MY_STELLAR_DATA 1e-06 15\n",
+      "MY_STELLAR_DATA 2e-06 15\n"
+     ]
+    }
+   ],
+   "source": [
+    "# generate logging lines\n",
+    "logging_line = autogen_C_logging_code(\n",
+    "    {\n",
+    "        \"MY_STELLAR_DATA\": [\"model.time\", \"star[0].mass\"],\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "# Generate code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(logging_line)\n",
+    "\n",
+    "# Generate library and get memaddr\n",
+    "custom_logging_memaddr, shared_lib_filename = create_and_load_logging_function(\n",
+    "    custom_logging_code\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "m1 = 15.0  # Msun\n",
+    "m2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000\n",
+    "argstring = \"binary_c M_1 {0:g} M_2 {1:g} separation {2:g} orbital_period {3:g} eccentricity {4:g} metallicity {5:g} max_evolution_time {6:g}\".format(\n",
+    "    m1,\n",
+    "    m2,\n",
+    "    separation,\n",
+    "    orbital_period,\n",
+    "    eccentricity,\n",
+    "    metallicity,\n",
+    "    max_evolution_time,\n",
+    ")\n",
+    "output = _binary_c_bindings.run_system(\n",
+    "    argstring, custom_logging_func_memaddr=custom_logging_memaddr\n",
+    ")\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print('\\n'.join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39c76b1d-d968-4eef-b5ae-2542ed9557c3",
+   "metadata": {},
+   "source": [
+    "## Examples of logging strings\n",
+    "Below are some examples of logging strings"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2ac4af72-6dab-4cc9-986e-5b5b1fa31b73",
+   "metadata": {},
+   "source": [
+    "### Compact object\n",
+    "This logging will print the timestep when the star becomes a compact object. After it does, we change the maximum time to be the current time, effectively terminating the evolution"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "id": "6f0edc65-a788-4706-a0c5-2ace030765ec",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "EXAMPLE_LOG_CO             2.773581245005e+01 1.33524 9.19314 1.72498e-05 730.446 13 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "if(stardata->star[0].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_LOG_CO %30.12e %g %g %g %g %d %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->previous_stardata->star[0].mass, //3\n",
+    "\n",
+    "            stardata->star[0].radius, //4\n",
+    "            stardata->previous_stardata->star[0].radius, //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type //7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=10, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "51c51592-6406-43bd-a879-10ace64aaf28",
+   "metadata": {},
+   "source": [
+    "### Logging mass evolution and the supernova\n",
+    "This logging code prints the mass evolution and the moment the star goes supernova"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 47,
+   "id": "8f58fdf9-3e76-4c18-a1c5-eed0980d4133",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "EXAMPLE_MASSLOSS             9.878236827680e+00 1.61349 8.38063 20 13 1\n",
+      "EXAMPLE_SN             9.878236827680e+00 1.61349 8.38063 20 12 13 5 1 6.74037 4.92267 6.74037 0 0\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_logging_string_CO = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d %g\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type, //5\n",
+    "    stardata->model.probability //6\n",
+    ");\n",
+    "if(stardata->star[0].SN_type != SN_NONE)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        if(stardata->pre_events_stardata != NULL)\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->pre_events_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->pre_events_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[ID_core(stardata->pre_events_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->pre_events_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "        else\n",
+    "        {\n",
+    "            Printf(\"EXAMPLE_SN %30.12e \" // 1\n",
+    "                \"%g %g %g %d \" // 2-5\n",
+    "                \"%d %d %g %g \" // 6-9\n",
+    "                \"%g %g %g %g\\\\n\", // 10-13\n",
+    "\n",
+    "                // \n",
+    "                stardata->model.time, // 1\n",
+    "\n",
+    "                stardata->star[0].mass, //2\n",
+    "                stardata->previous_stardata->star[0].mass, //3\n",
+    "                stardata->common.zero_age.mass[0], //4\n",
+    "                stardata->star[0].SN_type, //5\n",
+    "\n",
+    "                stardata->star[0].stellar_type, //6\n",
+    "                stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "                stardata->model.probability, //8\n",
+    "                stardata->previous_stardata->star[0].core_mass[ID_core(stardata->previous_stardata->star[0].stellar_type)],           // 9\n",
+    "\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_CO],     // 10\n",
+    "                stardata->previous_stardata->star[0].core_mass[CORE_He],    // 11\n",
+    "                stardata->star[0].fallback, // 12\n",
+    "                stardata->star[0].fallback_mass // 13\n",
+    "            );\n",
+    "        }\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "# Entire script\n",
+    "custom_logging_code = binary_c_log_code(example_logging_string_CO)\n",
+    "\n",
+    "# Run system\n",
+    "output = run_system(M_1=20, custom_logging_code=custom_logging_code)\n",
+    "\n",
+    "# print (abridged) output\n",
+    "print(\"\\n\".join(output.splitlines()[-2:]))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/source/notebook_extra_features.ipynb b/docs/source/notebook_extra_features.ipynb
new file mode 100644
index 000000000..d453a6f5b
--- /dev/null
+++ b/docs/source/notebook_extra_features.ipynb
@@ -0,0 +1,44 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d5c04b77-f0be-4b33-8c03-c72eb846527c",
+   "metadata": {},
+   "source": [
+    "# Extra features and functionality of binarycpython\n",
+    "In this notebook we'll go over some of the extra features and functionality that was not covered in the other notebooks.\n",
+    "\n",
+    "TODO"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0020f1bc-2a23-455c-8216-9e63e6e038ae",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/source/notebook_individual_systems.ipynb b/docs/source/notebook_individual_systems.ipynb
new file mode 100644
index 000000000..19c2d29fb
--- /dev/null
+++ b/docs/source/notebook_individual_systems.ipynb
@@ -0,0 +1,563 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "a544d28c-c2e1-4c6a-b55b-8caec440743f",
+   "metadata": {},
+   "source": [
+    "# Running individual systems with binarycpython\n",
+    "This notebook will show you how to run single systems and analyze their results.\n",
+    "\n",
+    "It can be useful to have some functions to quickly run a single system to e.g. inspect what evolutionary steps a specific system goes through, to plot the mass loss evolution of a single star, etc. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dd5d9ec7-5791-45f1-afbd-225947e2a583",
+   "metadata": {},
+   "source": [
+    "## Single system with run_wrapper\n",
+    "The simplest method to run a single system is to use the run_system wrapper. This function deals with setting up the argument string, makes sure all the required parameters are included and handles setting and cleaning up the custom logging functionality (see notebook_custom_logging).\n",
+    "\n",
+    "As arguments to this function we can add any of the parameters that binary_c itself actually knows, as well as:\n",
+    "- custom_logging_code: string containing a print statement that binary_c can use to print information\n",
+    "- log_filename: path of the logfile that binary_c generates\n",
+    "- parse_function: function that handles parsing the output of binary-c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "425efed3-d8e3-432d-829e-41d8ebe05162",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.run_system_wrapper import run_system\n",
+    "# help(run_system) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "b2abab48-433d-4936-8434-14804c52c9f6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 1 12462\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f127a5e4-dc01-4472-9130-8a943c92e8a7",
+   "metadata": {},
+   "source": [
+    "Lets try adding a log filename now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "029fc3f2-f09a-49af-a32b-248505738f2e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "      TIME      M1       M2   K1  K2           SEP   ECC  R1/ROL1 R2/ROL2  TYPE RANDOM_SEED=67365 RANDOM_COUNT=0\n",
+      "     0.0000    1.000    0.000  1  15            -1 -1.00   0.000   0.000  \"INITIAL \"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"OFF_MS\"\n",
+      " 11003.1302    1.000    0.000  2  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 11582.2424    1.000    0.000  3  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12325.1085    0.817    0.000  4  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12457.1300    0.783    0.000  5  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 12460.8955    0.774    0.000  6  15            -1 -1.00   0.000   0.000  \"shrinkAGB\"\n",
+      " 12461.9514    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"TYPE_CHNGE\"\n",
+      " 15000.0000    0.523    0.000 11  15            -1 -1.00   0.000   0.000  \"MAX_TIME\"\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "output = run_system(M_1=1, log_filename='/tmp/test_logfile.txt')\n",
+    "with open('/tmp/test_logfile.txt', 'r') as f:\n",
+    "    print(f.read())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "606670f2-3e0a-43c7-a885-006b92fac9d2",
+   "metadata": {},
+   "source": [
+    "To get more useful output we can include a custom_logging snippet (see notebook_custom_logging):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "e6a23b55-ca42-440d-83ac-e76a24a83a67",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 1 1 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 1 1 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 1 1 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "from binarycpython.utils.custom_logging_functions import binary_c_log_code\n",
+    "\n",
+    "# Create the print statement\n",
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"\n",
+    "\n",
+    "# Generate entire shared lib code around logging lines\n",
+    "custom_logging_code = binary_c_log_code(custom_logging_print_statement)\n",
+    "\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code)\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4c885143-db79-4fed-b4c4-0bd846e24f7d",
+   "metadata": {},
+   "source": [
+    "Now we have some actual output, it is time to create a parse_function which parses the output. Adding a parse_function to the run_system will make run_system run the output of binary_c through the parse_function."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "3822721f-217a-495b-962e-d57137b9e290",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 1.0, 1.0, 1.0], [0.0, 1.0, 1.0, 1.0]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "def parse_function(output):\n",
+    "    \"\"\"\n",
+    "    Example function to parse the output of binary_c\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    return value_lines\n",
+    "\n",
+    "# Catch output\n",
+    "output = run_system(M_1=1, custom_logging_code=custom_logging_code, parse_function=parse_function)\n",
+    "print(output[:3])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a551f07f-2eff-4425-9375-267579a581b3",
+   "metadata": {},
+   "source": [
+    "This output can now be turned into e.g. an Numpy array or Pandas dataframe (my favorite: makes querying the data very easy)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "654a07ed-2a88-46ff-9da0-b7759580f9f3",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0        time      mass initial_mass stellar_type\n",
+      "1           0         1            1            1\n",
+      "2           0         1            1            1\n",
+      "3       1e-06         1            1            1\n",
+      "4       2e-06         1            1            1\n",
+      "5       3e-06         1            1            1\n",
+      "...       ...       ...          ...          ...\n",
+      "1612  12461.8  0.577754            1            6\n",
+      "1613    12462  0.522806            1           11\n",
+      "1614    13462  0.522806            1           11\n",
+      "1615    14462  0.522806            1           11\n",
+      "1616    15000  0.522806            1           11\n",
+      "\n",
+      "[1616 rows x 4 columns]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import pandas as pd\n",
+    "\n",
+    "# Load data into dataframe\n",
+    "example_df = pd.DataFrame(output)\n",
+    "\n",
+    "# Fix column headers\n",
+    "example_df.columns = example_df.iloc[0]\n",
+    "example_df = example_df.drop(example_df.index[0])\n",
+    "\n",
+    "print(example_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "325c2ce6-f9a1-46b7-937f-84040e1252cf",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## Single system via population object\n",
+    "When setting up your population object (see notebook_population), and configuring all the parameters, it is possible to run a single system using that same configuration. It will use the parse_function if set, and running a single system is a good method to test if everything works accordingly."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "4a98ffca-1b72-4bb8-8df1-3bf3187d882f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from binarycpython.utils.grid import Population\n",
+    "# help(Population) # Uncomment to see the docstring"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7e2c2ef0-3db2-46a6-8c85-9b6cf720eb6a",
+   "metadata": {},
+   "source": [
+    "First, let's try this without any custom logging or parsing functionality"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "bff1cc2e-6b32-4ba0-879f-879ffbabd223",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "SINGLE_STAR_LIFETIME 10 27.7358\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Create the population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# Set some parameters\n",
+    "example_pop.set(\n",
+    "    verbosity=1\n",
+    ")\n",
+    "example_pop.set(\n",
+    "    M_1=10\n",
+    ")\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ae01fa35-f8b1-4a40-bfb2-b9e872cae0e7",
+   "metadata": {},
+   "source": [
+    "Now lets add some actual output with the custom logging"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "dd748bab-b57e-4129-8350-9ea11fa179d0",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\n\",\n",
+      "    // \n",
+      "    stardata->model.time, // 1\n",
+      "    stardata->star[0].mass, //2\n",
+      "    stardata->previous_stardata->star[0].mass, //3\n",
+      "    stardata->common.zero_age.mass[0], //4\n",
+      "\n",
+      "    stardata->star[0].stellar_type //5\n",
+      ");\n",
+      " to grid_options\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_eac2dfc438a14e5a9f5be98b1b6b4294.so\n",
+      "['EXAMPLE_MASSLOSS             0.000000000000e+00 10 0 10 1', 'EXAMPLE_MASSLOSS             0.000000000000e+00 10 10 10 1', 'EXAMPLE_MASSLOSS             1.000000000000e-06 10 10 10 1', 'EXAMPLE_MASSLOSS             2.000000000000e-06 10 10 10 1']\n"
+     ]
+    }
+   ],
+   "source": [
+    "custom_logging_print_statement = \"\"\"\n",
+    "Printf(\"EXAMPLE_MASSLOSS %30.12e %g %g %g %d\\\\n\",\n",
+    "    // \n",
+    "    stardata->model.time, // 1\n",
+    "    stardata->star[0].mass, //2\n",
+    "    stardata->previous_stardata->star[0].mass, //3\n",
+    "    stardata->common.zero_age.mass[0], //4\n",
+    "\n",
+    "    stardata->star[0].stellar_type //5\n",
+    ");\n",
+    "\"\"\"   \n",
+    "\n",
+    "example_pop.set(C_logging_code=custom_logging_print_statement)\n",
+    "\n",
+    "# get output and print\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output.splitlines()[:4])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "588a7d9e-9d64-4b3b-8907-656b905286e8",
+   "metadata": {},
+   "source": [
+    "Lastly we can add a parse_function to handle parsing the output again. \n",
+    "\n",
+    "Because the parse_function will now be part of the population object, it can access information of the object. We need to make a new parse function that is fit for an object: we the arguments now need to be (self, output). Returning the data is useful when running evolve_single(), but won't be used in a population evolution."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "fec39154-cce6-438c-8c2c-509d76b00f34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "import numpy as np\n",
+    "\n",
+    "def object_parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function that can be added to the population object\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # We can access object instance information now. \n",
+    "    # In this way we can store the results in a file for example. \n",
+    "    output_file = os.path.join(self.custom_options['output_dir'], 'example_output.json')\n",
+    "    \n",
+    "    # \n",
+    "    column_names = ['time', 'mass', 'initial_mass', 'stellar_type']\n",
+    "    value_lines = [column_names]\n",
+    "    \n",
+    "    # Loop over output\n",
+    "    for line in output.splitlines():\n",
+    "        \n",
+    "        # Select the lines starting with the header we chose\n",
+    "        if line.startswith(\"EXAMPLE_MASSLOSS\"):\n",
+    "        \n",
+    "        # Split the output and fetch the data\n",
+    "            split_line = line.split()\n",
+    "            values = [float(el) for el in split_line[1:]]\n",
+    "            value_lines.append(values)\n",
+    "\n",
+    "    # Turn into an array\n",
+    "    values_array = np.array(value_lines[1:])\n",
+    "    \n",
+    "    # make dict and fill\n",
+    "    output_dict = {}\n",
+    "    for i in range(len(column_names)):\n",
+    "        output_dict[column_names[i]] = list(values_array[:,i])\n",
+    "\n",
+    "    # Write to file\n",
+    "    with open(output_file, 'w') as f:\n",
+    "        f.write(json.dumps(output_dict, indent=4))\n",
+    "        \n",
+    "    # Return something anyway\n",
+    "    return value_lines"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "57347512-fd4a-434b-b13c-5e6dbd3ac415",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: parse_function=<function object_parse_function at 0x7f9265091598> to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: output_dir=/tmp/ to custom_options >>>>\n",
+      "Creating and loading custom logging functionality\n",
+      "Running binary_c M_1 10\n",
+      "Cleaning up the custom logging stuff. type: single\n",
+      "Removed /tmp/binary_c_python/custom_logging/libcustom_logging_e9c2bec7f15541eb847fc6013e48e7ed.so\n",
+      "[['time', 'mass', 'initial_mass', 'stellar_type'], [0.0, 10.0, 0.0, 10.0, 1.0], [0.0, 10.0, 10.0, 10.0, 1.0], [1e-06, 10.0, 10.0, 10.0, 1.0]]\n",
+      "dict_keys(['time', 'mass', 'initial_mass', 'stellar_type'])\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(\n",
+    "    parse_function=object_parse_function,\n",
+    "    output_dir='/tmp/'\n",
+    ")\n",
+    "output = example_pop.evolve_single()\n",
+    "print(output[:4])\n",
+    "\n",
+    "# Example of loading the data that was written\n",
+    "with open(os.path.join(example_pop.custom_options['output_dir'], 'example_output.json')) as f:\n",
+    "    written_data = json.loads(f.read())\n",
+    "\n",
+    "print(written_data.keys())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ddc06da3-fc68-4c6f-8067-14ea862b964d",
+   "metadata": {},
+   "source": [
+    "## Single system via API functionality\n",
+    "It is possible to construct your own functionality to run a single system by directly calling the API function to run a system. Under the hood all the other functions and wrappers actually use this API.\n",
+    "\n",
+    "There are less failsafes for this method, so this make sure the input is correct and binary_c knows all the arguments you pass in.\n",
+    "\n",
+    "for more details on this API function see `notebook_api_functions`"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "56886792-d379-4eac-b0d4-54508edb39c7",
+   "metadata": {},
+   "source": [
+    "First we must construct the argument string that we pass to binary_c"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "ec48125c-6bf5-48f4-9357-8261800b5d8b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "SINGLE_STAR_LIFETIME 15 14.2383\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For a binary system we need to pass in these arguments\n",
+    "M_1 = 15.0  # Msun\n",
+    "M_2 = 14.0  # Msun\n",
+    "separation = 0  # 0 = ignored, use period\n",
+    "orbital_period = 4530.0  # days\n",
+    "eccentricity = 0.0\n",
+    "metallicity = 0.02\n",
+    "max_evolution_time = 15000  # Myr. You need to include this argument.\n",
+    "\n",
+    "# Here we set up the argument string that is passed to the bindings\n",
+    "argstring = \"\"\"\n",
+    "binary_c M_1 {M_1} M_2 {M_2} separation {separation} orbital_period {orbital_period} eccentricity {eccentricity} metallicity {metallicity} max_evolution_time {max_evolution_time}\n",
+    "\"\"\".format(\n",
+    "    M_1=M_1,\n",
+    "    M_2=M_2,\n",
+    "    separation=separation,\n",
+    "    orbital_period=orbital_period,\n",
+    "    eccentricity=eccentricity,\n",
+    "    metallicity=metallicity,\n",
+    "    max_evolution_time=max_evolution_time,\n",
+    ").strip()\n",
+    "\n",
+    "from binarycpython import _binary_c_bindings\n",
+    "\n",
+    "output = _binary_c_bindings.run_system(argstring)\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "55c8ea24-0fc0-452c-8121-1e7667433479",
+   "metadata": {},
+   "source": [
+    "As we can see above, the output is rather empty. But if SINGLE_STAR_LIFETIME is printed we know we caught the output correctly. To get actual output we should have timesteps printed in the `log_every_timestep.c` in binary_c, or add some custom_logging (see notebook_custom_logging). "
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/source/notebook_population.ipynb b/docs/source/notebook_population.ipynb
index 8d2bdbf98..56f3b153c 100644
--- a/docs/source/notebook_population.ipynb
+++ b/docs/source/notebook_population.ipynb
@@ -5,44 +5,82 @@
    "id": "bbbaafbb-fd7d-4b73-a970-93506ba35d71",
    "metadata": {},
    "source": [
-    "# Title page\n"
+    "# Running populations with binarycpython\n",
+    "This notebook will show you how to evolve a population of stars\n",
+    "\n",
+    "Much of the code in the binarycpython package is written to evolve a population of stars through the Population object, rather than running a single system. Let's go through the functionality of this object step by step and set up some example populations. \n",
+    "\n",
+    "At the bottom of this notebook there are some complete example scripts"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "bf6b8673-a2b5-4b50-ad1b-e90671f57470",
    "metadata": {},
    "outputs": [],
    "source": [
     "import os\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
     "from binarycpython.utils.grid import Population\n",
-    "from binarycpython.utils.functions import (\n",
-    "    get_help_all,\n",
-    "    get_help,\n",
-    "    create_hdf5,\n",
-    "    output_lines,\n",
-    ")\n",
-    "from binarycpython.utils.custom_logging_functions import temp_dir\n"
+    "\n",
+    "# help(Population) # Uncomment to see the public functions of this object"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a081ab23-7822-4971-aa82-991548534714",
+   "metadata": {},
+   "source": [
+    "- running ensemble\n",
+    "- using M&S grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f268eff3-4e08-4f6b-8b59-f22dba4d2074",
+   "metadata": {},
+   "source": [
+    "## Setting up the Population object\n",
+    "To set up and configure the population object we need to make an object instance of the `Population` object, and add configuration via the `.set()` function.\n",
+    "\n",
+    "There are three categories of options that the Population object can set:\n",
+    "- BSE options: these options will be used for the binary_c calls, and are recognized by comparing the arguments to a known list of available arguments of binary_c. To see which options are available, see section [`binary_c parameters` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/binary_c_parameters.html). You can access these through `population.bse_options['<bse option name>']` after you have set them. \n",
+    "\n",
+    "- Grid options: these options will be used to configure the behaviour of the Population object. To see which options are available, see section [`Population grid code options` in the documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html). They can be accessed via `population.grid_options['<grid option name>']` after you have set them. \n",
+    "\n",
+    "- Custom options: these options are not recognized as either of the above, so they will be stored in the custom_options, and can be accessed via `population.custom_options['<custom option name>']`"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "79ab50b7-591f-4883-af09-116d1835a751",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: M_1=10 to BSE_options\n",
+      "adding: orbital_period=45000000080 to BSE_options\n",
+      "adding: max_evolution_time=15000 to BSE_options\n",
+      "adding: eccentricity=0.02 to BSE_options\n",
+      "adding: amt_cores=2 to grid_options\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: data_dir=/tmp/binary_c_python/example_python_population_result to custom_options >>>>\n",
+      "<<<< Warning: Key does not match previously known parameter:                     adding: base_filename=example_pop.dat to custom_options >>>>\n",
+      "1\n",
+      "example_pop.dat\n",
+      "10\n"
+     ]
+    }
+   ],
    "source": [
-    "#########################################################\n",
-    "# This file serves as an example for running a population.\n",
-    "# The use of help(<function>) is a good way to inspect what parameters are there to use\n",
-    "#########################################################\n",
-    "\n",
     "# Create population object\n",
     "example_pop = Population()\n",
     "\n",
     "# If you want verbosity, set this before other things\n",
-    "example_pop.set(verbose=1)\n",
+    "example_pop.set(verbosity=1)\n",
     "\n",
     "# Setting values can be done via .set(<parameter_name>=<value>)\n",
     "# Values that are known to be binary_c_parameters are loaded into bse_options.\n",
@@ -51,115 +89,244 @@
     "example_pop.set(\n",
     "    # binary_c physics options\n",
     "    M_1=10,  # bse_options\n",
-    "    separation=0,  # bse_options\n",
     "    orbital_period=45000000080,  # bse_options\n",
     "    max_evolution_time=15000,  # bse_options\n",
     "    eccentricity=0.02,  # bse_options\n",
-    "    # Set companion to low mass\n",
-    "    M_2=0.08,  # Since in the example we run a single system, we should set the companion mass here. If we donm't do this, the code will complain.\n",
+    "\n",
+    "\n",
     "    # grid_options\n",
     "    amt_cores=2,  # grid_options\n",
-    "    verbose=1,  # verbosity. Not fully configured correctly yet but having it value of 1 prints alot of stuff\n",
+    "    \n",
     "    # Custom options # TODO: need to be set in grid_options probably\n",
     "    data_dir=os.path.join(\n",
     "        temp_dir(), \"example_python_population_result\"\n",
     "    ),  # custom_options\n",
     "    base_filename=\"example_pop.dat\",  # custom_options\n",
-    ")"
+    ")\n",
+    "\n",
+    "# We can use the options through\n",
+    "print(example_pop.grid_options['verbosity'])\n",
+    "print(example_pop.custom_options['base_filename'])\n",
+    "print(example_pop.bse_options['M_1'])"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
+   "cell_type": "markdown",
+   "id": "f8d46d19-633d-4911-821d-a59daed31816",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "def parse_function(self, output):\n",
-    "    # EXAMPLE PARSE_FUNCTION\n",
-    "\n",
-    "    # extract info from the population instance\n",
-    "\n",
-    "    # Get some information from the\n",
-    "    data_dir = self.custom_options[\"data_dir\"]\n",
-    "    base_filename = self.custom_options[\"base_filename\"]\n",
-    "\n",
-    "    # Check directory, make if necessary\n",
-    "    os.makedirs(data_dir, exist_ok=True)\n",
-    "\n",
-    "    seperator = \" \"\n",
-    "\n",
-    "    # Create filename\n",
-    "    outfilename = os.path.join(data_dir, base_filename)\n",
-    "\n",
-    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "After configuring the population, but before running the actual population, its usually a good idea to export the full configuration (including version info of binary_c and all the parameters) to a file. To do this we use `example_pop.export_all_info()`.\n",
     "\n",
-    "    # Go over the output.\n",
-    "    for el in output_lines(output):\n",
-    "        headerline = el.split()[0]\n",
-    "\n",
-    "        # CHeck the header and act accordingly\n",
-    "        if headerline == \"MY_STELLAR_DATA\":\n",
-    "            values = el.split()[1:]\n",
-    "            print(values)\n",
-    "\n",
-    "            if not len(parameters) == len(values):\n",
-    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
-    "                raise ValueError\n",
+    "On default this exports everything, each of the sections can be disabled:\n",
+    "  - population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
+    "      settings=False\n",
+    "  - binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
+    "      turn off with include_binary_c_defaults=False\n",
+    "  - include_binary_c_version_info (all the compilation info, and information about the compiled\n",
+    "      parameters), turn off with include_binary_c_version_info=False\n",
+    "  - include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
+    "      turn off with include_binary_c_help_all=Fase\n",
+    "      \n",
+    "On default it will write this to the custom_options['data_dir'], but that can be overriden by setting use_datadir=False and providing an outfile=<>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "b9c2471a-a5b0-48b7-a50b-2f0d22100926",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Writing settings to /tmp/binary_c_python/example_python_population_result/example_pop_settings.json\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "example_pop.export_all_info()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f9a65554-36ab-4a04-96ca-9f1422c307fd",
+   "metadata": {},
+   "source": [
+    "## Adding grid variables\n",
+    "The main purpose of the Population object is to handle the population synthesis side of running a set of stars. The main method to do this with binarycpython, as is the case with Perl binarygrid, is to use grid variables. These are loops over a predefined range of values, where a probability will be assigned to the systems based on the chosen probability distributions.\n",
     "\n",
-    "            if not os.path.exists(outfilename):\n",
-    "                with open(outfilename, \"w\") as f:\n",
-    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "Usually we use either 1 mass grid variable, or a trio of mass, mass ratio and period (See below for full examples of all of these). We can, however, also add grid sampling for e.g. eccentricity, metallicity or other parameters. \n",
     "\n",
-    "            with open(outfilename, \"a\") as f:\n",
-    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "In some cases it could be easier to set up a for loop that sets that parameter and calls the evolve function several times, e.g. when you want to vary a prescription (usually a discrete, unweighted parameter) \n",
     "\n",
     "\n",
+    "A notable special type of grid variable is that of the Moe & di Stefano 2017 dataset (see further down in the notebook).\n",
     "\n",
-    "# Creating a parsing function\n",
-    "example_pop.set(\n",
-    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
-    ")"
+    "To add a grid variable to the population object we use `example_pop.add_grid_variable` (see next cell)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "2fa5188e-312f-4a05-aeda-0bd4c00629c8",
+   "execution_count": 4,
+   "id": "68c84521-9ae8-4020-af7a-5334173db969",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method add_grid_variable in module binarycpython.utils.grid:\n",
+      "\n",
+      "add_grid_variable(name:str, longname:str, valuerange:Union[list, str], resolution:str, spacingfunc:str, probdist:str, dphasevol:Union[str, int], parameter_name:str, gridtype:str='edge', branchpoint:int=0, precode:Union[str, NoneType]=None, condition:Union[str, NoneType]=None) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function to add grid variables to the grid_options.\n",
+      "    \n",
+      "    The execution of the grid generation will be through a nested for loop.\n",
+      "    Each of the grid variables will get create a deeper for loop.\n",
+      "    \n",
+      "    The real function that generates the numbers will get written to a new file in the TMP_DIR,\n",
+      "    and then loaded imported and evaluated.\n",
+      "    beware that if you insert some destructive piece of code, it will be executed anyway.\n",
+      "    Use at own risk.\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: Fix this complex function.\n",
+      "    \n",
+      "    Args:\n",
+      "        name:\n",
+      "            name of parameter. This is evaluated as a parameter and you can use it throughout\n",
+      "            the rest of the function\n",
+      "            \n",
+      "            Examples:\n",
+      "                name = 'lnm1'\n",
+      "        longname:\n",
+      "            Long name of parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                longname = 'Primary mass'\n",
+      "        range:\n",
+      "            Range of values to take. Does not get used really, the spacingfunction is used to\n",
+      "            get the values from\n",
+      "            \n",
+      "            Examples:\n",
+      "                range = [math.log(m_min), math.log(m_max)]\n",
+      "        resolution:\n",
+      "            Resolution of the sampled range (amount of samples).\n",
+      "            TODO: check if this is used anywhere\n",
+      "    \n",
+      "            Examples: \n",
+      "                resolution = resolution[\"M_1\"]\n",
+      "        spacingfunction:\n",
+      "            Function determining how the range is sampled. You can either use a real function,\n",
+      "            or a string representation of a function call. Will get written to a file and\n",
+      "            then evaluated.\n",
+      "    \n",
+      "            Examples:\n",
+      "                spacingfunction = \"const(math.log(m_min), math.log(m_max), {})\".format(resolution['M_1'])\n",
+      "    \n",
+      "        precode:\n",
+      "            Extra room for some code. This code will be evaluated within the loop of the\n",
+      "            sampling function (i.e. a value for lnm1 is chosen already)\n",
+      "            \n",
+      "            Examples:\n",
+      "                precode = 'M_1=math.exp(lnm1);'\n",
+      "        probdist:\n",
+      "            Function determining the probability that gets assigned to the sampled parameter\n",
+      "            \n",
+      "            Examples:\n",
+      "                probdist = 'Kroupa2001(M_1)*M_1'\n",
+      "        dphasevol:\n",
+      "            part of the parameter space that the total probability is calculated with. Put to -1\n",
+      "            if you want to ignore any dphasevol calculations and set the value to 1\n",
+      "            Examples:\n",
+      "                dphasevol = 'dlnm1'\n",
+      "        condition:\n",
+      "            condition that has to be met in order for the grid generation to continue\n",
+      "            Examples:\n",
+      "                condition = 'self.grid_options['binary']==1'\n",
+      "        gridtype:\n",
+      "            Method on how the value range is sampled. Can be either 'edge' (steps starting at\n",
+      "            the lower edge of the value range) or 'center'\n",
+      "            (steps starting at lower edge + 0.5 * stepsize).\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.add_grid_variable)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bd75cebe-2152-4025-b680-dc020b80889b",
    "metadata": {},
+   "source": [
+    "All the distribution functions that we can use are stored in the `binarycpython.utils.distribution_functions` or `binarycpython/utils/distribution_functions.py` on git. If you uncomment the help statement below you can see which functions are available now:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "048db541-3e92-4c5d-a25c-9c5a34b9c857",
+   "metadata": {
+    "scrolled": true,
+    "tags": []
+   },
    "outputs": [],
    "source": [
-    "### Custom logging\n",
-    "# Log the moment when the star turns into neutron\n",
-    "example_pop.set(\n",
-    "    C_logging_code=\"\"\"\n",
-    "if(stardata->star[0].stellar_type >= 13)    \n",
-    "{\n",
-    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
-    "    {\n",
-    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
-    "            // \n",
-    "            stardata->model.time, // 1\n",
-    "            stardata->star[0].mass, // 2\n",
-    "            stardata->common.zero_age.mass[0], // 4\n",
-    "            stardata->model.probability, // 5\n",
-    "            stardata->star[0].radius, // 6\n",
-    "            stardata->star[0].stellar_type // 7\n",
-    "      );\n",
-    "    };\n",
-    "    /* Kill the simulation to save time */\n",
-    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
-    "};\n",
-    "\"\"\"\n",
-    ")"
+    "# import binarycpython.utils.distribution_functions\n",
+    "# help(binarycpython.utils.distribution_functions)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b3a007b-5c17-42a7-a981-7e268e6f545c",
+   "metadata": {},
+   "source": [
+    "The next cell contains an example of adding the mass grid variable, but sampling in log mass. The commented grid variables are examples of the mass ratio sampling and the period sampling."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "fd197154-a8ce-4865-8929-008d3483101a",
+   "execution_count": 6,
+   "id": "47979841-2c26-4b26-8945-603d013dc93a",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added grid variable: {\n",
+      "    \"name\": \"lnm1\",\n",
+      "    \"longname\": \"Primary mass\",\n",
+      "    \"valuerange\": [\n",
+      "        2,\n",
+      "        150\n",
+      "    ],\n",
+      "    \"resolution\": \"20\",\n",
+      "    \"spacingfunc\": \"const(math.log(2), math.log(150), 20)\",\n",
+      "    \"precode\": \"M_1=math.exp(lnm1)\",\n",
+      "    \"probdist\": \"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+      "    \"dphasevol\": \"dlnm1\",\n",
+      "    \"parameter_name\": \"M_1\",\n",
+      "    \"condition\": \"\",\n",
+      "    \"gridtype\": \"edge\",\n",
+      "    \"branchpoint\": 0,\n",
+      "    \"grid_variable_number\": 0\n",
+      "}\n"
+     ]
+    }
+   ],
    "source": [
     "# Add grid variables\n",
     "resolution = {\"M_1\": 20, \"q\": 20, \"per\": 40}\n",
@@ -211,128 +378,815 @@
   },
   {
    "cell_type": "markdown",
-   "id": "8c96b151-8c3b-4479-969f-6c2f898497a5",
+   "id": "163f13ae-fec1-4ee8-b9d4-c1b75c19ff39",
    "metadata": {},
    "source": [
-    "Exporting of all the settings can be done with .export_all_info()\n",
-    "on default it exports everything, but can be supressed by turning it off:\n",
-    "  population settings (bse_options, grid_options, custom_options), turn off with include_population\n",
-    "      settings=False\n",
-    "  binary_c_defaults (all the commandline arguments that binary c accepts, and their defaults).\n",
-    "      turn off with include_binary_c_defaults=False\n",
-    "  include_binary_c_version_info (all the compilation info, and information about the compiled\n",
-    "      parameters), turn off with include_binary_c_version_info=False\n",
-    "  include_binary_c_help_all (all the help information for all the binary_c parameters),\n",
-    "      turn off with include_binary_c_help_all=Fase\n",
-    "On default it will write this to the custom_options['data_dir'], but that can be overriden by\n",
-    "  setting use_datadir=False and providing an outfile=<>"
+    "## Setting logging and handling the output\n",
+    "On default, binary_c will not output anything (except for 'SINGLE STAR LIFETIME'). It is up to us to determine what will be printed. We can either do that by hardcoding the print statements into `binary_c` (see documentation binary_c). Or, we can use the custom logging functionality of binarycpython (see notebook `notebook_custom_logging.ipynb`), which is faster to set up and requires no recompilation of binary_c, but is somewhat more limited in its functionality. \n",
+    "\n",
+    "After configuring what will be printed, we need to make a function to parse the output. This can be done by setting the parse_function parameter in the population object (see also notebook `notebook_individual_systems.ipynb`). \n",
+    "\n",
+    "In the code below we will set up both the custom logging, and a parse function to handle that output"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
-   "id": "ba83443c-64b4-4126-90b3-b1ca76c0f73d",
+   "execution_count": 7,
+   "id": "0c986215-93b1-4e30-ad79-f7c397e9ff7d",
    "metadata": {},
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "'/tmp/binary_c_python/example_python_population_result/example_pop_settings.json'"
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: C_logging_code=\n",
+      "if(stardata->star[0].stellar_type >= 13)    \n",
+      "{\n",
+      "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+      "    {\n",
+      "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\n\",\n",
+      "            // \n",
+      "            stardata->model.time, // 1\n",
+      "            stardata->star[0].mass, // 2\n",
+      "            stardata->common.zero_age.mass[0], // 3\n",
+      "            stardata->model.probability, // 4\n",
+      "            stardata->star[0].stellar_type // 5\n",
+      "      );\n",
+      "    };\n",
+      "    /* Kill the simulation to save time */\n",
+      "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+      "};\n",
+      " to grid_options\n"
+     ]
     }
    ],
    "source": [
-    "example_pop.export_all_info()"
+    "# Create custom logging statement: in this case we will log when the star turns into a compact object, and then terminate the evolution.\n",
+    "custom_logging_statement = \"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_COMPACT_OBJECT %30.12e %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 3\n",
+    "            stardata->model.probability, // 4\n",
+    "            stardata->star[0].stellar_type // 5\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    "\n",
+    "example_pop.set(\n",
+    "    C_logging_code=custom_logging_statement\n",
+    ")"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "ef5b51a1-e56d-4bec-a5c7-b9d5bceeceba",
+   "id": "ae1f1f0c-1f8b-42d8-b051-cbf8c6b51514",
    "metadata": {},
    "source": [
-    "Executing a single system\n",
-    "This uses the M_1 orbital period etc set with the set function"
+    "The parse function must now catch lines that start with \"EXAMPLE_COMPACT_OBJECT\", and write that line to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
-   "id": "c0a9aed7-1fc9-4fe3-8bcf-4e987bfc00a9",
+   "execution_count": 8,
+   "id": "fd197154-a8ce-4865-8929-008d3483101a",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating the code for the shared library for the custom logging\n",
-      "['2.773586668293e+01', '1.33526', '10', '1', '1.72498e-05', '13']\n",
-      "None\n"
+      "adding: parse_function=<function parse_function at 0x7ff3bdf79620> to grid_options\n"
      ]
     }
    ],
    "source": [
-    "output = example_pop.evolve_single()\n",
-    "print(output)"
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parse function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # get info from the population instance\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for line in output.splitlines():\n",
+    "        headerline = line.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_COMPACT_OBJECT\":\n",
+    "            values = line.split()[1:]\n",
+    "            print(line)\n",
+    "            \n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "# Add the parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,\n",
+    ")"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
-   "metadata": {
-    "tags": []
-   },
-   "outputs": [],
+   "cell_type": "markdown",
+   "id": "91509ce5-ffe7-4937-aa87-6d7baac9ac04",
+   "metadata": {},
    "source": [
-    "## Executing a population\n",
-    "## This uses the values generated by the grid_variables\n",
-    "example_pop.evolve()  # TODO: update this function call"
+    "## Evolving the grid\n",
+    "Now that we configured all the main parts of the population object, we can actually run the population! Doing this is straightforward: `example_pop.evolve()`\n",
+    "\n",
+    "This will start up the processing of all the systems. We can control how many cores are used by settings `amt_cores`. By setting the `verbosity` of the population object to a higher value we can get a lot of verbose information about the run, but for now we will set it to 0.\n",
+    "\n",
+    "There are many grid_options that can lead to different behaviour of the evolution of the grid. Please do have a look at those: [grid options docs](https://ri0005.pages.surrey.ac.uk/binary_c-python/grid_options_descriptions.html), and try  "
    ]
   },
   {
-   "cell_type": "markdown",
-   "id": "ce937b07-7292-4bb1-b2e7-d69e51bdff6e",
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "8ea376c1-1e92-45af-8cab-9d7fdca564eb",
    "metadata": {
     "tags": []
    },
-   "source": [
-    "Wrapping up the results to an hdf5 file can be done by using the create_hdf5\n",
-    "(<directory containing data and settings>) This function takes the settings file\n",
-    "(ending in _settings.json) and the data files (ending in .dat) from the data_dir\n",
-    "and packing them into an hdf5 file, which is then written into the same data_dir directory"
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "adding: verbosity=0 to grid_options\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "EXAMPLE_COMPACT_OBJECT             2.867655467480e+01 1.33079 9.81391 0.00167028 13\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "EXAMPLE_COMPACT_OBJECT             1.931266944719e+01 1.3933 12.3177 0.00124307 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.439623364590e+01 1.38004 7.81906 0.00224431 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.364277535630e+01 1.47961 15.4603 0.000925128 13\n",
+      "EXAMPLE_COMPACT_OBJECT             1.017435498578e+01 1.59052 19.4046 0.000688507 13\n",
+      "EXAMPLE_COMPACT_OBJECT             8.294870923827e+00 1.7197 24.3552 0.000512406 13\n",
+      "EXAMPLE_COMPACT_OBJECT             6.802132608769e+00 1.84162 30.5689 0.000381347 13\n",
+      "EXAMPLE_COMPACT_OBJECT             5.723570798020e+00 1.99471 38.3678 0.00028381 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.933751523833e+00 2.15875 48.1564 0.000211219 13\n",
+      "EXAMPLE_COMPACT_OBJECT             4.337250536639e+00 2.35209 60.4424 0.000157195 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.862081089332e+00 2.56776 75.8628 0.000116989 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.449960890183e+00 2.80457 95.2174 8.70668e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.172196856333e+00 3.05193 119.51 6.47976e-05 14\n",
+      "EXAMPLE_COMPACT_OBJECT             3.069627290216e+00 3.27563 150 4.82242e-05 14\n",
+      "Population-2a7732d03e594ef4b5dfe9051b41d9c0 finished! The total probability was: 0.05150046619238191. It took a total of 0.7797017097473145s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# change verbosity\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "## Executing a population\n",
+    "## This uses the values generated by the grid_variables\n",
+    "analytics = example_pop.evolve()  # TODO: update this function call"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "91ab45c7-7d31-4543-aee4-127ab58e891f",
+   "metadata": {},
+   "source": [
+    "After the run is complete, some technical report on the run is returned. I stored that in `analytics`. As we can see below, this dictionary is like a status report of the evolution. Useful for e.g. debugging."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
-   "id": "ad444138-f854-4fdb-8e18-49e35ac9c7e2",
+   "execution_count": 10,
+   "id": "e1f0464b-0424-4022-b34b-5b744bc2c59d",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Creating /tmp/binary_c_python/example_python_population_result/example_pop.hdf5\n",
-      "Adding settings to HDF5 file\n",
-      "Adding data to HDF5 file\n"
+      "{'population_name': '2a7732d03e594ef4b5dfe9051b41d9c0', 'evolution_type': 'grid', 'failed_count': 0, 'failed_prob': 0, 'failed_systems_error_codes': [], 'errors_exceeded': False, 'errors_found': False, 'total_probability': 0.05150046619238191, 'total_count': 20, 'start_timestamp': 1628444120.234709, 'end_timestamp': 1628444121.0144107, 'total_mass_run': 730.1048014407228, 'total_probability_weighted_mass_run': 0.2983275843337705, 'zero_prob_stars_skipped': 0}\n"
      ]
     }
    ],
    "source": [
-    "create_hdf5(data_dir=example_pop.custom_options[\"data_dir\"], name=\"example_pop.hdf5\")\n"
+    "print(analytics)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6460df56-9fba-4817-9a1e-593ef15d98c1",
+   "metadata": {},
+   "source": [
+    "## Noteworthy functionality\n",
+    "Some extra features that are available from via the population object are:\n",
+    "- write_binary_c_calls_to_file: Function to write the calls that would be passed to binary_c to a file"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "id": "34da69bc-fe60-4a9d-b07a-f6cd2f216964",
+   "execution_count": 11,
+   "id": "83f8e519-4f7c-474a-ad95-f175a34fae81",
    "metadata": {},
-   "outputs": [],
-   "source": []
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Help on method write_binary_c_calls_to_file in module binarycpython.utils.grid:\n",
+      "\n",
+      "write_binary_c_calls_to_file(output_dir:Union[str, NoneType]=None, output_filename:Union[str, NoneType]=None, include_defaults:bool=False) -> None method of binarycpython.utils.grid.Population instance\n",
+      "    Function that loops over the grid code and writes the generated parameters to a file.\n",
+      "    In the form of a command line call\n",
+      "    \n",
+      "    Only useful when you have a variable grid as system_generator. MC wouldn't be that useful\n",
+      "    \n",
+      "    Also, make sure that in this export there are the basic parameters\n",
+      "    like m1,m2,sep, orb-per, ecc, probability etc.\n",
+      "    \n",
+      "    On default this will write to the datadir, if it exists\n",
+      "    \n",
+      "    Tasks:\n",
+      "        - TODO: test this function\n",
+      "        - TODO: make sure the binary_c_python .. output file has a unique name\n",
+      "    \n",
+      "    Args:\n",
+      "        output_dir: (optional, default = None) directory where to write the file to. If custom_options['data_dir'] is present, then that one will be used first, and then the output_dir\n",
+      "        output_filename: (optional, default = None) filename of the output. If not set it will be called \"binary_c_calls.txt\"\n",
+      "        include_defaults: (optional, default = None) whether to include the defaults of binary_c in the lines that are written. Beware that this will result in very long lines, and it might be better to just export the binary_c defaults and keep them in a separate file.\n",
+      "    \n",
+      "    Returns:\n",
+      "        filename: filename that was used to write the calls to\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "help(example_pop.write_binary_c_calls_to_file)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "dacfed75-dfe3-4afd-a0ff-a4be17746021",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Saving grid code to grid_options\n",
+      "Writing grid code to /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Loading grid code function from /tmp/binary_c_python/binary_c_grid_2a7732d03e594ef4b5dfe9051b41d9c0.py\n",
+      "Grid code loaded\n",
+      "Writing binary_c calls to /tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "_calculate_multiplicity_fraction: Chosen not to use any multiplicity fraction.\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "/tmp/binary_c_python/example_python_population_result/binary_c_calls.txt\n",
+      "binary_c M_1 2.0 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.013208238029791246\n",
+      "binary_c M_1 2.5102526289471614 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.009829948023831718\n",
+      "binary_c M_1 3.1506841305680684 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.0073157281034221516\n",
+      "binary_c M_1 3.9545065608702976 eccentricity 0.02 max_evolution_time 15000 orbital_period 45000000080 phasevol 0.22723621650191106 probability 0.005444573822104362\n"
+     ]
+    }
+   ],
+   "source": [
+    "example_pop.set(verbosity=10)\n",
+    "calls_filename = example_pop.write_binary_c_calls_to_file()\n",
+    "print(calls_filename)\n",
+    "\n",
+    "with open(calls_filename, 'r') as f:\n",
+    "    print('\\n'.join(f.read().splitlines()[:4]))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "60359eb1-4d0c-4d2d-8265-ec5171b944a2",
+   "metadata": {},
+   "source": [
+    "## Full examples of population scripts\n",
+    "Below is a full setup for a population of single stars"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "7212b6be-9787-4122-a7f1-86538cf38179",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Grid has handled 20 stars\n",
+      "with a total probability of 0.05150046619238192\n",
+      "Total starcount for this run will be: 20\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Population-3680f3882c0a449c944462abffea2447 finished! The total probability was: 0.05150046619238191. It took a total of 0.6246354579925537s to run 20 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass zams_mass probability radius stellar_type\n",
+      "2.867655467480e+01 1.33079 9.81391 0.00167028 1.72498e-05 13\n",
+      "1.931266944719e+01 1.3933 12.3177 0.00124307 1.72498e-05 13\n",
+      "4.439623364590e+01 1.38004 7.81906 0.00224431 1.72498e-05 13\n",
+      "1.364277535630e+01 1.47961 15.4603 0.000925128 1.72498e-05 13\n",
+      "1.017435498578e+01 1.59052 19.4046 0.000688507 1.72498e-05 13\n",
+      "8.294870923827e+00 1.7197 24.3552 0.000512406 1.72498e-05 13\n",
+      "6.802132608769e+00 1.84162 30.5689 0.000381347 1.72498e-05 13\n",
+      "5.723570798020e+00 1.99471 38.3678 0.00028381 1.72498e-05 13\n",
+      "4.933751523833e+00 2.15875 48.1564 0.000211219 1.72498e-05 13\n",
+      "4.337250536639e+00 2.35209 60.4424 0.000157195 9.97286e-06 14\n",
+      "3.862081089332e+00 2.56776 75.8628 0.000116989 1.08873e-05 14\n",
+      "3.449960890183e+00 2.80457 95.2174 8.70668e-05 1.18914e-05 14\n",
+      "3.172196856333e+00 3.05193 119.51 6.47976e-05 1.29402e-05 14\n",
+      "3.069627290216e+00 3.27563 150 4.82242e-05 1.38887e-05 14\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\"time\", \"mass\", \"zams_mass\", \"probability\", \"radius\", \"stellar_type\"]\n",
+    "\n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"MY_STELLAR_DATA\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "if(stardata->star[0].stellar_type >= 13)    \n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"MY_STELLAR_DATA %30.12e %g %g %g %g %d\\\\n\",\n",
+    "            // \n",
+    "            stardata->model.time, // 1\n",
+    "            stardata->star[0].mass, // 2\n",
+    "            stardata->common.zero_age.mass[0], // 4\n",
+    "            stardata->model.probability, // 5\n",
+    "            stardata->star[0].radius, // 6\n",
+    "            stardata->star[0].stellar_type // 7\n",
+    "      );\n",
+    "    };\n",
+    "    /* Kill the simulation to save time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "};\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 20}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2ab0979-6575-481d-9c1c-ca98517b2437",
+   "metadata": {},
+   "source": [
+    "We can also set up a population that samples biinary systems, by adding extra grid variables. Below is an example of a full script that runs a binary population and registers when a double compact object is formed. The logging is rather compact and should be expanded top be more useful"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "79acdbb2-7dd6-45c4-9609-80994f03619a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Grid has handled 125 stars\n",
+      "with a total probability of 0.0862478164626921\n",
+      "Total starcount for this run will be: 125\n",
+      "Generating grid code\n",
+      "Constructing/adding: lnm1\n",
+      "Constructing/adding: q\n",
+      "Constructing/adding: log10per\n",
+      "Population-d20a4c74d20a43b881c0c9e5def5f76c finished! The total probability was: 0.08624781646269201. It took a total of 8.561265707015991s to run 125 systems on 2 cores\n",
+      "There were no errors found in this run.\n",
+      "\n",
+      "\n",
+      "time mass_1 zams_mass_1 mass_2 zams_mass_2 stellar_type_1 prev_stellar_type_1 stellar_type_2 prev_stellar_type_2 metallicity probability\n",
+      "8.863377990313e+01 1.29444 5.88566 0 2.99283 13 5 15 15 0.02 0.000627913\n",
+      "1.146421815741e+02 0 5.88566 1.33062 4.43925 15 15 13 5 0.02 0.000627913\n",
+      "7.222715508467e+01 1.34922 5.88566 0 5.88566 13 5 15 15 0.02 0.000627913\n",
+      "1.350021848285e+01 1.48488 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171108213270e+01 1.53113 17.3205 0 0.1 13 5 15 15 0.02 0.000154349\n",
+      "1.171086983243e+01 1.53177 17.3205 0 0.1 13 9 15 15 0.02 0.000154349\n",
+      "1.170770599495e+01 1.53176 17.3205 0 4.40513 13 5 15 15 0.02 0.000172877\n",
+      "1.230407246199e+01 1.59499 17.3205 0 4.40513 13 5 15 15 0.02 0.000610573\n",
+      "1.108751340926e+01 1.70319 17.3205 0 8.71025 13 4 15 15 0.02 0.000610573\n",
+      "1.941017702765e+01 1.34903 17.3205 1.65097 8.71025 13 13 13 5 0.02 0.000172877\n",
+      "1.980988739731e+01 1.36979 17.3205 1.60808 8.71025 13 13 13 5 0.02 0.000121486\n",
+      "3.571858031651e+01 1.53174 17.3205 1.30504 8.71025 13 13 13 5 0.02 8.42148e-05\n",
+      "3.459153942631e+01 1.53176 17.3205 1.31004 8.71025 13 13 13 5 0.02 9.8162e-05\n",
+      "1.687368550125e+01 1.34937 17.3205 1.73856 13.0154 13 13 13 8 0.02 0.000172877\n",
+      "1.194842917007e+01 1.78096 17.3205 0 13.0154 13 8 15 15 0.02 0.000610573\n",
+      "1.733614170983e+01 1.53184 17.3205 1.42375 13.0154 13 13 13 5 0.02 9.8162e-05\n",
+      "1.723547465714e+01 1.38403 17.3205 1.71288 13.0154 13 13 13 8 0.02 0.000121486\n",
+      "1.764340254985e+01 1.53174 17.3205 1.41264 13.0154 13 13 13 5 0.02 8.42148e-05\n",
+      "1.170425790780e+01 1.52963 17.3205 0 17.3205 13 5 15 15 0.02 0.000172877\n",
+      "8.922967341481e+00 1.85486 17.3205 0 17.3205 13 8 15 15 0.02 0.000610573\n",
+      "1.232906623449e+01 1.41074 17.3205 1.34281 17.3205 13 13 13 8 0.02 0.000121486\n",
+      "1.170775828562e+01 1.53183 17.3205 1.53183 17.3205 13 5 13 5 0.02 9.8162e-05\n",
+      "1.170770422321e+01 1.53175 17.3205 1.53175 17.3205 13 5 13 5 0.02 8.42148e-05\n",
+      "5.075844624794e+00 2.12303 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.766606588165e+00 2.20484 50.9713 0 0.1 14 8 15 15 0.02 3.79411e-05\n",
+      "4.768305081494e+00 2.18838 50.9713 0 0.1 13 8 15 15 0.02 3.79411e-05\n",
+      "4.458869865939e+00 2.29864 50.9713 0 12.8178 14 8 15 15 0.02 0.000150087\n",
+      "1.806014211040e+01 2.10446 50.9713 1.40749 12.8178 13 13 13 5 0.02 2.9863e-05\n",
+      "4.797342083485e+00 2.10328 50.9713 0 12.8178 13 13 15 1 0.02 4.24954e-05\n",
+      "1.721374713429e+01 2.21673 50.9713 1.42212 12.8178 14 14 13 5 0.02 2.41295e-05\n",
+      "4.055645404546e+00 2.47276 50.9713 0 25.5357 14 7 15 15 0.02 0.000150087\n",
+      "1.806123543037e+01 2.21893 50.9713 1.40745 12.8178 14 14 13 5 0.02 2.07011e-05\n",
+      "8.117519147635e+00 2.10433 50.9713 2.21473 25.5357 13 13 14 8 0.02 4.24954e-05\n",
+      "8.315554923168e+00 2.15343 50.9713 2.08519 25.5357 13 13 13 8 0.02 2.9863e-05\n",
+      "7.917420996633e+00 2.21892 50.9713 1.7431 25.5357 14 14 13 8 0.02 2.07011e-05\n",
+      "7.693213405973e+00 2.21805 50.9713 1.78384 25.5357 14 14 13 8 0.02 2.41295e-05\n",
+      "3.753837732894e+00 2.62517 50.9713 0 38.2535 14 7 15 15 0.02 0.000150087\n",
+      "7.087296558990e+00 2.10417 50.9713 2.40935 38.2535 13 13 14 8 0.02 4.24954e-05\n",
+      "7.007109286263e+00 2.15854 50.9713 2.28672 38.2535 13 13 14 8 0.02 2.9863e-05\n",
+      "5.653200958306e+00 2.21878 50.9713 2.0587 38.2535 14 14 13 8 0.02 2.41295e-05\n",
+      "5.733794947644e+00 2.21892 50.9713 1.99255 38.2535 14 14 13 8 0.02 2.07011e-05\n",
+      "3.513216011269e+00 2.76647 50.9713 0 50.9713 14 7 15 15 0.02 0.000150087\n",
+      "4.750574783854e+00 2.27442 50.9713 0 50.9713 14 8 15 15 0.02 4.24954e-05\n",
+      "7.278384712062e+00 1.29678 50.9713 2.09216 50.9713 13 8 13 13 0.02 2.9863e-05\n",
+      "4.765996194699e+00 2.20787 50.9713 2.20787 50.9713 14 8 14 8 0.02 2.07011e-05\n",
+      "4.765535914728e+00 2.21331 50.9713 2.21331 50.9713 14 8 14 8 0.02 2.41295e-05\n",
+      "3.104706358826e+00 3.17639 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.069363482023e+00 3.27572 150 0 0.1 14 7 15 15 0.02 9.32641e-06\n",
+      "3.047074050271e+00 3.3836 150 0 37.575 14 7 15 15 0.02 3.68933e-05\n",
+      "5.974759306305e+00 3.23604 150 2.53922 37.575 14 14 14 7 0.02 1.04459e-05\n",
+      "6.074084349384e+00 3.30145 150 2.13876 37.575 14 14 13 8 0.02 7.34071e-06\n",
+      "5.733865371895e+00 3.29994 150 2.00498 37.575 14 14 13 8 0.02 5.93135e-06\n",
+      "3.027099358410e+00 3.53631 150 0 75.05 14 7 15 15 0.02 3.68933e-05\n",
+      "5.807147339697e+00 3.30197 150 1.9791 37.575 14 14 13 8 0.02 5.08861e-06\n",
+      "4.862942347290e+00 3.25294 150 2.97823 75.05 14 14 14 7 0.02 1.04459e-05\n",
+      "4.556479830908e+00 3.29942 150 2.73221 75.05 14 14 14 7 0.02 7.34071e-06\n",
+      "3.853070305680e+00 3.29977 150 2.62486 75.05 14 14 14 7 0.02 5.93135e-06\n",
+      "3.881529045940e+00 3.30149 150 2.55924 75.05 14 14 14 7 0.02 5.08861e-06\n",
+      "3.015033359333e+00 3.64419 150 0 112.525 14 7 15 15 0.02 3.68933e-05\n",
+      "4.126828648362e+00 3.32047 150 0 112.525 14 14 15 3 0.02 1.04459e-05\n",
+      "3.990017992944e+00 3.3032 150 2.94027 112.525 14 14 14 7 0.02 7.34071e-06\n",
+      "3.206771867883e+00 3.07671 150 3.11282 112.525 14 14 14 7 0.02 5.93135e-06\n",
+      "3.006827156705e+00 3.72638 150 0 150 14 7 15 15 0.02 3.68933e-05\n",
+      "3.218786094847e+00 3.30337 150 3.01344 112.525 14 14 14 7 0.02 5.08861e-06\n",
+      "4.527722847382e+00 1.42238 150 0 150 13 5 15 15 0.02 1.04459e-05\n",
+      "3.069567332611e+00 3.27804 150 3.27804 150 14 7 14 7 0.02 5.93135e-06\n",
+      "5.726405299909e+00 1.29746 150 3.22759 150 13 8 14 14 0.02 7.34071e-06\n",
+      "3.069626478211e+00 3.27565 150 3.27565 150 14 7 14 7 0.02 5.08861e-06\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "from binarycpython.utils.grid import Population\n",
+    "from binarycpython.utils.custom_logging_functions import temp_dir\n",
+    "\n",
+    "def parse_function(self, output):\n",
+    "    \"\"\"\n",
+    "    Example parsing function\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    # extract info from the population instance\n",
+    "\n",
+    "    # Get some information from the\n",
+    "    data_dir = self.custom_options[\"data_dir\"]\n",
+    "    base_filename = self.custom_options[\"base_filename\"]\n",
+    "\n",
+    "    # Check directory, make if necessary\n",
+    "    os.makedirs(data_dir, exist_ok=True)\n",
+    "\n",
+    "    #\n",
+    "    seperator = \" \"\n",
+    "\n",
+    "    # Create filename\n",
+    "    outfilename = os.path.join(data_dir, base_filename)\n",
+    "\n",
+    "    # The header columns matching this \n",
+    "    parameters = [\n",
+    "        \"time\", \n",
+    "        \"mass_1\", \"zams_mass_1\", \"mass_2\", \"zams_mass_2\",\n",
+    "        \"stellar_type_1\", \"prev_stellar_type_1\", \"stellar_type_2\", \"prev_stellar_type_2\", \n",
+    "        \"metallicity\", \"probability\"\n",
+    "    ]\n",
+    "    \n",
+    "    # Go over the output.\n",
+    "    for el in output.splitlines():\n",
+    "        headerline = el.split()[0]\n",
+    "\n",
+    "        # CHeck the header and act accordingly\n",
+    "        if headerline == \"EXAMPLE_DCO\":\n",
+    "            values = el.split()[1:]\n",
+    "\n",
+    "            if not len(parameters) == len(values):\n",
+    "                print(\"Amount of column names isnt equal to amount of columns\")\n",
+    "                raise ValueError\n",
+    "\n",
+    "            if not os.path.exists(outfilename):\n",
+    "                with open(outfilename, \"w\") as f:\n",
+    "                    f.write(seperator.join(parameters) + \"\\n\")\n",
+    "\n",
+    "            with open(outfilename, \"a\") as f:\n",
+    "                f.write(seperator.join(values) + \"\\n\")\n",
+    "\n",
+    "\n",
+    "# Create population object\n",
+    "example_pop = Population()\n",
+    "\n",
+    "# If you want verbosity, set this before other things\n",
+    "example_pop.set(verbosity=0)\n",
+    "\n",
+    "# Setting values can be done via .set(<parameter_name>=<value>)\n",
+    "example_pop.set(\n",
+    "    # binary_c physics options\n",
+    "    M_1=10,  # bse_options\n",
+    "    separation=0,  # bse_options\n",
+    "    orbital_period=45000000080,  # bse_options\n",
+    "    max_evolution_time=15000,  # bse_options\n",
+    "    eccentricity=0.02,  # bse_options\n",
+    "    \n",
+    "    # grid_options\n",
+    "    amt_cores=2,  # grid_options\n",
+    "\n",
+    "    # Custom options: the data directory and the output filename\n",
+    "    data_dir=os.path.join(\n",
+    "        temp_dir(), \"example_python_population_result\"\n",
+    "    ),  # custom_options\n",
+    "    base_filename=\"example_pop.dat\",  # custom_options\n",
+    ")\n",
+    "\n",
+    "# Creating a parsing function\n",
+    "example_pop.set(\n",
+    "    parse_function=parse_function,  # Setting the parse function thats used in the evolve_population\n",
+    ")\n",
+    "\n",
+    "### Custom logging\n",
+    "# Log the moment when the star turns into neutron\n",
+    "example_pop.set(\n",
+    "    C_logging_code=\"\"\"\n",
+    "// logger to find gravitational wave progenitors\n",
+    "if(stardata->star[0].stellar_type>=NS && stardata->star[1].stellar_type>=NS)\n",
+    "{\n",
+    "    if (stardata->model.time < stardata->model.max_evolution_time)\n",
+    "    {\n",
+    "        Printf(\"EXAMPLE_DCO %30.12e \" // 1\n",
+    "            \"%g %g %g %g \" // 2-5\n",
+    "            \"%d %d %d %d \" // 6-9\n",
+    "            \"%g %g\\\\n\", // 10-11\n",
+    "\n",
+    "            stardata->model.time, // 1\n",
+    "\n",
+    "            stardata->star[0].mass, //2\n",
+    "            stardata->common.zero_age.mass[0], //3\n",
+    "            stardata->star[1].mass, //4\n",
+    "            stardata->common.zero_age.mass[1], //5\n",
+    "\n",
+    "            stardata->star[0].stellar_type, //6\n",
+    "            stardata->previous_stardata->star[0].stellar_type, //7\n",
+    "            stardata->star[1].stellar_type, //8\n",
+    "            stardata->previous_stardata->star[1].stellar_type, //9\n",
+    "\n",
+    "            // model stuff\n",
+    "            stardata->common.metallicity, //10\n",
+    "            stardata->model.probability //11\n",
+    "        );\n",
+    "    }\n",
+    "    /* Kill the simulation to safe time */\n",
+    "    stardata->model.max_evolution_time = stardata->model.time - stardata->model.dtm;\n",
+    "}\n",
+    "\"\"\"\n",
+    ")\n",
+    "\n",
+    "# Add grid variables\n",
+    "resolution = {\"M_1\": 5, \"q\": 5, \"per\": 5}\n",
+    "\n",
+    "# Mass\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"lnm1\",\n",
+    "    longname=\"Primary mass\",\n",
+    "    valuerange=[2, 150],\n",
+    "    resolution=\"{}\".format(resolution[\"M_1\"]),\n",
+    "    spacingfunc=\"const(math.log(2), math.log(150), {})\".format(resolution[\"M_1\"]),\n",
+    "    precode=\"M_1=math.exp(lnm1)\",\n",
+    "    probdist=\"three_part_powerlaw(M_1, 0.1, 0.5, 1.0, 150, -1.3, -2.3, -2.3)*M_1\",\n",
+    "    dphasevol=\"dlnm1\",\n",
+    "    parameter_name=\"M_1\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "# Mass ratio\n",
+    "example_pop.add_grid_variable(\n",
+    "    name=\"q\",\n",
+    "    longname=\"Mass ratio\",\n",
+    "    valuerange=[\"0.1/M_1\", 1],\n",
+    "    resolution=\"{}\".format(resolution['q']),\n",
+    "    spacingfunc=\"const(0.1/M_1, 1, {})\".format(resolution['q']),\n",
+    "    probdist=\"flatsections(q, [{'min': 0.1/M_1, 'max': 1.0, 'height': 1}])\",\n",
+    "    dphasevol=\"dq\",\n",
+    "    precode=\"M_2 = q * M_1\",\n",
+    "    parameter_name=\"M_2\",\n",
+    "    condition=\"\",  # Impose a condition on this grid variable. Mostly for a check for yourself\n",
+    ")\n",
+    "\n",
+    "#\n",
+    "example_pop.add_grid_variable(\n",
+    "   name=\"log10per\", # in days\n",
+    "   longname=\"log10(Orbital_Period)\",\n",
+    "   valuerange=[0.15, 5.5],\n",
+    "   resolution=\"{}\".format(resolution[\"per\"]),\n",
+    "   spacingfunc=\"const(0.15, 5.5, {})\".format(resolution[\"per\"]),\n",
+    "   precode=\"\"\"orbital_period = 10** log10per\n",
+    "sep = calc_sep_from_period(M_1, M_2, orbital_period)\n",
+    "sep_min = calc_sep_from_period(M_1, M_2, 10**0.15)\n",
+    "sep_max = calc_sep_from_period(M_1, M_2, 10**5.5)\"\"\",\n",
+    "   probdist=\"sana12(M_1, M_2, sep, orbital_period, sep_min, sep_max, math.log10(10**0.15), math.log10(10**5.5), -0.55)\",\n",
+    "   parameter_name=\"orbital_period\",\n",
+    "   dphasevol=\"dlog10per\",\n",
+    ")\n",
+    "\n",
+    "# Exporting of all the settings can be done with .export_all_info()\n",
+    "example_pop.export_all_info()\n",
+    "\n",
+    "# remove the result file if it exists\n",
+    "if os.path.isfile(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\")):\n",
+    "    os.remove(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"))\n",
+    "\n",
+    "# Evolve the population\n",
+    "example_pop.evolve()\n",
+    "\n",
+    "# \n",
+    "with open(os.path.join(temp_dir(), \"example_python_population_result\", \"example_pop.dat\"), 'r') as f:\n",
+    "    output = f.read()\n",
+    "print(\"\\n\")\n",
+    "print(output)"
+   ]
   }
  ],
  "metadata": {
diff --git a/docs/source/notebooks.rst b/docs/source/notebooks.rst
deleted file mode 100644
index 8002bcb2b..000000000
--- a/docs/source/notebooks.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Notebooks
-=========
-The notebooks.
-
-
-.. toctree::
-    :maxdepth: 2
-    :caption: Contents:
-
-    notebook_population.ipynb
diff --git a/docs/source/population_example.rst b/docs/source/population_example.rst
deleted file mode 100644
index 192372d01..000000000
--- a/docs/source/population_example.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Example of population script
-============================
-The source code of a script to run a population of stars. 
-
-.. literalinclude:: ../../examples/example_population.py
-    :language: python
-    :linenos:
\ No newline at end of file
-- 
GitLab