Repository: WISDEM/ORBIT (language: python)

Issue:
Changed required inputs for ElectricalCableInstallation from num_turb…
…ines/turbine_rating to plant.capacity

Closes #111 


Discussion / hints:

Fix patch:
diff --git a/ORBIT/core/library.py b/ORBIT/core/library.py
index a0dc514d..6f771cc0 100644
--- a/ORBIT/core/library.py
+++ b/ORBIT/core/library.py
@@ -286,7 +286,7 @@ def export_library_specs(key, filename, data, file_ext="yaml"):
     # project details
     "config": os.path.join("project", "config"),
     "plant": os.path.join("project", "plant"),
-    "port": os.path.join("project", "port"),
+    "port": os.path.join("project", "ports"),
     "project_development": os.path.join("project", "development"),
     "site": os.path.join("project", "site"),
     # substructures
diff --git a/ORBIT/manager.py b/ORBIT/manager.py
index cb72f6c1..5881191a 100644
--- a/ORBIT/manager.py
+++ b/ORBIT/manager.py
@@ -44,8 +44,8 @@
     GravityBasedInstallation,
     MooringSystemInstallation,
     ScourProtectionInstallation,
+    FloatingSubstationInstallation,
     OffshoreSubstationInstallation,
-    FloatingSubstationInstallation
 )
 from ORBIT.core.exceptions import (
     PhaseNotFound,
@@ -82,7 +82,7 @@ class ProjectManager:
         MooredSubInstallation,
         MooringSystemInstallation,
         GravityBasedInstallation,
-        FloatingSubstationInstallation
+        FloatingSubstationInstallation,
     ]
 
     def __init__(self, config, library_path=None, weather=None):
@@ -903,9 +903,6 @@ def turbine_rating(self):
     def logs(self):
         """Returns list of all logs in the project."""
 
-        if not self._output_logs:
-            raise Exception("Project hasn't been ran yet.")
-
         return sorted(self._output_logs, key=lambda l: l["time"])
 
     @property
diff --git a/ORBIT/phases/design/array_system_design.py b/ORBIT/phases/design/array_system_design.py
index 36125876..1a25ab9f 100644
--- a/ORBIT/phases/design/array_system_design.py
+++ b/ORBIT/phases/design/array_system_design.py
@@ -130,6 +130,8 @@ def detailed_output(self):
             "array_system_length_by_type": self.total_cable_length_by_type,
             "array_system_total_cost": self.total_cable_cost,
             "array_system_cost_by_type": self.cost_by_type,
+            "array_system_num_turbines_full_string": self.num_turbines_full_string,
+            "array_system_num_full_strings": self.num_full_strings,
         }
 
         return _output
diff --git a/ORBIT/phases/design/mooring_system_design.py b/ORBIT/phases/design/mooring_system_design.py
index 269a34e7..383a4924 100644
--- a/ORBIT/phases/design/mooring_system_design.py
+++ b/ORBIT/phases/design/mooring_system_design.py
@@ -108,7 +108,7 @@ def calculate_line_length_mass(self):
         """
 
         if self.anchor_type == "Drag Embedment":
-            fixed = self._design.get("drag_embedment_fixed_length", 0.5)
+            fixed = self._design.get("drag_embedment_fixed_length", 500)
 
         else:
             fixed = 0
diff --git a/ORBIT/phases/install/cable_install/export.py b/ORBIT/phases/install/cable_install/export.py
index 897ac62e..486bc9e7 100644
--- a/ORBIT/phases/install/cable_install/export.py
+++ b/ORBIT/phases/install/cable_install/export.py
@@ -11,7 +11,6 @@
 
 from marmot import process
 
-from ORBIT.core import Vessel
 from ORBIT.core.logic import position_onsite
 from ORBIT.phases.install import InstallPhase
 from ORBIT.core.exceptions import InsufficientCable
@@ -43,8 +42,7 @@ class ExportCableInstallation(InstallPhase):
         "export_cable_bury_vessel": "str | dict (optional)",
         "export_cable_trench_vessel": "str (optional)",
         "site": {"distance": "km"},
-        "plant": {"num_turbines": "int"},
-        "turbine": {"turbine_rating": "MW"},
+        "plant": {"capacity": "MW"},
         "export_system": {
             "cable": {
                 "linear_density": "t/km",
@@ -172,9 +170,7 @@ def calculate_onshore_transmission_cost(self, **kwargs):
         OffshoreBOS model.
         """
 
-        tr = self.config["turbine"]["turbine_rating"]
-        num = self.config["plant"]["num_turbines"]
-        capacity = num * tr
+        capacity = self.config["plant"]["capacity"]
 
         voltage = self.config["export_system"].get(
             "interconnection_voltage", 345
diff --git a/ORBIT/phases/install/quayside_assembly_tow/gravity_base.py b/ORBIT/phases/install/quayside_assembly_tow/gravity_base.py
index 00c1728c..4cbd97f6 100644
--- a/ORBIT/phases/install/quayside_assembly_tow/gravity_base.py
+++ b/ORBIT/phases/install/quayside_assembly_tow/gravity_base.py
@@ -398,6 +398,7 @@ def install_gravity_base_foundations(
                 num_vessels=station_keeping_vessels,
             )
             yield queue.vessel.release.succeed()
+            vessel.submit_debug_log(progress="Substructure")
             n += 1
 
         else:
diff --git a/ORBIT/phases/install/quayside_assembly_tow/moored.py b/ORBIT/phases/install/quayside_assembly_tow/moored.py
index 30d4255f..c38908b2 100644
--- a/ORBIT/phases/install/quayside_assembly_tow/moored.py
+++ b/ORBIT/phases/install/quayside_assembly_tow/moored.py
@@ -403,6 +403,7 @@ def install_moored_substructures(
                 num_vessels=station_keeping_vessels,
             )
             yield queue.vessel.release.succeed()
+            vessel.submit_debug_log(progress="Substructure")
             n += 1
 
         else:
diff --git a/docs/source/examples.rst b/docs/source/examples.rst
index 7c0420f3..e64f3996 100644
--- a/docs/source/examples.rst
+++ b/docs/source/examples.rst
@@ -1,13 +1,10 @@
 .. _examples:
 
 Examples
---------
+========
 
-There are several example notebooks located in the ORBIT
+There are several example interactive notebooks located in the ORBIT
 `repository <https://github.com/WISDEM/ORBIT/tree/master/examples>`_
 
-Jupyter Notebooks
------------------
-
 For information on running jupyter notebooks, please see this
 `tutorial <https://www.dataquest.io/blog/jupyter-notebook-tutorial/>`_.
diff --git a/docs/source/publications/index.rst b/docs/source/publications/index.rst
index 64e35304..2b644f5a 100644
--- a/docs/source/publications/index.rst
+++ b/docs/source/publications/index.rst
@@ -3,4 +3,6 @@
 Publications
 ============
 
-.. List of publications that have come out of the code.
+- `"ORBIT: Offshore Renewables Balance-of-System and Installation Tool" <https://www.nrel.gov/docs/fy20osti/77081.pdf>`_
+- `"Process-Based Balance-of-System Cost Modeling for Offshore Wind Power Plants in the United States" <https://www.nrel.gov/docs/fy20osti/74933.pdf>`_
+- `"Impacts of Turbine and Plant Upsizing on the Levelized Cost of Energy for Offshore Wind" <https://www.sciencedirect.com/science/article/pii/S0306261921006164>`_
diff --git a/docs/source/team.rst b/docs/source/team.rst
index 6a612ffe..7cba9314 100644
--- a/docs/source/team.rst
+++ b/docs/source/team.rst
@@ -11,12 +11,12 @@ Authors
 - Rob Hammond (NREL)
 - Patrick Duffy (NREL)
 
-Contributors
-------------
+.. Contributors
+.. ------------
 
-Coming soon!
+.. Coming soon!
 
-Reviewers
----------
+.. Reviewers
+.. ---------
 
-Coming soon!
+.. Coming soon!
diff --git a/docs/source/tutorial/available_outputs.rst b/docs/source/tutorial/available_outputs.rst
index 6035d28a..20b17231 100644
--- a/docs/source/tutorial/available_outputs.rst
+++ b/docs/source/tutorial/available_outputs.rst
@@ -4,7 +4,7 @@ Available Outputs
 ``ProjectManager`` is used to run a collection of ORBIT modules representing a
 complete offshore wind project installation. The outputs of each module are
 then aggregated into several different project-level outputs available via
-the ``ProjectManager`` api.
+the ``ProjectManager`` API.
 
 System and Installation CapEx
 -----------------------------
@@ -33,7 +33,7 @@ installation simulation.
 
 Installation CapEx is a dynamic result based on the installation simulation and
 is based on the times associated with each subsystem installation, day rates of
-any vessels/ports and accrued weather delays.
+any vessels/ports and any accrued weather delays.
 
 BOS CapEx
 ---------
diff --git a/docs/source/tutorial/define_vessels.rst b/docs/source/tutorial/define_vessels.rst
index e8e60593..25e532e0 100644
--- a/docs/source/tutorial/define_vessels.rst
+++ b/docs/source/tutorial/define_vessels.rst
@@ -1,11 +1,11 @@
 Vessels and Cable Definitions
 =============================
 
-Most installation modules require individual vessels or cables to be defined to
-complete the required configuration. These definitions are composed of several
-nested dictionaries (representing vessel subcomponents) that can be cumbersome
-to define within the project level configuration. As such, there are two helper
-libraries included with ORBIT that allow vessels/cables to be defined
+Most installation modules require individual vessels, cables or turbines to be
+defined to complete the required configuration. These definitions are composed
+of several nested dictionaries (representing vessel subcomponents) that can be
+cumbersome to define within the project level configuration. As such, there are
+helper libraries included with ORBIT that allow vessels/cables to be defined
 elsewhere and referenced with their name. By default, these libraries are
 located at:
 
@@ -13,6 +13,28 @@ located at:
 
    /path/to/orbit/library/cables/
    /path/to/orbit/library/vessels/
+   /path/to/orbit/library/turbines/
+
+External Libraries
+------------------
+
+It is possible to have ORBIT look in external folders for library items. To
+configure an external library, use the ``initialize_library`` function. It is
+recommended that any proprietary vessel or cable files be located outside
+of the main repository.
+
+.. code-block:: python
+
+   from ORBIT.core.library import initialize_library
+   initialize_library("path/to/external/library/")
+
+.. note::
+
+   If an external library is defined, ORBIT will search for a configured
+   library item there first and then search the library defined within ORBIT if
+   the item is not found. This is so that generic library items do not need to
+   be copied to the external library but can still be used within a project
+   definition.
 
 File Format
 -----------
@@ -73,18 +95,3 @@ following subcomponents and their use cases are available to be configured:
   for all fixed substructure and turbine installations.
 - ``'crane_specs'`` - Crane related parameters and constraints. Required for
   any offshore lifts.
-
-Changing Library Location
--------------------------
-
-It is recommended that any proprietary vessel or cable files be located outside
-of the main repository. To accomplish this, the library path can be changed by
-passing in the ``"library_path"`` parameter.
-
-.. code-block::
-
-   # ProjectManager
-   project = ProjectManager(config, library_path="/User/path/to/library/")
-
-   # Individual Phase
-   phase = MonopileInstallation(config, library_path="/User/path/to/library/")
diff --git a/docs/source/tutorial/design_phases.rst b/docs/source/tutorial/design_phases.rst
index 0996219e..c8a37bf4 100644
--- a/docs/source/tutorial/design_phases.rst
+++ b/docs/source/tutorial/design_phases.rst
@@ -1,11 +1,14 @@
-Design Phases
-=============
+.. _design_modules:
 
-There are two types of modules within ORBIT, design phases and installation
-phases. Installation phases require a number of inputs, setup a simulation and
+
+Design Modules
+==============
+
+There are two types of modules within ORBIT, design and installation.
+Installation modules require a number of inputs, setup a simulation and
 model the installation of offshore wind components. Alternatively, design
-phases model the design of an offshore wind components and can produce inputs.
-Within the context of ``ProjectManager``, a design phase can remove inputs from
+modules model the design of an offshore wind components and can produce inputs.
+Within the context of ``ProjectManager``, a design module can remove inputs from
 the required configuration for a project. The following example will illustrate
 this feature and how it is used within ``ProjectManager``.
 
@@ -13,7 +16,7 @@ this feature and how it is used within ``ProjectManager``.
 
    Design phase modules in ORBIT are intended to capture broad scaling trends
    for offshore wind components and do not represent the required fidelity of a
-   full design.
+   full engineering design.
 
 Example
 -------
@@ -134,7 +137,7 @@ project config above:
 
        'monopile': {               # <-- 'monopile' isn't required but can be
            'type': 'Monopile',     #     added to include known project parameters.
-           'mass': 800,          #     Other inputs produced by MonopileDesign will
+           'mass': 800,            #     Other inputs produced by MonopileDesign will
            'length': 100           #     be added to the config.
        },
 
diff --git a/docs/source/tutorial/index.rst b/docs/source/tutorial/index.rst
index 66ec3cd6..969a1197 100644
--- a/docs/source/tutorial/index.rst
+++ b/docs/source/tutorial/index.rst
@@ -17,9 +17,9 @@ GitHub.
 
    load_config
    project_manager
-   available_outputs
    design_phases
    phase_specific
+   available_outputs
    start_dates
    define_vessels
    parametric_manager
diff --git a/docs/source/tutorial/load_config.rst b/docs/source/tutorial/load_config.rst
index ce82f65d..9ed02fbc 100644
--- a/docs/source/tutorial/load_config.rst
+++ b/docs/source/tutorial/load_config.rst
@@ -3,11 +3,11 @@ Working with ORBIT Modules and Projects
 
 ORBIT is made up of many different modules representing the design and
 installation of offshore wind components. Each module can be ran indepenently
-or within a project and using :ref:`ProjectManager <manager>`. Modules and
+or within a project using :ref:`ProjectManager <manager>`. Modules and
 projects are configured with a set of nested dictionaries.
 
-Running Individual Phases
--------------------------
+Running Individual Modules
+--------------------------
 
 To run a module indepenently:
 
@@ -32,7 +32,7 @@ To run a module indepenently:
    phase.run()
    print(phase.total_cost)
 
-The inputs required for all modules are stored in ``expected_config``.
+The inputs required for each module are stored in ``expected_config``.
 For example:
 
 .. code-block:: python
diff --git a/docs/source/tutorial/phase_specific.rst b/docs/source/tutorial/phase_specific.rst
index 90f97852..580fb16c 100644
--- a/docs/source/tutorial/phase_specific.rst
+++ b/docs/source/tutorial/phase_specific.rst
@@ -4,7 +4,7 @@ Phase Specific Configurations
 By default, ``ProjectManager.compile_input_dict()`` returns the minimum
 required configuration, combining the same parameter that is needed for
 multiple phases into one input. This isn't always a desired outcome as there
-are cases when inputs need to be different for each phase. The
+are cases when inputs need to be different for each phase. For example, the
 ``distance_to_shore`` parameter may be different for each installation phase
 if different ports are used to stage monopiles and turbines or the
 installations may use different installation vessels. In these cases, it is
diff --git a/docs/source/tutorial/project_manager.rst b/docs/source/tutorial/project_manager.rst
index d649fd41..8c464ca3 100644
--- a/docs/source/tutorial/project_manager.rst
+++ b/docs/source/tutorial/project_manager.rst
@@ -100,3 +100,10 @@ now be filled out and the model can be ran:
   To include weather in the simulation, pass an hourly pandas DataFrame into
   ``ProjectManager``. Eg. ``ProjectManager(config, weather=weather_df)``. All
   installation phases will use this time series.
+
+Design Modules
+--------------
+
+For a more detailed description of design modules and the interaction with
+installation modules, please see the :ref:`Design Phases <design_modules>`
+documentation.
diff --git a/docs/source/tutorial/start_dates.rst b/docs/source/tutorial/start_dates.rst
index 1c9a146c..2b343079 100644
--- a/docs/source/tutorial/start_dates.rst
+++ b/docs/source/tutorial/start_dates.rst
@@ -7,7 +7,7 @@ Default Configuration
 By default, ``ProjectManager`` will run phases in the order that they are
 defined in the lists ``'design_phases'``, then ``'install_phases'`` located in
 the project configuration. This order also determines the sequence of phases in
-the outputs, including the project level action log ``.project_dataframe``. If
+the outputs, including the project level action log ``.actions``. If
 the project is configured with a weather file, any installation phases will
 start at the beginning of the weather profile.
 
@@ -88,8 +88,8 @@ Phase Dependencies
 ------------------
 
 Phases can also be defined to start at a percentage completed for a different
-phase. For example, this could be used to have the installation of the turbines
-start when the monopiles are 50% installed:
+phase. For example, the following config could be used to have the installation
+of the turbines start when the monopiles are 50% installed:
 
 .. code-block::
 
diff --git a/examples/1. Example Fixed Project.ipynb b/examples/1. Example Fixed Project.ipynb
deleted file mode 100644
index 320fe41c..00000000
--- a/examples/1. Example Fixed Project.ipynb
+++ /dev/null
@@ -1,562 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Jake Nunemaker\n",
-    "\n",
-    "National Renewable Energy Lab\n",
-    "\n",
-    "Last updated: 12/23/2020"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import os\n",
-    "import pandas as pd\n",
-    "from ORBIT import ProjectManager, load_config\n",
-    "\n",
-    "weather = pd.read_csv(\"example_weather.csv\", parse_dates=[\"datetime\"])\\\n",
-    "            .set_index(\"datetime\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Load the project configuration"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Num turbines: 50\n",
-      "Turbine: SWT_6MW_154m_110m\n",
-      "\n",
-      "Site: {'depth': 22.5, 'distance': 124, 'distance_to_landfall': 35, 'mean_windspeed': 9}\n"
-     ]
-    }
-   ],
-   "source": [
-    "fixed_config = load_config(\"example_fixed_project.yaml\") \n",
-    "\n",
-    "print(f\"Num turbines: {fixed_config['plant']['num_turbines']}\")\n",
-    "print(f\"Turbine: {fixed_config['turbine']}\")\n",
-    "print(f\"\\nSite: {fixed_config['site']}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Phases"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Design phases: ['MonopileDesign', 'ScourProtectionDesign', 'ArraySystemDesign', 'ExportSystemDesign', 'OffshoreSubstationDesign']\n",
-      "\n",
-      "Install phases: ['ArrayCableInstallation', 'ExportCableInstallation', 'MonopileInstallation', 'OffshoreSubstationInstallation', 'ScourProtectionInstallation', 'TurbineInstallation']\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Design phases: {fixed_config['design_phases']}\")\n",
-    "print(f\"\\nInstall phases: {list(fixed_config['install_phases'].keys())}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Run"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 8,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "project = ProjectManager(fixed_config, weather=weather)\n",
-    "project.run()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Top Level Outputs"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 31,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Installation CapEx:  181 M\n",
-      "System CapEx:        257 M\n",
-      "Turbine CapEx:       390 M\n",
-      "Soft CapEx:          194 M\n",
-      "Total CapEx:        1021 M\n",
-      "\n",
-      "Installation Time: 12731 h\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Installation CapEx:  {project.installation_capex/1e6:.0f} M\")\n",
-    "print(f\"System CapEx:        {project.system_capex/1e6:.0f} M\")\n",
-    "print(f\"Turbine CapEx:       {project.turbine_capex/1e6:.0f} M\")\n",
-    "print(f\"Soft CapEx:          {project.soft_capex/1e6:.0f} M\")\n",
-    "print(f\"Total CapEx:        {project.total_capex/1e6:.0f} M\")\n",
-    "\n",
-    "print(f\"\\nInstallation Time: {project.installation_time:.0f} h\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Phase Specific Outputs"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 41,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Monopile Installation:  29 M\n",
-      "Monopile Procurement:  154 M\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Monopile Installation:  {project.phases['MonopileInstallation'].installation_capex/1e6:.0f} M\")\n",
-    "print(f\"Monopile Procurement:  {project.phases['MonopileInstallation'].system_capex/1e6:.0f} M\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 43,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Turbine Installation:  45 M\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Turbine Installation:  {project.phases['TurbineInstallation'].installation_capex/1e6:.0f} M\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 45,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Array System Installation: 20 M\n",
-      "Array System Procurement:  24 M\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Array System Installation: {project.phases['ArrayCableInstallation'].installation_capex/1e6:.0f} M\")\n",
-    "print(f\"Array System Procurement:  {project.phases['ArrayCableInstallation'].system_capex/1e6:.0f} M\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Installation Actions"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 46,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>cost_multiplier</th>\n",
-       "      <th>agent</th>\n",
-       "      <th>action</th>\n",
-       "      <th>duration</th>\n",
-       "      <th>cost</th>\n",
-       "      <th>level</th>\n",
-       "      <th>time</th>\n",
-       "      <th>phase</th>\n",
-       "      <th>phase_name</th>\n",
-       "      <th>max_waveheight</th>\n",
-       "      <th>max_windspeed</th>\n",
-       "      <th>transit_speed</th>\n",
-       "      <th>location</th>\n",
-       "      <th>site_depth</th>\n",
-       "      <th>hub_height</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>0.5</td>\n",
-       "      <td>Array Cable Installation Vessel</td>\n",
-       "      <td>Mobilize</td>\n",
-       "      <td>72.000000</td>\n",
-       "      <td>180000.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>0.000000</td>\n",
-       "      <td>ArrayCableInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>0.5</td>\n",
-       "      <td>Heavy Lift Vessel</td>\n",
-       "      <td>Mobilize</td>\n",
-       "      <td>72.000000</td>\n",
-       "      <td>750000.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>0.000000</td>\n",
-       "      <td>OffshoreSubstationInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>0.5</td>\n",
-       "      <td>Feeder 0</td>\n",
-       "      <td>Mobilize</td>\n",
-       "      <td>72.000000</td>\n",
-       "      <td>180000.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>0.000000</td>\n",
-       "      <td>OffshoreSubstationInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>0.5</td>\n",
-       "      <td>SPI Vessel</td>\n",
-       "      <td>Mobilize</td>\n",
-       "      <td>72.000000</td>\n",
-       "      <td>180000.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>0.000000</td>\n",
-       "      <td>ScourProtectionInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>SPI Vessel</td>\n",
-       "      <td>Load SP Material</td>\n",
-       "      <td>4.000000</td>\n",
-       "      <td>20000.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>4.000000</td>\n",
-       "      <td>ScourProtectionInstallation</td>\n",
-       "      <td>ScourProtectionInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3098</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>WTIV</td>\n",
-       "      <td>Attach Blade</td>\n",
-       "      <td>3.500000</td>\n",
-       "      <td>26250.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>5758.182005</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>22.5</td>\n",
-       "      <td>110.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3099</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>WTIV</td>\n",
-       "      <td>Release Blade</td>\n",
-       "      <td>1.000000</td>\n",
-       "      <td>7500.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>5759.182005</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3100</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>WTIV</td>\n",
-       "      <td>Lift Blade</td>\n",
-       "      <td>1.100000</td>\n",
-       "      <td>8250.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>5760.282005</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>22.5</td>\n",
-       "      <td>110.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3101</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>WTIV</td>\n",
-       "      <td>Attach Blade</td>\n",
-       "      <td>3.500000</td>\n",
-       "      <td>26250.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>5763.782005</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>22.5</td>\n",
-       "      <td>110.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3102</th>\n",
-       "      <td>NaN</td>\n",
-       "      <td>WTIV</td>\n",
-       "      <td>Jackdown</td>\n",
-       "      <td>0.316667</td>\n",
-       "      <td>2375.0</td>\n",
-       "      <td>ACTION</td>\n",
-       "      <td>5764.098671</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>TurbineInstallation</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>22.5</td>\n",
-       "      <td>110.0</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>3103 rows × 15 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "      cost_multiplier                            agent            action  \\\n",
-       "0                 0.5  Array Cable Installation Vessel          Mobilize   \n",
-       "1                 0.5                Heavy Lift Vessel          Mobilize   \n",
-       "2                 0.5                         Feeder 0          Mobilize   \n",
-       "3                 0.5                       SPI Vessel          Mobilize   \n",
-       "4                 NaN                       SPI Vessel  Load SP Material   \n",
-       "...               ...                              ...               ...   \n",
-       "3098              NaN                             WTIV      Attach Blade   \n",
-       "3099              NaN                             WTIV     Release Blade   \n",
-       "3100              NaN                             WTIV        Lift Blade   \n",
-       "3101              NaN                             WTIV      Attach Blade   \n",
-       "3102              NaN                             WTIV          Jackdown   \n",
-       "\n",
-       "       duration      cost   level         time  \\\n",
-       "0     72.000000  180000.0  ACTION     0.000000   \n",
-       "1     72.000000  750000.0  ACTION     0.000000   \n",
-       "2     72.000000  180000.0  ACTION     0.000000   \n",
-       "3     72.000000  180000.0  ACTION     0.000000   \n",
-       "4      4.000000   20000.0  ACTION     4.000000   \n",
-       "...         ...       ...     ...          ...   \n",
-       "3098   3.500000   26250.0  ACTION  5758.182005   \n",
-       "3099   1.000000    7500.0  ACTION  5759.182005   \n",
-       "3100   1.100000    8250.0  ACTION  5760.282005   \n",
-       "3101   3.500000   26250.0  ACTION  5763.782005   \n",
-       "3102   0.316667    2375.0  ACTION  5764.098671   \n",
-       "\n",
-       "                               phase                   phase_name  \\\n",
-       "0             ArrayCableInstallation                          NaN   \n",
-       "1     OffshoreSubstationInstallation                          NaN   \n",
-       "2     OffshoreSubstationInstallation                          NaN   \n",
-       "3        ScourProtectionInstallation                          NaN   \n",
-       "4        ScourProtectionInstallation  ScourProtectionInstallation   \n",
-       "...                              ...                          ...   \n",
-       "3098             TurbineInstallation          TurbineInstallation   \n",
-       "3099             TurbineInstallation                          NaN   \n",
-       "3100             TurbineInstallation          TurbineInstallation   \n",
-       "3101             TurbineInstallation          TurbineInstallation   \n",
-       "3102             TurbineInstallation          TurbineInstallation   \n",
-       "\n",
-       "      max_waveheight  max_windspeed  transit_speed location  site_depth  \\\n",
-       "0                NaN            NaN            NaN      NaN         NaN   \n",
-       "1                NaN            NaN            NaN      NaN         NaN   \n",
-       "2                NaN            NaN            NaN      NaN         NaN   \n",
-       "3                NaN            NaN            NaN      NaN         NaN   \n",
-       "4                NaN            NaN            NaN      NaN         NaN   \n",
-       "...              ...            ...            ...      ...         ...   \n",
-       "3098             NaN            NaN            NaN      NaN        22.5   \n",
-       "3099             NaN            NaN            NaN      NaN         NaN   \n",
-       "3100             NaN            NaN            NaN      NaN        22.5   \n",
-       "3101             NaN            NaN            NaN      NaN        22.5   \n",
-       "3102             NaN            NaN            NaN      NaN        22.5   \n",
-       "\n",
-       "      hub_height  \n",
-       "0            NaN  \n",
-       "1            NaN  \n",
-       "2            NaN  \n",
-       "3            NaN  \n",
-       "4            NaN  \n",
-       "...          ...  \n",
-       "3098       110.0  \n",
-       "3099         NaN  \n",
-       "3100       110.0  \n",
-       "3101       110.0  \n",
-       "3102       110.0  \n",
-       "\n",
-       "[3103 rows x 15 columns]"
-      ]
-     },
-     "execution_count": 46,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "pd.DataFrame(project.actions)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.7.3"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/examples/1. Introduction.ipynb b/examples/1. Introduction.ipynb
new file mode 100644
index 00000000..88bc1f4c
--- /dev/null
+++ b/examples/1. Introduction.ipynb
@@ -0,0 +1,280 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from copy import deepcopy"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ORBIT Introduction\n",
+    "\n",
+    "ORBIT is organized into two different types of modules: design and installation. Design modules are intended to model the sizing and cost of offshore wind subcomponents and installation modules simulate the installation of these subcomponents in a discrete event simulation framework. The easiest way to start working with ORBIT is to look at one module. This tutorial will look at the monopile design module and the next tutorial will look at the monopile installation module."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# To import a design module:\n",
+    "from ORBIT.phases.design import MonopileDesign"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'site': {'depth': 'm', 'mean_windspeed': 'm/s'},\n",
+       " 'plant': {'num_turbines': 'int'},\n",
+       " 'turbine': {'rotor_diameter': 'm',\n",
+       "  'hub_height': 'm',\n",
+       "  'rated_windspeed': 'm/s'},\n",
+       " 'monopile_design': {'yield_stress': 'Pa (optional)',\n",
+       "  'load_factor': 'float (optional)',\n",
+       "  'material_factor': 'float (optional)',\n",
+       "  'monopile_density': 'kg/m3 (optional)',\n",
+       "  'monopile_modulus': 'Pa (optional)',\n",
+       "  'monopile_tp_connection_thickness': 'm (optional)',\n",
+       "  'transition_piece_density': 'kg/m3 (optional)',\n",
+       "  'transition_piece_thickness': 'm (optional)',\n",
+       "  'transition_piece_length': 'm (optional)',\n",
+       "  'soil_coefficient': 'N/m3 (optional)',\n",
+       "  'air_density': 'kg/m3 (optional)',\n",
+       "  'weibull_scale_factor': 'float (optional)',\n",
+       "  'weibull_shape_factor': 'float (optional)',\n",
+       "  'turb_length_scale': 'm (optional)',\n",
+       "  'monopile_steel_cost': 'USD/t (optional)',\n",
+       "  'tp_steel_cost': 'USD/t (optional)'}}"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Each module has a property `.expected_config` that gives hints as to how to configure the module properly.\n",
+    "# This property returns a nested dictionary with all of the inputs (including optional ones) that can be used\n",
+    "# to configure this module.\n",
+    "\n",
+    "# For example:\n",
+    "MonopileDesign.expected_config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# For now, lets ignore the optional inputs in the 'monopile_design' subdict and just look at the required inputs:\n",
+    "config_unfilled = {\n",
+    "    'site': {                    # Inputs are grouped into subdicts, eg. site, plant, etc.\n",
+    "        'depth': 'm',            # The value represents the unit where applicable\n",
+    "        'mean_windspeed': 'm/s'\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 'int'\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'rotor_diameter': 'm',\n",
+    "        'hub_height': 'm',\n",
+    "        'rated_windspeed': 'm/s'\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '/Users/jnunemak/Fun/repos/ORBIT/library'\n",
+      "Total Substructure Cost: 276.77 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Filling out the config for a simple fixed bottom project:\n",
+    "config = {\n",
+    "    'site': {\n",
+    "        'depth': 25,\n",
+    "        'mean_windspeed': 9.5\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 50\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'rotor_diameter': 220,\n",
+    "        'hub_height': 120,\n",
+    "        'rated_windspeed': 13\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "# To run the module, create an instance by passing the config into the module and then use module.run()\n",
+    "\n",
+    "module = MonopileDesign(config)\n",
+    "module.run()\n",
+    "print(f\"Total Substructure Cost: {module.total_cost/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "ename": "MissingInputs",
+     "evalue": "Input(s) '['site.depth', 'site.mean_windspeed']' missing in config.",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[0;31mMissingInputs\u001b[0m                             Traceback (most recent call last)",
+      "\u001b[0;32m<ipython-input-6-20015ab55893>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m      9\u001b[0m \u001b[0m_\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtmp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mpop\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m\"site\"\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     10\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 11\u001b[0;31m \u001b[0mmodule\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mMonopileDesign\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mtmp\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
+      "\u001b[0;32m~/Fun/repos/ORBIT/ORBIT/phases/design/monopile_design.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, config, **kwargs)\u001b[0m\n\u001b[1;32m     75\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     76\u001b[0m         \u001b[0mconfig\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0minitialize_library\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mconfig\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 77\u001b[0;31m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mconfig\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalidate_config\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mconfig\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     78\u001b[0m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_outputs\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m{\u001b[0m\u001b[0;34m}\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     79\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
+      "\u001b[0;32m~/Fun/repos/ORBIT/ORBIT/phases/base.py\u001b[0m in \u001b[0;36mvalidate_config\u001b[0;34m(self, config)\u001b[0m\n\u001b[1;32m    115\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    116\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0mmissing\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 117\u001b[0;31m             \u001b[0;32mraise\u001b[0m \u001b[0mMissingInputs\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mmissing\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    118\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    119\u001b[0m         \u001b[0;32melse\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
+      "\u001b[0;31mMissingInputs\u001b[0m: Input(s) '['site.depth', 'site.mean_windspeed']' missing in config."
+     ]
+    }
+   ],
+   "source": [
+    "# If a required input is missing, an error message will be raised with the input and it's location within the configuration.\n",
+    "# This error message used 'dot-notation' to show the structure of the dictionary. Each \".\" represents a lower level in the dictionary.\n",
+    "# \"site.depth\" indicates that it is the 'depth' input in the 'site' subdict.\n",
+    "\n",
+    "# In the example below, the 'site' inputs have been removed.\n",
+    "# The following inputs will be missing: '['site.depth', 'site.mean_windspeed']'\n",
+    "\n",
+    "tmp = deepcopy(config)\n",
+    "_ = tmp.pop(\"site\")\n",
+    "\n",
+    "module = MonopileDesign(tmp)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Optional Inputs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total Substructure Cost: 361.02 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Now lets add more optional inputs:\n",
+    "config = {\n",
+    "    'site': {\n",
+    "        'depth': 25,\n",
+    "        'mean_windspeed': 9.5\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 50\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'rotor_diameter': 220,\n",
+    "        'hub_height': 120,\n",
+    "        'rated_windspeed': 13\n",
+    "    },\n",
+    "    \n",
+    "    # --- New Inputs ---\n",
+    "    'monopile_design': {\n",
+    "        'monopile_steel_cost': 3500,  # USD/t\n",
+    "         'tp_steel_cost': 4500        # USD/t\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "module = MonopileDesign(config)\n",
+    "module.run()\n",
+    "print(f\"Total Substructure Cost: {module.total_cost/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'monopile': {'diameter': 10.217490535969192,\n",
+       "  'thickness': 0.10852490535969192,\n",
+       "  'moment': 44.02602353978204,\n",
+       "  'embedment_length': 37.11640362329476,\n",
+       "  'length': 72.11640362329476,\n",
+       "  'mass': 1082.5344126589946,\n",
+       "  'deck_space': 104.39711285262001,\n",
+       "  'unit_cost': 3788870.444306481},\n",
+       " 'transition_piece': {'thickness': 0.10852490535969192,\n",
+       "  'diameter': 10.434540346688577,\n",
+       "  'mass': 762.5683087222009,\n",
+       "  'length': 25,\n",
+       "  'deck_space': 108.87963224667176,\n",
+       "  'unit_cost': 3431557.389249904}}"
+      ]
+     },
+     "execution_count": 14,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# To look at more detailed results:\n",
+    "module.design_result"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/2. Installation Modules.ipynb b/examples/2. Installation Modules.ipynb
new file mode 100644
index 00000000..4f7247c2
--- /dev/null
+++ b/examples/2. Installation Modules.ipynb
@@ -0,0 +1,1742 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Installation Modules\n",
+    "\n",
+    "Installation modules have the same external structure (ie. 'expected_config') as design modules, however they have additional internal pieces to them that power the discrete event simulation framework."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# To import an installation module:\n",
+    "from ORBIT.phases.install import MonopileInstallation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'wtiv': 'dict | str',\n",
+       " 'feeder': 'dict | str (optional)',\n",
+       " 'num_feeders': 'int (optional)',\n",
+       " 'site': {'depth': 'm', 'distance': 'km'},\n",
+       " 'plant': {'num_turbines': 'int'},\n",
+       " 'turbine': {'hub_height': 'm'},\n",
+       " 'port': {'num_cranes': 'int (optional, default: 1)',\n",
+       "  'monthly_rate': 'USD/mo (optional)',\n",
+       "  'name': 'str (optional)'},\n",
+       " 'monopile': {'length': 'm',\n",
+       "  'diameter': 'm',\n",
+       "  'deck_space': 'm2',\n",
+       "  'mass': 't',\n",
+       "  'unit_cost': 'USD'},\n",
+       " 'transition_piece': {'deck_space': 'm2', 'mass': 't', 'unit_cost': 'USD'}}"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Expected config:\n",
+    "MonopileInstallation.expected_config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "config_unfilled = {\n",
+    "    'site': {                 # Similar to the design module, inputs are grouped by category\n",
+    "        'depth': 'm',         # Many of the inputs required are the same as the design module\n",
+    "        'distance': 'km'\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 'int'\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'hub_height': 'm'\n",
+    "    },\n",
+    "    \n",
+    "    'wtiv': 'dict | str',     # The WTIV that will be installing the monopiles.\n",
+    "                              # Vessel are defined in the library in .yaml files.\n",
+    "    \n",
+    "    'monopile': {             # Notice that the result of the last module (monopile + transition piece sizing)\n",
+    "        'length': 'm',        # is an input into the installation module.\n",
+    "        'diameter': 'm',\n",
+    "        'deck_space': 'm2',\n",
+    "        'mass': 't',\n",
+    "        'unit_cost': 'USD'\n",
+    "    },\n",
+    "    \n",
+    "    'transition_piece': {\n",
+    "        'deck_space': 'm2',\n",
+    "        'mass': 't',\n",
+    "        'unit_cost': 'USD'\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Installation CapEx: 21.94 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "config = {\n",
+    "    'site': {\n",
+    "        'depth': 25,\n",
+    "        'distance': 50\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 50\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'hub_height': 120\n",
+    "    },\n",
+    "    \n",
+    "    'wtiv': 'example_wtiv',    # See 'example_wtiv.yaml'\n",
+    "    \n",
+    "    'monopile': {\n",
+    "        'length': 72.1,\n",
+    "        'diameter': 10.2,\n",
+    "        'deck_space': 104.4,\n",
+    "        'mass': 1082.5,\n",
+    "        'unit_cost': 3788870\n",
+    "    },\n",
+    "    \n",
+    "    'transition_piece': {\n",
+    "        'deck_space': 108.9,\n",
+    "        'mass': 762.6,\n",
+    "        'unit_cost': 3431557\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "module = MonopileInstallation(config)\n",
+    "module.run()\n",
+    "\n",
+    "print(f\"Installation CapEx: {module.installation_capex/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Simulation Logs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.000000</td>\n",
+       "      <td>1260000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>20.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>32.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>40.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>52.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>60.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>80.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>5.000000</td>\n",
+       "      <td>37500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>85.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>10</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>87.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>11</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackup</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>87.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>12</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>RovSurvey</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>88.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>13</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Monopile</td>\n",
+       "      <td>3.000000</td>\n",
+       "      <td>22500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>91.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>14</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Upend Monopile</td>\n",
+       "      <td>0.721000</td>\n",
+       "      <td>5407.50</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>92.054333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>15</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower Monopile</td>\n",
+       "      <td>0.003500</td>\n",
+       "      <td>26.25</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>92.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>16</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>93.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>17</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Drive Monopile</td>\n",
+       "      <td>1.500000</td>\n",
+       "      <td>11250.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>94.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>18</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Transition Piece</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>96.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>19</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>97.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>20</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower TP</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>98.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>21</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Bolt TP</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>30000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>102.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>22</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>102.891167</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>23</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>104.891167</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>24</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackup</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>105.224500</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "    cost_multiplier agent                    action    duration        cost  \\\n",
+       "0               1.0  WTIV                  Mobilize  168.000000  1260000.00   \n",
+       "1               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "2               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "3               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "4               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "5               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "6               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "7               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "8               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "9               NaN  WTIV                   Transit    5.000000    37500.00   \n",
+       "10              NaN  WTIV           Position Onsite    2.000000    15000.00   \n",
+       "11              NaN  WTIV                    Jackup    0.333333     2500.00   \n",
+       "12              NaN  WTIV                 RovSurvey    1.000000     7500.00   \n",
+       "13              NaN  WTIV          Release Monopile    3.000000    22500.00   \n",
+       "14              NaN  WTIV            Upend Monopile    0.721000     5407.50   \n",
+       "15              NaN  WTIV            Lower Monopile    0.003500       26.25   \n",
+       "16              NaN  WTIV             Crane Reequip    1.000000     7500.00   \n",
+       "17              NaN  WTIV            Drive Monopile    1.500000    11250.00   \n",
+       "18              NaN  WTIV  Release Transition Piece    2.000000    15000.00   \n",
+       "19              NaN  WTIV             Crane Reequip    1.000000     7500.00   \n",
+       "20              NaN  WTIV                  Lower TP    1.000000     7500.00   \n",
+       "21              NaN  WTIV                   Bolt TP    4.000000    30000.00   \n",
+       "22              NaN  WTIV                  Jackdown    0.333333     2500.00   \n",
+       "23              NaN  WTIV           Position Onsite    2.000000    15000.00   \n",
+       "24              NaN  WTIV                    Jackup    0.333333     2500.00   \n",
+       "\n",
+       "     level        time                  phase  site_depth  hub_height  \n",
+       "0   ACTION    0.000000  Monopile Installation         NaN         NaN  \n",
+       "1   ACTION   12.000000  Monopile Installation        25.0       120.0  \n",
+       "2   ACTION   20.000000  Monopile Installation        25.0       120.0  \n",
+       "3   ACTION   32.000000  Monopile Installation        25.0       120.0  \n",
+       "4   ACTION   40.000000  Monopile Installation        25.0       120.0  \n",
+       "5   ACTION   52.000000  Monopile Installation        25.0       120.0  \n",
+       "6   ACTION   60.000000  Monopile Installation        25.0       120.0  \n",
+       "7   ACTION   72.000000  Monopile Installation        25.0       120.0  \n",
+       "8   ACTION   80.000000  Monopile Installation        25.0       120.0  \n",
+       "9   ACTION   85.000000  Monopile Installation         NaN         NaN  \n",
+       "10  ACTION   87.000000  Monopile Installation         NaN         NaN  \n",
+       "11  ACTION   87.333333  Monopile Installation        25.0       120.0  \n",
+       "12  ACTION   88.333333  Monopile Installation        25.0       120.0  \n",
+       "13  ACTION   91.333333  Monopile Installation         NaN         NaN  \n",
+       "14  ACTION   92.054333  Monopile Installation        25.0       120.0  \n",
+       "15  ACTION   92.057833  Monopile Installation        25.0       120.0  \n",
+       "16  ACTION   93.057833  Monopile Installation        25.0       120.0  \n",
+       "17  ACTION   94.557833  Monopile Installation        25.0       120.0  \n",
+       "18  ACTION   96.557833  Monopile Installation         NaN         NaN  \n",
+       "19  ACTION   97.557833  Monopile Installation        25.0       120.0  \n",
+       "20  ACTION   98.557833  Monopile Installation        25.0       120.0  \n",
+       "21  ACTION  102.557833  Monopile Installation        25.0       120.0  \n",
+       "22  ACTION  102.891167  Monopile Installation        25.0       120.0  \n",
+       "23  ACTION  104.891167  Monopile Installation         NaN         NaN  \n",
+       "24  ACTION  105.224500  Monopile Installation        25.0       120.0  "
+      ]
+     },
+     "execution_count": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# The logs of all simulation steps taken by the vessel(s) are stored and available for analysis.\n",
+    "\n",
+    "# The following code returns a list of all actions with the associated agent (vessel), duration, cost, and time completed.\n",
+    "# Once we configure a weather file, this will also include any accrued weather delays.\n",
+    "\n",
+    "import pandas as pd\n",
+    "\n",
+    "df = pd.DataFrame(module.env.actions)\n",
+    "df.head(25)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Inlcude Weather"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>windspeed</th>\n",
+       "      <th>waveheight</th>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>datetime</th>\n",
+       "      <th></th>\n",
+       "      <th></th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>2009-10-21 23:00:00</th>\n",
+       "      <td>5.075226</td>\n",
+       "      <td>0.59</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2009-10-22 00:00:00</th>\n",
+       "      <td>5.438400</td>\n",
+       "      <td>0.65</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2009-10-22 01:00:00</th>\n",
+       "      <td>4.947052</td>\n",
+       "      <td>0.55</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2009-10-22 02:00:00</th>\n",
+       "      <td>4.367195</td>\n",
+       "      <td>0.57</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2009-10-22 03:00:00</th>\n",
+       "      <td>4.135262</td>\n",
+       "      <td>0.49</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2013-12-31 19:00:00</th>\n",
+       "      <td>9.604172</td>\n",
+       "      <td>0.97</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2013-12-31 20:00:00</th>\n",
+       "      <td>9.894104</td>\n",
+       "      <td>0.97</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2013-12-31 21:00:00</th>\n",
+       "      <td>9.909363</td>\n",
+       "      <td>0.98</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2013-12-31 22:00:00</th>\n",
+       "      <td>11.856438</td>\n",
+       "      <td>1.13</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2013-12-31 23:00:00</th>\n",
+       "      <td>12.369148</td>\n",
+       "      <td>1.53</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>36769 rows × 2 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "                     windspeed  waveheight\n",
+       "datetime                                  \n",
+       "2009-10-21 23:00:00   5.075226        0.59\n",
+       "2009-10-22 00:00:00   5.438400        0.65\n",
+       "2009-10-22 01:00:00   4.947052        0.55\n",
+       "2009-10-22 02:00:00   4.367195        0.57\n",
+       "2009-10-22 03:00:00   4.135262        0.49\n",
+       "...                        ...         ...\n",
+       "2013-12-31 19:00:00   9.604172        0.97\n",
+       "2013-12-31 20:00:00   9.894104        0.97\n",
+       "2013-12-31 21:00:00   9.909363        0.98\n",
+       "2013-12-31 22:00:00  11.856438        1.13\n",
+       "2013-12-31 23:00:00  12.369148        1.53\n",
+       "\n",
+       "[36769 rows x 2 columns]"
+      ]
+     },
+     "execution_count": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Weather data can be loaded and included in the simulation. Each action can have associated weather\n",
+    "# constraints (eg. windspeed < 15 m/s, sig. waveheight < 2.5). As the simulation progresses, each action\n",
+    "# checks that it can proceed given the weather forecast. If the constraints are not met, the agent will\n",
+    "# accrue weather delays until they are.\n",
+    "\n",
+    "# To load a weather file:\n",
+    "weather = pd.read_csv(\"data/example_weather.csv\", parse_dates=['datetime']).set_index(\"datetime\")\n",
+    "weather"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Installation CapEx: 27.95 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# To include weather in the simulation, pass it into the 'weather' keyword:\n",
+    "\n",
+    "module = MonopileInstallation(config, weather=weather)\n",
+    "module.run()\n",
+    "\n",
+    "print(f\"Installation CapEx: {module.installation_capex/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.000000</td>\n",
+       "      <td>1260000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>20.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>32.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>40.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>52.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>60.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Delay</td>\n",
+       "      <td>29.000000</td>\n",
+       "      <td>217500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>89.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>90000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>101.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>60000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>109.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>10</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>5.000000</td>\n",
+       "      <td>37500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>114.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>11</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>116.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>12</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackup</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>116.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>13</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>RovSurvey</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>117.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>14</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Monopile</td>\n",
+       "      <td>3.000000</td>\n",
+       "      <td>22500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>120.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>15</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Upend Monopile</td>\n",
+       "      <td>0.721000</td>\n",
+       "      <td>5407.50</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>121.054333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>16</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower Monopile</td>\n",
+       "      <td>0.003500</td>\n",
+       "      <td>26.25</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>121.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>17</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>122.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>18</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Drive Monopile</td>\n",
+       "      <td>1.500000</td>\n",
+       "      <td>11250.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>123.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>19</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Transition Piece</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>125.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>20</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>126.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>21</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower TP</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>127.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>22</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Bolt TP</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>30000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>131.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>23</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2500.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>131.891167</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>120.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>24</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>15000.00</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>133.891167</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "    cost_multiplier agent                    action    duration        cost  \\\n",
+       "0               1.0  WTIV                  Mobilize  168.000000  1260000.00   \n",
+       "1               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "2               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "3               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "4               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "5               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "6               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "7               NaN  WTIV                     Delay   29.000000   217500.00   \n",
+       "8               NaN  WTIV           Fasten Monopile   12.000000    90000.00   \n",
+       "9               NaN  WTIV   Fasten Transition Piece    8.000000    60000.00   \n",
+       "10              NaN  WTIV                   Transit    5.000000    37500.00   \n",
+       "11              NaN  WTIV           Position Onsite    2.000000    15000.00   \n",
+       "12              NaN  WTIV                    Jackup    0.333333     2500.00   \n",
+       "13              NaN  WTIV                 RovSurvey    1.000000     7500.00   \n",
+       "14              NaN  WTIV          Release Monopile    3.000000    22500.00   \n",
+       "15              NaN  WTIV            Upend Monopile    0.721000     5407.50   \n",
+       "16              NaN  WTIV            Lower Monopile    0.003500       26.25   \n",
+       "17              NaN  WTIV             Crane Reequip    1.000000     7500.00   \n",
+       "18              NaN  WTIV            Drive Monopile    1.500000    11250.00   \n",
+       "19              NaN  WTIV  Release Transition Piece    2.000000    15000.00   \n",
+       "20              NaN  WTIV             Crane Reequip    1.000000     7500.00   \n",
+       "21              NaN  WTIV                  Lower TP    1.000000     7500.00   \n",
+       "22              NaN  WTIV                   Bolt TP    4.000000    30000.00   \n",
+       "23              NaN  WTIV                  Jackdown    0.333333     2500.00   \n",
+       "24              NaN  WTIV           Position Onsite    2.000000    15000.00   \n",
+       "\n",
+       "     level        time                  phase  site_depth  hub_height  \n",
+       "0   ACTION    0.000000  Monopile Installation         NaN         NaN  \n",
+       "1   ACTION   12.000000  Monopile Installation        25.0       120.0  \n",
+       "2   ACTION   20.000000  Monopile Installation        25.0       120.0  \n",
+       "3   ACTION   32.000000  Monopile Installation        25.0       120.0  \n",
+       "4   ACTION   40.000000  Monopile Installation        25.0       120.0  \n",
+       "5   ACTION   52.000000  Monopile Installation        25.0       120.0  \n",
+       "6   ACTION   60.000000  Monopile Installation        25.0       120.0  \n",
+       "7   ACTION   89.000000  Monopile Installation        25.0       120.0  \n",
+       "8   ACTION  101.000000  Monopile Installation        25.0       120.0  \n",
+       "9   ACTION  109.000000  Monopile Installation        25.0       120.0  \n",
+       "10  ACTION  114.000000  Monopile Installation         NaN         NaN  \n",
+       "11  ACTION  116.000000  Monopile Installation         NaN         NaN  \n",
+       "12  ACTION  116.333333  Monopile Installation        25.0       120.0  \n",
+       "13  ACTION  117.333333  Monopile Installation        25.0       120.0  \n",
+       "14  ACTION  120.333333  Monopile Installation         NaN         NaN  \n",
+       "15  ACTION  121.054333  Monopile Installation        25.0       120.0  \n",
+       "16  ACTION  121.057833  Monopile Installation        25.0       120.0  \n",
+       "17  ACTION  122.057833  Monopile Installation        25.0       120.0  \n",
+       "18  ACTION  123.557833  Monopile Installation        25.0       120.0  \n",
+       "19  ACTION  125.557833  Monopile Installation         NaN         NaN  \n",
+       "20  ACTION  126.557833  Monopile Installation        25.0       120.0  \n",
+       "21  ACTION  127.557833  Monopile Installation        25.0       120.0  \n",
+       "22  ACTION  131.557833  Monopile Installation        25.0       120.0  \n",
+       "23  ACTION  131.891167  Monopile Installation        25.0       120.0  \n",
+       "24  ACTION  133.891167  Monopile Installation         NaN         NaN  "
+      ]
+     },
+     "execution_count": 23,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(module.env.actions)\n",
+    "df.head(25)          # Note the weather delay on line 7"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Including Feeder Barges"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Installation CapEx: 23.02 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# The MonopileInstallation module can also be configured to use a WTIV + Feeder Barge installation strategy.\n",
+    "# To configure this module to use feeder barges, add the 'num_feeders' and 'feeder' input to the config:\n",
+    "\n",
+    "config = {\n",
+    "    'site': {\n",
+    "        'depth': 25,\n",
+    "        'distance': 50\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 50\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'hub_height': 120\n",
+    "    },\n",
+    "    \n",
+    "    # --- Vessels ---\n",
+    "    'wtiv': 'example_wtiv',\n",
+    "    'feeder': 'example_feeder',\n",
+    "    'num_feeders': 2,\n",
+    "    \n",
+    "    'monopile': {\n",
+    "        'length': 72.1,\n",
+    "        'diameter': 10.2,\n",
+    "        'deck_space': 104.4,\n",
+    "        'mass': 1082.5,\n",
+    "        'unit_cost': 3788870\n",
+    "    },\n",
+    "    \n",
+    "    'transition_piece': {\n",
+    "        'deck_space': 108.9,\n",
+    "        'mass': 762.6,\n",
+    "        'unit_cost': 3431557\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "module = MonopileInstallation(config)\n",
+    "module.run()\n",
+    "\n",
+    "print(f\"Installation CapEx: {module.installation_capex/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>location</th>\n",
+       "      <th>site_depth</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.000000</td>\n",
+       "      <td>1.260000e+06</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>1.125000e+05</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Feeder 1</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>1.125000e+05</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>5.000000</td>\n",
+       "      <td>3.750000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>3.750000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>2.500000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>20.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 1</td>\n",
+       "      <td>Queue</td>\n",
+       "      <td>20.000000</td>\n",
+       "      <td>6.250000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>20.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>8.333333</td>\n",
+       "      <td>2.604167e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>28.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Jackup</td>\n",
+       "      <td>1.666667</td>\n",
+       "      <td>5.208333e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>30.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Delay</td>\n",
+       "      <td>25.000000</td>\n",
+       "      <td>1.875000e+05</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>30.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>Site</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>10</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 1</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.000000</td>\n",
+       "      <td>3.750000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>32.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>11</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>1.500000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>32.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>12</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackup</td>\n",
+       "      <td>0.333333</td>\n",
+       "      <td>2.500000e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>32.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>13</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>RovSurvey</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7.500000e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>33.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>14</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Monopile</td>\n",
+       "      <td>3.000000</td>\n",
+       "      <td>2.250000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>36.333333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>15</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Upend Monopile</td>\n",
+       "      <td>0.721000</td>\n",
+       "      <td>5.407500e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>37.054333</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>16</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower Monopile</td>\n",
+       "      <td>0.003500</td>\n",
+       "      <td>2.625000e+01</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>37.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>17</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7.500000e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>38.057833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>18</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Drive Monopile</td>\n",
+       "      <td>1.500000</td>\n",
+       "      <td>1.125000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>39.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>19</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 1</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.000000</td>\n",
+       "      <td>2.500000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>40.000000</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>20</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Transition Piece</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>1.500000e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>41.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>21</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>ActiveFeeder</td>\n",
+       "      <td>11.557833</td>\n",
+       "      <td>3.611823e+04</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>41.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>Site</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>22</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7.500000e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>42.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>23</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>1.666667</td>\n",
+       "      <td>5.208333e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>43.224500</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>24</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower TP</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7.500000e+03</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>43.557833</td>\n",
+       "      <td>Monopile Installation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>25.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "    cost_multiplier     agent                    action    duration  \\\n",
+       "0               1.0      WTIV                  Mobilize  168.000000   \n",
+       "1               0.5  Feeder 0                  Mobilize   72.000000   \n",
+       "2               0.5  Feeder 1                  Mobilize   72.000000   \n",
+       "3               NaN      WTIV                   Transit    5.000000   \n",
+       "4               NaN  Feeder 0           Fasten Monopile   12.000000   \n",
+       "5               NaN  Feeder 0   Fasten Transition Piece    8.000000   \n",
+       "6               NaN  Feeder 1                     Queue   20.000000   \n",
+       "7               NaN  Feeder 0                   Transit    8.333333   \n",
+       "8               NaN  Feeder 0                    Jackup    1.666667   \n",
+       "9               NaN      WTIV                     Delay   25.000000   \n",
+       "10              NaN  Feeder 1           Fasten Monopile   12.000000   \n",
+       "11              NaN      WTIV           Position Onsite    2.000000   \n",
+       "12              NaN      WTIV                    Jackup    0.333333   \n",
+       "13              NaN      WTIV                 RovSurvey    1.000000   \n",
+       "14              NaN      WTIV          Release Monopile    3.000000   \n",
+       "15              NaN      WTIV            Upend Monopile    0.721000   \n",
+       "16              NaN      WTIV            Lower Monopile    0.003500   \n",
+       "17              NaN      WTIV             Crane Reequip    1.000000   \n",
+       "18              NaN      WTIV            Drive Monopile    1.500000   \n",
+       "19              NaN  Feeder 1   Fasten Transition Piece    8.000000   \n",
+       "20              NaN      WTIV  Release Transition Piece    2.000000   \n",
+       "21              NaN  Feeder 0              ActiveFeeder   11.557833   \n",
+       "22              NaN      WTIV             Crane Reequip    1.000000   \n",
+       "23              NaN  Feeder 0                  Jackdown    1.666667   \n",
+       "24              NaN      WTIV                  Lower TP    1.000000   \n",
+       "\n",
+       "            cost   level       time                  phase location  \\\n",
+       "0   1.260000e+06  ACTION   0.000000  Monopile Installation      NaN   \n",
+       "1   1.125000e+05  ACTION   0.000000  Monopile Installation      NaN   \n",
+       "2   1.125000e+05  ACTION   0.000000  Monopile Installation      NaN   \n",
+       "3   3.750000e+04  ACTION   5.000000  Monopile Installation      NaN   \n",
+       "4   3.750000e+04  ACTION  12.000000  Monopile Installation      NaN   \n",
+       "5   2.500000e+04  ACTION  20.000000  Monopile Installation      NaN   \n",
+       "6   6.250000e+04  ACTION  20.000000  Monopile Installation      NaN   \n",
+       "7   2.604167e+04  ACTION  28.333333  Monopile Installation      NaN   \n",
+       "8   5.208333e+03  ACTION  30.000000  Monopile Installation      NaN   \n",
+       "9   1.875000e+05  ACTION  30.000000  Monopile Installation     Site   \n",
+       "10  3.750000e+04  ACTION  32.000000  Monopile Installation      NaN   \n",
+       "11  1.500000e+04  ACTION  32.000000  Monopile Installation      NaN   \n",
+       "12  2.500000e+03  ACTION  32.333333  Monopile Installation      NaN   \n",
+       "13  7.500000e+03  ACTION  33.333333  Monopile Installation      NaN   \n",
+       "14  2.250000e+04  ACTION  36.333333  Monopile Installation      NaN   \n",
+       "15  5.407500e+03  ACTION  37.054333  Monopile Installation      NaN   \n",
+       "16  2.625000e+01  ACTION  37.057833  Monopile Installation      NaN   \n",
+       "17  7.500000e+03  ACTION  38.057833  Monopile Installation      NaN   \n",
+       "18  1.125000e+04  ACTION  39.557833  Monopile Installation      NaN   \n",
+       "19  2.500000e+04  ACTION  40.000000  Monopile Installation      NaN   \n",
+       "20  1.500000e+04  ACTION  41.557833  Monopile Installation      NaN   \n",
+       "21  3.611823e+04  ACTION  41.557833  Monopile Installation     Site   \n",
+       "22  7.500000e+03  ACTION  42.557833  Monopile Installation      NaN   \n",
+       "23  5.208333e+03  ACTION  43.224500  Monopile Installation      NaN   \n",
+       "24  7.500000e+03  ACTION  43.557833  Monopile Installation      NaN   \n",
+       "\n",
+       "    site_depth  \n",
+       "0          NaN  \n",
+       "1          NaN  \n",
+       "2          NaN  \n",
+       "3          NaN  \n",
+       "4          NaN  \n",
+       "5          NaN  \n",
+       "6          NaN  \n",
+       "7          NaN  \n",
+       "8          NaN  \n",
+       "9          NaN  \n",
+       "10         NaN  \n",
+       "11         NaN  \n",
+       "12        25.0  \n",
+       "13        25.0  \n",
+       "14         NaN  \n",
+       "15        25.0  \n",
+       "16        25.0  \n",
+       "17        25.0  \n",
+       "18        25.0  \n",
+       "19         NaN  \n",
+       "20         NaN  \n",
+       "21         NaN  \n",
+       "22        25.0  \n",
+       "23         NaN  \n",
+       "24        25.0  "
+      ]
+     },
+     "execution_count": 27,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(module.env.actions)\n",
+    "df.head(25)          # Note that there are no actions for two feeder barges interwoven into the actions list"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/3. ProjectManager Introduction.ipynb b/examples/3. ProjectManager Introduction.ipynb
new file mode 100644
index 00000000..5998460f
--- /dev/null
+++ b/examples/3. ProjectManager Introduction.ipynb
@@ -0,0 +1,201 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ProjectManager\n",
+    "\n",
+    "ProjectManager is used to interact with multiple modules within ORBIT. This class allows any combination of modules to be configured and ran together to represent an entire project in ORBIT. It handles the configuration of each module and maps outputs of design modules into installation modules where necessary. This tutorial goes through how to build up a project level configuration using ProjectManager."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from ORBIT import ProjectManager"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'wtiv': 'dict | str',\n",
+       " 'feeder': 'dict | str (optional)',\n",
+       " 'num_feeders': 'int (optional)',\n",
+       " 'site': {'depth': 'm', 'distance': 'km', 'mean_windspeed': 'm/s'},\n",
+       " 'plant': {'num_turbines': 'int'},\n",
+       " 'turbine': {'hub_height': 'm',\n",
+       "  'rotor_diameter': 'm',\n",
+       "  'rated_windspeed': 'm/s'},\n",
+       " 'port': {'num_cranes': 'int (optional, default: 1)',\n",
+       "  'monthly_rate': 'USD/mo (optional)',\n",
+       "  'name': 'str (optional)'},\n",
+       " 'monopile_design': {'yield_stress': 'Pa (optional)',\n",
+       "  'load_factor': 'float (optional)',\n",
+       "  'material_factor': 'float (optional)',\n",
+       "  'monopile_density': 'kg/m3 (optional)',\n",
+       "  'monopile_modulus': 'Pa (optional)',\n",
+       "  'monopile_tp_connection_thickness': 'm (optional)',\n",
+       "  'transition_piece_density': 'kg/m3 (optional)',\n",
+       "  'transition_piece_thickness': 'm (optional)',\n",
+       "  'transition_piece_length': 'm (optional)',\n",
+       "  'soil_coefficient': 'N/m3 (optional)',\n",
+       "  'air_density': 'kg/m3 (optional)',\n",
+       "  'weibull_scale_factor': 'float (optional)',\n",
+       "  'weibull_shape_factor': 'float (optional)',\n",
+       "  'turb_length_scale': 'm (optional)',\n",
+       "  'monopile_steel_cost': 'USD/t (optional)',\n",
+       "  'tp_steel_cost': 'USD/t (optional)'},\n",
+       " 'project_parameters': {'turbine_capex': '$/kW (optional, default: 1300)',\n",
+       "  'ncf': 'float (optional, default: 0.4)',\n",
+       "  'offtake_price': '$/MWh (optional, default: 80)',\n",
+       "  'project_lifetime': 'yrs (optional, default: 25)',\n",
+       "  'discount_rate': 'yearly (optional, default: .025)',\n",
+       "  'opex_rate': '$/kW/year (optional, default: 150)',\n",
+       "  'construction_insurance': '$/kW (optional, default: 44)',\n",
+       "  'construction_financing': '$/kW (optional, default: 183)',\n",
+       "  'contingency': '$/kW (optional, default: 316)',\n",
+       "  'commissioning': '$/kW (optional, default: 44)',\n",
+       "  'decommissioning': '$/kW (optional, default: 58)',\n",
+       "  'site_auction_price': '$ (optional, default: 100e6)',\n",
+       "  'site_assessment_cost': '$ (optional, default: 50e6)',\n",
+       "  'construction_plan_cost': '$ (optional, default: 1e6)',\n",
+       "  'installation_plan_cost': '$ (optional, default: 0.25e6)'},\n",
+       " 'design_phases': ['MonopileDesign'],\n",
+       " 'install_phases': ['MonopileInstallation'],\n",
+       " 'orbit_version': 'v1.0.4+19.g2ac3a73.dirty'}"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# The compile expected configs for multiple modules within ProjectManager, use the 'compile_input_dict' method:\n",
+    "# In this example, we'll configure ProjectManager to run the MonopileDesign and MonopileInstallation modules.\n",
+    "\n",
+    "ProjectManager.compile_input_dict([\"MonopileDesign\", \"MonopileInstallation\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total Substructure Cost: 258.67 M\n",
+      "Total Installation Cost:  21.88 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For simplicity, we are going to ignore the optional 'monopile_design' and 'project_parameters' subdicts.\n",
+    "\n",
+    "config = {\n",
+    "    'wtiv': 'example_wtiv',\n",
+    "    'site': {                   # The inputs required for the design module and\n",
+    "        'depth': 20,            # the installation module are combined into the 'site' subdict\n",
+    "        'distance': 50,\n",
+    "        'mean_windspeed': 9.5\n",
+    "    },\n",
+    "    \n",
+    "    'plant': {\n",
+    "        'num_turbines': 50\n",
+    "    },\n",
+    "    \n",
+    "    'turbine': {\n",
+    "        'rotor_diameter': 220,\n",
+    "        'hub_height': 120,\n",
+    "        'rated_windspeed': 13\n",
+    "    },\n",
+    "    \n",
+    "    # Sizing information for the substructure are not required as they will\n",
+    "    # be calculated by 'MonopileDesign' and passed into 'MonopileInstallation'\n",
+    "    # automatically by 'ProjecManager'.\n",
+    "    \n",
+    "    # --- Module Definitions ---\n",
+    "    'design_phases': ['MonopileDesign'],\n",
+    "    'install_phases': ['MonopileInstallation'],\n",
+    "}\n",
+    "\n",
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "print(f\"Total Substructure Cost: {project.system_capex/1e6:.2f} M\")\n",
+    "print(f\"Total Installation Cost:  {project.installation_capex/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Weather"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total Substructure Cost: 258.67 M\n",
+      "Total Installation Cost:  27.95 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Weather can be included in the same way as an individual module:\n",
+    "import pandas as pd\n",
+    "weather = pd.read_csv(\"data/example_weather.csv\", parse_dates=['datetime']).set_index(\"datetime\")\n",
+    "\n",
+    "project = ProjectManager(config, weather=weather)\n",
+    "project.run()\n",
+    "\n",
+    "print(f\"Total Substructure Cost: {project.system_capex/1e6:.2f} M\")\n",
+    "print(f\"Total Installation Cost:  {project.installation_capex/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/4. Example Fixed Project.ipynb b/examples/4. Example Fixed Project.ipynb
new file mode 100644
index 00000000..f8a4c389
--- /dev/null
+++ b/examples/4. Example Fixed Project.ipynb
@@ -0,0 +1,921 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Example Fixed Project\n",
+    "\n",
+    "The rest of this tutorial uses pre compiled ORBIT configs that are stored as .yaml files in the '~/configs/ folder. There are load and save methods available in ORBIT for working with .yaml files. These example projects each exhibit different functionalities within ORBIT. Using these examples and combinations of them, most project configurations can be modeled. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import pandas as pd\n",
+    "from ORBIT import ProjectManager, load_config\n",
+    "\n",
+    "weather = pd.read_csv(\"data/example_weather.csv\", parse_dates=[\"datetime\"])\\\n",
+    "            .set_index(\"datetime\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Load the project configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<class 'dict'>\n",
+      "Num turbines: 50\n",
+      "Turbine: SWT_6MW_154m_110m\n",
+      "\n",
+      "Site: {'depth': 22.5, 'distance': 124, 'distance_to_landfall': 35, 'mean_windspeed': 9}\n"
+     ]
+    }
+   ],
+   "source": [
+    "fixed_config = load_config(\"configs/example_fixed_project.yaml\")  # Configs can be loaded with absolute or relative paths\n",
+    "\n",
+    "print(type(fixed_config))                                         # They are loaded in as dictionaries.\n",
+    "\n",
+    "print(f\"Num turbines: {fixed_config['plant']['num_turbines']}\")   # Once a configuration is loaded, different parameters can  \n",
+    "print(f\"Turbine: {fixed_config['turbine']}\")                      # be accessed using dict access.\n",
+    "print(f\"\\nSite: {fixed_config['site']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Phases\n",
+    "\n",
+    "This fixed project represents a generic Offshore Wind farm with 50 6MW turbines. It includes 5 design modules and 6 installation modules as seen below. This is a common set of modules to run for a fixed bottom project. This config will model the procurement and installation of monopiles, scour protection, array system, export system, offshore substation and the turbines."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Design phases: ['MonopileDesign', 'ScourProtectionDesign', 'ArraySystemDesign', 'ExportSystemDesign', 'OffshoreSubstationDesign']\n",
+      "\n",
+      "Install phases: ['ArrayCableInstallation', 'ExportCableInstallation', 'MonopileInstallation', 'OffshoreSubstationInstallation', 'ScourProtectionInstallation', 'TurbineInstallation']\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"Design phases: {fixed_config['design_phases']}\")\n",
+    "print(f\"\\nInstall phases: {list(fixed_config['install_phases'].keys())}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Run\n",
+    "\n",
+    "This project is always being modeled with the example weather project supplied that is representative of US East Coast wind farm locations."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '/Users/jnunemak/Fun/repos/ORBIT/library'\n"
+     ]
+    }
+   ],
+   "source": [
+    "project = ProjectManager(fixed_config, weather=weather)\n",
+    "project.run()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Top Level Outputs\n",
+    "\n",
+    "ProjectManager offers several high level result categories:\n",
+    "- Installation CapEx\n",
+    "- System CapEx (procurement of BOS subcomponents)\n",
+    "- Turbine CapEx\n",
+    "- Soft CapEx (project management costs)\n",
+    "- Total CapEx\n",
+    "- Total installation time\n",
+    "- etc."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Installation CapEx:  181 M\n",
+      "System CapEx:        257 M\n",
+      "Turbine CapEx:       390 M\n",
+      "Soft CapEx:          194 M\n",
+      "Total CapEx:        1173 M\n",
+      "\n",
+      "Installation Time: 12731 h\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"Installation CapEx:  {project.installation_capex/1e6:.0f} M\")\n",
+    "print(f\"System CapEx:        {project.system_capex/1e6:.0f} M\")\n",
+    "print(f\"Turbine CapEx:       {project.turbine_capex/1e6:.0f} M\")\n",
+    "print(f\"Soft CapEx:          {project.soft_capex/1e6:.0f} M\")\n",
+    "print(f\"Total CapEx:        {project.total_capex/1e6:.0f} M\")\n",
+    "\n",
+    "print(f\"\\nInstallation Time: {project.installation_time:.0f} h\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### CapEx Breakdown"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'Array System': 24416575.834140003,\n",
+       " 'Export System': 22813500.0,\n",
+       " 'Offshore Substation': 49739550.0,\n",
+       " 'Scour Protection': 5896000,\n",
+       " 'Substructure': 154436243.91851607,\n",
+       " 'Array System Installation': 19828893.780554257,\n",
+       " 'Export System Installation': 63231897.48006167,\n",
+       " 'Offshore Substation Installation': 4323839.723173516,\n",
+       " 'Scour Protection Installation': 19613097.60273973,\n",
+       " 'Substructure Installation': 28858058.87808971,\n",
+       " 'Turbine Installation': 44667905.25114152,\n",
+       " 'Turbine': 390000000,\n",
+       " 'Soft': 193500000,\n",
+       " 'Project': 151250000.0}"
+      ]
+     },
+     "execution_count": 14,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# The breakdown of project costs by module is available  at 'capex_breakdown'\n",
+    "project.capex_breakdown"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Installation Actions"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>phase_name</th>\n",
+       "      <th>max_waveheight</th>\n",
+       "      <th>max_windspeed</th>\n",
+       "      <th>transit_speed</th>\n",
+       "      <th>location</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>180000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Heavy Lift Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>750000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>OffshoreSubstationInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Feeder 0</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>180000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>OffshoreSubstationInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>SPI Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>180000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>ScourProtectionInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>SPI Vessel</td>\n",
+       "      <td>Load SP Material</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>20000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>ScourProtectionInstallation</td>\n",
+       "      <td>ScourProtectionInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3098</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.500000</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5758.182005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3099</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Blade</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5759.182005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3100</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lift Blade</td>\n",
+       "      <td>1.100000</td>\n",
+       "      <td>8250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5760.282005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3101</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.500000</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5763.782005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3102</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.316667</td>\n",
+       "      <td>2375.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5764.098671</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>3103 rows × 15 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "      cost_multiplier                            agent            action  \\\n",
+       "0                 0.5  Array Cable Installation Vessel          Mobilize   \n",
+       "1                 0.5                Heavy Lift Vessel          Mobilize   \n",
+       "2                 0.5                         Feeder 0          Mobilize   \n",
+       "3                 0.5                       SPI Vessel          Mobilize   \n",
+       "4                 NaN                       SPI Vessel  Load SP Material   \n",
+       "...               ...                              ...               ...   \n",
+       "3098              NaN                             WTIV      Attach Blade   \n",
+       "3099              NaN                             WTIV     Release Blade   \n",
+       "3100              NaN                             WTIV        Lift Blade   \n",
+       "3101              NaN                             WTIV      Attach Blade   \n",
+       "3102              NaN                             WTIV          Jackdown   \n",
+       "\n",
+       "       duration      cost   level         time  \\\n",
+       "0     72.000000  180000.0  ACTION     0.000000   \n",
+       "1     72.000000  750000.0  ACTION     0.000000   \n",
+       "2     72.000000  180000.0  ACTION     0.000000   \n",
+       "3     72.000000  180000.0  ACTION     0.000000   \n",
+       "4      4.000000   20000.0  ACTION     4.000000   \n",
+       "...         ...       ...     ...          ...   \n",
+       "3098   3.500000   26250.0  ACTION  5758.182005   \n",
+       "3099   1.000000    7500.0  ACTION  5759.182005   \n",
+       "3100   1.100000    8250.0  ACTION  5760.282005   \n",
+       "3101   3.500000   26250.0  ACTION  5763.782005   \n",
+       "3102   0.316667    2375.0  ACTION  5764.098671   \n",
+       "\n",
+       "                               phase                   phase_name  \\\n",
+       "0             ArrayCableInstallation                          NaN   \n",
+       "1     OffshoreSubstationInstallation                          NaN   \n",
+       "2     OffshoreSubstationInstallation                          NaN   \n",
+       "3        ScourProtectionInstallation                          NaN   \n",
+       "4        ScourProtectionInstallation  ScourProtectionInstallation   \n",
+       "...                              ...                          ...   \n",
+       "3098             TurbineInstallation          TurbineInstallation   \n",
+       "3099             TurbineInstallation                          NaN   \n",
+       "3100             TurbineInstallation          TurbineInstallation   \n",
+       "3101             TurbineInstallation          TurbineInstallation   \n",
+       "3102             TurbineInstallation          TurbineInstallation   \n",
+       "\n",
+       "      max_waveheight  max_windspeed  transit_speed location  site_depth  \\\n",
+       "0                NaN            NaN            NaN      NaN         NaN   \n",
+       "1                NaN            NaN            NaN      NaN         NaN   \n",
+       "2                NaN            NaN            NaN      NaN         NaN   \n",
+       "3                NaN            NaN            NaN      NaN         NaN   \n",
+       "4                NaN            NaN            NaN      NaN         NaN   \n",
+       "...              ...            ...            ...      ...         ...   \n",
+       "3098             NaN            NaN            NaN      NaN        22.5   \n",
+       "3099             NaN            NaN            NaN      NaN         NaN   \n",
+       "3100             NaN            NaN            NaN      NaN        22.5   \n",
+       "3101             NaN            NaN            NaN      NaN        22.5   \n",
+       "3102             NaN            NaN            NaN      NaN        22.5   \n",
+       "\n",
+       "      hub_height  \n",
+       "0            NaN  \n",
+       "1            NaN  \n",
+       "2            NaN  \n",
+       "3            NaN  \n",
+       "4            NaN  \n",
+       "...          ...  \n",
+       "3098       110.0  \n",
+       "3099         NaN  \n",
+       "3100       110.0  \n",
+       "3101       110.0  \n",
+       "3102       110.0  \n",
+       "\n",
+       "[3103 rows x 15 columns]"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(project.actions)    # The project simulation logs are also available for all modules\n",
+    "df"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>phase_name</th>\n",
+       "      <th>max_waveheight</th>\n",
+       "      <th>max_windspeed</th>\n",
+       "      <th>transit_speed</th>\n",
+       "      <th>location</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>517</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.000000</td>\n",
+       "      <td>1260000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1524.932005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>523</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1528.932005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>527</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1532.932005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>534</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Nacelle</td>\n",
+       "      <td>4.000000</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1536.932005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>536</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.500000</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1538.432005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3098</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.500000</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5758.182005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3099</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Blade</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>7500.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5759.182005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3100</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lift Blade</td>\n",
+       "      <td>1.100000</td>\n",
+       "      <td>8250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5760.282005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3101</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.500000</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5763.782005</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3102</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.316667</td>\n",
+       "      <td>2375.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>5764.098671</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>22.5</td>\n",
+       "      <td>110.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>1505 rows × 15 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "      cost_multiplier agent                action    duration       cost  \\\n",
+       "517               1.0  WTIV              Mobilize  168.000000  1260000.0   \n",
+       "523               NaN  WTIV  Fasten Tower Section    4.000000    30000.0   \n",
+       "527               NaN  WTIV  Fasten Tower Section    4.000000    30000.0   \n",
+       "534               NaN  WTIV        Fasten Nacelle    4.000000    30000.0   \n",
+       "536               NaN  WTIV          Fasten Blade    1.500000    11250.0   \n",
+       "...               ...   ...                   ...         ...        ...   \n",
+       "3098              NaN  WTIV          Attach Blade    3.500000    26250.0   \n",
+       "3099              NaN  WTIV         Release Blade    1.000000     7500.0   \n",
+       "3100              NaN  WTIV            Lift Blade    1.100000     8250.0   \n",
+       "3101              NaN  WTIV          Attach Blade    3.500000    26250.0   \n",
+       "3102              NaN  WTIV              Jackdown    0.316667     2375.0   \n",
+       "\n",
+       "       level         time                phase           phase_name  \\\n",
+       "517   ACTION  1524.932005  TurbineInstallation                  NaN   \n",
+       "523   ACTION  1528.932005  TurbineInstallation  TurbineInstallation   \n",
+       "527   ACTION  1532.932005  TurbineInstallation  TurbineInstallation   \n",
+       "534   ACTION  1536.932005  TurbineInstallation  TurbineInstallation   \n",
+       "536   ACTION  1538.432005  TurbineInstallation  TurbineInstallation   \n",
+       "...      ...          ...                  ...                  ...   \n",
+       "3098  ACTION  5758.182005  TurbineInstallation  TurbineInstallation   \n",
+       "3099  ACTION  5759.182005  TurbineInstallation                  NaN   \n",
+       "3100  ACTION  5760.282005  TurbineInstallation  TurbineInstallation   \n",
+       "3101  ACTION  5763.782005  TurbineInstallation  TurbineInstallation   \n",
+       "3102  ACTION  5764.098671  TurbineInstallation  TurbineInstallation   \n",
+       "\n",
+       "      max_waveheight  max_windspeed  transit_speed location  site_depth  \\\n",
+       "517              NaN            NaN            NaN      NaN         NaN   \n",
+       "523              NaN            NaN            NaN      NaN        22.5   \n",
+       "527              NaN            NaN            NaN      NaN        22.5   \n",
+       "534              NaN            NaN            NaN      NaN        22.5   \n",
+       "536              NaN            NaN            NaN      NaN        22.5   \n",
+       "...              ...            ...            ...      ...         ...   \n",
+       "3098             NaN            NaN            NaN      NaN        22.5   \n",
+       "3099             NaN            NaN            NaN      NaN         NaN   \n",
+       "3100             NaN            NaN            NaN      NaN        22.5   \n",
+       "3101             NaN            NaN            NaN      NaN        22.5   \n",
+       "3102             NaN            NaN            NaN      NaN        22.5   \n",
+       "\n",
+       "      hub_height  \n",
+       "517          NaN  \n",
+       "523        110.0  \n",
+       "527        110.0  \n",
+       "534        110.0  \n",
+       "536        110.0  \n",
+       "...          ...  \n",
+       "3098       110.0  \n",
+       "3099         NaN  \n",
+       "3100       110.0  \n",
+       "3101       110.0  \n",
+       "3102       110.0  \n",
+       "\n",
+       "[1505 rows x 15 columns]"
+      ]
+     },
+     "execution_count": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# These logs can be sorted by phase by using DataFrame operations\n",
+    "\n",
+    "turbine_install = df.loc[df['phase']==\"TurbineInstallation\"]\n",
+    "turbine_install"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "action\n",
+       "Attach Blade             525.000000\n",
+       "Attach Nacelle           300.000000\n",
+       "Attach Tower Section     600.000000\n",
+       "Delay                    669.000000\n",
+       "Fasten Blade             225.000000\n",
+       "Fasten Nacelle           200.000000\n",
+       "Fasten Tower Section     400.000000\n",
+       "Jackdown                  15.833333\n",
+       "Jackup                    15.833333\n",
+       "Lift Blade               165.000000\n",
+       "Lift Nacelle              55.000000\n",
+       "Lift Tower Section        82.500000\n",
+       "Mobilize                 168.000000\n",
+       "Position Onsite          100.000000\n",
+       "Reequip                  100.000000\n",
+       "Release Blade            150.000000\n",
+       "Release Nacelle          150.000000\n",
+       "Release Tower Section    300.000000\n",
+       "Transit                  186.000000\n",
+       "Name: duration, dtype: float64"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Operations can also be grouped to see a total amount of time spend on each operation\n",
+    "\n",
+    "turbine_install.groupby([\"action\"]).sum()['duration']"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/2. Example Floating Project.ipynb b/examples/5. Example Floating Project.ipynb
similarity index 81%
rename from examples/2. Example Floating Project.ipynb
rename to examples/5. Example Floating Project.ipynb
index 52f458a1..8b01b575 100644
--- a/examples/2. Example Floating Project.ipynb
+++ b/examples/5. Example Floating Project.ipynb
@@ -13,7 +13,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": 2,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -21,7 +21,7 @@
     "import pandas as pd\n",
     "from ORBIT import ProjectManager, load_config\n",
     "\n",
-    "weather = pd.read_csv(\"example_weather.csv\", parse_dates=[\"datetime\"])\\\n",
+    "weather = pd.read_csv(\"data/example_weather.csv\", parse_dates=[\"datetime\"])\\\n",
     "            .set_index(\"datetime\")"
    ]
   },
@@ -34,7 +34,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [
     {
@@ -49,7 +49,7 @@
     }
    ],
    "source": [
-    "fixed_config = load_config(\"example_floating_project.yaml\") \n",
+    "fixed_config = load_config(\"configs/example_floating_project.yaml\") \n",
     "\n",
     "print(f\"Num turbines: {fixed_config['plant']['num_turbines']}\")\n",
     "print(f\"Turbine: {fixed_config['turbine']}\")\n",
@@ -65,7 +65,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [
     {
@@ -92,7 +92,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
@@ -124,13 +124,13 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Installation CapEx:  396 M\n",
-      "System CapEx:       1206 M\n",
+      "Installation CapEx:  420 M\n",
+      "System CapEx:       1222 M\n",
       "Turbine CapEx:       780 M\n",
       "Soft CapEx:          387 M\n",
-      "Total CapEx:        2769 M\n",
+      "Total CapEx:        2961 M\n",
       "\n",
-      "Installation Time: 27710 h\n"
+      "Installation Time: 27750 h\n"
      ]
     }
    ],
@@ -148,64 +148,40 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Phase Specific Outputs"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 10,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Substructure Installation:  56 M\n",
-      "Substructure Procurement:  631 M\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Substructure Installation:  {project.phases['MooredSubInstallation'].installation_capex/1e6:.0f} M\")\n",
-    "print(f\"Substructure Procurement:  {project.phases['MooredSubInstallation'].system_capex/1e6:.0f} M\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 16,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Mooring System Installation:   50 M\n",
-      "Mooring System Procurement:   331 M\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"Mooring System Installation:   {project.phases['MooringSystemInstallation'].installation_capex/1e6:.0f} M\")\n",
-    "print(f\"Mooring System Procurement:   {project.phases['MooringSystemInstallation'].system_capex/1e6:.0f} M\")"
+    "### CapEx Breakdown"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 17,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Array System Installation: 23 M\n",
-      "Array System Procurement:  57 M\n"
-     ]
+     "data": {
+      "text/plain": [
+       "{'Array System': 56983076.60642063,\n",
+       " 'Export System': 103712476.9152,\n",
+       " 'Substructure': 630709636.6,\n",
+       " 'Mooring System': 331379224.80820334,\n",
+       " 'Offshore Substation': 99479100.0,\n",
+       " 'Array System Installation': 22844527.896071255,\n",
+       " 'Export System Installation': 135112258.0470523,\n",
+       " 'Substructure Installation': 79182122.33637744,\n",
+       " 'Mooring System Installation': 50094520.5479452,\n",
+       " 'Offshore Substation Installation': 5499328.911719939,\n",
+       " 'Turbine Installation': 127738070.77625567,\n",
+       " 'Turbine': 780000000,\n",
+       " 'Soft': 387000000,\n",
+       " 'Project': 151250000.0}"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
     }
    ],
    "source": [
-    "print(f\"Array System Installation: {project.phases['ArrayCableInstallation'].installation_capex/1e6:.0f} M\")\n",
-    "print(f\"Array System Procurement:  {project.phases['ArrayCableInstallation'].system_capex/1e6:.0f} M\")"
+    "project.capex_breakdown"
    ]
   },
   {
@@ -217,7 +193,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 18,
+   "execution_count": 8,
    "metadata": {},
    "outputs": [
     {
@@ -375,7 +351,7 @@
        "      <td>...</td>\n",
        "    </tr>\n",
        "    <tr>\n",
-       "      <th>4390</th>\n",
+       "      <th>4405</th>\n",
        "      <td>NaN</td>\n",
        "      <td>Multi-Purpose Support Vessel</td>\n",
        "      <td>Connect Mooring Lines</td>\n",
@@ -394,7 +370,7 @@
        "      <td>NaN</td>\n",
        "    </tr>\n",
        "    <tr>\n",
-       "      <th>4391</th>\n",
+       "      <th>4406</th>\n",
        "      <td>NaN</td>\n",
        "      <td>Multi-Purpose Support Vessel</td>\n",
        "      <td>Check Mooring Lines</td>\n",
@@ -413,7 +389,7 @@
        "      <td>NaN</td>\n",
        "    </tr>\n",
        "    <tr>\n",
-       "      <th>4392</th>\n",
+       "      <th>4407</th>\n",
        "      <td>NaN</td>\n",
        "      <td>Towing Group 1</td>\n",
        "      <td>Positioning Support</td>\n",
@@ -432,7 +408,7 @@
        "      <td>2.0</td>\n",
        "    </tr>\n",
        "    <tr>\n",
-       "      <th>4393</th>\n",
+       "      <th>4408</th>\n",
        "      <td>NaN</td>\n",
        "      <td>Multi-Purpose Support Vessel</td>\n",
        "      <td>Transit</td>\n",
@@ -451,7 +427,7 @@
        "      <td>NaN</td>\n",
        "    </tr>\n",
        "    <tr>\n",
-       "      <th>4394</th>\n",
+       "      <th>4409</th>\n",
        "      <td>NaN</td>\n",
        "      <td>Towing Group 1</td>\n",
        "      <td>Transit</td>\n",
@@ -471,7 +447,7 @@
        "    </tr>\n",
        "  </tbody>\n",
        "</table>\n",
-       "<p>4395 rows × 16 columns</p>\n",
+       "<p>4410 rows × 16 columns</p>\n",
        "</div>"
       ],
       "text/plain": [
@@ -482,11 +458,11 @@
        "3                 1.0  Mooring System Installation Vessel   \n",
        "4                 0.5                   Heavy Lift Vessel   \n",
        "...               ...                                 ...   \n",
-       "4390              NaN        Multi-Purpose Support Vessel   \n",
-       "4391              NaN        Multi-Purpose Support Vessel   \n",
-       "4392              NaN                      Towing Group 1   \n",
-       "4393              NaN        Multi-Purpose Support Vessel   \n",
-       "4394              NaN                      Towing Group 1   \n",
+       "4405              NaN        Multi-Purpose Support Vessel   \n",
+       "4406              NaN        Multi-Purpose Support Vessel   \n",
+       "4407              NaN                      Towing Group 1   \n",
+       "4408              NaN        Multi-Purpose Support Vessel   \n",
+       "4409              NaN                      Towing Group 1   \n",
        "\n",
        "                     action    duration          cost   level         time  \\\n",
        "0                  Mobilize   72.000000  1.800000e+05  ACTION     0.000000   \n",
@@ -495,11 +471,11 @@
        "3                  Mobilize  168.000000  7.000000e+05  ACTION     0.000000   \n",
        "4                  Mobilize   72.000000  7.500000e+05  ACTION     0.000000   \n",
        "...                     ...         ...           ...     ...          ...   \n",
-       "4390  Connect Mooring Lines   22.000000  9.166667e+04  ACTION  8554.500000   \n",
-       "4391    Check Mooring Lines   12.000000  5.000000e+04  ACTION  8566.500000   \n",
-       "4392    Positioning Support   42.000000  1.050000e+05  ACTION  8566.500000   \n",
-       "4393                Transit   10.000000  4.166667e+04  ACTION  8576.500000   \n",
-       "4394                Transit   16.666667  6.250000e+04  ACTION  8583.166667   \n",
+       "4405  Connect Mooring Lines   22.000000  9.166667e+04  ACTION  8554.500000   \n",
+       "4406    Check Mooring Lines   12.000000  5.000000e+04  ACTION  8566.500000   \n",
+       "4407    Positioning Support   42.000000  1.050000e+05  ACTION  8566.500000   \n",
+       "4408                Transit   10.000000  4.166667e+04  ACTION  8576.500000   \n",
+       "4409                Transit   16.666667  6.250000e+04  ACTION  8583.166667   \n",
        "\n",
        "                               phase  location  site_depth  hub_height  \\\n",
        "0             ArrayCableInstallation       NaN         NaN         NaN   \n",
@@ -508,11 +484,11 @@
        "3          MooringSystemInstallation       NaN         NaN         NaN   \n",
        "4     OffshoreSubstationInstallation       NaN         NaN         NaN   \n",
        "...                              ...       ...         ...         ...   \n",
-       "4390           MooredSubInstallation       NaN         NaN         NaN   \n",
-       "4391           MooredSubInstallation       NaN         NaN         NaN   \n",
-       "4392           MooredSubInstallation      site         NaN         NaN   \n",
-       "4393           MooredSubInstallation       NaN         NaN         NaN   \n",
-       "4394           MooredSubInstallation       NaN         NaN         NaN   \n",
+       "4405           MooredSubInstallation       NaN         NaN         NaN   \n",
+       "4406           MooredSubInstallation       NaN         NaN         NaN   \n",
+       "4407           MooredSubInstallation      site         NaN         NaN   \n",
+       "4408           MooredSubInstallation       NaN         NaN         NaN   \n",
+       "4409           MooredSubInstallation       NaN         NaN         NaN   \n",
        "\n",
        "     phase_name  max_waveheight  max_windspeed  transit_speed  num_vessels  \n",
        "0           NaN             NaN            NaN            NaN          NaN  \n",
@@ -521,16 +497,16 @@
        "3           NaN             NaN            NaN            NaN          NaN  \n",
        "4           NaN             NaN            NaN            NaN          NaN  \n",
        "...         ...             ...            ...            ...          ...  \n",
-       "4390        NaN             NaN            NaN            NaN          NaN  \n",
-       "4391        NaN             NaN            NaN            NaN          NaN  \n",
-       "4392        NaN             NaN            NaN            NaN          2.0  \n",
-       "4393        NaN             NaN            NaN            NaN          NaN  \n",
-       "4394        NaN             NaN            NaN            NaN          3.0  \n",
+       "4405        NaN             NaN            NaN            NaN          NaN  \n",
+       "4406        NaN             NaN            NaN            NaN          NaN  \n",
+       "4407        NaN             NaN            NaN            NaN          2.0  \n",
+       "4408        NaN             NaN            NaN            NaN          NaN  \n",
+       "4409        NaN             NaN            NaN            NaN          3.0  \n",
        "\n",
-       "[4395 rows x 16 columns]"
+       "[4410 rows x 16 columns]"
       ]
      },
-     "execution_count": 18,
+     "execution_count": 8,
      "metadata": {},
      "output_type": "execute_result"
     }
diff --git a/examples/Example - Cable Install Configurations.ipynb b/examples/Example - Cable Install Configurations.ipynb
new file mode 100644
index 00000000..d4f20772
--- /dev/null
+++ b/examples/Example - Cable Install Configurations.ipynb
@@ -0,0 +1,887 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ORBIT Example - Cable Installation Options\n",
+    "\n",
+    "Last Updated: 07/88/2021"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pandas as pd\n",
+    "from ORBIT import ProjectManager"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### ArrayCableInstallation Module"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>phase_name</th>\n",
+       "      <th>max_waveheight</th>\n",
+       "      <th>max_windspeed</th>\n",
+       "      <th>transit_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.000000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.000000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Load Cable</td>\n",
+       "      <td>6.000000</td>\n",
+       "      <td>30000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>6.000000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>1.739130</td>\n",
+       "      <td>8695.652174</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>7.739130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.000000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>9.739130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Prepare Cable</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>5000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>10.739130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Pull In Cable</td>\n",
+       "      <td>5.500000</td>\n",
+       "      <td>27500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>16.239130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Terminate Cable</td>\n",
+       "      <td>5.500000</td>\n",
+       "      <td>27500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>21.739130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Lower Cable</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>5000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>22.739130</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Lay/Bury Cable</td>\n",
+       "      <td>6.666667</td>\n",
+       "      <td>33333.333333</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>29.405797</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>11.5</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Prepare Cable</td>\n",
+       "      <td>1.000000</td>\n",
+       "      <td>5000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>30.405797</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   cost_multiplier                            agent           action  \\\n",
+       "0              0.5  Array Cable Installation Vessel         Mobilize   \n",
+       "1              NaN  Array Cable Installation Vessel       Load Cable   \n",
+       "2              NaN  Array Cable Installation Vessel          Transit   \n",
+       "3              NaN  Array Cable Installation Vessel  Position Onsite   \n",
+       "4              NaN  Array Cable Installation Vessel    Prepare Cable   \n",
+       "5              NaN  Array Cable Installation Vessel    Pull In Cable   \n",
+       "6              NaN  Array Cable Installation Vessel  Terminate Cable   \n",
+       "7              NaN  Array Cable Installation Vessel      Lower Cable   \n",
+       "8              NaN  Array Cable Installation Vessel   Lay/Bury Cable   \n",
+       "9              NaN  Array Cable Installation Vessel    Prepare Cable   \n",
+       "\n",
+       "    duration           cost   level       time                   phase  \\\n",
+       "0  72.000000  180000.000000  ACTION   0.000000  ArrayCableInstallation   \n",
+       "1   6.000000   30000.000000  ACTION   6.000000  ArrayCableInstallation   \n",
+       "2   1.739130    8695.652174  ACTION   7.739130  ArrayCableInstallation   \n",
+       "3   2.000000   10000.000000  ACTION   9.739130  ArrayCableInstallation   \n",
+       "4   1.000000    5000.000000  ACTION  10.739130  ArrayCableInstallation   \n",
+       "5   5.500000   27500.000000  ACTION  16.239130  ArrayCableInstallation   \n",
+       "6   5.500000   27500.000000  ACTION  21.739130  ArrayCableInstallation   \n",
+       "7   1.000000    5000.000000  ACTION  22.739130  ArrayCableInstallation   \n",
+       "8   6.666667   33333.333333  ACTION  29.405797  ArrayCableInstallation   \n",
+       "9   1.000000    5000.000000  ACTION  30.405797  ArrayCableInstallation   \n",
+       "\n",
+       "               phase_name  max_waveheight  max_windspeed  transit_speed  \n",
+       "0                     NaN             NaN            NaN            NaN  \n",
+       "1  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "2  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "3                     NaN             NaN            NaN            NaN  \n",
+       "4  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "5  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "6  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "7  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "8  ArrayCableInstallation             2.0           25.0           11.5  \n",
+       "9  ArrayCableInstallation             NaN            NaN            NaN  "
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# The configuration below can be modified to change the installation strategies utilized in ArrayCableInstallation module\n",
+    "# by toggling on/off which vessels are configured:\n",
+    "\n",
+    "config = {\n",
+    "    \"array_cable_install_vessel\": \"example_cable_lay_vessel\",  # This vessel will perform a simultaneous lay/bury installation strategy\n",
+    "                                                               # as there is no 'bury_vessel' defined in the config\n",
+    "\n",
+    "#     \"array_cable_bury_vessel\": \"example_cable_lay_vessel\",   # <--- Commented out. Will be ignored by the code.\n",
+    "#     \"array_cable_trench_vessel\": \"example_cable_lay_vessel\", # <--- Commented out. Will be ignored by the code.\n",
+    "    \n",
+    "    \"site\": {\"distance\": 20, \"depth\": 35},\n",
+    "    \"port\": {},\n",
+    "    \"array_system\": {\n",
+    "        \"system_cost\": 50e6,\n",
+    "        \"cables\": {\n",
+    "            \"ExampleCable\": {\n",
+    "                \"linear_density\": 40,                 # t/km\n",
+    "                \"cable_sections\": [(2, 25), (1, 25)]  # (length, num) pairs. This example: 25 2km cables and 25 1km cables .\n",
+    "            }\n",
+    "        }\n",
+    "    },\n",
+    "    \n",
+    "    \"install_phases\": [\"ArrayCableInstallation\"]\n",
+    "}\n",
+    "\n",
+    "# Run\n",
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "# Outputs\n",
+    "df = pd.DataFrame(project.actions)\n",
+    "df.iloc[0:10]  # Notice the action \"Lay/Bury Cable\" in row 8."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Including a separate burial vessel"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>phase_name</th>\n",
+       "      <th>max_waveheight</th>\n",
+       "      <th>max_windspeed</th>\n",
+       "      <th>transit_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.00000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Burial Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.00000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Load Cable</td>\n",
+       "      <td>6.00000</td>\n",
+       "      <td>30000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>6.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>1.73913</td>\n",
+       "      <td>8695.652174</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>7.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.00000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>9.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Prepare Cable</td>\n",
+       "      <td>1.00000</td>\n",
+       "      <td>5000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>10.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Pull In Cable</td>\n",
+       "      <td>5.50000</td>\n",
+       "      <td>27500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>16.23913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Terminate Cable</td>\n",
+       "      <td>5.50000</td>\n",
+       "      <td>27500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>21.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Lower Cable</td>\n",
+       "      <td>1.00000</td>\n",
+       "      <td>5000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>22.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Lay Cable</td>\n",
+       "      <td>2.00000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>24.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>11.5</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   cost_multiplier                            agent           action  \\\n",
+       "0              0.5  Array Cable Installation Vessel         Mobilize   \n",
+       "1              0.5        Array Cable Burial Vessel         Mobilize   \n",
+       "2              NaN  Array Cable Installation Vessel       Load Cable   \n",
+       "3              NaN  Array Cable Installation Vessel          Transit   \n",
+       "4              NaN  Array Cable Installation Vessel  Position Onsite   \n",
+       "5              NaN  Array Cable Installation Vessel    Prepare Cable   \n",
+       "6              NaN  Array Cable Installation Vessel    Pull In Cable   \n",
+       "7              NaN  Array Cable Installation Vessel  Terminate Cable   \n",
+       "8              NaN  Array Cable Installation Vessel      Lower Cable   \n",
+       "9              NaN  Array Cable Installation Vessel        Lay Cable   \n",
+       "\n",
+       "   duration           cost   level      time                   phase  \\\n",
+       "0  72.00000  180000.000000  ACTION   0.00000  ArrayCableInstallation   \n",
+       "1  72.00000  180000.000000  ACTION   0.00000  ArrayCableInstallation   \n",
+       "2   6.00000   30000.000000  ACTION   6.00000  ArrayCableInstallation   \n",
+       "3   1.73913    8695.652174  ACTION   7.73913  ArrayCableInstallation   \n",
+       "4   2.00000   10000.000000  ACTION   9.73913  ArrayCableInstallation   \n",
+       "5   1.00000    5000.000000  ACTION  10.73913  ArrayCableInstallation   \n",
+       "6   5.50000   27500.000000  ACTION  16.23913  ArrayCableInstallation   \n",
+       "7   5.50000   27500.000000  ACTION  21.73913  ArrayCableInstallation   \n",
+       "8   1.00000    5000.000000  ACTION  22.73913  ArrayCableInstallation   \n",
+       "9   2.00000   10000.000000  ACTION  24.73913  ArrayCableInstallation   \n",
+       "\n",
+       "               phase_name  max_waveheight  max_windspeed  transit_speed  \n",
+       "0                     NaN             NaN            NaN            NaN  \n",
+       "1                     NaN             NaN            NaN            NaN  \n",
+       "2  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "3  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "4                     NaN             NaN            NaN            NaN  \n",
+       "5  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "6  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "7  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "8  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "9  ArrayCableInstallation             2.0           25.0           11.5  "
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "config = {\n",
+    "    \"array_cable_install_vessel\": \"example_cable_lay_vessel\",  # This vessel will now lay the cable but will not bury it.\n",
+    "    \"array_cable_bury_vessel\": \"example_cable_lay_vessel\",     # This vessel will now complete the burial process separate from the installation vessel.\n",
+    "#     \"array_cable_trench_vessel\": \"example_cable_lay_vessel\", # <--- Commented out. Will be ignored by the code.\n",
+    "    \n",
+    "    \"site\": {\"distance\": 20, \"depth\": 35},\n",
+    "    \"port\": {},\n",
+    "    \"array_system\": {\n",
+    "        \"system_cost\": 50e6,\n",
+    "        \"cables\": {\n",
+    "            \"ExampleCable\": {\n",
+    "                \"linear_density\": 40,                 # t/km\n",
+    "                \"cable_sections\": [(2, 25), (1, 25)]  # (length, num) pairs. This example: 25 2km cables and 25 1km cables .\n",
+    "            }\n",
+    "        }\n",
+    "    },\n",
+    "    \n",
+    "    \"install_phases\": [\"ArrayCableInstallation\"]\n",
+    "}\n",
+    "\n",
+    "# Run\n",
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "# Outputs\n",
+    "df = pd.DataFrame(project.actions)\n",
+    "df.iloc[0:10]\n",
+    "\n",
+    "# There is an additional vessel mobilization in Row 1 and Row 9 is now just \"Lay Cable\"\n",
+    "# The burial process now occurs separate from the installation vessel."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Including a Trenching Vessel"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>phase_name</th>\n",
+       "      <th>max_waveheight</th>\n",
+       "      <th>max_windspeed</th>\n",
+       "      <th>transit_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Installation Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.00000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Burial Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.00000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>0.5</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>72.00000</td>\n",
+       "      <td>180000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>0.00000</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Transit</td>\n",
+       "      <td>1.73913</td>\n",
+       "      <td>8695.652174</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>1.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.00000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3.73913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Dig Trench</td>\n",
+       "      <td>19.30000</td>\n",
+       "      <td>96500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>23.03913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>11.5</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.00000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>25.03913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Dig Trench</td>\n",
+       "      <td>19.30000</td>\n",
+       "      <td>96500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>44.33913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>11.5</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Position Onsite</td>\n",
+       "      <td>2.00000</td>\n",
+       "      <td>10000.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>46.33913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>Array Cable Trench Vessel</td>\n",
+       "      <td>Dig Trench</td>\n",
+       "      <td>19.30000</td>\n",
+       "      <td>96500.000000</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>65.63913</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>ArrayCableInstallation</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>25.0</td>\n",
+       "      <td>11.5</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   cost_multiplier                            agent           action  \\\n",
+       "0              0.5  Array Cable Installation Vessel         Mobilize   \n",
+       "1              0.5        Array Cable Burial Vessel         Mobilize   \n",
+       "2              0.5        Array Cable Trench Vessel         Mobilize   \n",
+       "3              NaN        Array Cable Trench Vessel          Transit   \n",
+       "4              NaN        Array Cable Trench Vessel  Position Onsite   \n",
+       "5              NaN        Array Cable Trench Vessel       Dig Trench   \n",
+       "6              NaN        Array Cable Trench Vessel  Position Onsite   \n",
+       "7              NaN        Array Cable Trench Vessel       Dig Trench   \n",
+       "8              NaN        Array Cable Trench Vessel  Position Onsite   \n",
+       "9              NaN        Array Cable Trench Vessel       Dig Trench   \n",
+       "\n",
+       "   duration           cost   level      time                   phase  \\\n",
+       "0  72.00000  180000.000000  ACTION   0.00000  ArrayCableInstallation   \n",
+       "1  72.00000  180000.000000  ACTION   0.00000  ArrayCableInstallation   \n",
+       "2  72.00000  180000.000000  ACTION   0.00000  ArrayCableInstallation   \n",
+       "3   1.73913    8695.652174  ACTION   1.73913  ArrayCableInstallation   \n",
+       "4   2.00000   10000.000000  ACTION   3.73913  ArrayCableInstallation   \n",
+       "5  19.30000   96500.000000  ACTION  23.03913  ArrayCableInstallation   \n",
+       "6   2.00000   10000.000000  ACTION  25.03913  ArrayCableInstallation   \n",
+       "7  19.30000   96500.000000  ACTION  44.33913  ArrayCableInstallation   \n",
+       "8   2.00000   10000.000000  ACTION  46.33913  ArrayCableInstallation   \n",
+       "9  19.30000   96500.000000  ACTION  65.63913  ArrayCableInstallation   \n",
+       "\n",
+       "               phase_name  max_waveheight  max_windspeed  transit_speed  \n",
+       "0                     NaN             NaN            NaN            NaN  \n",
+       "1                     NaN             NaN            NaN            NaN  \n",
+       "2                     NaN             NaN            NaN            NaN  \n",
+       "3  ArrayCableInstallation             NaN            NaN            NaN  \n",
+       "4                     NaN             NaN            NaN            NaN  \n",
+       "5  ArrayCableInstallation             2.0           25.0           11.5  \n",
+       "6                     NaN             NaN            NaN            NaN  \n",
+       "7  ArrayCableInstallation             2.0           25.0           11.5  \n",
+       "8                     NaN             NaN            NaN            NaN  \n",
+       "9  ArrayCableInstallation             2.0           25.0           11.5  "
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "config = {\n",
+    "    \"array_cable_install_vessel\": \"example_cable_lay_vessel\",  # This vessel will lay the cable but will not bury it.\n",
+    "    \"array_cable_bury_vessel\": \"example_cable_lay_vessel\",     # This vessel will complete the burial process separate from the installation vessel.\n",
+    "    \"array_cable_trench_vessel\": \"example_cable_lay_vessel\",   # This vessel will complete the trenching process prior to the other two vessels beginning their work.\n",
+    "    \n",
+    "    \"site\": {\"distance\": 20, \"depth\": 35},\n",
+    "    \"port\": {},\n",
+    "    \"array_system\": {\n",
+    "        \"system_cost\": 50e6,\n",
+    "        \"cables\": {\n",
+    "            \"ExampleCable\": {\n",
+    "                \"linear_density\": 40,                 # t/km\n",
+    "                \"cable_sections\": [(2, 25), (1, 25)]  # (length, num) pairs. This example: 25 2km cables and 25 1km cables .\n",
+    "            }\n",
+    "        }\n",
+    "    },\n",
+    "    \n",
+    "    \"install_phases\": [\"ArrayCableInstallation\"]\n",
+    "}\n",
+    "\n",
+    "# Run\n",
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "# Outputs\n",
+    "df = pd.DataFrame(project.actions)\n",
+    "df.iloc[0:10]\n",
+    "\n",
+    "# There are now three vessel mobilizations at the beginning of the installation.\n",
+    "# The first process to be completed is the trenching (\"Dig Trench\"). After this is completed the other vessels will begin their tasks."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Example - Cash Flow.ipynb b/examples/Example - Cash Flow.ipynb
new file mode 100644
index 00000000..6d7e0c48
--- /dev/null
+++ b/examples/Example - Cash Flow.ipynb
@@ -0,0 +1,540 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ORBIT Example - Cash Flow and NPV\n",
+    "\n",
+    "Last Updated: 07/28/2021"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This notebook provides an example of the cash flow and net present value functionality in ORBIT.\n",
+    "\n",
+    "import os\n",
+    "import pandas as pd\n",
+    "import matplotlib.pyplot as plt\n",
+    "from ORBIT import ProjectManager, load_config\n",
+    "\n",
+    "weather = pd.read_csv(\"data/example_weather.csv\", parse_dates=[\"datetime\"])\\\n",
+    "            .set_index(\"datetime\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Load the Project Configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "config = load_config(\"configs/example_fixed_project.yaml\")\n",
+    "\n",
+    "# config['install_phases'] = {\n",
+    "#     'ArrayCableInstallation': 0,\n",
+    "#     'ExportCableInstallation': 2000,\n",
+    "#     'MonopileInstallation': ('ScourProtectionInstallation', 0.5),\n",
+    "#     'OffshoreSubstationInstallation': 0,\n",
+    "#     'ScourProtectionInstallation': 0,\n",
+    "#     'TurbineInstallation': ('MonopileInstallation', 0.1)\n",
+    "# }"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For this example, a project with the following phases will be configured:\n",
+    "\n",
+    "- ProjectDevelopment\n",
+    "- MonopileDesign\n",
+    "- ArraySystemDesign\n",
+    "- ExportSystemDesign\n",
+    "- OffshoreSubstationDesign\n",
+    "- ArrayCableInstallation\n",
+    "- ExportCableInstallation\n",
+    "- MonopileInstallation\n",
+    "- OffshoreSubstationInstallation\n",
+    "- TurbineInstallation\n",
+    "\n",
+    "The configuration below represents a \"complete\" project that will be able to produce\n",
+    "power when the requisite pieces are done being installed. As each array string is able to\n",
+    "generate power, the project will begin to generate additional revenue and incur\n",
+    "O&M costs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '/Users/jnunemak/Fun/repos/ORBIT/library'\n"
+     ]
+    }
+   ],
+   "source": [
+    "project = ProjectManager(config, weather=weather)\n",
+    "project.run()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### NPV"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Net Present Value: 426.31 M\n"
+     ]
+    }
+   ],
+   "source": [
+    "# In addition to the other results shown in previous examples, the NPV of the project is available:\n",
+    "\n",
+    "print(f\"Net Present Value: {project.npv/1e6:.2f} M\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Project Progress + String Energization Points\n",
+    "\n",
+    "The \"progress points\" of the project are tracked in the output below. These are used to determine when array strings and turbines can be energized and revenue begins."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[('Offshore Substation', 120.0925357142857),\n",
+       " ('Array String', 313.9859420289855),\n",
+       " ('Array String', 618.4459420289855),\n",
+       " ('Array String', 843.9059420289856),\n",
+       " ('Array String', 1253.1092753623188),\n",
+       " ('Substructure', 1496.5764009525235),\n",
+       " ('Substructure', 1516.3403019050465),\n",
+       " ('Substructure', 1534.1042028575694),\n",
+       " ('Substructure', 1551.8681038100924),\n",
+       " ('Substructure', 1569.6320047626155),\n",
+       " ('Substructure', 1627.3959057151385),\n",
+       " ('Substructure', 1675.1598066676615),\n",
+       " ('Array String', 1688.5692753623189),\n",
+       " ('Turbine', 1791.015338095949),\n",
+       " ('Turbine', 1842.1986714292825),\n",
+       " ('Substructure', 1888.7237076201845),\n",
+       " ('Turbine', 1893.382004762616),\n",
+       " ('Substructure', 1906.4876085727078),\n",
+       " ('Array String', 1918.029275362319),\n",
+       " ('Substructure', 1924.2515095252309),\n",
+       " ('Substructure', 1942.015410477754),\n",
+       " ('Turbine', 1944.5653380959493),\n",
+       " ('Substructure', 1959.7793114302772),\n",
+       " ('Substructure', 1977.5432123828004),\n",
+       " ('Turbine', 1997.7486714292827)]"
+      ]
+     },
+     "execution_count": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "project.progress.data[:25]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "([2626.8153260869567,\n",
+       "  2626.8153260869567,\n",
+       "  3208.7320047626126,\n",
+       "  3866.13200476261,\n",
+       "  4333.532004762608,\n",
+       "  4829.932004762606,\n",
+       "  5156.032004762603,\n",
+       "  5620.432004762601,\n",
+       "  5764.09867142927],\n",
+       " [6, 6, 6, 6, 6, 6, 6, 6, 2])"
+      ]
+     },
+     "execution_count": 13,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "project.progress.energize_points"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "__Format__: [string installation times], [number of turbines energized]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Monthly Cash Flow\n",
+    "\n",
+    "The monthly cash flow is shown below.\n",
+    "\n",
+    "- Revenue is generated as each turbine and associated array string is powered and the export system has been installed.\n",
+    "- A simple generation model is implemented for now (constant NCF), however this is an area for future development.\n",
+    "- The expenses from each installation phase are collected and totaled per month.\n",
+    "- As turbines are powered, the project begins accruing additional operating expenses."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>Expenses</th>\n",
+       "      <th>Revenue</th>\n",
+       "      <th>Cash Flow</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>1.159244e+07</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>-1.159244e+07</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>9.592865e+06</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>-9.592865e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>7.878374e+07</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>-7.878374e+07</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>1.748031e+07</td>\n",
+       "      <td>1681920.0</td>\n",
+       "      <td>-1.579839e+07</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>1.231171e+07</td>\n",
+       "      <td>2522880.0</td>\n",
+       "      <td>-9.788830e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>1.000148e+07</td>\n",
+       "      <td>4204800.0</td>\n",
+       "      <td>-5.796680e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>8.155250e+06</td>\n",
+       "      <td>5045760.0</td>\n",
+       "      <td>-3.109490e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>8.677000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>-1.669000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>10</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>11</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>12</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>13</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>14</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>15</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>16</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>17</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>18</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>19</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>20</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>21</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>22</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>23</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>24</th>\n",
+       "      <td>3.750000e+06</td>\n",
+       "      <td>7008000.0</td>\n",
+       "      <td>3.258000e+06</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "        Expenses    Revenue     Cash Flow\n",
+       "0   1.159244e+07        0.0 -1.159244e+07\n",
+       "1   9.592865e+06        0.0 -9.592865e+06\n",
+       "2   7.878374e+07        0.0 -7.878374e+07\n",
+       "3   1.748031e+07  1681920.0 -1.579839e+07\n",
+       "4   1.231171e+07  2522880.0 -9.788830e+06\n",
+       "5   1.000148e+07  4204800.0 -5.796680e+06\n",
+       "6   8.155250e+06  5045760.0 -3.109490e+06\n",
+       "7   8.677000e+06  7008000.0 -1.669000e+06\n",
+       "8   3.750000e+06  7008000.0  3.258000e+06\n",
+       "9   3.750000e+06  7008000.0  3.258000e+06\n",
+       "10  3.750000e+06  7008000.0  3.258000e+06\n",
+       "11  3.750000e+06  7008000.0  3.258000e+06\n",
+       "12  3.750000e+06  7008000.0  3.258000e+06\n",
+       "13  3.750000e+06  7008000.0  3.258000e+06\n",
+       "14  3.750000e+06  7008000.0  3.258000e+06\n",
+       "15  3.750000e+06  7008000.0  3.258000e+06\n",
+       "16  3.750000e+06  7008000.0  3.258000e+06\n",
+       "17  3.750000e+06  7008000.0  3.258000e+06\n",
+       "18  3.750000e+06  7008000.0  3.258000e+06\n",
+       "19  3.750000e+06  7008000.0  3.258000e+06\n",
+       "20  3.750000e+06  7008000.0  3.258000e+06\n",
+       "21  3.750000e+06  7008000.0  3.258000e+06\n",
+       "22  3.750000e+06  7008000.0  3.258000e+06\n",
+       "23  3.750000e+06  7008000.0  3.258000e+06\n",
+       "24  3.750000e+06  7008000.0  3.258000e+06"
+      ]
+     },
+     "execution_count": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(list(zip(\n",
+    "    project.monthly_expenses.values(),\n",
+    "    project.monthly_revenue.values(),\n",
+    "    project.cash_flow.values()\n",
+    ")), columns=[\"Expenses\", \"Revenue\", \"Cash Flow\"])\n",
+    "\n",
+    "df.head(25)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Cash Flow Figure\n",
+    "\n",
+    "Play around with the start dates of the configuration above. As the dates are moved around, the underlying expenses and generation will shift, affecting the net present value of the project."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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\n",
+      "text/plain": [
+       "<Figure size 1200x800 with 1 Axes>"
+      ]
+     },
+     "metadata": {
+      "needs_background": "light"
+     },
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "fig = plt.figure(figsize=(6, 4), dpi=200)\n",
+    "axis = fig.add_subplot(111)\n",
+    "\n",
+    "last = 24\n",
+    "\n",
+    "df.loc[:last, \"Cash Flow\"].plot(kind='bar', ax=axis)\n",
+    "\n",
+    "## Formatting\n",
+    "_ = axis.axhline(0, color='k', lw=0.5)\n",
+    "\n",
+    "# Axis Labels\n",
+    "axis.set_xlabel(\"Month\")\n",
+    "\n",
+    "xticks = []\n",
+    "for i, tick in enumerate(axis.get_xticklabels()):\n",
+    "    tick.set_rotation(0)\n",
+    "    tick.set_fontsize(8)\n",
+    "    xticks.append(tick)\n",
+    "    \n",
+    "# xticks = [str(item.get_text()) for item in axis.get_xticklabels()]\n",
+    "xticks[-2] = \"...\"\n",
+    "xticks[-1] = str(df.index.max())\n",
+    "\n",
+    "_ = axis.set_xticklabels(xticks)\n",
+    "\n",
+    "axis.set_ylabel(\"Cash Flow ($M)\")\n",
+    "axis.yaxis.set_major_formatter(plt.FuncFormatter(lambda x, loc: \"{:.0f}M\".format(int(x) / 1e6)))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Example - Custom Array Layout.ipynb b/examples/Example - Custom Array Layout.ipynb
new file mode 100644
index 00000000..b091c0e0
--- /dev/null
+++ b/examples/Example - Custom Array Layout.ipynb
@@ -0,0 +1,2132 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Custom Array Cabling Layout Example\n",
+    "## Dudgeon Windfarm\n",
+    "\n",
+    "\n",
+    "#### Author: Rob Hammond\n",
+    "#### Date: 4 May 2020\n",
+    "#### Update: 30 March 2021\n",
+    "\n",
+    "\n",
+    "\n",
+    "##### Data source: Dudgeon Wind Farm turbine locations from their publicly available [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf)\n",
+    "\n",
+    "\n",
+    "This notebook will guide you through four of the main use cases on using the custom array cable layout functionality of `ORBIT` for when custom turbine locations, cable lengths or burial speeds are needed.\n",
+    "\n",
+    "**Note:** All array cable layout files are CSVs, which can be edited in Microsoft Excel.\n",
+    "\n",
+    "**Update:** This example was updated to work with ORBIT >= 1.0.0"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '../library'\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "from copy import deepcopy\n",
+    "from pprint import pprint\n",
+    "\n",
+    "import numpy as np\n",
+    "import pandas as pd\n",
+    "\n",
+    "import ORBIT\n",
+    "from ORBIT import ProjectManager\n",
+    "from ORBIT.core import library\n",
+    "from ORBIT.phases.design import CustomArraySystemDesign\n",
+    "from ORBIT.phases.install import ArrayCableInstallation\n",
+    "\n",
+    "# initialize the library location\n",
+    "library.initialize_library(\"../library\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Contents\n",
+    " - [Overview](#overview): How to use the inputs\n",
+    " - [Case 1](#case_1): Needing to know what to collect\n",
+    " - [Case 2](#case_2): Coordinates with a straight-line distance for cable length\n",
+    " - [Case 3](#case_3): Using distance from a reference point\n",
+    " - [Case 4](#case_4): Adjusting for exclusions in the cable paths\n",
+    " - [Case 5](#case_5): Fully customizing the cabling parameters\n",
+    " - [Applying the cases to `ArrayCableInstallation`](#running)\n",
+    " - [Using `ProjectManager` to model the entire process](#project_manager)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"overview\"></a>\n",
+    "## Overview\n",
+    "\n",
+    "#### Before starting it is important to demonstrate how to create a configuration file or how to set up a customized layout file.\n",
+    "\n",
+    "In the highest level of this repository there is a folder called `library` where all of the example data for this notebook is going to be stored. While any folder could be used, the folder structure must be strictly adhered to. More details on this structure can be found [here](https://github.com/WISDEM/ORBIT/blob/master/ORBIT/library.py#L9-L23).\n",
+    "\n",
+    "For this example of how to setup a configuration, I will be using the file `<path>/ORBIT/library/project/config/example_custom_array_simple.yaml`. YAML' files are used for configuration throughout this codebase due their ease of encoding and loading `Python` data types.\n",
+    "\n",
+    "Now, we will load the configuration file and display it below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+      "                         'location_data': 'dudgeon_array'},\n",
+      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+      " 'site': {'depth': 20},\n",
+      " 'turbine': 'SWT_6MW_154m_110m'}\n"
+     ]
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple\")\n",
+    "pprint(config)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### A couple of things to notice in the configuration file for a custom array layout:\n",
+    "```python\n",
+    "{\n",
+    "    # Array cabling system specific data configuration\n",
+    "    'array_system_design': {\n",
+    "        \n",
+    "        # A list of array cable YAML files that can be found in library/project/cables/ as\n",
+    "        # XLPE_400mm_33kV.yaml and XLPE_630mm_33kV.yaml\n",
+    "        'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+    "        \n",
+    "        # A YAML file named dudgeon_array.csv found in the same location\n",
+    "        'location_data': 'dudgeon_array'},\n",
+    "    \n",
+    "    # We are using a custom layout and the Dudgeon contains 67 turbines\n",
+    "    'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+    "    \n",
+    "    # The average water depth at the site\n",
+    "    'site': {'depth': 20},\n",
+    "    \n",
+    "    # Turbine details (optional for custom)\n",
+    "    'turbine': 'SWT_6MW_154m_110m'\n",
+    "}\n",
+    "```\n",
+    "\n",
+    "#### Now, let's see what is contained within the additional files from the configuration dictionary\n",
+    "\n",
+    "It should be noted that running the design class extracts the data from the files automatically to produce the below output."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'array_system_design': {'cables': {'XLPE_400mm_33kV': {'ac_resistance': 0.06,\n",
+      "                                                        'capacitance': 225,\n",
+      "                                                        'conductor_size': 400,\n",
+      "                                                        'cost_per_km': 300000,\n",
+      "                                                        'current_capacity': 600,\n",
+      "                                                        'inductance': 0.375,\n",
+      "                                                        'linear_density': 35,\n",
+      "                                                        'name': 'XLPE_400mm_33kV',\n",
+      "                                                        'rated_voltage': 33},\n",
+      "                                    'XLPE_630mm_33kV': {'ac_resistance': 0.04,\n",
+      "                                                        'capacitance': 300,\n",
+      "                                                        'conductor_size': 630,\n",
+      "                                                        'cost_per_km': 450000,\n",
+      "                                                        'current_capacity': 700,\n",
+      "                                                        'inductance': 0.35,\n",
+      "                                                        'linear_density': 42.5,\n",
+      "                                                        'name': 'XLPE_630mm_33kV',\n",
+      "                                                        'rated_voltage': 33}},\n",
+      "                         'location_data': 'dudgeon_array'},\n",
+      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+      " 'site': {'depth': 20},\n",
+      " 'turbine': {'blade': {'deck_space': 100, 'length': 75, 'mass': 100},\n",
+      "             'hub_height': 110,\n",
+      "             'nacelle': {'deck_space': 200, 'mass': 360},\n",
+      "             'name': 'SWT-6MW-154',\n",
+      "             'rated_windspeed': 13,\n",
+      "             'rotor_diameter': 154,\n",
+      "             'tower': {'deck_space': 36,\n",
+      "                       'length': 110,\n",
+      "                       'mass': 150,\n",
+      "                       'sections': 2},\n",
+      "             'turbine_rating': 6}}\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "UserWarning: /Users/jnunemak/Fun/repos/ORBIT/ORBIT/phases/design/array_system_design.py:881\n",
+      "Missing data in columns ['cable_length', 'bury_speed']; all values will be calculated."
+     ]
+    }
+   ],
+   "source": [
+    "array = CustomArraySystemDesign(config)\n",
+    "array.run()\n",
+    "pprint(array.config)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### When the `dudgeon_array.csv` file is loaded, it is not passed back into the configuration dictionary, so let's dissect this file:\n",
+    "\n",
+    "1. The file must have all of the columns shown below (not case-sensitive).\n",
+    " - All columns must be completely filled out for turbines (note on substation(s) following).\n",
+    " - `cable_length` and `bury_speed` are optional and if these are not known, simply fill with a 0.\n",
+    "2. A latitude and longitude must be provided for all turbines and substation(s). This can either be a WGS-84 decimal coordinate or a distance-based \"coordinate\" where latitude and longitude are the distances from some reference point, in kilometers; see [Case 3](#case_3) for more details.\n",
+    "2. Define the offshore substation(s)\n",
+    " - For each substation,  the values in columns `id` and `substation_id` _must_ be the same.\n",
+    " - There is no need to fill in any data for the columns `String`, `Order`, `cable_length` and `bury_speed`.\n",
+    "3. Define the turbines\n",
+    " - Each turbine should have a reference to its substation in the `substation_id` column.\n",
+    "     - In this example, there is one substaion, so all of the values are \"DOW_OSS\".\n",
+    " - `string` and `order` should be 0-indexed for their ordering and not skip any numbers.\n",
+    "     - In this example, the strings are ordered in clock-wise order starting from the string with turbines labeled with an \"A\" in the [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf)\n",
+    " - The ordering on a string should travel from substation to the farthest end of the cable"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>id</th>\n",
+       "      <th>substation_id</th>\n",
+       "      <th>name</th>\n",
+       "      <th>Longitude</th>\n",
+       "      <th>Latitude</th>\n",
+       "      <th>String</th>\n",
+       "      <th>Order</th>\n",
+       "      <th>cable_length</th>\n",
+       "      <th>bury_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>1.358783</td>\n",
+       "      <td>53.243950</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>1.349033</td>\n",
+       "      <td>53.248467</td>\n",
+       "      <td>0</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>1.339283</td>\n",
+       "      <td>53.252983</td>\n",
+       "      <td>0</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>1.329550</td>\n",
+       "      <td>53.257500</td>\n",
+       "      <td>0</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>1.319800</td>\n",
+       "      <td>53.262017</td>\n",
+       "      <td>0</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>59</th>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>1.368533</td>\n",
+       "      <td>53.239433</td>\n",
+       "      <td>11</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>60</th>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>1.378250</td>\n",
+       "      <td>53.234917</td>\n",
+       "      <td>11</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>61</th>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>1.388000</td>\n",
+       "      <td>53.230400</td>\n",
+       "      <td>11</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>62</th>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>1.397750</td>\n",
+       "      <td>53.225883</td>\n",
+       "      <td>11</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>53.264800</td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>68 rows × 9 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "         id substation_id     name  Longitude   Latitude String Order  \\\n",
+       "1    DAE_A1       DOW_OSS   DAE_A1   1.358783  53.243950      0     0   \n",
+       "2    DAD_A2       DOW_OSS   DAD_A2   1.349033  53.248467      0     1   \n",
+       "3    DAC_A3       DOW_OSS   DAC_A3   1.339283  53.252983      0     2   \n",
+       "4    DAB_A4       DOW_OSS   DAB_A4   1.329550  53.257500      0     3   \n",
+       "5    DAA_A5       DOW_OSS   DAA_A5   1.319800  53.262017      0     4   \n",
+       "..      ...           ...      ...        ...        ...    ...   ...   \n",
+       "59   DAF_L2       DOW_OSS   DAF_L2   1.368533  53.239433     11     1   \n",
+       "60   DAG_L3       DOW_OSS   DAG_L3   1.378250  53.234917     11     2   \n",
+       "61   DAH_L4       DOW_OSS   DAH_L4   1.388000  53.230400     11     3   \n",
+       "62   DAJ_L5       DOW_OSS   DAJ_L5   1.397750  53.225883     11     4   \n",
+       "0   DOW_OSS       DOW_OSS  DOW_OSS   1.378767  53.264800                \n",
+       "\n",
+       "   cable_length bury_speed  \n",
+       "1             0          0  \n",
+       "2             0          0  \n",
+       "3             0          0  \n",
+       "4             0          0  \n",
+       "5             0          0  \n",
+       "..          ...        ...  \n",
+       "59            0          0  \n",
+       "60            0          0  \n",
+       "61            0          0  \n",
+       "62            0          0  \n",
+       "0                           \n",
+       "\n",
+       "[68 rows x 9 columns]"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.read_csv(\"../library/cables/dudgeon_array.csv\").fillna(\"\")\n",
+    "df.sort_values(by=[\"String\", \"Order\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"case_1\"></a>\n",
+    "## Case 1: Needing to know what to collect\n",
+    "\n",
+    "Here we know that we need to have a csv created to input all the data but need to see what data is necessary to collect.\n",
+    "\n",
+    "\n",
+    "First, we need to load in the configuration dictionary. Then, we will create a \"starter\" file that can be filled in for a new project, which will be saved in the \"library\"."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+      "                         'location_data': 'dudgeon_array_no_data'},\n",
+      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+      " 'site': {'depth': 20},\n",
+      " 'turbine': 'SWT_6MW_154m_110m'}\n",
+      "\n",
+      "+--------------------------------+\n",
+      "|     PROJECT SPECIFICATIONS     |\n",
+      "+---------------------------+----+\n",
+      "| N turbines full string    |  6 |\n",
+      "| N full strings            | 11 |\n",
+      "| N turbines partial string |  1 |\n",
+      "| N partial strings         |  1 |\n",
+      "+---------------------------+----+\n",
+      "Saving custom array CSV to: <library_path>/cables/dudgeon_array_no_data.csv\n"
+     ]
+    },
+    {
+     "name": "stdin",
+     "output_type": "stream",
+     "text": [
+      "../library/cables/dudgeon_array_no_data.csv already exists, overwrite [y/n]? y\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Save complete!\n"
+     ]
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_no_data\")\n",
+    "pprint(config)\n",
+    "print()\n",
+    "\n",
+    "array = CustomArraySystemDesign(config)\n",
+    "save_path = array.config[\"array_system_design\"][\"location_data\"]\n",
+    "array.create_project_csv(save_path)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Let's take a look at the data to see what it output\n",
+    "\n",
+    "**NOTE**:\n",
+    " 1. The offshore substation (row 0) is indicated via the `id` and `substation_id` columns being equal\n",
+    " 2. For substaions only the `id`, `substation_id`, `name`, `latitued`, and `longitude` are required\n",
+    " 3. `cable_length` and `bury_speed` are optional columns for turbines\n",
+    " 4. `string` and `order` are filled out to maximize the length of a string given the cable(s) provided so in this case we can have up to 6 turbines in a string. **These are also, very importantly, starting their numbering with 0.**"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "dudgeon_array_no_data = pd.read_csv(\"../library/cables/dudgeon_array_no_data.csv\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>id</th>\n",
+       "      <th>substation_id</th>\n",
+       "      <th>name</th>\n",
+       "      <th>latitude</th>\n",
+       "      <th>longitude</th>\n",
+       "      <th>string</th>\n",
+       "      <th>order</th>\n",
+       "      <th>cable_length</th>\n",
+       "      <th>bury_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>oss1</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>offshore_substation</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>t0</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>t1</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-1</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>1.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>t2</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-2</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>t3</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-3</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>3.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>63</th>\n",
+       "      <td>t62</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-62</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>10.0</td>\n",
+       "      <td>2.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>64</th>\n",
+       "      <td>t63</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-63</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>10.0</td>\n",
+       "      <td>3.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>65</th>\n",
+       "      <td>t64</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-64</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>10.0</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>66</th>\n",
+       "      <td>t65</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-65</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>10.0</td>\n",
+       "      <td>5.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>67</th>\n",
+       "      <td>t66</td>\n",
+       "      <td>oss1</td>\n",
+       "      <td>turbine-66</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>11.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>68 rows × 9 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "      id substation_id                 name  latitude  longitude  string  \\\n",
+       "0   oss1          oss1  offshore_substation       0.0        0.0     NaN   \n",
+       "1     t0          oss1            turbine-0       0.0        0.0     0.0   \n",
+       "2     t1          oss1            turbine-1       0.0        0.0     0.0   \n",
+       "3     t2          oss1            turbine-2       0.0        0.0     0.0   \n",
+       "4     t3          oss1            turbine-3       0.0        0.0     0.0   \n",
+       "..   ...           ...                  ...       ...        ...     ...   \n",
+       "63   t62          oss1           turbine-62       0.0        0.0    10.0   \n",
+       "64   t63          oss1           turbine-63       0.0        0.0    10.0   \n",
+       "65   t64          oss1           turbine-64       0.0        0.0    10.0   \n",
+       "66   t65          oss1           turbine-65       0.0        0.0    10.0   \n",
+       "67   t66          oss1           turbine-66       0.0        0.0    11.0   \n",
+       "\n",
+       "    order  cable_length  bury_speed  \n",
+       "0     NaN           NaN         NaN  \n",
+       "1     0.0           0.0         0.0  \n",
+       "2     1.0           0.0         0.0  \n",
+       "3     2.0           0.0         0.0  \n",
+       "4     3.0           0.0         0.0  \n",
+       "..    ...           ...         ...  \n",
+       "63    2.0           0.0         0.0  \n",
+       "64    3.0           0.0         0.0  \n",
+       "65    4.0           0.0         0.0  \n",
+       "66    5.0           0.0         0.0  \n",
+       "67    0.0           0.0         0.0  \n",
+       "\n",
+       "[68 rows x 9 columns]"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "dudgeon_array_no_data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"case_2\"></a>\n",
+    "## Case 2: Standard straight-line distance for cable lengths\n",
+    "\n",
+    "Here we have the turbine and offshore substation locations that were extracted from the data source in the header but nothing specific regarding the actual cable lengths or the cable burial speeds for each section."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+      "                         'location_data': 'dudgeon_array'},\n",
+      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+      " 'site': {'depth': 20},\n",
+      " 'turbine': 'SWT_6MW_154m_110m'}\n"
+     ]
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple\")\n",
+    "pprint(config)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "array = CustomArraySystemDesign(config)\n",
+    "array.run()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Let's take a look at the data to see what it output\n",
+    "\n",
+    "**NOTE**: Here the cable length and bury speed are still set to 0 to indicate that they are unknown"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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KIEWEREREUmAEmgRERERkQRkhB2AiIiISCV4ESgkWKAiUqU0B1pEREREJAEq4RARERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBCiBFhERERFJgBJoEREREZEEKIEWEREREUmAEmgRERERkQQogRYRERERSYASaBERERGRBGTs68pZs2a1zMjImAD0RMm2iIiIiKSGEmBeUVHRZX379v2y7JX7TKAzMjImZGVldW/RosW6tLQ0r7IQRUREREQioqSkxFavXp1TWFg4ARhY9vr9nSr3bNGixddKnkVEREQkVaSlpXmLFi02EFRh7GGfJ9DB/RNPnos3fZ6xaeEDzYrWza3rO77OsFqNijIO6bWlfvbVa9LrtSlK9POJiIiIiFSneA5c7mHz/hLohGwrfLPeNx/e2Xr7qqmNwaBkm+267vN/lWyaN6Zt7awTNzT41i++yMw6cXNlPraIiIiISHWotMbAb+aObr72lQHdtn/xnyaUbLfSyTMAJdvSKNlu21e+2mTtKwO6fTN3dPPKemwRERERkepSKSfQ38wd3XzjB7e3p3hrBRJyh+KtaRs/uL09QINeI7+qjBhERERERKrDQZ9Abyt8s17Fk+dS4kn0tsKp9Q42BklNn67bklFUXFKh2xYVl/Dpui2VWrIkIiIiqemgE+hvPryzNcXbDuzzFG9L+2bOnVmJ3OXjjz+udeqppx7esWPHnu3bt+956aWXtt+6datt3LgxbeDAgYd27do1p0uXLj369u3bbcOGDWkAI0eOzOrcuXOPrl275mRnZ+e89tpr9Q8oXomMouISfjBhepc++VO7v/3J2n2+CHtr6Zp6ffKndj9z4vTOFU24AQoLC9Ozs7NzsrOzc5o3b967ZcuW39r5961bt9r+PwMMGjTo0CeeeKJJ2ctfe+21+kOHDm1f4WBEREQkMg4qgS7e9HlG0DB4oFPunO2FbzYp3ryyQieDJSUlnHXWWZ0HDhy4fvny5fM++eSTeZs2bUobPnx427vuuqtly5YtdyxatGj+4sWLP3r00UeX1a5d21999dX6//rXv5rMnTt3/qJFi+a//vrriw477LDtBxiwRMSirzbVXr1pe62PVm2sd+If3ul+2TMfttuwZcdu38/rtuxIG/r0B+1P+uO07h+t2lhv9Tfbay36alPtij5GVlZWcUFBwfyCgoL5Q4YMWX3llVeu2vn3OnXq7PebfseOHXu97pRTTtk0ceLEFRWNRSQRS5YsqdW2bdteq1atSgdYvXp1etu2bXu99NJLDbp06dKj7O3POeecTm3btu2VnZ2dk5OT0/3VV1+tX/by7OzsnCOOOCJ7X4/74osvNszOzs7p3Llzj379+nUD2Lx5s/Xq1at7t27dcjp37txjxIgRbXbeftWqVen9+/fv0rFjx579+/fvsnr16vTK/Zco375iGj58eJudhy3HHXdcl2XLltUCGDduXLMhQ4Z0KPv/26dPn93+TXbs2EGzZs16L1++vFZ1/L9IcgvruQrw5ptv1ktPT+/72GOPHbLzskmTJjXq1KlTzw4dOvS85ZZbdh1w6rm6p4NKoDctfKAZVOggbh/MNxU80Kwit4zFYg0zMzNLhg8fvgYgIyODBx98cMXTTz/dfNmyZZlt27bdlbH07t17W926df3zzz+v1bRp06K6des6QOvWrYs6deq098xGkkJOq4bbF4w8ed7QYzqsApg4/dNW2aNf7/GXWZ81Bnhy1mdNuo9+veej761oCXDZMR1WFYw8+aOcVg0P+sXTvHnzMrOzs3N2/v2WW27Juummm1oD9O3bt9t1113X9qijjuo2atSolgD//Oc/G/Xt27dbp06dej7zzDONAF544YWGp5122uEAw4YNa3Peeed17NevX7d27dr1GjVqVIudn3v8+PHNevXq1T07Ozvnoosu6lBcXHyw4Us1MrO+VfFnf4/buXPnHZdeeumX119/fTuA4cOHtxsyZMjqzp077/X7/8477/ysoKBg/p133vn51Vdf3bHs5QUFBfPff//9gr3d/6uvvkofPnx4h1gstmTJkiUfvfDCCx8D1KlTx99+++2FCxcunP/RRx/N/89//tPoP//5T32A2267rfVJJ520cfny5fNOOumkjb/61a8SekfyQO0npsJFixbNLygomH/GGWdsuOWWW1rv7fOcccYZGwsLC2svXLhw1wvzyZMnN+rateuWjh076veM7FcYz1WAoqIiRo4c2e7444/fUPqyESNGdPjHP/6xaNGiRR8999xzTWfNmlUH9Fwtz0El0EXr5tbdY9pGokq2pRWtn1u3IjedO3du3d69e+82/q5p06YlrVu33j5kyJA148ePz+rTp0/2sGHD2sydOzcT4Kyzzvp65cqVtTt16tTzoosu6vDSSy81OKh4JTIOqVurZMJ5vT9785rjFvRo1XBz4cZttS/66/udLS/W9+K/vn/4qo3bavXIarj5zWuOW/DIeb0/a1y3VsXrNw7C119/nTZz5syFv/rVr74EWLlyZe333ntv4eTJkxcPGzas05YtW/Z4znz88cd13nrrrUXTp09fMHr06LZFRUXMmDGjzuTJk5vMnj17QUFBwfzi4mJ75JFHmlbH/4Mkv1/+8pdfzpo1q/6vf/3rlu+9916D2267bVVF7jdgwICNK1asyEz08SZMmND0Bz/4wbouXbpsB2jbtm0RQFpaGo0bNy4B2L59uxUVFZlZ8BT45z//2eSKK65YA3DFFVesefnllw+B4ATptNNOO/yUU07p3LZt21533XVXi9tvv71V9+7dc3r37p2987Tu6KOP7jZ06ND2Rx11VLfDDjusx5tvvlnve9/73uEdO3bsOWzYsDblhMn+YmratOmunxObNm1K23l5aU899VTjPn36ZH/55ZcZZ5555trHH3981/Pyb3/7W9PBgwevTfTfT8IXxotdqP7nKsBdd93VctCgQeuaN2++azfHG2+8Ub9jx47bcnJyttepU8d/+MMfrp00aVIT0HO13NgO9I4AvuPrSmnK8u0V+zzujpnt8da5u9OsWbPiTz75ZO6IESMK165dm9G/f//us2fPrtO4ceOSefPmzb///vuXt2jRouiSSy45fNy4cRU68ZbkcPyhTTd/kHfCgt8M6LZbScSdZ3Rb8cENJyw4/tCm1Tpz/MILL9ztCXnOOeesS09Pp3fv3ttat269fd68eXv8wBswYMCGOnXqeNu2bYsaN25ctHLlyoyXX3650Zw5c+r36tUrJzs7O+fdd99t+PHHHx/QD0sJh7vPqoo/FXnszMxMHzVq1Ge33XZb+zFjxqyoSNkRwFNPPdWkS5cuW3b+/dZbb223823hgQMHHrq3+y1atKjOunXrMo4++uhuPXr06H7//ffv+jlbVFREdnZ2TqtWrXqfeOKJX59yyimbANasWZOx8/SnY8eOO9auXZtR6vPVfe6555bOmDFjwahRo9rWq1evZMGCBfOPOuqoTQ899NCuz127du2SmTNnLrz00ktXDx48uPMjjzzyaUFBwUdPP/1088LCwr2+zby3mACuu+66tllZWd+aNGlSszFjxqwsfb/HH3+8yZgxY7JeeeWVxa1bty66+OKL1z7//PNNAbZs2WKvv/5644svvnhdRf6tJVpS5bn6ySef1IrFYof87Gc/W1368hUrVtRu27btrpPvdu3abf/8889rg56r5TmoBNpqNaqUrYJWu2Kfp1evXls++OCD3RoA165dm1ZYWFi7e/fu2xo3blxyySWXrH/yySc/Pfvss9dOnjy5MQSlHmeeeebGe++9d+WYMWM+feGFFw4p/xEkWWWkp3Hrd7t+eV7vNl8BnNe7zVe/OK3rlxnplTbqfJdatWp5Scn/DrO3bt19Ak2DBg12O+ku+6KvvFfJmZmZu+6TlpbmO3bsMHfn/PPP/2rnW3LLli2bN2bMmC8q6/9Dar6XXnqpcYsWLXbMmTOnzv5uu/OX74QJE5pPnDhx2c7LS78tPGXKlE/2dv+ioiKbM2dOvVdffXXxq6++unjMmDGt58yZkwnBz+CCgoL5n3766ZzZs2fXnzFjxn7j6d+//8ZDDjmkpE2bNkUNGjQoHjx48HqAXr16bV62bNmuF5Jnn332eoDevXtv6dy585aOHTvuqFu3rrdv337b0qVL99rzsK+Yxo8f/3lhYeGcc889d82YMWNa7rx82rRpDfPz87NeeeWVxS1atCgGOPHEEzdv3rw57cMPP8ycNGlS4z59+mzaeZ1IRVXnc/Xqq69uf/fdd3+WkbH72aX7nnl7eYeWZaXqc/WgsouMQ3ptIS3zQDsI4xFklmQ06bVl/zeEgQMHbty6dWvazpONoqIirr766vaDBw/+6t133627s6h969attmjRojqdOnXa/uGHH2buLOcAeP/99+u2a9dOTYQ1VNvGdXaU/lgV2rdvv2P16tW1Vq9enb5582b797//3Xhft3/uueealpSUMGfOnMwvvviids+ePbdV5HHOOOOMjZMnT276xRdfZEAwFWTx4sUVboKU1DZt2rS6U6dObfTOO+8UPPjgg6321yiz85fvtGnTFvfr129roo/Xrl277aeeeurXjRo1KmndunXRMcccs3HmzJm7Tchp3rx58fHHH78xFos1BmjWrFnRzriWL19eq2nTprsOU2rXrr3rd0taWho7T+XS0tIoKira9Sq09OWZmZm73af07fambEylXXrppWtffPHFXQcuHTp02LZp06b0efPm7ZbknHXWWWsff/zxpk8//XTTH/3oRyrfkIRU93N1zpw59YcMGXJY27Zte7388suH5OXldXjiiSeadOjQYdeJM8Bnn31Wu02bNjtAz9XyHFQCXb/bVWsOfALHTm71s69aU5FbpqWl8cILLyx5/vnnD+nYsWPPQw89tGdmZmbJuHHjPl+0aFGd4447rlvXrl1zevbsmdOnT5/Nl1xyybqvv/46fciQIYcefvjhPbp27ZpTUFBQd/To0Sv3/2gi5atXr54PHz68sG/fvt2/+93vdu7ates+XwAedthhW/v169dt4MCBXcaNG7esom/PHX300VtuvvnmlSeffHLXrl275px66qldV66s2MQaSW0lJSVcffXVHceMGbOiS5cu26+99tpV1113XbuqfMxzzz13/bvvvttgx44dbNy4Me39999v0KtXry0rV67M+Oqrr9IBvvnmG3vjjTcade/efSvA6aefvn7nW7wPPfRQswEDBqyvyhh32ldMpQ9cnn322SaHH374rud3u3bttj/33HNLLr300kNnzpy56xfzkCFD1k6aNKnZtGnTGp5//vnV8v8gNUMYz9XPP/987s4/Z5xxxrr8/PxPL7744vUnnnjipmXLltUpKCiovXXrVnv++eebnnPOOetBz9XyHNQv4/T6bYtqtzphw/Yv/tPkwBJpo3bWievT67WpcClI586dd7z22mtLyl5+7bXXrrn22mv3SMS/853vbN5fN6rI/owdO3a3F1233377qttvv32PRo9Zs2YtLP33yZMnl/s22llnnbXxrLPO2ggwbty43T73J5988tHO/77yyivXXnnllTrRkoSMHTu2edu2bbefffbZXwOMHDnyy969e3dfsmRJ7U8++SSzVatW39p521GjRu1znOKtt97abvTo0bu62z/44IMF5b0IPPLII7eedtppG7Kzs3ukpaVx8cUXr+7Xr9/W6dOn1/3JT35yaHFxMe5ugwYNWnv++edvALjjjju+OPvssw/v2LFj8zZt2mzfObmjqq1YsaLW3mK68cYb2y1durSOmXm7du22T5w4cXnp+/bu3Xvb448/vvRHP/rR4VOmTFnSo0ePbX379t1ap06dkl69em1u1KhRtTQrS80QxnN1b2rVqkV+fv6nAwYM6FpcXMwFF1zw1VFHHbUV9Fwtj5VX87LThx9+uKx37977XLW9rfDNemtfGdAt4U2EAOl1Spp+918LM7NOqNYmL6m5bpj8UZt7py5tPeKEw74YO6iH3mkQERGRA/bhhx827927d6eylx90h1Vm1ombG/a5fQXpdRLL5NPrlDTsc/sKJc8iIiIikkwqpZ6yQa+RXwFs/OD29sFa7329Y2CQnlnSsM/tK3beT0REksN9993X7IEHHmhV+rJ+/fp988QTT3waVkx7U1hYmH7SSSd1K3v5G2+8sTArK0uTMqRG03O1ah10CUdp2wqn1vtmzp1Z2wvfbALmlGz73wl3WmYJuNXOOnF9g2/dWqiTZ6kKUz9eU++/y9fVP7bjIZtOOLyZvsdERETkgO2thKNSO/ozs07YnJn176XFm1dmbCp4oFnR+rl1ffvXGVa7UVFGk15b6mdftSaRhkGRRJ1weLPNSpxFRESkKlXJSKz0em2KGh35mwqtohQRERERSSb7ayIsKSkp2e9waxERERGRmiSeA5c7JGN/CfS81atXN1YSLSIiIiKpoqSkxFavXt0YmFfe9fss4SgqKrqssLBwQmFhYU8qYeSdiIiIiEgSKAHmFRUVXVbelfucwiEiIiIiIrvTqbKIiIiISAKUQIuIiIiIJEAJtIiIiIhIApRAi4iIiIgkQAm0iIiIiEgC/h+/rXFdPBWc1gAAAABJRU5ErkJggg==\n",
+      "text/plain": [
+       "<Figure size 720x720 with 1 Axes>"
+      ]
+     },
+     "metadata": {
+      "needs_background": "light"
+     },
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "array.plot_array_system(show=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### It should be noted here that the the latitude and longitude here are WGS-84 decimal coordinates"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>id</th>\n",
+       "      <th>substation_id</th>\n",
+       "      <th>substation_name</th>\n",
+       "      <th>substation_latitude</th>\n",
+       "      <th>substation_longitude</th>\n",
+       "      <th>turbine_name</th>\n",
+       "      <th>turbine_latitude</th>\n",
+       "      <th>turbine_longitude</th>\n",
+       "      <th>string</th>\n",
+       "      <th>order</th>\n",
+       "      <th>cable_length</th>\n",
+       "      <th>bury_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>53.243950</td>\n",
+       "      <td>1.358783</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>53.248467</td>\n",
+       "      <td>1.349033</td>\n",
+       "      <td>0</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>53.252983</td>\n",
+       "      <td>1.339283</td>\n",
+       "      <td>0</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>53.257500</td>\n",
+       "      <td>1.329550</td>\n",
+       "      <td>0</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>53.262017</td>\n",
+       "      <td>1.319800</td>\n",
+       "      <td>0</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>57</th>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>53.251783</td>\n",
+       "      <td>1.368833</td>\n",
+       "      <td>11</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>58</th>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>53.239433</td>\n",
+       "      <td>1.368533</td>\n",
+       "      <td>11</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>59</th>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>53.234917</td>\n",
+       "      <td>1.378250</td>\n",
+       "      <td>11</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>60</th>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>53.230400</td>\n",
+       "      <td>1.388000</td>\n",
+       "      <td>11</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>61</th>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>53.225883</td>\n",
+       "      <td>1.397750</td>\n",
+       "      <td>11</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0.0</td>\n",
+       "      <td>0.0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>67 rows × 12 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "        id substation_id substation_name  substation_latitude  \\\n",
+       "0   DAE_A1       DOW_OSS         DOW_OSS              53.2648   \n",
+       "1   DAD_A2       DOW_OSS         DOW_OSS              53.2648   \n",
+       "2   DAC_A3       DOW_OSS         DOW_OSS              53.2648   \n",
+       "3   DAB_A4       DOW_OSS         DOW_OSS              53.2648   \n",
+       "4   DAA_A5       DOW_OSS         DOW_OSS              53.2648   \n",
+       "..     ...           ...             ...                  ...   \n",
+       "57  DCE_L1       DOW_OSS         DOW_OSS              53.2648   \n",
+       "58  DAF_L2       DOW_OSS         DOW_OSS              53.2648   \n",
+       "59  DAG_L3       DOW_OSS         DOW_OSS              53.2648   \n",
+       "60  DAH_L4       DOW_OSS         DOW_OSS              53.2648   \n",
+       "61  DAJ_L5       DOW_OSS         DOW_OSS              53.2648   \n",
+       "\n",
+       "    substation_longitude turbine_name  turbine_latitude  turbine_longitude  \\\n",
+       "0               1.378767       DAE_A1         53.243950           1.358783   \n",
+       "1               1.378767       DAD_A2         53.248467           1.349033   \n",
+       "2               1.378767       DAC_A3         53.252983           1.339283   \n",
+       "3               1.378767       DAB_A4         53.257500           1.329550   \n",
+       "4               1.378767       DAA_A5         53.262017           1.319800   \n",
+       "..                   ...          ...               ...                ...   \n",
+       "57              1.378767       DCE_L1         53.251783           1.368833   \n",
+       "58              1.378767       DAF_L2         53.239433           1.368533   \n",
+       "59              1.378767       DAG_L3         53.234917           1.378250   \n",
+       "60              1.378767       DAH_L4         53.230400           1.388000   \n",
+       "61              1.378767       DAJ_L5         53.225883           1.397750   \n",
+       "\n",
+       "    string  order  cable_length  bury_speed  \n",
+       "0        0      0           0.0         0.0  \n",
+       "1        0      1           0.0         0.0  \n",
+       "2        0      2           0.0         0.0  \n",
+       "3        0      3           0.0         0.0  \n",
+       "4        0      4           0.0         0.0  \n",
+       "..     ...    ...           ...         ...  \n",
+       "57      11      0           0.0         0.0  \n",
+       "58      11      1           0.0         0.0  \n",
+       "59      11      2           0.0         0.0  \n",
+       "60      11      3           0.0         0.0  \n",
+       "61      11      4           0.0         0.0  \n",
+       "\n",
+       "[67 rows x 12 columns]"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "array.location_data"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Now let's look at the cost for this cabling setup by each type of cable as well as the total cost"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Cable Type      |      Cost in USD\n",
+      "XLPE_400mm_33kV | $  19,868,788.44\n",
+      "XLPE_630mm_33kV | $   5,462,877.30\n",
+      "Total           | $  25,331,665.74\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
+    "for cable, cost in array.cost_by_type.items():\n",
+    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
+    "    \n",
+    "print(f\"{'Total':<16}| ${array.total_cable_cost:>15,.2f}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"case_3\"></a>\n",
+    "## Case 3: Distance-based \"coordinate\" system\n",
+    "\n",
+    "In this case, we will consider each turbine and substation on a distance-based \"coordinate\" system where the longitude and latitude are the longitudinal (x direction) and latitudinal (y direction) **distances**, in kilometers, from a common reference point. We are still using the Dudgeon data, but the distances were computed outside of this example and the details are not be included.\n",
+    "\n",
+    "Below, we can see that the input file is still encoded in the exact same manner as [Case 2](#case_2), but latitude and longitude are relative distances and not proper coordinates."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>id</th>\n",
+       "      <th>substation_id</th>\n",
+       "      <th>name</th>\n",
+       "      <th>longitude</th>\n",
+       "      <th>latitude</th>\n",
+       "      <th>string</th>\n",
+       "      <th>order</th>\n",
+       "      <th>cable_length</th>\n",
+       "      <th>bury_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>16.229909</td>\n",
+       "      <td>35.769173</td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "      <td></td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>14.890845</td>\n",
+       "      <td>33.450759</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>14.237528</td>\n",
+       "      <td>33.953026</td>\n",
+       "      <td>0</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>13.584211</td>\n",
+       "      <td>34.455182</td>\n",
+       "      <td>0</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>12.932034</td>\n",
+       "      <td>34.957450</td>\n",
+       "      <td>0</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>63</th>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>15.564263</td>\n",
+       "      <td>34.321749</td>\n",
+       "      <td>11</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>64</th>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>15.544161</td>\n",
+       "      <td>32.948491</td>\n",
+       "      <td>11</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>65</th>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>16.195266</td>\n",
+       "      <td>32.446335</td>\n",
+       "      <td>11</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>66</th>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>16.848583</td>\n",
+       "      <td>31.944067</td>\n",
+       "      <td>11</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>67</th>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>17.501899</td>\n",
+       "      <td>31.441800</td>\n",
+       "      <td>11</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>68 rows × 9 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "         id substation_id     name  longitude   latitude string order  \\\n",
+       "0   DOW_OSS       DOW_OSS  DOW_OSS  16.229909  35.769173                \n",
+       "1    DAE_A1       DOW_OSS   DAE_A1  14.890845  33.450759      0     0   \n",
+       "2    DAD_A2       DOW_OSS   DAD_A2  14.237528  33.953026      0     1   \n",
+       "3    DAC_A3       DOW_OSS   DAC_A3  13.584211  34.455182      0     2   \n",
+       "4    DAB_A4       DOW_OSS   DAB_A4  12.932034  34.957450      0     3   \n",
+       "..      ...           ...      ...        ...        ...    ...   ...   \n",
+       "63   DCE_L1       DOW_OSS   DCE_L1  15.564263  34.321749     11     0   \n",
+       "64   DAF_L2       DOW_OSS   DAF_L2  15.544161  32.948491     11     1   \n",
+       "65   DAG_L3       DOW_OSS   DAG_L3  16.195266  32.446335     11     2   \n",
+       "66   DAH_L4       DOW_OSS   DAH_L4  16.848583  31.944067     11     3   \n",
+       "67   DAJ_L5       DOW_OSS   DAJ_L5  17.501899  31.441800     11     4   \n",
+       "\n",
+       "   cable_length bury_speed  \n",
+       "0                           \n",
+       "1             0          0  \n",
+       "2             0          0  \n",
+       "3             0          0  \n",
+       "4             0          0  \n",
+       "..          ...        ...  \n",
+       "63            0          0  \n",
+       "64            0          0  \n",
+       "65            0          0  \n",
+       "66            0          0  \n",
+       "67            0          0  \n",
+       "\n",
+       "[68 rows x 9 columns]"
+      ]
+     },
+     "execution_count": 13,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "df = pd.read_csv(\"../library/cables/dudgeon_distance_based.csv\", index_col=False).fillna(\"\")\n",
+    "df"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### For this case we also add the `distance` argument to the `array_system_design` and set it to `True` to indicate we are dealing with distances."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+      "                         'distance': True,\n",
+      "                         'location_data': 'dudgeon_distance_based'},\n",
+      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+      " 'site': {'depth': 20},\n",
+      " 'turbine': 'SWT_6MW_154m_110m'}\n"
+     ]
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple_distance_based\")\n",
+    "pprint(config)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### OR we can create the flag in the function call.\n",
+    "\n",
+    "**Note:** the configuration dictionary will always override this setting."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "array_distance = CustomArraySystemDesign(config, distance=True)\n",
+    "array_distance.run()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Let's take a look at the data to see what it output\n",
+    "\n",
+    "While some of the cable lengths may be slightly different, the spacing is still maintained, and we can see that this is the Dudgeon windfarm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAtAAAALICAYAAABW0sdqAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8li6FKAAAgAElEQVR4nOzdd5icZfn28e+ZDaEkoYhgECLFmlBNABEboggCC4iKBSwIqAgEklFQVAREsG0CqIA0aXZfIBlEVPCnUiQkRKQEsCCKFEHpSE3O94/nCSYxZWd3dp+Z2fNzHBzI7ky4JJvdc+657uuSbSIiIiIioneGVV1AREREREQ7SYCOiIiIiGhAAnRERERERAMSoCMiIiIiGpAAHRERERHRgAToiIiIiIgGJEBHRERERDQgAToiIiIiogEJ0BERERERDUiAjoiIiIhoQAJ0REREREQDEqAjIiIiIhqQAB0RERER0YAE6IiIiIiIBiRAR0REREQ0IAE6IiIiIqIBCdAREREREQ1IgI6IiIiIaEACdEREREREAxKgIyIiIiIakAAdEREREdGABOiIiIiIiAYkQEdERERENCABOiIiIiKiAQnQERERERENSICOiIiIiGhAAnRERERERAMSoCMiIiIiGpAAHRERERHRgAToiIiIiIgGJEBHRERERDQgAToiIiIiogEJ0BERERERDUiAjoiIiIhoQAJ0REREREQDEqAjIiIiIhqQAB0RERER0YAE6IiIiIiIBiRAR0REREQ0IAE6IiIiIqIBCdAREREREQ1IgI6IiIiIaEACdEREREREAxKgIyIiIiIakAAdEREREdGABOiIiIiIiAYkQEdERERENCABOiIiIiKiAQnQERERERENSICOiIiIiGhAAnRERERERAMSoCMiIiIiGpAAHRERERHRgAToiIiIiIgGJEBHW1KtPka1elcvH9ulWn3MQNcUERERQ0MCdLSdMjjPAGaqVp+wnMdOBGYC03sbuCMiIiKWZXjVBUT0wfrAOsB6wCzV6icBR7mn+/EFD1CtPho4FphE8ULxrvJ5dwx+uREREdFJcgIdbcc93XcA44Fp5YcmA3NVq+8GoFp9d2AucFj5+anA+PJ5EREREf0i21XXENFnZQvH6cDEJXx6NvAx93TPGdyqIiIiopPlBDraWhmOXwMcusgn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2GKArqurG9e9e/e+3bp1+7impsaLVqKIiIiISEo0NDTY7Nmz+82cOXMcMKjp7ataVd6+W7dunyo8i4iIiEi1qKmp8W7dus0h7ML4ghZXoMP92x6e6+e/Uzf/hUs3XPbxsx196ad11m6dZXXr77Cwc58TP6zttMmytn49EREREZFSSjJws4vNqwrQbbJ45oOd5j19Xo8lsx5aFwwaFttnt73zr4b5z/2pZ/vue81Z+8tnvNeh+14LCvnYIiIiIiKlULCDgfOevbDrR//Zf9sl7927Hg1LrHF4BqBhcQ0NS2zJuxPX++g/+28779kLuxbqsUVERERESqUgK9Dznr2w69ynzt6M+kWtCOQO9Ytq5j519mYAa+9w2geFqEFEREREpBTWeAV68cwHO7U+PDeShOjFMx/qtKY1SHV68+OFdcvqG1p17bL6Bt78eGFBtyyJiIhIdVrjAD3v6fN6UL949b5O/eKaec+c170td3nllVfa7bvvvl/q1avX9pttttn2xxxzzGaLFi2yuXPn1gwaNGjLbbbZpl/v3r23GzBgwLZz5sypATjttNO6b7311ttts802/fr06dPvvvvu67xa9UpqLKtv4LvjJvXeKfdQ3/++9lGLL8IefvXDTjvlHur7vasmbd3awA0wc+bM2j59+vTr06dPv65du+640UYbfXn5/1+0aJGt+ivAgQceuOUNN9ywXtPP33fffZ2PPfbYzVpdjIiIiKTGGgXo+vnv1IUDg6vb5c5ZMvPB9eoXvNuqlcGGhgYOOuigrQcNGvTJG2+88dxrr7323Pz582uGDh3a8/zzz99oo402Wvriiy9Oe+mll56/+uqrX2/fvr1PnDix87/+9a/1nn322WkvvvjitPvvv//FrbbaaslqFiwp8eIH89vPnr+k3fOz5nba65JH+h73t6c3nbNw6Qr/nj9euLTm2Fuf2mzvvzza9/lZczvNnrek3YsfzG/f2sfo3r17/YwZM6bNmDFj2tFHHz178ODBs5b//7XWWmuV/+iXLl260tu+8Y1vzL/qqqveam0tIm3x8ssvt+vZs+cOs2bNqgWYPXt2bc+ePXf4xz/+sXbv3r23a3r9oYceukXPnj136NOnT79+/fr1nThxYuemn+/Tp0+/nXfeuU9LjzthwoQuffr06bf11ltvN3DgwG0BFixYYDvssEPfbbfdtt/WW2+9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\n",
+      "text/plain": [
+       "<Figure size 720x720 with 1 Axes>"
+      ]
+     },
+     "metadata": {
+      "needs_background": "light"
+     },
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "array_distance.plot_array_system(show=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Now let's look at the cost for this cabling setup by each type of cable as well as the total cost and compare it to the previous case\n",
+    "\n",
+    "While there is a minor difference, this difference is small in comparison to the total project cost and errs in a more conservative direction."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Cable Type       | Cost in USD (lat,lon) | Cost in USD (dist_lat,dist_lon)\n",
+      "XLPE_400mm_33kV  | $       19,868,788.44 | $  19,926,147.66\n",
+      "XLPE_630mm_33kV  | $        5,462,877.30 | $   5,479,206.87\n",
+      "Total            | $       25,331,665.74 | $  25,405,354.53\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"{'Cable Type':<16} | {'Cost in USD (lat,lon)':>20} | {'Cost in USD (dist_lat,dist_lon)':>15}\")\n",
+    "for (cable1, cost1), (cable2, cost2) in zip(array.cost_by_type.items(), array_distance.cost_by_type.items()):\n",
+    "    print(f\"{cable1:<16} | ${cost1:>20,.2f} | ${cost2:>15,.2f}\")\n",
+    "    \n",
+    "print(f\"{'Total':<16} | ${array.total_cable_cost:>20,.2f} | ${array_distance.total_cable_cost:>15,.2f}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"case_4\"></a>\n",
+    "## Case 4: We want to account for some additions to the cable lengths due to exclusion zones\n",
+    "\n",
+    "This can be done with the `\"average_exclusion_percent\"` keyword in the configuration that can be seen below.\n",
+    "\n",
+    "**Note:**\n",
+    " 1. There is an average  exclusion and is applied to each of the cable sections\n",
+    " 2. The plot won't change because it will not have details on the new paths so we'll only demonstrate the cost changes (a 4.8% increase, which is in line with the exclusion and the accounting for the site depth."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+       "  'location_data': 'dudgeon_array',\n",
+       "  'average_exclusion_percent': 0.05},\n",
+       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+       " 'site': {'depth': 20},\n",
+       " 'turbine': 'SWT_6MW_154m_110m'}"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_exclusions\")\n",
+    "config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "array_exclusion = CustomArraySystemDesign(config)\n",
+    "array_exclusion.run()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Cable Type      |      Cost in USD\n",
+      "XLPE_400mm_33kV | $  20,826,227.86\n",
+      "XLPE_630mm_33kV | $   5,729,721.17\n",
+      "Total           | $  26,555,949.03\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
+    "for cable, cost in array_exclusion.cost_by_type.items():\n",
+    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
+    "    \n",
+    "print(f\"{'Total':<16}| ${array_exclusion.total_cable_cost:>15,.2f}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"case_5\"></a>\n",
+    "## Case 5: Customize the distances \n",
+    "\n",
+    "If we look at the map in the [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf) there are different sized exclusions in the cables, so for this example we'll change the distances from [Case 4](#case_4) where we used an average exclusion to be a bit different in each case by using the `cable_length` column. In addition, we will utilize the `bury_speed` column to demonstrate how these columns will be used.\n",
+    "\n",
+    "**Note:** this work was done outside the notebook, but can be uploaded as show in the example below.\n",
+    "\n",
+    "For this example, half of the windfarm will have different soil condition, so we will use our proxy: `bury_speed` by modifying the burial speed to be fast (0.5 km/h) and slow (0.05 km/hr), respectively, to account for sandy soil and rocky soil. The purpose of this is for passing through customized parameters in the design phase to be utilized in the installation phase as will be seen in the final two examples."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+       "  'location_data': 'dudgeon_custom'},\n",
+       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+       " 'site': {'depth': 20},\n",
+       " 'turbine': 'SWT_6MW_154m_110m'}"
+      ]
+     },
+     "execution_count": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_custom\")\n",
+    "\n",
+    "# Note location_data the same one that was saved because I updated it!\n",
+    "config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "array_custom = CustomArraySystemDesign(config)\n",
+    "array_custom.run()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Note that there are now cable lengths defined as well as burial speeds for installation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>id</th>\n",
+       "      <th>substation_id</th>\n",
+       "      <th>substation_name</th>\n",
+       "      <th>substation_latitude</th>\n",
+       "      <th>substation_longitude</th>\n",
+       "      <th>turbine_name</th>\n",
+       "      <th>turbine_latitude</th>\n",
+       "      <th>turbine_longitude</th>\n",
+       "      <th>string</th>\n",
+       "      <th>order</th>\n",
+       "      <th>cable_length</th>\n",
+       "      <th>bury_speed</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAE_A1</td>\n",
+       "      <td>53.243950</td>\n",
+       "      <td>1.358783</td>\n",
+       "      <td>0</td>\n",
+       "      <td>0</td>\n",
+       "      <td>3.135279</td>\n",
+       "      <td>0.50</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAD_A2</td>\n",
+       "      <td>53.248467</td>\n",
+       "      <td>1.349033</td>\n",
+       "      <td>0</td>\n",
+       "      <td>1</td>\n",
+       "      <td>0.993860</td>\n",
+       "      <td>0.50</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAC_A3</td>\n",
+       "      <td>53.252983</td>\n",
+       "      <td>1.339283</td>\n",
+       "      <td>0</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0.993719</td>\n",
+       "      <td>0.50</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAB_A4</td>\n",
+       "      <td>53.257500</td>\n",
+       "      <td>1.329550</td>\n",
+       "      <td>0</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0.992699</td>\n",
+       "      <td>0.50</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAA_A5</td>\n",
+       "      <td>53.262017</td>\n",
+       "      <td>1.319800</td>\n",
+       "      <td>0</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0.993673</td>\n",
+       "      <td>0.50</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>62</th>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DCE_L1</td>\n",
+       "      <td>53.251783</td>\n",
+       "      <td>1.368833</td>\n",
+       "      <td>11</td>\n",
+       "      <td>0</td>\n",
+       "      <td>1.712822</td>\n",
+       "      <td>0.05</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>63</th>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAF_L2</td>\n",
+       "      <td>53.239433</td>\n",
+       "      <td>1.368533</td>\n",
+       "      <td>11</td>\n",
+       "      <td>1</td>\n",
+       "      <td>1.483318</td>\n",
+       "      <td>0.05</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>64</th>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAG_L3</td>\n",
+       "      <td>53.234917</td>\n",
+       "      <td>1.378250</td>\n",
+       "      <td>11</td>\n",
+       "      <td>2</td>\n",
+       "      <td>0.901721</td>\n",
+       "      <td>0.05</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>65</th>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAH_L4</td>\n",
+       "      <td>53.230400</td>\n",
+       "      <td>1.388000</td>\n",
+       "      <td>11</td>\n",
+       "      <td>3</td>\n",
+       "      <td>0.903679</td>\n",
+       "      <td>0.05</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>66</th>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>DOW_OSS</td>\n",
+       "      <td>53.2648</td>\n",
+       "      <td>1.378767</td>\n",
+       "      <td>DAJ_L5</td>\n",
+       "      <td>53.225883</td>\n",
+       "      <td>1.397750</td>\n",
+       "      <td>11</td>\n",
+       "      <td>4</td>\n",
+       "      <td>0.903736</td>\n",
+       "      <td>0.05</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>67 rows × 12 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "        id substation_id substation_name  substation_latitude  \\\n",
+       "0   DAE_A1       DOW_OSS         DOW_OSS              53.2648   \n",
+       "1   DAD_A2       DOW_OSS         DOW_OSS              53.2648   \n",
+       "2   DAC_A3       DOW_OSS         DOW_OSS              53.2648   \n",
+       "3   DAB_A4       DOW_OSS         DOW_OSS              53.2648   \n",
+       "4   DAA_A5       DOW_OSS         DOW_OSS              53.2648   \n",
+       "..     ...           ...             ...                  ...   \n",
+       "62  DCE_L1       DOW_OSS         DOW_OSS              53.2648   \n",
+       "63  DAF_L2       DOW_OSS         DOW_OSS              53.2648   \n",
+       "64  DAG_L3       DOW_OSS         DOW_OSS              53.2648   \n",
+       "65  DAH_L4       DOW_OSS         DOW_OSS              53.2648   \n",
+       "66  DAJ_L5       DOW_OSS         DOW_OSS              53.2648   \n",
+       "\n",
+       "    substation_longitude turbine_name  turbine_latitude  turbine_longitude  \\\n",
+       "0               1.378767       DAE_A1         53.243950           1.358783   \n",
+       "1               1.378767       DAD_A2         53.248467           1.349033   \n",
+       "2               1.378767       DAC_A3         53.252983           1.339283   \n",
+       "3               1.378767       DAB_A4         53.257500           1.329550   \n",
+       "4               1.378767       DAA_A5         53.262017           1.319800   \n",
+       "..                   ...          ...               ...                ...   \n",
+       "62              1.378767       DCE_L1         53.251783           1.368833   \n",
+       "63              1.378767       DAF_L2         53.239433           1.368533   \n",
+       "64              1.378767       DAG_L3         53.234917           1.378250   \n",
+       "65              1.378767       DAH_L4         53.230400           1.388000   \n",
+       "66              1.378767       DAJ_L5         53.225883           1.397750   \n",
+       "\n",
+       "    string  order  cable_length  bury_speed  \n",
+       "0        0      0      3.135279        0.50  \n",
+       "1        0      1      0.993860        0.50  \n",
+       "2        0      2      0.993719        0.50  \n",
+       "3        0      3      0.992699        0.50  \n",
+       "4        0      4      0.993673        0.50  \n",
+       "..     ...    ...           ...         ...  \n",
+       "62      11      0      1.712822        0.05  \n",
+       "63      11      1      1.483318        0.05  \n",
+       "64      11      2      0.901721        0.05  \n",
+       "65      11      3      0.903679        0.05  \n",
+       "66      11      4      0.903736        0.05  \n",
+       "\n",
+       "[67 rows x 12 columns]"
+      ]
+     },
+     "execution_count": 23,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "array_custom.location_data"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### See also that the costs have increased again!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Cable Type      |      Cost in USD\n",
+      "XLPE_400mm_33kV | $  22,269,793.09\n",
+      "XLPE_630mm_33kV | $   5,355,606.02\n",
+      "Total           | $  27,625,399.10\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
+    "for cable, cost in array_custom.cost_by_type.items():\n",
+    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
+    "    \n",
+    "print(f\"{'Total':<16}| ${array_custom.total_cable_cost:>15,.2f}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"running\"></a>\n",
+    "# Let's run some simulations!\n",
+    "We can now compare cases 2-4 to see how the installation cost will vary."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### First, we have to create a configuration dictionary for each of the 3 main cases we'll be simulating for installations, corresponding to the configuration file from the tests library. Then, we'll update eeach with the `design_result` of each of the 3 cases that we defined above."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "base_config = library.extract_library_specs(\"config\", \"example_array_cable_install\")\n",
+    "\n",
+    "#Case 2\n",
+    "array_case2 = deepcopy(base_config)\n",
+    "array_case2[\"array_system\"] = array.design_result[\"array_system\"]\n",
+    "\n",
+    "# Case 3\n",
+    "array_case3 = deepcopy(base_config)\n",
+    "array_case3[\"array_system\"] = array_distance.design_result[\"array_system\"]\n",
+    "\n",
+    "# Case 4\n",
+    "array_case4 = deepcopy(base_config)\n",
+    "array_case4[\"array_system\"] = array_exclusion.design_result[\"array_system\"]\n",
+    "\n",
+    "# Case 5\n",
+    "array_case5 = deepcopy(base_config)\n",
+    "array_case5[\"array_system\"] = array_custom.design_result[\"array_system\"]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Instantiate the simulations"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "sim2 = ArrayCableInstallation(array_case2)\n",
+    "sim3 = ArrayCableInstallation(array_case3)\n",
+    "sim4 = ArrayCableInstallation(array_case4)\n",
+    "sim5 = ArrayCableInstallation(array_case5)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Run the simulations\n",
+    "\n",
+    "We can see that both the installation cost and the time required to complete the simulation have all increased here, which corresponds to the increased cable lengths and changes to the burial speeds defined above."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Simulation                 |  Cost (in USD) |  Time (in hours)\n",
+      "straight-line distance     | $11,444,455.51 |            2,211\n",
+      "distance-based coordinates | $11,447,877.14 |            2,212\n",
+      "with exclusions            | $11,501,377.80 |            2,222\n",
+      "custom                     | $15,600,938.01 |            3,040\n"
+     ]
+    }
+   ],
+   "source": [
+    "names = (\"straight-line distance\", \"distance-based coordinates\", \"with exclusions\", \"custom\")\n",
+    "simulations = (sim2, sim3, sim4, sim5)\n",
+    "\n",
+    "print(f\"{'Simulation':<26} | {'Cost (in USD)':>14} | {'Time (in hours)':>16}\")\n",
+    "for name, simulation in zip(names, simulations):\n",
+    "    simulation.run()\n",
+    "    cost = simulation.installation_capex\n",
+    "    time = simulation.total_phase_time\n",
+    "    print(f\"{name:<26} | ${cost:>13,.2f} | {time:>16,.0f}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a id=\"project_manager\"></a>\n",
+    "## Let's put this all together\n",
+    "\n",
+    "#### Using `ProjectManager` we will run Case 4 from design to installation.\n",
+    "\n",
+    "We'll see here at the end that we end up with the same results running a custom array cabling project piecemeal and as a whole."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'design_phases': ['CustomArraySystemDesign'],\n",
+       " 'install_phases': ['ArrayCableInstallation'],\n",
+       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
+       " 'port': {'monthly_rate': 10000},\n",
+       " 'site': {'depth': 20, 'distance': 50},\n",
+       " 'turbine': 'SWT_6MW_154m_110m',\n",
+       " 'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
+       "  'location_data': 'dudgeon_custom',\n",
+       "  'distance': False},\n",
+       " 'array_cable_install_vessel': 'example_cable_lay_vessel',\n",
+       " 'array_cable_bury_vessel': 'example_cable_lay_vessel'}"
+      ]
+     },
+     "execution_count": 28,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "config = library.extract_library_specs(\"config\", \"example_custom_array_project_manager\")\n",
+    "config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "project = ProjectManager(config)\n",
+    "project.run()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Custom Design        | $27,625,399.10\n",
+      "Custom Installation  | $15,600,938.01\n",
+      "Total Cost.          | $43,226,337.11\n",
+      "Project Manager Cost | $43,226,337.11\n"
+     ]
+    }
+   ],
+   "source": [
+    "total = array_custom.total_cable_cost + sim5.installation_capex\n",
+    "\n",
+    "print(f\"Custom Design        | ${array_custom.total_cable_cost:>13,.2f}\")\n",
+    "print(f\"Custom Installation  | ${sim5.installation_capex:>13,.2f}\")\n",
+    "print(f\"Total Cost.          | ${total:>13,.2f}\")\n",
+    "print(f\"Project Manager Cost | ${project.bos_capex:>13,.2f}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Example - Dependent Phases.ipynb b/examples/Example - Dependent Phases.ipynb
new file mode 100644
index 00000000..8e2c2a74
--- /dev/null
+++ b/examples/Example - Dependent Phases.ipynb
@@ -0,0 +1,908 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ORBIT Example - Dependent Phases\n",
+    "\n",
+    "Last Updated: 07/28/2020\n",
+    "\n",
+    "The start times for phases in ORBIT can be defined relative to other phases. This is often used to simulate an installation phase that is dependent on an earlier installation phase. For example, the turbine installation for fixed bottom substructures can't happen until the substructures are installed. The phases can be scheduled such that the turbine installation starts when 50% of the monopiles have been installed."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pandas as pd\n",
+    "from ORBIT import ProjectManager"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Simple Configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# For this example we will start with a simple project with only two phases:\n",
+    "# - MonopileInstallation\n",
+    "# - TurbineInstallation\n",
+    "\n",
+    "# In the config below, the installation phases are defined in a list. They will run\n",
+    "# in the code sequentially. ie, TurbineInstallation will start at the timestep that\n",
+    "# MonopileInstallation ends.\n",
+    "\n",
+    "config = {\n",
+    "    \"site\": {\n",
+    "        \"depth\": 20,\n",
+    "        \"distance\": 40\n",
+    "    },\n",
+    "    \n",
+    "    \"plant\": {\"num_turbines\": 50},\n",
+    "    \"turbine\": \"SWT_6MW_154m_110m\",\n",
+    "    \"port\": {\"num_cranes\": 1},\n",
+    "    \n",
+    "    \"monopile\": {\n",
+    "        \"unit_cost\": 5e6,\n",
+    "        \"length\": 80,\n",
+    "        \"diameter\": 8,\n",
+    "        \"deck_space\": 1000,\n",
+    "        \"mass\": 1000,\n",
+    "    },\n",
+    "    \n",
+    "    \"transition_piece\": {\n",
+    "        \"unit_cost\": 3e6,\n",
+    "        \"deck_space\": 300,\n",
+    "        \"mass\": 500,\n",
+    "    },\n",
+    "    \n",
+    "    \"MonopileInstallation\": {\"wtiv\": \"example_wtiv\"},\n",
+    "    \"TurbineInstallation\": {\"wtiv\": \"example_wtiv\"},\n",
+    "    \n",
+    "    'install_phases': ['MonopileInstallation', 'TurbineInstallation']\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "      <th>phase_name</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>780</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Crane Reequip</td>\n",
+       "      <td>1.0</td>\n",
+       "      <td>7500.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2021.85</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>781</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lower TP</td>\n",
+       "      <td>1.0</td>\n",
+       "      <td>7500.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2022.85</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>782</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Bolt TP</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2026.85</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>783</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.3</td>\n",
+       "      <td>2250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2027.15</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>784</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.0</td>\n",
+       "      <td>1260000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2028.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>785</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2032.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>786</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2036.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>787</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Nacelle</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2040.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>788</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2041.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>789</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2043.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>790</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2044.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>791</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2048.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>792</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2052.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>793</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Nacelle</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2056.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>794</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2058.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>795</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2059.50</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>796</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Blade</td>\n",
+       "      <td>1.5</td>\n",
+       "      <td>11250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2061.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>797</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2065.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>798</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2069.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>799</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Nacelle</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>2073.00</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "     cost_multiplier agent                action  duration       cost   level  \\\n",
+       "780              NaN  WTIV         Crane Reequip       1.0     7500.0  ACTION   \n",
+       "781              NaN  WTIV              Lower TP       1.0     7500.0  ACTION   \n",
+       "782              NaN  WTIV               Bolt TP       4.0    30000.0  ACTION   \n",
+       "783              NaN  WTIV              Jackdown       0.3     2250.0  ACTION   \n",
+       "784              1.0  WTIV              Mobilize     168.0  1260000.0  ACTION   \n",
+       "785              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "786              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "787              NaN  WTIV        Fasten Nacelle       4.0    30000.0  ACTION   \n",
+       "788              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "789              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "790              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "791              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "792              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "793              NaN  WTIV        Fasten Nacelle       4.0    30000.0  ACTION   \n",
+       "794              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "795              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "796              NaN  WTIV          Fasten Blade       1.5    11250.0  ACTION   \n",
+       "797              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "798              NaN  WTIV  Fasten Tower Section       4.0    30000.0  ACTION   \n",
+       "799              NaN  WTIV        Fasten Nacelle       4.0    30000.0  ACTION   \n",
+       "\n",
+       "        time                 phase  site_depth  hub_height  \\\n",
+       "780  2021.85  MonopileInstallation        20.0       110.0   \n",
+       "781  2022.85  MonopileInstallation        20.0       110.0   \n",
+       "782  2026.85  MonopileInstallation        20.0       110.0   \n",
+       "783  2027.15  MonopileInstallation        20.0       110.0   \n",
+       "784  2028.00   TurbineInstallation         NaN         NaN   \n",
+       "785  2032.00   TurbineInstallation        20.0       110.0   \n",
+       "786  2036.00   TurbineInstallation        20.0       110.0   \n",
+       "787  2040.00   TurbineInstallation        20.0       110.0   \n",
+       "788  2041.50   TurbineInstallation        20.0       110.0   \n",
+       "789  2043.00   TurbineInstallation        20.0       110.0   \n",
+       "790  2044.50   TurbineInstallation        20.0       110.0   \n",
+       "791  2048.50   TurbineInstallation        20.0       110.0   \n",
+       "792  2052.50   TurbineInstallation        20.0       110.0   \n",
+       "793  2056.50   TurbineInstallation        20.0       110.0   \n",
+       "794  2058.00   TurbineInstallation        20.0       110.0   \n",
+       "795  2059.50   TurbineInstallation        20.0       110.0   \n",
+       "796  2061.00   TurbineInstallation        20.0       110.0   \n",
+       "797  2065.00   TurbineInstallation        20.0       110.0   \n",
+       "798  2069.00   TurbineInstallation        20.0       110.0   \n",
+       "799  2073.00   TurbineInstallation        20.0       110.0   \n",
+       "\n",
+       "               phase_name  \n",
+       "780  MonopileInstallation  \n",
+       "781  MonopileInstallation  \n",
+       "782  MonopileInstallation  \n",
+       "783  MonopileInstallation  \n",
+       "784                   NaN  \n",
+       "785   TurbineInstallation  \n",
+       "786   TurbineInstallation  \n",
+       "787   TurbineInstallation  \n",
+       "788   TurbineInstallation  \n",
+       "789   TurbineInstallation  \n",
+       "790   TurbineInstallation  \n",
+       "791   TurbineInstallation  \n",
+       "792   TurbineInstallation  \n",
+       "793   TurbineInstallation  \n",
+       "794   TurbineInstallation  \n",
+       "795   TurbineInstallation  \n",
+       "796   TurbineInstallation  \n",
+       "797   TurbineInstallation  \n",
+       "798   TurbineInstallation  \n",
+       "799   TurbineInstallation  "
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "df = pd.DataFrame(project.actions)  # Return a table of all of the vessel actions that were performed throughout the project.\n",
+    "df.iloc[780:800]                            # Filter to rows 780-790 where the TurbineInstallation phase begins."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Defining Dependent Phases"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# In the new config below, the installation phases are defined in a dict.\n",
+    "# MonopileInstallation is set to begin at timestep 0, and TurbineInstallation\n",
+    "# will begin when MonopileInstallation is 50% complete.\n",
+    "\n",
+    "config = {\n",
+    "    \"site\": {\n",
+    "        \"depth\": 20,\n",
+    "        \"distance\": 40\n",
+    "    },\n",
+    "    \n",
+    "    \"plant\": {\"num_turbines\": 50},\n",
+    "    \"turbine\": \"SWT_6MW_154m_110m\",\n",
+    "    \"port\": {\"num_cranes\": 1},\n",
+    "    \n",
+    "    \"monopile\": {\n",
+    "        \"unit_cost\": 5e6,\n",
+    "        \"length\": 80,\n",
+    "        \"diameter\": 8,\n",
+    "        \"deck_space\": 1000,\n",
+    "        \"mass\": 1000,\n",
+    "    },\n",
+    "    \n",
+    "    \"transition_piece\": {\n",
+    "        \"unit_cost\": 3e6,\n",
+    "        \"deck_space\": 300,\n",
+    "        \"mass\": 500,\n",
+    "    },\n",
+    "    \n",
+    "    \"MonopileInstallation\": {\"wtiv\": \"example_wtiv\"},\n",
+    "    \"TurbineInstallation\": {\"wtiv\": \"example_wtiv\"},\n",
+    "    \n",
+    "    'install_phases': {                                        # <--- 'install_phases' changed to a dict\n",
+    "        \"MonopileInstallation\": 0,                             # <--- MonopileInstallation will start at timestep 0\n",
+    "        \"TurbineInstallation\": (\"MonopileInstallation\", 0.25)   # <--- TurbineInstallation will start when MonopileInstallation is 50% complete.\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>cost_multiplier</th>\n",
+       "      <th>agent</th>\n",
+       "      <th>action</th>\n",
+       "      <th>duration</th>\n",
+       "      <th>cost</th>\n",
+       "      <th>level</th>\n",
+       "      <th>time</th>\n",
+       "      <th>phase</th>\n",
+       "      <th>site_depth</th>\n",
+       "      <th>hub_height</th>\n",
+       "      <th>phase_name</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>189</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Monopile</td>\n",
+       "      <td>12.0</td>\n",
+       "      <td>90000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>498.8360</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>190</th>\n",
+       "      <td>1.0</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Mobilize</td>\n",
+       "      <td>168.0</td>\n",
+       "      <td>1260000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>506.7875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>191</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Transition Piece</td>\n",
+       "      <td>8.0</td>\n",
+       "      <td>60000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>506.8360</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>MonopileInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>192</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>510.7875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>193</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Fasten Tower Section</td>\n",
+       "      <td>4.0</td>\n",
+       "      <td>30000.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>514.7875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>...</th>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "      <td>...</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2245</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.5</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3943.3875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2246</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Release Blade</td>\n",
+       "      <td>1.0</td>\n",
+       "      <td>7500.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3944.3875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "      <td>NaN</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2247</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Lift Blade</td>\n",
+       "      <td>1.1</td>\n",
+       "      <td>8250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3945.4875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2248</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Attach Blade</td>\n",
+       "      <td>3.5</td>\n",
+       "      <td>26250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3948.9875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2249</th>\n",
+       "      <td>NaN</td>\n",
+       "      <td>WTIV</td>\n",
+       "      <td>Jackdown</td>\n",
+       "      <td>0.3</td>\n",
+       "      <td>2250.0</td>\n",
+       "      <td>ACTION</td>\n",
+       "      <td>3949.2875</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "      <td>20.0</td>\n",
+       "      <td>110.0</td>\n",
+       "      <td>TurbineInstallation</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "<p>2061 rows × 11 columns</p>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "      cost_multiplier agent                   action  duration       cost  \\\n",
+       "189               NaN  WTIV          Fasten Monopile      12.0    90000.0   \n",
+       "190               1.0  WTIV                 Mobilize     168.0  1260000.0   \n",
+       "191               NaN  WTIV  Fasten Transition Piece       8.0    60000.0   \n",
+       "192               NaN  WTIV     Fasten Tower Section       4.0    30000.0   \n",
+       "193               NaN  WTIV     Fasten Tower Section       4.0    30000.0   \n",
+       "...               ...   ...                      ...       ...        ...   \n",
+       "2245              NaN  WTIV             Attach Blade       3.5    26250.0   \n",
+       "2246              NaN  WTIV            Release Blade       1.0     7500.0   \n",
+       "2247              NaN  WTIV               Lift Blade       1.1     8250.0   \n",
+       "2248              NaN  WTIV             Attach Blade       3.5    26250.0   \n",
+       "2249              NaN  WTIV                 Jackdown       0.3     2250.0   \n",
+       "\n",
+       "       level       time                 phase  site_depth  hub_height  \\\n",
+       "189   ACTION   498.8360  MonopileInstallation        20.0       110.0   \n",
+       "190   ACTION   506.7875   TurbineInstallation         NaN         NaN   \n",
+       "191   ACTION   506.8360  MonopileInstallation        20.0       110.0   \n",
+       "192   ACTION   510.7875   TurbineInstallation        20.0       110.0   \n",
+       "193   ACTION   514.7875   TurbineInstallation        20.0       110.0   \n",
+       "...      ...        ...                   ...         ...         ...   \n",
+       "2245  ACTION  3943.3875   TurbineInstallation        20.0       110.0   \n",
+       "2246  ACTION  3944.3875   TurbineInstallation         NaN         NaN   \n",
+       "2247  ACTION  3945.4875   TurbineInstallation        20.0       110.0   \n",
+       "2248  ACTION  3948.9875   TurbineInstallation        20.0       110.0   \n",
+       "2249  ACTION  3949.2875   TurbineInstallation        20.0       110.0   \n",
+       "\n",
+       "                phase_name  \n",
+       "189   MonopileInstallation  \n",
+       "190                    NaN  \n",
+       "191   MonopileInstallation  \n",
+       "192    TurbineInstallation  \n",
+       "193    TurbineInstallation  \n",
+       "...                    ...  \n",
+       "2245   TurbineInstallation  \n",
+       "2246                   NaN  \n",
+       "2247   TurbineInstallation  \n",
+       "2248   TurbineInstallation  \n",
+       "2249   TurbineInstallation  \n",
+       "\n",
+       "[2061 rows x 11 columns]"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "project = ProjectManager(config)\n",
+    "project.run()\n",
+    "\n",
+    "df = pd.DataFrame(project.actions)\n",
+    "\n",
+    "monopiles = df.loc[df[\"phase\"]==\"MonopileInstallation\"]  # Filter actions table to the MonopileInstallation phase.\n",
+    "halfway_point = max(monopiles[\"time\"]) / 4               # Find the halway point of the MonopileInstallation phase.\n",
+    "\n",
+    "df.loc[df[\"time\"] > halfway_point - 10]                  # Display the total actions table starting from 10 hours prior to the halfway point.\n",
+    "                                                         # Notice the \"Mobilize\" action for the TurbineInstallation phase. This marks the beginning of\n",
+    "                                                         # the TurbineInstallation phase."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Other Examples\n",
+    "\n",
+    "The examples below are not complete configurations but showcase the flexibility of dependent phases."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Multiple dependent phases\n",
+    "config = {\n",
+    "    \n",
+    "    # ...\n",
+    "    \n",
+    "    'install_phases': {\n",
+    "        'MonopileInstallation': 0,                                      # MonopileInstallation will start at timestep 0\n",
+    "        'ScourProtectionInstallation': (\"MonopileInstallation\", 0.8),   # ScourProtectionInstallation will start when MonopileInstallation is 80% complete\n",
+    "        'TurbineInstallation': (\"MonopileInstallation\", 0.5)            # TurbineInstallation will start when MonopileInstallation is 50% complete\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Multiple dependent phases with start dates\n",
+    "config = {\n",
+    "    \n",
+    "    # ...\n",
+    "    \n",
+    "    'install_phases': {\n",
+    "        'MonopileInstallation': \"04/01/2010\",                           # MonopileInstallation will start on April 1st, 2010\n",
+    "        'ScourProtectionInstallation': (\"MonopileInstallation\", 0.8),   # ScourProtectionInstallation will start when MonopileInstallation is 80% complete\n",
+    "        'TurbineInstallation': (\"MonopileInstallation\", 0.5)            # TurbineInstallation will start when MonopileInstallation is 50% complete\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Chained dependent phases\n",
+    "config = {\n",
+    "    \n",
+    "    # ...\n",
+    "\n",
+    "    \"install_phases\": {\n",
+    "        \"ScourProtectionInstallation\": 0,                               # ScourProtectionInstallation will start at timestep 0\n",
+    "        \"MonopileInstallation\": (\"ScourProtectionInstallation\", 0.1),   # MonopileInstallation will start when the above is 10% complete\n",
+    "        \"TurbineInstallation\": (\"MonopileInstallation\", 0.5)            # TurbineInstallation will start whent he above is 50% complete\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Multiple chains\n",
+    "config = {\n",
+    "    \n",
+    "    # ...\n",
+    "\n",
+    "    \"install_phases\": {\n",
+    "        \"ScourProtectionInstallation\": 0,                                # ScourProtectionInstallation will start at timestep 0\n",
+    "        \"MonopileInstallation\": (\"ScourProtectionInstallation\", 0.1),    # MonopileInstallation will start when the above phase is 10% complete\n",
+    "        \"TurbineInstallation\": (\"MonopileInstallation\", 0.5),            # TurbineInstallation will start when the above phase is 50% complete\n",
+    "        \"ArrayCableInstallation\": (\"MonopileInstallation\", 0.25),        # ArrayCableInstallation will start when the Monopiles are 25% complete\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Example - Modifying Library Assets.ipynb b/examples/Example - Modifying Library Assets.ipynb
new file mode 100644
index 00000000..e40cdd89
--- /dev/null
+++ b/examples/Example - Modifying Library Assets.ipynb
@@ -0,0 +1,216 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Example - Library Assets\n",
+    "\n",
+    "ORBIT stores the inputs associated with vessels, cables and turbines in a library in order to allow for modeling of discrete options of these inputs as well as to keep the input configurations cleaner. For example, all of the inputs related to the WTIV that we have been using to this point, are stored in the 'example_wtiv.yaml' file in the ORBIT library."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Configuring the library"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '/Users/jnunemak/Fun/repos/ORBIT/examples/library'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# By default, ORBIT initializes the library at '~/ORBIT/library/'\n",
+    "# The library location can also be changed by using the following:\n",
+    "\n",
+    "import os\n",
+    "from ORBIT.core.library import initialize_library\n",
+    "initialize_library(os.path.join(os.getcwd(), \"library\"))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This allows for proprietary vessel/cable/turbine information to be stored outside of the model repo.\n",
+    "\n",
+    "# Note: The library functions will search for library assets at an external library first, but will\n",
+    "# search the internal ORBIT library if it is not found. This means that the example library files\n",
+    "# don't need to be copied to an external library to be used."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Vessels"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Navigate to '~/ORBIT/library/vessels/example_wtiv.yaml':"
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {},
+   "source": [
+    "crane_specs:\n",
+    "  max_hook_height: 100    # m\n",
+    "  max_lift: 1200          # t\n",
+    "  max_windspeed: 15       # m/s\n",
+    "jacksys_specs:\n",
+    "  leg_length: 110         # m\n",
+    "  max_depth: 75           # m\n",
+    "  max_extension: 85       # m\n",
+    "  speed_above_depth: 1    # m/min\n",
+    "  speed_below_depth: 2.5  # m/min\n",
+    "storage_specs:\n",
+    "  max_cargo: 8000         # t\n",
+    "  max_deck_load: 15       # t/m^2\n",
+    "  max_deck_space: 4000    # m^2\n",
+    "transport_specs:\n",
+    "  max_waveheight: 3       # m\n",
+    "  max_windspeed: 20       # m/s\n",
+    "  transit_speed: 10       # km/h\n",
+    "vessel_specs:\n",
+    "  day_rate: 180000        # USD/day\n",
+    "  mobilization_days: 7    # days\n",
+    "  mobilization_mult: 1    # Mobilization multiplier applied to 'day_rate'\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This vessel file defines a generic WTIV that could be used for installation of turbines, substructures, etc.\n",
+    "# The vessel file is organized by different subcomponents, eg. crane, jacking system, storage.\n",
+    "\n",
+    "# The weather constraints for the vessel are also defined in 'transport_specs' and 'crane_specs'\n",
+    "# These constraints are applied to underlying processes that the vessel performs in the simulation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Navigate to '~/ORBIT/library/vessels/example_feeder.yaml':"
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {},
+   "source": [
+    "crane_specs:\n",
+    "  max_lift: 500             # t\n",
+    "jacksys_specs:\n",
+    "  leg_length: 85            # m\n",
+    "  max_depth: 40             # m\n",
+    "  max_extension: 60         # m\n",
+    "  speed_above_depth: 0.5    # m/min\n",
+    "  speed_below_depth: 0.5    # m/min\n",
+    "storage_specs:\n",
+    "  max_cargo: 1200           # t\n",
+    "  max_deck_load: 8          # t/m^2\n",
+    "  max_deck_space: 1000      # m^2\n",
+    "transport_specs:\n",
+    "  max_waveheight: 2.5       # m\n",
+    "  max_windspeed: 20         # m/s\n",
+    "  transit_speed: 6          # km/h\n",
+    "vessel_specs:\n",
+    "  day_rate: 75000           # USD/day\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Turbines"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Turbine files contain information on a given turbine and the associated subcomponents.\n",
+    "# See below for an example 6MW turbine"
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {},
+   "source": [
+    "blade:\n",
+    "  deck_space: 100     # m^2\n",
+    "  length: 75          # m\n",
+    "  mass: 100           # t\n",
+    "hub_height: 110       # m\n",
+    "nacelle:\n",
+    "  deck_space: 200     # m^2\n",
+    "  mass: 360           # t\n",
+    "name: SWT-6MW-154\n",
+    "rotor_diameter: 154   # m\n",
+    "tower:\n",
+    "  deck_space: 36      # m^2\n",
+    "  sections: 2         # n\n",
+    "  length: 110         # m\n",
+    "  mass: 150           # t\n",
+    "turbine_rating: 6     # MW\n",
+    "rated_windspeed: 13   # m/s\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# These inputs will affect which vessels are able to install the turbine as well as the underyling process times.\n",
+    "# Deck space is a measure of the area that the component would take up on a transportation vessel."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Example - Parametric Manager.ipynb b/examples/Example - Parametric Manager.ipynb
new file mode 100644
index 00000000..2a17e0ff
--- /dev/null
+++ b/examples/Example - Parametric Manager.ipynb
@@ -0,0 +1,510 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### ORBIT Example - ParametricManager\n",
+    "\n",
+    "ParametricManager provides a similar interface into ORBIT as ProjectManager but allows for some (or all) inputs to be parameterized. This class is useful for quickly exploring how a module or project scales with certain inputs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from ORBIT.phases.design import MonopileDesign\n",
+    "\n",
+    "from ORBIT import ParametricManager, ProjectManager"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'site': {'depth': 'm', 'mean_windspeed': 'm/s'},\n",
+       " 'plant': {'num_turbines': 'int'},\n",
+       " 'turbine': {'rotor_diameter': 'm',\n",
+       "  'hub_height': 'm',\n",
+       "  'rated_windspeed': 'm/s'},\n",
+       " 'monopile_design': {'yield_stress': 'Pa (optional)',\n",
+       "  'load_factor': 'float (optional)',\n",
+       "  'material_factor': 'float (optional)',\n",
+       "  'monopile_density': 'kg/m3 (optional)',\n",
+       "  'monopile_modulus': 'Pa (optional)',\n",
+       "  'monopile_tp_connection_thickness': 'm (optional)',\n",
+       "  'transition_piece_density': 'kg/m3 (optional)',\n",
+       "  'transition_piece_thickness': 'm (optional)',\n",
+       "  'transition_piece_length': 'm (optional)',\n",
+       "  'soil_coefficient': 'N/m3 (optional)',\n",
+       "  'air_density': 'kg/m3 (optional)',\n",
+       "  'weibull_scale_factor': 'float (optional)',\n",
+       "  'weibull_shape_factor': 'float (optional)',\n",
+       "  'turb_length_scale': 'm (optional)',\n",
+       "  'monopile_steel_cost': 'USD/t (optional)',\n",
+       "  'tp_steel_cost': 'USD/t (optional)'}}"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# For this example we will look at the MonopileDesign module.\n",
+    "MonopileDesign.expected_config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The following inputs are the only \"required\" inputs for the MonopileDesign module.\n",
+    "# Thee 'site' inputs are commented out as they will be defined as parametric inputs below.\n",
+    "\n",
+    "base_config = {\n",
+    "#     \"site\": {\n",
+    "#         \"depth\": 20,\n",
+    "#         \"mean_windspeed\": 8\n",
+    "#     }\n",
+    "    \"turbine\": \"12MW_generic\",\n",
+    "    \"plant\": {\n",
+    "        \"num_turbines\": 50\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Parametric inputs:\n",
+    "\n",
+    "parameters = {\n",
+    "    \"site.depth\": [20, 40, 60],           # The dot-notation allows you to access nested dictionaries\n",
+    "    \"site.mean_windspeed\": [8, 9, 10]     # These inputs correspond to the 'depth' and 'mean_windspeed' inputs above, which are nested\n",
+    "}                                         # in the 'site' dictionary. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Desired results:\n",
+    "# Since there are so many available results in ORBIT, you have to tell ParametricManager which ones\n",
+    "# you are interested in for this parametric run. The syntax for this always follows the \n",
+    "# 'lambda run: run.{output}' format. The {output} can be any output available for the configured module\n",
+    "\n",
+    "results = {\n",
+    "    \"capex\": lambda run: run.total_cost\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ORBIT library intialized at '/Users/jnunemak/Fun/repos/ORBIT/library'\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>site.depth</th>\n",
+       "      <th>site.mean_windspeed</th>\n",
+       "      <th>capex</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>20</td>\n",
+       "      <td>8</td>\n",
+       "      <td>2.388521e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>40</td>\n",
+       "      <td>9</td>\n",
+       "      <td>3.261239e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>60</td>\n",
+       "      <td>10</td>\n",
+       "      <td>4.289900e+08</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   site.depth  site.mean_windspeed         capex\n",
+       "0          20                    8  2.388521e+08\n",
+       "1          40                    9  3.261239e+08\n",
+       "2          60                   10  4.289900e+08"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Pass the above definitions into ParametricManager like this:\n",
+    "# Note: I only want to run MonopileDesign so I passed it into module directily.\n",
+    "# If you want to run an entire project (with multiple modules), leave module blank and it will\n",
+    "# automatically run ProjectManager\n",
+    "\n",
+    "parametric = ParametricManager(base_config, parameters, results, module=MonopileDesign)\n",
+    "parametric.run()\n",
+    "\n",
+    "\n",
+    "# By default, ParametricManager doesn't run the product of all parameters and just\n",
+    "# runs the first set of inputs, then the second set of inputs, etc.\n",
+    "# In this case, there will only be 3 results\n",
+    "parametric.results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>site.depth</th>\n",
+       "      <th>site.mean_windspeed</th>\n",
+       "      <th>capex</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>20</td>\n",
+       "      <td>8</td>\n",
+       "      <td>2.388521e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>20</td>\n",
+       "      <td>9</td>\n",
+       "      <td>2.545394e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>20</td>\n",
+       "      <td>10</td>\n",
+       "      <td>2.705817e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>40</td>\n",
+       "      <td>8</td>\n",
+       "      <td>3.062888e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>40</td>\n",
+       "      <td>9</td>\n",
+       "      <td>3.261239e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>40</td>\n",
+       "      <td>10</td>\n",
+       "      <td>3.463884e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>60</td>\n",
+       "      <td>8</td>\n",
+       "      <td>3.798072e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>60</td>\n",
+       "      <td>9</td>\n",
+       "      <td>4.041444e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>60</td>\n",
+       "      <td>10</td>\n",
+       "      <td>4.289900e+08</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   site.depth  site.mean_windspeed         capex\n",
+       "0          20                    8  2.388521e+08\n",
+       "1          20                    9  2.545394e+08\n",
+       "2          20                   10  2.705817e+08\n",
+       "3          40                    8  3.062888e+08\n",
+       "4          40                    9  3.261239e+08\n",
+       "5          40                   10  3.463884e+08\n",
+       "6          60                    8  3.798072e+08\n",
+       "7          60                    9  4.041444e+08\n",
+       "8          60                   10  4.289900e+08"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# To configure ParametricManager to run the product of all inputs, pass 'product=True'\n",
+    "# This will result in 3x3 results as each combination is ran\n",
+    "parametric = ParametricManager(base_config, parameters, results, module=MonopileDesign, product=True)\n",
+    "parametric.run()\n",
+    "\n",
+    "parametric.results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "10 runs elapsed time: 0.06s\n",
+      "27 runs estimated time: 0.15s\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div>\n",
+       "<style scoped>\n",
+       "    .dataframe tbody tr th:only-of-type {\n",
+       "        vertical-align: middle;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe tbody tr th {\n",
+       "        vertical-align: top;\n",
+       "    }\n",
+       "\n",
+       "    .dataframe thead th {\n",
+       "        text-align: right;\n",
+       "    }\n",
+       "</style>\n",
+       "<table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       "    <tr style=\"text-align: right;\">\n",
+       "      <th></th>\n",
+       "      <th>site.depth</th>\n",
+       "      <th>site.mean_windspeed</th>\n",
+       "      <th>monopile_design.soil_coefficient</th>\n",
+       "      <th>capex</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <th>0</th>\n",
+       "      <td>60</td>\n",
+       "      <td>8</td>\n",
+       "      <td>4000000</td>\n",
+       "      <td>3.798072e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>1</th>\n",
+       "      <td>40</td>\n",
+       "      <td>9</td>\n",
+       "      <td>4500000</td>\n",
+       "      <td>3.240537e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>2</th>\n",
+       "      <td>40</td>\n",
+       "      <td>9</td>\n",
+       "      <td>4000000</td>\n",
+       "      <td>3.261239e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>3</th>\n",
+       "      <td>40</td>\n",
+       "      <td>8</td>\n",
+       "      <td>4000000</td>\n",
+       "      <td>3.062888e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>4</th>\n",
+       "      <td>20</td>\n",
+       "      <td>10</td>\n",
+       "      <td>4500000</td>\n",
+       "      <td>2.685895e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>5</th>\n",
+       "      <td>20</td>\n",
+       "      <td>9</td>\n",
+       "      <td>4000000</td>\n",
+       "      <td>2.545394e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>6</th>\n",
+       "      <td>60</td>\n",
+       "      <td>10</td>\n",
+       "      <td>5000000</td>\n",
+       "      <td>4.243511e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>7</th>\n",
+       "      <td>60</td>\n",
+       "      <td>9</td>\n",
+       "      <td>4000000</td>\n",
+       "      <td>4.041444e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>8</th>\n",
+       "      <td>40</td>\n",
+       "      <td>8</td>\n",
+       "      <td>5000000</td>\n",
+       "      <td>3.027043e+08</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <th>9</th>\n",
+       "      <td>20</td>\n",
+       "      <td>8</td>\n",
+       "      <td>5000000</td>\n",
+       "      <td>2.356558e+08</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table>\n",
+       "</div>"
+      ],
+      "text/plain": [
+       "   site.depth  site.mean_windspeed  monopile_design.soil_coefficient  \\\n",
+       "0          60                    8                           4000000   \n",
+       "1          40                    9                           4500000   \n",
+       "2          40                    9                           4000000   \n",
+       "3          40                    8                           4000000   \n",
+       "4          20                   10                           4500000   \n",
+       "5          20                    9                           4000000   \n",
+       "6          60                   10                           5000000   \n",
+       "7          60                    9                           4000000   \n",
+       "8          40                    8                           5000000   \n",
+       "9          20                    8                           5000000   \n",
+       "\n",
+       "          capex  \n",
+       "0  3.798072e+08  \n",
+       "1  3.240537e+08  \n",
+       "2  3.261239e+08  \n",
+       "3  3.062888e+08  \n",
+       "4  2.685895e+08  \n",
+       "5  2.545394e+08  \n",
+       "6  4.243511e+08  \n",
+       "7  4.041444e+08  \n",
+       "8  3.027043e+08  \n",
+       "9  2.356558e+08  "
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# If you are configuring many parameters it can take a long time to run, especially if weather is turned on.\n",
+    "# To get an idea of how long it'll take, you can run the .preview() method:\n",
+    "\n",
+    "parameters = {\n",
+    "    \"site.depth\": [20, 40, 60],\n",
+    "    \"site.mean_windspeed\": [8, 9, 10],\n",
+    "    \"monopile_design.soil_coefficient\": [4000000, 4500000, 5000000]\n",
+    "}      \n",
+    "\n",
+    "parametric = ParametricManager(base_config, parameters, results, module=MonopileDesign, product=True)\n",
+    "parametric.preview()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/example_fixed_project.yaml b/examples/configs/example_fixed_project.yaml
similarity index 87%
rename from examples/example_fixed_project.yaml
rename to examples/configs/example_fixed_project.yaml
index 5a29b68a..2e8ee389 100644
--- a/examples/example_fixed_project.yaml
+++ b/examples/configs/example_fixed_project.yaml
@@ -1,24 +1,47 @@
+# Site + Plant Parameters
+site:
+  depth: 22.5
+  distance: 124
+  distance_to_landfall: 35
+  mean_windspeed: 9
+plant:
+  layout: grid
+  num_turbines: 50
+  row_spacing: 7
+  substation_distance: 1
+  turbine_spacing: 7
+landfall:
+  interconnection_distance: 3
+  trench_length: 2
+turbine: SWT_6MW_154m_110m
+# Vessels
+array_cable_install_vessel: example_cable_lay_vessel
+export_cable_install_vessel: example_cable_lay_vessel
+export_cable_bury_vessel: example_cable_lay_vessel
+oss_install_vessel: example_heavy_lift_vessel
+spi_vessel: example_scour_protection_vessel
+wtiv: example_wtiv
+# Module Specific
 OffshoreSubstationInstallation:
   feeder: example_heavy_feeder
   num_feeders: 1
-array_cable_install_vessel: example_cable_lay_vessel
 array_system_design:
   cables:
   - XLPE_630mm_33kV
   - XLPE_400mm_33kV
-commissioning: 0.01
-decommissioning: 0.15
+export_system_design:
+  cables: XLPE_500mm_132kV
+  percent_added_length: 0.0
+scour_protection_design:
+  cost_per_tonne: 40
+  scour_protection_depth: 1
+# Configured Phases
 design_phases:
 - MonopileDesign
 - ScourProtectionDesign
 - ArraySystemDesign
 - ExportSystemDesign
 - OffshoreSubstationDesign
-export_cable_bury_vessel: example_cable_lay_vessel
-export_cable_install_vessel: example_cable_lay_vessel
-export_system_design:
-  cables: XLPE_500mm_132kV
-  percent_added_length: 0.0
 install_phases:
   ArrayCableInstallation: 0
   ExportCableInstallation: 2000
@@ -30,25 +53,8 @@ install_phases:
   TurbineInstallation: !!python/tuple
   - MonopileInstallation
   - 0.1
-landfall:
-  interconnection_distance: 3
-  trench_length: 2
-oss_install_vessel: example_heavy_lift_vessel
-plant:
-  layout: grid
-  num_turbines: 50
-  row_spacing: 7
-  substation_distance: 1
-  turbine_spacing: 7
-scour_protection_design:
-  cost_per_tonne: 40
-  scour_protection_depth: 1
-site:
-  depth: 22.5
-  distance: 124
-  distance_to_landfall: 35
-  mean_windspeed: 9
-spi_vessel: example_scour_protection_vessel
-turbine: SWT_6MW_154m_110m
-turbine_capex: 1200
-wtiv: example_wtiv
+# Project Inputs
+project_parameters:
+  turbine_capex: 1500
+  commissioning: 0.01
+  decommissioning: 0.15
diff --git a/examples/example_floating_project.yaml b/examples/configs/example_floating_project.yaml
similarity index 93%
rename from examples/example_floating_project.yaml
rename to examples/configs/example_floating_project.yaml
index ac6468f0..baad61c0 100644
--- a/examples/example_floating_project.yaml
+++ b/examples/configs/example_floating_project.yaml
@@ -1,21 +1,49 @@
+# Site + Plant Parameters
+site:
+  depth: 900
+  distance: 100
+  distance_to_landfall: 100
+plant:
+  layout: ring
+  num_turbines: 50
+  row_spacing: 7
+  substation_distance: 1
+  turbine_spacing: 7
+port:
+  monthly_rate: 2000000.0
+  sub_assembly_lines: 1
+  turbine_assembly_cranes: 1
+# Vessels
+array_cable_install_vessel: example_cable_lay_vessel
+export_cable_install_vessel: example_cable_lay_vessel
+mooring_install_vessel: example_support_vessel
+oss_install_vessel: floating_heavy_lift_vessel
+support_vessel: example_support_vessel
+towing_vessel: example_towing_vessel
+towing_vessel_groups:
+  station_keeping_vessels: 2
+  towing_vessels: 3
+wtiv: floating_heavy_lift_vessel
+# Module Specific
+substructure:
+  takt_time: 168
 OffshoreSubstationInstallation:
   feeder: floating_barge
-array_cable_install_vessel: example_cable_lay_vessel
 array_system:
   free_cable_length: 0.5
 array_system_design:
   cables:
   - XLPE_630mm_66kV
+export_system_design:
+  cables: XLPE_500mm_132kV
+  percent_added_length: 0.0
+# Configured Phases
 design_phases:
 - ArraySystemDesign
 - ExportSystemDesign
 - MooringSystemDesign
 - OffshoreSubstationDesign
 - SemiSubmersibleDesign
-export_cable_install_vessel: example_cable_lay_vessel
-export_system_design:
-  cables: XLPE_500mm_132kV
-  percent_added_length: 0.0
 install_phases:
   ArrayCableInstallation: 0
   ExportCableInstallation: 0
@@ -23,28 +51,5 @@ install_phases:
   MooringSystemInstallation: 0
   OffshoreSubstationInstallation: 0
   TurbineInstallation: 0
-mooring_install_vessel: example_support_vessel
-oss_install_vessel: floating_heavy_lift_vessel
-plant:
-  layout: ring
-  num_turbines: 50
-  row_spacing: 7
-  substation_distance: 1
-  turbine_spacing: 7
-port:
-  monthly_rate: 2000000.0
-  sub_assembly_lines: 1
-  turbine_assembly_cranes: 1
-site:
-  depth: 900
-  distance: 100
-  distance_to_landfall: 100
-substructure:
-  takt_time: 168
-support_vessel: example_support_vessel
-towing_vessel: example_towing_vessel
-towing_vessel_groups:
-  station_keeping_vessels: 2
-  towing_vessels: 3
+# Project Inputs
 turbine: 12MW_generic
-wtiv: floating_heavy_lift_vessel
diff --git a/examples/custom_array_layout.ipynb b/examples/custom_array_layout.ipynb
deleted file mode 100644
index 7247d376..00000000
--- a/examples/custom_array_layout.ipynb
+++ /dev/null
@@ -1,2168 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "# Custom Array Cabling Layout Example\n",
-    "## Dudgeon Windfarm\n",
-    "\n",
-    "\n",
-    "#### Author: Rob Hammond\n",
-    "#### Date: 4 May 2020\n",
-    "#### Update: 30 March 2021\n",
-    "\n",
-    "\n",
-    "\n",
-    "##### Data source: Dudgeon Wind Farm turbine locations from their publicly available [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf)\n",
-    "\n",
-    "\n",
-    "This notebook will guide you through four of the main use cases on using the custom array cable layout functionality of `ORBIT` for when custom turbine locations, cable lengths or burial speeds are needed.\n",
-    "\n",
-    "**Note:** All array cable layout files are CSVs, which can be edited in Microsoft Excel.\n",
-    "\n",
-    "**Update:** This example was updated to work with ORBIT >= 1.0.0"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "ORBIT library intialized at '../library'\n"
-     ]
-    }
-   ],
-   "source": [
-    "import os\n",
-    "from copy import deepcopy\n",
-    "from pprint import pprint\n",
-    "\n",
-    "import numpy as np\n",
-    "import pandas as pd\n",
-    "\n",
-    "import ORBIT\n",
-    "from ORBIT import ProjectManager\n",
-    "from ORBIT.core import library\n",
-    "from ORBIT.phases.design import CustomArraySystemDesign\n",
-    "from ORBIT.phases.install import ArrayCableInstallation\n",
-    "\n",
-    "# initialize the library location\n",
-    "library.initialize_library(\"../library\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Contents\n",
-    " - [Overview](#overview): How to use the inputs\n",
-    " - [Case 1](#case_1): Needing to know what to collect\n",
-    " - [Case 2](#case_2): Coordinates with a straight-line distance for cable length\n",
-    " - [Case 3](#case_3): Using distance from a reference point\n",
-    " - [Case 4](#case_4): Adjusting for exclusions in the cable paths\n",
-    " - [Case 5](#case_5): Fully customizing the cabling parameters\n",
-    " - [Applying the cases to `ArrayCableInstallation`](#running)\n",
-    " - [Using `ProjectManager` to model the entire process](#project_manager)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"overview\"></a>\n",
-    "## Overview\n",
-    "\n",
-    "#### Before starting it is important to demonstrate how to create a configuration file or how to set up a customized layout file.\n",
-    "\n",
-    "In the highest level of this repository there is a folder called `library` where all of the example data for this notebook is going to be stored. While any folder could be used, the folder structure must be strictly adhered to. More details on this structure can be found [here](https://github.com/WISDEM/ORBIT/blob/master/ORBIT/library.py#L9-L23).\n",
-    "\n",
-    "For this example of how to setup a configuration, I will be using the file `<path>/ORBIT/library/project/config/example_custom_array_simple.yaml`. YAML' files are used for configuration throughout this codebase due their ease of encoding and loading `Python` data types.\n",
-    "\n",
-    "Now, we will load the configuration file and display it below."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-      "                         'location_data': 'dudgeon_array'},\n",
-      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-      " 'site': {'depth': 20},\n",
-      " 'turbine': 'SWT_6MW_154m_110m'}\n"
-     ]
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple\")\n",
-    "pprint(config)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### A couple of things to notice in the configuration file for a custom array layout:\n",
-    "```python\n",
-    "{\n",
-    "    # Array cabling system specific data configuration\n",
-    "    'array_system_design': {\n",
-    "        \n",
-    "        # A list of array cable YAML files that can be found in library/project/cables/ as\n",
-    "        # XLPE_400mm_33kV.yaml and XLPE_630mm_33kV.yaml\n",
-    "        'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-    "        \n",
-    "        # A YAML file named dudgeon_array.csv found in the same location\n",
-    "        'location_data': 'dudgeon_array'},\n",
-    "    \n",
-    "    # We are using a custom layout and the Dudgeon contains 67 turbines\n",
-    "    'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-    "    \n",
-    "    # The average water depth at the site\n",
-    "    'site': {'depth': 20},\n",
-    "    \n",
-    "    # Turbine details (optional for custom)\n",
-    "    'turbine': 'SWT_6MW_154m_110m'\n",
-    "}\n",
-    "```\n",
-    "\n",
-    "#### Now, let's see what is contained within the additional files from the configuration dictionary\n",
-    "\n",
-    "It should be noted that running the design class extracts the data from the files automatically to produce the below output."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'array_system_design': {'cables': {'XLPE_400mm_33kV': {'ac_resistance': 0.06,\n",
-      "                                                        'capacitance': 225,\n",
-      "                                                        'conductor_size': 400,\n",
-      "                                                        'cost_per_km': 300000,\n",
-      "                                                        'current_capacity': 600,\n",
-      "                                                        'inductance': 0.375,\n",
-      "                                                        'linear_density': 35,\n",
-      "                                                        'name': 'XLPE_400mm_33kV',\n",
-      "                                                        'rated_voltage': 33},\n",
-      "                                    'XLPE_630mm_33kV': {'ac_resistance': 0.04,\n",
-      "                                                        'capacitance': 300,\n",
-      "                                                        'conductor_size': 630,\n",
-      "                                                        'cost_per_km': 450000,\n",
-      "                                                        'current_capacity': 700,\n",
-      "                                                        'inductance': 0.35,\n",
-      "                                                        'linear_density': 42.5,\n",
-      "                                                        'name': 'XLPE_630mm_33kV',\n",
-      "                                                        'rated_voltage': 33}},\n",
-      "                         'location_data': 'dudgeon_array'},\n",
-      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-      " 'site': {'depth': 20},\n",
-      " 'turbine': {'blade': {'deck_space': 100, 'length': 75, 'mass': 100},\n",
-      "             'hub_height': 110,\n",
-      "             'nacelle': {'deck_space': 200, 'mass': 360},\n",
-      "             'name': 'SWT-6MW-154',\n",
-      "             'rated_windspeed': 13,\n",
-      "             'rotor_diameter': 154,\n",
-      "             'tower': {'deck_space': 36,\n",
-      "                       'length': 110,\n",
-      "                       'mass': 150,\n",
-      "                       'sections': 2},\n",
-      "             'turbine_rating': 6}}\n"
-     ]
-    },
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "UserWarning: /Users/rhammond/Documents/GitHub/ORBIT/ORBIT/phases/design/array_system_design.py:846\n",
-      "Missing data in columns ['cable_length', 'bury_speed']; all values will be calculated."
-     ]
-    }
-   ],
-   "source": [
-    "array = CustomArraySystemDesign(config)\n",
-    "array.run()\n",
-    "pprint(array.config)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### When the `dudgeon_array.csv` file is loaded, it is not passed back into the configuration dictionary, so let's dissect this file:\n",
-    "\n",
-    "1. The file must have all of the columns shown below (not case-sensitive).\n",
-    " - All columns must be completely filled out for turbines (note on substation(s) following).\n",
-    " - `cable_length` and `bury_speed` are optional and if these are not known, simply fill with a 0.\n",
-    "2. A latitude and longitude must be provided for all turbines and substation(s). This can either be a WGS-84 decimal coordinate or a distance-based \"coordinate\" where latitude and longitude are the distances from some reference point, in kilometers; see [Case 3](#case_3) for more details.\n",
-    "2. Define the offshore substation(s)\n",
-    " - For each substation,  the values in columns `id` and `substation_id` _must_ be the same.\n",
-    " - There is no need to fill in any data for the columns `String`, `Order`, `cable_length` and `bury_speed`.\n",
-    "3. Define the turbines\n",
-    " - Each turbine should have a reference to its substation in the `substation_id` column.\n",
-    "     - In this example, there is one substaion, so all of the values are \"DOW_OSS\".\n",
-    " - `string` and `order` should be 0-indexed for their ordering and not skip any numbers.\n",
-    "     - In this example, the strings are ordered in clock-wise order starting from the string with turbines labeled with an \"A\" in the [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf)\n",
-    " - The ordering on a string should travel from substation to the farthest end of the cable"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>id</th>\n",
-       "      <th>substation_id</th>\n",
-       "      <th>name</th>\n",
-       "      <th>Longitude</th>\n",
-       "      <th>Latitude</th>\n",
-       "      <th>String</th>\n",
-       "      <th>Order</th>\n",
-       "      <th>cable_length</th>\n",
-       "      <th>bury_speed</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>1.358783</td>\n",
-       "      <td>53.243950</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>1.349033</td>\n",
-       "      <td>53.248467</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>1.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>1.339283</td>\n",
-       "      <td>53.252983</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>1.329550</td>\n",
-       "      <td>53.257500</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>5</th>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>1.319800</td>\n",
-       "      <td>53.262017</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>4.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>59</th>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>1.368533</td>\n",
-       "      <td>53.239433</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>1.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>60</th>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>1.378250</td>\n",
-       "      <td>53.234917</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>61</th>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>1.388000</td>\n",
-       "      <td>53.230400</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>62</th>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>1.397750</td>\n",
-       "      <td>53.225883</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>4.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>53.264800</td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>68 rows × 9 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "         id substation_id     name  Longitude   Latitude String Order  \\\n",
-       "1    DAE_A1       DOW_OSS   DAE_A1   1.358783  53.243950    0.0   0.0   \n",
-       "2    DAD_A2       DOW_OSS   DAD_A2   1.349033  53.248467    0.0   1.0   \n",
-       "3    DAC_A3       DOW_OSS   DAC_A3   1.339283  53.252983    0.0   2.0   \n",
-       "4    DAB_A4       DOW_OSS   DAB_A4   1.329550  53.257500    0.0   3.0   \n",
-       "5    DAA_A5       DOW_OSS   DAA_A5   1.319800  53.262017    0.0   4.0   \n",
-       "..      ...           ...      ...        ...        ...    ...   ...   \n",
-       "59   DAF_L2       DOW_OSS   DAF_L2   1.368533  53.239433   11.0   1.0   \n",
-       "60   DAG_L3       DOW_OSS   DAG_L3   1.378250  53.234917   11.0   2.0   \n",
-       "61   DAH_L4       DOW_OSS   DAH_L4   1.388000  53.230400   11.0   3.0   \n",
-       "62   DAJ_L5       DOW_OSS   DAJ_L5   1.397750  53.225883   11.0   4.0   \n",
-       "0   DOW_OSS       DOW_OSS  DOW_OSS   1.378767  53.264800                \n",
-       "\n",
-       "   cable_length bury_speed  \n",
-       "1           0.0        0.0  \n",
-       "2           0.0        0.0  \n",
-       "3           0.0        0.0  \n",
-       "4           0.0        0.0  \n",
-       "5           0.0        0.0  \n",
-       "..          ...        ...  \n",
-       "59          0.0        0.0  \n",
-       "60          0.0        0.0  \n",
-       "61          0.0        0.0  \n",
-       "62          0.0        0.0  \n",
-       "0                           \n",
-       "\n",
-       "[68 rows x 9 columns]"
-      ]
-     },
-     "execution_count": 4,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "df = pd.read_csv(\"../library/cables/dudgeon_array.csv\").fillna(\"\")\n",
-    "df.sort_values(by=[\"String\", \"Order\"])"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"case_1\"></a>\n",
-    "## Case 1: Needing to know what to collect\n",
-    "\n",
-    "Here we know that we need to have a csv created to input all the data but need to see what data is necessary to collect.\n",
-    "\n",
-    "\n",
-    "First, we need to load in the configuration dictionary. Then, we will create a \"starter\" file that can be filled in for a new project, which will be saved in the \"library\"."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-      "                         'location_data': 'dudgeon_array_no_data'},\n",
-      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-      " 'site': {'depth': 20},\n",
-      " 'turbine': 'SWT_6MW_154m_110m'}\n",
-      "\n",
-      "+--------------------------------+\n",
-      "|     PROJECT SPECIFICATIONS     |\n",
-      "+---------------------------+----+\n",
-      "| N turbines full string    |  6 |\n",
-      "| N full strings            | 11 |\n",
-      "| N turbines partial string |  1 |\n",
-      "| N partial strings         |  1 |\n",
-      "+---------------------------+----+\n",
-      "Saving custom array CSV to: <library_path>/cables/dudgeon_array_no_data.csv\n"
-     ]
-    },
-    {
-     "name": "stdin",
-     "output_type": "stream",
-     "text": [
-      "../library/cables/dudgeon_array_no_data.csv already exists, overwrite [y/n]? n\n"
-     ]
-    },
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Cancelling save!\n"
-     ]
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_no_data\")\n",
-    "pprint(config)\n",
-    "print()\n",
-    "\n",
-    "array = CustomArraySystemDesign(config)\n",
-    "save_path = array.config[\"array_system_design\"][\"location_data\"]\n",
-    "array.create_project_csv(save_path)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Let's take a look at the data to see what it output\n",
-    "\n",
-    "**NOTE**:\n",
-    " 1. The offshore substation (row 0) is indicated via the `id` and `substation_id` columns being equal\n",
-    " 2. For substaions only the `id`, `substation_id`, `name`, `latitued`, and `longitude` are required\n",
-    " 3. `cable_length` and `bury_speed` are optional columns for turbines\n",
-    " 4. `string` and `order` are filled out to maximize the length of a string given the cable(s) provided so in this case we can have up to 6 turbines in a string. **These are also, very importantly, starting their numbering with 0.**"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 6,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "dudgeon_array_no_data = pd.read_csv(\"../library/cables/dudgeon_array_no_data.csv\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>id</th>\n",
-       "      <th>substation_id</th>\n",
-       "      <th>name</th>\n",
-       "      <th>latitude</th>\n",
-       "      <th>longitude</th>\n",
-       "      <th>string</th>\n",
-       "      <th>order</th>\n",
-       "      <th>cable_length</th>\n",
-       "      <th>bury_speed</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>oss1</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>offshore_substation</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "      <td>NaN</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>t0</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>t1</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-1</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>1.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>t2</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-2</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>t3</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-3</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>63</th>\n",
-       "      <td>t62</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-62</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>10.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>64</th>\n",
-       "      <td>t63</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-63</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>10.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>65</th>\n",
-       "      <td>t64</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-64</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>10.0</td>\n",
-       "      <td>4.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>66</th>\n",
-       "      <td>t65</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-65</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>10.0</td>\n",
-       "      <td>5.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>67</th>\n",
-       "      <td>t66</td>\n",
-       "      <td>oss1</td>\n",
-       "      <td>turbine-66</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>68 rows × 9 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "      id substation_id                 name  latitude  longitude  string  \\\n",
-       "0   oss1          oss1  offshore_substation       0.0        0.0     NaN   \n",
-       "1     t0          oss1            turbine-0       0.0        0.0     0.0   \n",
-       "2     t1          oss1            turbine-1       0.0        0.0     0.0   \n",
-       "3     t2          oss1            turbine-2       0.0        0.0     0.0   \n",
-       "4     t3          oss1            turbine-3       0.0        0.0     0.0   \n",
-       "..   ...           ...                  ...       ...        ...     ...   \n",
-       "63   t62          oss1           turbine-62       0.0        0.0    10.0   \n",
-       "64   t63          oss1           turbine-63       0.0        0.0    10.0   \n",
-       "65   t64          oss1           turbine-64       0.0        0.0    10.0   \n",
-       "66   t65          oss1           turbine-65       0.0        0.0    10.0   \n",
-       "67   t66          oss1           turbine-66       0.0        0.0    11.0   \n",
-       "\n",
-       "    order  cable_length  bury_speed  \n",
-       "0     NaN           NaN         NaN  \n",
-       "1     0.0           0.0         0.0  \n",
-       "2     1.0           0.0         0.0  \n",
-       "3     2.0           0.0         0.0  \n",
-       "4     3.0           0.0         0.0  \n",
-       "..    ...           ...         ...  \n",
-       "63    2.0           0.0         0.0  \n",
-       "64    3.0           0.0         0.0  \n",
-       "65    4.0           0.0         0.0  \n",
-       "66    5.0           0.0         0.0  \n",
-       "67    0.0           0.0         0.0  \n",
-       "\n",
-       "[68 rows x 9 columns]"
-      ]
-     },
-     "execution_count": 7,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "dudgeon_array_no_data"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"case_2\"></a>\n",
-    "## Case 2: Standard straight-line distance for cable lengths\n",
-    "\n",
-    "Here we have the turbine and offshore substation locations that were extracted from the data source in the header but nothing specific regarding the actual cable lengths or the cable burial speeds for each section."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 8,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-      "                         'location_data': 'dudgeon_array'},\n",
-      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-      " 'site': {'depth': 20},\n",
-      " 'turbine': 'SWT_6MW_154m_110m'}\n"
-     ]
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple\")\n",
-    "pprint(config)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 9,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "UserWarning: /Users/rhammond/Documents/GitHub/ORBIT/ORBIT/phases/design/array_system_design.py:846\n",
-      "Missing data in columns ['cable_length', 'bury_speed']; all values will be calculated."
-     ]
-    }
-   ],
-   "source": [
-    "array = CustomArraySystemDesign(config)\n",
-    "array.run()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Let's take a look at the data to see what it output\n",
-    "\n",
-    "**NOTE**: Here the cable length and bury speed are still set to 0 to indicate that they are unknown"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 10,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "VisibleDeprecationWarning: /opt/miniconda3/envs/orbit-development/lib/python3.8/site-packages/numpy/core/_asarray.py:171\n",
-      "Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray."
-     ]
-    },
-    {
-     "data": {
-      "image/png": "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8Zzsa8KOR6ourUCLiIhIVbG8yFeRCqEEWkRERESkDJRAi4iIiIiUgRJoEREREZEyUAItIiIiIlIGSqBFRERERMogJewARERERMrJeGA1wQAVkQqjPtAiIiIiImWgLRwiIiIiImWgBFpEREREpAyUQIuIiIiIlIESaBERERGRMlACLSIiIiJSBkqgRURERETKQAm0iIiIiEgZKIEWERERESkDJdAiIiIiImWgBFpEREREpAyUQIuIiIiIlIESaBERERGRMlACLSIiIiJSBkqgRURERETKQAm0iIiIiEgZKIEWERERESkDJdAiIiIiImWgBFpEREREpAyUQIuIiIiIlIESaBERERGRMlACLSIiIiJSBkqgRURERETKQAm0iIiIiEgZKIEWERERESkDJdAiIiIiImWgBFpEREREpAyUQIuIiIiIlIESaBERERGRMlACLSIiIiJSBkqgRURERETKQAm0iIiIiEgZKIEWERERESkDJdAiIiIiImWgBFpEREREpAyUQIuIiIiIlEHK/u6cPn1605SUlNFAV5Rsi4iIiEj1kA/Myc3NvSYrK2tt0Tv3m0CnpKSMbt68eecmTZpsSEpK8goLUUREREQkTuTn59u6desyV69ePRroW/T+A60qd23SpMlmJc8iIiIiUl0kJSV5kyZNNhHswviR/a5AB88ve/Kct21Fyrb5Tx6Ru2F2Hd+zOcVq1M9NObzbjnqdblyfXPfI3LK+noiIiIhIZYrlwMUuNh8ogS6TXasn1d0688G03Ws+bAAG+bts730r3snfNufR9JrNf7LpsO53rarV/Cfby/O9RUREREQqQ7kVBm6dPbzx9++d3XH3qvcbkr/bCifPAOTvSiJ/t+1eOaHh9++d3XHr7OGNy+u9RUREREQqS7msQG+dPbzxli/ua0nezlIk5A55O5O2fHFfS4DDug37rjxiEBERERGpDIe8Ar1r9aS6pU+eC4kl0btWf1j3UGOQ6mvphh0puXn5pXpsbl4+SzfsKNdtSyIiIlL9HHICvXXmg2nk7Tq418nblbR11oPNy/KUb775psYZZ5zRNiMjo2vLli27XnXVVS137txpW7ZsSerbt2/rDh06ZLZv375LVlZWx02bNiUBDBs2rHm7du26dOjQIbNTp06ZEydOrHdQ8Upcyc3L59zRk9sfnfNh548Wf7/fE7H/LFpf9+icDzv3GTO5XWkTboDVq1cnd+rUKbNTp06ZjRs37tG0adPuBX/fuXOn7e+58+fPr9m+ffsuxd33y1/+MmP69Om1Sx2IiIiIxI1DSqDztq1ICQoGD7bLnbN79aSGedtXlmpVMD8/n/PPP79d3759N3777bdzFi9ePGfbtm1JQ4YMSf/DH/7QtGnTpnsWLFgw9+uvv/7y2WefXVKzZk2fMGFCvXfeeafh7Nmz5y5YsGDuBx98sKBNmza7DzJgiSMLvttWc9223TW+XLOl7k/+/HHna/4xs8WmHXv2+ZnesGNP0sBXvmj5X0980vnLNVvqrtu6u8aC77bVLO17NG/ePG/evHlz582bN3fAgAHrrr/++jUFf69du3aJP/h79uzZ7+u+8sor32ZlZe0sbRwiZbFw4cIa6enp3dasWZMMsG7duuT09PRuJZ3U9evXr1V6enq3Tp06ZWZmZnaeMGFCvaK3d+rUKfOYY47ptL/3HT9+fGqnTp0y27Vr16VXr14dAbZv327dunXr3LFjx8x27dp1ufXWW48sePy8efNqdu/evdNRRx3V9dxzz21zoJPS8vLBBx/ULfg3dezYMfO5555reKBY09PTu61atWqfz6rjjjuuw2uvvVa/8G33339/00svvfSoyvh3SOIL61gFmDRpUt2UlJSsv/71r4cX3DZq1KgjMjIyumZkZHQdNWrUEQW3/+c//6nboUOHzKOOOqrrlVde2TI/v/QLUYfi73//e8OCxc+uXbt2fueddw4DWLBgQc3MzMzOBb9vHnnkkSYFz6lbt+4xRV+nRYsW3WbOnFmr8G1XX311y7vuuqtMi7iFHVICvW3+k0fAof6+M98278kjDvw4iEajqbVq1cofMmTIeoCUlBSeeuqpZa+88krjJUuW1EpPT9+btfTo0WNXnTp1fMWKFTUaNWqUW6dOHQdIS0vLbdWq1f6zG0kImc1Sd3817LQ5A487ag3AmMlLm3Ua/kGXF6YvbwDw9+nLG3Ye/kHXZ6csawpwzXFHrZk37LQvM5ulHtIJVL9+/VoV/oVTcLCOHz8+NSsrq+Ppp5/ern379l0BcnNz6du3b+s2bdp0Ofvss9ts2bIlCaB3794dP/ww2L5Ut27dY26++eb0jh07Zvbo0aPTsmXLUgBWrlyZctZZZ7Xt2rVr565du3Z+9913deUkAZlZVkX8t7/3bNeu3Z6rrrpq7S233NICYMiQIS0GDBiwbn/PefDBB5fPmzdv7oMPPrjixhtvzCh6+7x58+Z+/vnn80p6/nfffZc8ZMiQo6LR6MKFCxd+OXbs2G8Aateu7R999NH8+fPnz/3yyy/nvv/++/Xff//9egBDhw5tMWjQoDVLly6d06BBg9zHHnusUorLjz322J2zZ8+eO2/evLnvvvvu17fcckvGnj179htrcfr37//9Sy+91Kjwba+99lqjyy677PuK/1dIVRDGsQrBZ9OwYcNanHTSSZsKbluzZk3y8OHDj5wyZcpX06ZN+2r48OFHrlu3LhngxhtvzHjyySe/XbJkyZxFixbVfvXVV+uX/OrlJzs7e3PBv2nMmDFLrr/++gyAo446as/06dPnzZs3b+706dO/euyxx5ovWbKkRkmvc/7553//3HPP7T1W8/LyeOuttw6/4oorDvpYPaQEOnfD7Do/6rZRVvm7knI3zq5TmofOnj27To8ePfZpf9eoUaP8tLS03QMGDFg/atSo5kcffXSnwYMHHzl79uxaAOeff/7mlStX1mzVqlXXyy677Ki33nrrsEOKV+LK4XVq5I++qMfySTed9FWXZqnbV2/ZVfOyFz9vZ5Fo1uUvft52zZZdNbo0T90+6aaTvvrLRT2WN6hTo0JPm+fOnVv3iSeeWLpkyZI5AEuWLKk9aNCgtYsWLfoyNTU1/9FHH21S9Dk7duxIOuGEE7bOnz9/7gknnLB11KhRTQCuu+66lkOHDl0zZ86cr954441vrr/++lYVGbtULffcc8/a6dOn17v//vubTpky5bD77rtvTWmed/bZZ29ZtmxZrQM/cl+jR49udO65525o3779boD09PRcgKSkJBo0aJAPsHv3bsvNzTUzIz8/n08//TT1qquu2gBw9dVXr49Gow0hOEm99NJLj+rRo0enFi1adBs/fnxq//79W7Vp06ZLv379WhW8Z926dY+57rrrWrRr167LiSee2OGDDz6o27t3744tWrTo9sILLzQoKdbU1NT8GjWCz9odO3aYWfAxVlKshW3dutVOPfXU9jk5OY0vv/zyDRMnTmxQsHI+f/78mmvXrq1x1llnbS3r/z+JD5V9sguVf6wC/OEPf2h63nnnbWjcuPHe2Rxjx45tcOqpp25u1qxZXpMmTfJOPfXUza+//nqDb7/9tsbWrVuTzjjjjG1JSUlceuml68eOHXs4BItBAwcObNm1a9fObdq06TJp0qS6P/vZz9pmZGR0HTx48JEQHBetW7fu0q9fv1atWrXq2rdv39Zjx45N7dmzZ6eMjIyuH3zwQYlbMBs0aJCflBSkqlu2bEkqOB5r167tBQujO3bssOJWxFetWpVy9NFHd3r55ZcbDBgw4PuxY8fuTaDffvvt1PT09N0dOnQ46AW1Qyqo8j2by6Ugy3cf+us0atQob/HixbPHjh1b/7333qt/4okndp40adK8nj177pwzZ87cf//736nvv/9+6hVXXNH23nvvXT548OD15RG7xIeTWzfa/kXk1K8enriw6T3/nt+y4PYHz+m4bNhp7damJJdbx8b96t69+7ZOnTrtPSCbN2+++2c/+9k2gMsvv3z9448/3hTY55djjRo1/OKLL94EkJWVtW3ChAn1AT7++OP6X3/99d6Ty61btyZv2rQpqeADXhKDu08P431r1arlDz300PILL7yw/euvv/51rVq1SrXX7uWXX27Yvn37HQV/v/vuu1sMHz48DaBDhw473nzzzcXFPW/BggW19+zZY7179+64bdu2pBtuuGHtoEGD1kOw2tW1a9fMpUuX1rriiivWnn766dtWrVqVkpqamleQyLZq1Wr3mjVr9m6v2rRpU8rnn38+78UXX2x48cUXt5s4ceK8rKysHd27d+/8ySef1DnxxBN37NixI+mMM87Y/PTTTy8/88wz2959993p//nPfxbMmDGj9lVXXdX60ksv3VRcrAATJ06sd+2117ZauXJlzaeeempxQRzFxVrwnM2bNyf169evzSWXXLK+4N/Wo0ePba+++mqDyy67bOPf/va3RtnZ2RsKPvAl8YRxvFb2sbp48eIa0Wj08M8++2z+RRddtPcKy4oVK2q0aNFi7+dXenr67hUrVtT49ttva6Slpe29cp+RkbF71apVe1d7a9asmT9nzpyvHnjggab9+/dvN3Xq1K+aNm2a26pVq26/+c1v1gAsW7as9iuvvLIoKytrSffu3Tu/8MILR0ybNm3eiy++2PD3v/992mmnnfZNSf/O5557ruFvf/vb9O+//77Ga6+99nXB7QsXLqzx85//vP2yZctq3XvvvcsL7y5YtmxZyrnnntvud7/73coLLrhgMwQnyJ9++mmdE044YceLL754+IUXXnhIeeAhHeVWo365TBW0mqV7na5du+6YOXPmPmcq33//fdKqVatqZmZm7mrQoEH+FVdcsfHvf//70gsuuOD7cePGNYBgq0efPn22jBw5cuWjjz66tODMSaqWlOQk7j6zw9qLehz5HcBFPY787q6fdij35DklJcXz8vKA4DLQnj179i5R1a1bd5/ktujqVdG/F7xewQduSkoKubm5BuDuzJgx46uCy1dr166dpeRZyuKtt95q0KRJkz2zZs06YMHq3Xff3aJTp06Zo0ePbjxmzJglBbcXvixc0gcyQG5urs2aNavuhAkTvp4wYcLXjz76aNqsWbNqQfBzPW/evLlLly6dNWPGjHpTp049YDznnnvuxqSkJHr27Ln9iCOO2NO7d+8dycnJdOjQYcc333xTC4KTzwsvvHAzQJcuXXacfPLJW2rVquW9e/fesWLFiv3WOpx++unbFi5c+OVHH3301aOPPpq2fft2O1Csffv2bXf55Zd/V5A8A1x00UXfv/LKK4cDvP76640uv/xybd+QMqvMY/XGG29s+fDDDy9PTk4ul9gvuOCCjQA9evTY0a5dux0ZGRl76tSp4y1btty1aNGimgDp6em7Ch/Dp59++uaC43v58uX7XUUfMGDAxsWLF3/58ssvL7z33nvTC25v167dngULFsz96quv5rz44ouNC7Y/5ubm2umnn97xoYceWl6QPAP84he/WP/3v/+90Z49e3j33XcPv/zyyzccyr/7kDKLlMO77SCpdGdKJUdQKz+lYbcdB34g9O3bd8vOnTuT/vSnPx0BwUrBjTfe2LJ///7fffrpp3UK9urs3LnTFixYULtVq1a7Z86cWatgOwfA559/XqfwGZZUPekNau8p/LW8ZWRk7J4+fXpdgBdffLFhQcJbnFWrVtUsKPJ44YUXGp144omlvrR78sknb37ooYeaFvz9k08+KdVWJxEIfl4+/PDD+h9//PG8p556qtm3335b4v5A+OHD95NPPvm6V69eZS5wbdGixe7TTz99c/369fPT0tJyjzvuuC3Tpk3bZ8GjcePGeaeccsqWaDTaoFmzZrlbtmxJLii4XbJkSc1mzZrt/d1cUKSbnJxMzZo1937OJCUl7T3JLHzymZSURMHKXXJyMnl5eaXaXtizZ8+d9erVy5s2bdo+x1fhWAtu69Wr19Z33nmnQeHLxZdccsnGjz/+uP5HH31Ud+fOnUmnnHKKpuxKmVT2sTpr1qx6AwYMaJOent7t7bffPjwSiRz1/PPPN0xPT9+zfPnyvSeeK1asqJmenr4nIyNjT+EV52+//bZm4RXpgmO18DFY8PeCY7XoMVz4+C7tsXrOOedsXbp0aa2ixbytWrXa06lTpx0TJkxIjb2md+vWbdvbb7+9zzauAQMGbHjzzTcPHzduXP2OHTtub9my5SEtAh9SAl2v4w3rD74DRwG3ep1uKNUyelJSEmPHjl34+uuvH56RkdG1devWXWvVqpX/+OOPr1iwYEHtk046qWOHDh0yu3btmnn00Udvv+KKKzZs3rw5ecCAAa3btm3bpUOHDpnz5s2rM3z48JWHGLRUYzfffPO6Tz75JLVjx46Zn3zySb06deqUuCrcqlWrnaNGjWrapk2bLhs3bky57bbb9lscUtgzzzyzbMaMGfU6dOiQ2bZt2y5/+tOffrR/WqQ4+fn53HjjjRmPPvrosvbt2+8eNGjQmptvvrlFRb7nhRdeuPGzzz47bM+ePWzZsiXp888/P6xbt247Vq5cmfLdd98lQ7B/+IMPPqjfuXPnnUlJSRx//PFbCgpyn3322SP69OmzsSJjLDBv3ryaBYn7ggULai5atKh2+/btd5cUa8HzHn300ZUNGzbMHTBgwN4uGw0aNMg/4YQTtlxzzTWtLrjgAq0+S5mEcayuWLFidsF/55xzzoacnJyll19++cbzzz9/06RJk+qvW7cued26dcmTJk2qf/7552/KyMjYc9hhh+W///779fLz83nhhReOOO+88zZWZIwF5syZU6vghPWjjz6qu3v3bmvWrFnuN998U2Pr1q0GQeeSqVOnHtalS5edEFzp/cc//rFkwYIFtQt32ejSpcuuww8/PPfuu+9ucdFFFx3ysXpIe4+T66Xn1mx26qbdq95veHCJtFGz+U82Jtc9stRnAe3atdszceLEhUVvHzRo0PrCl9UKnHLKKdsPVI0qUhojRozYe+I1c+bMvT9TTz755AqAPn36bOnTp8+Wgts7duy4e/HixV8W91pTpkyZX/Dn7du3f17w56uuumpDQVFVWlpa7ltvvbWofP8VUh2MGDGicXp6+u6Cy5fDhg1b2717984LFy6suXjx4lrNmjXrXvDYhx56aNn+XqvwvkqAL7744qviWjj27Nlz509/+tNNnTp16pKUlMTll1++rlevXjsnT55c58orr2ydl5eHu9t55533/a9+9atNADk5Oct/+ctftn3wwQfTu3Tpsn3IkCGVMpn2/fffP6xPnz5psRVsz8nJWZqWlpa7v1gLPPvss8suuuiiVtdff32Lp556ajnAxRdf/P2AAQPavvTSSzpepUzCOFZL0qxZs7zbb799ZVZWVmeAO+64Y2WzZs3yAP785z9/O3DgwNY7d+600047bXP//v1LrC8oTy+99NLhr7zyyhEpKSleu3bt/Oeff35RUlISs2bNqjNs2LAWZoa7M2jQoNW9e/feu5shJSWFcePGLTrzzDPbPfzww3l33nnnOoALL7zw+9///vctLrvsso2HGpu5l/z/dubMmUt69Oix319ou1ZPqvv9e2d3LPMkQoDk2vmNznxnfq3mp+qSl5SboeO+PHLkh4vSbj21zaoR53XR1QYRERE5KDNnzmzco0ePVkVvP+TqqlrNf7I99ej7lpFcu2zFTcm181OPvm+ZkmcRERERSSTl0obusG7DvgPY8sV9LYOx3vu7YmCQXCs/9ej7lhU8T0REEsNjjz12xJNPPtms8G29evXa+vzzzy8NK6aSvPbaa/XvuuuuffaTtmzZctd7771XYssskaoikY7VRIq1wCFv4Shs1+oP626d9WDz3asnNQRz8nf9sMKdVCsf3Go2/8nGw7rfvVorz1JRPvxmfd3Pvt1Q7/iMw7ed2vYI/ZyJiIjIQSlpC0e5rEAXqNX81O21mr+7KG/7ypRt8548Infj7Dq+e3OK1ayfm9Kw2456nW5YX5aCQZGDcWrbI7YrcRYREZGKUq4JdIHkukfm1u/5QKlGUYqIiIiIJJIDFRHm5+fnl6rBtYiIiIhIVRHLgYttknGgBHrOunXrGiiJFhEREZHqIj8/39atW9cAmFPc/fvdwpGbm3vN6tWrR69evbor5dDyTkREREQkAeQDc3Jzc68p7s79duEQEREREZF9aVVZRERERKQMlECLiIiIiJSBEmgRERERkTJQAi0iIiIiUgZKoEVEREREyuD/AQUzAkae1JCjAAAAAElFTkSuQmCC\n",
-      "text/plain": [
-       "<Figure size 720x720 with 1 Axes>"
-      ]
-     },
-     "metadata": {
-      "needs_background": "light"
-     },
-     "output_type": "display_data"
-    }
-   ],
-   "source": [
-    "array.plot_array_system(show=True)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### It should be noted here that the the latitude and longitude here are WGS-84 decimal coordinates"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 11,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>id</th>\n",
-       "      <th>substation_id</th>\n",
-       "      <th>substation_name</th>\n",
-       "      <th>substation_latitude</th>\n",
-       "      <th>substation_longitude</th>\n",
-       "      <th>turbine_name</th>\n",
-       "      <th>turbine_latitude</th>\n",
-       "      <th>turbine_longitude</th>\n",
-       "      <th>string</th>\n",
-       "      <th>order</th>\n",
-       "      <th>cable_length</th>\n",
-       "      <th>bury_speed</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>53.243950</td>\n",
-       "      <td>1.358783</td>\n",
-       "      <td>0</td>\n",
-       "      <td>0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>53.248467</td>\n",
-       "      <td>1.349033</td>\n",
-       "      <td>0</td>\n",
-       "      <td>1</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>53.252983</td>\n",
-       "      <td>1.339283</td>\n",
-       "      <td>0</td>\n",
-       "      <td>2</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>53.257500</td>\n",
-       "      <td>1.329550</td>\n",
-       "      <td>0</td>\n",
-       "      <td>3</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>53.262017</td>\n",
-       "      <td>1.319800</td>\n",
-       "      <td>0</td>\n",
-       "      <td>4</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>57</th>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>53.251783</td>\n",
-       "      <td>1.368833</td>\n",
-       "      <td>11</td>\n",
-       "      <td>0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>58</th>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>53.239433</td>\n",
-       "      <td>1.368533</td>\n",
-       "      <td>11</td>\n",
-       "      <td>1</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>59</th>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>53.234917</td>\n",
-       "      <td>1.378250</td>\n",
-       "      <td>11</td>\n",
-       "      <td>2</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>60</th>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>53.230400</td>\n",
-       "      <td>1.388000</td>\n",
-       "      <td>11</td>\n",
-       "      <td>3</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>61</th>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>53.225883</td>\n",
-       "      <td>1.397750</td>\n",
-       "      <td>11</td>\n",
-       "      <td>4</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>67 rows × 12 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "        id substation_id substation_name  substation_latitude  \\\n",
-       "0   DAE_A1       DOW_OSS         DOW_OSS              53.2648   \n",
-       "1   DAD_A2       DOW_OSS         DOW_OSS              53.2648   \n",
-       "2   DAC_A3       DOW_OSS         DOW_OSS              53.2648   \n",
-       "3   DAB_A4       DOW_OSS         DOW_OSS              53.2648   \n",
-       "4   DAA_A5       DOW_OSS         DOW_OSS              53.2648   \n",
-       "..     ...           ...             ...                  ...   \n",
-       "57  DCE_L1       DOW_OSS         DOW_OSS              53.2648   \n",
-       "58  DAF_L2       DOW_OSS         DOW_OSS              53.2648   \n",
-       "59  DAG_L3       DOW_OSS         DOW_OSS              53.2648   \n",
-       "60  DAH_L4       DOW_OSS         DOW_OSS              53.2648   \n",
-       "61  DAJ_L5       DOW_OSS         DOW_OSS              53.2648   \n",
-       "\n",
-       "    substation_longitude turbine_name  turbine_latitude  turbine_longitude  \\\n",
-       "0               1.378767       DAE_A1         53.243950           1.358783   \n",
-       "1               1.378767       DAD_A2         53.248467           1.349033   \n",
-       "2               1.378767       DAC_A3         53.252983           1.339283   \n",
-       "3               1.378767       DAB_A4         53.257500           1.329550   \n",
-       "4               1.378767       DAA_A5         53.262017           1.319800   \n",
-       "..                   ...          ...               ...                ...   \n",
-       "57              1.378767       DCE_L1         53.251783           1.368833   \n",
-       "58              1.378767       DAF_L2         53.239433           1.368533   \n",
-       "59              1.378767       DAG_L3         53.234917           1.378250   \n",
-       "60              1.378767       DAH_L4         53.230400           1.388000   \n",
-       "61              1.378767       DAJ_L5         53.225883           1.397750   \n",
-       "\n",
-       "    string  order  cable_length  bury_speed  \n",
-       "0        0      0           0.0         0.0  \n",
-       "1        0      1           0.0         0.0  \n",
-       "2        0      2           0.0         0.0  \n",
-       "3        0      3           0.0         0.0  \n",
-       "4        0      4           0.0         0.0  \n",
-       "..     ...    ...           ...         ...  \n",
-       "57      11      0           0.0         0.0  \n",
-       "58      11      1           0.0         0.0  \n",
-       "59      11      2           0.0         0.0  \n",
-       "60      11      3           0.0         0.0  \n",
-       "61      11      4           0.0         0.0  \n",
-       "\n",
-       "[67 rows x 12 columns]"
-      ]
-     },
-     "execution_count": 11,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "array.location_data"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Now let's look at the cost for this cabling setup by each type of cable as well as the total cost"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 12,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Cable Type      |      Cost in USD\n",
-      "XLPE_400mm_33kV | $  19,868,788.44\n",
-      "XLPE_630mm_33kV | $   5,462,877.30\n",
-      "Total           | $  25,331,665.74\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
-    "for cable, cost in array.cost_by_type.items():\n",
-    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
-    "    \n",
-    "print(f\"{'Total':<16}| ${array.total_cable_cost:>15,.2f}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"case_3\"></a>\n",
-    "## Case 3: Distance-based \"coordinate\" system\n",
-    "\n",
-    "In this case, we will consider each turbine and substation on a distance-based \"coordinate\" system where the longitude and latitude are the longitudinal (x direction) and latitudinal (y direction) **distances**, in kilometers, from a common reference point. We are still using the Dudgeon data, but the distances were computed outside of this example and the details are not be included.\n",
-    "\n",
-    "Below, we can see that the input file is still encoded in the exact same manner as [Case 2](#case_2), but latitude and longitude are relative distances and not proper coordinates."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 13,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>id</th>\n",
-       "      <th>substation_id</th>\n",
-       "      <th>name</th>\n",
-       "      <th>longitude</th>\n",
-       "      <th>latitude</th>\n",
-       "      <th>string</th>\n",
-       "      <th>order</th>\n",
-       "      <th>cable_length</th>\n",
-       "      <th>bury_speed</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>16.229909</td>\n",
-       "      <td>35.769173</td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "      <td></td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>14.890845</td>\n",
-       "      <td>33.450759</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>14.237528</td>\n",
-       "      <td>33.953026</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>1.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>13.584211</td>\n",
-       "      <td>34.455182</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>12.932034</td>\n",
-       "      <td>34.957450</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>63</th>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>15.564263</td>\n",
-       "      <td>34.321749</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>64</th>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>15.544161</td>\n",
-       "      <td>32.948491</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>1.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>65</th>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>16.195266</td>\n",
-       "      <td>32.446335</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>2.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>66</th>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>16.848583</td>\n",
-       "      <td>31.944067</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>3.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>67</th>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>17.501899</td>\n",
-       "      <td>31.441800</td>\n",
-       "      <td>11.0</td>\n",
-       "      <td>4.0</td>\n",
-       "      <td>0.0</td>\n",
-       "      <td>0.0</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>68 rows × 9 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "         id substation_id     name  longitude   latitude string order  \\\n",
-       "0   DOW_OSS       DOW_OSS  DOW_OSS  16.229909  35.769173                \n",
-       "1    DAE_A1       DOW_OSS   DAE_A1  14.890845  33.450759    0.0   0.0   \n",
-       "2    DAD_A2       DOW_OSS   DAD_A2  14.237528  33.953026    0.0   1.0   \n",
-       "3    DAC_A3       DOW_OSS   DAC_A3  13.584211  34.455182    0.0   2.0   \n",
-       "4    DAB_A4       DOW_OSS   DAB_A4  12.932034  34.957450    0.0   3.0   \n",
-       "..      ...           ...      ...        ...        ...    ...   ...   \n",
-       "63   DCE_L1       DOW_OSS   DCE_L1  15.564263  34.321749   11.0   0.0   \n",
-       "64   DAF_L2       DOW_OSS   DAF_L2  15.544161  32.948491   11.0   1.0   \n",
-       "65   DAG_L3       DOW_OSS   DAG_L3  16.195266  32.446335   11.0   2.0   \n",
-       "66   DAH_L4       DOW_OSS   DAH_L4  16.848583  31.944067   11.0   3.0   \n",
-       "67   DAJ_L5       DOW_OSS   DAJ_L5  17.501899  31.441800   11.0   4.0   \n",
-       "\n",
-       "   cable_length bury_speed  \n",
-       "0                           \n",
-       "1           0.0        0.0  \n",
-       "2           0.0        0.0  \n",
-       "3           0.0        0.0  \n",
-       "4           0.0        0.0  \n",
-       "..          ...        ...  \n",
-       "63          0.0        0.0  \n",
-       "64          0.0        0.0  \n",
-       "65          0.0        0.0  \n",
-       "66          0.0        0.0  \n",
-       "67          0.0        0.0  \n",
-       "\n",
-       "[68 rows x 9 columns]"
-      ]
-     },
-     "execution_count": 13,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "df = pd.read_csv(\"../library/cables/dudgeon_distance_based.csv\", index_col=False).fillna(\"\")\n",
-    "df"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### For this case we also add the `distance` argument to the `array_system_design` and set it to `True` to indicate we are dealing with distances."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 14,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-      "                         'distance': True,\n",
-      "                         'location_data': 'dudgeon_distance_based'},\n",
-      " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-      " 'site': {'depth': 20},\n",
-      " 'turbine': 'SWT_6MW_154m_110m'}\n"
-     ]
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_simple_distance_based\")\n",
-    "pprint(config)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### OR we can create the flag in the function call.\n",
-    "\n",
-    "**Note:** the configuration dictionary will always override this setting."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 15,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "UserWarning: /Users/rhammond/Documents/GitHub/ORBIT/ORBIT/phases/design/array_system_design.py:846\n",
-      "Missing data in columns ['cable_length', 'bury_speed']; all values will be calculated."
-     ]
-    }
-   ],
-   "source": [
-    "array_distance = CustomArraySystemDesign(config, distance=True)\n",
-    "array_distance.run()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Let's take a look at the data to see what it output\n",
-    "\n",
-    "While some of the cable lengths may be slightly different, the spacing is still maintained, and we can see that this is the Dudgeon windfarm."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 16,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "VisibleDeprecationWarning: /opt/miniconda3/envs/orbit-development/lib/python3.8/site-packages/numpy/core/_asarray.py:171\n",
-      "Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray."
-     ]
-    },
-    {
-     "data": {
-      "image/png": "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JL1pBVpERERSlg87byp1GrZn2+abd7urP3CskmepClqBFhERkbRgsfgo4BpgtOfnXRt1PJK+tAItIiIi6WLZbl9FqoQSaBERERGRclACLSIiIiJSDkqgRURERETKQQm0iIiIiEg5KIEWERERESmHrKgDEBEREakkLwIrCAaoiFQZ9YEWERERESkHlXCIiIiIiJSDEmgRERERkXJQAi0iIiIiUg5KoEVEREREykEJtIiIiIhIOSiBFhEREREpByXQIiIiIiLloARaRERERKQclECLiIiIiJSDEmgRERERkXJQAi0iIiIiUg5KoEVEREREykEJtIiIiIhIOSiBFhEREREpByXQIiIiIiLloARaRERERKQclECLiIiIiJSDEmgRERERkXJQAi0iIiIiUg5KoEVEREREykEJtIiIiIhIOSiBFhEREREpByXQIiIiIiLlkFXanVOmTGmWlZU1CuiKkm0RERERqR6KgFkFBQXX9uzZ8+vd7yw1gc7KyhrVokWLTk2bNl2TkZHhVRaiiIiIiEiSKCoqslWrVnVesWLFKKD37vfva1W5a9OmTdcreRYRERGR6iIjI8ObNm26jqAK4ztKXYEOHl/+5Llw0/KsTfMeObBgzczavmN9ltVoUJDVuNuWuh37fptZ56CC8j6fiIiIiEgihTnwHheb95VAl8u2FRPrbJx+d8vtK99uCAZF22znfctfKdo06/6cmi1OWVfv8Fu/ym5xyubKfG0RERERkUSotI2BG2cOabL6tTM7bP/qjUYUbbeSyTMARdsyKNpu2798vdHq187ssHHmkCaV9doiIiIiIolSKSvQG2cOabLhkztbU7i1DAm5Q+HWjA2f3NkaoF63W76pjBhERERERBKhwivQ21ZMrFP25LmEMInetuLtOhWNQaqvJWu2ZBUUFpXp2ILCIpas2VKpZUsiIiJS/VQ4gd44/e6WFG7bv+cp3JaxccbdLcrzkM8//7zG6aefflhubm7X1q1bd73qqqtab9261TZs2JDRu3fvQ9q3b9+5Xbt2XXr27Nlh3bp1GQC33HJLi7Zt23Zp3759544dO3Z+88036+5XvJJUCgqLOHvUR+2OyH+707tfrC71ROydhd/WOSL/7U7njP6obVkTboAVK1ZkduzYsXPHjh07N2nSpHuzZs0OL/7z1q1brbTHzps3r2a7du267Om+n/zk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//4HQfC+OOSQQ7pccMEFbdq0adO1d+/eh4wbN65+jx49Oubm5nZ966239lqC2bBhw6KMjCBV3bBhQ0bx+7FWrVpevDC6ZcsW29OK+FdffZV1xBFHdHzmmWca9unTZ/W4ceN2JtAvv/xy/ZycnO3t27ff7wW1Cm2o8h3rK2VDlm+v+PMccMABhV988cXMcePGNXjttdcaHH/88Z0mTpw4t0ePHltnzZo1+z//+U/9N954o/6VV1552O23376sf//+31ZG7JIcTjzkgM2fxE6e84c3FzT77X/mtS6+/e6zOiy95Xttv87KrLSOjaU6/PDDN3Xs2HHnG7JFixbbf/CDH2wCuOKKK7598MEHmwG7/HKsUaOGX3LJJesAevbsuen1119vAPDee+81+Oyzz3aeXG7cuDFz3bp1GcUf8JIa3H1KFK+bnZ3t991337ILL7yw3fPPP/9ZdnZ2mWrtnnnmmUbt2rXbUvzn2267rdWQIUNaArRv337LhAkTvtjT4+bPn19rx44ddvTRR3fYtGlTxg033PB1v379voVgtatr166dlyxZkn3llVd+fdppp2366quvsurXr19YnMi2adNm+8qVK3eWV61bty5r2rRpc8eMGdPokksuafvmm2/O7dmz55bDDz+80/vvv1/7+OOP37Jly5aM008/ff1f/vKXZWecccZht912W84777wzf+rUqbWuuuqqQy677LJ1e4oV4M0336z7i1/8os2XX35Zc+TIkV8Ux7GnWIsfs379+owLLrjg0EsvvfTb4u+te/fum5599tmGl19++dp//OMfB+Tl5a0p/sCX1BPF+zXR79UvvviiRjweb/zhhx/Ou/jii3deYVm+fHmNVq1a7fz8ysnJ2b58+fIaixcvrtGyZcudV+5zc3O3f/XVVztXe2vWrFk0a9asOb///e+bXXTRRW0nTZo0p1mzZgVt2rTp9pvf/GYlwNKlS2uNHTt2Yc+ePRcdfvjhnZ566qkDJ0+ePHfMmDGN7rnnnpbf+973Pt/b9/n44483uuOOO3JWr15d47nnnvus+PYFCxbU+NGPftRu6dKl2bfffvuyktUFS5cuzTr77LPb/u53v/vy/PPPXw/BCfIHH3xQ+7jjjtsyZsyYxhdeeGGF8sAKvcutRoNKmSpoNcv2PF27dt0yffr0Xc5UVq9enfHVV1/V7Ny587aGDRsWXXnllWuffPLJJeeff/7q8ePHN4Sg1OOcc87ZMGzYsC/vv//+JcVnTpJesjIzuO2M9l9f3P2gbwAu7n7QN7d+v32lJ89ZWVleWFgIBJeBduzYsXOJqk6dOrskt7uvXu3+5+LnK/7AzcrKoqCgwADcnalTp84pvnz19ddfz1DyLOXx0ksvNWzatOmOGTNm7HPD6m233daqY8eOnUeNGtVk9OjRi4pvL3lZeG8fyAAFBQU2Y8aMOq+//vpnr7/++mf3339/yxkzZmRD8O967ty5s5csWTJj6tSpdSdNmrTPeM4+++y1GRkZ9OjRY/OBBx644+ijj96SmZlJ+/btt3z++efZEJx8XnjhhesBunTpsuXEE0/ckJ2d7UcfffSW5cuXl7rX4bTTTtu0YMGCT9999905999/f8vNmzfbvmLt3bt32yuuuOKb4uQZ4OKLL149duzYxgDPP//8AVdccYXKN6TcEvle7du3b+s//OEPyzIzMysl9vPPP38tQPfu3be0bdt2S25u7o7atWt769atty1cuLAmQE5OzraS7+HTTjttffH7e9myZaWuovfp02ftF1988ekzzzyz4Pbbb88pvr1t27Y75s+fP3vOnDmzxowZ06S4/LGgoMBOO+20Dvfdd9+y4uQZ4Mc//vG3Tz755AE7duzg1VdfbXzFFVesqcj3XaHMIqtxty1klO1Mae8RZBdlNeq2Zd8HQu/evTds3bo146GHHjoQgpWCvn37tr7ooou++eCDD2oX1+ps3brV5s+fX6tNmzbbp0+fnl1czgEwbdq02iXPsCT95DSstaPk18qWm5u7fcqUKXUAxowZ06g44d2Tr776qmbxJo+nnnrqgOOPP77Ml3ZPPPHE9ffdd1+z4j+///77ZSp1EoHg38vbb7/d4L333ps7cuTI5osXL95rfSD878P3/fff/6xXr17l3uDaqlWr7aeddtr6Bg0aFLVs2bLgmGOO2TB58uRdFjyaNGlSeNJJJ22Ix+MNmzdvXrBhw4bM4g23ixYtqtm8efOdv5uLN+lmZmZSs2bNnZ8zGRkZO08yS558ZmRkULxyl5mZSWFhYZnKC3v06LG1bt26hZMnT97l/VUy1uLbevXqtfGVV15pWPJy8aWXXrr2vffea/Duu+/W2bp1a8ZJJ52kKbtSLol+r86YMaNunz59Ds3Jyen28ssvN47FYgc/8cQTjXJycnYsW7Zs54nn8uXLa+bk5OzIzc3dUXLFefHixTVLrkgXv1dLvgeL/1z8Xt39PVzy/V3W9+pZZ521ccmSJdm7b+Zt06bNjo4dO255/fXX64fP6d26ddv08ssv71LG1adPnzUTJkxoPH78+AYdOnTY3Lp16wotAlcoga7b4YZv978DRzG3uh1vKNMyekZGBuPGjVvw/PPPN87Nze16yCGHdM3Ozi568MEHl8+fP7/WCSec0KF9+/adu3bt2vmII47YfOWVV65Zv359Zp8+fQ457LDDurRv377z3Llzaw8ZMuTLCgYt1dhNN9206v3336/foUOHzu+//37d2rVr73VVuE2bNltHjBjR7NBDD+2ydu3arF/+8pelbg4p6dFHH106derUuu3bt+982GGHdXnooYe+Uz8tsidFRUX07ds39/7771/arl277f369Vt50003tarK17zwwgvXfvjhh/V27NjBhg0bMqZNm1avW7duW7788susb775JhOC+uG33nqrQadOnbZmZGRw7LHHbijekPvYY48deM4556ytyhiLzZ07t2Zx4j5//vyaCxcurNWuXbvte4u1+HH333//l40aNSro06fPzi4bDRs2LDruuOM2XHvttW3OP/98rT5LuUTxXl2+fPnM4v/OOuusNfn5+UuuuOKKteedd966iRMnNli1alXmqlWrMidOnNjgvPPOW5ebm7ujXr16RW+88UbdoqIinnrqqQPPPffctVUZY7FZs2ZlF5+wvvvuu3W2b99uzZs3L/j8889rbNy40SDoXDJp0qR6Xbp02QrBld5//vOfi+bPn1+rZJeNLl26bGvcuHHBbbfd1uriiy+u8Hu1QrXHmXVzCmo2P3nd9q/eaLR/ibRRs8UpazPrHFTms4C2bdvuePPNNxfsfnu/fv2+LXlZrdhJJ520eV+7UUXKYujQoTtPvKZPn77z39QjjzyyHOCcc87ZcM4552wovr1Dhw7bv/jii0/39Fwff/zxvOL/37x587Ti/7/qqqvWFG+qatmyZcFLL720sHK/C6kOhg4d2iQnJ2d78eXLW2655evDDz+804IFC2p+8cUX2c2bNz+8+Nj77rtvaWnPVbKuEuCTTz6Zs6cWjj169Nj6/e9/f13Hjh27ZGRkcMUVV6zq1avX1o8++qj2z372s0MKCwtxdzv33HNX//SnP10HkJ+fv+wnP/nJYXfffXdOly5dNg8YMCAhk2nfeOONeuecc07LcAXb8/Pzl7Rs2bKgtFiLPfbYY0svvvjiNtdff32rkSNHLgO45JJLVvfp0+ewp59+Wu9XKZco3qt707x588Kbb775y549e3YC+NWvfvVl8+bNCwH+/Oc/L77mmmsO2bp1q33ve99bf9FFF+11f0FlevrppxuPHTv2wKysLK9Vq1bRE088sTAjI4MZM2bUvuWWW1qZGe5Ov379Vhx99NE7qxmysrIYP378wjPOOKPtH/7wh8Jf//rXqwAuvPDC1ffcc0+ryy+/fG1FYzP3vf/dTp8+fVH37t1L/YW2bcXEOqtfO7NDuScRAmTWKjrgjFfmZbc4WZe8pNIMHv/pQcPeXthy0MmHfjX03C662iAiIiL7Zfr06U26d+/eZvfbK7y7KrvFKZvrH3HnUjJrlW9zU2atovpH3LlUybOIiIiIpJJKaUNXr9st3wBs+OTO1sFY79KuGBhkZhfVP+LOpcWPExGR1DB8+PADH3nkkeYlb+vVq9fGJ554YklUMe3Nc8891+DWW2/dpZ60devW21577bW9tswSSRep9F5NpViLVbiEo6RtK96us3HG3S22r5jYCMwp2va/Fe6M7CJwq9nilLX1Dr9thVaepaq8/fm3dT5cvKbusbmNN5182IH6dyYiIiL7ZW8lHJWyAl0su8XJm7NbvLqwcPOXWZvmPnJgwdqZtX37+iyr2aAgq1G3LXU73vBteTYMiuyPkw87cLMSZxEREakqlZpAF8usc1BBgx6/L9MoShERERGRVLKvTYRFRUVFZWpwLSIiIiKSLsIceI9NMvaVQM9atWpVQyXRIiIiIlJdFBUV2apVqxoCs/Z0f6klHAUFBdeuWLFi1IoVK7pSCS3vRERERERSQBEwq6Cg4No93VlqFw4REREREdmVVpVFRERERMpBCbSIiIiISDkogRYRERERKQcl0CIiIiIi5aAEWkRERESkHP4f35PfUoby0GUAAAAASUVORK5CYII=\n",
-      "text/plain": [
-       "<Figure size 720x720 with 1 Axes>"
-      ]
-     },
-     "metadata": {
-      "needs_background": "light"
-     },
-     "output_type": "display_data"
-    }
-   ],
-   "source": [
-    "array_distance.plot_array_system(show=True)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Now let's look at the cost for this cabling setup by each type of cable as well as the total cost and compare it to the previous case\n",
-    "\n",
-    "While there is a minor difference, this difference is small in comparison to the total project cost and errs in a more conservative direction."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 17,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Cable Type       | Cost in USD (lat,lon) | Cost in USD (dist_lat,dist_lon)\n",
-      "XLPE_400mm_33kV  | $       19,868,788.44 | $  19,926,147.66\n",
-      "XLPE_630mm_33kV  | $        5,462,877.30 | $   5,479,206.87\n",
-      "Total            | $       25,331,665.74 | $  25,405,354.53\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"{'Cable Type':<16} | {'Cost in USD (lat,lon)':>20} | {'Cost in USD (dist_lat,dist_lon)':>15}\")\n",
-    "for (cable1, cost1), (cable2, cost2) in zip(array.cost_by_type.items(), array_distance.cost_by_type.items()):\n",
-    "    print(f\"{cable1:<16} | ${cost1:>20,.2f} | ${cost2:>15,.2f}\")\n",
-    "    \n",
-    "print(f\"{'Total':<16} | ${array.total_cable_cost:>20,.2f} | ${array_distance.total_cable_cost:>15,.2f}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"case_4\"></a>\n",
-    "## Case 4: We want to account for some additions to the cable lengths due to exclusion zones\n",
-    "\n",
-    "This can be done with the `\"average_exclusion_percent\"` keyword in the configuration that can be seen below.\n",
-    "\n",
-    "**Note:**\n",
-    " 1. There is an average  exclusion and is applied to each of the cable sections\n",
-    " 2. The plot won't change because it will not have details on the new paths so we'll only demonstrate the cost changes (a 4.8% increase, which is in line with the exclusion and the accounting for the site depth."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 18,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-       "  'location_data': 'dudgeon_array',\n",
-       "  'average_exclusion_percent': 0.05},\n",
-       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-       " 'site': {'depth': 20},\n",
-       " 'turbine': 'SWT_6MW_154m_110m'}"
-      ]
-     },
-     "execution_count": 18,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_exclusions\")\n",
-    "config"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 19,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "UserWarning: /Users/rhammond/Documents/GitHub/ORBIT/ORBIT/phases/design/array_system_design.py:846\n",
-      "Missing data in columns ['cable_length', 'bury_speed']; all values will be calculated."
-     ]
-    }
-   ],
-   "source": [
-    "array_exclusion = CustomArraySystemDesign(config)\n",
-    "array_exclusion.run()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 20,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Cable Type      |      Cost in USD\n",
-      "XLPE_400mm_33kV | $  20,826,227.86\n",
-      "XLPE_630mm_33kV | $   5,729,721.17\n",
-      "Total           | $  26,555,949.03\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
-    "for cable, cost in array_exclusion.cost_by_type.items():\n",
-    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
-    "    \n",
-    "print(f\"{'Total':<16}| ${array_exclusion.total_cable_cost:>15,.2f}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"case_5\"></a>\n",
-    "## Case 5: Customize the distances \n",
-    "\n",
-    "If we look at the map in the [Call to Mariners](http://dudgeonoffshorewind.co.uk/news/notices/Dudgeon%20-%20Notice%20to%20Mariners%20wk25.pdf) there are different sized exclusions in the cables, so for this example we'll change the distances from [Case 4](#case_4) where we used an average exclusion to be a bit different in each case by using the `cable_length` column. In addition, we will utilize the `bury_speed` column to demonstrate how these columns will be used.\n",
-    "\n",
-    "**Note:** this work was done outside the notebook, but can be uploaded as show in the example below.\n",
-    "\n",
-    "For this example, half of the windfarm will have different soil condition, so we will use our proxy: `bury_speed` by modifying the burial speed to be fast (0.5 km/h) and slow (0.05 km/hr), respectively, to account for sandy soil and rocky soil. The purpose of this is for passing through customized parameters in the design phase to be utilized in the installation phase as will be seen in the final two examples."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 21,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-       "  'location_data': 'dudgeon_custom'},\n",
-       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-       " 'site': {'depth': 20},\n",
-       " 'turbine': 'SWT_6MW_154m_110m'}"
-      ]
-     },
-     "execution_count": 21,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_custom\")\n",
-    "\n",
-    "# Note location_data the same one that was saved because I updated it!\n",
-    "config"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 22,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "array_custom = CustomArraySystemDesign(config)\n",
-    "array_custom.run()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Note that there are now cable lengths defined as well as burial speeds for installation"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 23,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div>\n",
-       "<style scoped>\n",
-       "    .dataframe tbody tr th:only-of-type {\n",
-       "        vertical-align: middle;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe tbody tr th {\n",
-       "        vertical-align: top;\n",
-       "    }\n",
-       "\n",
-       "    .dataframe thead th {\n",
-       "        text-align: right;\n",
-       "    }\n",
-       "</style>\n",
-       "<table border=\"1\" class=\"dataframe\">\n",
-       "  <thead>\n",
-       "    <tr style=\"text-align: right;\">\n",
-       "      <th></th>\n",
-       "      <th>id</th>\n",
-       "      <th>substation_id</th>\n",
-       "      <th>substation_name</th>\n",
-       "      <th>substation_latitude</th>\n",
-       "      <th>substation_longitude</th>\n",
-       "      <th>turbine_name</th>\n",
-       "      <th>turbine_latitude</th>\n",
-       "      <th>turbine_longitude</th>\n",
-       "      <th>string</th>\n",
-       "      <th>order</th>\n",
-       "      <th>cable_length</th>\n",
-       "      <th>bury_speed</th>\n",
-       "    </tr>\n",
-       "  </thead>\n",
-       "  <tbody>\n",
-       "    <tr>\n",
-       "      <th>0</th>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAE_A1</td>\n",
-       "      <td>53.243950</td>\n",
-       "      <td>1.358783</td>\n",
-       "      <td>0</td>\n",
-       "      <td>0</td>\n",
-       "      <td>3.135279</td>\n",
-       "      <td>0.50</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>1</th>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAD_A2</td>\n",
-       "      <td>53.248467</td>\n",
-       "      <td>1.349033</td>\n",
-       "      <td>0</td>\n",
-       "      <td>1</td>\n",
-       "      <td>0.993860</td>\n",
-       "      <td>0.50</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>2</th>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAC_A3</td>\n",
-       "      <td>53.252983</td>\n",
-       "      <td>1.339283</td>\n",
-       "      <td>0</td>\n",
-       "      <td>2</td>\n",
-       "      <td>0.993719</td>\n",
-       "      <td>0.50</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>3</th>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAB_A4</td>\n",
-       "      <td>53.257500</td>\n",
-       "      <td>1.329550</td>\n",
-       "      <td>0</td>\n",
-       "      <td>3</td>\n",
-       "      <td>0.992699</td>\n",
-       "      <td>0.50</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>4</th>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAA_A5</td>\n",
-       "      <td>53.262017</td>\n",
-       "      <td>1.319800</td>\n",
-       "      <td>0</td>\n",
-       "      <td>4</td>\n",
-       "      <td>0.993673</td>\n",
-       "      <td>0.50</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>...</th>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "      <td>...</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>62</th>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DCE_L1</td>\n",
-       "      <td>53.251783</td>\n",
-       "      <td>1.368833</td>\n",
-       "      <td>11</td>\n",
-       "      <td>0</td>\n",
-       "      <td>1.712822</td>\n",
-       "      <td>0.05</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>63</th>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAF_L2</td>\n",
-       "      <td>53.239433</td>\n",
-       "      <td>1.368533</td>\n",
-       "      <td>11</td>\n",
-       "      <td>1</td>\n",
-       "      <td>1.483318</td>\n",
-       "      <td>0.05</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>64</th>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAG_L3</td>\n",
-       "      <td>53.234917</td>\n",
-       "      <td>1.378250</td>\n",
-       "      <td>11</td>\n",
-       "      <td>2</td>\n",
-       "      <td>0.901721</td>\n",
-       "      <td>0.05</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>65</th>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAH_L4</td>\n",
-       "      <td>53.230400</td>\n",
-       "      <td>1.388000</td>\n",
-       "      <td>11</td>\n",
-       "      <td>3</td>\n",
-       "      <td>0.903679</td>\n",
-       "      <td>0.05</td>\n",
-       "    </tr>\n",
-       "    <tr>\n",
-       "      <th>66</th>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>DOW_OSS</td>\n",
-       "      <td>53.2648</td>\n",
-       "      <td>1.378767</td>\n",
-       "      <td>DAJ_L5</td>\n",
-       "      <td>53.225883</td>\n",
-       "      <td>1.397750</td>\n",
-       "      <td>11</td>\n",
-       "      <td>4</td>\n",
-       "      <td>0.903736</td>\n",
-       "      <td>0.05</td>\n",
-       "    </tr>\n",
-       "  </tbody>\n",
-       "</table>\n",
-       "<p>67 rows × 12 columns</p>\n",
-       "</div>"
-      ],
-      "text/plain": [
-       "        id substation_id substation_name  substation_latitude  \\\n",
-       "0   DAE_A1       DOW_OSS         DOW_OSS              53.2648   \n",
-       "1   DAD_A2       DOW_OSS         DOW_OSS              53.2648   \n",
-       "2   DAC_A3       DOW_OSS         DOW_OSS              53.2648   \n",
-       "3   DAB_A4       DOW_OSS         DOW_OSS              53.2648   \n",
-       "4   DAA_A5       DOW_OSS         DOW_OSS              53.2648   \n",
-       "..     ...           ...             ...                  ...   \n",
-       "62  DCE_L1       DOW_OSS         DOW_OSS              53.2648   \n",
-       "63  DAF_L2       DOW_OSS         DOW_OSS              53.2648   \n",
-       "64  DAG_L3       DOW_OSS         DOW_OSS              53.2648   \n",
-       "65  DAH_L4       DOW_OSS         DOW_OSS              53.2648   \n",
-       "66  DAJ_L5       DOW_OSS         DOW_OSS              53.2648   \n",
-       "\n",
-       "    substation_longitude turbine_name  turbine_latitude  turbine_longitude  \\\n",
-       "0               1.378767       DAE_A1         53.243950           1.358783   \n",
-       "1               1.378767       DAD_A2         53.248467           1.349033   \n",
-       "2               1.378767       DAC_A3         53.252983           1.339283   \n",
-       "3               1.378767       DAB_A4         53.257500           1.329550   \n",
-       "4               1.378767       DAA_A5         53.262017           1.319800   \n",
-       "..                   ...          ...               ...                ...   \n",
-       "62              1.378767       DCE_L1         53.251783           1.368833   \n",
-       "63              1.378767       DAF_L2         53.239433           1.368533   \n",
-       "64              1.378767       DAG_L3         53.234917           1.378250   \n",
-       "65              1.378767       DAH_L4         53.230400           1.388000   \n",
-       "66              1.378767       DAJ_L5         53.225883           1.397750   \n",
-       "\n",
-       "    string  order  cable_length  bury_speed  \n",
-       "0        0      0      3.135279        0.50  \n",
-       "1        0      1      0.993860        0.50  \n",
-       "2        0      2      0.993719        0.50  \n",
-       "3        0      3      0.992699        0.50  \n",
-       "4        0      4      0.993673        0.50  \n",
-       "..     ...    ...           ...         ...  \n",
-       "62      11      0      1.712822        0.05  \n",
-       "63      11      1      1.483318        0.05  \n",
-       "64      11      2      0.901721        0.05  \n",
-       "65      11      3      0.903679        0.05  \n",
-       "66      11      4      0.903736        0.05  \n",
-       "\n",
-       "[67 rows x 12 columns]"
-      ]
-     },
-     "execution_count": 23,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "array_custom.location_data"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### See also that the costs have increased again!"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 24,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Cable Type      |      Cost in USD\n",
-      "XLPE_400mm_33kV | $  22,269,793.09\n",
-      "XLPE_630mm_33kV | $   5,355,606.02\n",
-      "Total           | $  27,625,399.10\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(f\"{'Cable Type':<16}|  {'Cost in USD':>15}\")\n",
-    "for cable, cost in array_custom.cost_by_type.items():\n",
-    "    print(f\"{cable:<16}| ${cost:>15,.2f}\")\n",
-    "    \n",
-    "print(f\"{'Total':<16}| ${array_custom.total_cable_cost:>15,.2f}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"running\"></a>\n",
-    "# Let's run some simulations!\n",
-    "We can now compare cases 2-4 to see how the installation cost will vary."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### First, we have to create a configuration dictionary for each of the 3 main cases we'll be simulating for installations, corresponding to the configuration file from the tests library. Then, we'll update eeach with the `design_result` of each of the 3 cases that we defined above."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 25,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "base_config = library.extract_library_specs(\"config\", \"example_array_cable_install\")\n",
-    "\n",
-    "#Case 2\n",
-    "array_case2 = deepcopy(base_config)\n",
-    "array_case2[\"array_system\"] = array.design_result[\"array_system\"]\n",
-    "\n",
-    "# Case 3\n",
-    "array_case3 = deepcopy(base_config)\n",
-    "array_case3[\"array_system\"] = array_distance.design_result[\"array_system\"]\n",
-    "\n",
-    "# Case 4\n",
-    "array_case4 = deepcopy(base_config)\n",
-    "array_case4[\"array_system\"] = array_exclusion.design_result[\"array_system\"]\n",
-    "\n",
-    "# Case 5\n",
-    "array_case5 = deepcopy(base_config)\n",
-    "array_case5[\"array_system\"] = array_custom.design_result[\"array_system\"]"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Instantiate the simulations"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 26,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "sim2 = ArrayCableInstallation(array_case2)\n",
-    "sim3 = ArrayCableInstallation(array_case3)\n",
-    "sim4 = ArrayCableInstallation(array_case4)\n",
-    "sim5 = ArrayCableInstallation(array_case5)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "#### Run the simulations\n",
-    "\n",
-    "We can see that both the installation cost and the time required to complete the simulation have all increased here, which corresponds to the increased cable lengths and changes to the burial speeds defined above."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 27,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Simulation                 |  Cost (in USD) |  Time (in hours)\n",
-      "straight-line distance     | $11,444,455.51 |            2,211\n",
-      "distance-based coordinates | $11,447,877.14 |            2,212\n",
-      "with exclusions            | $11,501,377.80 |            2,222\n",
-      "custom                     | $15,600,938.01 |            3,040\n"
-     ]
-    }
-   ],
-   "source": [
-    "names = (\"straight-line distance\", \"distance-based coordinates\", \"with exclusions\", \"custom\")\n",
-    "simulations = (sim2, sim3, sim4, sim5)\n",
-    "\n",
-    "print(f\"{'Simulation':<26} | {'Cost (in USD)':>14} | {'Time (in hours)':>16}\")\n",
-    "for name, simulation in zip(names, simulations):\n",
-    "    simulation.run()\n",
-    "    cost = simulation.installation_capex\n",
-    "    time = simulation.total_phase_time\n",
-    "    print(f\"{name:<26} | ${cost:>13,.2f} | {time:>16,.0f}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<a id=\"project_manager\"></a>\n",
-    "## Let's put this all together\n",
-    "\n",
-    "#### Using `ProjectManager` we will run Case 4 from design to installation.\n",
-    "\n",
-    "We'll see here at the end that we end up with the same results running a custom array cabling project piecemeal and as a whole."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 28,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'design_phases': ['CustomArraySystemDesign'],\n",
-       " 'install_phases': ['ArrayCableInstallation'],\n",
-       " 'plant': {'layout': 'custom', 'num_turbines': 67},\n",
-       " 'port': {'monthly_rate': 10000},\n",
-       " 'site': {'depth': 20, 'distance': 50},\n",
-       " 'turbine': 'SWT_6MW_154m_110m',\n",
-       " 'array_system_design': {'cables': ['XLPE_400mm_33kV', 'XLPE_630mm_33kV'],\n",
-       "  'location_data': 'dudgeon_custom',\n",
-       "  'distance': False},\n",
-       " 'array_cable_install_vessel': 'example_cable_lay_vessel',\n",
-       " 'array_cable_bury_vessel': 'example_cable_lay_vessel'}"
-      ]
-     },
-     "execution_count": 28,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "config = library.extract_library_specs(\"config\", \"example_custom_array_project_manager\")\n",
-    "config"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 29,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "project = ProjectManager(config)\n",
-    "project.run()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 30,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Custom Design        | $27,625,399.10\n",
-      "Custom Installation  | $15,600,938.01\n",
-      "Total Cost.          | $43,226,337.11\n",
-      "Project Manager Cost | $43,226,337.11\n"
-     ]
-    }
-   ],
-   "source": [
-    "total = array_custom.total_cable_cost + sim5.installation_capex\n",
-    "\n",
-    "print(f\"Custom Design        | ${array_custom.total_cable_cost:>13,.2f}\")\n",
-    "print(f\"Custom Installation  | ${sim5.installation_capex:>13,.2f}\")\n",
-    "print(f\"Total Cost.          | ${total:>13,.2f}\")\n",
-    "print(f\"Project Manager Cost | ${project.bos_capex:>13,.2f}\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.8.8"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/examples/example_weather.csv b/examples/data/example_weather.csv
similarity index 100%
rename from examples/example_weather.csv
rename to examples/data/example_weather.csv
diff --git a/library/ports/example_port.yaml b/library/ports/example_port.yaml
new file mode 100644
index 00000000..00bb48ca
--- /dev/null
+++ b/library/ports/example_port.yaml
@@ -0,0 +1,1 @@
+num_cranes: 1
diff --git a/library/vessels/example_heavy_feeder.yaml b/library/vessels/example_heavy_feeder.yaml
index fb318b9d..a77d645e 100644
--- a/library/vessels/example_heavy_feeder.yaml
+++ b/library/vessels/example_heavy_feeder.yaml
@@ -9,7 +9,7 @@ jacksys_specs:
 storage_specs:
   max_cargo: 8000           # t
   max_deck_load: 8          # t/m^2
-  max_deck_space: 1000      # m^2
+  max_deck_space: 2000      # m^2
 transport_specs:
   max_waveheight: 2.5       # m
   max_windspeed: 20         # m/s
diff --git a/templates/design_module.py b/templates/design_module.py
new file mode 100644
index 00000000..2b1bdafe
--- /dev/null
+++ b/templates/design_module.py
@@ -0,0 +1,308 @@
+__author__ = ["Jake Nunemaker"]
+__copyright__ = "Copyright 2020, National Renewable Energy Laboratory"
+__maintainer__ = "Jake Nunemaker"
+__email__ = ["jake.nunemaker@nrel.gov"]
+
+
+from ORBIT.phases.design import DesignPhase
+
+
+class TemplateDesign(DesignPhase):
+    """Template Design Phase"""
+
+    expected_config = {
+        "required_input": "unit",
+        "optional_input": "unit, (optional, default: 'default')"
+    }
+
+    output_config = {
+        "example_output": "unit"
+    }
+
+    def __init__(self, config, **kwargs):
+        """Creates an instance of `TemplateDesign`."""
+
+        config = self.initialize_library(config, **kwargs)
+        self.config = self.validate_config(config)
+
+        self._outputs = {}
+
+    def run(self):
+        """Main run function."""
+
+        self.example_computation()
+
+    def example_computation(self):
+        """Example computation method."""
+
+        var1 = self.config["required_input"]
+        var2 = self.config.get("optional_input", "default")
+
+        self.result = var1 + var2
+        self._outputs["example_output"] = self.result
+
+    @property
+    def detailed_output(self):
+        """Returns detailed output dictionary."""
+
+        return {
+            "example_detailed_output": self.result
+        }
+
+    @property
+    def total_cost(self):
+        """Returns total cost of subcomponent(s)."""
+
+        num_turbines = 100  # Where applicable
+        return self.result * num_turbines
+
+    @property
+    def design_result(self):
+        """Must match `self.output_config` structure."""
+
+        return {
+            "example_output": self.result
+        }
+
+
+# === Annotated Example ===
+class SparDesign(DesignPhase):
+    """Spar Design Module"""
+
+    # The expected config tells ProjectManager what inputs are required to run
+    # the module. If a input is optional (and has a default value), then flag
+    # it with the (optional, default: ###) after the unit. This will make it so
+    # that ProjectManager doesn't raise a warning if doesn't find the input in
+    # a project level config.
+    expected_config = {
+        "site": {"depth": "m"},                                        # For common inputs that will be shared across many modules,
+        "plant": {"num_turbines": "int"},                              # it's best to look up how the variable is named in existing modules
+        "turbine": {"turbine_rating": "MW"},                           # so the user doesn't have to input the same thing twice. For example, avoid adding
+                                                                       # 'number_turbines' if 'num_turbines' is already used throughout ORBIT
+
+
+
+        # Inputs can be grouped into dictionaries like the following:
+        "spar_design": {
+            "stiffened_column_CR": "$/t (optional, default: 3120)",    # I tend to group module specific cost rates
+            "tapered_column_CR": "$/t (optional, default: 4220)",      # into dictionaries named after the component being considered
+            "ballast_material_CR": "$/t (optional, default: 100)",     # eg. spar_design, gbf_design, etc.
+            "secondary_steel_CR": "$/t (optional, default: 7250)",
+            "towing_speed": "km/h (optional, default: 6)",
+        },
+    }
+
+    # The output config tells ProjectManager which inputs will be produced by
+    # the design module. Design modules are ran first in a project, and the
+    # results are used as inputs to installation modules. As such, these output
+    # names should match the input names of the respective installation module
+    output_config = {
+        "substructure": {            # Typically a design phase ouptuts a component design
+            "mass": "t",             # grouped into a dictionary, eg. "substructure" dict to the left.
+            "ballasted_mass": "t",
+            "unit_cost": "USD",
+            "towing_speed": "km/h",
+        }
+    }
+
+    def __init__(self, config, **kwargs):
+        """
+        Creates an instance of `SparDesign`.
+
+        Parameters
+        ----------
+        config : dict
+        """
+
+        config = self.initialize_library(config, **kwargs)    # These first two lines are required in all modules. They initialize the library 
+        self.config = self.validate_config(config)            # if it hasn't already been and validate the config against '.expected_config' from above
+    
+
+        self._design = self.config.get("spar_design", {})     # Not required, but I often save module specific outputs to "_design" for later use
+                                                              # If the "spar_design" sub dictionary isn't found, an empty one is returned to
+                                                              # work with later methods.    
+        self._outputs = {}
+
+    def run(self):
+        """
+        This method is required. It is the method that ProjectManager will call
+        after initialization. Any calculations should be called from here and
+        the outputs should be stored.
+        """
+
+        substructure = {
+            "mass": self.unballasted_mass,
+            "ballasted_mass": self.ballasted_mass,
+            "unit_cost": self.substructure_cost,
+            "towing_speed": self._design.get("towing_speed", 6),
+        }
+
+        self._outputs["substructure"] = substructure
+
+    @property
+    def stiffened_column_mass(self):
+        """
+        Calculates the mass of the stiffened column for a single spar in tonnes.
+        From original OffshoreBOS model.
+        """
+
+        # The following methods are examples of module specific calculations.
+        # Note that they can access the input dictionary at `self.config`
+
+        rating = self.config["turbine"]["turbine_rating"]
+        depth = self.config["site"]["depth"]
+
+        mass = 535.93 + 17.664 * rating ** 2 + 0.02328 * depth * log(depth)
+
+        return mass
+
+    @property
+    def tapered_column_mass(self):
+        """
+        Calculates the mass of the atpered column for a single spar in tonnes. From original OffshoreBOS model.
+        """
+
+        rating = self.config["turbine"]["turbine_rating"]
+
+        mass = 125.81 * log(rating) + 58.712
+
+        return mass
+
+    @property
+    def stiffened_column_cost(self):
+        """
+        Calculates the cost of the stiffened column for a single spar. From original OffshoreBOS model.
+        """
+
+        cr = self._design.get("stiffened_column_CR", 3120)     # This is how I typically handle outputs. This will look for the key in 
+                                                               # self._design, and return default value if it isn't found.
+        return self.stiffened_column_mass * cr
+
+    @property
+    def tapered_column_cost(self):
+        """
+        Calculates the cost of the tapered column for a single spar. From original OffshoreBOS model.
+        """
+
+        cr = self._design.get("tapered_column_CR", 4220)
+        return self.tapered_column_mass * cr
+
+    @property
+    def ballast_mass(self):
+        """
+        Calculates the ballast mass of a single spar. From original OffshoreBOS model.
+        """
+
+        rating = self.config["turbine"]["turbine_rating"]
+        mass = -16.536 * rating ** 2 + 1261.8 * rating - 1554.6
+
+        return mass
+
+    @property
+    def ballast_cost(self):
+        """
+        Calculates the cost of ballast material for a single spar. From original OffshoreBOS model.
+        """
+
+        cr = self._design.get("ballast_material_CR", 100)
+        return self.ballast_mass * cr
+
+    @property
+    def secondary_steel_mass(self):
+        """
+        Calculates the mass of the required secondary steel for a single
+        spar. From original OffshoreBOS model.
+        """
+
+        rating = self.config["turbine"]["turbine_rating"]
+        depth = self.config["site"]["depth"]
+
+        mass = exp(
+            3.58
+            + 0.196 * (rating ** 0.5) * log(rating)
+            + 0.00001 * depth * log(depth)
+        )
+
+        return mass
+
+    @property
+    def secondary_steel_cost(self):
+        """
+        Calculates the cost of the required secondary steel for a single
+        spar. For original OffshoreBOS model.
+        """
+
+        cr = self._design.get("secondary_steel_CR", 7250)
+        return self.secondary_steel_mass * cr
+
+    @property
+    def unballasted_mass(self):
+        """Returns the unballasted mass of the spar substructure."""
+
+        return (
+            self.stiffened_column_mass
+            + self.tapered_column_mass
+            + self.secondary_steel_mass
+        )
+
+    @property
+    def ballasted_mass(self):
+        """Returns the ballasted mass of the spar substructure."""
+
+        return self.unballasted_mass + self.ballast_mass
+
+    @property
+    def substructure_cost(self):
+        """Returns the total cost (including ballast) of the spar substructure."""
+
+        return (
+            self.stiffened_column_cost
+            + self.tapered_column_cost
+            + self.secondary_steel_cost
+            + self.ballast_cost
+        )
+
+    # === End of module specific calculations ===
+
+    # The following properties are required methods for a DesignPhase
+
+    # .detailed_output returns any relevant detailed outputs from the module
+    # in a dictionary. 
+    @property
+    def detailed_output(self):
+        """Returns detailed phase information."""
+
+        _outputs = {
+            "stiffened_column_mass": self.stiffened_column_mass,
+            "stiffened_column_cost": self.stiffened_column_cost,
+            "tapered_column_mass": self.tapered_column_mass,
+            "tapered_column_cost": self.tapered_column_cost,
+            "ballast_mass": self.ballast_mass,
+            "ballast_cost": self.ballast_cost,
+            "secondary_steel_mass": self.secondary_steel_mass,
+            "secondary_steel_cost": self.secondary_steel_cost,
+        }
+
+        return _outputs
+
+    # .total_cost returns the total procurement cost for the subsystem for the
+    # entire project.
+    @property
+    def total_cost(self):
+        """Returns total phase cost in $USD."""
+
+        num = self.config["plant"]["num_turbines"]
+        return num * self.substructure_cost
+
+    # .design_result returns an output dictionary that includes all of the
+    # outputs included in `self.output_config`. This property is called by
+    # ProjectManager and used to add the results of design phases to the
+    # total project configuration.
+    @property
+    def design_result(self):
+        """Returns the result of `self.run()`"""
+
+        if not self._outputs:
+            raise Exception("Has `SparDesign` been ran yet?")
+
+        return self._outputs


Test patch:
diff --git a/tests/data/library/project/config/export_cable_install.yaml b/tests/data/library/project/config/export_cable_install.yaml
index beccf930..18e75aef 100644
--- a/tests/data/library/project/config/export_cable_install.yaml
+++ b/tests/data/library/project/config/export_cable_install.yaml
@@ -10,7 +10,7 @@ export_system:
   system_cost: 200e6
 plant:
   layout: grid
-  num_turbines: 40
+  capacity: 360
   turbine_spacing: 5
 site:
   depth: 20
@@ -20,4 +20,3 @@ site:
   distance_to_landfall: 30
 turbine:
   rotor_diameter: 154
-  turbine_rating: 9
diff --git a/tests/phases/design/test_mooring_system_design.py b/tests/phases/design/test_mooring_system_design.py
index d6007018..88a7a747 100644
--- a/tests/phases/design/test_mooring_system_design.py
+++ b/tests/phases/design/test_mooring_system_design.py
@@ -64,7 +64,7 @@ def test_drag_embedment_fixed_length():
     custom = deepcopy(base)
     custom["mooring_system_design"] = {
         "anchor_type": "Drag Embedment",
-        "drag_embedment_fixed_length": 10,
+        "drag_embedment_fixed_length": 1000,
     }
 
     m = MooringSystemDesign(custom)