From 1d76798e0aad25fe183980f8cf94e4542a4fef5c Mon Sep 17 00:00:00 2001
From: Anthony Scopatz <scopatz@gmail.com>
Date: Thu, 9 Feb 2017 11:41:09 -0500
Subject: [PATCH] Pyagent Documentation (#230)

LGTM!

thx @scopatz
---
 source/arche/cli.rst                          |  44 +-
 source/arche/custom_tables.rst                |  60 +-
 source/arche/dbtypes.rst                      |  22 +-
 source/arche/decay.rst                        |  24 +-
 source/arche/dre.rst                          | 579 ++++++++++++------
 source/arche/dynamic_loading.rst              |   8 +-
 source/arche/errors.rst                       |  33 +-
 .../{hello_world.rst => hello_world_cpp.rst}  |  68 +-
 source/arche/hello_world_py.rst               | 130 ++++
 source/arche/index.rst                        |  24 +-
 source/arche/logger.rst                       |  24 +-
 source/arche/resources.rst                    | 161 ++++-
 source/arche/sim_init.rst                     |   2 -
 source/arche/timestep.rst                     |  22 +-
 source/arche/toolkit.rst                      | 101 ++-
 source/arche/{tour.rst => tour_cpp.rst}       |   0
 .../{tutorial => tutorial_cpp}/cyclist.rst    |   0
 .../arche/{tutorial => tutorial_cpp}/dre.rst  |   0
 .../{tutorial => tutorial_cpp}/github_new.png | Bin
 .../{tutorial => tutorial_cpp}/index.rst      |   7 +-
 .../input_files.rst                           |   0
 .../{tutorial => tutorial_cpp}/setup.rst      |  58 +-
 .../simple_cycle.svg                          |   0
 .../{tutorial => tutorial_cpp}/state_var.rst  |   0
 .../storage_capacity.svg                      |   0
 .../storage_diagram.svg                       |   0
 .../{tutorial => tutorial_cpp}/testing.rst    |   0
 .../{tutorial => tutorial_cpp}/toolkit.rst    |   0
 source/arche/tutorial_py/github_new.png       | Bin 0 -> 132458 bytes
 source/arche/tutorial_py/index.rst            |  28 +
 source/arche/tutorial_py/input_files.rst      |   5 +
 source/arche/tutorial_py/setup.rst            | 170 +++++
 source/arche/tutorial_py/simple_cycle.svg     |   4 +
 source/arche/tutorial_py/state_var.rst        | 228 +++++++
 source/arche/tutorial_py/storage_capacity.svg |   4 +
 source/arche/tutorial_py/storage_diagram.svg  |   4 +
 source/arche/tutorial_py/testing.rst          |   4 +
 source/arche/tutorial_py/toolkit.rst          | 329 ++++++++++
 source/cyclusagent.py                         | 163 ++++-
 source/user/input_specs/archetypes.rst        |  21 +-
 source/user/input_specs/commodity.rst         |  26 +-
 source/user/input_specs/control.rst           |  24 +-
 source/user/input_specs/facility.rst          |  75 +--
 source/user/input_specs/inst.rst              |  94 ++-
 source/user/input_specs/recipe.rst            |  61 +-
 source/user/input_specs/region.rst            |  63 +-
 source/user/writing_input.rst                 |  78 ++-
 47 files changed, 2155 insertions(+), 593 deletions(-)
 rename source/arche/{hello_world.rst => hello_world_cpp.rst} (69%)
 create mode 100644 source/arche/hello_world_py.rst
 rename source/arche/{tour.rst => tour_cpp.rst} (100%)
 rename source/arche/{tutorial => tutorial_cpp}/cyclist.rst (100%)
 rename source/arche/{tutorial => tutorial_cpp}/dre.rst (100%)
 rename source/arche/{tutorial => tutorial_cpp}/github_new.png (100%)
 rename source/arche/{tutorial => tutorial_cpp}/index.rst (90%)
 rename source/arche/{tutorial => tutorial_cpp}/input_files.rst (100%)
 rename source/arche/{tutorial => tutorial_cpp}/setup.rst (67%)
 rename source/arche/{tutorial => tutorial_cpp}/simple_cycle.svg (100%)
 rename source/arche/{tutorial => tutorial_cpp}/state_var.rst (100%)
 rename source/arche/{tutorial => tutorial_cpp}/storage_capacity.svg (100%)
 rename source/arche/{tutorial => tutorial_cpp}/storage_diagram.svg (100%)
 rename source/arche/{tutorial => tutorial_cpp}/testing.rst (100%)
 rename source/arche/{tutorial => tutorial_cpp}/toolkit.rst (100%)
 create mode 100644 source/arche/tutorial_py/github_new.png
 create mode 100644 source/arche/tutorial_py/index.rst
 create mode 100644 source/arche/tutorial_py/input_files.rst
 create mode 100644 source/arche/tutorial_py/setup.rst
 create mode 100644 source/arche/tutorial_py/simple_cycle.svg
 create mode 100644 source/arche/tutorial_py/state_var.rst
 create mode 100644 source/arche/tutorial_py/storage_capacity.svg
 create mode 100644 source/arche/tutorial_py/storage_diagram.svg
 create mode 100644 source/arche/tutorial_py/testing.rst
 create mode 100644 source/arche/tutorial_py/toolkit.rst

diff --git a/source/arche/cli.rst b/source/arche/cli.rst
index 58bf08255..c7edb670b 100644
--- a/source/arche/cli.rst
+++ b/source/arche/cli.rst
@@ -2,7 +2,6 @@
 
 Archetype Command Line Interface
 =======================================
-
 There are a few archetype-specific |Cyclus| CLI commands that allow
 introspecting details of archetypes that |Cyclus| can find.  Most expose data
 that is automatically generated by the Cyclus preprocessor. For example,
@@ -39,15 +38,15 @@ To view a JSON structured output of all the data generated and collected from
       $ cyclus --agent-annotations :cycamore:Source
       {
        "all_parents": [
-        "cyclus::Agent", 
-        "cyclus::Facility", 
-        "cyclus::Ider", 
-        "cyclus::StateWrangler", 
-        "cyclus::TimeListener", 
-        "cyclus::Trader", 
-        "cyclus::toolkit::AgentManaged", 
+        "cyclus::Agent",
+        "cyclus::Facility",
+        "cyclus::Ider",
+        "cyclus::StateWrangler",
+        "cyclus::TimeListener",
+        "cyclus::Trader",
+        "cyclus::toolkit::AgentManaged",
         "cyclus::toolkit::CommodityProducer"
-       ], 
+       ],
        "doc": "This facility acts as a source of material with a fixed...
        ...
 
@@ -69,26 +68,33 @@ And to list all archetypes inside a particular library:
 
 Archetype Versioning
 --------------------
-
 The ``cyclus::Agent`` class exposes a ``version()`` member function which can be
-queried with the |Cyclus| CLI. For example, 
+queried with the |Cyclus| CLI. For example,
 
-  .. code-block:: bash
+.. code-block:: bash
 
-      $ cyclus --agent-version :agents:Source
-      1.3.1-7-g9a2c9c9
+    $ cyclus --agent-version :agents:Source
+    1.3.1-7-g9a2c9c9
 
 This is generated from some ``git`` version control information. You can make
 your own version tag information for some archetype like
 
+**C++:**
+
+.. code-block:: c++
 
-  .. code-block:: c++
+    virtual std::string version() { return "My Version"; }
 
-      virtual std::string version() { return "My Version"; }
+**Python:**
+
+.. code-block:: Python
+
+    def version(self):
+        return "My Version"
 
 and then access the version with
 
-  .. code-block:: bash
+.. code-block:: bash
 
-      $ cyclus --agent-version my/path:my_library:MyArchetype
-      My Version
+    $ cyclus --agent-version my/path:my_library:MyArchetype
+    My Version
diff --git a/source/arche/custom_tables.rst b/source/arche/custom_tables.rst
index 5063f70c1..473530b69 100644
--- a/source/arche/custom_tables.rst
+++ b/source/arche/custom_tables.rst
@@ -1,4 +1,3 @@
-
 Custom Database Tables
 =======================
 
@@ -6,6 +5,8 @@ Agents are allowed to write their own custom output into the database during
 simulations.  The interface for recording this data is accessible through the
 agent's :term:`context`.  Data may be logged via the Context::NewDatum function:
 
+**C++:**
+
 .. code-block:: c++
 
   MyReactor::Tick() {
@@ -22,10 +23,29 @@ agent's :term:`context`.  Data may be logged via the Context::NewDatum function:
     ...
   }
 
+**Python:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+    import cyclus.typesystem as ts
+
+    class MyReactor(Facility):
+
+        def tick(self):
+            ...
+            d = self.context.new_datum("MyReactorData")
+            d.add_val("AgentID", self.id, type=ts.INT)
+            d.add_val("Time", self.context.time, type=ts.INT)
+            d.add_val("WaterUsage", self.monthl_water, type=ts.DOUBLE)
+            d.add_val("OperatingCost", self.monthly_op_cost, type=ts.DOUBLE)
+            d.record()
+            ...
+
 This would create a table in the output database named "MyReactorData". The
 table would get a new row entry every time step with four columns named
-"AgentID", "Time", "WaterUsage" and "OperatingCost".  ``AddVal`` calls can be chained
-any number of times for an arbitrary number of columns.  ``Record`` must be
+"AgentID", "Time", "WaterUsage" and "OperatingCost".  "Add value" calls can be chained
+any number of times for an arbitrary number of columns.  Record must be
 called once for each datum after all values have been added.  Any custom
 tables created in this manner will appear in the output database alongside the
 |cyclus| core tables.  Because there may be several agent instances of a
@@ -33,6 +53,8 @@ single agent class, tables should generally include a column that adds their
 ID; and for similar reasons, it is often desirable to include the simulation
 time as a column in these tables:
 
+**C++:**
+
 .. code-block:: c++
 
     context()->NewDatum("MyReactorData")
@@ -41,6 +63,16 @@ time as a column in these tables:
              ->AddVal(...
              ...
 
+**Python:**
+
+.. code-block:: python
+
+    d = self.context.new_datum("MyReactorData")
+    d.add_val("AgentID", self.id, type=ts.INT)
+    d.add_val("Time", self.context.time, type=ts.INT)
+    d.add_val(...
+    ...
+
 Datums with the same table name must have the same schema (e.g. same field
 names and value types). It is the responsibility of the developer to
 enforce this in their code.
@@ -53,8 +85,8 @@ enforce this in their code.
    use. For information on which c++ types the backends support, you can check
    :doc:`here <dbtypes>`.
 
-.. note:: If you require a datatype that isn't currently supported, please 
-          ask the kernel developers and they will help as soon as possible. 
+.. note:: If you require a datatype that isn't currently supported, please
+          ask the kernel developers and they will help as soon as possible.
 
 Table Data Shapes
 ------------------
@@ -70,6 +102,8 @@ vector indicates variable length also.  It is an error to pass in a shape
 vector with the wrong rank (number of elements) for that type.  An example of
 using the shape vector follows:
 
+**C++:**
+
 .. code-block:: c++
 
     std::vector<std::string> colors;
@@ -84,15 +118,27 @@ using the shape vector follows:
     context()->NewDatum("DecorPreferences")
              ->AddVal("AgentID", id())
              ->AddVal("Time", context()->time())
-             ->AddVal("FavoritColors", colors, shape)
+             ->AddVal("FavoriteColors", colors, shape)
              ->Record();
 
+**Python:**
+
+.. code-block:: c++
+
+    colors = ["green", "blue", "chartreuse"]
+    shape = [5, 8]
+    d = self.context.new_datum("DecorPreferences")
+    d.add_val("AgentID", self.id, type=ts.INT)
+    d.add_val("Time", self.context.time, type=ts.INT)
+    d.add_val("FavoriteColors", colors, shape, ts.VECTOR_STRING)
+    d.record()
+
 In the example above, the "chartreuse" color is longer than the 8 characters
 specified in the shape.  So it will be truncated to "chartreu" in the
 database. Shape vectors should generally be stored as class member variables
 to avoid excessive memory [de]allocation and should be set correctly from
 construction to destruction of your agent.
-    
+
 Reserved Table Names
 ---------------------
 
diff --git a/source/arche/dbtypes.rst b/source/arche/dbtypes.rst
index 25a86cb69..c69d55872 100644
--- a/source/arche/dbtypes.rst
+++ b/source/arche/dbtypes.rst
@@ -3,8 +3,8 @@
 Database Types
 ==============
 
-Here is a listing of all supported data types that the various backends have 
-implemented, by |cyclus| version number. If your agents need a type that is not 
+Here is a listing of all supported data types that the various backends have
+implemented, by |cyclus| version number. If your agents need a type that is not
 yet supported, please let us know and we'll get to it as soon as possible!
 
 **Description of fields:**
@@ -29,7 +29,7 @@ yet supported, please let us know and we'll get to it as soon as possible!
 
     <style>
     p {
-      font-size: 100%; 
+      font-size: 100%;
     }
 
     img {
@@ -52,7 +52,7 @@ yet supported, please let us know and we'll get to it as soon as possible!
     var dbdata = []
     $.getJSON("/arche/dbtypes.json", function(json) {
         dbdata = json;
-    
+
         function setupPivot(input){
           input.callbacks = {afterUpdateResults: function(){
             $('#results > table').dataTable({
@@ -72,16 +72,16 @@ yet supported, please let us know and we'll get to it as soon as possible!
             fields =[{name: 'id',         type: 'integer', filterable: true},
                      {name: 'name',       type: 'string',  filterable: true,
                       displayFunction: function(value){
-                        return '<div style="font-family:Courier,monospace;">' + 
+                        return '<div style="font-family:Courier,monospace;">' +
                                value + '</div>';}},
                      {name: "C++ type",   type: 'string',  filterable: true,
                       displayFunction: function(value){
-                        return '<div style="font-family:Courier,monospace;">' + 
+                        return '<div style="font-family:Courier,monospace;">' +
                                value + '</div>';}},
                      {name: 'shape rank', type: 'integer', filterable: true},
-                     {name: 'backend',    type: 'string',  filterable: true, 
+                     {name: 'backend',    type: 'string',  filterable: true,
                       columnLabelable: true},
-                     {name: 'version',    type: 'string',  filterable: true, 
+                     {name: 'version',    type: 'string',  filterable: true,
                       columnLabelable: true},
                      {name: 'supported',  type: 'integer', filterable: true,
                       rowLabelable: true, summarizable: 'sum',
@@ -90,15 +90,15 @@ yet supported, please let us know and we'll get to it as soon as possible!
                           return '<div style="text-align:center;' +
                                  'background-color:#c8e8b0">Yes</div>';
                         else
-                          return '<div style="text-align:center;' + 
+                          return '<div style="text-align:center;' +
                                  'background-color:#fcf1df">No</div>';
                         }
                       }
                      ];
 
             setupPivot({json: dbdata, fields: fields,
-                        filters: {version: "v1.2"}, 
-                        rowLabels: ["C++ type"], 
+                        filters: {version: "v1.2"},
+                        rowLabels: ["C++ type"],
                         columnLabels: ["backend"],
                         summaries: ["supported_sum"]});
 
diff --git a/source/arche/decay.rst b/source/arche/decay.rst
index 22a02cbc0..e593bbe58 100644
--- a/source/arche/decay.rst
+++ b/source/arche/decay.rst
@@ -2,7 +2,6 @@
 
 Radioactive Decay in |Cyclus|
 =============================
-
 .. warning:: Decay in |cyclus| is experimental.
 
 Radioactive decay of a group of isotopes over time can be described by the
@@ -28,7 +27,6 @@ is explained in more detail below.
 
 The Uniformization Method
 -------------------------
-
 The Uniformization Method is essentially a modification of the truncated Taylor
 Series expansion of the matrix exponential solution, which can be described by
 the following summation:
@@ -51,7 +49,7 @@ The first step in applying the uniformization technique is to define
 element of `A`:
 
 .. math::
-  
+
    \alpha=max_i\left | {a_i}_i \right |
 
 Then, given `alpha`, the next step is to redefine the matrix
@@ -114,15 +112,15 @@ in an even lower maximum time scale.
 References
 ----------
 
-  #. Cleve Moler and Charles van Loan, "Nineteen Dubious Ways to Compute the
-     Exponential of a Matrix, Twenty-Five Years Later," *SIAM Review*, *45*,
-     3-49 (2003)
+#. Cleve Moler and Charles van Loan, "Nineteen Dubious Ways to Compute the
+   Exponential of a Matrix, Twenty-Five Years Later," *SIAM Review*, *45*,
+   3-49 (2003)
+
+#. Erwin Muller, Frederik Reitsma and Paulus P. Kruger, "A Stable Nuclide
+   Transmutation Procedure Free of Numerical Roundoff," *PHYSOR 2006*, September
+   10-14, Vancouver, Canada (2006)
 
-  #. Erwin Muller, Frederik Reitsma and Paulus P. Kruger, "A Stable Nuclide
-     Transmutation Procedure Free of Numerical Roundoff," *PHYSOR 2006*, September
-     10-14, Vancouver, Canada (2006)
+#. R. B. Sidje and W. J. Stewart, "A numerical study of large sparse matrix
+   exponentials arising in Markov chains," *Computational Statistics & Data
+   Analysis*, *29*, 345-368 (1999)
 
-  #. R. B. Sidje and W. J. Stewart, "A numerical study of large sparse matrix
-     exponentials arising in Markov chains," *Computational Statistics & Data
-     Analysis*, *29*, 345-368 (1999)
-  
diff --git a/source/arche/dre.rst b/source/arche/dre.rst
index 7516493a9..106c3d19d 100644
--- a/source/arche/dre.rst
+++ b/source/arche/dre.rst
@@ -2,21 +2,20 @@
 
 Dynamic Resource Exchange
 =========================
-
 The Dynamic Resource Exchange (DRE) is the heart of a |cyclus| simulation time
-step. Every ``cyclus::Trader`` that is registered with the ``cyclus::Context``
-are automatically included in the exchange. |cyclus| agents can either implement
-the ``cyclus::Trader`` interface as a mixin or can be composed of one or more
-``cyclus::Trader``\ s. Note that ``cyclus::Facility`` derives the
-``cyclus::Trader`` interface, therefore all agents that derive from
-``cyclus::Facility`` also get the interface.
+step. Every ``Trader`` that is registered with the ``Context``
+is automatically included in the exchange. |cyclus| agents can either implement
+the ``Trader`` interface as a mixin or can be composed of one or more
+traders. Note that the ``Facility`` class derives the
+``Trader`` interface, and therefore all agents that derive from
+``Facility`` are also traders.
 
-At any given time step, there is a separate ``cyclus::ResourceExchange`` 
-instance for each concrete ``cyclus::Resource`` of which the kernel is
-aware. For example, there is an exchange for ``cyclus::Material``\ s and another
-for ``cyclus::Product``\ s.
+On each time step, there is a separate ``ResourceExchange``
+instance for each concrete ``Resource`` (i.e. ``Materials`` and ``Products``) of which
+the kernel is aware. For example, there is an exchange for ``Material``
+resources and another for ``Product`` resources.
 
-The DRE is comprised of five phases:
+The DRE is comprised of five phases which execure in series:
 
 * :ref:`rfb`
 * :ref:`rrfb`
@@ -29,15 +28,14 @@ The DRE is comprised of five phases:
 
 Request For Bids Phase
 ----------------------
-
 In the Request for Bids (RFB) phase, the exchange queries all registered traders
 regarding their demand for a given resource type. Querying is provided through
-the ``cyclus::Trader`` interface's ``Get*Requests`` for a given resource type,
-e.g., ``GetMatlRequests``.
+the ``Trader`` interface's "get requests" for a given resource type,
+e.g., ``GetMatlRequests()`` (C++) or ``get_material_requests()`` (Python) functions.
 
-Requests are modeled as collections of ``cyclus::RequestPortfolio``\ s, where each
-portfolio includes a collection of ``cyclus::Request``\ s and a collection of
-``cyclus::CapacityConstraint``\ s. A portfolio is sufficiently met if one or more
+Requests are modeled as collections of ``RequestPortfolio`` instances, where each
+portfolio includes a collection of ``Request`` objects and a collection of
+``CapacityConstraint`` objects. A portfolio is sufficiently met if one or more
 of its constituent requests are met and all of its constraints are satisfied.
 
 A request provides a target resource, a commodity, and a preference for that
@@ -46,15 +44,16 @@ conversion function that can convert a potential resource into the units of the
 capacity (see :ref:`rrfb` for a more detailed example).
 
 For example, consider a facility of type ``FooFac`` that needs 5 kg fuel,
-which is a ``cyclus::Material`` resource type. It knows of two commodities in
+where the fuel is represented by a ``Material`` resource. It knows of two commodities in
 the simulation that meet its demand, ``FuelA`` and ``FuelB``, and it prefers
-``FuelA`` over ``FuelB``. A valid ``GetMatlRequests`` implementation would then
+``FuelA`` over ``FuelB``. A valid get material request implementation would then
 be:
 
+**C++:**
+
 .. code-block:: c++
 
-    virtual std::set<cyclus::RequestPortfolio<cyclus::Material>::Ptr>
-        FooFac::GetMatlRequests() {
+    virtual std::set<cyclus::RequestPortfolio<cyclus::Material>::Ptr> FooFac::GetMatlRequests() {
       using cyclus::RequestPortfolio;
       using cyclus::Material;
       using cyclus::CapacityConstraint;
@@ -62,16 +61,16 @@ be:
       double request_qty = 10; // kg
       std::string recipeA = "recipeA";
       std::string commoda = "FuelA";
-      Material::Ptr targetA = 
-          Material::CreateUntracked(request_qty, context()->GetRecipe(recipeA));
+      Material::Ptr targetA = Material::CreateUntracked(request_qty,
+                                                        context()->GetRecipe(recipeA));
 
       std::string recipeB = "recipeB";
       std::string commodB = "FuelB";
-      Material::Ptr targetB = 
-          Material::CreateUntracked(request_qty, context()->GetRecipe(recipeB));
-      
+      Material::Ptr targetB = Material::CreateUntracked(request_qty,
+                                                        context()->GetRecipe(recipeB));
+
       CapacityConstraint<Material> cc(request_qty);
-      
+
       RequestPortfolio<Material>::Ptr port(new RequestPortfolio<Material>());
       port->AddRequest(targeta, this, commodA);
       port->AddRequest(targetb, this, commodB);
@@ -79,22 +78,61 @@ be:
 
       std::set<RequestPortfolio<Material>::Ptr> ports();
       ports.insert(port);
-      return ports;  
+      return ports;
     }
 
+**Python:**
+
+.. code-block:: python
+
+    import cyclus.typesystem as ts
+
+    def get_material_requests(self):
+        request_qty = 10.0  # kg
+        # Material Target A
+        recipe_a = self.context().get_recipe("recipeA")
+        target_a = ts.Material.create_untracked(request_qty, recipe_a)
+        # Material Target B
+        recipe_b = self.context().get_recipe("recipeB")
+        target_b = ts.Material.create_untracked(request_qty, recipe_b)
+        # commodity mapping to request target
+        commods = {"FuelA": target_a, "FuelB": target_b}
+
+        # The Python interface allow you to return a few different structures,
+        # depending on your needs.  In its simplest form, if you do not not have
+        # any capacity constraints, you can just return the commoditer mapping!
+        return commods
+
+        # If you do have a capacity constraint, you need to provide a portfolio
+        # dict. This is simply a dict with two keys: "commodities" and "constraints".
+        # The "commodities" value is the same as above. The "constraints" value is
+        # either a float or an iterable of floats.
+        # single constraint:
+        port = {"commodities": commods, "constraints": request_qty}
+        return port
+        # many constraints:
+        port = {"commodities": commods, "constraints": [request_qty, request_qty*2]}
+        return port
+
+        # lastly, if you need to return many portfolios, simply return a list of
+        # portfolio dictionaries!
+        ports = [{"commodities": {"FuelA": target_a}, "constraints": request_qty},
+                 {"commodities": {"FuelB": target_b}, "constraints": request_qty}]
+        return ports
+
+
 .. _rrfb:
 
 Response to Request For Bids Phase
 ----------------------------------
-
 In the Response to Request for Bids (RRFB) phase, the exchange queries all
 registered traders regarding their supply for a given resource type. Querying is
-provided through the ``cyclus::Trader`` interface's ``Get*Bids`` for a given
-resource type, e.g., ``GetMatlBids``.
+provided through the ``Trader`` interface's "get bids" for a given
+resource type, e.g. ``GetMatlBids()`` (C++) or ``get_material_bids()`` (Python).
 
-Bids are modeled as collections of ``cyclus::BidPortfolio``\ s, where each
-portfolio includes a collection of ``cyclus::Bid``\ s and a collection of
-``cyclus::CapacityConstraint``\ s. A portfolio is not violated if any of its
+Bids are modeled as collections of ``BidPortfolio``, where each
+portfolio includes a collection of ``Bid`` objects and a collection of
+``CapacityConstraint`` objectss. A portfolio is not violated if any of its
 constituent bids are connected to their requests and all of its constraints are
 satisfied.
 
@@ -103,11 +141,12 @@ offering in response to the request.
 
 Black Box Examples
 ++++++++++++++++++
-
 Consider a facility of type ``FooFac`` that has 10 kg of fuel of commodity type
 ``FuelA`` that it can provide. Furthermore, consider that its capacity to
 fulfill orders is constrained by the total amount of a given nuclide. A valid
-``GetMatlBids`` implementation would then be:
+get material bids implementation would then be:
+
+**C++:**
 
 .. code-block:: c++
 
@@ -115,20 +154,17 @@ fulfill orders is constrained by the total amount of a given nuclide. A valid
      public:
       NucConverter(int nuc) : nuc_(nuc) {};
 
-      virtual double convert(
-          cyclus::Material::Ptr m,
-      	  cyclus::Arc const * a = NULL,
-      	  cyclus::ExchangeTranslationContext<cyclus::Material> const * ctx = NULL) const {
+      virtual double convert(cyclus::Material::Ptr m, cyclus::Arc const * a = NULL,
+                             cyclus::ExchangeTranslationContext<cyclus::Material> const * ctx = NULL) const {
         cyclus::MatQuery mq(m);
-  	return mq.mass(nuc_);
+        return mq.mass(nuc_);
       }
 
      private:
-      int nuc_; 
+      int nuc_;
     };
 
-    virtual std::set<cyclus::BidPortfolio<cyclus::Material>::Ptr>
-      FooFac::GetMatlBids(
+    virtual std::set<cyclus::BidPortfolio<cyclus::Material>::Ptr> FooFac::GetMatlBids(
         cyclus::CommodMap<cyclus::Material>::type& commod_requests) {
       using cyclus::BidPortfolio;
       using cyclus::CapacityConstraint;
@@ -144,14 +180,15 @@ fulfill orders is constrained by the total amount of a given nuclide. A valid
       for (it = requests.begin(); it != requests.end(); ++it) {
         std::string recipe = "recipe";
         std::string commod = "Fuel";
-        for (it = requests.begin(); it != requests.end(); ++it) {      
-          Material::Ptr offer = 
-              Material::CreateUntracked(request_qty, context()->GetRecipe(recipe));
-	port->AddBid(*it, offer, this);
+        for (it = requests.begin(); it != requests.end(); ++it) {
+          Material::Ptr offer = Material::CreateUntracked(request_qty,
+                                                          context()->GetRecipe(recipe));
+          port->AddBid(*it, offer, this);
+        }
       }
 
       // add a custom constraint for Pu-239
-      int pu = 932390000; // Pu-239 
+      int pu = 932390000; // Pu-239
       Converter<Material>::Ptr conv(new NucConverter(pu));
       double max_pu = 8.0; // 1 Signifigant Quantity of Pu-239
       CapacityConstraint<Material> constr(max_pu, conv);
@@ -162,26 +199,83 @@ fulfill orders is constrained by the total amount of a given nuclide. A valid
       return ports;
     }
 
+
+**Python:**
+
+.. code-block:: python
+
+    # Note that the Python interface does not yet support custom constraint functions.
+    # these are fairly rare in practice and is a forth coming feature.
+    import cyclus.typesystem as ts
+
+    def get_material_bids(self, requests):
+        """This function takes as input a requests dictionary, which maps
+        commodity names to tuples of Request instances. For example::
+
+            requests = {
+                "FuelA": (MaterialRequest1, MaterialRequest2),
+                "FuelB": (MaterialRequest3, MaterialRequest4),
+                }
+
+        For more information on MaterialRequests and ProductRequests, please see
+        the cyclus.typesystem docs.
+        """
+        # Like with get_material_requests(), many potential bid structures can be returned
+        # depending on you need. If the commodity that you trade in wasn't requested this
+        # time step, you can just return None.
+        if 'FuelA' not in requests:
+            return
+
+        # Alternitavely, you may return a bid portfolio. Let's start by constructing the
+        # bids. If you don't want to offer a bid that is different than the request,
+        # you can just provide the requests. The bids are then a list of the request objects
+        reqs = requests['FuelA']
+        bids = [req for req in reqs]
+        # Or if you do want to offer something different than the request, the bids list
+        # list contains dictionaries with "request" and "offer" keys
+        recipe_comp = self.context.get_recipe(self.recipe_name)
+        bids = []
+        for req in reqs:
+            qty = min(req.target.quantity, self.capacity)
+            mat = ts.Material.create_untracked(qty, recipe_comp)
+            bids.append({'request': req, 'offer': mat})
+        # now that we have the bids, we can add this to a bid portfolio dict, which
+        # contains a "bids" key.
+        port = {"bids": bids}
+        return port
+
+        # if you need to add capcity constraint(s), also include a "constraints" key
+        # in the bids portfolio dict.
+        port = {"bids": bids, "constraints": self.capacity}
+        return port
+
+        # Of course you may also return many bid portfolios by putting the many
+        # dicts in the above form in a list.
+        ports = [{"bids": bids[::2], "constraints": self.capacity},
+                 {"bids": bids[1::2], "constraints": self.capacity}]
+        return ports
+
+
 White Box Examples
 +++++++++++++++++++
-
 Consider a case where a facility's bid depends on the type of the requester's
-``cyclus::Agent``, and the bidder determines its offer based on the requester's
+``Agent``, and the bidder determines its offer based on the requester's
 interface:
 
+**C++:**
+
 .. code-block:: c++
 
     cyclus::Material::Ptr FooFac::SpecialFooOffer() {
       std::string recipe = "recipe";
       double quantity = 10;
-      Material::Ptr target = 
-          Material::CreateUntracked(quantity, context()->GetRecipe(recipe));
+      Material::Ptr target = Material::CreateUntracked(quantity,
+                                                       context()->GetRecipe(recipe));
       return target;
     };
 
-    virtual std::set<cyclus::BidPortfolio<cyclus::Material>::Ptr>
-      FooFac::GetMatlBids(
-        cyclus::CommodMap<cyclus::Material>::type& commod_requests) {
+    virtual std::set<cyclus::BidPortfolio<cyclus::Material>::Ptr> FooFac::GetMatlBids(
+                                cyclus::CommodMap<cyclus::Material>::type& commod_requests) {
       using cyclus::BidPortfolio;
       using cyclus::Material;
       using cyclus::Request;
@@ -193,16 +287,16 @@ interface:
       std::vector<Request<Material>*>::iterator it;
       for (it = requests.begin(); it != requests.end(); ++it) {
         Material::Ptr offer;
-	Agent* agent = it->requester();
-	FooFac* cast = dynamic_cast<FooFac*>(agent);
-	if (cast != NULL) {
-	    offer = cast->SpecialFooOffer(); // get a special response that the requester wants
-	} else { 
-	    double qty = it->quantity();     
-      	    std::string recipe = "some_other_recipe";
-      	    Material::Ptr offer = Material::CreateUntracked(qty, context()->GetRecipe(recipe));
-	}	    
-	port->AddBid(*it, offer, this);
+        Agent* agent = it->requester();
+        FooFac* cast = dynamic_cast<FooFac*>(agent);
+        if (cast != NULL) {
+          offer = cast->SpecialFooOffer(); // get a special response that the requester wants
+        } else {
+          double qty = it->quantity();
+          std::string recipe = "some_other_recipe";
+          Material::Ptr offer = Material::CreateUntracked(qty, context()->GetRecipe(recipe));
+        }
+        port->AddBid(*it, offer, this);
       }
 
       std::set<BidPortfolio<Material>::Ptr> ports;
@@ -210,29 +304,54 @@ interface:
       return ports;
     }
 
+
+**Python:**
+
+.. code-block:: python
+
+    from cyclus.typesystem import ts
+
+    def special_foo_offer(self):
+        recipe = self.context.get_recipe("recipe")
+        target = ts.Material.create_untracked(10, recipe)
+        return target
+
+    def get_material_bids(self, requests):
+        reqs = requests["FuelA"]
+        bids = []
+        for req in reqs:
+            if isinstance(req.requester, FooFac):
+                offer = self.special_foo_offer()
+            else:
+                qty = req.quantity
+                recipe = self.context.get_recipe("some_other_recipe")
+                offer = ts.Material.create_untracked(qty, recipe)
+            bids.append(req)
+        return {"bids": bids}
+
+
 .. _adj:
 
 Preference Adjustment Phase
 ---------------------------
-
 In the Preference Adjustment (PA) phase, requesters are allowed to view which
 bids were matched to their requests, and adjust their preference for the given
-bid-request pairing. Querying is provided through the ``cyclus::Trader`` and
-``cyclus::Agent`` interfaces' ``Adjust*Prefs`` for a given resource type, e.g.,
-``AdjustMaterialPrefs``.
+bid-request pairing. Querying is provided through the ``Agent`` interface, so all cyclus
+archetypes may adjust preferences. The "adjust prefs: functions are based on a given resource
+type, e.g. ``AdjustMaterialPrefs`` (C++) or ``adjust_material_prefs()`` (Python).
 
 Preferences are used by resource exchange solvers to inform their solution
 method. The default preference for all bids is zero. Agents will only utilize
 the PA phase if there is a reason to update preferences over the default
 provided in their original request.
 
-Preferences can be adjusted by both the original ``cyclus::Trader`` placing
-requests as well as any parent ``cyclus::Agent``\s, with the trader adjusting
+Preferences can be adjusted by both the original ``Trader`` placing
+requests as well as any parent ``Agent`` instances, with the trader adjusting
 first and the most senior parent adjusting last. In the supported
 Region-Institution-Facility agent relationship, Facilities adjust first,
 followed by Institution and Region parent agents. The calling chain is shown in
-Figure 1, with the orange box representing a call through the ``cyclus::Trader``
-interface and a green box representing the ``cyclus::Agent`` interface.
+Figure 1, with the orange box representing a call through the ``Trader``
+interface and a green box representing the ``Agent`` interface.
 
 .. figure:: dre-1.svg
     :align: center
@@ -257,132 +376,203 @@ interface and a green box representing the ``cyclus::Agent`` interface.
         color = green
 	Region; Institution;
 	}
-      }    
+      }
 
 
 Black Box Examples
 ++++++++++++++++++
-
 For example, suppose that an agent prefers potential trades in which the bidder
-has the same parent agent as it does. A valid ``AdjustMatlPrefs`` implementation
+has the same parent agent as it does. A valid adjust material preferences implementation
 would then be:
 
+**C++:**
+
 .. code-block:: c++
 
-    virtual void FooFac::AdjustMatlPrefs(
-        cyclus::PrefMap<cyclus::Material>::type& prefs) {
+    virtual void FooFac::AdjustMatlPrefs(cyclus::PrefMap<cyclus::Material>::type& prefs) {
       cyclus::PrefMap<cyclus::Material>::type::iterator pmit;
       for (pmit = prefs.begin(); pmit != prefs.end(); ++pmit) {
         std::map<Bid<Material>*, double>::iterator mit;
         Request<Material>* req = pmit->first;
-	for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
+        for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
           Bid<Material>* bid = mit->first;
-	  if (parent() == bid->bidder()->manager()->parent())
-	    mit->second += 1; // bump pref if parents are equal
-	} 
+          if (parent() == bid->bidder()->manager()->parent())
+            mit->second += 1; // bump pref if parents are equal
+        }
       }
     }
 
-Alternatively, a ``cyclus::Institution`` managing a ``cyclus::Facility`` could
-adjust preferences as follows
+
+**Python:**
+
+.. code-block:: python
+
+    def adjust_material_prefs(self, prefs):
+        """The adjustment methods have a single argument which is a prefernce dictionary.
+        It maps (Request, Bid) tuples to float valued prefernces.  For example::
+
+            prefs = {
+                (Request1, Bid1): 1.0,
+                (Request1, Bid2): 2.0,
+                (Request2, Bid3): 1.0,
+                }
+
+        This function may return None or a dictionary of the same form. Note that the
+        return value does not need to have all of the same keys as were passed in. Rather,
+        it can return only those request-bid pairs that it actually wants to update.
+        """
+        # If you don't want to do any prefernce adjustment, just return None.
+        return None
+
+        # Otherwise we can loop though and update those that matter.
+        updates = {}
+        for (req, bid), pref in prefs.items():
+            # favor bids if the parents are the same
+            if self.parent_id == bid.bidder.parent_id:
+                updates[req, bid] = pref + 1.0
+        return updates
+
+
+Alternatively, an ``Institution`` managing a ``Facility`` could
+adjust preferences as follows:
+
+**C++:**
 
 .. code-block:: c++
 
-    virtual void FooInst::AdjustMatlPrefs(
-        cyclus::PrefMap<cyclus::Material>::type& prefs) {
+    virtual void FooInst::AdjustMatlPrefs(cyclus::PrefMap<cyclus::Material>::type& prefs) {
       cyclus::PrefMap<cyclus::Material>::type::iterator pmit;
       for (pmit = prefs.begin(); pmit != prefs.end(); ++pmit) {
         std::map<Bid<Material>*, double>::iterator mit;
         Request<Material>* req = pmit->first;
-	for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
+        for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
           Bid<Material>* bid = mit->first;
-	  Agent* you = bid->bidder()->manager()->parent();
-	  Agent* me = this;
-	  if (me == you)
-	    mit->second += 1; // bump pref if the parent is me (institutions are equal)
-	} 
+          Agent* you = bid->bidder()->manager()->parent();
+          Agent* me = this;
+         if (me == you)
+           mit->second += 1; // bump pref if the parent is me (institutions are equal)
+        }
       }
     }
 
-Finally, a ``cyclus::Region`` managing a ``cyclus::Institution`` could adjust
+
+**Python:**
+
+.. code-block:: python
+
+    def adjust_material_prefs(self, prefs):
+        updates = {}
+        for (req, bid), pref in prefs.items():
+            if self.id == bid.bidder.parent_id:
+                updates[req, bid] = pref + 1.0
+        return updates
+
+
+Finally, a ``Region`` managing a ``Institution`` could adjust
 preferences as
 
+**C++:**
+
 .. code-block:: c++
 
-    virtual void FooRegion::AdjustMatlPrefs(
-        cyclus::PrefMap<cyclus::Material>::type& prefs) {
+    virtual void FooRegion::AdjustMatlPrefs(cyclus::PrefMap<cyclus::Material>::type& prefs) {
       cyclus::PrefMap<cyclus::Material>::type::iterator pmit;
       for (pmit = prefs.begin(); pmit != prefs.end(); ++pmit) {
         std::map<Bid<Material>*, double>::iterator mit;
         Request<Material>* req = pmit->first;
-	for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
+        for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
           Bid<Material>* bid = mit->first;
-	  Agent* you = bid->bidder()->manager()->parent()->parent();
-	  Agent* me = this;
-	  if (me == you)
-	    mit->second += 1; // bump pref if the grandparent is me (regions are equal)
-	} 
+          Agent* you = bid->bidder()->manager()->parent()->parent();
+          Agent* me = this;
+          if (me == you)
+            mit->second += 1; // bump pref if the grandparent is me (regions are equal)
+        }
       }
     }
 
 
+**Python:**
+
+.. code-block:: python
+
+    def adjust_material_prefs(self, prefs):
+        updates = {}
+        for (req, bid), pref in prefs.items():
+            if self.id == bid.bidder.parent.parent_id:
+                updates[req, bid] = pref + 1.0
+        return updates
+
+
+
 White Box Examples
 ++++++++++++++++++
-
 Consider a scenario in which preferences will only be adjusted if the requester
 and bidder are of the same type:
 
+**C++:**
+
 .. code-block:: c++
 
-    virtual void FooFac::AdjustMatlPrefs(
-        cyclus::PrefMap<cyclus::Material>::type& prefs) {
+    virtual void FooFac::AdjustMatlPrefs(cyclus::PrefMap<cyclus::Material>::type& prefs) {
       cyclus::PrefMap<cyclus::Material>::type::iterator pmit;
       for (pmit = prefs.begin(); pmit != prefs.end(); ++pmit) {
         Request<Material>* req = pmit->first;
-	FooFac* cast = dynamic_cast<FooFac*>(req->requester()->manager());
-	if (cast != NULL) {
-  	  for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
-            mit->second = pref + 10; // we like this guy!
-	  }
+        FooFac* cast = dynamic_cast<FooFac*>(req->requester()->manager());
+        if (cast != NULL) {
+          for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
+            mit->second = pref + 10; // we like this trader!
+          }
         }
       }
     }
 
+
+**Python:**
+
+.. code-block:: python
+
+    def adjust_material_prefs(self, prefs):
+        updates = {}
+        for (req, bid), pref in prefs.items():
+            if not isinstance(req.requester, FooFac):
+                continue
+            updates[req, bid] = pref + 10.0  # we like this trader
+        return updates
+
+
 .. _solve:
 
 Solution Phase
 --------------
-
 The Solution Phase is straightforward from a module developer point of
 view. Given requests, bids for those requests, and preferences for each
-request-bid pairing, a ``cyclus::ExchangeSolver`` selects request-bid pairs to
+request-bid pairing, a ``ExchangeSolver`` selects request-bid pairs to
 satisfy and the quantity each resource to assign to each satisfied request-bid
 pairing. The solution times and actual pairings will depend on the concrete
-solver that is employed by the |cyclus| kernel. At present, only the
-``cyclus::GreedySolver`` is available.
+solver that is employed by the |cyclus| kernel.
 
 .. _trade:
 
 Trade Execution Phase
 ---------------------
-
 When satisfactory request-bid pairings are determined, a final communication is
 executed for each bidder and requester during the Trade Execution Phase. Bidders
-are notified of their winning bids through the ``cyclus::Trader`` ``Get*Trades``
-member function (e.g. ``GetMatlTrades``), and requesters are provided their
-satisfied requests through the ``cyclus::Trader`` ``Accept*Trades`` member
-function (e.g. ``AcceptMatlTrades``).
-
-Traders can implement a ``TradeResponse`` function that provides a
-``cyclus::Material::Ptr`` given a ``cyclus::Trade``. It can then implement its
+are notified of their winning bids through the ``Trader`` "get trades"
+functions (e.g. ``GetMatlTrades()`` in C++ and ``get_material_trades()`` in Python),
+and requesters are provided their
+satisfied requests through the ``Trader`` "accept trades"
+functions (e.g. ``AcceptMatlTrades()`` in C++ and ``accept_material_trades()`` in Python).
+
+By convention in C++, traders can implement a ``TradeResponse()`` function that provides a
+``Material::Ptr`` given a ``Trade``. It can then implement its
 Trader interface as follows:
 
+**C++:**
+
 .. code-block:: c++
 
-    void FooFac::GetMatlTrades(
-      const std::vector< cyclus::Trade<cyclus::Material> >& trades,
-      std::vector<std::pair<cyclus::Trade<cyclus::Material>,
-      cyclus::Material::Ptr> >& responses) {
+    void FooFac::GetMatlTrades(const std::vector< cyclus::Trade<cyclus::Material> >& trades,
+                               std::vector<std::pair<cyclus::Trade<cyclus::Material>, cyclus::Material::Ptr> >& responses) {
       using cyclus::Material;
       using cyclus::Trade;
 
@@ -394,48 +584,88 @@ Trader interface as follows:
       }
     }
 
-Similarly, Traders can implement an ``AcceptTrade`` function that accepts a
-``cyclus::Material::Ptr`` given a ``cyclus::Trade``. It can then implement its
+**Python:**
+
+.. code-block:: python
+
+    import cyclus.typesystem as ts
+
+    def get_material_trades(self, trades):
+        """In Python, the get trades functions take a single trades aregument and
+        should return a responses dict.  The trades is list of Trade objects, see the
+        cyclus.typesystem docs for more information.
+
+        The reponses should be a dict whose keys are these trades and whose values
+        are tracked resource instances. For example, Materials.
+        """
+        # here we respond with what the trade request was.
+        responses = {}
+        for trade in trades:
+            mat = ts.Material.create(self, trade.amt, trade.request.target.comp())
+            responses[trade] = mat
+        return responses
+
+
+Similarly, Traders can implement an "accept trade" function that accepts a
+the resources from a ``Trade``. It can then implement its
 Trader interface as follows:
 
+**C++:**
+
 .. code-block:: c++
 
-    void FooFac::AcceptMatlTrades(
-      const std::vector< std::pair<cyclus::Trade<cyclus::Material>,
-      cyclus::Material::Ptr> >& responses) {
-      std::vector< std::pair<cyclus::Trade<cyclus::Material>,
-          cyclus::Material::Ptr> >::const_iterator it;
+    void FooFac::AcceptMatlTrades(const std::vector< std::pair<cyclus::Trade<cyclus::Material>, cyclus::Material::Ptr> >& responses) {
+      std::vector< std::pair<cyclus::Trade<cyclus::Material>, cyclus::Material::Ptr> >::const_iterator it;
       for (it = responses.begin(); it != responses.end(); ++it) {
         AcceptTrade(it->second);
       }
     }
 
+
+**Python:**
+
+.. code-block:: python
+
+    def accept_material_trades(self, responses):
+        """In the Python interface, this accepts a responses dict that has the same format as
+        the responses returned from get_material_trades() above. That is, responses maps
+        Trades to Materials. This function is responsible for storing these traded materails
+        somewhere in the agent's inventories. This is the end of the dynamic resource
+        exchange and so this function shouldn't return anything.
+        """
+        for mat in responses.values():
+            self.inventory.push(mat)
+
+
 The implementation logic for each of these functions is determined by how each
 individual agent handles their resource inventories. Accordingly, their
 implementation will be unique to each agent. Some initial examples can be found
-in the ``cyclus::Source`` and ``cyclus::Sink`` agents, where ``cyclus::Source``
-implements ``GetMatlTrades`` as a bidder and ``cyclus::Sink`` implements
-``AcceptMatlTrades`` as a requester.
+in the ``Source`` and ``Sink`` agents, where ``Source``
+implements ``GetMatlTrades()`` or ``get_material_trades()`` as a bidder and ``Sink``
+implements ``AcceptMatlTrades()`` or ``accept_material_trades()`` as a requester.
 
 .. _examples:
 
 Examples
 --------
 
-Mixin-based Trader Behavior
-+++++++++++++++++++++++++++
+Mixin-based Trader Behavior [C++]
++++++++++++++++++++++++++++++++++
+
+.. note:: The Python interface can easily handle mix-in behavior for
+          Python agents via subclassing and using ``super()`` on any agent.
 
 Trader behavior can be specialized based on mixins that an archetype uses. For
 example, consider an interface that helps determines preferences based on
 the equality of the parent of a ``cyclus::Agent``.
 
 .. code-block:: c++
- 
+
   class PrefGetter {
    public:
     double GetPref(cyclus::Agent* mine, cyclus::Agent* yours) {
        return (mine == yours) ? 1 : 0.5;
-    } 
+    }
   };
 
 A trader who then wants behavior based on whether a bidder's manager inherits
@@ -443,29 +673,24 @@ from ``PrefGetter`` can then implement its preference adjustment as follows:
 
 .. code-block:: c++
 
-    virtual void FooFac::AdjustMatlPrefs(
-        cyclus::PrefMap<cyclus::Material>::type& prefs) {
-
+    virtual void FooFac::AdjustMatlPrefs(cyclus::PrefMap<cyclus::Material>::type& prefs) {
       cyclus::PrefMap<cyclus::Material>::type::iterator pmit;
       for (pmit = prefs.begin(); pmit != prefs.end(); ++pmit) {
-
         std::map<Bid<Material>*, double>::iterator mit;
         Request<Material>* req = pmit->first;
-	cyclus::Agent* reqagent = req->requester()->manager();
-	for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
-
+        cyclus::Agent* reqagent = req->requester()->manager();
+        for (mit = pmit->second.begin(); mit != pmit->second.end(); ++mit) {
           Bid<Material>* bid = mit->first;
-	  cyclus::Agent* bidagent = bid->bidder()->manager();
-	  PrefGetter* pg_cast = dynamic_cast<PrefGetter*>(bidagent);
-
-	  if (pg_cast != NULL) {
-	    // special behavior for the mixin
-	    mit->second = cast->GetPref(reqagent->parent(), 
-	                                bidagent->parent()); 
-	  } else {
-	    mit->second = 0; // choose any (reasonable) default behavior
-	  }
-	} 
+          cyclus::Agent* bidagent = bid->bidder()->manager();
+          PrefGetter* pg_cast = dynamic_cast<PrefGetter*>(bidagent);
+          if (pg_cast != NULL) {
+            // special behavior for the mixin
+            mit->second = cast->GetPref(reqagent->parent(),
+                                        bidagent->parent());
+          } else {
+            mit->second = 0; // choose any (reasonable) default behavior
+          }
+        }
       }
     }
 
@@ -485,27 +710,30 @@ from ``PrefGetter`` can then implement its preference adjustment as follows:
 
 .. _white_box:
 
-Non-Black Box Behavior
-+++++++++++++++++++++++++++
+Non-Black Box Behavior [C++]
+++++++++++++++++++++++++++++
+
+.. note:: The Python interface can trivially handle non-black box behavior for
+          Python agents by using ``isinstance()`` on any agent.
 
 Cyclus provides a simulation framework that supports black-box entity
 interaction, i.e., any entity in the simulation can interact with any other
-entity through its ``cyclus::Agent`` interface. However, there is nothing
+entity through its ``Agent`` interface. However, there is nothing
 stopping an archetype developer from implementing logic that is specific to a
 implemented archetype.
 
 For example, take a facility that informs a trader what composition of material
-it wants given another facility's inventory. 
+it wants given another facility's inventory.
 
 .. code-block:: c++
- 
+
   class TradeInformer: public cyclus::Facility {
    public:
     #pragma cyclus
 
     cyclus::Material::Ptr IdealMatl(const cyclus::toolkit::ResBuf& buffer) {
        // provide whatever implementation is desired
-    } 
+    }
   };
 
 A provider of material can then implement its ``GetMatlBids`` as follows:
@@ -527,16 +755,16 @@ A provider of material can then implement its ``GetMatlBids`` as follows:
       std::vector<Request<Material>*>::iterator it;
       for (it = requests.begin(); it != requests.end(); ++it) {
         Material::Ptr offer;
-	Agent* agent = it->requester();
-	TradeInformer* cast = dynamic_cast<TradeInformer*>(agent);
-	if (cast != NULL) {
-	    offer = cast->IdealMatl(inventory); // inventory is a state variable ResBuf
-	} else { 
-	    double qty = it->quantity();     
-      	    std::string recipe = "recipe";
-      	    Material::Ptr offer = Material::CreateUntracked(qty, context()->GetRecipe(recipe));
-	}	    
-	port->AddBid(*it, offer, this);
+        Agent* agent = it->requester();
+        TradeInformer* cast = dynamic_cast<TradeInformer*>(agent);
+        if (cast != NULL) {
+          offer = cast->IdealMatl(inventory); // inventory is a state variable ResBuf
+        } else {
+          double qty = it->quantity();
+          std::string recipe = "recipe";
+          Material::Ptr offer = Material::CreateUntracked(qty, context()->GetRecipe(recipe));
+        }
+        port->AddBid(*it, offer, this);
       }
 
       std::set<BidPortfolio<Material>::Ptr> ports;
@@ -546,6 +774,5 @@ A provider of material can then implement its ``GetMatlBids`` as follows:
 
 Further Reading
 ---------------
-
 For a more in depth (and historical) discussion, see `CEP 18
 <http://fuelcycle.org/cep/cep18.html>`_.
diff --git a/source/arche/dynamic_loading.rst b/source/arche/dynamic_loading.rst
index 5bbf41d71..1d152e6b5 100644
--- a/source/arche/dynamic_loading.rst
+++ b/source/arche/dynamic_loading.rst
@@ -1,5 +1,4 @@
-Dynamic Loading Overview
-========================
+Dynamic Loading Overview========================
 
 *Dynamic loading* is a term used to describe the action of loading
 libraries at run time. This implies that knowledge of the structure
@@ -8,8 +7,9 @@ the executing program. In Linux, these libraries are denoted by the
 suffix '.so', in Windows, '.dll', and in OSX, '.dylib'.
 
 In |cyclus|, every *module* is dynamically loaded. Modules include one or more
-*agents*.
+*agents*.  Python moduels that contain archetypes are loaded dynamically by
+|cyclus|'s loading system, which itself call out to Python's import mechanism.
 
 The internal process used by the |cyclus| core is very close to that
-described in this 
+described in this
 `article <http://www.linuxjournal.com/article/3687>`_.
diff --git a/source/arche/errors.rst b/source/arche/errors.rst
index c00a6a4eb..9d17ef2cc 100644
--- a/source/arche/errors.rst
+++ b/source/arche/errors.rst
@@ -1,11 +1,12 @@
-Errors and Warnings
-===================
-
+Errors and Warnings [C++]
+=========================
 Module developers may also leverage the |Cyclus| error and warning system
 within the code that they write. These are useful for failing gracefully from
 undefined behavior or to signal that code is still experimental and under
 development.
 
+.. note:: Python agents should just use the Python error and warning system.
+
 Errors
 ------
 
@@ -23,7 +24,7 @@ live within the ``cyclus`` namespace and subclass from ``std::exception``.
 .. table:: **Table I.** Cyclus Error Classes
     :widths: 1 9
     :column-alignment: left left
-    :column-wrapping: true true 
+    :column-wrapping: true true
     :column-dividers: none single none
 
     =============== ==============================================================
@@ -31,7 +32,7 @@ live within the ``cyclus`` namespace and subclass from ``std::exception``.
     =============== ==============================================================
     Error           Base error for |Cyclus|.
     ValueError      For values that are too big, too small, etc.
-    KeyError        For failed retrieval/insertion of key-based data into/from 
+    KeyError        For failed retrieval/insertion of key-based data into/from
                     data structures.
     StateError      For failed object state expectations.
     IOError         For failed reading/writing to files, network connections, etc.
@@ -75,7 +76,7 @@ warning that was given.  All warnings are issued through the
 .. table:: **Table II.** Cyclus Warnings
     :widths: 3 7
     :column-alignment: left left
-    :column-wrapping: true true 
+    :column-wrapping: true true
     :column-dividers: none single none
 
     =========================== =================================================
@@ -83,22 +84,22 @@ warning that was given.  All warnings are issued through the
     =========================== =================================================
     WARNING                     Basic warning for |Cyclus|.
     VALUE_WARNING               For values that are too big, too small, etc.
-    KEY_WARNING                 For unexpected retrieval/insertion of key-based 
+    KEY_WARNING                 For unexpected retrieval/insertion of key-based
                                 data into/from data structures.
     STATE_WARNING               For unexpected object state.
-    IO_WARNING                  For unexpected reading/writing to files, network 
+    IO_WARNING                  For unexpected reading/writing to files, network
                                 connections, etc.
     CAST_WARNING                For unexpected casts.
-    VALIDATION_WARNING          For validating files received via I/O or for 
-                                indicating that the software has not been 
+    VALIDATION_WARNING          For validating files received via I/O or for
+                                indicating that the software has not been
                                 properly benchmarked.
     DEPRECATION_WARNING         For features, behaviors, or APIs that are no
-                                longer supported. Expect removal in future 
+                                longer supported. Expect removal in future
                                 releases.
-    PENDING_DEPRECATION_WARNING For features, behaviors, or APIs that are 
+    PENDING_DEPRECATION_WARNING For features, behaviors, or APIs that are
                                 candidates for future deprecation.
-    EXPERIMENTAL_WARNING        For features, behaviors, or APIs that are not 
-                                considered stable. Reasons for instability may 
+    EXPERIMENTAL_WARNING        For features, behaviors, or APIs that are not
+                                considered stable. Reasons for instability may
                                 include a lack of benchmarking, uncertainty about
                                 future needs, or known future API changes.
     =========================== =================================================
@@ -107,7 +108,7 @@ warning that was given.  All warnings are issued through the
 
     <br />
 
-Revisiting the reactor error example from above, we could have issued a 
+Revisiting the reactor error example from above, we could have issued a
 warning instead.
 
 **Warning example:**
@@ -121,7 +122,7 @@ warning instead.
 
 Warnings have a number of advantages over errors.  The first is that since
 they do not stop the process they are fast to issue. They are also a great way
-for communicating with users the expectations of using your module. 
+for communicating with users the expectations of using your module.
 
 Warnings also have two command line options that users can provide which
 modify their behavior.  The first is ``--warn-limit``.  This changes the
diff --git a/source/arche/hello_world.rst b/source/arche/hello_world_cpp.rst
similarity index 69%
rename from source/arche/hello_world.rst
rename to source/arche/hello_world_cpp.rst
index 6a01afffb..eca8b4f55 100644
--- a/source/arche/hello_world.rst
+++ b/source/arche/hello_world_cpp.rst
@@ -1,15 +1,15 @@
 .. _hello_world:
 
-Hello, Cyclus!
-==============
-This pages walks you through a very simple hello world example using 
-|cyclus| agents.  First make sure that you have the dependencies installed, 
+Hello, Cyclus! [C++]
+====================
+This pages walks you through a very simple hello world example using
+|cyclus| agents.  First make sure that you have the dependencies installed,
 namely |Cyclus|, CMake, and a recent version of Python (2.7 or 3.3+).
 
-First, you need to get the ``cycstub`` code.  Cycstub is a skeleton code base 
+First, you need to get the ``cycstub`` code.  Cycstub is a skeleton code base
 that you can use to quick-start new |cyclus| module development projects.
-You can grab cycstub either by using git to 
-`clone the repository <https://github.com/cyclus/cycstub.git>`_ or by 
+You can grab cycstub either by using git to
+`clone the repository <https://github.com/cyclus/cycstub.git>`_ or by
 `downloading the zip file <https://github.com/cyclus/cycstub/archive/develop.zip>`_.
 Let's put this code in a ``tutorial`` directory and go into it.
 
@@ -66,9 +66,9 @@ Change the original functions to look like:
 
 ------------
 
-Now that we have altered the behavior of the TutorialFacility, let's compile and 
+Now that we have altered the behavior of the TutorialFacility, let's compile and
 install the ``tutorial`` project.  This done with the install.py script.
-The install script puts the project into your cyclus userspace, 
+The install script puts the project into your cyclus userspace,
 ``${HOME}/.local/lib/cyclus``.
 
 .. code-block:: bash
@@ -84,33 +84,33 @@ an :file:`example.xml`. Running |cyclus| on this file with the command
 .. code-block:: bash
 
     tutorial $ cyclus input/example.xml
-                  :                                                               
-              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q   
-            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)  
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
             CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
          CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
-         iCCCt  ;;;;;.  CCCC                                                      
-        CCCC  ;;;;;;;;;. CClL.                          c                         
-       CCCC ,;;       ;;: CCCC  ;                   : CCCCi                       
-        CCC ;;         ;;  CC   ;;:                CCC`   `C;                     
-      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;   
-      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;  
-       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .      
-      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.    
-      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:  
-       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;  
-      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;  
-      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;  
-        CCl ;;             CC    ;;;;              CCC    CCL                     
-       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.                      
-        CCCC  ;;     :;; CCCCf  ;                     ,L                          
-         lCCC   ;;;;;;  CCCL                                                      
-         CCCCCC  :;;  fCCCCC                                                      
-          . CCCC     CCCC .                                                       
-           .CCCCCCCCCCCCCi                                                        
-              iCCCCCLCf                                                           
-               .  C. ,                                                            
-                  :                                                               
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
     Hello, World!
     Hello, World!
     Hello, World!
diff --git a/source/arche/hello_world_py.rst b/source/arche/hello_world_py.rst
new file mode 100644
index 000000000..1d7345324
--- /dev/null
+++ b/source/arche/hello_world_py.rst
@@ -0,0 +1,130 @@
+.. _hello_world:
+
+Hello, Cyclus! [Python]
+=======================
+This pages walks you through a very simple hello world example using
+|cyclus| agents.  First make sure that you have the dependencies installed,
+namely |Cyclus| and a recent version of Python (2.7 or 3.5+).
+
+|Cyclus| can read agents from any normal python package and module. If you are unsure of
+how to start and install a Python project, please see the Python documentation. There are
+also many high-quality guides and tools online. Here, we will assume that there is a
+project called ``proj`` that has a module called ``agents`` that contains an archetype
+class called ``MyFacility``.
+
+To start writing ``MyFacility``, open up ``agents.py``, import ``cyclus.agents``,
+anf write the following:
+
+**proj/agents.py:**
+
+.. code-block:: Python
+
+    from cyclus.agents import Facility
+
+    class MyFacility(Facility):
+        """My first Cyclus archetype!"""
+
+
+And that is it! The above is a fully-functional |Cyclus| facility.
+
+------------
+
+Let's now change the behavior of the MyFacility's ``tick()`` and
+``tock()`` methods to print "Hello" and "World" respectively.
+
+**proj/agents.py:**
+
+.. code-block:: Python
+
+    from cyclus.agents import Facility
+
+    class MyFacility(Facility):
+        """My first Cyclus archetype!"""
+
+        def tick(self):
+            print("Hello,")
+
+        def tock(self):
+            print("World!")
+
+
+Now that we have altered the behavior of the TutorialFacility, reinstall the project
+so that it is available to cyclus.
+
+------------
+
+You can refer to this facilty in a |cyclus| input file by using the Python package and
+module name in the lib section of the archetypes spec, like you would write it if you
+were importing a module.  The class name goes in the
+name section of the spec.
+
+.. code-block:: xml
+
+    <archetypes>
+      <spec><lib>proj.agents</lib><name>MyFacility</name></spec>
+    </archetypes>
+
+------------
+
+Let's run |cyclus| with this example! In the input directory there is
+an :file:`example.xml`. First modify it to point to the archetype we just wrote.
+Running |cyclus| on this file with the command
+``cyclus input/example.xml`` should produce the following output.
+
+.. code-block:: bash
+
+    tutorial $ cyclus input/example.xml
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
+            CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
+         CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+    Hello,
+    World!
+
+    Status: Cyclus run successful!
+    Output location: cyclus.sqlite
+    Simulation ID: 0ae730e0-a9a8-4576-afaa-d1db6399d5a2
+
+If you look in the input file you'll see that the simulation duration was set
+to 10.  This is why "Hello, World!" is printed ten times.
diff --git a/source/arche/index.rst b/source/arche/index.rst
index f2698479f..bd53f8192 100644
--- a/source/arche/index.rst
+++ b/source/arche/index.rst
@@ -43,13 +43,15 @@ Installation
     ../user/install
 
 Hello World
------------
+-----------------
 
 .. toctree::
     :maxdepth: 1
-    
-    hello_world
-    tour
+
+    hello_world_cpp
+    tour_cpp
+    hello_world_py
+
 
 Writing Agents & Modules
 ------------------------
@@ -59,16 +61,17 @@ Tutorial
 
 .. toctree::
     :maxdepth: 1
-    
-    tutorial/index
 
-Building, Installing and Testing
-++++++++++++++++++++++++++++++++
+    tutorial_cpp/index
+    tutorial_py/index
+
+Building, Installing and Testing [C++]
+++++++++++++++++++++++++++++++++++++++
 
 .. toctree::
     :maxdepth: 1
 
-    cmake    
+    cmake
     cycpp
     testing
 
@@ -77,7 +80,7 @@ Interfacing with the |Cyclus| Kernel
 
 .. toctree::
     :maxdepth: 1
-    
+
     timestep
     resources
     dre
@@ -89,7 +92,6 @@ Interfacing with the |Cyclus| Kernel
 
 A Word About Style
 ++++++++++++++++++
-
 Having a consistent style in your code is important. Python has a great style
 guide encapsulated in `PEP8 <http://legacy.python.org/dev/peps/pep-0008/>`_. As
 our code base is mostly C++, the kernel development team follows the `Google C++
diff --git a/source/arche/logger.rst b/source/arche/logger.rst
index 7f3137f86..487d4bca7 100644
--- a/source/arche/logger.rst
+++ b/source/arche/logger.rst
@@ -15,7 +15,7 @@ provide this functionality.  The Logger class should generally not be accessed
 directly.  The macro returns a string stream object that can be used exactly
 as `std::cout` for printing output.  Streamed in content is flushed to stdout
 as soon as execution passes beyond the terminating semi-colon of the log
-statement.  
+statement.
 
 A brief description of when to use which log level is given with the LogLevel
 enum doxygen documentation. The following is a summary:
@@ -43,7 +43,7 @@ enum doxygen documentation. The following is a summary:
 Developers working on agents set the LOG prefix argument to a unique
 archetype/agent-specific identifier (up to 6 characters long).  This will allow
 developers to more easily filter the logger output in order to isolate
-information most relevant to their work. 
+information most relevant to their work.
 
 This macro does a check on the given LogLevel 'level' argument; if the
 specified level is not higher than or equal to the report-level cutoff, the
@@ -51,8 +51,10 @@ macro does nothing, limiting the performance impact of logging statements.
 
 .. warning::
 
-  Do NOT place any state-changing expressions with the LOG 
-  macro as they may not run if the report level excludes the specified LogLevel.  
+  Do NOT place any state-changing expressions with the LOG
+  macro as they may not run if the report level excludes the specified LogLevel.
+
+.. note:: The Python interface should use the Python standard library logging system.
 
 Examples
 --------
@@ -65,11 +67,11 @@ Examples
 
     LOG(LEV_ERROR, "prefix") << "This is my error statement. "
                              << "and more info...";
-    
+
     LOG(LEV_DEBUG2, "prefix") << "This is my first debug statement. "
-                              << "and more info...";  
+                              << "and more info...";
     LOG(LEV_DEBUG1, "prefix") << "This is another debug statement. "
-                              << "and more info...";  
+                              << "and more info...";
   }
 
 The command-line specified verbosity is used to determine the logger
@@ -86,9 +88,9 @@ executed. An example of what NOT to do follows:
 
 .. code-block:: cpp
 
-  LOG(LEV_DEBUG2, "module name") << "The expression myobject.setName(newname): " 
-                                 << myobject.setName(newname) 
-                                 << " might not ever execute" 
-                                 << " depending on the verbosity level."; 
+  LOG(LEV_DEBUG2, "module name") << "The expression myobject.setName(newname): "
+                                 << myobject.setName(newname)
+                                 << " might not ever execute"
+                                 << " depending on the verbosity level.";
 
 
diff --git a/source/arche/resources.rst b/source/arche/resources.rst
index 6911ea929..cd552343f 100644
--- a/source/arche/resources.rst
+++ b/source/arche/resources.rst
@@ -1,4 +1,3 @@
-
 Resources
 ==========
 
@@ -27,16 +26,27 @@ resource objects (including creation) are tracked and recorded in the
 database.  Because of this, agents should handle resources carefully.  For
 more details about this, see :ref:`tracked-untracked`.
 
-All resource objects are created and managed as pointer types. For
+In C++, all resource objects are created and managed as pointer types. For
 convenience, each of the classes related to resources have a special pointer
-type defined:
+type defined. In Python, they each have their own class that this available
+in the ``cyclus.typesystem`` module.
+
+**C++:**
 
 .. code-block:: c++
 
     cyclus::Resource::Ptr r;
     cyclus::Product::Ptr p;
     cyclus::Material::Ptr m;
-    cyclus::Composition::Ptr c;
+
+**Python:**
+
+.. code-block:: python
+
+    import cyclus.typesystem as ts
+    ts.Resource
+    ts.Product
+    ts.Material
 
 These pointer types should be always be used instead of plain class instances
 or raw pointers.  The following sections describe basic creation and
@@ -45,6 +55,8 @@ terms of the ``cyclus::Resource`` superclass.  So it will sometimes be
 necessary to cast down to the appropriate resource subclass.  |Cyclus| provides
 an overloaded ResCast function for casting convenience:
 
+**C++*:*
+
 .. code-block:: c++
 
     // r is a Material object stored in a cyclus::Resource::Ptr var
@@ -55,13 +67,17 @@ an overloaded ResCast function for casting convenience:
     ...
     std::vector<cyclus::Product::Ptr> ps = cyclus::ResCast<Product>(rs);
 
+In Python, the situation is much simpler and you should only need to use ``Product`` and
+``Material`` directly. They both inherit from ``Resource``.
+
+
 Product Resources
 -------------------
 
 Products in |Cyclus| have a quantity (no particular units) and a quality.
-The quality is a ``std::string`` that describes what the product is.  A
-product's quality might be "apples", "kg apples", "man-hours", etc.  Product
-resources with different qualities may NOT be combined together.  
+The quality is a ``std::string`` (C++) or ``str`` (Python) that describes what
+the product is. A product's quality might be "apples", "kg apples", etc. Product
+resources with different qualities may NOT be combined together.
 
 There are 3 basic operations that can be performed on product resources
 (examples follow):
@@ -70,6 +86,8 @@ There are 3 basic operations that can be performed on product resources
 * Extract
 * Absorb
 
+**C++:**
+
 .. code-block:: c++
 
     // create a "grapes" product holding 100 grapes.
@@ -83,14 +101,31 @@ There are 3 basic operations that can be performed on product resources
     p1->Absorb(p2);
     // p2 now has 0 grapes. p1 has 100 grapes.
 
+
+**Python:**
+
+.. code-block:: python
+
+    # create a "grapes" product holding 100 grapes.
+    p1 = ts.Product.create(100, "grapes")
+
+    # extract 7 grapes from p1
+    p2 = p1.extract(7)
+    # p1 now has 93 grapes
+
+    # combine p2 back into p1
+    p1.absorb(p2)
+    # p2 now has 0 grapes. p1 has 100 grapes.
+
+
 Material Resources
 -------------------
-
 Materials in |Cyclus| have a mass and an associated nuclide composition.  The
-composition is represented by a  ``cyclus::Composition`` object.  Material
+composition is represented by a  ``cyclus::Composition`` object (C++) or dict of
+nuclide keys (str or int), float values (Python).  Material
 quantity is always represented in units of kg. Agents can either create a
 composition manually (see the *Compositions* section below) or acquire one from
-their ``cyclus::Context`` which holds all recipes defined as part of the
+their Context which holds all recipes defined as part of the
 simulation input.
 
 There are 4 basic operations that can be performed on material resources
@@ -102,6 +137,8 @@ There are 4 basic operations that can be performed on material resources
 * Transmute
 * Decay (EXPERIMENTAL) - which is a special case of the Transmute operation
 
+**C++:**
+
 .. code-block:: c++
 
     cyclus::Composition::Ptr c1 = context()->GetRecipe("nat_u");
@@ -126,18 +163,47 @@ There are 4 basic operations that can be performed on material resources
     // decay composition m1 up to the current time step (EXPERIMENTAL)
     m1->Decay(); // EXPERIMENTAL
 
+**Python:**
+
+.. code-block:: python
+
+    c1 = self.context.get_recipe("nat_u")
+    c2 = self.context.get_recipe("enriched_u")
+
+    # create a 100 kg material from the nat_u recipe defined in the input file
+    m1 = ts.Material.create(self, 100, c1)
+
+    # extract 1 kg of enriched U from m1
+    m2 = m1.extract_comp(1, c2)
+    # mass of m1 is now 99 kg and its composition has changed
+
+    # extract 1 kg from m1 of whatever composition it is
+    m3 = m1.ExtractQty(1)
+    # mass of m1 is now 98 kg and its composition. m1 and m3 have the same composition
+
+    # combine m2 and m3 back into m1
+    m1.absorb(m2)
+    m1.absorb(m3)
+    # m2 and m3 now have mass 0 kg. m1 has mass 100 kg with its original nat_u composition
+
+    # decay composition m1 up to the current time step (EXPERIMENTAL)
+    m1.decay()  # EXPERIMENTAL
+
+
 .. warning::
 
     Decay functionality as currently implemented is experimental and may not
     be correct.
 
-Compositions
-++++++++++++++
+Compositions in C++
+++++++++++++++++++++
 
 A ``cyclus::Composition`` is a massless, immutable nuclide composition.
 Because it is immutable, a mutable ``cyclus::CompMap`` must be populated in
 order to create a composition:
 
+**C++:**
+
 .. code-block:: c++
 
     cyclus::CompMap m;
@@ -160,11 +226,31 @@ compositions from equivalent ``cyclus::CompMap`` objects.  Reusing
 ``cyclus::Composition`` objects helps avoid duplicate records in the
 database and redundant decay calculations.
 
+
+Compositions in Python
++++++++++++++++++++++++
+Compositions in Python are much simplier than in C++. They are represented by a simple
+dict of nuclides to values. When a Material is created, you have to declare whether
+the composition has a mass or atom basis.  By default it has a mass basis, though
+you may pass in the string ``"atom"`` to obtain an atom basis.
+
+**Python:**
+
+.. code-block:: python
+
+    # 5% U235, 95% U238 by mass
+    m = {922350000: 5, 922380000: 95}
+    mat_mass = ts.Material.create_untracked(10, m)
+
+    # 5% U235, 95% U238 by atom fraction
+    a = {"U235": 5, "U238": 95}
+    mat_atom = ts.Material.create_untracked(10, a, basis="atom")
+
+
 .. _resource-ids:
 
 Resource IDs
 ---------------
-
 Every resource object has 3 different IDs.  One of them, the ``qual_id``, is
 generally not of use to agent developers and can be ignored.  The other two
 serve two different purposes, and it is important to understand their
@@ -184,6 +270,8 @@ difference:
 
 Here are some examples of how these IDs work:
 
+**C++:**
+
 .. code-block:: c++
 
     cyclus::Product::Ptr p1 = cyclus::Product::Create(this, 10, "bananas");
@@ -209,6 +297,34 @@ Here are some examples of how these IDs work:
     rsrc_labels[p2->obj_id()] = "fruit";
     ...
 
+**Python:**
+
+.. code-block:: python
+
+    # p1 gets new separate state_id and obj_id
+    p1 = ts.Product.create(self, 10, "bananas")
+
+    # p1 gets new state_id and keeps same obj_id
+    # p2 gets new separate state_id and obj_id
+    p2 = p1.extract_qty(3)
+
+    # p1 gets new state_id and keeps same obj_id
+    # p2 gets new state_id and keeps same obj_id
+    p1.absorb(p2)
+
+    # no new resource object is created, p1 and p1_dup point to same resource object.
+    # In Python this is just an increase in the refcount anyway.
+    # p1 keeps same state_id and same obj_id
+    # p1 and p1_dup have idential state_id's
+    # p1 and p1_dup have idential obj_id's
+    p1_dup = p1
+
+    # want to associate some label with resource objects? Use the obj_id.
+    rsrc_labels = {}
+    rsrc_labels[p1.obj_id] = "fruit"
+    rsrc_labels[p2.obj_id] = "fruit"
+    ...
+
 .. warning::
 
     When associating information with resources like the ``rsrc_labels``
@@ -216,11 +332,11 @@ Here are some examples of how these IDs work:
     ``std::map<cyclus::Resource::Ptr, std::string>``).  Pointers are unstable
     and change across simulation snapshot+restart.
 
+
 .. _tracked-untracked:
 
 Tracked and Untracked Resources
 ---------------------------------
-
 All changes to normal resource objects (including creation, splitting,
 trasmutation, etc.) are tracked and recorded in the database.  By default, all
 resources are **tracked resources**.  Because of this, agents should handle
@@ -239,6 +355,8 @@ Just like the functions for creating trakced resources, there are
 corresponding function for creating both untracked materials and untracked
 products:
 
+**C++:**
+
 .. code-block:: c++
 
     cyclus::Composition::Ptr c = context()->GetRecipe("enriched_u");
@@ -251,6 +369,21 @@ products:
 
     // nothing about m1 and p1 will ever be recorded in the output data.
 
+
+**Python:**
+
+.. code-block:: python
+
+    c = self.context.get_recipe("enriched_u")
+
+    # create an untracked 100 kg material from c (the enriched_u recipe)
+    m1 = ts.Material.create_untracked(100, c)
+
+    # create an untracked "grapes" product holding 100 grapes.
+    p1 = ts.Product.create_untracked(100, "grapes")
+
+    # nothing about m1 and p1 will ever be recorded in the output data.
+
 .. warning::
 
     When a need for placeholder, dummy, or otherwise untracked
diff --git a/source/arche/sim_init.rst b/source/arche/sim_init.rst
index 702099589..c9e09d0de 100644
--- a/source/arche/sim_init.rst
+++ b/source/arche/sim_init.rst
@@ -1,7 +1,5 @@
-
 Initialization and Restart
 ============================
-
 |Cyclus| has built-in functionality for simulation snapshotting and restart.
 All simulations are initialized from the database.  In order to support
 running from XML input files, the |Cyclus| kernel translates the input file
diff --git a/source/arche/timestep.rst b/source/arche/timestep.rst
index f9b5ea379..8f9ca17d1 100644
--- a/source/arche/timestep.rst
+++ b/source/arche/timestep.rst
@@ -18,7 +18,9 @@ The list of phases in order is:
 * :ref:`tock` (agent)
 * :ref:`decom` (kernel)
 
-Agent phases are invoked using a method call of the same name, e.g., 
+Agent phases are invoked using a method call of the same name, e.g.,
+
+**C++:**
 
 .. code-block:: c++
 
@@ -26,6 +28,13 @@ Agent phases are invoked using a method call of the same name, e.g.,
       // perform agent-phase Tick's work
     }
 
+**Python:**
+
+.. code-block:: python
+
+    def tick(self):
+        # perform agent-phase tick's work, no return value
+
 Importantly, the order in which agents' agent-phase methods are invoked is *not
 guaranteed*. In other words, the execution of any given phase is conceptually
 occurring *simultaneously among agents*.
@@ -40,6 +49,8 @@ support approximately 1-month time steps), then they should throw an
 exception as early as possible (i.e. in their constructor).  The time step
 duration can be queried from an the simulation context:
 
+**C++:**
+
 .. code-block:: c++
 
     virtual void MyAgent::Tick() {
@@ -48,6 +59,15 @@ duration can be queried from an the simulation context:
         ...
     }
 
+**Python:**
+
+.. code-block:: python
+
+    def tick(self):
+        ...
+        discharge_qty = self.discharge_rate * self.context.dt
+        ...
+
 .. _build:
 
 Build Phase
diff --git a/source/arche/toolkit.rst b/source/arche/toolkit.rst
index 53c0a564e..ec09b5cb2 100644
--- a/source/arche/toolkit.rst
+++ b/source/arche/toolkit.rst
@@ -2,28 +2,31 @@
 
 The (Experimental) Cyclus Toolkit
 =================================
-
 Currently in an experimental state, the |cyclus| toolkit aims to provide
 functionality relevant to a variety of :term:`archetypes <archetype>` that do
 not belong strictly in the :term:`cyclus kernel`.
 
-Resourcebuff
+ResourceBuff
 ++++++++++++
-
 .. warning::
 
     ResourceBuff will soon be deprecated in favor of ``ResBuf``.
 
-The ``cyclus::toolkit::ResourceBuff`` class provides provides a canonical
-methodology for dealing with collections of ``cyclus::Resources``.
+The ``cyclus::toolkit::ResourceBuff`` (C++) or ``cyclus.typesystem.ResourceBuff`` (Python)
+class provides provides a canonical
+methodology for dealing with collections of ``Resources``.
 :term:`Archetypes <archetype>` in both |cyclus| and Cycamore make use of this
-class.  ``ResourceBuff``\ s are usually used as member variables of
-archetypes.  The Cyclus preprocessor has special handling for ``ResourceBuff``
-\ - it can generate all needed code for proper persistence and intiialization
-of the buffer.  For this to work, you must annotate the buffer member variable
-with a Cyclus pre-processor :ref:`pragma <pragma-cyclus-var>` in one of the
+class.  ``ResourceBuffs`` are usually used as member variables of
+archetypes.  The |Cyclus| preprocessor (C++) or |Cyclus| agents (Python) have special
+handling for ``ResourceBuff``
+as it can generate all needed code for proper persistence and intiialization
+of the buffer. For this to work, you must annotate the buffer member variable
+with a Cyclus pre-processor :ref:`pragma <pragma-cyclus-var>` (C++) or have a
+special ``ResourceBuffInv`` class attribute (Python) in one of the
 following ways:
 
+**C++:**
+
 .. code-block:: c++
 
     // Option 1: minimum required annotation
@@ -41,20 +44,42 @@ following ways:
     #pragma cyclus var {'capacity': 'buf_cap'}
     cyclus::toolkit::ResourceBuff mybuf;
 
+**Python:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+    import cyclus.typesystem as ts
+
+    class MyFacility(Facility):
+        # Option 1: minimum required class attribute
+        mybuf = ts.ResourceBuffInv()
+
+        # Option 2: you can set a specify buffer capacity
+        mybuf = ts.ResourceBuffInv(capacity=245.6)
+
+        # Option 3: you can reference another annotated member variable's value
+        # as the capacity
+        buf_cap = ts.Double()
+        mybuf = ts.ResourceBuffInv(capacity='buf_cap')
+
 You can read the `ResourceBuff API documentation
 <http://fuelcycle.org/cyclus/api/classcyclus_1_1toolkit_1_1ResourceBuff.html>`_ for
 more details on how to use the buffer.
 
 ResBuf
 ++++++++++++
-
-The ``cyclus::toolkit::ResBuf`` class provides provides a canonical
-methodology for dealing with collections of Resources.  ``ResBuf``\ s
+The ``cyclus::toolkit::ResBuf`` (C++) or ``cyclus.typesystem.ResBuf`` (Python) class
+provides provides a canonical
+methodology for dealing with collections of Resources.  ``ResBufs``
 are usually used as member variables of archetypes.  The Cyclus preprocessor
-has special handling for ``ResBuf`` - it can generate all needed code
+has special handling for ``ResBuf`` as it can generate all needed code
 for proper persistence and intiialization of the buffer.  For this to work,
 you must annotate the buffer member variable with a Cyclus pre-processor
-:ref:`pragma <pragma-cyclus-var>` in one of the following ways:
+:ref:`pragma <pragma-cyclus-var>` (C++) or set a class attribute (Python)
+in one of the following ways:
+
+**C++:**
 
 .. code-block:: c++
 
@@ -73,41 +98,55 @@ you must annotate the buffer member variable with a Cyclus pre-processor
     #pragma cyclus var {'capacity': 'buf_cap'}
     cyclus::toolkit::ResBuf<cyclus::Material> mybuf;
 
+**Python:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+    import cyclus.typesystem as ts
+
+    class MyFacility(Facility):
+        # Option 1: minimum required annotation
+        mybuf = ts.ResBufMaterialInv()
+
+        # Option 2: you can set a specify buffer capacity
+        mybuf = ts.ResBufMaterialInv(capacity=245.6)
+
+        # Option 3: you can reference another annotated member variable's value
+        # as the capacity
+        buf_cap = ts.Double()
+        mybuf = ts.ResBufMaterialInv(capacity='buf_cap')
+
 You can read the `ResBuf API documentation
 <http://fuelcycle.org/cyclus/api/classcyclus_1_1toolkit_1_1ResBuf.html>`_ for
 more details on how to use the buffer.
 
-MatQuery
-++++++++
-
+MatQuery [C++]
+++++++++++++++
 The ``cyclus::toolkit::MatQuery`` class provides some easy-to-use functions that
 interrogate the ``cyclus::Material`` object. For example, one can query the mass
 or number of moles of a given nuclide.
 
-Enrichment
-++++++++++
-
+Enrichment [C++]
+++++++++++++++++
 A number of functions are provided in ``toolkit/enrichment.h`` that assist in
 enrichment-related calculations. Some highlights include a representation of
 uranium assays in ``cyclus::toolkit::Assays``, as well as functions to calculate
 feed, tails, and SWU quantity requirements.
 
-Commodity Recipe Context
-++++++++++++++++++++++++
-
+Commodity Recipe Context [C++]
++++++++++++++++++++++++++++++++
 The ``cyclus::toolkit::CommodityRecipeContext`` class provides a mapping between
 commodities and recipes that can be updated as a simulation progresses.
 
-Symbolic Functions
-++++++++++++++++++
-
+Symbolic Functions [C++]
+++++++++++++++++++++++++
 The ``cyclus::toolkit::SymbolicFunction`` class and its derivatives provide an
 object-oriented hierarchy to represent symbolic functions. Factory methods are
 provided by the ``cyclus::toolkit::SymbFunctionFactory`` class.
 
-Agent Managed Classes
-+++++++++++++++++++++
-
+Agent Managed Classes [C++]
++++++++++++++++++++++++++++
 There are a number of interfaces provided in the |cyclus| toolkit that can be
 used as either as `mixins <http://en.wikipedia.org/wiki/Mixin>`_ or as
 composable, agent-managed state variables:
@@ -122,7 +161,7 @@ composable, agent-managed state variables:
   about commodities that can be produced by the manager
 
 * ``cyclus::toolkit::CommodityProducerManager``: an interface that allows an
-  agent to query a collection of ``cyclus::toolkit::CommodityProducer``\ s
+  agent to query a collection of ``cyclus::toolkit::CommodityProducers``
 
 * ``cyclus::toolkit::SupplyDemandManager``: an interface for querying the supply
   and demand on commodities
diff --git a/source/arche/tour.rst b/source/arche/tour_cpp.rst
similarity index 100%
rename from source/arche/tour.rst
rename to source/arche/tour_cpp.rst
diff --git a/source/arche/tutorial/cyclist.rst b/source/arche/tutorial_cpp/cyclist.rst
similarity index 100%
rename from source/arche/tutorial/cyclist.rst
rename to source/arche/tutorial_cpp/cyclist.rst
diff --git a/source/arche/tutorial/dre.rst b/source/arche/tutorial_cpp/dre.rst
similarity index 100%
rename from source/arche/tutorial/dre.rst
rename to source/arche/tutorial_cpp/dre.rst
diff --git a/source/arche/tutorial/github_new.png b/source/arche/tutorial_cpp/github_new.png
similarity index 100%
rename from source/arche/tutorial/github_new.png
rename to source/arche/tutorial_cpp/github_new.png
diff --git a/source/arche/tutorial/index.rst b/source/arche/tutorial_cpp/index.rst
similarity index 90%
rename from source/arche/tutorial/index.rst
rename to source/arche/tutorial_cpp/index.rst
index 7f2cb6c8f..94ba77bb4 100644
--- a/source/arche/tutorial/index.rst
+++ b/source/arche/tutorial_cpp/index.rst
@@ -1,6 +1,5 @@
-Archetype Development Tutorial
-===============================
-
+Archetype Development Tutorial [C++]
+====================================
 In this tutorial, we will work through a number of steps for creating a
 Facility archetype for Cyclus.  This tutorial assumes that the learner is
 already reasonably familiar with programming in C++ and with the primary
@@ -41,4 +40,4 @@ Given enough time, the following extra topics may be covered:
 
     If you ever see an error like ``ERROR(core ):SQL error [INSERT INTO
     AgentState...`` simply remove the output database with ``$ rm
-    cyclus.sqlite`` and rerun the simulation
\ No newline at end of file
+    cyclus.sqlite`` and rerun the simulation
diff --git a/source/arche/tutorial/input_files.rst b/source/arche/tutorial_cpp/input_files.rst
similarity index 100%
rename from source/arche/tutorial/input_files.rst
rename to source/arche/tutorial_cpp/input_files.rst
diff --git a/source/arche/tutorial/setup.rst b/source/arche/tutorial_cpp/setup.rst
similarity index 67%
rename from source/arche/tutorial/setup.rst
rename to source/arche/tutorial_cpp/setup.rst
index 0dd381949..dc7a3f71d 100644
--- a/source/arche/tutorial/setup.rst
+++ b/source/arche/tutorial_cpp/setup.rst
@@ -5,18 +5,18 @@ In this lesson, we will:
 
 1. Do the tasks the the Cyclus Archetype Hello World!
 2. Clean up the file system for the single storage facility
-3. Install the storage facility 
+3. Install the storage facility
 4. Run an input file that uses the new storage facility
 
 Follow the Hello Cyclus! Instructions
 ---------------------------------------------------
 
-Follow all of the steps of :ref:`hello_world`.
+Follow all of the steps of :ref:`hello_world_cpp`.
 
 Make a Storage Facility
 ------------------------------------------
 
-Next, make a new facility by copying the facility archetype from the Hello World! tutorial. 
+Next, make a new facility by copying the facility archetype from the Hello World! tutorial.
 
 Start by making sure you are in the correct directory
 
@@ -60,7 +60,7 @@ Run the unit tests
 
     $ Storage_unit_tests
 
-Make a new input file that is a copy of the test input file 
+Make a new input file that is a copy of the test input file
 
 .. code-block:: console
 
@@ -78,33 +78,33 @@ Test the input file by running Cyclus
 .. code-block:: console
 
     $ cyclus -v 2 input/storage.xml
-                  :                                                               
-              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q   
-            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)  
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
             CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
          CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
-         iCCCt  ;;;;;.  CCCC                                                      
-        CCCC  ;;;;;;;;;. CClL.                          c                         
-       CCCC ,;;       ;;: CCCC  ;                   : CCCCi                       
-        CCC ;;         ;;  CC   ;;:                CCC`   `C;                     
-      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;   
-      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;  
-       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .      
-      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.    
-      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:  
-       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;  
-      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;  
-      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;  
-        CCl ;;             CC    ;;;;              CCC    CCL                     
-       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.                      
-        CCCC  ;;     :;; CCCCf  ;                     ,L                          
-         lCCC   ;;;;;;  CCCL                                                      
-         CCCCCC  :;;  fCCCCC                                                      
-          . CCCC     CCCC .                                                       
-           .CCCCCCCCCCCCCi                                                        
-              iCCCCCLCf                                                           
-               .  C. ,                                                            
-                  :                                                               
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
     INFO1(core  ):Simulation set to run from start=0 to end=10
     INFO1(core  ):Beginning simulation
     INFO1(tutori):Hello
diff --git a/source/arche/tutorial/simple_cycle.svg b/source/arche/tutorial_cpp/simple_cycle.svg
similarity index 100%
rename from source/arche/tutorial/simple_cycle.svg
rename to source/arche/tutorial_cpp/simple_cycle.svg
diff --git a/source/arche/tutorial/state_var.rst b/source/arche/tutorial_cpp/state_var.rst
similarity index 100%
rename from source/arche/tutorial/state_var.rst
rename to source/arche/tutorial_cpp/state_var.rst
diff --git a/source/arche/tutorial/storage_capacity.svg b/source/arche/tutorial_cpp/storage_capacity.svg
similarity index 100%
rename from source/arche/tutorial/storage_capacity.svg
rename to source/arche/tutorial_cpp/storage_capacity.svg
diff --git a/source/arche/tutorial/storage_diagram.svg b/source/arche/tutorial_cpp/storage_diagram.svg
similarity index 100%
rename from source/arche/tutorial/storage_diagram.svg
rename to source/arche/tutorial_cpp/storage_diagram.svg
diff --git a/source/arche/tutorial/testing.rst b/source/arche/tutorial_cpp/testing.rst
similarity index 100%
rename from source/arche/tutorial/testing.rst
rename to source/arche/tutorial_cpp/testing.rst
diff --git a/source/arche/tutorial/toolkit.rst b/source/arche/tutorial_cpp/toolkit.rst
similarity index 100%
rename from source/arche/tutorial/toolkit.rst
rename to source/arche/tutorial_cpp/toolkit.rst
diff --git a/source/arche/tutorial_py/github_new.png b/source/arche/tutorial_py/github_new.png
new file mode 100644
index 0000000000000000000000000000000000000000..1fa91ee6dd52ae108359f239bfd893e975ee148b
GIT binary patch
literal 132458
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%0Af({P
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
VFaM;OJ224io4EYfDpA9L{{!V(#RUKW

literal 0
HcmV?d00001

diff --git a/source/arche/tutorial_py/index.rst b/source/arche/tutorial_py/index.rst
new file mode 100644
index 000000000..7473e5688
--- /dev/null
+++ b/source/arche/tutorial_py/index.rst
@@ -0,0 +1,28 @@
+Archetype Development Tutorial [Python]
+=======================================
+In this tutorial, we will work through a number of steps for creating a
+Facility archetype for Cyclus.  This tutorial assumes that the learner is
+already reasonably familiar with programming in Python and with the primary
+vocabulary of Cyclus.  We also assume that the learner has a Github account.
+
+Overview
+---------
+Through this tutorial, we will transform a copy of the Cycstub repository into
+an open source Cyclus archetype module that includes an archetype to simulate
+a very simple interim storage facility, named "Storage".  Ultimately, this
+facility will have the following characteristics, all definable by the user:
+
+* a fixed rate at which it can transfer material
+* a minimum time that material stays in storage
+* a fixed storage capacity
+
+This tutorial has the following steps:
+
+.. toctree::
+    :maxdepth: 1
+
+    setup
+    state_var
+    toolkit
+    testing
+    input_files
diff --git a/source/arche/tutorial_py/input_files.rst b/source/arche/tutorial_py/input_files.rst
new file mode 100644
index 000000000..65081a574
--- /dev/null
+++ b/source/arche/tutorial_py/input_files.rst
@@ -0,0 +1,5 @@
+
+Making Input Files
+===============================
+Cyclus uses XML, JSON, or Python as its input file format, and there is an extensive guide to
+making input files on the `website <http://fuelcycle.org/user/writing_input.html>`_.
diff --git a/source/arche/tutorial_py/setup.rst b/source/arche/tutorial_py/setup.rst
new file mode 100644
index 000000000..4ac0b1590
--- /dev/null
+++ b/source/arche/tutorial_py/setup.rst
@@ -0,0 +1,170 @@
+Setup a New Project
+==============================================
+In this lesson, we will:
+
+1. Clean up the file system for the single storage facility
+2. Install the storage facility
+3. Run an input file that uses the new storage facility
+
+Make a New Project
+-------------------
+First let's start by making a tutorial example project with an ``agents.py`` file.
+
+.. code-block:: console
+
+    ~ $ mkdir -p tutorial/tut
+    ~ $ cd tutorial/tut
+    ~/tuorial/tut $ touch __init__.py agents.py
+
+
+Make a Storage Facility
+------------------------------------------
+Next, make a new facility by editing the ``agents.py`` file to look like the following:
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+
+
+    class Storage(Facility):
+        """My storage facility."""
+
+        def tick(self):
+            print("Hello,")
+            print("World!")
+
+
+Install and Test
+----------------------------------
+To install the tutorial project, we'll need to have a ``setup.py`` file in the
+root tutorial directory. Create one that looks like:
+
+**~/tutorial/setup.py:**
+
+.. code-block:: python
+
+    #!/usr/bin/env python
+    from distutils.core import setup
+
+
+    VERSION = '0.0.1'
+    setup_kwargs = {
+        "version": VERSION,
+        "description": 'My Cyclus tutorial',
+        "author": 'Just Me',
+        }
+
+    if __name__ == '__main__':
+        setup(
+            name='tut',
+            packages=['tut'],
+            scripts=['xo'],
+            **setup_kwargs
+            )
+
+
+Now we can install the tutorial project via,
+
+.. code-block:: console
+
+    ~ $ cd tutorial
+    ~/tutorial $ python setup.py install --user
+
+
+Let's now make an exmaple input file in a special ``input`` directory:
+
+.. code-block:: console
+
+    ~ $ cd tutorial
+    ~/tutorial $ mkdir -p input
+    ~/tutorial $ touch input/storage.py
+
+Now open up the ``input/storage.`` input file and edit it to look like:
+
+.. code-block:: python
+
+    SIMULATION = {
+     'simulation': {
+      'archetypes': {
+       'spec': [
+        {'lib': 'tut.agents', 'name': 'Storage'},
+        {'lib': 'agents', 'name': 'NullInst'},
+        {'lib': 'agents', 'name': 'NullRegion'},
+       ],
+      },
+      'control': {'duration': 10, 'startmonth': 1, 'startyear': 2000},
+      'facility': {'config': {'Storage': None}, 'name': 'OneFacility'},
+      'region': {
+       'config': {'NullRegion': None},
+       'institution': {
+        'config': {'NullInst': None},
+        'initialfacilitylist': {'entry': {'number': 1, 'prototype': 'OneFacility'},},
+        'name': 'OneInst',
+       },
+       'name': 'OneRegion',
+      },
+     },
+    }
+
+
+Test the input file by running Cyclus:
+
+.. code-block:: console
+
+    $ cyclus -v 2 input/storage.py
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
+            CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
+         CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
+    INFO1(core  ):Simulation set to run from start=0 to end=10
+    INFO1(core  ):Beginning simulation
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+
+    Status: Cyclus run successful!
+    Output location: cyclus.sqlite
+    Simulation ID: 9f15b93c-9ab2-49bb-a14f-fef872e64ce8
+
diff --git a/source/arche/tutorial_py/simple_cycle.svg b/source/arche/tutorial_py/simple_cycle.svg
new file mode 100644
index 000000000..2fa484125
--- /dev/null
+++ b/source/arche/tutorial_py/simple_cycle.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" standalone="yes"?>
+
+<svg version="1.1" viewBox="0.0 0.0 903.0 223.0" fill="none" stroke="none" stroke-linecap="square" stroke-miterlimit="10" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="p.0"><path d="m0 0l903.0 0l0 223.0l-903.0 0l0 -223.0z" clip-rule="nonzero"></path></clipPath><g clip-path="url(#p.0)"><path fill="#000000" fill-opacity="0.0" d="m0 0l903.4593 0l0 223.56168l-903.4593 0z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m14.04462 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m14.04462 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path fill="#000000" d="m77.78918 114.22216l1.6875 -0.140625q0.125 1.015625 0.5625 1.671875q0.4375 0.65625 1.359375 1.0625q0.9375 0.40625 2.09375 0.40625q1.03125 0 1.8125 -0.3125q0.796875 -0.3125 1.1875 -0.84375q0.390625 -0.53125 0.390625 -1.15625q0 -0.640625 -0.375 -1.109375q-0.375 -0.484375 -1.234375 -0.8125q-0.546875 -0.21875 -2.421875 -0.65625q-1.875 -0.453125 -2.625 -0.859375q-0.96875 -0.515625 -1.453125 -1.265625q-0.46875 -0.75 -0.46875 -1.6875q0 -1.03125 0.578125 -1.921875q0.59375 -0.90625 1.703125 -1.359375q1.125 -0.46875 2.5 -0.46875q1.515625 0 2.671875 0.484375q1.15625 0.484375 1.765625 1.4375q0.625 0.9375 0.671875 2.140625l-1.71875 0.125q-0.140625 -1.28125 -0.953125 -1.9375q-0.796875 -0.671875 -2.359375 -0.671875q-1.625 0 -2.375 0.609375q-0.75 0.59375 -0.75 1.4375q0 0.734375 0.53125 1.203125q0.515625 0.46875 2.703125 0.96875q2.203125 0.5 3.015625 0.875q1.1875 0.546875 1.75 1.390625q0.578125 0.828125 0.578125 1.921875q0 1.09375 -0.625 2.0625q-0.625 0.953125 -1.796875 1.484375q-1.15625 0.53125 -2.609375 0.53125q-1.84375 0 -3.09375 -0.53125q-1.25 -0.546875 -1.96875 -1.625q-0.703125 -1.078125 -0.734375 -2.453125zm12.209198 -0.546875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm15.735092 4.921875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm3.9069672 0l0 -9.859375l1.5 0l0 1.5q0.578125 -1.046875 1.0625 -1.375q0.484375 -0.34375 1.078125 -0.34375q0.84375 0 1.71875 0.546875l-0.578125 1.546875q-0.609375 -0.359375 -1.234375 -0.359375q-0.546875 0 -0.984375 0.328125q-0.421875 0.328125 -0.609375 0.90625q-0.28125 0.890625 -0.28125 1.953125l0 5.15625l-1.671875 0zm12.665802 -3.609375l1.640625 0.21875q-0.265625 1.6875 -1.375 2.65625q-1.109375 0.953125 -2.734375 0.953125q-2.015625 0 -3.25 -1.3125q-1.21875 -1.328125 -1.21875 -3.796875q0 -1.59375 0.515625 -2.78125q0.53125 -1.203125 1.609375 -1.796875q1.09375 -0.609375 2.359375 -0.609375q1.609375 0 2.625 0.8125q1.015625 0.8125 1.3125 2.3125l-1.625 0.25q-0.234375 -1.0 -0.828125 -1.5q-0.59375 -0.5 -1.421875 -0.5q-1.265625 0 -2.0625 0.90625q-0.78125 0.90625 -0.78125 2.859375q0 1.984375 0.765625 2.890625q0.765625 0.890625 1.984375 0.890625q0.984375 0 1.640625 -0.59375q0.65625 -0.609375 0.84375 -1.859375zm9.640633 0.4375l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.4218826 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.2812576 -1.375 3.3281326 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m358.04462 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m358.04462 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path fill="#000000" d="m418.67374 114.22216l1.6875 -0.140625q0.125 1.015625 0.5625 1.671875q0.4375 0.65625 1.359375 1.0625q0.9375 0.40625 2.09375 0.40625q1.03125 0 1.8125 -0.3125q0.796875 -0.3125 1.1875 -0.84375q0.390625 -0.53125 0.390625 -1.15625q0 -0.640625 -0.375 -1.109375q-0.375 -0.484375 -1.234375 -0.8125q-0.546875 -0.21875 -2.421875 -0.65625q-1.875 -0.453125 -2.625 -0.859375q-0.96875 -0.515625 -1.453125 -1.265625q-0.46875 -0.75 -0.46875 -1.6875q0 -1.03125 0.578125 -1.921875q0.59375 -0.90625 1.703125 -1.359375q1.125 -0.46875 2.5 -0.46875q1.515625 0 2.671875 0.484375q1.15625 0.484375 1.765625 1.4375q0.625 0.9375 0.671875 2.140625l-1.71875 0.125q-0.140625 -1.28125 -0.953125 -1.9375q-0.796875 -0.671875 -2.359375 -0.671875q-1.625 0 -2.375 0.609375q-0.75 0.59375 -0.75 1.4375q0 0.734375 0.53125 1.203125q0.515625 0.46875 2.703125 0.96875q2.203125 0.5 3.015625 0.875q1.1875 0.546875 1.75 1.390625q0.578125 0.828125 0.578125 1.921875q0 1.09375 -0.625 2.0625q-0.625 0.953125 -1.796875 1.484375q-1.15625 0.53125 -2.609375 0.53125q-1.84375 0 -3.09375 -0.53125q-1.25 -0.546875 -1.96875 -1.625q-0.703125 -1.078125 -0.734375 -2.453125zm16.490448 2.875l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm0.9020386 -3.421875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.266357 4.921875l0 -9.859375l1.5 0l0 1.5q0.578125 -1.046875 1.0625 -1.375q0.484375 -0.34375 1.078125 -0.34375q0.84375 0 1.71875 0.546875l-0.578125 1.546875q-0.609375 -0.359375 -1.234375 -0.359375q-0.546875 0 -0.984375 0.328125q-0.421875 0.328125 -0.609375 0.90625q-0.28125 0.890625 -0.28125 1.953125l0 5.15625l-1.671875 0zm12.665802 -1.21875q-0.9375 0.796875 -1.796875 1.125q-0.859375 0.3125 -1.84375 0.3125q-1.609375 0 -2.484375 -0.78125q-0.875 -0.796875 -0.875 -2.03125q0 -0.734375 0.328125 -1.328125q0.328125 -0.59375 0.859375 -0.953125q0.53125 -0.359375 1.203125 -0.546875q0.5 -0.140625 1.484375 -0.25q2.03125 -0.25 2.984375 -0.578125q0 -0.34375 0 -0.4375q0 -1.015625 -0.46875 -1.4375q-0.640625 -0.5625 -1.90625 -0.5625q-1.171875 0 -1.734375 0.40625q-0.5625 0.40625 -0.828125 1.46875l-1.640625 -0.234375q0.234375 -1.046875 0.734375 -1.6875q0.515625 -0.640625 1.46875 -0.984375q0.96875 -0.359375 2.25 -0.359375q1.265625 0 2.046875 0.296875q0.78125 0.296875 1.15625 0.75q0.375 0.453125 0.515625 1.140625q0.09375 0.421875 0.09375 1.53125l0 2.234375q0 2.328125 0.09375 2.953125q0.109375 0.609375 0.4375 1.171875l-1.75 0q-0.265625 -0.515625 -0.328125 -1.21875zm-0.140625 -3.71875q-0.90625 0.359375 -2.734375 0.625q-1.03125 0.140625 -1.453125 0.328125q-0.421875 0.1875 -0.65625 0.546875q-0.234375 0.359375 -0.234375 0.796875q0 0.671875 0.5 1.125q0.515625 0.4375 1.484375 0.4375q0.96875 0 1.71875 -0.421875q0.75 -0.4375 1.109375 -1.15625q0.265625 -0.578125 0.265625 -1.671875l0 -0.609375zm3.781952 5.75l1.609375 0.25q0.109375 0.75 0.578125 1.09375q0.609375 0.453125 1.6875 0.453125q1.171875 0 1.796875 -0.46875q0.625 -0.453125 0.859375 -1.28125q0.125 -0.515625 0.109375 -2.15625q-1.09375 1.296875 -2.71875 1.296875q-2.03125 0 -3.15625 -1.46875q-1.109375 -1.46875 -1.109375 -3.515625q0 -1.40625 0.515625 -2.59375q0.515625 -1.203125 1.484375 -1.84375q0.96875 -0.65625 2.265625 -0.65625q1.75 0 2.875 1.40625l0 -1.1875l1.546875 0l0 8.515625q0 2.3125 -0.46875 3.265625q-0.46875 0.96875 -1.484375 1.515625q-1.015625 0.5625 -2.5 0.5625q-1.765625 0 -2.859375 -0.796875q-1.078125 -0.796875 -1.03125 -2.390625zm1.375 -5.921875q0 1.953125 0.765625 2.84375q0.78125 0.890625 1.9375 0.890625q1.140625 0 1.921875 -0.890625q0.78125 -0.890625 0.78125 -2.78125q0 -1.8125 -0.8125 -2.71875q-0.796875 -0.921875 -1.921875 -0.921875q-1.109375 0 -1.890625 0.90625q-0.78125 0.890625 -0.78125 2.671875zm16.047607 1.9375l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.421875 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.28125 -1.375 3.328125 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m198.92651 111.67716l159.1181 0" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m198.92651 111.67716l135.1181 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="4.0" stroke-linecap="butt" d="m334.04462 118.284096l18.152405 -6.6069336l-18.152405 -6.606926z" fill-rule="evenodd"></path><path fill="#cfe2f3" d="m702.0446 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m702.0446 13.897637l184.8819 0l0 195.55905l-184.8819 0z" fill-rule="nonzero"></path><path fill="#000000" d="m777.19885 114.22216l1.6875 -0.140625q0.125 1.015625 0.5625 1.671875q0.4375 0.65625 1.359375 1.0625q0.9375 0.40625 2.09375 0.40625q1.03125 0 1.8125 -0.3125q0.796875 -0.3125 1.1875 -0.84375q0.390625 -0.53125 0.390625 -1.15625q0 -0.640625 -0.375 -1.109375q-0.375 -0.484375 -1.234375 -0.8125q-0.546875 -0.21875 -2.421875 -0.65625q-1.875 -0.453125 -2.625 -0.859375q-0.96875 -0.515625 -1.453125 -1.265625q-0.46875 -0.75 -0.46875 -1.6875q0 -1.03125 0.578125 -1.921875q0.59375 -0.90625 1.703125 -1.359375q1.125 -0.46875 2.5 -0.46875q1.515625 0 2.671875 0.484375q1.15625 0.484375 1.765625 1.4375q0.625 0.9375 0.671875 2.140625l-1.71875 0.125q-0.140625 -1.28125 -0.953125 -1.9375q-0.796875 -0.671875 -2.359375 -0.671875q-1.625 0 -2.375 0.609375q-0.75 0.59375 -0.75 1.4375q0 0.734375 0.53125 1.203125q0.515625 0.46875 2.703125 0.96875q2.203125 0.5 3.015625 0.875q1.1875 0.546875 1.75 1.390625q0.578125 0.828125 0.578125 1.921875q0 1.09375 -0.625 2.0625q-0.625 0.953125 -1.796875 1.484375q-1.15625 0.53125 -2.609375 0.53125q-1.84375 0 -3.09375 -0.53125q-1.25 -0.546875 -1.96875 -1.625q-0.703125 -1.078125 -0.734375 -2.453125zm12.8497925 -7.3125l0 -1.90625l1.671875 0l0 1.90625l-1.671875 0zm0 11.6875l0 -9.859375l1.671875 0l0 9.859375l-1.671875 0zm4.1292114 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm10.391357 0l0 -13.59375l1.671875 0l0 7.75l3.953125 -4.015625l2.15625 0l-3.765625 3.65625l4.140625 6.203125l-2.0625 0l-3.25 -5.03125l-1.171875 1.125l0 3.90625l-1.671875 0z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m542.9265 111.67716l159.1181 0" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m542.9265 111.67716l135.1181 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="4.0" stroke-linecap="butt" d="m678.0446 118.284096l18.152405 -6.6069336l-18.152405 -6.606926z" fill-rule="evenodd"></path></g></svg>
+
diff --git a/source/arche/tutorial_py/state_var.rst b/source/arche/tutorial_py/state_var.rst
new file mode 100644
index 000000000..9858a0b71
--- /dev/null
+++ b/source/arche/tutorial_py/state_var.rst
@@ -0,0 +1,228 @@
+Adding State Variables
+=======================
+In this lesson, we will:
+
+1. Add the necessary state variables to define the storage facility
+3. Modify the sample input file to include these variables
+
+Add State Variables
+----------------------------------------------
+The Cyclus Python interface preprocessor provides a ``typesystem`` module that help define
+variables that are state variables for an archetype. These state vars also allow convenient
+annotations.
+
+First, we'll add the maximum monthly transfer capacity, called ``throughput``.
+Open the file ``tutorial/tut/agents.py`` in your text editor.
+Immediately after the storage class name, add the following:
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+    import cyclus.typesystem as ts
+
+
+    class Storage(Facility):
+        """My storage facility."""
+
+        # this declares throughput to be of type double for purposes of storage
+        # and user input
+        throughput = ts.Double(
+            doc="Maximum amount of material that can be transferred in or "
+                "out each time step",
+            tooltip="Maximum amount of material that can be transferred in "
+                    "or out each time step",
+            units="kg",
+            uilabel="Maximum Throughput",
+            )
+
+        def tick(self):
+            print("Hello, World!")
+
+
+Now, we'll add variables for the minimum amount of time that material is
+stored and the input/output commodity names.
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        storage_time = ts.Int(
+            doc="Minimum amount of time material must be stored",
+            tooltip="Minimum amount of time material must be stored",
+            units="months",
+            uilabel="Storage Time",
+            )
+        incommod = ts.String(
+            tooltip="Storage input commodity",
+            doc="Input commodity on which Storage requests material.",
+            uilabel="Input Commodity",
+            uitype="incommodity",
+            )
+        outcommod = ts.Int(
+            tooltip="Storage output commodity",
+            doc="Output commodity on which Storage offers material.",
+            uilabel="Output Commodity",
+            uitype="outcommodity",
+            )
+        ...
+
+Re-innstall the Modified Module
+---------------------------------------
+To reinstall this module, just issue the same ``setupy.py`` command as before:
+
+.. code-block:: console
+
+    ~/tutorial $ python setup.py install --user
+
+
+Modify the Input File
+-------------------------
+If you try to run the same input file with your modified module, you will get
+errors because the sample input file no longer includes the necessary pieces
+to define your module.  It is missing the new variables.  Try it:
+
+.. code-block:: console
+
+    ~/tutorial $ cyclus -v 2 input/storage.py
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
+            CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
+         CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
+    Entity: line 17: element Storage: Relax-NG validity error : Expecting an element throughput, got nothing
+    Entity: line 17: element Storage: Relax-NG validity error : Invalid sequence in interleave
+    Entity: line 17: element Storage: Relax-NG validity error : Element Storage failed to validate content
+     ERROR(core  ):Document failed schema validation
+
+The simulation now fails because it does not match the schema. You can view the schema with
+
+.. code-block:: console
+
+    ~/tutorial $ cyclus --agent-schema :tut.agents:Storage
+
+Notice that you were able to take advantage of the input file validation simply by using
+the special typesystem class attributes .
+
+Our failed cyclus simulation produced an output file that will need to be deleted.
+
+.. code-block:: console
+
+    ~/tutorial $ rm cyclus.sqlite
+
+Now, we'll change that input file.  Open the file ``input/storage.py`` in
+your text editor, and find the prototype configuration for the single facility
+named "OneFacility" that looks like this.
+
+**~/tutorial/input/storage.py:**
+
+.. code-block:: python
+
+    {
+    # ...
+    'facility': {'config': {'Storage': None}, 'name': 'OneFacility'}
+    # ...
+    }
+
+We need to replace the ``<config>`` element with this:
+
+**~/tutorial/input/storage.py:**
+
+.. code-block:: python
+
+    {
+    # ...
+    'facility': {'config': {'Storage': {
+                                'throughput': 10,
+                                'storage_time': 1,
+                                'incommod': 'fuel',
+                                'outcommod': 'stored_fuel',
+                                }},
+                            'name': 'OneFacility'}
+    # ...
+    }
+
+Now we can try it again:
+
+.. code-block:: console
+
+    ~/tutorial $ cyclus -v 2 input/storage.py
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
+            CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
+         CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
+    INFO1(core  ):Simulation set to run from start=0 to end=10
+    INFO1(core  ):Beginning simulation
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+
+    Status: Cyclus run successful!
+    Output location: cyclus.sqlite
+    Simulation ID: 9f15b93c-9ab2-49bb-a14f-fef872e64ce8
diff --git a/source/arche/tutorial_py/storage_capacity.svg b/source/arche/tutorial_py/storage_capacity.svg
new file mode 100644
index 000000000..de8f7ecc2
--- /dev/null
+++ b/source/arche/tutorial_py/storage_capacity.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" standalone="yes"?>
+
+<svg version="1.1" viewBox="0.0 0.0 1466.0 467.0" fill="none" stroke="none" stroke-linecap="square" stroke-miterlimit="10" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="p.0"><path d="m0 0l1466.0 0l0 467.0l-1466.0 0l0 -467.0z" clip-rule="nonzero"></path></clipPath><g clip-path="url(#p.0)"><path fill="#000000" fill-opacity="0.0" d="m0 0l1466.0 0l0 467.0l-1466.0 0z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m41.220474 94.11024l532.0 0l0 107.90551l-532.0 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" stroke-dasharray="8.0,6.0" d="m41.220474 94.11024l532.0 0l0 107.90551l-532.0 0z" fill-rule="nonzero"></path><path fill="#000000" d="m288.2392 154.98299l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.667694 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.1405945 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.1718445 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm10.375702 3.78125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313232 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.578827 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m41.220474 346.0l532.8819 0l0 47.118103l-532.8819 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m41.220474 346.0l532.8819 0l0 47.118103l-532.8819 0z" fill-rule="nonzero"></path><path fill="#000000" d="m280.5807 369.85406q0 -3.390625 1.8125 -5.296875q1.828125 -1.921875 4.703125 -1.921875q1.875 0 3.390625 0.90625q1.515625 0.890625 2.296875 2.5q0.796875 1.609375 0.796875 3.65625q0 2.0625 -0.84375 3.703125q-0.828125 1.625 -2.359375 2.46875q-1.53125 0.84375 -3.296875 0.84375q-1.921875 0 -3.4375 -0.921875q-1.5 -0.9375 -2.28125 -2.53125q-0.78125 -1.609375 -0.78125 -3.40625zm1.859375 0.03125q0 2.453125 1.3125 3.875q1.328125 1.40625 3.3125 1.40625q2.03125 0 3.34375 -1.421875q1.3125 -1.4375 1.3125 -4.0625q0 -1.65625 -0.5625 -2.890625q-0.546875 -1.234375 -1.640625 -1.921875q-1.078125 -0.6875 -2.421875 -0.6875q-1.90625 0 -3.28125 1.3125q-1.375 1.3125 -1.375 4.390625zm19.433289 6.59375l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.6249695 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15621948 0.65625 0.6718445 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm1.5270386 5.28125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313232 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m41.220474 202.0l532.8819 0l0 144.0l-532.8819 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m41.220474 202.0l532.8819 0l0 144.0l-532.8819 0z" fill-rule="nonzero"></path><path fill="#000000" d="m271.05783 280.91998l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.667694 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm13.110077 0l-3.75 -9.859375l1.765625 0l2.125 5.90625q0.34375 0.953125 0.625 1.984375q0.21875 -0.78125 0.625 -1.875l2.1875 -6.015625l1.71875 0l-3.734375 9.859375l-1.5625 0zm13.34375 -3.171875l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.421875 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.28125 -1.375 3.328125 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875zm9.110077 5.875l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm14.031982 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm0.9020386 -3.421875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.266357 4.921875l0 -9.859375l1.5 0l0 1.5q0.578125 -1.046875 1.0625 -1.375q0.484375 -0.34375 1.078125 -0.34375q0.84375 0 1.71875 0.546875l-0.578125 1.546875q-0.609375 -0.359375 -1.234375 -0.359375q-0.546875 0 -0.984375 0.328125q-0.421875 0.328125 -0.609375 0.90625q-0.28125 0.890625 -0.28125 1.953125l0 5.15625l-1.671875 0zm6.150177 3.796875l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m750.22046 94.11024l532.0 0l0 64.88189l-532.0 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" stroke-dasharray="8.0,6.0" d="m750.22046 94.11024l532.0 0l0 64.88189l-532.0 0z" fill-rule="nonzero"></path><path fill="#000000" d="m997.2392 133.47118l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.6676636 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm10.375732 3.78125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313232 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m750.22046 315.98425l532.88196 0l0 77.13385l-532.88196 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m750.22046 315.98425l532.88196 0l0 77.13385l-532.88196 0z" fill-rule="nonzero"></path><path fill="#000000" d="m989.5807 354.8462q0 -3.390625 1.8125 -5.296875q1.828125 -1.921875 4.703125 -1.921875q1.875 0 3.390625 0.90625q1.515625 0.890625 2.296875 2.5q0.796875 1.609375 0.796875 3.65625q0 2.0625 -0.84375 3.703125q-0.828125 1.625 -2.359375 2.46875q-1.53125 0.84375 -3.296875 0.84375q-1.921875 0 -3.4375 -0.921875q-1.5 -0.9375 -2.28125 -2.53125q-0.78125 -1.609375 -0.78125 -3.40625zm1.859375 0.03125q0 2.453125 1.3125 3.875q1.328125 1.40625 3.3125 1.40625q2.03125 0 3.34375 -1.421875q1.3125 -1.4375 1.3125 -4.0625q0 -1.65625 -0.5625 -2.890625q-0.546875 -1.234375 -1.640625 -1.921875q-1.078125 -0.6875 -2.421875 -0.6875q-1.90625 0 -3.28125 1.3125q-1.375 1.3125 -1.375 4.390625zm19.433289 6.59375l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm1.5270386 5.28125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313232 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m750.22046 159.0l532.88196 0l0 156.97638l-532.88196 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m750.22046 159.0l532.88196 0l0 156.97638l-532.88196 0z" fill-rule="nonzero"></path><path fill="#000000" d="m980.05786 244.40819l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.6676636 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm13.110107 0l-3.75 -9.859375l1.765625 0l2.125 5.90625q0.34375 0.953125 0.625 1.984375q0.21875 -0.78125 0.625 -1.875l2.1875 -6.015625l1.71875 0l-3.734375 9.859375l-1.5625 0zm13.34375 -3.171875l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.421875 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.28125 -1.375 3.328125 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875zm9.110046 5.875l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm14.031982 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm0.9020996 -3.421875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.266357 4.921875l0 -9.859375l1.5 0l0 1.5q0.578125 -1.046875 1.0625 -1.375q0.484375 -0.34375 1.078125 -0.34375q0.84375 0 1.71875 0.546875l-0.578125 1.546875q-0.609375 -0.359375 -1.234375 -0.359375q-0.546875 0 -0.984375 0.328125q-0.421875 0.328125 -0.609375 0.90625q-0.28125 0.890625 -0.28125 1.953125l0 5.15625l-1.671875 0zm6.1501465 3.796875l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m256.65353 30.0l102.01575 0l0 47.11811l-102.01575 0z" fill-rule="nonzero"></path><path fill="#000000" d="m306.5175 55.42l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#000000" d="m307.29456 59.685623q0 -1.53125 0.3125 -2.453125q0.3125 -0.9375 0.921875 -1.4375q0.625 -0.5 1.5625 -0.5q0.6875 0 1.203125 0.28125q0.53125 0.28125 0.875 0.8125q0.34375 0.515625 0.53125 1.265625q0.1875 0.75 0.1875 2.03125q0 1.515625 -0.3125 2.4375q-0.296875 0.921875 -0.921875 1.4375q-0.609375 0.5 -1.5625 0.5q-1.234375 0 -1.953125 -0.890625q-0.84375 -1.0625 -0.84375 -3.484375zm1.078125 0q0 2.109375 0.5 2.8125q0.5 0.703125 1.21875 0.703125q0.734375 0 1.21875 -0.703125q0.5 -0.703125 0.5 -2.8125q0 -2.125 -0.5 -2.8125q-0.484375 -0.703125 -1.234375 -0.703125q-0.71875 0 -1.15625 0.609375q-0.546875 0.78125 -0.546875 2.90625z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m965.2126 30.0l102.01581 0l0 47.11811l-102.01581 0z" fill-rule="nonzero"></path><path fill="#000000" d="m1015.07654 55.42l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#000000" d="m1019.8223 63.92l-1.046875 0l0 -6.71875q-0.390625 0.359375 -1.015625 0.734375q-0.609375 0.359375 -1.09375 0.53125l0 -1.015625q0.875 -0.421875 1.53125 -1.0q0.671875 -0.59375 0.953125 -1.15625l0.671875 0l0 8.625z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m1379.6719 22.460876l-0.34643555 106.078735" fill-rule="nonzero"></path><path stroke="#f1c232" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m1379.6719 22.460876l-0.26794434 82.07887" fill-rule="evenodd"></path><path fill="#f1c232" stroke="#f1c232" stroke-width="4.0" stroke-linecap="butt" d="m1372.797 104.518166l6.5476074 18.173874l6.6661377 -18.130714z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m1379.6719 128.53961l-0.34643555 106.07875" fill-rule="nonzero"></path><path stroke="#b45f06" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m1379.6719 128.53961l-0.26794434 82.07887" fill-rule="evenodd"></path><path fill="#b45f06" stroke="#b45f06" stroke-width="4.0" stroke-linecap="butt" d="m1372.797 210.59691l6.5476074 18.173874l6.6661377 -18.130722z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m1379.6719 232.38214l-0.34643555 106.078735" fill-rule="nonzero"></path><path stroke="#38761d" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m1379.6719 232.38214l-0.26794434 82.07886" fill-rule="evenodd"></path><path fill="#38761d" stroke="#38761d" stroke-width="4.0" stroke-linecap="butt" d="m1372.797 314.43942l6.5476074 18.17389l6.6661377 -18.130737z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m1379.6719 338.46088l-0.34643555 106.078735" fill-rule="nonzero"></path><path stroke="#f1c232" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m1379.6719 338.46088l-0.26794434 82.07886" fill-rule="evenodd"></path><path fill="#f1c232" stroke="#f1c232" stroke-width="4.0" stroke-linecap="butt" d="m1372.797 420.51816l6.5476074 18.17389l6.6661377 -18.130737z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m618.72705 233.5l86.86615 0" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m618.72705 233.5l62.86615 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="4.0" stroke-linecap="butt" d="m681.5932 240.10693l18.152344 -6.6069336l-18.152344 -6.6069336z" fill-rule="evenodd"></path></g></svg>
+
diff --git a/source/arche/tutorial_py/storage_diagram.svg b/source/arche/tutorial_py/storage_diagram.svg
new file mode 100644
index 000000000..0fca5efc8
--- /dev/null
+++ b/source/arche/tutorial_py/storage_diagram.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" standalone="yes"?>
+
+<svg version="1.1" viewBox="0.0 0.0 565.0 360.0" fill="none" stroke="none" stroke-linecap="square" stroke-miterlimit="10" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="p.0"><path d="m0 0l565.0 0l0 360.0l-565.0 0l0 -360.0z" clip-rule="nonzero"></path></clipPath><g clip-path="url(#p.0)"><path fill="#000000" fill-opacity="0.0" d="m0 0l565.0 0l0 360.0l-565.0 0z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m16.0 47.0l532.0 0l0 298.99213l-532.0 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" stroke-dasharray="8.0,6.0" d="m16.0 47.0l532.0 0l0 298.99213l-532.0 0z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m25.93832 229.72441l108.59842 0l0 106.89763l-108.59842 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m25.93832 229.72441l108.59842 0l0 106.89763l-108.59842 0z" fill-rule="nonzero"></path><path fill="#000000" d="m61.25628 290.09323l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.667679 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm10.375717 3.78125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313225 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.8593826 0 -1.6250076 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.2656326 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.578842 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m228.20079 55.989502l108.598434 0l0 280.6299l-108.598434 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m228.20079 55.989502l108.598434 0l0 280.6299l-108.598434 0z" fill-rule="nonzero"></path><path fill="#000000" d="m245.89642 203.22446l0 -13.59375l1.8125 0l0 13.59375l-1.8125 0zm4.667679 0l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.89064026 0 1.6406403 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.50001526 -0.296875 -1.1718903 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm13.110092 0l-3.75 -9.859375l1.765625 0l2.125 5.90625q0.34375 0.953125 0.625 1.984375q0.21875 -0.78125 0.625 -1.875l2.1875 -6.015625l1.71875 0l-3.734375 9.859375l-1.5625 0zm13.34375 -3.171875l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.421875 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.28125 -1.375 3.328125 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875zm9.110107 5.875l0 -9.859375l1.5 0l0 1.40625q1.09375 -1.625 3.140625 -1.625q0.890625 0 1.640625 0.328125q0.75 0.3125 1.109375 0.84375q0.375 0.515625 0.53125 1.21875q0.09375 0.46875 0.09375 1.625l0 6.0625l-1.671875 0l0 -6.0q0 -1.015625 -0.203125 -1.515625q-0.1875 -0.515625 -0.6875 -0.8125q-0.5 -0.296875 -1.171875 -0.296875q-1.0625 0 -1.84375 0.671875q-0.765625 0.671875 -0.765625 2.578125l0 5.375l-1.671875 0zm14.031952 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm0.9020386 -3.421875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.266357 4.921875l0 -9.859375l1.5 0l0 1.5q0.578125 -1.046875 1.0625 -1.375q0.484375 -0.34375 1.078125 -0.34375q0.84375 0 1.71875 0.546875l-0.578125 1.546875q-0.609375 -0.359375 -1.234375 -0.359375q-0.546875 0 -0.984375 0.328125q-0.421875 0.328125 -0.609375 0.90625q-0.28125 0.890625 -0.28125 1.953125l0 5.15625l-1.671875 0zm6.150177 3.796875l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m430.46326 208.84251l108.59845 0l0 127.779526l-108.59845 0z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m430.46326 208.84251l108.59845 0l0 127.779526l-108.59845 0z" fill-rule="nonzero"></path><path fill="#000000" d="m457.68176 273.02728q0 -3.390625 1.8125 -5.296875q1.828125 -1.921875 4.703125 -1.921875q1.875 0 3.390625 0.90625q1.515625 0.890625 2.296875 2.5q0.796875 1.609375 0.796875 3.65625q0 2.0625 -0.84375 3.703125q-0.828125 1.625 -2.359375 2.46875q-1.53125 0.84375 -3.296875 0.84375q-1.921875 0 -3.4375 -0.921875q-1.5 -0.9375 -2.28125 -2.53125q-0.78125 -1.609375 -0.78125 -3.40625zm1.859375 0.03125q0 2.453125 1.3125 3.875q1.328125 1.40625 3.3125 1.40625q2.03125 0 3.34375 -1.421875q1.3125 -1.4375 1.3125 -4.0625q0 -1.65625 -0.5625 -2.890625q-0.546875 -1.234375 -1.640625 -1.921875q-1.078125 -0.6875 -2.421875 -0.6875q-1.90625 0 -3.28125 1.3125q-1.375 1.3125 -1.375 4.390625zm19.433289 6.59375l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.5788574 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.265625 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6875 0l0 1.3125l-1.6875 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.265625 0 0.734375 -0.078125zm1.5270386 5.28125l0 -13.640625l1.53125 0l0 1.28125q0.53125 -0.75 1.203125 -1.125q0.6875 -0.375 1.640625 -0.375q1.265625 0 2.234375 0.65625q0.96875 0.640625 1.453125 1.828125q0.5 1.1875 0.5 2.59375q0 1.515625 -0.546875 2.734375q-0.546875 1.203125 -1.578125 1.84375q-1.03125 0.640625 -2.171875 0.640625q-0.84375 0 -1.515625 -0.34375q-0.65625 -0.359375 -1.078125 -0.890625l0 4.796875l-1.671875 0zm1.515625 -8.65625q0 1.90625 0.765625 2.8125q0.78125 0.90625 1.875 0.90625q1.109375 0 1.890625 -0.9375q0.796875 -0.9375 0.796875 -2.921875q0 -1.875 -0.78125 -2.8125q-0.765625 -0.9375 -1.84375 -0.9375q-1.0625 0 -1.890625 1.0q-0.8125 1.0 -0.8125 2.890625zm15.313202 4.875l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm7.578827 -1.5l0.234375 1.484375q-0.703125 0.140625 -1.2655945 0.140625q-0.90625 0 -1.40625 -0.28125q-0.5 -0.296875 -0.703125 -0.75q-0.203125 -0.46875 -0.203125 -1.984375l0 -5.65625l-1.234375 0l0 -1.3125l1.234375 0l0 -2.4375l1.65625 -1.0l0 3.4375l1.6874695 0l0 1.3125l-1.6874695 0l0 5.75q0 0.71875 0.078125 0.921875q0.09375 0.203125 0.296875 0.328125q0.203125 0.125 0.578125 0.125q0.26559448 0 0.7343445 -0.078125z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m137.9357 283.17322l86.866135 0" fill-rule="nonzero"></path><path stroke="#b45f06" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m137.9357 283.17322l62.866135 0" fill-rule="evenodd"></path><path fill="#b45f06" stroke="#b45f06" stroke-width="4.0" stroke-linecap="butt" d="m200.80183 289.78015l18.15239 -6.6069336l-18.15239 -6.6069336z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m340.19815 283.17322l86.86615 0" fill-rule="nonzero"></path><path stroke="#38761d" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m340.19815 283.17322l62.86615 0" fill-rule="evenodd"></path><path fill="#38761d" stroke="#38761d" stroke-width="4.0" stroke-linecap="butt" d="m403.0643 289.78015l18.152405 -6.6069336l-18.152405 -6.6069336z" fill-rule="evenodd"></path><path fill="#f4cccc" d="m30.127296 171.00525l0 0c0 -29.518967 23.372852 -53.448822 52.204727 -53.448822l0 0c13.845551 0 27.124023 5.6312027 36.914307 15.6548c9.790291 10.02359 15.290413 23.618515 15.290413 37.79402l0 0c0 29.518967 -23.372849 53.448822 -52.20472 53.448822l0 0c-28.831875 0 -52.204727 -23.929855 -52.204727 -53.448822z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m30.127296 171.00525l0 0c0 -29.518967 23.372852 -53.448822 52.204727 -53.448822l0 0c13.845551 0 27.124023 5.6312027 36.914307 15.6548c9.790291 10.02359 15.290413 23.618515 15.290413 37.79402l0 0c0 29.518967 -23.372849 53.448822 -52.20472 53.448822l0 0c-28.831875 0 -52.204727 -23.929855 -52.204727 -53.448822z" fill-rule="nonzero"></path><path fill="#000000" d="m67.64894 166.92525l0 -13.59375l5.109375 0q1.546875 0 2.484375 0.40625q0.953125 0.40625 1.484375 1.265625q0.53125 0.859375 0.53125 1.796875q0 0.875 -0.46875 1.65625q-0.46875 0.765625 -1.4375 1.234375q1.234375 0.359375 1.890625 1.234375q0.671875 0.875 0.671875 2.0625q0 0.953125 -0.40625 1.78125q-0.390625 0.8125 -0.984375 1.265625q-0.59375 0.4375 -1.5 0.671875q-0.890625 0.21875 -2.1875 0.21875l-5.1875 0zm1.796875 -7.890625l2.9375 0q1.203125 0 1.71875 -0.15625q0.6875 -0.203125 1.03125 -0.671875q0.359375 -0.46875 0.359375 -1.1875q0 -0.671875 -0.328125 -1.1875q-0.328125 -0.515625 -0.9375 -0.703125q-0.59375 -0.203125 -2.0625 -0.203125l-2.71875 0l0 4.109375zm0 6.28125l3.390625 0q0.875 0 1.21875 -0.0625q0.625 -0.109375 1.046875 -0.359375q0.421875 -0.265625 0.6875 -0.765625q0.265625 -0.5 0.265625 -1.140625q0 -0.765625 -0.390625 -1.328125q-0.390625 -0.5625 -1.078125 -0.78125q-0.6875 -0.234375 -1.984375 -0.234375l-3.15625 0l0 4.671875zm16.959198 1.609375l0 -1.453125q-1.140625 1.671875 -3.125 1.671875q-0.859375 0 -1.625 -0.328125q-0.75 -0.34375 -1.125 -0.84375q-0.359375 -0.5 -0.515625 -1.234375q-0.09375 -0.5 -0.09375 -1.5625l0 -6.109375l1.671875 0l0 5.46875q0 1.3125 0.09375 1.765625q0.15625 0.65625 0.671875 1.03125q0.515625 0.375 1.265625 0.375q0.75 0 1.40625 -0.375q0.65625 -0.390625 0.921875 -1.046875q0.28125 -0.671875 0.28125 -1.9375l0 -5.28125l1.671875 0l0 9.859375l-1.5 0zm3.8444672 3.796875l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#000000" d="m58.91818 188.92525l0 -13.59375l5.125004 0q1.359375 0 2.078125 0.125q1.0 0.171875 1.671875 0.640625q0.671875 0.46875 1.078125 1.3125q0.421875 0.84375 0.421875 1.84375q0 1.734375 -1.109375 2.9375q-1.09375 1.203125 -3.984375 1.203125l-3.4843788 0l0 5.53125l-1.796875 0zm1.796875 -7.140625l3.5156288 0q1.75 0 2.46875 -0.640625q0.734375 -0.65625 0.734375 -1.828125q0 -0.859375 -0.4375 -1.46875q-0.421875 -0.609375 -1.125 -0.796875q-0.453125 -0.125 -1.671875 -0.125l-3.4843788 0l0 4.859375zm9.802952 2.21875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.250717 4.921875l0 -13.59375l1.671875 0l0 13.59375l-1.671875 0zm4.191696 -11.6875l0 -1.90625l1.671875 0l0 1.90625l-1.671875 0zm0 11.6875l0 -9.859375l1.671875 0l0 9.859375l-1.671875 0zm10.566696 -3.609375l1.640625 0.21875q-0.265625 1.6875 -1.375 2.65625q-1.109375 0.953125 -2.734375 0.953125q-2.015625 0 -3.25 -1.3125q-1.21875 -1.328125 -1.21875 -3.796875q0 -1.59375 0.515625 -2.78125q0.53125 -1.203125 1.609375 -1.796875q1.09375 -0.609375 2.359375 -0.609375q1.609375 0 2.625 0.8125q1.015625 0.8125 1.3125 2.3125l-1.625 0.25q-0.234375 -1.0 -0.828125 -1.5q-0.59375 -0.5 -1.421875 -0.5q-1.265625 0 -2.0625 0.90625q-0.78125 0.90625 -0.78125 2.859375q0 1.984375 0.765625 2.890625q0.765625 0.890625 1.984375 0.890625q0.984375 0 1.640625 -0.59375q0.65625 -0.609375 0.84375 -1.859375zm2.8125 7.40625l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#f4cccc" d="m430.46326 150.96063l0 0c0 -29.518967 23.372864 -53.448822 52.204712 -53.448822l0 0c13.845551 0 27.124023 5.6312027 36.914307 15.6548c9.790283 10.023598 15.290405 23.618515 15.290405 37.79402l0 0c0 29.518967 -23.372833 53.448822 -52.204712 53.448822l0 0c-28.831848 0 -52.204712 -23.929855 -52.204712 -53.448822z" fill-rule="nonzero"></path><path stroke="#000000" stroke-width="2.0" stroke-linejoin="round" stroke-linecap="butt" d="m430.46326 150.96063l0 0c0 -29.518967 23.372864 -53.448822 52.204712 -53.448822l0 0c13.845551 0 27.124023 5.6312027 36.914307 15.6548c9.790283 10.023598 15.290405 23.618515 15.290405 37.79402l0 0c0 29.518967 -23.372833 53.448822 -52.204712 53.448822l0 0c-28.831848 0 -52.204712 -23.929855 -52.204712 -53.448822z" fill-rule="nonzero"></path><path fill="#000000" d="m467.9729 142.50563l1.6875 -0.140625q0.125 1.015625 0.5625 1.671875q0.4375 0.65625 1.359375 1.0625q0.9375 0.40625 2.09375 0.40625q1.03125 0 1.8125 -0.3125q0.796875 -0.3125 1.1875 -0.84375q0.390625 -0.53125 0.390625 -1.15625q0 -0.640625 -0.375 -1.109375q-0.375 -0.484375 -1.234375 -0.8125q-0.546875 -0.21875 -2.421875 -0.65625q-1.875 -0.453125 -2.625 -0.859375q-0.96875 -0.515625 -1.453125 -1.265625q-0.46875 -0.75 -0.46875 -1.6875q0 -1.03125 0.578125 -1.921875q0.59375 -0.90625 1.703125 -1.359375q1.125 -0.46875 2.5 -0.46875q1.515625 0 2.671875 0.484375q1.15625 0.484375 1.765625 1.4375q0.625 0.9375 0.671875 2.140625l-1.71875 0.125q-0.140625 -1.28125 -0.953125 -1.9375q-0.796875 -0.671875 -2.359375 -0.671875q-1.625 0 -2.375 0.609375q-0.75 0.59375 -0.75 1.4375q0 0.734375 0.53125 1.203125q0.515625 0.46875 2.703125 0.96875q2.203125 0.5 3.015625 0.875q1.1875 0.546875 1.75 1.390625q0.578125 0.828125 0.578125 1.921875q0 1.09375 -0.625 2.0625q-0.625 0.953125 -1.796875 1.484375q-1.15625 0.53125 -2.609375 0.53125q-1.84375 0 -3.09375 -0.53125q-1.25 -0.546875 -1.96875 -1.625q-0.703125 -1.078125 -0.734375 -2.453125zm19.584198 1.203125l1.71875 0.21875q-0.40625 1.5 -1.515625 2.34375q-1.09375 0.828125 -2.8125 0.828125q-2.15625 0 -3.421875 -1.328125q-1.265625 -1.328125 -1.265625 -3.734375q0 -2.484375 1.265625 -3.859375q1.28125 -1.375 3.328125 -1.375q1.984375 0 3.234375 1.34375q1.25 1.34375 1.25 3.796875q0 0.140625 -0.015625 0.4375l-7.34375 0q0.09375 1.625 0.921875 2.484375q0.828125 0.859375 2.0625 0.859375q0.90625 0 1.546875 -0.46875q0.65625 -0.484375 1.046875 -1.546875zm-5.484375 -2.703125l5.5 0q-0.109375 -1.234375 -0.625 -1.859375q-0.796875 -0.96875 -2.078125 -0.96875q-1.140625 0 -1.9375 0.78125q-0.78125 0.765625 -0.859375 2.046875zm9.078827 5.875l0 -13.59375l1.671875 0l0 13.59375l-1.671875 0zm4.1448364 0l0 -13.59375l1.671875 0l0 13.59375l-1.671875 0z" fill-rule="nonzero"></path><path fill="#000000" d="m459.25415 168.88063l0 -13.59375l5.125 0q1.359375 0 2.078125 0.125q1.0 0.171875 1.671875 0.640625q0.671875 0.46875 1.078125 1.3125q0.421875 0.84375 0.421875 1.84375q0 1.734375 -1.109375 2.9375q-1.09375 1.203125 -3.984375 1.203125l-3.484375 0l0 5.53125l-1.796875 0zm1.796875 -7.140625l3.515625 0q1.75 0 2.46875 -0.640625q0.734375 -0.65625 0.734375 -1.828125q0 -0.859375 -0.4375 -1.46875q-0.421875 -0.609375 -1.125 -0.796875q-0.453125 -0.125 -1.671875 -0.125l-3.484375 0l0 4.859375zm9.802948 2.21875q0 -2.734375 1.53125 -4.0625q1.265625 -1.09375 3.09375 -1.09375q2.03125 0 3.3125 1.34375q1.296875 1.328125 1.296875 3.671875q0 1.90625 -0.578125 3.0q-0.5625 1.078125 -1.65625 1.6875q-1.078125 0.59375 -2.375 0.59375q-2.0625 0 -3.34375 -1.328125q-1.28125 -1.328125 -1.28125 -3.8125zm1.71875 0q0 1.890625 0.828125 2.828125q0.828125 0.9375 2.078125 0.9375q1.25 0 2.0625 -0.9375q0.828125 -0.953125 0.828125 -2.890625q0 -1.828125 -0.828125 -2.765625q-0.828125 -0.9375 -2.0625 -0.9375q-1.25 0 -2.078125 0.9375q-0.828125 0.9375 -0.828125 2.828125zm9.250702 4.921875l0 -13.59375l1.671875 0l0 13.59375l-1.671875 0zm4.1917114 -11.6875l0 -1.90625l1.671875 0l0 1.90625l-1.671875 0zm0 11.6875l0 -9.859375l1.671875 0l0 9.859375l-1.671875 0zm10.566681 -3.609375l1.640625 0.21875q-0.265625 1.6875 -1.375 2.65625q-1.109375 0.953125 -2.734375 0.953125q-2.015625 0 -3.25 -1.3125q-1.21875 -1.328125 -1.21875 -3.796875q0 -1.59375 0.515625 -2.78125q0.53125 -1.203125 1.609375 -1.796875q1.09375 -0.609375 2.359375 -0.609375q1.609375 0 2.625 0.8125q1.015625 0.8125 1.3125 2.3125l-1.625 0.25q-0.234375 -1.0 -0.828125 -1.5q-0.59375 -0.5 -1.421875 -0.5q-1.265625 0 -2.0625 0.90625q-0.78125 0.90625 -0.78125 2.859375q0 1.984375 0.765625 2.890625q0.765625 0.890625 1.984375 0.890625q0.984375 0 1.640625 -0.59375q0.65625 -0.609375 0.84375 -1.859375zm2.8125 7.40625l-0.171875 -1.5625q0.546875 0.140625 0.953125 0.140625q0.546875 0 0.875 -0.1875q0.34375 -0.1875 0.5625 -0.515625q0.15625 -0.25 0.5 -1.25q0.046875 -0.140625 0.15625 -0.40625l-3.734375 -9.875l1.796875 0l2.046875 5.71875q0.40625 1.078125 0.71875 2.28125q0.28125 -1.15625 0.6875 -2.25l2.09375 -5.75l1.671875 0l-3.75 10.03125q-0.59375 1.625 -0.9375 2.234375q-0.4375 0.828125 -1.015625 1.203125q-0.578125 0.390625 -1.375 0.390625q-0.484375 0 -1.078125 -0.203125z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m82.67191 6.252214l-0.3464508 106.07874" fill-rule="nonzero"></path><path stroke="#f1c232" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m82.67191 6.252214l-0.2680664 82.07887" fill-rule="evenodd"></path><path fill="#f1c232" stroke="#f1c232" stroke-width="4.0" stroke-linecap="butt" d="m75.79695 88.3095l6.5476074 18.173874l6.666176 -18.130714z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m482.66928 89.19433l0 -83.779526" fill-rule="nonzero"></path><path stroke="#f1c232" stroke-width="4.0" stroke-linejoin="round" stroke-linecap="butt" d="m482.66928 89.19433l0 -59.77953" fill-rule="evenodd"></path><path fill="#f1c232" stroke="#f1c232" stroke-width="4.0" stroke-linecap="butt" d="m489.2762 29.414799l-6.6069336 -18.15239l-6.6069336 18.15239z" fill-rule="evenodd"></path></g></svg>
+
diff --git a/source/arche/tutorial_py/testing.rst b/source/arche/tutorial_py/testing.rst
new file mode 100644
index 000000000..688b997c1
--- /dev/null
+++ b/source/arche/tutorial_py/testing.rst
@@ -0,0 +1,4 @@
+Adding a Test
+================
+Feel free to use pytest, nosetests, or your favorite Python testing framework to test your
+archetypes.
\ No newline at end of file
diff --git a/source/arche/tutorial_py/toolkit.rst b/source/arche/tutorial_py/toolkit.rst
new file mode 100644
index 000000000..47ec1f62d
--- /dev/null
+++ b/source/arche/tutorial_py/toolkit.rst
@@ -0,0 +1,329 @@
+Adding Resource Buffers
+=================================================
+In this lesson, we will:
+
+1. Add ResBufs to track material inventories
+2. Add a notion of total storage capacity
+
+Overview
+--------------
+Cyclus has a collection of standard patterns that can be used by
+archetype developers. There are many advantages to using the toolkit patterns
+rather than developing similar functionality yourself, typical of most code
+reuse situations:
+
+* robustness - toolkit patterns have been subjected to the Cyclus QA process
+* time savings - It will take less time to learn how to use a toolkit than it takes to develop your own
+* improvements - You can benefit immediately from any improvements in the performance of the toolkit pattern
+
+Code reuse is a critical best practice in all software development.
+
+One of the toolkit patterns is a ``ResBuf``, providing a way to track an
+inventory of ``Resource`` objects.
+
+Add State Variables and Resource Buffers
+------------------------------------------
+All state variable additions should be included in ``~/tutorial/tut/agents.py`` below the
+other state variables added previously in this tutorial.
+
+A ``ResBuf`` is available as a data type in the typesystem. However, to use it
+as a state variable, so we instead have to use the ``ResBufMaterialInv`` or
+``RefBufProductInv`` classes. These inventories should be added below the other state
+variables we have already applied to the storage class.
+
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    from cyclus.agents import Facility
+    import cyclus.typesystem as ts
+
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        # this facility holds material in storage.
+        inventory = ts.ResBufMaterialInv()
+
+
+This creates a state variable named ``inventory`` that is based on the
+``ResBuf`` class.  We'll explain how buffers
+work in just a moment.  A ResBuf object and its ``ts.Inventory`` state var has special
+handling by the Python ``Agent`` class from which ``Facility`` inherits. It will not appear
+in the schema and therefore will not appear in the Cycic UI either.
+
+Next, add two additional buffers:
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        # this facility holds material in storage.
+        inventory = ts.ResBufMaterialInv()
+        # a buffer for incoming material
+        input = ts.ResBufMaterialInv()
+        # a buffer for outgoing material
+        output = ts.ResBufMaterialInv()
+
+
+Finally, check that everything works by reinstalling like before.
+You can also confirm that everything still works with running the simulation:
+
+.. code-block:: console
+
+    ~/tutorial $ cyclus -v 3 input/storage.py
+                  :
+              .CL:CC CC             _Q     _Q  _Q_Q    _Q    _Q              _Q
+            CC;CCCCCCCC:C;         /_\)   /_\)/_/\\)  /_\)  /_\)            /_\)
+            CCCCCCCCCCCCCl       __O|/O___O|/O_OO|/O__O|/O__O|/O____________O|/O__
+         CCCCCCf     iCCCLCC     /////////////////////////////////////////////////
+         iCCCt  ;;;;;.  CCCC
+        CCCC  ;;;;;;;;;. CClL.                          c
+       CCCC ,;;       ;;: CCCC  ;                   : CCCCi
+        CCC ;;         ;;  CC   ;;:                CCC`   `C;
+      lCCC ;;              CCCC  ;;;:             :CC .;;. C;   ;    :   ;  :;;
+      CCCC ;.              CCCC    ;;;,           CC ;    ; Ci  ;    :   ;  :  ;
+       iCC :;               CC       ;;;,        ;C ;       CC  ;    :   ; .
+      CCCi ;;               CCC        ;;;.      .C ;       tf  ;    :   ;  ;.
+      CCC  ;;               CCC          ;;;;;;; fC :       lC  ;    :   ;    ;:
+       iCf ;;               CC         :;;:      tC ;       CC  ;    :   ;     ;
+      fCCC :;              LCCf      ;;;:         LC :.  ,: C   ;    ;   ; ;   ;
+      CCCC  ;;             CCCC    ;;;:           CCi `;;` CC.  ;;;; :;.;.  ; ,;
+        CCl ;;             CC    ;;;;              CCC    CCL
+       tCCC  ;;        ;; CCCL  ;;;                  tCCCCC.
+        CCCC  ;;     :;; CCCCf  ;                     ,L
+         lCCC   ;;;;;;  CCCL
+         CCCCCC  :;;  fCCCCC
+          . CCCC     CCCC .
+           .CCCCCCCCCCCCCi
+              iCCCCCLCf
+               .  C. ,
+                  :
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    Experimental Warning: ResBuf is experimental and its API may be subject to change
+    INFO1(core  ):Simulation set to run from start=0 to end=10
+    INFO1(core  ):Beginning simulation
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+    INFO1(tutori):Hello
+    INFO1(tutori):World!
+
+    Status: Cyclus run successful!
+    Output location: cyclus.sqlite
+    Simulation ID: 9f15b93c-9ab2-49bb-a14f-fef872e64ce8
+
+
+Add Implementation Logic
+-----------------------------
+The goal of a storage facility is to ask for material up to some limit, store it
+for an amount of time, and then send it on to any interested parties. This can
+be implemented in Cyclus by utilizing the Toolkit objects stated above. The buy
+and sell policies will automatically fill and empty the input and output
+buffers, respectively.  A concept of material flow through the facility is
+shown below.
+
+.. figure:: storage_diagram.svg
+    :width: 75 %
+    :align: center
+
+    **Figure:** Material flow through a Storage facility. Green arrows occur
+    **before** the DRE (during the Tick). Yellow arrows occur during the
+    DRE. Brown arrows occur **after** the DRE (during the Tock).
+
+
+Buffer Transfer Logic
+++++++++++++++++++++++++++++++++
+The job of the ``Storage`` archetype developer is to determine and implement
+the logic related to transfering material between the input and output buffers
+and the middle inventory buffer. Two rules govern buffer transfer logic
+in this model:
+
+1. All material in the input buffer is transferred to the inventory buffer
+2. Material in the inventory buffer that has been stored for long enough is
+   transferred to the output buffer
+
+Because the input buffer transfer should occur *after* the DRE, it must happen
+in the ``tock()`` method. Similarly, because the output buffer transfer should
+occur *before* the DRE, it must happen in the ``tick()`` method. For each
+transfer, care must be taken to update the ``entry_times`` list appropriately.
+
+The input buffer transfer requires the following operation for each object in
+the buffer:
+
+1. *Pop* the object from the input buffer
+2. *Push* the object to the inventory buffer
+3. *Push* the current time to the ``entry_times``
+
+In order to implement this, add or replace the current ``tock()`` implementation in
+``agents/py`` with:
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        def __init__(self, ctx):
+            """Agents that have an init method must accept a context and must call super
+            first thing!
+            """
+            super().__init__(ctx)
+            self.entry_times = []
+
+        def tock(self):
+            t = self.context.time
+            while not self.input.empty():
+                self.inventory.push(self.input.pop())
+                entry_times.append(t)
+
+The output buffer transfer requires the following operation so long as the
+condition in 1. is met:
+
+1. Check whether enough time has passed since the time at the front of
+   ``entry_times`` *and* the inventory is not empty. If so:
+2. *pop()* an object from the inventory buffer
+3. *push()* that object to the output buffer
+4. *pop()* a time from the ``entry_times``
+
+In order to implement this, replace the current ``tick()`` implementation in
+``agents.py`` with
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        def tick(self):
+            finished_storing = self.context.time - self.storage_time
+            while (not self.inventory.empty()) and (self.entry_times[0] <= finished_storing):
+                self.output.push(self.inventory.pop())
+                del self.entry_times[0]
+
+
+At this point, please feel free to reinstall and rerun.
+
+Add a State Variable to Define Storage Capcity
+-------------------------------------------------------------
+A natural extension for the current storage facility implementation is to have a
+maximum storage capacity. To do so, first add a capacity state variable to
+storage.h . If you still want the input file to work, you have to provide a
+``default`` key in the pragma data structure. A sufficiently large value will
+do.
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        capacity = ts.Double(
+            doc='Maximum storage capacity (including all material in the facility)',
+            tooltip='Maximum storage capacity',
+            units='kg',
+            default=1e200,
+            uilabel='Maximum Storage Capacity',
+            )
+
+The required implementation is nontrivial. The goal of adding a capacity
+member is to guarantee that the amount of material in the facility never exceeds
+a certain value. The only way for material to enter the facility is through the
+``input`` ResBuff.
+
+.. figure:: storage_capacity.svg
+    :align: center
+
+    **Figure:** Storage buffers between two time steps. The total capacity is
+    represented by the area of all three boxes. The ``input`` buffer's capacity
+    must be updated to reflect how much material is in both the ``inventory``
+    and ``output`` buffers. The colored arrows on the right match the material
+    flows in the previous figure.
+
+
+To do so, add the following line to the end of the ``tick()`` function (in the
+implementation file), which updates capacity of the ``input`` through the
+``ResBuf`` ``capacity`` API.
+
+**~/tutorial/tut/agents.py:**
+
+.. code-block:: python
+
+    class Storage(Facility):
+        """My storage facility."""
+        ...
+        def tick(self):
+            finished_storing = self.context.time - self.storage_time
+            while (not self.inventory.empty()) and (self.entry_times[0] <= finished_storing):
+                self.output.push(self.inventory.pop())
+                del self.entry_times[0]
+            # only allow requests up to the storage capacity
+            self.input.capacity = self.capacity - self.inventory.quantity - self.output.quantity
+
+
+
+Update Input File and Run
+++++++++++++++++++++++++++++++++
+You can test that your new capacity capability works by adding the following to
+the end of the ``config`` block for ``Storage`` (before the close tag
+</Storage>) in ``input/storage.py``
+
+
+**~/tutorial/input/storage.py:**
+
+.. code-block:: python
+
+    {
+    # ...
+    'facility': {'config': {'Storage': {
+                                'throughput': 10,
+                                'storage_time': 1,
+                                'incommod': 'fuel',
+                                'outcommod': 'stored_fuel',
+                                # capacity is optional since it has a default
+                                'capacity': 8,
+                                }},
+                            'name': 'OneFacility'}
+    # ...
+    }
+
+
+Note that this capacity is smaller than the throughput! What do you think you
+will see in the output logs?
+
+Try it out (don't forget to delete the old sqlite file first)!
diff --git a/source/cyclusagent.py b/source/cyclusagent.py
index 3fc5a339e..f2237d763 100644
--- a/source/cyclusagent.py
+++ b/source/cyclusagent.py
@@ -1,7 +1,7 @@
-"""This module adds a reST directive to sphinx that generates cyclus agent 
-documentation based on its annotations and schema. The user simply specifies 
-the normal cyclus agent spec for the agent that they wish to document. 
-For example, 
+"""This module adds a reST directive to sphinx that generates cyclus agent
+documentation based on its annotations and schema. The user simply specifies
+the normal cyclus agent spec for the agent that they wish to document.
+For example,
 
     .. cyclus-agent:: tests:TestFacility:TestFacility
 
@@ -26,7 +26,7 @@
 
 from docutils import io, nodes, statemachine, utils
 try:
-    from docutils.utils.error_reporting import ErrorString  # the new way 
+    from docutils.utils.error_reporting import ErrorString  # the new way
 except ImportError:
     from docutils.error_reporting import ErrorString        # the old way
 from docutils.parsers.rst import Directive, convert_directive_function
@@ -43,7 +43,7 @@
     def indent(text, prefix):
         lines = text.splitlines(True)
         s = prefix + prefix.join(lines)
-        return s 
+        return s
 elif sys.version_info[0] >= 3:
     STRING_TYPES = (str,)
     IS_PY3 = True
@@ -132,13 +132,13 @@ def prepare_type(cpptype, othertype):
     'boost::uuids::uuid': 'token',
     # UI types
     'nuclide': 'string',
-    'commodity': 'string', 
-    'incommodity': 'string', 
-    'outcommodity': 'string', 
-    'range': None, 
-    'combobox': None, 
-    'facility': None, 
-    'prototype': 'string', 
+    'commodity': 'string',
+    'incommodity': 'string',
+    'outcommodity': 'string',
+    'range': None,
+    'combobox': None,
+    'facility': None,
+    'prototype': 'string',
     'recipe': 'string',
     'none': None,
     None: None,
@@ -242,6 +242,7 @@ def build_xml_sample(cpptype, schematype=None, uitype=None, names=None, units=No
     _, lines = s.split("\n", 1)
     return lines
 
+
 def build_json_sample(cpptype, schematype=None, uitype=None, names=None, units=None, default=None):
     schematype = prepare_type(cpptype, schematype)
     uitype = prepare_type(cpptype, uitype)
@@ -260,7 +261,7 @@ def build_json_sample(cpptype, schematype=None, uitype=None, names=None, units=N
         defstr = json.dumps(default) if isinstance(default, STRING_TYPES) else default
 
         if default is None or defstr == '"null"':
-            defstr = '"<required>"' 
+            defstr = '"<required>"'
 
         if isinstance(units, STRING_TYPES):
             impl += '{{"{0}": {1}}}  # {2}, {3}'.format(name, defstr, d_type, units)
@@ -307,7 +308,7 @@ def build_json_sample(cpptype, schematype=None, uitype=None, names=None, units=N
         impl += indent('{' + post.rstrip() + ',\n', '    ')
         pre, post = y.split('{', 1)
         post, _, _ = post.rpartition('}')
-        impl += indent(post + '},\n', '    ')        
+        impl += indent(post + '},\n', '    ')
         impl += indent('...\n', '  ')
         impl += ']}}'
     elif t == 'std::pair':
@@ -335,8 +336,121 @@ def build_json_sample(cpptype, schematype=None, uitype=None, names=None, units=N
         raise RuntimeError(msg)
     return impl
 
+
+def build_py_sample(cpptype, schematype=None, uitype=None, names=None, units=None, default=None):
+    schematype = prepare_type(cpptype, schematype)
+    uitype = prepare_type(cpptype, uitype)
+    names = prepare_type(cpptype, names)
+    units = prepare_type(cpptype, units)
+
+    impl = ''
+    t = cpptype if isinstance(cpptype, STRING_TYPES) else cpptype[0]
+    if t in PRIMITIVES:
+        name = 'val'
+        if names is not None:
+            name = names
+        d_type = _type(t, schematype or uitype)
+        d_type = uitype if uitype in special_uitypes else d_type
+
+        if isinstance(default, STRING_TYPES):
+            defstr = repr(default)
+        elif t == 'bool':
+            defstr = bool(default)
+        else:
+            defstr = default
+
+        required = False
+        if default is None or defstr == 'None':
+            if t == 'int':
+                defstr = '0'
+            elif t == 'float' or t == 'double':
+                defstr = '0.0'
+            elif t == 'bool':
+                defstr = 'False'
+            else:
+                defstr = '""'
+            required = True
+
+        if isinstance(units, STRING_TYPES):
+            impl += '{{"{0}": {1}}}  # {2}, {3}'.format(name, defstr, d_type, units)
+        else:
+            impl += '{{"{0}": {1}}}  # {2}'.format(name, defstr, d_type)
+        if required:
+            impl += ', required'
+        else:
+            impl += ', optional'
+    elif t in ['std::list', 'std::set', 'std::vector']:
+        name = 'list' if names[0] is None else names[0]
+        impl += '{{"{0}":'.format(name)
+        x = build_py_sample(cpptype[1], schematype[1], uitype[1], names[1], units[1])
+        pre, post = x.split(':', 1)
+        post, _ = post.rsplit('}', 1)
+        impl += indent(pre + ': [\n', "  ")
+        impl += indent(post.rstrip() + ",\n", '  ')
+        impl += indent(post.rstrip() + ",\n", '  ')
+        impl += indent('...\n', '  ')
+        impl += ']}}'
+    elif t == 'std::map':
+        name = 'map'
+        if isinstance(names[0], STRING_TYPES):
+            names[0] = [names[0], None]
+        elif names[0] is None:
+            names[0] = [name, None]
+        if names[0][0] is not None:
+            name = names[0][0]
+        itemname = 'item' if names[0][1] is None else names[0][1]
+        keynames = 'key' if isinstance(cpptype[1], STRING_TYPES) else ['key']
+        if names[1] is not None:
+            keynames = names[1]
+        valnames = 'val' if isinstance(cpptype[2], STRING_TYPES) else ['val']
+        if names[1] is not None:
+            valnames = names[2]
+        impl += '{{"{0}": {{\n'.format(name)
+        impl += indent('"{0}": [{{\n'.format(itemname), '  ')
+        x = build_py_sample(cpptype[1], schematype[1], uitype[1], keynames, units[1])
+        pre, post = x.split('{', 1)
+        post, _ = post.rsplit('}', 1)
+        impl += indent(post.rstrip() + ',\n', '    ')
+        y = build_py_sample(cpptype[2], schematype[2], uitype[2], valnames, units[2])
+        pre, post = y.split('{', 1)
+        post, _, _ = post.rpartition('}')
+        impl += indent(post + '},\n', '    ')
+        pre, post = x.split('{', 1)
+        post, _ = post.rsplit('}', 1)
+        impl += indent('{' + post.rstrip() + ',\n', '    ')
+        pre, post = y.split('{', 1)
+        post, _, _ = post.rpartition('}')
+        impl += indent(post + '},\n', '    ')
+        impl += indent('...\n', '  ')
+        impl += ']}}'
+    elif t == 'std::pair':
+        name = 'pair'
+        if names[0] is not None:
+            name = names[0]
+        firstname = 'first' if isinstance(cpptype[1], STRING_TYPES) else ['first']
+        if names[1] is not None:
+            firstname = names[1]
+        secondname = 'second' if isinstance(cpptype[2], STRING_TYPES) else ['second']
+        if names[2] is not None:
+            secondname = names[2]
+        x = build_py_sample(cpptype[1], schematype[1], uitype[1], firstname, units[1])
+        impl += '{{"{0}": {{\n'.format(name)
+        pre, post = x.split('{', 1)
+        post, _ = post.rsplit('}', 1)
+        impl += indent(post.rstrip() + ',\n', '  ')
+        y = build_py_sample(cpptype[2], schematype[2], uitype[2], secondname, units[2])
+        pre, post = y.split('{', 1)
+        post, _, _ = post.rpartition('}')
+        impl += indent(post.rstrip() + '\n', '  ')
+        impl += "  " + '}\n}'
+    else:
+        msg = 'Unsupported type {1}'.format(t)
+        raise RuntimeError(msg)
+    return impl
+
+
 class CyclusAgent(Directive):
-    """The cyclus-agent directive, which is based on constructing a list of 
+    """The cyclus-agent directive, which is based on constructing a list of
     of string lines of restructured text and then parsing it into its own node.
     """
     required_arguments = 1
@@ -411,7 +525,7 @@ def _sort_statevars(self, item):
         return val['index']
 
     def append_statevars(self):
-        vars = OrderedDict(sorted(self.annotations.get('vars', {}).items(), 
+        vars = OrderedDict(sorted(self.annotations.get('vars', {}).items(),
                            key=self._sort_statevars))
         if len(vars) == 0:
             return
@@ -431,7 +545,7 @@ def append_statevars(self):
 
             alias = info.get('alias', name)
             if isinstance(alias, STRING_TYPES):
-                name = alias 
+                name = alias
             elif isinstance(alias[0], STRING_TYPES):
                 name = alias[0]
             else:
@@ -455,7 +569,7 @@ def append_statevars(self):
             # add docs
             ind = " " * 4
             if 'doc' in info:
-                doc = ind + info['doc'].replace('\n', '\n'+ind) 
+                doc = ind + info['doc'].replace('\n', '\n'+ind)
                 lines += doc.splitlines()
                 lines.append('')
 
@@ -496,7 +610,16 @@ def append_statevars(self):
                     previndent = ' ' * (len(l) - len(l.lstrip()))
             self.lines.append('')
 
-
+            self.lines += [ind + '**Python:**', '', ind + '.. code-block:: python', '']
+            schemalines = build_py_sample(t, schematype, uitype, labels, units, default=info.get('default', None)).split('\n')
+            previndent = ''
+            for l in schemalines:
+                if len(l.strip()) > 0:
+                    if l.strip() == '...':
+                        l = previndent + l.strip()
+                    self.lines.append(ind + '    ' + l)
+                    previndent = ' ' * (len(l) - len(l.lstrip()))
+            self.lines.append('')
 
     def append_schema(self):
         header = 'XML Input Schema'
diff --git a/source/user/input_specs/archetypes.rst b/source/user/input_specs/archetypes.rst
index 286da6ff6..3f186b1c6 100644
--- a/source/user/input_specs/archetypes.rst
+++ b/source/user/input_specs/archetypes.rst
@@ -20,7 +20,7 @@ In addition to the unambiguous specification (as defined in
 elsewhere in the file.  If an alias is defined, it is the **only way** to
 refer to that archetype in other locations.
 
-Example 
+Example
 ++++++++
 
 .. code-block:: xml
@@ -54,12 +54,13 @@ defined in :doc:`../find_agents`.  For example, `simpleSource` will be found
 in a library file with a name such as `libsimpleSource.so`, in the standard
 |Cyclus| archetype path.
 
+This is what the example above would look like if written in JSON.
 
 .. code-block:: json
 
     {
     "archetypes": {
-      "spec": [ { 
+      "spec": [ {
         "path": "my/custom/path",
         "lib": "myAgentCollection",
         "alias": "ReactorAgent" },
@@ -67,11 +68,19 @@ in a library file with a name such as `libsimpleSource.so`, in the standard
        {"name": "simpleRegion" },
        {"name": "simpleInst" }
       ]
-    }
+    }}
 
+And similarly, in Python:
 
-This is what the example above would look like if written in JSON.
+.. code-block:: python
 
+    {"archetypes": {"spec": [
+        {"path": "my/custom/path", "lib": "myAgentCollection", "alias": "ReactorAgent"},
+        {"name": "simpleSource"},
+        {"name": "simpleRegion"},
+        {"name": "simpleInst" },
+        ]
+    }}
 
 .. rst-class:: html-toggle
 
@@ -80,9 +89,9 @@ Grammar Definition
 
 .. code-block:: xml
 
-  <element name="archetypes"> 
+  <element name="archetypes">
     <oneOrMore>
-      <element name="spec"> 
+      <element name="spec">
         <optional><element name="path"><text/></element></optional>
         <optional><element name="lib"><text/></element></optional>
         <element name="name"><text/></element>
diff --git a/source/user/input_specs/commodity.rst b/source/user/input_specs/commodity.rst
index 2434b3b8b..69bf85160 100644
--- a/source/user/input_specs/commodity.rst
+++ b/source/user/input_specs/commodity.rst
@@ -33,19 +33,27 @@ Example
     <solution_priority>4.5</solution_priority>
   </commodity>
 
+
 **JSON:**
 
 .. code-block:: json
 
-    {"commodity": {
-       "name": "enriched_u",
-       "solution_priority": 5.5 }
-     }
+    {"commodity": [
+        {"name": "enriched_u", "solution_priority": 5.5},
+        {"name": "waste", "solution_priority": 4.5}
+        ]
+    }
+
+
+**Python:**
 
-    {"commodity": {
-       "name": "waste",
-       "solution_priority": 4.5 }
-     }
+.. code-block:: python
+
+    {"commodity": [
+        {"name": "enriched_u", "solution_priority": 5.5},
+        {"name": "waste", "solution_priority": 4.5},
+        ],
+    }
 
 
 In this example, while there may be many commodities used in the problem, two
@@ -53,7 +61,7 @@ of them are given explicit priorities.  The ``enriched_u`` has the highest
 priority followed by ``waste``.  Note that these particular names do not imply
 any specific composition of the commodity; this will be determined later by
 the facilities that trade in these commodities.
- 
+
 
 .. rst-class:: html-toggle
 
diff --git a/source/user/input_specs/control.rst b/source/user/input_specs/control.rst
index 83b696f52..0f650d088 100644
--- a/source/user/input_specs/control.rst
+++ b/source/user/input_specs/control.rst
@@ -44,7 +44,7 @@ tag, and has the following sections in any order:
         - preconditioner (optional) - precondition greedy-solved graphs
 
           - choose one of:
-		  
+
 		    - ``greedy``: use an average-preference greedy preconditioner
 
       - ``coin-or``: use the COIN-OR CLP/CBC solver suite
@@ -72,7 +72,7 @@ Example
     <startmonth>11</startmonth>   <!-- start in november -->
     <duration>1200</duration>     <!-- run for 100 years -->
     <dt>86400</dt>                <!-- 1-day time steps -->
-    <decay>lazy</decay>           
+    <decay>lazy</decay>
   </control>
 
 
@@ -90,6 +90,20 @@ Example
       }
 
 
+**Python:**
+
+.. code-block:: python
+
+     {"control": {
+        "startyear": 2007,
+        "startmonth": 11,
+        "duration": 12 * 100,
+        "dt": 86400,
+        "decay": "lazy",
+        }
+      }
+
+
 This example starts in November 2007, and runs for 100 years (1200 months).
 
 
@@ -111,8 +125,8 @@ Grammar Definition
       <optional>
         <element name="decay"> <text/> </element>
       </optional>
-      <optional> 
-        <element name="dt"><data type="nonNegativeInteger"/></element> 
+      <optional>
+        <element name="dt"><data type="nonNegativeInteger"/></element>
       </optional>
       <optional>
         <element name="explicit_inventory"> <data type="boolean"/> </element>
@@ -121,7 +135,7 @@ Grammar Definition
         <element name="explicit_inventory_compact"> <data type="boolean"/> </element>
       </optional>
       <optional>
-        <element name="solver"> 
+        <element name="solver">
           <interleave>
             <optional><element name="config">
             <choice>
diff --git a/source/user/input_specs/facility.rst b/source/user/input_specs/facility.rst
index 9ba1acca4..73e2af915 100644
--- a/source/user/input_specs/facility.rst
+++ b/source/user/input_specs/facility.rst
@@ -16,6 +16,13 @@ Each ``facility`` block has the follwoing sections in any order:
 
 Example
 +++++++
+This example introduces two facility prototypes.  The first has the name
+`LongTermStorage`, and is configured from the :term:`archetype` with the name
+(or alias) `Sink`.  The contents of the ``Sink`` section are defined by the
+author of the `Sink` archetype.  The second has the name ``PBMR``, has a
+lifetime of 720 time steps (60 years) and is based on the archetype with the
+name (or alias) `RecipeReactor`.  The contents of the ``RecipeReactor``
+section are defined by the author of the `RecipeReactor` archetype.
 
 **XML:**
 
@@ -44,54 +51,34 @@ Example
 
 .. code-block:: json
 
-    {"facility": {
-      "config": {
-       "Sink": "(... archetype-specific input for a `Sink` archetype)"}, 
-      "name": "LongTermStorage"
-     }
-    }
- 
-    {"facility": {
-     "config": {
-      "RecipeReactor": "(... archetype-specific input for a `RecipeReactor` archetype)"}, 
-     "lifetime": 720, 
-     "name": "PBMR"
-     }
+    {"facility": [
+        {"config": {"Sink": "(... archetype-specific input for a `Sink` archetype)"},
+         "name": "LongTermStorage"
+         },
+        {"config": {
+            "RecipeReactor": "(... archetype-specific input for a `RecipeReactor` archetype)"},
+         "lifetime": 720,
+         "name": "PBMR"
+         }
+        ]
     }
 
 
-This example introduces two facility prototypes.  The first has the name
-`LongTermStorage`, and is configured from the :term:`archetype` with the name
-(or alias) `Sink`.  The contents of the ``Sink`` section are defined by the
-author of the `Sink` archetype.  The second has the name ``PBMR``, has a
-lifetime of 720 time steps (60 years) and is based on the archetype with the
-name (or alias) `RecipeReactor`.  The contents of the ``RecipeReactor``
-section are defined by the author of the `RecipeReactor` archetype.
-
-
-.. code-block:: json
-
-     {
-      "facility": {
-        "name": "LongTermStorage",
-        "config": {
-        "sink": "... archetype-specific input for a `Sink` archetype" }
-        }
-      }
-
-
-     {
-      "facility": {
-        "name": "PBMR",
-        "lifetime": 720,
-        "config": {
-        "RecipeReactor": "... archetype-specific input for a `RecipeReactor` archetype" }
-        }
-      }
+**Python:**
 
+.. code-block:: python
 
-This is what the example above would look like if written in JSON.
-
+    {"facility": [
+        {"config": {"Sink": "(... archetype-specific input for a `Sink` archetype)"},
+         "name": "LongTermStorage",
+         },
+        {"config": {
+            "RecipeReactor": "(... archetype-specific input for a `RecipeReactor` archetype)"},
+         "lifetime": 720,
+         "name": "PBMR",
+         },
+        ],
+    }
 
 .. rst-class:: html-toggle
 
@@ -99,7 +86,7 @@ Grammar Definition
 ++++++++++++++++++
 
 .. code-block:: xml
-   
+
     <element name="facility">
       <element name="name"> <text/> </element>
       <optional>
diff --git a/source/user/input_specs/inst.rst b/source/user/input_specs/inst.rst
index bf5dd5b75..1b5fd54f9 100644
--- a/source/user/input_specs/inst.rst
+++ b/source/user/input_specs/inst.rst
@@ -26,6 +26,15 @@ each contain the following sections, in the following order:
 
 Example
 +++++++
+This example introduces two institution agents (the region section that
+encloses them is not shown).  The first institution has the name
+`SingleInstitution`, and is configured from the :term:`archetype` with the
+name (or alias) `NullInst`.  The author of the ``NullInst`` archetype has
+defined no archetype-specific data. This agent begins the simulation with two
+facility agents, one based on the ``FacilityA`` prototype and another based on
+the ``FacilityB`` prototype.  The second institution has the name
+`AnotherInstitution`, is also configured from the archetype with the name (or
+alias) ``NullInst``.  This institution has no initial facilities.
 
 **XML:**
 
@@ -51,64 +60,47 @@ Example
       <config> <NullInst/> </config>
     </institution>
 
+
 **JSON:**
 
 .. code-block:: json
 
-    {"institution": {
-     "config": {"NullInst": null}, 
-     "initialfacilitylist": {
-      "entry": [
-       {"number": 1, "prototype": "FacilityA"}, 
-       {"number": 1, "prototype": "FacilityB"}
+    {"institution": [
+        {"config": {"NullInst": null},
+         "initialfacilitylist": {
+            "entry": [
+                {"number": 1, "prototype": "FacilityA"},
+                {"number": 1, "prototype": "FacilityB"}
+                ]
+            },
+         "name": "SingleInstitution"
+        },
+        {"config": {"NullInst": null},
+         "name": "AnotherInstitution"
+         }
         ]
-       }, 
-     "name": "SingleInstitution"
-      }
-     }
-
-    {"institution": {
-     "config": {"NullInst": null},
-     "name": "AnotherInstitution"
-     }
     }
 
 
-
-This example introduces two institution agents (the region section that
-encloses them is not shown).  The first institution has the name
-`SingleInstitution`, and is configured from the :term:`archetype` with the
-name (or alias) `NullInst`.  The author of the ``NullInst`` archetype has
-defined no archetype-specific data. This agent begins the simulation with two
-facility agents, one based on the ``FacilityA`` prototype and another based on
-the ``FacilityB`` prototype.  The second institution has the name
-`AnotherInstitution`, is also configured from the archetype with the name (or
-alias) ``NullInst``.  This institution has no initial facilities.
-
-
-.. code-block:: json
-
-     {
-      "institution": {
-        "name": "SingleInstitution",
-        "initialfacilitylist": [{
-          "entry": {
-            "prototype": "FacilityA",
-            "number": 1}},
-          {"entry": {"prototype": "FacilityB"}}],
-        "config": {}
-        }
-      }
-
-     {
-      "institution": {
-        "name": "AnotherInstitution",
-        "config": {}
-        }
-      }
-
-
-This is what the example above would look like if written in JSON.
+**Python:**
+
+.. code-block:: Python
+
+    {"institution": [
+        {"config": {"NullInst": None},
+         "initialfacilitylist": {
+            "entry": [
+                {"number": 1, "prototype": "FacilityA"},
+                {"number": 1, "prototype": "FacilityB"},
+                ],
+            },
+         "name": "SingleInstitution",
+        },
+        {"config": {"NullInst": None},
+         "name": "AnotherInstitution",
+         },
+        ],
+    }
 
 
 .. rst-class:: html-toggle
@@ -117,7 +109,7 @@ Grammar Definition
 ++++++++++++++++++
 
 .. code-block:: xml
-   
+
         <element name="institution"> <interleave>
           <element name="name"> <text/> </element>
           <optional>
diff --git a/source/user/input_specs/recipe.rst b/source/user/input_specs/recipe.rst
index 36ee5c36c..97744ed34 100644
--- a/source/user/input_specs/recipe.rst
+++ b/source/user/input_specs/recipe.rst
@@ -36,6 +36,12 @@ A ``recipe`` block has the following sections in the following order:
 
 Example
 +++++++
+This example defines two material compositions.  The first has the name
+``commod_recipe``, is defined using mass fractions, and contains a single
+nuclide of H-1.  The second recipe is named ``natU_recipe``, is defined using
+atom fractions, and contains two nuclides: 0.7% of the atoms are U-235 and
+99.3% of the atoms are U-238.
+
 
 **XML:**
 
@@ -61,41 +67,46 @@ Example
     </nuclide>
   </recipe>
 
+
 **JSON:**
 
 .. code-block:: json
 
      {
-      "recipe": {
-        "name": "proton_recipe",
-        "basis": "mass",
-        "nuclide": {
-          "id": "H1",
-          "comp": 1 } 
-        }
+      "recipe": [
+        {"name": "proton_recipe",
+         "basis": "mass",
+         "nuclide": {"id": "H1", "comp": 1}
+        },
+        {"name": "natU_recipe",
+         "basis": "atom",
+         "nuclide": [
+            {"id": "U235", "comp": 0.007},
+            {"id": "U238", "comp": 0.993}
+            ]
+         }
+        ]
       }
 
 
-     {
-      "recipe": {
-        "name": "natU_recipe",
-        "basis": "atom",
-        "nuclide": {
-          "id": "U235",
-          "comp": 0.007 },
-        "nuclide": {
-          "id": "U238",
-          "comp": 0.993 }
-        }
-      }
-
-This example defines two material compositions.  The first has the name
-`commod_recipe`, is defined using mass fractions, and contains a single
-nuclide of H-1.  The second recipe is named `natU_recipe`, is defined using
-atom fractions, and contains two nuclides: 0.7% of the atoms are U-235 and
-99.3% of the atoms are U-238.
+**Python:**
 
+.. code-block:: python
 
+     {"recipe": [
+        {"name": "proton_recipe",
+         "basis": "mass",
+         "nuclide": {"id": "H1", "comp": 1},
+        },
+        {"name": "natU_recipe",
+         "basis": "atom",
+         "nuclide": [
+            {"id": "U235", "comp": 0.007},
+            {"id": "U238", "comp": 0.993},
+            ],
+         },
+        ],
+      }
 
 .. rst-class:: html-toggle
 
diff --git a/source/user/input_specs/region.rst b/source/user/input_specs/region.rst
index 3abb22503..d75e51ffa 100644
--- a/source/user/input_specs/region.rst
+++ b/source/user/input_specs/region.rst
@@ -16,6 +16,13 @@ Each ``region`` block has the following sections in any order:
 
 Example
 +++++++
+This example introduces two region agents.  The first has the name
+`MyHomeRegion`, and is configured from the :term:`archetype` with the name (or
+alias) `NullRegion`.  The author of the ``NullRegion`` archetype has defined
+no archetype-specific data.  The second has the name ``MyNeighborRegion`` and
+is based on the archetype with the name (or alias) `GrowthRegion`.  The
+contents of the ``GrowthRegion`` section are defined by the author of the
+`GrowthRegion` archetype.
 
 **XML:**
 
@@ -32,8 +39,8 @@ Example
 
   <region>
     <name>MyNeighborRegion</name>
-    <config> 
-      <GrowthRegion> 
+    <config>
+      <GrowthRegion>
          ... archetype-specific input for a `GrowthRegion` archetype
       </GrowthRegion>
     </config>
@@ -42,43 +49,39 @@ Example
     </institution>
   </region>
 
-**JSON:**
 
-
-This example introduces two region agents.  The first has the name
-`MyHomeRegion`, and is configured from the :term:`archetype` with the name (or
-alias) `NullRegion`.  The author of the ``NullRegion`` archetype has defined
-no archetype-specific data.  The second has the name ``MyNeighborRegion`` and
-is based on the archetype with the name (or alias) `GrowthRegion`.  The
-contents of the ``GrowthRegion`` section are defined by the author of the
-`GrowthRegion` archetype.
+**JSON:**
 
 .. code-block:: json
 
      {
-      "region": {
-        "name": "MyHomeRegion",
-        "config": { },
-        "institution": "... data for this institution goes here" }
+      "region": [
+        {"name": "MyHomeRegion",
+         "config": { },
+         "institution": "... data for this institution goes here"}
+         },
+        {"name": "MyNeighborRegion",
+         "config": {"GrowthRegion": "... archetype-specific input for a GrowthRegion archetype"},
+         "institution": "... data for this institution goes here"}
+        ]
       }
 
 
-     {
-      "region": {
-        "name": "MyNeighborRegion",
-        "config": {
-          "GrowthRegion": "... archetype-specific input for a `GrowthRegion` archetype" },
-        "institution": "... data for this institution goes here" }
-      }
+**Python:**
 
+.. code-block:: python
+
+     {"region": [
+        {"name": "MyHomeRegion",
+         "config": { },
+         "institution": "... data for this institution goes here"},
+         },
+        {"name": "MyNeighborRegion",
+         "config": {"GrowthRegion": "... archetype-specific input for a GrowthRegion archetype"},
+         "institution": "... data for this institution goes here"},
+        ],
+      }
 
-This example introduces two region agents.  The first has the name
-`MyHomeRegion`, and is configured from the :term:`archetype` with the name (or
-alias) `NullRegion`.  The author of the ``NullRegion`` archetype has defined
-no archetype-specific data.  The second has the name ``MyNeighborRegion`` and
-is based on the archetype with the name (or alias) `GrowthRegion`.  The
-contents of the ``GrowthRegion`` section are defined by the author of the
-`GrowthRegion` archetype.
 
 
 .. rst-class:: html-toggle
@@ -87,7 +90,7 @@ Grammar Definition
 ++++++++++++++++++
 
 .. code-block:: xml
-   
+
     <element name="region"> <interleave>
       <element name="name"> <text/> </element>
       <optional>
diff --git a/source/user/writing_input.rst b/source/user/writing_input.rst
index 6d1f8d9c3..5ac25c451 100644
--- a/source/user/writing_input.rst
+++ b/source/user/writing_input.rst
@@ -1,7 +1,7 @@
 Writing a |Cyclus| Input File
 =============================
 This section will provide an introduction to creating a valid input file for
-|Cyclus| by hand.  Because |Cyclus| uses both XML and JSON, input files have clearly defined
+|Cyclus| by hand.  Because |Cyclus| uses XML, JSON, or Python, input files have clearly defined
 sections, or blocks, that can be automatically validated for correctness.
 
 Work is underway to provide a drag-and-drop graphical user interface to
@@ -28,6 +28,18 @@ Here is an example of a XML code block.
      <body>We have released Cyclus v1.0 for everyone to use.</body>
   </note>
 
+In this example, a section named ``note`` includes four other sections named
+``to``, ``from``, ``heading``, and ``body``, respectively.
+
+The set of tags for any given project, and their relationship to each other in
+the hierarchy, is referred to as a grammar.  In addition to defining which
+tags exist, the grammar defines how many times each tag must or may exist
+in a given section.  A tag may be completely optional, required one or more
+times, or allowed to appear as many times as the user desires.
+
+Although XML grammars are designed to be self-documenting, comments can be
+inserted into XML files anywhere using the ``<!-- comment here -->`` syntax,
+as shown above.
 
 
 A Brief Introduction to JSON
@@ -48,18 +60,28 @@ Here is the same code block using JSON.
     }
 
 
-In this example, a section named ``note`` includes four other sections named
-``to``, ``from``, ``heading``, and ``body``, respectively.  
+A Brief Introduction to Python
+------------------------------------
+`Python`_ is a fully featured dynamic programming language. It hosts a wide variety of
+primitives built in to the language as well as powerful 3rd part libraries. Python
+input files allow for the computation of mathematical expressions in the input file
+itself. Static, proecomputed values are not required (as with XML and JSON).
 
-The set of tags for any given project, and their relationship to each other in
-the hierarchy, is referred to as a grammar.  In addition to defining which
-tags exist, the grammar defines how many times each tag must or may exist
-in a given section.  A tag may be completely optional, required one or more
-times, or allowed to appear as many times as the user desires.
+Here is the same code block using Python.
 
-Although XML grammars are designed to be self-documenting, comments can be
-inserted into XML files anywhere using the ``<!-- comment here -->`` syntax,
-as shown above.
+.. code-block:: python
+
+    {"note": {
+        "to": "Matt",       # message recipient
+        "from": "Anthony",  # message sender
+        "heading": "Cyclus released today",
+        "body": "We have released Cyclus v1.0 for everyone to use.",
+        }
+    }
+
+
+In this example, a dictionary with a  ``note`` key is has a dictionary vary that includes
+four other keys named ``to``, ``from``, ``heading``, and ``body`` respectively.
 
 
 The |Cyclus| Input File
@@ -74,9 +96,9 @@ contains all data for a simulation.
    <simulation>
      ... simulation data will go here ...
    </simulation>
- 
-**JSON:** 
- 
+
+**JSON:**
+
 .. code-block:: json
 
     {
@@ -84,6 +106,22 @@ contains all data for a simulation.
           "… simulation data will go here …"
     }
 
+**Python:**
+
+.. code-block:: python
+
+    # Python input files will look for a variable named
+    # simulation, Simulation, or SIMULATION. It's value should be a
+    # dictionary with a single "simulation" key.
+    simulation = {"simulation": {...}}
+
+    # Alternitavely, the simualtion variable can also be a Python function or
+    # callable that returns a simulation dictionary. This function should not
+    # take any arguments.
+    def simulation():
+        return {"simulation": {...}}
+
+
 Although not all sections are required, the following sections may appear in
 any order in the input file:
 
@@ -101,14 +139,14 @@ any order in the input file:
 Including XML Files
 --------------------
 One feature of XML is that you are able to include external XML files inside of
-your current document. This lets you reuse common parts of your input file that 
+your current document. This lets you reuse common parts of your input file that
 do not change across multiple simulations. To enable XML include semantics
-the attribute ``xmlns:xi="http://www.w3.org/2001/XInclude"`` *must* be added to the 
-``<simulation>`` tag. Then to include an external 
+the attribute ``xmlns:xi="http://www.w3.org/2001/XInclude"`` *must* be added to the
+``<simulation>`` tag. Then to include an external
 file use the ``<xi:include href="path/to/file" />`` tag where you want the included
 file to go.
 
-A common inclusion pattern is to have a recipe book of materials in one file 
+A common inclusion pattern is to have a recipe book of materials in one file
 and then include this in your simulation.
 
 **input.xml:**
@@ -117,8 +155,8 @@ and then include this in your simulation.
 
     <simulation xmlns:xi="http://www.w3.org/2001/XInclude">
       ...
-      <xi:include href="recipebook.xml" /> 
-      ... 
+      <xi:include href="recipebook.xml" />
+      ...
     </simulation>
 
 **recipebook.xml:**