From ae068b2ffb363b360f4121d6f2dbf444a5a0d183 Mon Sep 17 00:00:00 2001
From: Matthew Dailis <matthew.l.dailis@jpl.nasa.gov>
Date: Fri, 5 Jul 2024 13:06:13 -0700
Subject: [PATCH] Add checkout and update docs

---
 docs-src/1_tutorials/1_gettingstarted.md      | 138 +++++++++++
 docs-src/1_tutorials/index.md                 |   6 +
 docs-src/1_tutorials/tutorial.py              |  22 ++
 docs-src/1_tutorials/tutorial2.md             |   3 +
 docs-src/2_guides/datamodel.md                |   3 +
 docs-src/2_guides/index.md                    |  12 +
 docs-src/2_guides/jupyter.md                  |   3 +
 docs-src/2_guides/powermodel.md               |   3 +
 docs-src/2_guides/scheduling.md               |   6 +
 docs-src/2_guides/spice.md                    |   5 +
 docs-src/2_guides/telecom.md                  |  11 +
 docs-src/3_explanation/co-simulation.md       |   9 +
 docs-src/3_explanation/command-errors.md      | 102 +++++++++
 docs-src/3_explanation/fidelity.md            |  16 ++
 docs-src/3_explanation/index.md               |  10 +
 docs-src/3_explanation/planning.md            |   3 +
 docs-src/3_explanation/simulation.md          |  35 +++
 docs-src/Makefile                             |  20 ++
 {docs => docs-src/_build}/.nojekyll           |   0
 .../1_tutorials/1_gettingstarted.doctree      | Bin 0 -> 35412 bytes
 .../_build/doctrees/1_tutorials/index.doctree | Bin 0 -> 3158 bytes
 .../doctrees/1_tutorials/tutorial2.doctree    | Bin 0 -> 2929 bytes
 .../doctrees/2_guides/datamodel.doctree       | Bin 0 -> 2954 bytes
 .../_build/doctrees/2_guides/index.doctree    | Bin 0 -> 3225 bytes
 .../_build/doctrees/2_guides/jupyter.doctree  | Bin 0 -> 2994 bytes
 .../doctrees/2_guides/powermodel.doctree      | Bin 0 -> 2931 bytes
 .../doctrees/2_guides/scheduling.doctree      | Bin 0 -> 2930 bytes
 .../_build/doctrees/2_guides/spice.doctree    | Bin 0 -> 3471 bytes
 .../_build/doctrees/2_guides/telecom.doctree  | Bin 0 -> 4654 bytes
 .../3_explanation/co-simulation.doctree       | Bin 0 -> 4761 bytes
 .../3_explanation/command-errors.doctree      | Bin 0 -> 42958 bytes
 .../doctrees/3_explanation/fidelity.doctree   | Bin 0 -> 6383 bytes
 .../doctrees/3_explanation/index.doctree      | Bin 0 -> 3554 bytes
 .../doctrees/3_explanation/planning.doctree   | Bin 0 -> 2970 bytes
 .../doctrees/3_explanation/simulation.doctree | Bin 0 -> 14920 bytes
 .../_build/doctrees/apidocs/index.doctree     | Bin 0 -> 3284 bytes
 .../apidocs/pymerlin/pymerlin.doctree         | Bin 0 -> 200375 bytes
 .../pymerlin/pymerlin.duration.doctree        | Bin 0 -> 277563 bytes
 .../pymerlin/pymerlin.model_actions.doctree   | Bin 0 -> 295484 bytes
 docs-src/_build/doctrees/architecture.doctree | Bin 0 -> 6500 bytes
 docs-src/_build/doctrees/contribute.doctree   | Bin 0 -> 27638 bytes
 docs-src/_build/doctrees/developer.doctree    | Bin 0 -> 4319 bytes
 .../_build/doctrees/documentation.doctree     | Bin 0 -> 5057 bytes
 docs-src/_build/doctrees/environment.pickle   | Bin 0 -> 444666 bytes
 docs-src/_build/doctrees/index.doctree        | Bin 0 -> 7411 bytes
 docs-src/_build/doctrees/install.doctree      | Bin 0 -> 2889 bytes
 docs-src/_build/doctrees/license.doctree      | Bin 0 -> 6176 bytes
 docs-src/_build/doctrees/publishing.doctree   | Bin 0 -> 3647 bytes
 docs-src/_build/doctrees/quickstart.doctree   | Bin 0 -> 6410 bytes
 docs-src/_templates/custom-class-template.rst |  32 +++
 .../_templates/custom-module-template.rst     |  66 ++++++
 docs-src/apidocs/index.rst                    |  10 +
 .../apidocs/pymerlin/pymerlin.duration.rst    | 216 ++++++++++++++++++
 .../pymerlin/pymerlin.model_actions.rst       |  76 ++++++
 docs-src/apidocs/pymerlin/pymerlin.rst        |  42 ++++
 docs-src/architecture.md                      |  16 ++
 docs-src/conf.py                              |  64 ++++++
 docs-src/contribute.md                        | 114 +++++++++
 docs-src/developer.md                         |  10 +
 docs-src/documentation.md                     |  15 ++
 docs-src/index.md                             |  56 +++++
 docs-src/install.md                           |   3 +
 docs-src/license.md                           |   4 +
 docs-src/make.bat                             |  35 +++
 docs-src/publishing.md                        |  11 +
 docs-src/quickstart.md                        |  26 +++
 docs/.buildinfo                               |   2 +-
 docs/1_tutorials/1_gettingstarted.html        |  28 ++-
 docs/1_tutorials/index.html                   |   9 +-
 docs/1_tutorials/tutorial2.html               |   8 +-
 docs/2_guides/datamodel.html                  |   8 +-
 docs/2_guides/index.html                      |   8 +-
 docs/2_guides/jupyter.html                    |   8 +-
 docs/2_guides/powermodel.html                 |   8 +-
 docs/2_guides/scheduling.html                 |   8 +-
 docs/2_guides/spice.html                      |   8 +-
 docs/2_guides/telecom.html                    |   8 +-
 docs/3_explanation/co-simulation.html         |   8 +-
 docs/3_explanation/command-errors.html        |   8 +-
 docs/3_explanation/fidelity.html              |   8 +-
 docs/3_explanation/index.html                 |   8 +-
 docs/3_explanation/planning.html              |   8 +-
 docs/3_explanation/simulation.html            |   8 +-
 .../1_tutorials/1_gettingstarted.md.txt       |  11 +-
 .../apidocs/pymerlin/pymerlin.rst.txt         |  24 ++
 docs/_sources/publishing.md.txt               |   3 +-
 docs/_sources/quickstart.md.txt               |   6 +
 docs/_static/documentation_options.js         |   2 +-
 docs/apidocs/index.html                       |   8 +-
 docs/apidocs/pymerlin/pymerlin.duration.html  |   8 +-
 docs/apidocs/pymerlin/pymerlin.html           |  40 +++-
 .../pymerlin/pymerlin.model_actions.html      |   8 +-
 docs/architecture.html                        |   8 +-
 docs/contribute.html                          |   8 +-
 docs/developer.html                           |   8 +-
 docs/documentation.html                       |   8 +-
 docs/genindex.html                            |  12 +-
 docs/index.html                               |   8 +-
 docs/install.html                             |   8 +-
 docs/license.html                             |   8 +-
 docs/objects.inv                              | Bin 1096 -> 1112 bytes
 docs/publishing.html                          |  12 +-
 docs/py-modindex.html                         |   8 +-
 docs/quickstart.html                          |  13 +-
 docs/search.html                              |   8 +-
 docs/searchindex.js                           |   2 +-
 .../aerie/merlin/python/MerlinEntryPoint.java |   1 -
 pymerlin/__init__.py                          |  40 +++-
 pymerlin/_internal/_gateway.py                |   3 +-
 pyproject.toml                                |   2 +-
 requirements.txt                              |   9 +
 111 files changed, 1484 insertions(+), 146 deletions(-)
 create mode 100644 docs-src/1_tutorials/1_gettingstarted.md
 create mode 100644 docs-src/1_tutorials/index.md
 create mode 100644 docs-src/1_tutorials/tutorial.py
 create mode 100644 docs-src/1_tutorials/tutorial2.md
 create mode 100644 docs-src/2_guides/datamodel.md
 create mode 100644 docs-src/2_guides/index.md
 create mode 100644 docs-src/2_guides/jupyter.md
 create mode 100644 docs-src/2_guides/powermodel.md
 create mode 100644 docs-src/2_guides/scheduling.md
 create mode 100644 docs-src/2_guides/spice.md
 create mode 100644 docs-src/2_guides/telecom.md
 create mode 100644 docs-src/3_explanation/co-simulation.md
 create mode 100644 docs-src/3_explanation/command-errors.md
 create mode 100644 docs-src/3_explanation/fidelity.md
 create mode 100644 docs-src/3_explanation/index.md
 create mode 100644 docs-src/3_explanation/planning.md
 create mode 100644 docs-src/3_explanation/simulation.md
 create mode 100644 docs-src/Makefile
 rename {docs => docs-src/_build}/.nojekyll (100%)
 create mode 100644 docs-src/_build/doctrees/1_tutorials/1_gettingstarted.doctree
 create mode 100644 docs-src/_build/doctrees/1_tutorials/index.doctree
 create mode 100644 docs-src/_build/doctrees/1_tutorials/tutorial2.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/datamodel.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/index.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/jupyter.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/powermodel.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/scheduling.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/spice.doctree
 create mode 100644 docs-src/_build/doctrees/2_guides/telecom.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/co-simulation.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/command-errors.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/fidelity.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/index.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/planning.doctree
 create mode 100644 docs-src/_build/doctrees/3_explanation/simulation.doctree
 create mode 100644 docs-src/_build/doctrees/apidocs/index.doctree
 create mode 100644 docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.doctree
 create mode 100644 docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.duration.doctree
 create mode 100644 docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.model_actions.doctree
 create mode 100644 docs-src/_build/doctrees/architecture.doctree
 create mode 100644 docs-src/_build/doctrees/contribute.doctree
 create mode 100644 docs-src/_build/doctrees/developer.doctree
 create mode 100644 docs-src/_build/doctrees/documentation.doctree
 create mode 100644 docs-src/_build/doctrees/environment.pickle
 create mode 100644 docs-src/_build/doctrees/index.doctree
 create mode 100644 docs-src/_build/doctrees/install.doctree
 create mode 100644 docs-src/_build/doctrees/license.doctree
 create mode 100644 docs-src/_build/doctrees/publishing.doctree
 create mode 100644 docs-src/_build/doctrees/quickstart.doctree
 create mode 100644 docs-src/_templates/custom-class-template.rst
 create mode 100644 docs-src/_templates/custom-module-template.rst
 create mode 100644 docs-src/apidocs/index.rst
 create mode 100644 docs-src/apidocs/pymerlin/pymerlin.duration.rst
 create mode 100644 docs-src/apidocs/pymerlin/pymerlin.model_actions.rst
 create mode 100644 docs-src/apidocs/pymerlin/pymerlin.rst
 create mode 100644 docs-src/architecture.md
 create mode 100644 docs-src/conf.py
 create mode 100644 docs-src/contribute.md
 create mode 100644 docs-src/developer.md
 create mode 100644 docs-src/documentation.md
 create mode 100644 docs-src/index.md
 create mode 100644 docs-src/install.md
 create mode 100644 docs-src/license.md
 create mode 100644 docs-src/make.bat
 create mode 100644 docs-src/publishing.md
 create mode 100644 docs-src/quickstart.md

diff --git a/docs-src/1_tutorials/1_gettingstarted.md b/docs-src/1_tutorials/1_gettingstarted.md
new file mode 100644
index 0000000..49701d8
--- /dev/null
+++ b/docs-src/1_tutorials/1_gettingstarted.md
@@ -0,0 +1,138 @@
+# Getting Started
+
+:::{warning}
+This page is under construction. Please bear with us as we port our [Java tutorial](https://nasa-ammos.github.io/aerie-docs/tutorials/mission-modeling/introduction/) to python.
+:::
+
+Welcome Aerie modeling padawans! For your training today, you will be learning the basics of mission modeling in Aerie by building your own simple model of an on-board spacecraft solid state recorder (SSR). This model will track the recording rate into the recorder from a couple instruments along with the integrated data volume over time. Through the process of building this model, you'll learn about the fundamental objects of a model, activities and resources, and their structure. You'll be introduced to the different categories of resources and learn how you define and implement each along with restrictions on when you can/can't modify them. As a bonus, we will also cover how you can make your resources "unit aware" to prevent those pesky issues that come along with performing unit conversions and how you can test your model without having to pull your model into an Aerie deployment.
+
+Let the training begin!
+
+## Installing pymerlin
+If you haven't already, go to the [quickstart](../quickstart.md) guide to get set up with pymerlin.
+
+## Creating a Mission Model
+
+Start by creating a `mission.py` file with the following contents:
+
+```python
+from pymerlin import MissionModel, simulate, Schedule, Directive
+
+@MissionModel
+class FireSat:
+    def __init__(self, registrar):
+        self.counter = registrar.cell(0)
+        registrar.resource("counter", self.counter.get)
+
+@FireSat.ActivityType
+async def increment_counter(mission: FireSat):
+    counter = mission.counter
+    counter.set_value(counter.get() + 1)
+
+def main():
+    print(simulate(
+        FireSat,
+        Schedule.build(("00:00:01", Directive("increment_counter"))),
+        "01:00:00"
+    ))
+
+if __name__ == '__main__':
+    main()
+
+```
+
+## Your First Resource
+
+We will begin building our SSR model by creating a single resource, `RecordingRate`, to track the rate at which data is being written to the SSR over time. As a reminder, a **Resource** is any measurable quantity whose behavior we want to track over the course of a plan. Then, we will create a simple activity, `CollectData`, that updates the `RecordingRate` by a user-specified rate for a user-specified duration. This activity is intended to represent an on-board camera taking images and writing data to the spacecraft SSR.
+
+Although we could define the `RecordingRate` resource directly in the pre-provided top-level `Mission` class, we'd like to keep that class as simple as possible and delegate most of model's behavior definition to other, more focused classes. With this in mind, let's create a new class within the `missionmodel` package called `DataModel`, which we will eventually instantiate within the `Mission` class.
+
+In the `DataModel` class, declare the `RecordingRate` resource with the following line of code:
+
+```python
+self.recording_rate = registrar.cell(0); // Megabits/s
+```
+
+:::{tip}
+As you are coding, take advantage of your IDE to auto import the modeling framework classes you need like `MutableResource`.
+:::
+
+Let's tease apart this line of code and use it as an opportunity to provide a brief overview of the various types of resources available to you as a modeler. The mission modeling framework provides two primary classes from which to define resources:
+
+1. `MutableResource` - resource whose value can be explicitly updated by activities or other modeling code after it has been defined. Updates to the resource take the form of "Effects" such as `increase`, `decrease`, or `set`. The values of this category of resource are explicitly tracked in objects called "Cells" within Aerie, which you can read about in detail in the [Aerie Software Design Document](https://ammos.nasa.gov/aerie-docs/overview/software-design-document/#cells) if you are interested.
+2. `Resource` - resource whose value cannot be explicitly updated after it has been defined. In other words, these resources cannot be updated via "Effects". The most common use of these resources are to create "derived" resources that are fully defined by the values of other resources (we will have some examples of these later). Since these resources get their value from other resources, they actually don't need to store their own value within a "Cell". Interestingly, the `MutableResource` class extends the `Resource` class and includes additional logic to ensure values are correctly stored in these "Cells".
+
+From these classes, there are a few different types of resources provided, which are primarily distinguished by how the value of the resource progresses between computed points:
+
+- `Discrete` - resource that maintains a constant value between computed points (i.e. a step function or piecewise constant function). Discrete resources can be defined as many different types such as `Boolean`, `Integer`, `Double`, or an enumeration. These types of resources are what you traditionally find in discrete event simulators and are the easiest to define and "effect".
+- `Linear` - resource that has a linear profile between computed points. When computing the value of such resources you have to specify both the value of the resource at a given time along with a rate so that the resource knows how it should change until the next point is computed. The resource does not have to be strictly continuous. In other words, the linear segments that are computed for the resource do not have to match up. Unlike discrete resources, a linear resource is implicitly defined as a `Double`.
+- `Polynomial` - generalized version of the linear resource that allows you to define resources that evolve over time based on polynomial functions.
+- `Clock` - special resource type to provide "stopwatch" like functionality that allows you to track the time since an event occurred.
+
+TODO: Add more content on `Clock`
+
+:::info
+
+Polynomial resources currently cannot be rendered in the Aerie UI and must be transformed to a linear resource (an example of this is shown later in the tutorial)
+
+:::
+
+Looking back at our resource declaration, you can see that `RecordingRate` is a `MutableResource` (we will emit effects on this resource in our first activity) of the type `Discrete<Double>`, so the value of the resource will stay constant until the next time we compute effects on it.
+
+Next, we must define and initialize our `RecordingRate` resource, which we can do in a class constructor that takes one parameter we'll called `registrar` of type `Registrar`. You can think of the `Registrar` class as your link to what will ultimately get exposed in the UI and in a second we will use this class to register `RecordingRate`. But first, let's add the following line to the constructor we just made to fully define our resource.
+
+Both the `MutableResource` and `Discrete` classes have static helper functions for initializing resources of their type. If you included those functions via `import static` statements, you get the simple line above. The `discrete()` function expects an initial value for the resource, which we have specified as `0.0`.
+
+The last thing to do is to register `RecordingRate` to the UI so we can view the resource as a timeline along with our activity plan. This is accomplished with the following line of code:
+
+```java
+registrar.discrete("RecordingRate", RecordingRate, new DoubleValueMapper());
+```
+
+The first argument to this `discrete` function is the string name of the resource you want to appear in the UI, the second argument is the resource itself, and then the third argument is a [Value Mapper](https://nasa-ammos.github.io/aerie-docs/mission-modeling/activity-mappers/#value-mappers) object that matches the resource primitive type, which in this case is a `Double`. For now, you don't need to know much about Value Mappers other than they are needed for performing data serialization to the UI and there are mappers already currently available as part of the framework for all basic types. You can create custom ones if you have complex resource types, but for almost all cases, you should be able to get away with one of the pre-built mappers.
+
+You have now declared, defined, and registered your first resource and your `DataModel` class should look something like this:
+
+```java
+package missionmodel;
+
+import gov.nasa.jpl.aerie.contrib.streamline.core.MutableResource;
+import gov.nasa.jpl.aerie.contrib.streamline.modeling.Registrar;
+import gov.nasa.jpl.aerie.contrib.streamline.modeling.discrete.Discrete;
+import gov.nasa.jpl.aerie.contrib.serialization.mappers.DoubleValueMapper;
+
+import static gov.nasa.jpl.aerie.contrib.streamline.core.MutableResource.resource;
+import static gov.nasa.jpl.aerie.contrib.streamline.modeling.discrete.Discrete.discrete;
+
+public class DataModel {
+
+    public MutableResource<Discrete<Double>> RecordingRate; // Megabits/s
+
+    public DataModel(Registrar registrar) {
+        RecordingRate = resource(discrete(0.0));
+        registrar.discrete("RecordingRate", RecordingRate, new DoubleValueMapper());
+    }
+}
+```
+
+With our `DataModel` class built, we can now instantiate it within the top-level `Model` class as a member variable of that class. The `Registrar` that we are passing to `DataModel` is unique in that it can log simulation errors as a resource, so we also need to instantiate one of these special error registrars as well. After these additions, the `Mission` class should look like this:
+
+```java
+package missionmodel;
+
+import gov.nasa.jpl.aerie.contrib.streamline.modeling.Registrar;
+
+public final class Mission {
+
+  public final Registrar errorRegistrar;
+  public final DataModel dataModel;
+
+  public Mission(final gov.nasa.jpl.aerie.merlin.framework.Registrar registrar, final Configuration config) {
+    this.errorRegistrar = new Registrar(registrar, Registrar.ErrorBehavior.Log);
+    // Tutorial code
+    this.dataModel = new DataModel(this.errorRegistrar);
+
+  }
+}
+```
+
diff --git a/docs-src/1_tutorials/index.md b/docs-src/1_tutorials/index.md
new file mode 100644
index 0000000..418b25d
--- /dev/null
+++ b/docs-src/1_tutorials/index.md
@@ -0,0 +1,6 @@
+# Tutorials
+
+```{toctree}
+1_gettingstarted
+tutorial2
+```
diff --git a/docs-src/1_tutorials/tutorial.py b/docs-src/1_tutorials/tutorial.py
new file mode 100644
index 0000000..d1f0f94
--- /dev/null
+++ b/docs-src/1_tutorials/tutorial.py
@@ -0,0 +1,22 @@
+from pymerlin import MissionModel, simulate, Schedule, Directive
+
+@MissionModel
+class FireSat:
+    def __init__(self, registrar):
+        self.counter = registrar.cell(0)
+        registrar.resource("counter", self.counter.get)
+
+@FireSat.ActivityType
+async def increment_counter(mission: FireSat):
+    counter = mission.counter
+    counter.set_value(counter.get() + 1)
+
+def main():
+    print(simulate(
+        FireSat,
+        Schedule.build(("00:00:01", Directive("increment_counter"))),
+        "01:00:00"
+    ))
+
+if __name__ == '__main__':
+    main()
diff --git a/docs-src/1_tutorials/tutorial2.md b/docs-src/1_tutorials/tutorial2.md
new file mode 100644
index 0000000..069381d
--- /dev/null
+++ b/docs-src/1_tutorials/tutorial2.md
@@ -0,0 +1,3 @@
+# Going further
+
+This is a tutorial
\ No newline at end of file
diff --git a/docs-src/2_guides/datamodel.md b/docs-src/2_guides/datamodel.md
new file mode 100644
index 0000000..8c7e147
--- /dev/null
+++ b/docs-src/2_guides/datamodel.md
@@ -0,0 +1,3 @@
+# Modeling Data Volume
+
+This is a tutorial
\ No newline at end of file
diff --git a/docs-src/2_guides/index.md b/docs-src/2_guides/index.md
new file mode 100644
index 0000000..c443d6c
--- /dev/null
+++ b/docs-src/2_guides/index.md
@@ -0,0 +1,12 @@
+# Guides
+
+```{toctree}
+:hidden:
+
+jupyter
+datamodel
+powermodel
+telecom
+scheduling
+spice
+```
diff --git a/docs-src/2_guides/jupyter.md b/docs-src/2_guides/jupyter.md
new file mode 100644
index 0000000..81c5cad
--- /dev/null
+++ b/docs-src/2_guides/jupyter.md
@@ -0,0 +1,3 @@
+# How to use pymerlin in Jupyter
+
+This is a tutorial
\ No newline at end of file
diff --git a/docs-src/2_guides/powermodel.md b/docs-src/2_guides/powermodel.md
new file mode 100644
index 0000000..794dc3d
--- /dev/null
+++ b/docs-src/2_guides/powermodel.md
@@ -0,0 +1,3 @@
+# Modeling Power
+
+This is a tutorial
\ No newline at end of file
diff --git a/docs-src/2_guides/scheduling.md b/docs-src/2_guides/scheduling.md
new file mode 100644
index 0000000..fe7b17c
--- /dev/null
+++ b/docs-src/2_guides/scheduling.md
@@ -0,0 +1,6 @@
+# Scheduling
+
+```mermaid
+A -> B
+```
+
diff --git a/docs-src/2_guides/spice.md b/docs-src/2_guides/spice.md
new file mode 100644
index 0000000..d68d3b1
--- /dev/null
+++ b/docs-src/2_guides/spice.md
@@ -0,0 +1,5 @@
+# Using spice for geometry
+
+The SPICE toolkit, provided by NASA JPL's NAIF, is popular for use in orbital calculations. [spiceypy](https://spiceypy.readthedocs.io/)
+provides python bindings to that toolkit.
+
diff --git a/docs-src/2_guides/telecom.md b/docs-src/2_guides/telecom.md
new file mode 100644
index 0000000..6875c2e
--- /dev/null
+++ b/docs-src/2_guides/telecom.md
@@ -0,0 +1,11 @@
+# Modeling Telecom
+
+Telecommunications play a key role in any tele-operated system, and the availability and bandwidth of the communication
+link limits the performance of the system.
+
+The bandwidth of a communication link is determined by the properties of the transmitter and receiver, as well as the
+distance between them and any obstructions or media in the communication path.
+
+The availability of a communication link depends on whether there is an occultation of some body between the transmitter
+and receiver, whether the transmitter or receiver is able to be pointed towards the other, and whether the transmitter
+or receiver has been allocated for a different purpose and is busy.
\ No newline at end of file
diff --git a/docs-src/3_explanation/co-simulation.md b/docs-src/3_explanation/co-simulation.md
new file mode 100644
index 0000000..d32234c
--- /dev/null
+++ b/docs-src/3_explanation/co-simulation.md
@@ -0,0 +1,9 @@
+# Co-Simulation
+
+Many missions come to `pymerlin` with existing tools and processes. It would be great to be able to leverage some of
+these instead of re-implementing them in `pymerlin`.
+
+There are challenges that arise when trying to get two simulators to play nicely together. 
+
+## Further Reading
+- [System Design, Modeling, and Simluation in Ptolemy II](https://ptolemy.berkeley.edu/books/Systems/PtolemyII_DigitalV1_02.pdf)
\ No newline at end of file
diff --git a/docs-src/3_explanation/command-errors.md b/docs-src/3_explanation/command-errors.md
new file mode 100644
index 0000000..06ff992
--- /dev/null
+++ b/docs-src/3_explanation/command-errors.md
@@ -0,0 +1,102 @@
+# Command Errors
+
+A command error, sometimes called a command file error, describes the situation in which a message is sent from the ground system to the flight system that results in one of the following responses:
+- The spacecraft rejects the command as invalid
+- The command triggers a spacecraft fault condition
+- The command has an adverse effect on the spacecraft
+- The command does not result in the intended spacecraft behavior
+
+The consequence of a command error can range from lost opportunities (e.g. a spacecraft does not record data of a particular event of interest), to loss of mission (the spacecraft is permanently incapacitated).
+
+The flight system’s fault protection subsystem is designed to minimize the consequence of command error by putting the spacecraft into a “safe mode” when certain automatic fault detection, isolation, and recovery (FDIR) mechanisms are triggered. There are, however, command errors that FDIRs are powerless against:
+- CFDP 2 delayed packets (Clipper)
+- Incorrect inputs to maneuvers (Mars Climate Orbiter)
+- Unexpected failure modes of FSW (MSL sol 200)
+- Incorrect observation timings (I don’t have a specific example here)
+- Incorrect Earth vector values (Viking)
+- Concurrent communication of multiple spacecraft in a constellation (MMS)
+- Unintentional sequence deletes (MSL)
+- Sequences that don’t set a new parameter that was added in a new FSW version (MSL)
+
+## Avoiding Command Errors
+In order to reduce the risk of command error, the ground system may perform certain checks before allowing a message to be sent to the spacecraft. These checks range from constraints on the syntax of command files, to some abstract interpretation of the command files, to simulation of these command files. Some desirable characteristics of a ground system check:
+- Precision - a check should minimize false positives
+- Recall - a check should miss as few command errors as possible
+- Interactivity - a check should be fast enough to enable an operations team to make multiple drafts of their command files before the communication deadline
+
+Recall is perhaps the most important characteristic for risk mitigation. When the consequences of command errors are high, ground system checks will skew towards high recall at the cost of lowering their precision. This is the mentality of “if you’re not sure, err on the side of caution.”
+
+The cost of low precision is increased burden on the operations team, which in turn can lead to increased risk of command error. They have to sift through large numbers of false positives, dispositioning many of them as “nominal”. This can lead to complacency, where an operator sees a familiar error, and marks it as a false positive, when in fact something about the environment has changed, making this a true positive. (example: sequences before and after MSL FSW upgrade. False positives that sequences were drafted for the wrong FSW became true positives when the FSW was in fact swapped).
+
+If certain checks can be done with low cost, high precision and high recall, we recommend that they be performed on every command file, as early in the process as feasible. These checks are typically syntactic checks on individual command files. In typical spacecraft command paradigms, this involves inspecting commands and their arguments, such as:
+- Command existence checks (does the command you entered actually exist?)
+- Argument cardinality checks (did you provide a correct number of arguments, or in the case of key/value pairs, did you provide all of the required keys?)
+- Command argument type checks (do the arguments you provided correspond to the types declared by the command definition?)
+- Command argument range checks (for enumerations or numeric arguments, are the values you provided within the ranges specified in the command definition?)
+- Restricted command checks (has the mission marked the command you entered as approved for use?)
+
+Many checks fall under the category “Don’t execute command X in condition Y” (cite Matt Muszynski). The check for the absence of command X is trivial, and we recommend that that check be performed unconditionally. If command X is rare, this check will have high recall (i.e. most command files will correctly pass this check.) The check for condition Y may range from straightforward, to difficult, to impossible. Importantly, the checks must not be limited to “pass” or “fail” results - there must be a way for the check to indicate an indefinite state, such as “I have found command X, but could not check condition Y”, marking that check for follow-up by another part of the ground system.
+
+## Methods of Validation
+- Validating that the contents of a command file match the intent of the author cannot be accomplished via a fixed set of checks. This sort of validation is far more dynamic, and requires interactivity between the author and the ground system. Usually, this involves executing the command file in an environment where the consequence of command file errors is low.
+- Validation using spacecraft behavioral models
+- Validation using spacecraft resource models
+- Validation using flight software on the ground
+- Validation using flight hardware on the ground
+- Validation in flight
+
+The author can view the results of the command file execution and assess whether the results match their intent. If the results resemble spacecraft telemetry, the author’s assessment can mirror the telemetry assessment they expect to perform once the command file has been executed on board the spacecraft.
+
+> Note: There's a difference between validation of commands sent to the flight system and validation of the behavior of
+the whole mission operations system.
+
+## Re-usable command files
+Not all command files carry the same consequence of command file error. Prudent spacecraft command language designers try to separate dangerous commands from lower risk ones. This can reduce the burden on ground systems - if it can be proven that a command file has low risk, it’s possible to subject it to less exhaustive verification and validation.
+
+One way to reduce the burden on ground systems is to re-use command files. The command file can be exhaustively validated once using one of the validation methods above and then approved for re-use without further re-validation. This paradigm allows these command files to be subjected to a high level of scrutiny once, reducing the risk of command file error, and then re-used with a lower level of scrutiny, reducing the burden on the operations team.
+
+One risk to keep in mind with re-usable command files is that it is imperative for the operations team to be aware of their operational envelope. An approval to use these sequences should come with a description of the conditions under which it is safe or unsafe to use this command file.
+
+Depending on the flight system, these reusable command files can be re-transmitted as needed by the ground system, or persisted on-board and referenced by name.
+
+Re-usable command files cannot use absolute times - either the ground system or the flight system must be able to compute the execution timing of these files every time they are used.
+
+## Making changes to command files
+The situation often arises where a command file has gone through a verification and validation process, been approved, and then for some reason needs to change. These reasons range from:
+- The predicted state of the spacecraft when the command file was written differs from the newest predicted state
+- The intent of the author has changed
+- A new risk was identified that was not addressed during verification and validation
+- An optimization was identified, meaning the intent of the command file can be achieved better in some way
+  - It can be achieved with less risk, or more reliably
+  - It can be achieved more quickly
+  - It can be achieved while using fewer resources
+  - It can be achieved at a different time, which frees up spacecraft resources to perform a more constrained activity that conflicted with the original time
+
+If the verification and validation process is lightweight enough, the file can be marked as superseded, and a new file can be submitted with the changes applied. However, it may be the case that smaller deviations from the original file can justify skipping some of the checks performed on the original file. Even if all checks are still performed, small differences give the human reviewers a signal for where to focus their attention. This can reduce burden on the operations team, and reduce perceived risk.
+
+A prudent command file author will write their command files in such a way that the most likely changes are small. Small here has two meanings: the change should result in a file that is syntactically identical to the original file in all but a small number of places. It should also be easy to prove that the change does not affect the validity of the majority of the file. (cite Carol Polanskey)
+
+## Integrated vs Partial validation
+Some spacecraft operations teams include multiple command file authors. It can be difficult or impossible (or undesirable) to have all of the authors write their command files together. To maximize their autonomy, the process may include independent work time interspersed with key coordination points. The authors must first come to a consensus about how limited spacecraft resources should be allocated. This can be a pointing profile (where is the spacecraft pointed, when?) or a power allocation (I want to do this power intensive activity, which means you can’t also do a power intensive activity until the battery recharges). Having defined a skeleton for the plan, the authors can go off and work on their pieces independently, trusting that if they stay within the guardrails defined by the skeleton, the risk of conflict between their work and another author’s work is low. Put another way, the purpose of the skeleton is to promote the following property: the absence of command errors in a single author’s work implies the lack of command errors in the combined execution of all authors’ work. These guarantees are not bulletproof, and are usually defined informally, and aren’t checked automatically, so there is typically an integrated validation step, where all authors deliver their work to a single place, where the combined execution of all of their command files can be verified and validated.
+
+## Activity Planning
+The “plan skeleton” mentioned in the previous section is a high level representation of what the spacecraft is expected to do. High level representations are useful in a few ways:
+- They represent a plan in a smaller number of constituent parts, making it more palatable for human understanding, and more tractable for automated analysis
+- They define a plan that is correct with respect to the high level definitions of the activities. As long as the implementations of those activities adhere to the expectations set during activity planning, the same correctness properties should hold on the integrated command plan
+- They can more directly represent the intent of the plan
+
+How do flight system capabilities impact the planning process?
+Spacecraft have been designed with some on-board autonomy for off-nominal situations for a very long time now. The Voyager missions famously had in-depth fault protection responses. Most of this autonomy is focused on keeping the spacecraft healthy and operable - automatic heater controls to keep components within allowable flight temperatures, safe modes for both earth pointing (enable communication for fault recovery) and sun point (use solar panels to recharge for survival).
+
+In nominal operations, the ground system has until recently had more fine-grained control. Command files would include specific times at which the spacecraft should execute specific actions. Any uncertainty in the duration or outcome of an action would be anticipated, and the command file would be written assuming the worst case outcome - either longest duration or worst performance. This mode of operations has low risk of failure - in practice most of these commands have close to the best case duration and performance - but it introduces waste in the form of lost spacecraft time, and also limits the spacecraft’s performance by tying its actions to the ability of the ground system to model the state of the spacecraft and its environment.
+
+Ground systems that support flight systems with more on-board autonomy share some similarities to other ground systems. For one, command files must still be sent to the spacecraft, and telemetry must still be received. Those command files may contain errors that cause the spacecraft to do undesirable things, so it would still be prudent for a ground system to run checks on those command files. However, the contents of those command files, the semantics of their execution, and therefore the kinds of checks that can be performed is where there is the greatest difference.
+
+Any sound checks of command files strive to guarantee that these files will execute without error within the envelope of time uncertainty as well as spacecraft state uncertainty. In less autonomous flight systems, the uncertainty in spacecraft state can be more tightly bounded - there is a comparatively smaller number of things the spacecraft may decide to do. Autonomous systems need guardrails to be operable - the system itself must know more about its safe envelope, so that it can guarantee using onboard checks that the activities it chooses to perform keep it in a safe state.
+
+This means that the ground system has somewhat less responsibility for the safety of the spacecraft (though it must still do what it can), but the ground system still has complete responsibility for validating the intent of the operators. That means it needs some way to simulate a representative range of autonomous decisions and across the range of environmental uncertainty and give the operator a sense for how likely it is that the behavior will match their intent.
+
+## How do you guarantee the safety of an autonomous spacecraft?
+- Give it clear constraints
+- Limit the actions it can take (maybe avoid autonomous trajectory maneuvers)
+- Imbue it with old fashioned FDIRs
\ No newline at end of file
diff --git a/docs-src/3_explanation/fidelity.md b/docs-src/3_explanation/fidelity.md
new file mode 100644
index 0000000..7f6203a
--- /dev/null
+++ b/docs-src/3_explanation/fidelity.md
@@ -0,0 +1,16 @@
+# Tuning Fidelity
+
+pymerlin (and Aerie's) strength is its ability to compose several subsystem models and observe behavior of the
+integrated system. It is not necessarily the best tool for detailed modeling of individual subsystems.
+
+Different mission phases have different needs for simulation:
+- Mission planning requires simulation to run quickly across large time horizons, and to provide enough fidelity to
+  perform trade-offs between different parameters. It may be desirable to automatically run many simulations with small
+  variations in parameters, sometimes called "Monte-Carlo" simulations
+- Operations requires simulation to catch command errors quickly and reliably, but the simulated time spans can be
+  relatively short (typically days or weeks depending on the operations concept)
+
+There are also differences in how activity plans are generated in different mission phases. During mission planning, a
+notional schedule that merely approximates the duty cycles of communication, engineering, and science activities may be
+sufficient. During operations, much more precision is required of the activity plan, and additional tools and processes
+such as external schedulers and strict configuration management of plans come into play.
\ No newline at end of file
diff --git a/docs-src/3_explanation/index.md b/docs-src/3_explanation/index.md
new file mode 100644
index 0000000..bf8cca4
--- /dev/null
+++ b/docs-src/3_explanation/index.md
@@ -0,0 +1,10 @@
+# Background
+Here, you can learn more about some of the theory of simulation, planning, and simulation.
+
+```{toctree}
+simulation
+planning
+fidelity
+command-errors
+co-simulation
+```
diff --git a/docs-src/3_explanation/planning.md b/docs-src/3_explanation/planning.md
new file mode 100644
index 0000000..5035206
--- /dev/null
+++ b/docs-src/3_explanation/planning.md
@@ -0,0 +1,3 @@
+# Planning and Scheduling
+
+This is a tutorial
\ No newline at end of file
diff --git a/docs-src/3_explanation/simulation.md b/docs-src/3_explanation/simulation.md
new file mode 100644
index 0000000..87eb764
--- /dev/null
+++ b/docs-src/3_explanation/simulation.md
@@ -0,0 +1,35 @@
+# Discrete Event Simulation
+
+Requirements:
+- Allow a mission model to express time-dependent state in a way that can be tracked and managed by the host system
+- Evaluate conditions whenever their dependencies change
+- Evaluate resources whenever their dependencies change
+- Allow for tasks to operate transactionally
+
+Quality attributes:
+- Avoid wasted work - avoid computing the current state of a cell unless it is queried
+- Minimize needless allocations - Cells should be mutable and not require duplication on every step
+
+## The Theory
+
+The merlin concept of a "Cell" implements a more generic simulation concept called a "State Variable". Traditionally, every state variable in a simulation is given an initial value, and it keeps that value until an *event* is emitted that changes that value. Put another way, the value of a State Variable at time `t` can be computed by some function `f : Value x History -> Value`, where the first `Value` is the initial value, and `History` is the list of events that have occurred before time `t`.
+
+This function `f` should have the following property: for all partitions of `History` into a `prefix` and a `suffix`, `f(f(initial, prefix), suffix) = f(initial, prefix + suffix).` To paraphrase, as time moves forward, we should be able to "forget" both the initial value and the prefix once we've applied `f` to it.
+
+There are two additional enhancements we add to this formulation:
+- continuous evolution, borrowed from [Hybrid systems](https://en.wikipedia.org/wiki/Hybrid_system)
+- concurrent events (TODO)
+
+Continuous evolution means that the value of a State Variable can change even in the absence of any events. This requires some separation between the *dynamics* of a State Variable and its *value*. The dynamics describes the future evolution of the State Variable, while its value describes its current state.
+
+Concurrent events exist to model two phenomena:
+- Two or more independent *tasks* are scheduled to act at the same time, and we'd like to avoid arbitrarily serializing their actions
+- A single task *spawns* another to run in parallel, and again we'd like to avoid arbitrary choices regarding in what order the parent and child perform their actions.
+
+In order to enable tasks to have *[read-your-writes](https://en.wikipedia.org/wiki/Consistency_model#Read-your-writes_consistency)* semantics, we introduce the notion of a task *step* with certain transactional guarantees.
+
+Further reading:
+- https://nasa-ammos.github.io/aerie-docs/mission-modeling/advanced-the-merlin-interface/
+- https://en.wikipedia.org/wiki/Hybrid_system
+- https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type
+- https://komputasi.wordpress.com/wp-content/uploads/2018/03/mvsteen-distributed-systems-3rd-preliminary-version-3-01pre-2017-170215.pdf
\ No newline at end of file
diff --git a/docs-src/Makefile b/docs-src/Makefile
new file mode 100644
index 0000000..03ece53
--- /dev/null
+++ b/docs-src/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O); touch _build/.nojekyll; rm -rf ../docs; mv _build/html ../docs; echo "moved HTML pages to ../docs"
diff --git a/docs/.nojekyll b/docs-src/_build/.nojekyll
similarity index 100%
rename from docs/.nojekyll
rename to docs-src/_build/.nojekyll
diff --git a/docs-src/_build/doctrees/1_tutorials/1_gettingstarted.doctree b/docs-src/_build/doctrees/1_tutorials/1_gettingstarted.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..81a0c64a48e57b8079e30bc3d7e6316220719814
GIT binary patch
literal 35412
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
E0gC=e$p8QV

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/1_tutorials/index.doctree b/docs-src/_build/doctrees/1_tutorials/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..be0b0cf4bf7cd35b3b9a6f00f2716f9671994895
GIT binary patch
literal 3158
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/1_tutorials/tutorial2.doctree b/docs-src/_build/doctrees/1_tutorials/tutorial2.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..c8767a06a76c198f968a0787d055e0c327cce85f
GIT binary patch
literal 2929
zcmZ`*OK%%D5RT(Wwrop&<k13&(*#AD1dXk<D2k$&0O=tIqdpXAZv{c^QX*?Ex#c64
z4+h#pfEeH{?4Ri4AGH6iA9uAYS#=FBL=K1Z{APx~bbcFeUaS7Xwk^3((?go)O6SbR
zu%7G87fiYMK0f_5p2sJlXXvTb-efF>Yv9PZkhx(h{usj`u{$B{;q3mJWtkINwbyxv
zclp|n@d@vRjuTF@g`?1arG=V27<=P5GchrO@5XC3O$IC<zm2s;-I7ATi+nfqNNX@(
z4c(cY$Ki$)ip66;qG5wNXT-=m_?P@y6}e5euVs>23nJDXMT>g1p8ImX8PV*-uyNw?
zVa?G=I*NRo-#=R6`{C8_d&`U+=2S>who#X!!F@ZV%m_9t&kAN>#}Fpk18cJ3XT*7@
zjiAyFo7LxsMIQNGzQynHRX>9JJ-A0FhL(IWRC}+vun+K0A2e6%c-;wC9nE3|!NVk&
z?;rE~DIEMG#DG6UoIl3*2;XCTPvIZ`lpnw^u<~bfdsurR^d~7<2TihQBVl&XW|1z6
z+^9oUiCnE+{C^wT1oCI$mNQgYNfVj~B0Dk6)(Px5?Wl}L*TP1_!*XnWa$zM5GH((*
zNDGFohEjtftXt+BTmjy9TL6!ZR*tDWhVBnkdZ3}LfUfqg^e!Ir?c>m!FvSc-8Y4D2
z1*{w`N^CZb)()n!v6#lNGK^ufHi1Cz2^cnJTW=(GeWx>$0G3W+N(VNZvl#Zq5TmqX
z3y1GQKNXhp1(}YuDdM{@ut0T5GF_x{wGeo>rZCAW3ON;ylLq9_H@h%H{c+ebtklL4
z$=)!8^Lp6eRJPkr*kx0JC_3uAZJ0Wtle3YZK;7V!8igo=!!TNa(nC5jmRw5q35A#u
zrZSy_D~6tT<Abjbtibx-<wL@Z(S~rUa)~wo7{Is8#jssRenCp7k`lxI(#ettuEU@f
zIya!XdhhbV(#^1w902evM|>n4LLZV;O+1}2ggeLnI=WxDX;`LBPI6WPHc%sgnd8vS
zv>L-lghS*F8hAGhC`zBqN#VKx*7~_GO48yHQLP99P&5i{0%Eo+N`>^4`Z=kz%;%a+
zi-e{fHZ8SfWbtMNk<5`d!ipNN+awp3j%0FVX60H_C#bnCIAc*6Rnb9cf5t|}Le}l^
zPFg_;+Fn(dOeJYK^1X>MfjrgQqm{6miVd()6QEFvLb&+t&f_pBSxHbL3?-UX0ozKH
z5ryrkF2aZ0xzc_;9D-~Q%QMHdI@D%@a=M*3D+9nu94n9>hjgrie(>n|7l`M;jI$;2
zi82@eNh2PWOA}sCm^l>8jVm4K21D)&31vM;M<}7(@p!Zz_5sL(w3XR9Kx~;1auIgy
znR0YWxR`K>58%Bab;A9YEhwt&XOEJ$2-MALUvG)j8J&f8KjY~884_O?8=_o=5Vuc!
z2^DGBRugpA11^9boe4Dt24+oRFLep)M@wv?NZ6H{)|Hrs<4FW$iV@3EzGtw2Gv=V<
zb_T8!!U{|@f@eW$x|P+tv%wCm%5mM$F2X8PZ_<zr>vbzZ?E;BH<pQ<gh@)o0(3&t{
zcVQHeg~^rLd7egUn#J3vsGv-H<qp!yrs@B|GOJKx=}8e*zHDY6R`saE$ok7(G2i~H
z<I;TkBaJ(FusgS;5UP4C@IUJp5buPQ=dHfybAA6@sqYF&S84QN?~<eSqvPtJ{C=f*
zfBO{oadR<r)8s)6&+)cN#CpwN@)tJr62YC7$mMzDFE1>Ah~F1{%ZC0Us;k@mOrSPW
zq9C!Rq~_J|)d^js)O<)Ys-PHY*%nI0dTWW;a`!Gt>@`}eOM92(V+a`+(N%6Q%bK0w
zEr8ZqAt?=z%}h%P2*L+U*0paE!a#oy=ikQf&?fN2Lc_tE&!RGFg>8quMBZ%46}UHr
j%B0UzF-;P#H}W(DX8kffZ^A}#W-&FT$MfPm`qAOP*!_^)

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/datamodel.doctree b/docs-src/_build/doctrees/2_guides/datamodel.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..0265e4c99512b6aae9a5203839986ad6fdfc7513
GIT binary patch
literal 2954
zcmZ`*OK%%D5RT(Ww)~JEanb^bQwK$w1dXhqDA1yp0BLSPd??b~0)pD5MAlq#%ZDu=
zjJAgWF~D2cKheiOX#ZP3?n*0Jbqp^=4u|vnW`@7Ee*b0tTJ;yUY{`WhAJRNmI%hV9
z)m&%3V9Lc0@$ql*JU$8?Lr<;tCSx&N14qV%%neiVZ4BMS?u4|5llv={Wlm_-T<0y`
z<|}XGBi;!uC!Az+M`7<3)Jma72QR3j2XC~5@|gI+e&aP8Cp$jE^)A--wMz<XT;w~U
zLmKn>a%fMiJ_<LWg2f|0pka+VXT-oec$>Ui7P(EHtYnf}3nJDnMT>g1n)`CL8PM$5
zuwmlyVa3r=I*NRY-+Q^l_rr_+kCqwR&#92Y_DiFGLNIKfG9y^OJS&)i9etQ+d)8$A
zugJ&?L>(6#Em9y3i#+l>e1qTR%YJ|mbl@8u8CvrBsO`Sy!XDtC9ysr`5meSOyB)4N
zngj}h`$;h0KjQaNEcj;#0Kbn|e~#|~zK8f8!#VyX@4+ds@+UKUSaTulRpugZy<~gu
zq|O_i3YwiCr1OL3d``hy9koiqa_#WPEoySfpM*VUsIrnKm=OedWSFgU*>c(;6fduZ
zwJ8tFvGvKJrO?g1Nk}0LE;go=8XsZRGUwnG3Sp-~_RwhMn95^lzoF6t7)@!kwRfd=
z@rZ97h0cg6W+?Izv4P*rBCRDh>qct_Q`u0AV_53PuwI)$p!XOIYm==v61z>OGm@~D
zPGL$5Hk-2;c83t7v}1FJ@55%QIOPj69%@s>_n~V6@RDS@NOf!>@J>x(l2sIPDjX+M
zyhGpQ!lVF>!iHg`HjYSk!Vu2uVU1JSY+GT6jRm6UsPlHp)C#Sf4g3h|x~J4AL=hZ@
z(E^kX(vh*`QnF7d#EdYN=^R`!bi5n(zU^6o_1(*dgc+j^;Z)_48Dt=tnz<OZ>d4PY
zX;o5U*k3qV5W#im)<S0nOt0R(e6VmcY$pc*Jj)Ru35R0XlvIs89WjJE$NoCnVz_Bo
zrcF+ARsuFqBY>Hs(9X0P!bgNd<Wn^8cIZ;nFqx6Ubpfnx=DsLNgGWTQA_zdyC@Pb{
zt%_11J*9p|DlPN5CgUQZX`78pZ5f%rSwSRo<V09e<8_PV!qS0Ej!djvnbrwvZUfF(
zR7O>F5V|>GBSRtUPI)`6padPTDom!5v>f?f$NWH^>g~&=u#<`nuu&tRP>Mph_-gxM
z=$5P`C=rGd&8mQHB+7uo_EZ<)Q|?@8zw7rwwuj}J<60eRGeSAtN}QDe;3SR}NRLB0
zRzdGQc=|Qs*)_v#L42aj#D6grpE_2;>oGHjg1KR(1Kps{T_K^Y<LCe-lsg_@u7-U8
zvLH=mHVzP5CWKssZF{C19TP4_T;c<GZ%CbRzhMiCD*M@^q%8t<v)b2NB6UV5q213o
zra*?o*Tse?S0TjhV_!l=n!?p+o%DbUphssy4S|74Q`k*i!ur7in<x@?rKWWyra5^W
z0hwaJa+L2GEZ~ee=(v@E>zJ?t!;Rp*keY5~_0DAC1FLdaH?)he%+yJmw_&wzC8%8>
zQK(#?HXL!(j2K!IX6+7)0<tj2QajJnbWLM<>l77~X|G%_t!#P^e6q+YlvsFcgr#q$
zlMt(V@L_=cZLgSi|JOn12jHJ+_`!pnnI(l#)w_ZJRX>e*D=a;2^gW&F`}azHS4g@_
zqYt~69If9UR|n;fE6w}Ir??NN7ehNu9>nk*&zwZ8*ZetuW<w_t+*yfSo=5)t!t(q0
zea1Iz*qldob$c@tsEw2;NUSNTc}@B1gw9iHKBO5{Pz<ze3Z-J*TOc;vol6osQ?1pd
z-AnQ@gp7;mDz_G8O-}F@Kx?g#lm^IprlkY~;R7b?%J&Ijpnrh#@8S<=6L@f;;o$ja
yQ5m(uro&z$uQ%ih-0MPR(&wp|MhVwzc^U$fewm&(VXZi`n3~e#d2t^7;P5|ODVcEq

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/index.doctree b/docs-src/_build/doctrees/2_guides/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..33e5d15b0beb4b5a353c6d98f66ac61150ede7f2
GIT binary patch
literal 3225
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/jupyter.doctree b/docs-src/_build/doctrees/2_guides/jupyter.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..1a4881f4a864c5c349a0da237a062df0985ec347
GIT binary patch
literal 2994
zcmai0TW=gS6mF7klFemv=>?=VAr&fZMK@az4~Uma<pmLu2UK`NmUqUxcH^-JUz*KB
zBzUOQNPesN4M<%60sJ>U&+N`_mPJH6ihX>1uHQMwKec}Ob@N8`7j|sPg&G~xJXbnr
zHiq?FXTD&{#dq<^&+#%o4sAovt@b8kG28%0#)ZrcQ}KrwI*Hv0X^+SE*DTAN(5ku4
zTYQzT{SY7Xc4#@_B%3)3hhORQBd3qNWk=;j!Hg8@2*0m=dEuCe=_W4Te91=1qW|T8
z6Kk7SO9~5J<a?n_8khJ=SRH$E8g4=ri>JO%!v=NEh`x7-K=OD+<TiP?mPu+Yh*-B2
zE$Y>J?#t<>PqQ<_28qXqHAjc(DDoYCc(TL~!i(N_mKod2sgT0<N~2#PK(<Gj5v(_H
zxd#(%*P5*NDH(c!O!QvW5jZaL$nWtjexI-SK0?ukXLM+2$!FuZ|B?%PgdaU}-f1JK
ztYddKEIJy834(h`Fh4luhba>L1Gvv0Am$(9dx-B5z9(>vf6TjZ39S6-)E?Gc2!~vs
zcb)Dclii71U7@;TKO&uotT-3te9Aeabfb=ArF5kZ!hc)YWS2h;x1FKNN}9k(5cZ*A
zw$5(LX@~Hf+z1;J9+qS4laouKlX;V{LmH%PO(->D!n$S72{lBy>^1lw7_A&rc?_%H
zQ|SSfrhrzpccpjnl<%B|_K+!NC~_3B$tf`BXi;LbX|#4Ql?}uwhNWH%o3#l9de6YH
zG2VJ3vD<b!BME)!6sELbv$=?2e*iH`J2rFpHf*Q5RK6gifi^{a8#)${FG;40RP7c5
z@6{A0Sw$h|!f`UG0O%WE7?;Fp*fOlt#u3S0GlX+FY;Y=@Z7b}tkw6q3b>2>xTA`J*
zz8^we=bRdaD1yT<T7c3<Ix?1AO7;nbm=UHjor5cews(W>=UpqXzJL9YFk`eKoT^-+
zX#fWBEpsvK)RCW&(yFAya4>f=CxYwHsfA7rm|VSo{b259*i8-qc$OnR5)Q?%EvXuM
zI%EiUj{P#4XSiiprcF+ARsuFqBY>IHu$pN#fR6}=$R}vvtD!?t*JMfx%K}*2&V5mm
z29JnpMG%0ZQB)>@I~AoudP@D2R9fb9O-4mR(=Hp8+A=bGvw}$G$ZKImjn^HL3rqVl
zIWo3#ZBi$wxh*(jQ5jXyLFo3FjSPgWd*|J>f)ez^sxX;K(sJZ`6H^9xs<$UgVJ{UM
zV55dWp%jI1@tfU8p;NMwphOr-G^+x(l_-4*+f!YH_qlVW{i4?c*&btxaIKED8KRu-
zB+kkJa1zG~q{ks0>!5cZKKl&u?3h6|Cq7Z8;y;>*N9EFl*E4301#^Q+2f9IzyFx-)
z+tEHsD0e)btcL>tvLH=mHVzP5CWKstU3;M%9T6^uT;c<GZ%UnTzhw)GD*Mr+q%8t<
ztJ>FFB6UW`p*_erCPRkA*Tse?S0TjhGhaeQn$^_+9`}GNphssy4S<1hQ`k>k!utLk
zn<x@?rKWWyrpb900hyxDa+L1{EZ~ee=(v-C>x{4h<Bs4}k(zF0_1^eh0IbSE-O#SW
z3RADs1P<$UD?#l7i9+Q9wc&`PX2{T*Fn#x66p)44mfCrq=4~3(JLjmNOnc?JX=T$}
z;k|iQp~T#aBrJdOY%(6xvL1&RYk%4WGw|P9=<HbhJ&i>8us5}(5UP4h@IUG&6mNy4
zMj=*>zP}ghTOetXMj!UCxmv$T7Ki1xh35U`Q{)Gei(xg*9z^jHPoG4r*Zc*4ZbLf}
z+(n6OUPk`n%JK*J|D12xusw_G>h^XfP#q~%kXTbv`<n38DV?R%d`L9vpy+GaluE^V
zdyd#}x35WTPqbE-_OHpu7&0!RuiTlJH9o;>0L`_+QW_zfnU)eDgb$dlYhNaef&LE8
zzlq<XQQ#SdmV+muMQzjyn;v_OyxEW|cy9`oNuQ^38YX0K<Y^3yJ7#*|gpK0DVs1*0
L2gYUe{o{WCmqn<+

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/powermodel.doctree b/docs-src/_build/doctrees/2_guides/powermodel.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..b9df3649227e6f527cadc7cd76a615a6f45fa78d
GIT binary patch
literal 2931
zcmZ`**=`#*6piCZw!FwomKI2yIw;a4Xe0$iQ51a%kfKjUjG{>U77)}7C9>v_Q!cUm
zV4!^n5CeP*`x9OMp#8TV&PXF!af1jRUS8gf=iJL*Tfg(oYt_H7V@od7q)+o)>73aZ
z)^nZtf+-i@$0xtV^Y}P)3_Z2ln~cS94H_92GB-@c*D-XHx)aj&r{~u!%bd`vInG<W
z&DUPX$Gj6-PB_UHwnFzM+)AOwhu`Z{W@6HW;*D2qk|OwE|81;eYL^rdxXAZHhcqGc
z)zF?sdK_-REQ`l}NW%to&WNFR$S`HJDsr2mU&|!57D9Zt6fNqn_1u^9#gJwvhK-Vr
z4{MH&(^lj={Ql7jKM3CqezeTkK~9Afc2FAqGYVh_lo`PW<ypZD;us)A+p{Jcd_l%u
zpwfdf<y)le`$Zo4UB1Qd@l`)W_8lZg$A*@Cu~hr7xUh%#PY<1U+6XG^a@`46ZA~i$
z!-Hg)9~|@hsTlkdRDeG~nLowvA%2hWdxGrv=e&okpvs@l<6+H#(5=G7W%a7yBb}L;
z?;Or{7L0DxrK*gs)=B<<6wL+lr{R_}R9Q(Ao(L*CHq6!+*mBw-{iADPW2VD$EPYC1
zC3G`y5<Ex)hOL>T21Qu6%sFHN#P2l_9vQ71Q+W*SpQ!XeL&Jf#_OA3U9`l{!&>1tu
z48<KpEOH81Ia-uhY#OZ{LS-W{iD6|B!)6@<f!`A-Y)qHlNUXM<&PW1S+C?ZW#B9!D
z*dM`+(vB@`z6;xlTFMt>GSa4q??TrC)g{SvkqB#H@NO+(l2sCNDjX*>ki*~fz!dez
zVau>m8%HF2!%)uaVS`iIEL&lZO$4gwsPlHF)C#Sf4gDDIx~J4AR1q46(E^eVt|Mb9
zr4*k~s2O1@(>b(a=y*5keciJH-}f$W5@w7xgj1DE^Z~#Cxn(Yfox1W1R$7&n7!H<p
zmP~LRy0y`H0JEd_E^jQI47(`-0MByNM<SsZwk1_#Psa@9&au9Z{ugc<mT8ldoRxqL
z+z4RiIJ7gZM#vH65cv!ZydAm}yd`r{xGsRT?c5h7Y4C`uRssPi8bxI?xKl|gq^GN&
zi%QFUuF0fGXxe3yQd>qAPgW4g9C;(GsPVc(a$)IErbMPuuFZG?&TSzX3uaWLgVF7&
z8W{;$x5qo_3r^7XDq=E~tmU}xO$-X$Q@uP|344ibfQ=dhg;Es4#h1H}Lbqfk0Yw-n
znpFkcN|GT(?1>lQWA0pOzZnc5w*B(Vajp8=j6tW{NwW$7n#8dJ*W+*<>yY;zKKl~&
z?3z)wWIjpe=0BU62Xkq{>j^V`!Q80wfo?G1u8?rnadZd@<&MXr^>6?{7NlWjlK`=0
zLdZqfwP(uF3E^VQC4K<!4XG3Ew`@VdvR^zXZBeM3)w*61sWUn)?Lo%T`7>O6O*T}y
zDj`mv_!2JCxUFXBv<F-OJvtL=1Pn}@!hY%!)(@A|M3Jy7HLaPLhT};DWQrlnLEke(
zz!`J!aXW+731I~$8o|RLHQg%ez3FHNR^_N}Xcu9XsW)lJhV{CYfV)7VP`Lm%9C6f)
z8Cnwt>>h#wvM{?+JI~WdO|y9C6b#C=SFV@7Y#RR`EvpJ8mL3&h<*V8B!&g1*Ftq-*
zS4_AMebB|B_h%Y-$Y5_CNg-7ASm1xvZy??ZE6*B#&*uLAz0%(mmag*X!~Ug2>qp1c
zMfu~(@c!|s?xWek&`y&FH9W`LCJF0r{(?WZp_2seti)ZONB-i%@(1|)oNw8%y@=}S
z^mZn|jdW44SW8m#n(5USx+tmjaLr&rG1RglN~L;hN!Vz2E?Ml%yjF+yFWJWsGA^R4
z++Mad-N9P`t+hf@8X%jQmJ$#|4w$TK-zJ1X{vOG{jX$7G;E{!fgEyZAGirxThrJ};
pY{V6~H-*Zi&l8!(3D+BW8UoXPnVvUcqd2pen$qKWaUT7!{~w*`k#hh5

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/scheduling.doctree b/docs-src/_build/doctrees/2_guides/scheduling.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..75d8cda92548109ae0946415bba2eb9f9bc886cd
GIT binary patch
literal 2930
zcmaJ@%WfMt6piD^vSdqs<k13&+Xh9N1dXk<=%UD?KpQlhpkDN~3kYh45?OP|DId1H
zFwian!~l0;f1{5-X#cE-Gn$dD8Z{tzczJnWJm+5i()n$=ajp6bTejpv%?@auE1feN
z!+NeWUohq3+xYm`corXpo}njJdy}yku0bQ?Lgt34_$r2BQg=eygZcTcWtkINwa0mf
zukr4y_=xvH#|bCdg{{#4F5@isQmAQ6T2Q+2J)0%(m-b%AI+nGP!n2EfC-g`gDqjt2
z^9T>a4H#qb(2r^8Q|F8rdxy+YCaWU1De7(}skIQ|yQ64Pf34@fTr9>kJ2GsNbbRPK
zI!#-VZ}InDuJFC^_2>u7j2-1vNMT2%(LW(^JEF`8HY!gGW)Q~+A=-UwveBnx>IEu1
zvTec#MIQNGzRB<LRX;}N11TIcRFbjO+0n%^b-(;z|BDa4>en^86WVoM7g!nDG3D<g
zNq!$y{1Cqf_&vn$F_K)DR82jd;s(2jte_%~p*Jh!Gh5Phuj{2@$mf_v&p+n-e2+gt
zqN|JWSZh4=7b!&AxLT6V9VcV`x?(VRm#@~j{!gUMJ@O~vmNQgYNfVq13Oq%K^*wf+
zc2vff*FwM1VL6sQ`CAFY%$tM~(qdw>k<{1->y|kO%mMH_ErKUTE5{Tnv-TsE9-wF`
zu%^8$y^Du@>oD}DOyQcGHW7=Q0$q+4B^Db-Yll$TM9gAX8O5+shd|)>2nzlA(i@4@
z!0C)6oTXia(m~ATG=|*?%qZ>Hh0Ql%keH=>L1q(eiufiBEx=upOc#l-76$Lu5++$C
zAt%Cd(qJ9_<_G5BKMb3OmD)HW*)c;ouZKRTvR!t<4x0&7(NX7ZqtpqVoQ?ey?uIAS
zC{z&|hS36&9<C!}DWw#jP^cMUD${x5cj$RH+5dds3Vh$Yyh)fb+7M1vE}6j%q);;#
z!&Y7S3syRnl^FJxc9u+V8-}&fMF7pwdzUwsPKNE20DxyX>LV+D3>pHV+&TDi9qljN
zG%V95Cpjwt8@Lg`%wbr|w3;ACltbhV8u(fmQtvcbh{E;6!a?qflC*e4RV#r26pf-X
z8QiKQ71GnyFGQtfKGy_1hSoNlmD)0L@ni*&%#mYZMUB@jk_$`6k|B|Kl--6W;M^vX
zv0z3;Iv5?y)yPE1x=Y?kUvPqMQ4y1=WG%;iZ(vT~p6cbxm9Ue@2H2=6P$)$qT>NJH
zVHlRIB%lZbMYF14n@KXJh&}Nlyvv;{?X%GcVtY`YI<D1$HdD~)cG9c@fF^OQ!1cJQ
zeX(-?!PC!B&!L%QOXibgVg94WJeW%pUXPeL5X?;~ALs@n?g|NKJx9l&Q0{nqxgPca
z$bz)YY!e`L2R#ql_Eb4KBV0_m#1G)TA$7w2rY$H~_Ol12EedtBTGva0R!`@p-OD&d
zJh=FpY^ZWoLYzMGWjwE@Z8bvYJ>VSZ(V0*aU|`-9c2k$Ie!Qe63N(NCqBRrKj68~f
zOfhCT=zEF?IAabzZfDRsA`CM^61)pi)2*W3nNN0LRZi-Lb{<xlI!?1Ttk<ms+yxSa
z$_2RLh@)o8(3&uUb`TVh<?vcSJI~W(O(S{h1PscwS8hLj+4KT<XIWJ!vGk@0E1xv8
z5MS*S{OhVI_+KBi8H{OO{E>zoGT2!}QV3PO8Tg;|6Nq=h%G1{0(}ll(uJm_>rK>#p
zuzM-d`t5ObQGUNNyuW>_`=mJ-*3#rb4bL#<ld%5gFZgpCdP(3;OWfsI<S))GzmNaV
z`KAqni>R(n4>AF6q>F;ZT9TSqqgP+(MM<rPYX%F7v6d}SD%D#{!dAO?$zreZS{>TG
zWFJGwxQMQDd)d}}2X6ti)(S~!fNW%1N<a`fV6t|fCxk)%7RkSk-=a<6A&G{Ar=JBg
wYKLuyy(Hdf#TB?WgvzAP6Pcz7*Zn*VfqB17&zsOMPA#UU^mtyJML$0H7a<stegFUf

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/spice.doctree b/docs-src/_build/doctrees/2_guides/spice.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..989d40436e31d17e102faea47128f73b5edc57a8
GIT binary patch
literal 3471
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/2_guides/telecom.doctree b/docs-src/_build/doctrees/2_guides/telecom.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..48228ca102503e300448e5999c616080e80e2333
GIT binary patch
literal 4654
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
Qtsu3fM~m^S@!9$R0UyW)WdHyG

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/co-simulation.doctree b/docs-src/_build/doctrees/3_explanation/co-simulation.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..7e44a40f05860ea7f8c537ffc028c051b9a7c29e
GIT binary patch
literal 4761
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/command-errors.doctree b/docs-src/_build/doctrees/3_explanation/command-errors.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..68fe2a844525f9f8b1db394d0a37dbdeded36ffc
GIT binary patch
literal 42958
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
Wbhzrk5O;O7^Faw6>bY^*S@}Q1OjCFO

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/fidelity.doctree b/docs-src/_build/doctrees/3_explanation/fidelity.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..cdff5631160bbcc1ff5e948e650253acc054dc68
GIT binary patch
literal 6383
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/index.doctree b/docs-src/_build/doctrees/3_explanation/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..0919979a44d47daac9b0cf288e1da39a64262332
GIT binary patch
literal 3554
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/planning.doctree b/docs-src/_build/doctrees/3_explanation/planning.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..76b1f276546e42a77e55b0d5f4d7636e142a2b10
GIT binary patch
literal 2970
zcmZ`*OK%%D5RT(Ww)~JEc@;>UIw;a4Xk-Owffl_4NG}D98bzD-77)}fC9>u&w<On=
z4+h#pfEXaqL)bsj$3JNQTff<rR<i0CUWgnH=lRVHe`)>x+xoTYFKoF&s(gIF(=<1!
za51c=CMh$K`}i(C{WYG)C!u5csWYWbL=4x!kw~ReEAsd{hAy#trQN~g{)!WcS0-<+
z%a&}*mDll!?1YwAUW>V-aQ9oy^IYYleV(WL-zQR}rN%bW72LS-N{q>r_cOkUwUzCH
z!zLf)PUx`43Ar5F6Wfo%4M-O8s2uRH#=W;{P<r@GJ}#@&kv}Vm=FWkLbt~sty;@Dn
zVzwFZ<k*TK@swf3^AR0Ixg{SQF3G*{b^iw^tm~&-Y32HbH9sLFuFr*4qF<b4!orR|
zOmsbGlm4enj0;48Q`q{nqIeu+X_WWmhP*GA%K;+Mfq#5tc_HWHxBE&ew~v3m?@Mp2
z;<^sqop9CBBv=sKC&6;>NIsx=$PW<&`4A!h2;U=okMTW)gYpyEgJWQo&t~?B=0dnT
zwYY~2_S`Ikd@5_kQYHBk%bc3EI)0U!<=XA{+tp-MJ`1<J<+;;U{20PLvclC_ZF%Dn
zki%<XZOS83Y)f)$DRh(45@uL~kc}y&MoL(9!h2)`g|X8heP~VYMV`jc{*mhv5NS%K
zZAxF1J|4-fqtF?NTv(2*L~K$Hta+Xl*sNP)JWLfsHI8AaAH#ZW0)yUTFsx0srPbJN
zdXq3h9i76I7Hqa>G3*W@CO2Np9li~lRDpS!vGLH@EWQn02dEb;F&WjhgTQ+=MQBk`
z*s1c8O_2|MlM9nlI0_q96vld{#fd;TuZK0sb+c`S9WhpjqUXMJQ>IpErD9Nypsst$
zEnylQR`3jz4$_eba*6CyIby~{o|u$MKXghz?0wO53hVoq51FvmSSEorEi5uXrY1gy
ztvd2^Qd*Ui81@!U7DPxBy0y@m0n@AZFCQ%24BO-YfafIQqv22tn<(E=$wva=PO-m^
zHW_YOkr<n@R1|;>)F@!)D6|uk58)%iq0%WDWIJ>@Dw)kl;kp9WHq$aISc6AIwIV1$
z(dJx}z^#f>A)Qh`BNa}RsbS-c(6o(qW1L{~H!FxFo}DPCYP@c-R5?D-<jBOzm1&)z
z<~HDrLuFJ&2cer2Ha1kc?wNOJ1tsW()Yy<1l9nRh>zF6a_HZfeP_Y3v`3NY~DpNjw
zv;8=93sEqXh(L)ZRlqigGT^YC>LPp~y)WFC{XWR<pg8l=<Ojx%P)@grvoZjj%!>@^
z@kqxi=)FhJKSMmbc9<-PC(2Cx$5ZjBTuyjB7WP01Kdf}18}y~mG?aBbAE1O%FXQ2A
z*aILl)>LNW0CNQ)<RWalv)uDBlWHV2K7jXzHiY{PmvL0t&m~IQAy7A~eZ6JcBzzLu
zy+mRbBuIQ+Y>09dLfk$s3#g!}T#edE54Zq&Orr83FfeHfyVNCIIapv*8DUo&URNSb
z%;N~iWCM|+e9vHk6v9Kt?F3xMOk@~y4DSbOx|P*ClNSK6s)uz$y9mo7KcUGRR_j)R
z+659-o+{LaXP(=UKx@L(-GNa+7N!}YCZ#z`1A6Ne6_l7V_dQxUdK}zcWL3FZczcAU
z&!_Vct9txljQ#Ddn0f!#!RN=|pELsD!OqN*Oy$)JLjF}hm1HX{J#X|qpXvMeN_|&I
zx=Ldib}u<vzeKJM${$yn_fJW2A5JfZHccMH@Ei{wBGzm9QoeAZLj-?TAeZM+zPxbq
zA%0)T4Hq`&QC;2MOcZK^5(SAhg__rtuTJPZrRGDLQ3ct+=%!FA)>{k2hP!h~VrQzg
zy0m*qK8BF>5nbi>qO8dY-U4W?6_RLxtS3fmKoCA)vaWnZ2m}2coPQI)Lz}>}3k?Sk
zL5Iqy6*e9A5_!ELSKwY(d7{gdifKf+UQ1~RO!_4~Z^Bx3<}fvNiRZ<6EC&bw0dC}=
ATmS$7

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/3_explanation/simulation.doctree b/docs-src/_build/doctrees/3_explanation/simulation.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..6fc20065747320d3337b0a36c8ef1c7699629f03
GIT binary patch
literal 14920
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
K<-Hu|;{OAcA;BpC

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/apidocs/index.doctree b/docs-src/_build/doctrees/apidocs/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..27212d4ff44e7131f7f59178ba501f93435f8654
GIT binary patch
literal 3284
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.doctree b/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..7dc3ce3ced5129caacff3196928b48465401ac96
GIT binary patch
literal 200375
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.duration.doctree b/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.duration.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..063d7f668dd544450c695feacdf351267b969970
GIT binary patch
literal 277563
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
W<>Le%ed2Zb#~btqQBrkZ*Z%{@#0C!l

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.model_actions.doctree b/docs-src/_build/doctrees/apidocs/pymerlin/pymerlin.model_actions.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..773535b0995dcc1d9868bb70044f1f390591e3fc
GIT binary patch
literal 295484
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
OUe)LBv>u%7`Tqs~b`%c)

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/architecture.doctree b/docs-src/_build/doctrees/architecture.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..24fbf8f73ec9fbca67f14ed86a2f3373e0cf636b
GIT binary patch
literal 6500
zcmc&&+m0MZ8Q%4J4>No6I<bl6Lpp*GTkOsd5kUx2B#R3qtn5W(AW>wsYr1QuYPU~R
zRqyN=EWt&jSkw(la{)X9j}eI{;CcA|>f?+(w&O^#<*~b~tNv4c|M4&D|M>jciu+^t
zbtYtTK44*(q#@UZ-3rqnk9lH>uZuf>Egl!QZBMbOPIDFT!meOPAY>FOo)ixXyGPrN
zjP#&7zo~g(WSTU`#k$xKn-7ZHqG#8QG!gH7vO9Mb$Qhi;6)$KXwq3l>&x!xS*Ds4w
zo{fxwyD7wh?fH$kV$E(;QXbojkxY1ToR668Gh>t-<p$c3Hfu7}B>83#F|DzP=k<ie
z<<nM}XYI>~1*eLSX-{r94V%!XLhOrM_g2MC`|<F1nkzjFnT(_!W-2{_B6`TUl6;uW
zVy+;^5F+X$t%4!z=sJkQLR=R+;)YnuM^L&4t=L4dOmyt?S+u&cQWNr|_Dt%PR6VA>
zFS41&snZ9yg)y1_XgGAQ1D3Hs@Ik63j`uKPP~Hq#CLxp&X)=^a$j=AD#L=CK>K8Af
zbZ5}NFCan8Spqo(GhQQD4m*-GADpzJOsCTUtvE66khshnDH%?9f5gp{^8^c}I36q)
zaE%>Fh{Y3jhA-vPz;jGl6s1$$GK3kx6H;*RE*aa?GR~nUfamdKg3I?psc;$5?9iJ^
z=$xCrU}rL!kO>t(l5rMs!nr5$H>o5UI0)VrSM9Y%xkalN6%KKGL%Kb2^H|&h)aVWY
z77lE}Q)=%K>vprcrV`#)+xM2xFS~@8cpE?!@4y#+h~K;Ty@%f&0CfWlawQA<(W~Eh
zk&B;*UjV|8TpZR~Kz>M8fnlkNAC@5jO07G*)GAePtwNu?oI>I^_S#ZSo+Ie$V5x{#
z?P~uyA8$P$#7j@MnqMST*NT@ft={6L^}bT;J?ALT(RruqLrdj+w)(i|TlZGn9iP1(
z?|XHDfAms*+g`z(Q}U(0L|$;z@q#)M4;qO3i%?N{l28PBSVbHD(9?z~L!nLQqdJP^
z+HG=S?C69kZ<sM7h9+%N!T_re+gS6~GDaPv{k;n;gqqC=SyQp78)&v_xoUK_3$1zn
z-6ga<)R1}p3G-}KLBjEO0J{DhrI!l)ug0oxzrZfF>@VEcs`Q`ls?uCInX~kZ@lzY9
z#?N-GX<hbQsu!$xHv>kHo7o5jgPD2h8CPD$)i_l#qpaZypsO#ju~q)RFRwh+E&b{~
zzoBEe&j#+F^)IZf+($x<8PcKQ2{&FkZc{GOAe$He(B*4M@RxCwIe5ZG5%*BW$dGcl
zNzE)HcL1pv6=qZ=dDMt!(nzic{Xd|b<la;uae7&*wFH5~u2qo0qsSX^FGv$DL+lF=
zUDnnfKhKcld05sXI*oaX)ISxeH)RO~L#{`KCevI;v#KzF#Zfl&J60#zuq0Ktif}x$
zRGI2i0O5(;Z>cyr0t*=kPoS!y8YE0}(s~4=jZsd3p5k%pstuh6r`+^|G>-E`24#st
z_bxbt8Xz#`&<_7kU=b=$K(8!eASvPs)<D{^tpg0ikcl?R)#+u?l(1;_2xe1=G)_Z?
z@~SUpRB?HFrVWo#2sxo+HX~!kDeN7}@mL0V1T9k!xKs?*RPqsTgOk4h{bQmNM*i1@
zH%gSb<i7YZe=S)0meO`|aq|75@YMy)UkiR;UEW`P7v#6Gbq-%IP6a#jv9&#57enU}
zMS!Eu?H8=B^`F}Nbe3RsKR`*k-wEnf4(c%8>Gqr*CX4G;gHaPick5b%wK7XAFB6)c
zTO8UqjY4Z!c40nZ)kLAEb3OMu(f~@8dn>kI@8Ka{bK<vZ_kvteNAEZN`%b-5_VIR0
zb7K$*F`zhTCJtkjCdgAE+M?gHC`SWdH(hoE{a%)v;#lk-+uj6m8G$iX1ztke46``H
z%eG2W15pvR&kMUcEbMkEf)Bo@*wC+Da~0uj*Q9|@GXeSvQPv@|nicl)7-W*v@Xp7t
z>@H10l05d$DZLk8**%18nfc^OIH*DJdbz^OPE`BUsrvO?0{p52)u7_o?kG+v$&dIM
zhdD1;^t4g)x^55nxr7xBGr6uep;Zg{D4&4c-jpdSV6j7S7GtG{>j*fhMDoc5HuKTG
zrXh9}wwIgn(T7J`;`zq>N1rQ|Dqo;ukGR4Okf?zv?0#wa4wZFBrLZ>_zATV9`52=P
zyI0a}WvEZznE$YF*j^$XfITf>q6j(_b~j?lBxe&2i-&l>fQglT14DsSg?`90AO~zv
zg1`<NC@scN6BdzS4G6Je_gHRHzg@ByB;d9i=5gjXkc45~f&>~B5-}0ncPkF;bo=d6
zrg<Kw{&`G*x`g^A)!gr%bSMdoe<rmoA-nH~Qd3z4MJg#bYgd8W?LZj~=WwM3i0)R~
z{4we(H{QBRPhf&lh$bYs8=@BC%C|AvYhLfI+5_@8ASamsh>?t?DL%RMp54oM<~Oqq
zQf7x%Mhvo(YuLByW){mDV;>qaxxr6iuh32>0CxJQLvTF?*Rh55qj!J$0qnV_#=!!4
zT4~AuxF!$hWdzw%t_G5uaXsT2(kKh=+cRtgFA9w)?rqtdz+~(<&e<s7V|D?AJh7Mb
zEHUid7jhyZ{D9w!QA*I?(J>l3|BpGmTEkFpxcBnakJ5luroGt|O{KrV%Fcv1eVS)r
zK?71Z^{m3c6QCyzWHJT@s<?2O0tNcVg>5n>>_#aoosmYGrv)Grk9Y_Vo<Rb^xdD$W
z0d}4G9F=?IW0XsA*GYX)4P$}TXk5m$Cw7e|XEYkMTV*tX`vQrW2)copkA`-_5uGq?
zI)G3>mcf7*s0nEhN)y!mDLg1h^TZs{lctgF4;Ht|1m*qQ7}&18|FfUh9gcf06Ro&@
z@@Kfd9zC69o@UieeJ77_j1m=eIcQ~yW#WdtCx61{ruSNXzh;f6hOu47_!;z;u+Ht}
zIo-?Y@iXmoG6TD3iuyNv$mv4H^>H`qqfzx^jH+p|e7=2hfUPHc^iPle*>ER&v;&<M
zZXKN6o+s}6lU%$*D|A5YxZUEL-0pUr!tvM*BwUN`8A6mR6#MFZB_6sf<vySUP85&Q
zsPQwm_05IFW_NFnVz1`v4qcw3??x*Hg3^^mTGba+6Nt<Xh?Ii1gEWfZNzehgdGpr<
zP^^Cqi+ovpiYS9oIpP%t{Thx{GHe3$-12s_?0jQeCP9>k<ckw>i+)HsqzboGAlZJ5
Q4$Ie3jsoRzk&g!d2WxGFYybcN

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/contribute.doctree b/docs-src/_build/doctrees/contribute.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..5a4386a1f658c4e1c2c472a85428963aea0da4db
GIT binary patch
literal 27638
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/developer.doctree b/docs-src/_build/doctrees/developer.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..cd48fcd741a7298f583692abb8731f4e03b91044
GIT binary patch
literal 4319
zcmb7HOK)677PjMb+wHfLIE*GSG(r$Z6T2B;F~evEK>|pz@B#rF#9US1TisRmy;XPW
z5qFOiiCG{en$m2jS+GUoM<DStSRk?Em+;kn^#eP^mRi1b>QvSF&ij1X`u~sH3&o$?
z(mCT|bV!m!$b@R|RuUQ8j0)qw_ILl|ANzgRQRGZZt77Wi0ytvE(?n6>zwmA|up6H0
z!|MF9rm^8tG{;$swb}9)exG$*%W#v@sV#T?0ewVMnR7Ah=Hra2lnWo&!F}};ItpT(
z&-9fqrEBK|vKY^HTqkOTXG^YK$$adt;!^65ZJ)SRVvOQ_Yk)OiTjGfhIF{p-XbmF1
zTY_Ze*GgjZ$)Zo<Q$+`X$GT-hhGEOIE%xHkBHMF+>wT)J(!GT6l<Quu<Ox)vdxR=Z
zdo{QoMAQdb#l56NPSs(Scy^1ev)gRR_5r*DNMxu;&ZbrM+6PiKI_g%ZgQf0u$I{+O
z)2^U2dAro!O}GC{_FumIra4e)5+d}12yE||y%?0mUV?_$%do{O_`QnX9sKSBJ^K?o
z0BW$Zdoz-+^=+C`6F~tJ2b%VPPS}aKq1hC)(m~i^>2Iv%)*g~ar2EF7yAK~6)p%xT
z6Oli>oXA%zksp-Gem2JUfU!RCPGz0@wUECN`bIuBOp5NChkxzDQj8B7RkifzZ%$zR
z^Kvj+6^zfH7e;-cf<Z5|t!tMi^ltH>F!bN2lu*0q#8SKOCJ7JmPSS45`-;HVb>o8<
z>`q|+`*N_C=N#@Iv&PtG7h7kyZ;`dS`-2cf2xKxu%DG#c=Yrjdp#Qs^pevQ2|9xKj
z)CZoF2c7}sra414tAN-(;t3gig5;v@36$?H2c=U%`Sy9C)CYba${!IiRGSiuvO<I^
z5GcAa%(GY~kbbxvq}2-2_s<KdK2SlrIC|KKjYD<}K~tNw3Yy6wcfCs9fO}Ba1yAZM
zJH6fHdu&f7-&I_Xl2at#rQZY56hd~--7ty>ostl-5h~PBQC$|omXU^}{%FCi);u)9
z(grw-ZZozjl-Z~$s_QkSEUs=vQ)7S#J;YAa6bzIUhKj_y_GcuusH#m@(U#Wa*7#$#
zb?iDrDySkxDvw1%f)kJ|$6`%MX&@>c@DXxS&%3o!1k@OD3Wn8cX;q5VhLLd;3U%0p
zC@sjW#@<~U;2I$fo!WfjHbS!^Y!;1>7Bc_DZEAD}c@)bm6jqH3Z<Q39(t;A5al@jz
zS-^YMfvS5rcI%4fQlSEd>h6!OxK&2dX4!H(bi|=WLyXlmQ_Hmy+P6bIw|PcX2m^2^
zN-|J7Fh@)Sq#z#`&{;%9EE8~f*Rf`B@RtM4@qK%CGongK6)_@`6om+G0Bo`GZmZP%
z)Ge*z7Vq}vcIK`)Sy^0IaGT}56B+8$w`Vuz4!iAu0ludhRFndfcN-}YLraDf8c(pk
zf~L}4S2UI?i4vN_bMOo*3iQy9r5FGvG{TeGAz0gO5^H2MA-O9Y?zWNGERPzOgklQ<
zhc_zJs&L^}K`ER)SbsvwHMNP1Mp<yEZ92-OrqT4t!b@TkJ>r^|F1r;aT$6qpfK*a0
z*P(*2TL&18;3(n_mu^&S(SWCAr+G7c;SqF@MQl<LZcAYDHFV!FRk=J`bUPv5;5lLl
zM@)IfjsIx-j@!&>9wAC7qBJfPwjL;b0@*`oxIZvsa{YF%2eLjadzC|}hKQ)$z*z_Y
z&Ir93%wu4V70?e}ef=%yb5jlCx$6UEa{X)d^$1=PT=o==EvIHsyn%$!V<t=SSjUh)
zq9`%UAFa4O_+%C}!Px+aG>SC!Pu;d23qwXxXs1&A;J;T>8C-u|X9R)vFN>(wP}KEe
zT`r?k#-vj1Ud+%=$1r>uZ_sj~LYzLeIi3hJOfi^LY2YcmN5)(X-~&}&xE2zHw*5Ia
zo(11cB`Je3%o(R1E|c|Xf(RZ%0!FF98@n;MP9vIOIEXN9g}hrxy;IFg@YQrs=Cr47
ziHb*IUU4gBHbMBp6S+t@V#7p+s3Apm!mP3bq2O5tGZ->@5~h<d)@+?2f?{cfIS5}m
zj8iYnvvN^%ZcR!?<9+3gH|v%te3liK-8%UIfv?Y*2!8v}be%eRfMcOd0m;rpqKu1T
z{yKRd+jR%$7GJMl##i(3XBRzu&V3g=ZQZpQ<mEtju9i;j<GFK1{S+HEm}5{MckNJ<
zpxVcn9s{xbW<Rr^wCe<d8RszZW6yqms@co<{}Wr+Ze!Zni_;r1N5};G;l`2@a$3z-
z+IgB%^1=EDj;t@!CVmRm8*{{lyEAiRr+&3KbZzE-lqY38lFjb?UDXb{1Z3R8!9r<S
zizUXsV(v%HUA`Y25A?4A{wx16vIhoQ<RMJe8Ua&2*d*Q=@>)YKe146KIJHTLv0-rc
b)g;u0DvgH5$E{{#43s*xXgnT!+dupjP4;Uo

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/documentation.doctree b/docs-src/_build/doctrees/documentation.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..22c36621af8568c2f729d5280ea70efb9491cdbd
GIT binary patch
literal 5057
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/environment.pickle b/docs-src/_build/doctrees/environment.pickle
new file mode 100644
index 0000000000000000000000000000000000000000..3a60cb7d02693c654ee072fc03928bdbd62f2ec5
GIT binary patch
literal 444666
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
Q1#pp$!hEgI)Mrxv4?|mqi~s-t

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/index.doctree b/docs-src/_build/doctrees/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..ba0c03adbfbb833ea128d827e28ee9bfe0cc4104
GIT binary patch
literal 7411
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
TCDo>}v@OCMmCAzxAG-bvZ(zSg

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/install.doctree b/docs-src/_build/doctrees/install.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..73364196b33d8135d72faa2fe90964979c38ffe2
GIT binary patch
literal 2889
zcmZ`*OK%%D5RT(Wviy)O=g|U*(*{MF1dXj6a%g*Kfb>)Z^`U5c3l`Lp5?OP}Eg!Lb
zFwh<X!~kz$|3n}Ep#5+CxVu`(sw-e2ayXplH#7XD^V?Tj*Q#IGwIvs7c0?#unlc;1
z2GzMQm~!!beDZ5NkB>v&kW;I@$yp57z>#wysbMO<j$x44osjmZx!<!acS5W7I`8l<
z@4b$Xc|UZVaFQ(@h2A&HIwECEEa15DJ)0%fi-WhZwxU}S=yZ_}LqBVc<m;i^*mfLl
zNTFCf_G1z@iE~Dby@OB5hjl@1vbUE@Vl9YRcN8h=)duzDVlyWBiD8q(<3rDpX*!C0
zm*0Q2#t*_5qaQ3Yc0`Gg!j4L#e}c<)M3@n5RGt;gz>X12w1?K@BT;*JRM5!p@@;;P
zulq4v?ZY85HKgRr0U736Ir#bUR5SZAX9k*6Xzqk7PMX+2>?n!l2gm$=a-V+$pZNn^
z`vl)Ze2?%wfj|5+eh5Fn%AYQ*VeN&`Ys`&ges`I)BxbV?M<r&xcIyB2wn^eo!!2is
zvXUf}WQg9>Fk2_7<20}kUtJ5Ea~?*q^~vnDFvz`05XjnuZ_g=p;=_hz&IvUIj)yHU
zC#H%hjiLJ^kscXuk=@namEOf;zIz<{Q>K_9PMe4gC4i12MTyOp(b~aOHW9NJ)<!XG
z)h1-ndjf{dX6uc_ZpZ07OCU<8Fr@>V%~=fl6NpjTv8BUzVJ8)g@<leAXj8;@VPJvW
zGRt+5%FsgK-I~HAt0>v2a6Fp>8Ty(F4YH5Jwqd0<E|csHLpZO8O-^LH?Svtl2}IEm
z=k1)S6FQWQ{S@j3r^F~k5gdk*0+c?|k+bAdvQH?)EMqFy6kIX%y_+0<erN^O_bwl1
z%ouGlP85~QAOp$N+{Lh4M}A34r;-xG!OF>s2(H7R7P>HCe)ZnvgO!_MFF63<S&sNf
zI26N<Bx>r(lp)*{`|Idx;ih4^HZ-HGWQszK0A`Lu7nM1Ij|hjLb2RX77!dDtwjhP;
z0$AIjz9_R6kBDkT5GZb=h)e=^D@uj*l==m!w9HeT&5DGkJvJ+~W!du03L?47-Uusd
zyzXXHSTdH$k;cm2yiQPa+i=FBGOD73(4B@Yn+RFAz&mLLC1`C`VKSAZQRI6I?H_rn
zx3AX1FclkMqozQi6oqi{+r39&P_i;ZiJ)Vtyb9QMqKpY_PjwMK<j$4$%h3pAdsLn|
zuGNt?Q<T%~#90{t&djj_>2XNM2Iz+mpFKxB2WFD5h)<M-_)q8JQMn}H^@N!t!Q7<M
zfo?G3u8>gHcVvtbqK?N`8{q(eEV8yTTL&^*CWKssJ$t4cnPpr|xx@$X-jF)se%lrV
zRra$-Nm~T!X0@-knbbLHLVJ*Nbov~LuZs;)u0n|0C%%M=G(@Y(*z|x4phxFIO@M)>
zDeR{%Vf}c8O%w^cQj@w8(*Qh)fJ`xF6y<vc3pisAI&SCSI>}gpsg+^er>0w3J!}Rx
zuqr2YL%Rs;Oub2iG;GwZ1hoq!3PlBK!)1<`DMM?*5FNrOAj{zqfObyP*i7?w_Y@VB
zYp>j4TG=$)KUifIN~}B;!rJrsxWlR*Zx~a5*(+w+e|3=MG51FraqwWcu%r;GdJynG
z>z57hgtcd_zGn-4|6Hl>3Q1RK^kM&!qxHk$>Y)67rFnn*6!*#eV(6yHgBYIU{gR0F
zn!n^PZ0IL~J1ddP^T=ObSpES2FZi|%JIko9Ztvs*wUH79i8UoPuQ^|x&}B-^hcu%K
zim{e$p;WB5R){Tk|B}T1Tx)e{|B`$RA>$&t%I#HI%?aKDXss2J(g4}YwUmG$e86Pw
zeVq^n`g=J4HhzaTfkzb@4&HSZl~F5fJM1O$R!gqHy(LsGJx#?lO}O5qX$Um^GCgm?
RW^raQHKoV%;yn8C(ZAlbf%*Ud

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/license.doctree b/docs-src/_build/doctrees/license.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..6ad0c8ca62bda76455f30c63d93a5fdb1290540e
GIT binary patch
literal 6176
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

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/publishing.doctree b/docs-src/_build/doctrees/publishing.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..0c3ff028e20ca15d36f454f9113f9e992267e424
GIT binary patch
literal 3647
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
a9<G6gF~fl4hQ(Ur-V_!C#!GK!lYat3%8`!%

literal 0
HcmV?d00001

diff --git a/docs-src/_build/doctrees/quickstart.doctree b/docs-src/_build/doctrees/quickstart.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..a7bd5568f84a8c89ac24bbabbebdab1e2b54cfcb
GIT binary patch
literal 6410
zcmb_g+io058Mb4O?eW<;nAIi@on0-l6?-O55bOq639UfdwJ>BAxQRlirn_dU#(moE
zYL5qLrR8F!SSqcA(p+%G6L5)m3t%s~1D=4x1Hf0+UEMunj}tFg8mqgy>OX$}sXlA`
z`af?>=|8!aM2rU~E#kUC=+Y#U3vTG7J`F_nGTZrO_Gz{)n=u(AVH!I$lT+B?Fz&fA
z4YFsMTvgiz_mWm|em<d&;9*c6XAL&T=AUKTtSK9U3y;=5$;HPhca9Q4Vv(s`*fjfu
zo+$1k-#*WBS>_@F&e*#ln|3KGn~`&cgokq0;{nYM(+-h~M2MJoQUT4BCNtbkl+^Q%
zN0J1Kcy0v5&z~0DG^$=Y#5sy-SM5pVydXXGDPwEw_Q5pUlHYCrG@)_Qb_w@*(vIS=
z55<!<p)sfJXz0@za<n00vX{h8`;$`7mhWclCR=8=*i71i!cFKzdNGMu-7@b#VLY)4
zYg+J)15IdRv2b9C(CSfPX|qw+8gRj^=Z5EV>mR@U;#6C6n{CSWCFx{^sUc!piO9AN
z*=<-8g3fzf(3p62F&7Nm+<lv}TBr!US0_Z+*Wn9x2hM&QzjyGvi{B3H%<i#o!@l6j
zb`5`U-jt18r;6f;X!Jsgdo_y2=u0`YD{QWt1-blT0K0k~(J0oK+#Fl1#CY=hiYeeU
z3dJ55zHgOW4}ZwxMC@8VIigmQ#?%^ysl~`KwLT)p#CouAef04UEE2d@G!!fhto;WT
z&m{!{@Q(d4jw3h&+A_}gf0L~=@4UX|$^r9Znm6TAC-pokY(!6$Ybu8zEYuepi1TZB
z%X0~<47aPy^T=XCM9HIeo48>lc<Q$TD%v=j#t6cgdXymC+r})HJ5(wCi_0n9ER-JP
z?!FlKDXe4;#05T%4L;7O{k@-P6jX{227^|Pj8+);kaq@w7ZNuy$|EHy*z7&re{jFF
z!~aO7GR&_oXPCvpFkif`Va$QTFp~pb&gHPm<n*4-CsEC;XTxsr<G`U743kg`g~f^~
zafd||66<LZYR5blDe){C;3*7Lb$qsM5T`PH-SQ9H9`D2?9=4CMzr}>_?O5F~&I7cl
z6J>VZx=?^xF8*EJ!m4PXHc^y96lGJWSwp@#Sz?3zi?&n_{X?DIWZ=p<h=CZ(<h@JS
zLp$d8aLjUn1Ff7+^c!bQRS7j>gUJ|BWkls1L;bAVAAi4#LS_+kD#yt4K@SihqVC^a
zlU(a{Ro7X;C}i}!aG=gPq3<IpKPnx1?-HbI?)|cEZ}zT<`&u<ED$#l6^)L0qlbvPC
z>uO<j%~M<bR^CEPP_1&nh?K8(fMH}D(3C4h2Vr--&^f9j_eR8{(&nb8STvxW@HLkV
zox;D9&Sbsif=7a0N_yyD8wsPHm&xXd?>$N)qI%keD5mJ;j;Y4wKecskAFP9{5xgol
z`yVjs9OZCP<|<0CZWd6t9fwjE^|&*%;xq_=kQ^CkVZOr2((wJp^wiYrJ6VDMdf{ZF
z!oNyLJ;-y!Lu=2m-r{}~#sWP>-miYAd}=vL(J&R;J8zY4_$o(@kNVf3!zJC+pTU{_
zEdD9%8qaK=>zU^tc5}BBUPyLT#=UEj`nf%`^59dEiZJHHd$zrAo9CpxZ==IjsiA1H
zckYxS{@%Hq{{Go-UdgKp`2O2t9%WN<Iii6Jj`j(XYArU3;@^~WJkYaEE#WU1iA|(b
z3l(}EjPV)`m2Ekz8Om9Ih*pe_b>#i~>h#V2UP%PK`R#)#%vTfJZe5++&?h{|4)qHL
zJlHdnw=S}ArppNmDrUcGUc$Hrdx&8~v;O-KLN2M&cM^Hr;UaqhWc2ST*=`@anPa}R
zt<G)JcP_B{t8-XE)1-pxfLyM}en!kNb7s9Z+$=&!GXoT(NR41!=Zf6u>KHLhqIy!A
zQOV&#kC^$G?aJ#SCP9)9I5rxR9@1YvA2&pZ(I-2Yl8a^!b@7_2@SB#aP8zG}+b(DA
zWwVmc+;Sl)f+mw2YC6|916}k?0?>wge@46%!?ppioI`?%Qjs09HQ=O21B{o5Mg<y|
zU}_h{kMOb-hoOL|w98M>*|jsdl#77rAvnT@#o{%MJ-n@m(6QD0uD;?<qXC)YVJ5G3
zK_&<Vt$lnUSJaFhq`rNEF3rzg$khaw29d2wI}Rowcr#zY7@=2e)d<+;4gvg%1I4An
zp<IrsN~^X<k15P~MJ_Vpm9GuCK~FfWD2PZCv#B8)F72c}uv;CFSk(^fKtt+dr3rU9
zRH>xo;{j}DqxTC{x<D~YMR)Jry@ccW*62r@#&H<i3_XfRV|YM`>L3u;a?97KG&Ge=
zZjF5zBhi1UVsJI5TghNf-x~cec37?}9e}-r!9<=ezbmFX!{RQ=@fF-G$!jrn!q~N4
zs*)nuaKPqJ&N*Swg_^JkcMTxeoLnVH;&!zpuW-O^#ZCRlE+GlS>IDuo#sTpZ!8N_2
z!LGbtEky}U-OxsxfL-fIHy9D@`bmuvN7%<a;W=d2Y?mjb<54J5NI7pp1!1=gWfD}B
z{9*y9DYn^N?m;<RMQy4lFhMh-E+60<Ma_lFmv9AFz8*}=4Ha)dPS67oJ?<kB{%HNK
zT#aaCtL&%;1EmaVN(8h+b`=`(4b!D#d1PwI<PEh`3xJ(AMrXK3=<bL{d+*%;ChWNy
zcbzfvYNaCo4MQHmOB7^}Xx!pdbc>nPX{&Jv;oB6XgD7$Z%MKRg7BK1CWpI`X*m;9?
zD%X=?AjpZ$c#nDb0l%|esGz@`__#W>KS>eQ2@G{jzvr(udQ4K7cFSS7WOLy7Jl<es
zZ9<$rN~7#lUu5dr$s!G$0zIL_gDx;o<b|s$Q6y<+Y#aB{S%MeIgHc^S9%X=x-=Qud
zcnAp?MeRG4HyrFbvMK7KXXDCM<y|fHMsdvtta{x%r=7|fjF0LXQ!eD$1mO!La<mAD
z4PoaMRpVv@LIGK51r%yrb!n+?JJ$w?ASX-%v8SFAb-DVr@vS`IW7oCv%C{bxZbChl
z4cwOq{PP;Pvy4dXMz8-TRh&_#pvguhk<SBtE!+PyK9{}e^nJq_PbK5OO=5fwy$P&S
zd38kd{GRt*EA{^fcIS%vSA0m7JG$n$ZdlZ%@~7xh)MEa;-S1*+-%<a5uKqpMC!1=A
zYGky3^qy1w{WN8FAd5c0mi2D-IF&2)kkC9<(DLZ~p~5g<QJK%|%h6C@$@d|*AcXu*
z=#^2Xw_YDxEO$3YC^ijOedy{4ecc{sNJ%%wX%%14OCT?67^(ua<Y0CNet}d}=J^j4
zJhA=~7W_Q>7&!));mB6Fl1~s;Im0qNk1Q{h%Q`Zac;I-ct0J+dlIfzWDoBxRReK~C
QRex(IUfNTZOFOOq0{c2)&j0`b

literal 0
HcmV?d00001

diff --git a/docs-src/_templates/custom-class-template.rst b/docs-src/_templates/custom-class-template.rst
new file mode 100644
index 0000000..6c9ea84
--- /dev/null
+++ b/docs-src/_templates/custom-class-template.rst
@@ -0,0 +1,32 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:                                    <-- add at least this line
+   :show-inheritance:                           <-- plus I want to show inheritance...
+   :inherited-members:                          <-- ...and inherited members too
+
+   {% block methods %}
+   .. automethod:: __init__
+
+   {% if methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   .. autosummary::
+   {% for item in methods %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
diff --git a/docs-src/_templates/custom-module-template.rst b/docs-src/_templates/custom-module-template.rst
new file mode 100644
index 0000000..0b9c4e2
--- /dev/null
+++ b/docs-src/_templates/custom-module-template.rst
@@ -0,0 +1,66 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Module Attributes
+
+   .. autosummary::
+      :toctree:                                          <-- add this line
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   .. autosummary::
+      :toctree:                                          <-- add this line
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: {{ _('Classes') }}
+
+   .. autosummary::
+      :toctree:                                          <-- add this line
+      :template: custom-class-template.rst               <-- add this line
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autosummary::
+      :toctree:                                          <-- add this line
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+{% block modules %}
+{% if modules %}
+.. rubric:: Modules
+
+.. autosummary::
+   :toctree:
+   :template: custom-module-template.rst                 <-- add this line
+   :recursive:
+{% for item in modules %}
+   {{ item }}
+{%- endfor %}
+{% endif %}
+{% endblock %}
diff --git a/docs-src/apidocs/index.rst b/docs-src/apidocs/index.rst
new file mode 100644
index 0000000..bce112e
--- /dev/null
+++ b/docs-src/apidocs/index.rst
@@ -0,0 +1,10 @@
+
+API Reference
+=============
+
+Here, you can find the details of functions, classes, and data structures provided by the `pymerlin` package.
+
+.. toctree::
+   :titlesonly:
+
+   pymerlin/pymerlin
\ No newline at end of file
diff --git a/docs-src/apidocs/pymerlin/pymerlin.duration.rst b/docs-src/apidocs/pymerlin/pymerlin.duration.rst
new file mode 100644
index 0000000..a3cb82f
--- /dev/null
+++ b/docs-src/apidocs/pymerlin/pymerlin.duration.rst
@@ -0,0 +1,216 @@
+:py:mod:`pymerlin.duration`
+===========================
+
+.. py:module:: pymerlin.duration
+
+.. autodoc2-docstring:: pymerlin.duration
+   :parser: myst
+   :allowtitles:
+
+Module Contents
+---------------
+
+Classes
+~~~~~~~
+
+.. list-table::
+   :class: autosummary longtable
+   :align: left
+
+   * - :py:obj:`Duration <pymerlin.duration.Duration>`
+     - .. autodoc2-docstring:: pymerlin.duration.Duration
+          :parser: myst
+          :summary:
+
+Data
+~~~~
+
+.. list-table::
+   :class: autosummary longtable
+   :align: left
+
+   * - :py:obj:`ZERO <pymerlin.duration.ZERO>`
+     - .. autodoc2-docstring:: pymerlin.duration.ZERO
+          :parser: myst
+          :summary:
+   * - :py:obj:`MICROSECOND <pymerlin.duration.MICROSECOND>`
+     - .. autodoc2-docstring:: pymerlin.duration.MICROSECOND
+          :parser: myst
+          :summary:
+   * - :py:obj:`MICROSECONDS <pymerlin.duration.MICROSECONDS>`
+     - .. autodoc2-docstring:: pymerlin.duration.MICROSECONDS
+          :parser: myst
+          :summary:
+   * - :py:obj:`MILLISECOND <pymerlin.duration.MILLISECOND>`
+     - .. autodoc2-docstring:: pymerlin.duration.MILLISECOND
+          :parser: myst
+          :summary:
+   * - :py:obj:`MILLISECONDS <pymerlin.duration.MILLISECONDS>`
+     - .. autodoc2-docstring:: pymerlin.duration.MILLISECONDS
+          :parser: myst
+          :summary:
+   * - :py:obj:`SECOND <pymerlin.duration.SECOND>`
+     - .. autodoc2-docstring:: pymerlin.duration.SECOND
+          :parser: myst
+          :summary:
+   * - :py:obj:`SECONDS <pymerlin.duration.SECONDS>`
+     - .. autodoc2-docstring:: pymerlin.duration.SECONDS
+          :parser: myst
+          :summary:
+   * - :py:obj:`MINUTE <pymerlin.duration.MINUTE>`
+     - .. autodoc2-docstring:: pymerlin.duration.MINUTE
+          :parser: myst
+          :summary:
+   * - :py:obj:`MINUTES <pymerlin.duration.MINUTES>`
+     - .. autodoc2-docstring:: pymerlin.duration.MINUTES
+          :parser: myst
+          :summary:
+   * - :py:obj:`HOUR <pymerlin.duration.HOUR>`
+     - .. autodoc2-docstring:: pymerlin.duration.HOUR
+          :parser: myst
+          :summary:
+   * - :py:obj:`HOURS <pymerlin.duration.HOURS>`
+     - .. autodoc2-docstring:: pymerlin.duration.HOURS
+          :parser: myst
+          :summary:
+
+API
+~~~
+
+.. py:class:: Duration(micros)
+   :canonical: pymerlin.duration.Duration
+
+   .. autodoc2-docstring:: pymerlin.duration.Duration
+      :parser: myst
+
+   .. rubric:: Initialization
+
+   .. autodoc2-docstring:: pymerlin.duration.Duration.__init__
+      :parser: myst
+
+   .. py:method:: times(scalar)
+      :canonical: pymerlin.duration.Duration.times
+
+      .. autodoc2-docstring:: pymerlin.duration.Duration.times
+         :parser: myst
+
+   .. py:method:: plus(other)
+      :canonical: pymerlin.duration.Duration.plus
+
+      .. autodoc2-docstring:: pymerlin.duration.Duration.plus
+         :parser: myst
+
+   .. py:method:: negate()
+      :canonical: pymerlin.duration.Duration.negate
+
+      .. autodoc2-docstring:: pymerlin.duration.Duration.negate
+         :parser: myst
+
+   .. py:method:: of(scalar, unit)
+      :canonical: pymerlin.duration.Duration.of
+      :staticmethod:
+
+      .. autodoc2-docstring:: pymerlin.duration.Duration.of
+         :parser: myst
+
+   .. py:method:: from_string(duration_string)
+      :canonical: pymerlin.duration.Duration.from_string
+      :staticmethod:
+
+      .. autodoc2-docstring:: pymerlin.duration.Duration.from_string
+         :parser: myst
+
+   .. py:method:: __repr__()
+      :canonical: pymerlin.duration.Duration.__repr__
+
+   .. py:method:: __eq__(other)
+      :canonical: pymerlin.duration.Duration.__eq__
+
+   .. py:method:: __gt__(other)
+      :canonical: pymerlin.duration.Duration.__gt__
+
+   .. py:method:: __ge__(other)
+      :canonical: pymerlin.duration.Duration.__ge__
+
+   .. py:method:: __lt__(other)
+      :canonical: pymerlin.duration.Duration.__lt__
+
+   .. py:method:: __le__(other)
+      :canonical: pymerlin.duration.Duration.__le__
+
+.. py:data:: ZERO
+   :canonical: pymerlin.duration.ZERO
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.ZERO
+      :parser: myst
+
+.. py:data:: MICROSECOND
+   :canonical: pymerlin.duration.MICROSECOND
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MICROSECOND
+      :parser: myst
+
+.. py:data:: MICROSECONDS
+   :canonical: pymerlin.duration.MICROSECONDS
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MICROSECONDS
+      :parser: myst
+
+.. py:data:: MILLISECOND
+   :canonical: pymerlin.duration.MILLISECOND
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MILLISECOND
+      :parser: myst
+
+.. py:data:: MILLISECONDS
+   :canonical: pymerlin.duration.MILLISECONDS
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MILLISECONDS
+      :parser: myst
+
+.. py:data:: SECOND
+   :canonical: pymerlin.duration.SECOND
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.SECOND
+      :parser: myst
+
+.. py:data:: SECONDS
+   :canonical: pymerlin.duration.SECONDS
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.SECONDS
+      :parser: myst
+
+.. py:data:: MINUTE
+   :canonical: pymerlin.duration.MINUTE
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MINUTE
+      :parser: myst
+
+.. py:data:: MINUTES
+   :canonical: pymerlin.duration.MINUTES
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.MINUTES
+      :parser: myst
+
+.. py:data:: HOUR
+   :canonical: pymerlin.duration.HOUR
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.HOUR
+      :parser: myst
+
+.. py:data:: HOURS
+   :canonical: pymerlin.duration.HOURS
+   :value: None
+
+   .. autodoc2-docstring:: pymerlin.duration.HOURS
+      :parser: myst
diff --git a/docs-src/apidocs/pymerlin/pymerlin.model_actions.rst b/docs-src/apidocs/pymerlin/pymerlin.model_actions.rst
new file mode 100644
index 0000000..dc82197
--- /dev/null
+++ b/docs-src/apidocs/pymerlin/pymerlin.model_actions.rst
@@ -0,0 +1,76 @@
+:py:mod:`pymerlin.model_actions`
+================================
+
+.. py:module:: pymerlin.model_actions
+
+.. autodoc2-docstring:: pymerlin.model_actions
+   :parser: myst
+   :allowtitles:
+
+Module Contents
+---------------
+
+Functions
+~~~~~~~~~
+
+.. list-table::
+   :class: autosummary longtable
+   :align: left
+
+   * - :py:obj:`delay <pymerlin.model_actions.delay>`
+     - .. autodoc2-docstring:: pymerlin.model_actions.delay
+          :parser: myst
+          :summary:
+   * - :py:obj:`spawn <pymerlin.model_actions.spawn>`
+     - .. autodoc2-docstring:: pymerlin.model_actions.spawn
+          :parser: myst
+          :summary:
+   * - :py:obj:`call <pymerlin.model_actions.call>`
+     - .. autodoc2-docstring:: pymerlin.model_actions.call
+          :parser: myst
+          :summary:
+   * - :py:obj:`wait_until <pymerlin.model_actions.wait_until>`
+     - .. autodoc2-docstring:: pymerlin.model_actions.wait_until
+          :parser: myst
+          :summary:
+   * - :py:obj:`_yield_with <pymerlin.model_actions._yield_with>`
+     - .. autodoc2-docstring:: pymerlin.model_actions._yield_with
+          :parser: myst
+          :summary:
+
+API
+~~~
+
+.. py:function:: delay(duration)
+   :canonical: pymerlin.model_actions.delay
+   :async:
+
+   .. autodoc2-docstring:: pymerlin.model_actions.delay
+      :parser: myst
+
+.. py:function:: spawn(child)
+   :canonical: pymerlin.model_actions.spawn
+
+   .. autodoc2-docstring:: pymerlin.model_actions.spawn
+      :parser: myst
+
+.. py:function:: call(child)
+   :canonical: pymerlin.model_actions.call
+   :async:
+
+   .. autodoc2-docstring:: pymerlin.model_actions.call
+      :parser: myst
+
+.. py:function:: wait_until(condition)
+   :canonical: pymerlin.model_actions.wait_until
+   :async:
+
+   .. autodoc2-docstring:: pymerlin.model_actions.wait_until
+      :parser: myst
+
+.. py:function:: _yield_with(status)
+   :canonical: pymerlin.model_actions._yield_with
+   :async:
+
+   .. autodoc2-docstring:: pymerlin.model_actions._yield_with
+      :parser: myst
diff --git a/docs-src/apidocs/pymerlin/pymerlin.rst b/docs-src/apidocs/pymerlin/pymerlin.rst
new file mode 100644
index 0000000..e00ad00
--- /dev/null
+++ b/docs-src/apidocs/pymerlin/pymerlin.rst
@@ -0,0 +1,42 @@
+:py:mod:`pymerlin`
+==================
+
+.. py:module:: pymerlin
+
+.. autodoc2-docstring:: pymerlin
+   :parser: myst
+   :allowtitles:
+
+Submodules
+----------
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   pymerlin.duration
+   pymerlin.model_actions
+
+Package Contents
+----------------
+
+Functions
+~~~~~~~~~
+
+.. list-table::
+   :class: autosummary longtable
+   :align: left
+
+   * - :py:obj:`checkout <pymerlin.checkout>`
+     - .. autodoc2-docstring:: pymerlin.checkout
+          :parser: myst
+          :summary:
+
+API
+~~~
+
+.. py:function:: checkout()
+   :canonical: pymerlin.checkout
+
+   .. autodoc2-docstring:: pymerlin.checkout
+      :parser: myst
diff --git a/docs-src/architecture.md b/docs-src/architecture.md
new file mode 100644
index 0000000..a4ef72c
--- /dev/null
+++ b/docs-src/architecture.md
@@ -0,0 +1,16 @@
+# Architecture
+
+pymerlin is to merlin as [pyspark](https://spark.apache.org/docs/latest/api/python/index.html) is to [spark](https://spark.apache.org/).
+This means that pymerlin uses [py4j](https://www.py4j.org/) as a bridge
+between a python process and a java process. This allows pymerlin to use the Aerie simulation engine directly, without
+having to re-implement it in python.
+
+This means that running `simulate` starts a subprocess using `java -jar /path/to/pymerlin.jar`.
+
+## Approachability over performance
+
+The main tenet of pymerlin is approachability, and its aim is to enable rapid prototyping of models and activities.
+While where possible, performance will be considered, it is expected that someone who wants to seriously engineer the
+performance of their simulation will port their code to Java - which has the double benefit of removing socket
+communication overhead, as well as giving the engineer a single Java process to instrument and analyze, rather than a
+hybrid system, which may be more difficult to characterize.
\ No newline at end of file
diff --git a/docs-src/conf.py b/docs-src/conf.py
new file mode 100644
index 0000000..7e47c2b
--- /dev/null
+++ b/docs-src/conf.py
@@ -0,0 +1,64 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'pymerlin'
+copyright = '2024, California Institute of Technology'
+author = 'Matthew Dailis'
+
+# Keep project version synchronized with pyproject.toml
+import os, tomllib
+with open(os.path.join(os.path.dirname(__file__), "../pyproject.toml"), "rb") as f:
+    release = tomllib.load(f)["project"]["version"]
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('..'))  # Source code dir relative to this file
+
+extensions = [
+    "autodoc2",
+    'myst_parser',
+    # 'sphinx.ext.autodoc',  # Core library for html generation from docstrings
+    # 'sphinx.ext.autosummary',  # Create neat summary tables
+]
+
+autodoc2_packages = [
+    "../pymerlin",
+]
+
+autodoc2_docstring_parser_regexes = [
+    # this will render all docstrings as Markdown
+    (r".*", "myst"),
+]
+
+myst_enable_extensions = ["colon_fence"]
+
+autodoc2_index_template = """
+API Reference
+=============
+
+Here, you can find the details of functions, classes, and data structures provided by the `pymerlin` package.
+
+.. toctree::
+   :titlesonly:
+{% for package in top_level %}
+   {{ package }}
+{%- endfor %}
+"""
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'furo'
+html_static_path = ['_static']
diff --git a/docs-src/contribute.md b/docs-src/contribute.md
new file mode 100644
index 0000000..9a18da8
--- /dev/null
+++ b/docs-src/contribute.md
@@ -0,0 +1,114 @@
+# Contributing
+
+We would love for you to contribute to pymerlin and help make it even better than it is today! As a contributor, here are the guidelines we would like you to follow:
+
+- [Question or Problem?](#question)
+- [Building pymerlin](#building)
+- [Pull Request Guidelines](#pr-guidelines)
+- [Good Commit, PR, and Code Review Practices](#best-practices)
+- [Submitting a Pull Request](#submit-pr)
+
+(question)=
+## Got a Question or Problem?
+
+If you would like to chat about the question in real-time, you can reach out via [the Aerie users Slack channel](https://join.slack.com/t/nasa-ammos/shared_invite/zt-1mlgmk5c2-MgqVSyKzVRUWrXy87FNqPw).
+
+(building)=
+## Building pymerlin
+
+To build and develop pymerlin please read through the [developer documentation](./developer.md).
+
+(pr-guidelines)=
+## Pull Request Guidelines
+
+Here are some general Pull Request (PR) guidelines for the pymerlin project:
+
+- Every PR should include a summary of changes that gives reviewers an idea of what they should pay attention to.
+- PR branches should have as "clean" of a history as possible.
+- Each commit should present one change or idea to a reviewer.
+- Commits that merely "fix up" previous commits should be interactively rebased and squashed into their targets.
+- Prefer the use of `git rebase` over `git merge`:
+
+  - `git rebase` actually _rebases_ your branch from the current development branch's endpoint. This localizes conflicts to the commits at which they actually appear, though it can become complicated when there are more than a few conflicts.
+  - `git merge` pulls in all the updates that your branch does not have, and combines them with the updates you have made in a single merge commit. This allows you to deal with any and all conflicts at once, but information such as when conflicts originated is lost.
+
+  For more info on `git merge` vs `git rebase` see [here](https://www.atlassian.com/git/tutorials/merging-vs-rebasing).
+
+- Before merging a PR, the following requirements must be met. These requirements ensure that history is effectively linear, which aids readability and makes `git bisect` more useful and easier to reason about.
+  - At least one (preferably two) reviewers have approved the PR.
+  - No outstanding review comments have been left unresolved.
+  - The branch passes continuous integration.
+  - The branch has been rebased onto the current `develop` branch.
+- The "Squash and merge" and "Rebase and merge" buttons on GitHub's PR interface should not be used. Always use the "Merge" strategy.
+  - In combination with the restrictions above, this ensures that features are neatly bracketed by merge commits on either side, making a clear hierarchical separation between features added to `develop` and the work that went into each feature.
+
+(best-practices)=
+## Good Commit, PR, and Code Review Practices
+
+The pymerlin project relies on the ability to effectively query the Git history. Please read through the following resources before contributing:
+
+- [How to write a good commit message](https://chris.beams.io/posts/git-commit/)
+- [Telling Stories Through Your Commits](https://blog.mocoso.co.uk/talks/2015/01/12/telling-stories-through-your-commits/)
+- [How to Make Your Code Reviewer Fall in Love with You](https://mtlynch.io/code-review-love/)
+
+(submit-pr)=
+## Submitting a Pull Request
+
+Please follow these instructions when submitting a Pull Request:
+
+1. Search [GitHub](https://github.com/NASA-AMMOS/pymerlin/pulls) for an open or closed PR that relates to your submission. You don't want to duplicate effort.
+1. Be sure that an issue describes the problem you're fixing, or documents the design for the feature you'd like to add. Discussing the design up front helps to ensure that we're ready to accept your work.
+1. Clone the [pymerlin repo](https://github.com/NASA-AMMOS/pymerlin).
+1. Make your changes in a new git branch:
+
+   ```sh
+   git checkout develop
+   git pull origin develop
+   git checkout -b my-fix-branch develop
+   ```
+
+1. Create your patch.
+1. Commit your changes using a descriptive commit message that follows our [commit conventions](#best-practices).
+
+   ```sh
+   git commit -a
+   ```
+
+   Note: the optional commit `-a` command line option will automatically "add" and "rm" edited files.
+
+1. Push your branch to GitHub:
+
+   ```sh
+   git push origin my-fix-branch
+   ```
+
+1. In GitHub, send a pull request to `pymerlin:develop`.
+1. If we suggest changes then:
+
+- Make the required updates.
+- [Rebase your branch](https://dev.to/maxwell_dev/the-git-rebase-introduction-i-wish-id-had) and force push to your branch to GitHub (this will update your Pull Request):
+
+  ```sh
+  git rebase develop -i
+  git push -f
+  ```
+
+After your pull request is merged, you can safely delete your branch and pull the changes from the repository:
+
+- Check out the develop branch:
+
+  ```shell
+  git checkout develop
+  ```
+
+- Update your develop with the latest version:
+
+  ```shell
+  git pull origin develop
+  ```
+
+- Delete the local branch:
+
+  ```shell
+  git branch -D my-fix-branch
+  ```
diff --git a/docs-src/developer.md b/docs-src/developer.md
new file mode 100644
index 0000000..93bb2de
--- /dev/null
+++ b/docs-src/developer.md
@@ -0,0 +1,10 @@
+# Developing pymerlin
+
+For pymerlin development, you'll need:
+- Java 21 JDK
+- python 3.9 or higher
+
+Additional libraries:
+- build (for packaging)
+- twine (for publishing)
+- pytest (for running tests)
\ No newline at end of file
diff --git a/docs-src/documentation.md b/docs-src/documentation.md
new file mode 100644
index 0000000..5bdd255
--- /dev/null
+++ b/docs-src/documentation.md
@@ -0,0 +1,15 @@
+# Documentation
+
+Contributions to this documentation are welcome!
+
+This documentation lives in the `docs` directory, and is built
+by running the following:
+
+```shell
+cd docs
+make clean html
+```
+
+This documentation is built using [sphinx](https://www.sphinx-doc.org/en/master/) with the [MyST](https://mystmd.org/)
+plugin, using the [Furo](https://pradyunsg.me/furo/) theme. Python docstrings are automatically parsed and included in
+this documentation using the [sphinx-autodoc2](https://sphinx-autodoc2.readthedocs.io) extension.
\ No newline at end of file
diff --git a/docs-src/index.md b/docs-src/index.md
new file mode 100644
index 0000000..97a98fc
--- /dev/null
+++ b/docs-src/index.md
@@ -0,0 +1,56 @@
+---
+hide-toc: true
+---
+
+# pymerlin 0.0.2
+
+pymerlin is a discrete event simulation framework, built for use in the [Aerie](https://github.com/NASA-AMMOS/aerie>) ecosystem.
+
+To learn more about Aerie, read the [Aerie Docs](https://nasa-ammos.github.io/aerie-docs).
+
+Ready to get started? Check out the [Quickstart](./quickstart.md) guide.
+
+```{include} ../README.md
+:start-after: <!-- start elevator-pitch -->
+:end-before: <!-- end elevator-pitch -->
+```
+
+## Source code
+
+You can access the source code at: [https://github.com/mattdailis/pymerlin](https://github.com/mattdailis/pymerlin).
+
+## How to get help, contribute, or provide feedback
+
+See our [feedback and contribution submission guidelines](contribute.md).
+
+```{toctree}
+:hidden:
+
+quickstart
+1_tutorials/index
+2_guides/index
+3_explanation/index
+apidocs/index
+```
+
+```{toctree}
+:caption: Development
+:hidden:
+
+architecture
+developer
+contribute
+install
+license
+publishing
+documentation
+```
+
+<!-- Autosummary:
+```{autosummary}
+:toctree: _autosummary
+:template: custom-module-template.rst
+:recursive:
+
+pymerlin
+```-->
\ No newline at end of file
diff --git a/docs-src/install.md b/docs-src/install.md
new file mode 100644
index 0000000..6f0fefb
--- /dev/null
+++ b/docs-src/install.md
@@ -0,0 +1,3 @@
+# Install
+
+content goes here
\ No newline at end of file
diff --git a/docs-src/license.md b/docs-src/license.md
new file mode 100644
index 0000000..4ace915
--- /dev/null
+++ b/docs-src/license.md
@@ -0,0 +1,4 @@
+# License
+
+```{include} ../LICENSE
+```
\ No newline at end of file
diff --git a/docs-src/make.bat b/docs-src/make.bat
new file mode 100644
index 0000000..32bb245
--- /dev/null
+++ b/docs-src/make.bat
@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd
diff --git a/docs-src/publishing.md b/docs-src/publishing.md
new file mode 100644
index 0000000..57718af
--- /dev/null
+++ b/docs-src/publishing.md
@@ -0,0 +1,11 @@
+# Publishing to pypi
+
+Make sure your `.pypirc` file exists and includes your pypi API key.
+
+Run these commands from the root of the repository
+
+```shell
+rm -rf dist
+python3 -m build     
+python3 -m twine upload dist/*
+```
\ No newline at end of file
diff --git a/docs-src/quickstart.md b/docs-src/quickstart.md
new file mode 100644
index 0000000..95903fb
--- /dev/null
+++ b/docs-src/quickstart.md
@@ -0,0 +1,26 @@
+# Quickstart
+
+This section describes how to get started with `pymerlin` 🎉
+
+## Installation
+
+First, make sure you have Java 21 JRE and python 12 installed on your machine.
+
+- Java: https://adoptium.net/temurin/releases/
+- Python: https://www.python.org/downloads/release/python-3120/
+
+Once those are ready, make a [python virtual environment](https://docs.python.org/3/library/venv.html) for your project
+
+After activating that environment, install `pymerlin` with the following command:
+
+```shell
+pip install pymerlin
+```
+
+Check that the installation succeeded by running:
+
+```shell
+python3 -c "import pymerlin; pymerlin.checkout()"
+```
+
+If that succeeds, you're ready to get started with the [tutorial](1_tutorials/1_gettingstarted)!
\ No newline at end of file
diff --git a/docs/.buildinfo b/docs/.buildinfo
index 883d31b..c4683e9 100644
--- a/docs/.buildinfo
+++ b/docs/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: c0ce92a8bf45021a353da59fd8b4c33f
+config: be4e0b5eaac5574ce1216b1e91665780
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/1_tutorials/1_gettingstarted.html b/docs/1_tutorials/1_gettingstarted.html
index 13d5ab1..18f46de 100644
--- a/docs/1_tutorials/1_gettingstarted.html
+++ b/docs/1_tutorials/1_gettingstarted.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Going further" href="tutorial2.html" /><link rel="prev" title="Tutorials" href="index.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Getting Started - pymerlin 0.0.2 documentation</title>
+        <title>Getting Started - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -295,8 +295,16 @@
         <article role="main" id="furo-main-content">
           <section id="getting-started">
 <h1>Getting Started<a class="headerlink" href="#getting-started" title="Link to this heading">¶</a></h1>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>This page is under construction. Please bear with us as we port our <a class="reference external" href="https://nasa-ammos.github.io/aerie-docs/tutorials/mission-modeling/introduction/">Java tutorial</a> to python.</p>
+</div>
 <p>Welcome Aerie modeling padawans! For your training today, you will be learning the basics of mission modeling in Aerie by building your own simple model of an on-board spacecraft solid state recorder (SSR). This model will track the recording rate into the recorder from a couple instruments along with the integrated data volume over time. Through the process of building this model, you’ll learn about the fundamental objects of a model, activities and resources, and their structure. You’ll be introduced to the different categories of resources and learn how you define and implement each along with restrictions on when you can/can’t modify them. As a bonus, we will also cover how you can make your resources “unit aware” to prevent those pesky issues that come along with performing unit conversions and how you can test your model without having to pull your model into an Aerie deployment.</p>
 <p>Let the training begin!</p>
+<section id="installing-pymerlin">
+<h2>Installing pymerlin<a class="headerlink" href="#installing-pymerlin" title="Link to this heading">¶</a></h2>
+<p>If you haven’t already, go to the <a class="reference internal" href="../quickstart.html"><span class="std std-doc">quickstart</span></a> guide to get set up with pymerlin.</p>
+</section>
 <section id="creating-a-mission-model">
 <h2>Creating a Mission Model<a class="headerlink" href="#creating-a-mission-model" title="Link to this heading">¶</a></h2>
 <p>Start by creating a <code class="docutils literal notranslate"><span class="pre">mission.py</span></code> file with the following contents:</p>
@@ -334,9 +342,10 @@ <h2>Your First Resource<a class="headerlink" href="#your-first-resource" title="
 <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="bp">self</span><span class="o">.</span><span class="n">recording_rate</span> <span class="o">=</span> <span class="n">registrar</span><span class="o">.</span><span class="n">cell</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="o">//</span> <span class="n">Megabits</span><span class="o">/</span><span class="n">s</span>
 </pre></div>
 </div>
-<blockquote>
-<div><p>Tip: As you are coding, take advantage of your IDE to auto import the modeling framework classes you need like <code class="docutils literal notranslate"><span class="pre">MutableResource</span></code>.</p>
-</div></blockquote>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>As you are coding, take advantage of your IDE to auto import the modeling framework classes you need like <code class="docutils literal notranslate"><span class="pre">MutableResource</span></code>.</p>
+</div>
 <p>Let’s tease apart this line of code and use it as an opportunity to provide a brief overview of the various types of resources available to you as a modeler. The mission modeling framework provides two primary classes from which to define resources:</p>
 <ol class="arabic simple">
 <li><p><code class="docutils literal notranslate"><span class="pre">MutableResource</span></code> - resource whose value can be explicitly updated by activities or other modeling code after it has been defined. Updates to the resource take the form of “Effects” such as <code class="docutils literal notranslate"><span class="pre">increase</span></code>, <code class="docutils literal notranslate"><span class="pre">decrease</span></code>, or <code class="docutils literal notranslate"><span class="pre">set</span></code>. The values of this category of resource are explicitly tracked in objects called “Cells” within Aerie, which you can read about in detail in the <a class="reference external" href="https://ammos.nasa.gov/aerie-docs/overview/software-design-document/#cells">Aerie Software Design Document</a> if you are interested.</p></li>
@@ -350,9 +359,9 @@ <h2>Your First Resource<a class="headerlink" href="#your-first-resource" title="
 <li><p><code class="docutils literal notranslate"><span class="pre">Clock</span></code> - special resource type to provide “stopwatch” like functionality that allows you to track the time since an event occurred.</p></li>
 </ul>
 <p>TODO: Add more content on <code class="docutils literal notranslate"><span class="pre">Clock</span></code></p>
-<p>:::info</p>
+<div class="info docutils">
 <p>Polynomial resources currently cannot be rendered in the Aerie UI and must be transformed to a linear resource (an example of this is shown later in the tutorial)</p>
-<p>:::</p>
+</div>
 <p>Looking back at our resource declaration, you can see that <code class="docutils literal notranslate"><span class="pre">RecordingRate</span></code> is a <code class="docutils literal notranslate"><span class="pre">MutableResource</span></code> (we will emit effects on this resource in our first activity) of the type <code class="docutils literal notranslate"><span class="pre">Discrete&lt;Double&gt;</span></code>, so the value of the resource will stay constant until the next time we compute effects on it.</p>
 <p>Next, we must define and initialize our <code class="docutils literal notranslate"><span class="pre">RecordingRate</span></code> resource, which we can do in a class constructor that takes one parameter we’ll called <code class="docutils literal notranslate"><span class="pre">registrar</span></code> of type <code class="docutils literal notranslate"><span class="pre">Registrar</span></code>. You can think of the <code class="docutils literal notranslate"><span class="pre">Registrar</span></code> class as your link to what will ultimately get exposed in the UI and in a second we will use this class to register <code class="docutils literal notranslate"><span class="pre">RecordingRate</span></code>. But first, let’s add the following line to the constructor we just made to fully define our resource.</p>
 <p>Both the <code class="docutils literal notranslate"><span class="pre">MutableResource</span></code> and <code class="docutils literal notranslate"><span class="pre">Discrete</span></code> classes have static helper functions for initializing resources of their type. If you included those functions via <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">static</span></code> statements, you get the simple line above. The <code class="docutils literal notranslate"><span class="pre">discrete()</span></code> function expects an initial value for the resource, which we have specified as <code class="docutils literal notranslate"><span class="pre">0.0</span></code>.</p>
@@ -461,6 +470,7 @@ <h2>Your First Resource<a class="headerlink" href="#your-first-resource" title="
           <div class="toc-tree">
             <ul>
 <li><a class="reference internal" href="#">Getting Started</a><ul>
+<li><a class="reference internal" href="#installing-pymerlin">Installing pymerlin</a></li>
 <li><a class="reference internal" href="#creating-a-mission-model">Creating a Mission Model</a></li>
 <li><a class="reference internal" href="#your-first-resource">Your First Resource</a></li>
 </ul>
@@ -474,7 +484,7 @@ <h2>Your First Resource<a class="headerlink" href="#your-first-resource" title="
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/1_tutorials/index.html b/docs/1_tutorials/index.html
index 6e258f4..e2a396b 100644
--- a/docs/1_tutorials/index.html
+++ b/docs/1_tutorials/index.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Getting Started" href="1_gettingstarted.html" /><link rel="prev" title="Quickstart" href="../quickstart.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Tutorials - pymerlin 0.0.2 documentation</title>
+        <title>Tutorials - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -298,6 +298,7 @@ <h1>Tutorials<a class="headerlink" href="#tutorials" title="Link to this heading
 <div class="toctree-wrapper compound">
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="1_gettingstarted.html">Getting Started</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="1_gettingstarted.html#installing-pymerlin">Installing pymerlin</a></li>
 <li class="toctree-l2"><a class="reference internal" href="1_gettingstarted.html#creating-a-mission-model">Creating a Mission Model</a></li>
 <li class="toctree-l2"><a class="reference internal" href="1_gettingstarted.html#your-first-resource">Your First Resource</a></li>
 </ul>
@@ -356,7 +357,7 @@ <h1>Tutorials<a class="headerlink" href="#tutorials" title="Link to this heading
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/1_tutorials/tutorial2.html b/docs/1_tutorials/tutorial2.html
index 937b54f..de997df 100644
--- a/docs/1_tutorials/tutorial2.html
+++ b/docs/1_tutorials/tutorial2.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Guides" href="../2_guides/index.html" /><link rel="prev" title="Getting Started" href="1_gettingstarted.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Going further - pymerlin 0.0.2 documentation</title>
+        <title>Going further - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>Going further<a class="headerlink" href="#going-further" title="Link to this
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/datamodel.html b/docs/2_guides/datamodel.html
index e39f54f..3941b71 100644
--- a/docs/2_guides/datamodel.html
+++ b/docs/2_guides/datamodel.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Modeling Power" href="powermodel.html" /><link rel="prev" title="How to use pymerlin in Jupyter" href="jupyter.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Modeling Data Volume - pymerlin 0.0.2 documentation</title>
+        <title>Modeling Data Volume - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>Modeling Data Volume<a class="headerlink" href="#modeling-data-volume" title
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/index.html b/docs/2_guides/index.html
index 414073a..188ae6d 100644
--- a/docs/2_guides/index.html
+++ b/docs/2_guides/index.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to use pymerlin in Jupyter" href="jupyter.html" /><link rel="prev" title="Going further" href="../1_tutorials/tutorial2.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Guides - pymerlin 0.0.2 documentation</title>
+        <title>Guides - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -348,7 +348,7 @@ <h1>Guides<a class="headerlink" href="#guides" title="Link to this heading">¶</
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/jupyter.html b/docs/2_guides/jupyter.html
index 635b871..1cf872a 100644
--- a/docs/2_guides/jupyter.html
+++ b/docs/2_guides/jupyter.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Modeling Data Volume" href="datamodel.html" /><link rel="prev" title="Guides" href="index.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>How to use pymerlin in Jupyter - pymerlin 0.0.2 documentation</title>
+        <title>How to use pymerlin in Jupyter - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>How to use pymerlin in Jupyter<a class="headerlink" href="#how-to-use-pymerl
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/powermodel.html b/docs/2_guides/powermodel.html
index 366bde8..0afe3a9 100644
--- a/docs/2_guides/powermodel.html
+++ b/docs/2_guides/powermodel.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Modeling Telecom" href="telecom.html" /><link rel="prev" title="Modeling Data Volume" href="datamodel.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Modeling Power - pymerlin 0.0.2 documentation</title>
+        <title>Modeling Power - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>Modeling Power<a class="headerlink" href="#modeling-power" title="Link to th
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/scheduling.html b/docs/2_guides/scheduling.html
index fbeed8f..b3be96f 100644
--- a/docs/2_guides/scheduling.html
+++ b/docs/2_guides/scheduling.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Using spice for geometry" href="spice.html" /><link rel="prev" title="Modeling Telecom" href="telecom.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Scheduling - pymerlin 0.0.2 documentation</title>
+        <title>Scheduling - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -349,7 +349,7 @@ <h1>Scheduling<a class="headerlink" href="#scheduling" title="Link to this headi
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/spice.html b/docs/2_guides/spice.html
index 0a7df36..c104a45 100644
--- a/docs/2_guides/spice.html
+++ b/docs/2_guides/spice.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Background" href="../3_explanation/index.html" /><link rel="prev" title="Scheduling" href="scheduling.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Using spice for geometry - pymerlin 0.0.2 documentation</title>
+        <title>Using spice for geometry - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -348,7 +348,7 @@ <h1>Using spice for geometry<a class="headerlink" href="#using-spice-for-geometr
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/2_guides/telecom.html b/docs/2_guides/telecom.html
index 05a0b8c..18db43d 100644
--- a/docs/2_guides/telecom.html
+++ b/docs/2_guides/telecom.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Scheduling" href="scheduling.html" /><link rel="prev" title="Modeling Power" href="powermodel.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Modeling Telecom - pymerlin 0.0.2 documentation</title>
+        <title>Modeling Telecom - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -353,7 +353,7 @@ <h1>Modeling Telecom<a class="headerlink" href="#modeling-telecom" title="Link t
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/co-simulation.html b/docs/3_explanation/co-simulation.html
index 7b0091a..3d62fc2 100644
--- a/docs/3_explanation/co-simulation.html
+++ b/docs/3_explanation/co-simulation.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="API Reference" href="../apidocs/index.html" /><link rel="prev" title="Command Errors" href="command-errors.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Co-Simulation - pymerlin 0.0.2 documentation</title>
+        <title>Co-Simulation - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -374,7 +374,7 @@ <h2>Further Reading<a class="headerlink" href="#further-reading" title="Link to
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/command-errors.html b/docs/3_explanation/command-errors.html
index cf14838..65aac96 100644
--- a/docs/3_explanation/command-errors.html
+++ b/docs/3_explanation/command-errors.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Co-Simulation" href="co-simulation.html" /><link rel="prev" title="Tuning Fidelity" href="fidelity.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Command Errors - pymerlin 0.0.2 documentation</title>
+        <title>Command Errors - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -480,7 +480,7 @@ <h2>How do you guarantee the safety of an autonomous spacecraft?<a class="header
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/fidelity.html b/docs/3_explanation/fidelity.html
index c158810..1ad7e9a 100644
--- a/docs/3_explanation/fidelity.html
+++ b/docs/3_explanation/fidelity.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Command Errors" href="command-errors.html" /><link rel="prev" title="Planning and Scheduling" href="planning.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Tuning Fidelity - pymerlin 0.0.2 documentation</title>
+        <title>Tuning Fidelity - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -360,7 +360,7 @@ <h1>Tuning Fidelity<a class="headerlink" href="#tuning-fidelity" title="Link to
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/index.html b/docs/3_explanation/index.html
index d74c96e..271c415 100644
--- a/docs/3_explanation/index.html
+++ b/docs/3_explanation/index.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Discrete Event Simulation" href="simulation.html" /><link rel="prev" title="Using spice for geometry" href="../2_guides/spice.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Background - pymerlin 0.0.2 documentation</title>
+        <title>Background - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -371,7 +371,7 @@ <h1>Background<a class="headerlink" href="#background" title="Link to this headi
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/planning.html b/docs/3_explanation/planning.html
index a5027da..8ed770f 100644
--- a/docs/3_explanation/planning.html
+++ b/docs/3_explanation/planning.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Tuning Fidelity" href="fidelity.html" /><link rel="prev" title="Discrete Event Simulation" href="simulation.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Planning and Scheduling - pymerlin 0.0.2 documentation</title>
+        <title>Planning and Scheduling - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>Planning and Scheduling<a class="headerlink" href="#planning-and-scheduling"
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/3_explanation/simulation.html b/docs/3_explanation/simulation.html
index 21db388..1773262 100644
--- a/docs/3_explanation/simulation.html
+++ b/docs/3_explanation/simulation.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Planning and Scheduling" href="planning.html" /><link rel="prev" title="Background" href="index.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Discrete Event Simulation - pymerlin 0.0.2 documentation</title>
+        <title>Discrete Event Simulation - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -401,7 +401,7 @@ <h2>The Theory<a class="headerlink" href="#the-theory" title="Link to this headi
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/_sources/1_tutorials/1_gettingstarted.md.txt b/docs/_sources/1_tutorials/1_gettingstarted.md.txt
index 57cbb6b..49701d8 100644
--- a/docs/_sources/1_tutorials/1_gettingstarted.md.txt
+++ b/docs/_sources/1_tutorials/1_gettingstarted.md.txt
@@ -1,9 +1,16 @@
 # Getting Started
 
+:::{warning}
+This page is under construction. Please bear with us as we port our [Java tutorial](https://nasa-ammos.github.io/aerie-docs/tutorials/mission-modeling/introduction/) to python.
+:::
+
 Welcome Aerie modeling padawans! For your training today, you will be learning the basics of mission modeling in Aerie by building your own simple model of an on-board spacecraft solid state recorder (SSR). This model will track the recording rate into the recorder from a couple instruments along with the integrated data volume over time. Through the process of building this model, you'll learn about the fundamental objects of a model, activities and resources, and their structure. You'll be introduced to the different categories of resources and learn how you define and implement each along with restrictions on when you can/can't modify them. As a bonus, we will also cover how you can make your resources "unit aware" to prevent those pesky issues that come along with performing unit conversions and how you can test your model without having to pull your model into an Aerie deployment.
 
 Let the training begin!
 
+## Installing pymerlin
+If you haven't already, go to the [quickstart](../quickstart.md) guide to get set up with pymerlin.
+
 ## Creating a Mission Model
 
 Start by creating a `mission.py` file with the following contents:
@@ -46,7 +53,9 @@ In the `DataModel` class, declare the `RecordingRate` resource with the followin
 self.recording_rate = registrar.cell(0); // Megabits/s
 ```
 
-> Tip: As you are coding, take advantage of your IDE to auto import the modeling framework classes you need like `MutableResource`.
+:::{tip}
+As you are coding, take advantage of your IDE to auto import the modeling framework classes you need like `MutableResource`.
+:::
 
 Let's tease apart this line of code and use it as an opportunity to provide a brief overview of the various types of resources available to you as a modeler. The mission modeling framework provides two primary classes from which to define resources:
 
diff --git a/docs/_sources/apidocs/pymerlin/pymerlin.rst.txt b/docs/_sources/apidocs/pymerlin/pymerlin.rst.txt
index 057d486..e00ad00 100644
--- a/docs/_sources/apidocs/pymerlin/pymerlin.rst.txt
+++ b/docs/_sources/apidocs/pymerlin/pymerlin.rst.txt
@@ -16,3 +16,27 @@ Submodules
 
    pymerlin.duration
    pymerlin.model_actions
+
+Package Contents
+----------------
+
+Functions
+~~~~~~~~~
+
+.. list-table::
+   :class: autosummary longtable
+   :align: left
+
+   * - :py:obj:`checkout <pymerlin.checkout>`
+     - .. autodoc2-docstring:: pymerlin.checkout
+          :parser: myst
+          :summary:
+
+API
+~~~
+
+.. py:function:: checkout()
+   :canonical: pymerlin.checkout
+
+   .. autodoc2-docstring:: pymerlin.checkout
+      :parser: myst
diff --git a/docs/_sources/publishing.md.txt b/docs/_sources/publishing.md.txt
index 01634b8..57718af 100644
--- a/docs/_sources/publishing.md.txt
+++ b/docs/_sources/publishing.md.txt
@@ -2,8 +2,9 @@
 
 Make sure your `.pypirc` file exists and includes your pypi API key.
 
+Run these commands from the root of the repository
+
 ```shell
-cd pymerlin
 rm -rf dist
 python3 -m build     
 python3 -m twine upload dist/*
diff --git a/docs/_sources/quickstart.md.txt b/docs/_sources/quickstart.md.txt
index 0d96777..95903fb 100644
--- a/docs/_sources/quickstart.md.txt
+++ b/docs/_sources/quickstart.md.txt
@@ -17,4 +17,10 @@ After activating that environment, install `pymerlin` with the following command
 pip install pymerlin
 ```
 
+Check that the installation succeeded by running:
 
+```shell
+python3 -c "import pymerlin; pymerlin.checkout()"
+```
+
+If that succeeds, you're ready to get started with the [tutorial](1_tutorials/1_gettingstarted)!
\ No newline at end of file
diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
index b15f8b4..efced5b 100644
--- a/docs/_static/documentation_options.js
+++ b/docs/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '0.0.2',
+    VERSION: '0.0.4-rc',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/docs/apidocs/index.html b/docs/apidocs/index.html
index 4291c0b..49e30a3 100644
--- a/docs/apidocs/index.html
+++ b/docs/apidocs/index.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="pymerlin" href="pymerlin/pymerlin.html" /><link rel="prev" title="Co-Simulation" href="../3_explanation/co-simulation.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>API Reference - pymerlin 0.0.2 documentation</title>
+        <title>API Reference - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -356,7 +356,7 @@ <h1>API Reference<a class="headerlink" href="#api-reference" title="Link to this
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../_static/documentation_options.js?v=126c459f"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/apidocs/pymerlin/pymerlin.duration.html b/docs/apidocs/pymerlin/pymerlin.duration.html
index a0e3efd..eca863c 100644
--- a/docs/apidocs/pymerlin/pymerlin.duration.html
+++ b/docs/apidocs/pymerlin/pymerlin.duration.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" /><link rel="next" title="pymerlin.model_actions" href="pymerlin.model_actions.html" /><link rel="prev" title="pymerlin" href="pymerlin.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>pymerlin.duration - pymerlin 0.0.2 documentation</title>
+        <title>pymerlin.duration - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -636,7 +636,7 @@ <h3>API<a class="headerlink" href="#api" title="Link to this heading">¶</a></h3
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../../_static/documentation_options.js?v=126c459f"></script>
     <script src="../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/apidocs/pymerlin/pymerlin.html b/docs/apidocs/pymerlin/pymerlin.html
index 08ea1fd..23c006a 100644
--- a/docs/apidocs/pymerlin/pymerlin.html
+++ b/docs/apidocs/pymerlin/pymerlin.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" /><link rel="next" title="pymerlin.duration" href="pymerlin.duration.html" /><link rel="prev" title="API Reference" href="../index.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>pymerlin - pymerlin 0.0.2 documentation</title>
+        <title>pymerlin - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -305,6 +305,30 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Link to this headi
 </ul>
 </div>
 </section>
+<section id="package-contents">
+<h2>Package Contents<a class="headerlink" href="#package-contents" title="Link to this heading">¶</a></h2>
+<section id="functions">
+<h3>Functions<a class="headerlink" href="#functions" title="Link to this heading">¶</a></h3>
+<div class="table-wrapper autosummary longtable docutils container">
+<table class="autosummary longtable docutils align-left">
+<tbody>
+<tr class="row-odd"><td><p><a class="reference internal" href="#pymerlin.checkout" title="pymerlin.checkout"><code class="xref py py-obj docutils literal notranslate"><span class="pre">checkout</span></code></a></p></td>
+<td><p>Check that your pymerlin installation was successful</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</section>
+<section id="api">
+<h3>API<a class="headerlink" href="#api" title="Link to this heading">¶</a></h3>
+<dl class="py function">
+<dt class="sig sig-object py" id="pymerlin.checkout">
+<span class="sig-prename descclassname"><span class="pre">pymerlin.</span></span><span class="sig-name descname"><span class="pre">checkout</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#pymerlin.checkout" title="Link to this definition">¶</a></dt>
+<dd><p>Check that your pymerlin installation was successful</p>
+</dd></dl>
+
+</section>
+</section>
 </section>
 
         </article>
@@ -364,6 +388,14 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Link to this headi
             <ul>
 <li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">pymerlin</span></code></a><ul>
 <li><a class="reference internal" href="#submodules">Submodules</a></li>
+<li><a class="reference internal" href="#package-contents">Package Contents</a><ul>
+<li><a class="reference internal" href="#functions">Functions</a></li>
+<li><a class="reference internal" href="#api">API</a><ul>
+<li><a class="reference internal" href="#pymerlin.checkout"><code class="docutils literal notranslate"><span class="pre">checkout()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
 </ul>
 </li>
 </ul>
@@ -375,7 +407,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Link to this headi
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../../_static/documentation_options.js?v=126c459f"></script>
     <script src="../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/apidocs/pymerlin/pymerlin.model_actions.html b/docs/apidocs/pymerlin/pymerlin.model_actions.html
index 268d20d..1b4cf67 100644
--- a/docs/apidocs/pymerlin/pymerlin.model_actions.html
+++ b/docs/apidocs/pymerlin/pymerlin.model_actions.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" /><link rel="next" title="Architecture" href="../../architecture.html" /><link rel="prev" title="pymerlin.duration" href="pymerlin.duration.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>pymerlin.model_actions - pymerlin 0.0.2 documentation</title>
+        <title>pymerlin.model_actions - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="../../index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -437,7 +437,7 @@ <h3>API<a class="headerlink" href="#api" title="Link to this heading">¶</a></h3
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="../../_static/documentation_options.js?v=126c459f"></script>
     <script src="../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/architecture.html b/docs/architecture.html
index 7ea6397..7220463 100644
--- a/docs/architecture.html
+++ b/docs/architecture.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Developing pymerlin" href="developer.html" /><link rel="prev" title="pymerlin.model_actions" href="apidocs/pymerlin/pymerlin.model_actions.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Architecture - pymerlin 0.0.2 documentation</title>
+        <title>Architecture - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -378,7 +378,7 @@ <h2>Approachability over performance<a class="headerlink" href="#approachability
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/contribute.html b/docs/contribute.html
index 17188a9..dd77f1e 100644
--- a/docs/contribute.html
+++ b/docs/contribute.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Install" href="install.html" /><link rel="prev" title="Developing pymerlin" href="developer.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Contributing - pymerlin 0.0.2 documentation</title>
+        <title>Contributing - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -481,7 +481,7 @@ <h1>Contributing<a class="headerlink" href="#contributing" title="Link to this h
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/developer.html b/docs/developer.html
index fd20257..c2f5156 100644
--- a/docs/developer.html
+++ b/docs/developer.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Contributing" href="contribute.html" /><link rel="prev" title="Architecture" href="architecture.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Developing pymerlin - pymerlin 0.0.2 documentation</title>
+        <title>Developing pymerlin - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -357,7 +357,7 @@ <h1>Developing pymerlin<a class="headerlink" href="#developing-pymerlin" title="
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/documentation.html b/docs/documentation.html
index 4e95bbd..0f9f6e3 100644
--- a/docs/documentation.html
+++ b/docs/documentation.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="prev" title="Publishing to pypi" href="publishing.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Documentation - pymerlin 0.0.2 documentation</title>
+        <title>Documentation - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -348,7 +348,7 @@ <h1>Documentation<a class="headerlink" href="#documentation" title="Link to this
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/genindex.html b/docs/genindex.html
index c180f01..473b2a4 100644
--- a/docs/genindex.html
+++ b/docs/genindex.html
@@ -4,7 +4,7 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
 
-    <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 --><title>Index - pymerlin 0.0.2 documentation</title>
+    <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 --><title>Index - pymerlin 0.0.4-rc documentation</title>
 <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -177,7 +177,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -201,7 +201,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -319,6 +319,10 @@ <h2>C</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li><a href="apidocs/pymerlin/pymerlin.model_actions.html#pymerlin.model_actions.call">call() (in module pymerlin.model_actions)</a>
+</li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="apidocs/pymerlin/pymerlin.html#pymerlin.checkout">checkout() (in module pymerlin)</a>
 </li>
     </ul></td>
   </tr></table>
@@ -526,7 +530,7 @@ <h2>Z</h2>
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/index.html b/docs/index.html
index f90a183..0d77648 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Quickstart" href="quickstart.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>pymerlin 0.0.2 documentation</title>
+        <title>pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="#"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="#"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="#">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -359,7 +359,7 @@ <h2>How to get help, contribute, or provide feedback<a class="headerlink" href="
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/install.html b/docs/install.html
index 8cfadd1..a7e77e4 100644
--- a/docs/install.html
+++ b/docs/install.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="License" href="license.html" /><link rel="prev" title="Contributing" href="contribute.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Install - pymerlin 0.0.2 documentation</title>
+        <title>Install - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,7 +347,7 @@ <h1>Install<a class="headerlink" href="#install" title="Link to this heading">¶
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/license.html b/docs/license.html
index 0467fba..280073f 100644
--- a/docs/license.html
+++ b/docs/license.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Publishing to pypi" href="publishing.html" /><link rel="prev" title="Install" href="install.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>License - pymerlin 0.0.2 documentation</title>
+        <title>License - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -363,7 +363,7 @@ <h1>License<a class="headerlink" href="#license" title="Link to this heading">¶
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/objects.inv b/docs/objects.inv
index 1f650f25529d7aaee4aa443b33ee666ac2c45a85..551218b30ad82ba1533f1a5568b1736348f38fd0 100644
GIT binary patch
delta 1003
zcmV<H0~Gwo2-paadw)6*fbaSh1p1Cuws-5LXcM>1L)xfz(!;w5v^2KaP^8KwuKs<w
zXrnDJKqWv2YL<^fa>yaessKR=LuK`@;JK!Nt`IIs&NF#g*2=bVu~7wm<L%;qP#m?2
zYy;T~*UEBMnq`V`hOSSM0z|F_c5df|(wHBPskON4ku!>=JbxNl2tH1{NK^QgrY>Yq
z8=j9zUc+Q$H5Hjo7BihJW&x#`hP@KJNTm{lt*5{<SYriKkojr~YDu-6f~!aYV}idt
zKF=*K#|n=ETZ~5gdVf2AT+D7Czuis295c{|hx^e3ZJA>R`tA8?HZpF!@J61(v1jl9
z+5GWuVWxHiO@FbwGsrWmf8cZY3J{v56#<&3TcS2+-%|!UI?_XiDV+#y+PIpCEla#*
z6S23Ls8lmW{(54rQ>7Ib1XFo=ZEi<OnYt<!77B7CRsPQ4P<)M!**O~e>}6=-g#nqc
z9DX0dIi+VjHNwEVY26$mv<7t~+{UreLTx}qH|biF9Dn4c-A-;6`j~yKXMD9yi@CF#
z@CT>5fDW}co={VV;Ut~YPhD0D#GqTP^NwHm7AcOjwAYaODPg|<yiErz`4+_C5q0XF
zAthGPVWfFym|bo)LzqtOF^l%UhbTz~!`@co9iOG^!kMnPKx^RUZXv1;qkuxji$PGW
z+ZoD}mw!h8rtrI@n7QNdGUKr%g{J<2(xV+Q^Wa+^FIv$awJ0#lV-SK1c?{dPYq(B^
zW=^&PUJ*MQRUJk)7R@eUcI=;O;SOytHwV<7^ATq+Yr!?kcM!J4cJg7^!h@2=-VU*s
zAED1VOR~EjcSL3a%zb?J3QVEi+B7HK-f#njr+<7%?$I1pAb@2M9Xun4D8rBJc3(!P
zi}QKZpp>IMadhUveqLw$wEzw4A}q2EQIIJug8ki>*K^#HL`#q=E`_CJ;De%gY0fF*
znsH_xZ%eJ9sY0K*d0*HaLeyK7%-^~+x;1f_MSCT%MM*=7mYUGK$;>0jkBwcsP@PSG
z9Dh5Wrq}x4rf&|fKzSJ+*{!fnQ2!frWh_m#U}|sq14ZrM7e#AeT|T$NYoy-e-ZrDX
zwC`E8`FwS8b#Y@%O`WDRG<Ko}=zbz<W|+xfdTNokd+<Mz$&i5{%PMXZ?HO$^oIc!A
z#O@q7QJv0*M4M>m@JpL4@>SHiMWtR+B4jr^2U91l52Mb?6w$IONz{w&M9@iP9=j}z
z-Nn(Y<k2)%2&3<fwW)B4;7ba{dxId^i@PoLBk!cX^Y86{B*E^mutzVei?G)xcny)%
ZOS5y#b~_c|!Wp_t8V)8o`U3)@mz(r7?G*q3

delta 987
zcmV<110?*|2*?PKdw)0-fbaSh1g6KzS?1PDF-<&e25F<(Ne{gUwDfFqN|7p;xcc|y
zqFwR=R04FM-tzI0eB>kZA_GAQLwWHo<Ef^At`W{j$`g5&m&&@a*sF~G<?X^ZC=6;v
zss&brU&^V>&jT0tEpkG!l<4MS@M+>Aj^Sq<yO2Tcc{(L|2Y<7X)m&scTg-H}m<8lw
z9`;u7ES5?TwwnXbV22gVLFU^zs5#Yg4z3~@ObPz<^s=(J6e~OlY&{w6^TXZhX}!FA
z`f@)9bIL#;A0H+Uv}R5j=$Du0<;1w@!kc&sr=Gp<%hl7L!c6T38so&O<%QM1<8%B9
z&^3z-0yK>eM1SpVH(Sk|;$++-9i8YQ!IaK~Hf>zY#FjZeu$kBgOjN9yB7ZzFH?h)+
z3xcV<x-qvSrA%Fw3JV1(k}7>?a45V%r|cXJee^Q4_QDRCuoQkB!#SmAJXgYwch$N*
zMyL(SNVtt-tA*Nw2yWw@CMn1(yPe!Dv@t`iXMDCzi+{PdoA4W_I)er^7*AJIhT$ZQ
z)Bidz6o^r`Qs*5%@dHvEX=$$^<vYN9|9P7RnDYaO<0ER+y&*+b(O_h<2eZqqW(?D)
zJ!W11w-7l=VBFhkyyJ^>T{zP%7ib6E+$}`WU=&bDcs2?ub-kfHdui}@48L-UnL7@z
z5*|vDX@BY;C@tCvGY`Jw;kp(Ls9A<t8iEj9$Wz$1UBz`Wv~;o_cuVYPRB;?xSya1(
z*|Gmy3VXCcZjPuu=L1fD>;%^=?ICQ7_3~ld!h@p9-VU*qA6=hImZZNP_e3TF%zb?M
z3QVEa+EgdqV7MKHr~DH=pcQOE081b^dPa^>#(&@1^}Y<w7w5~Uol=el;^4xA{j$!6
zwE&Il0xXg}QIIGtI{UjVFXy-=2{s^Am<vluzz0R~#+*~eHQ~%W-Zol6RfRrs^S-b<
zgs8VDTD^5?bZ6o)i}p(3fTD^NY&4;1m6<1yA1b?gp&Fa^IC`F@*Ye+{ZwjwKdEPy;
zYky&xp#Hbhm9aF{f~mpscNC?6TNLboHThf*uabI?2ipt=Y2UJ_^Z9yly|^`|rcP7Z
zHFly3=zaofW|+y&^pqlR_vn8DlOZEP=0#X3>NDD2IDNRe2;DhuqB@@skv7q;;HNfO
z<g2K23v#`oMDBYBQzI=8qsGb<(Y(k>&{T@;Owdtb9=og?yNjb*$&+cU5Jq1sYg6GO
z!8a7L_Xa_dAMUo)j=Yij&cD|Gfdsq5x;=VXS%kel!aE40-k6<Zw%fS?*Ur#g(r{;z
JgWnE}e(N|!={f)a

diff --git a/docs/publishing.html b/docs/publishing.html
index a8560e9..bd5374b 100644
--- a/docs/publishing.html
+++ b/docs/publishing.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Documentation" href="documentation.html" /><link rel="prev" title="License" href="license.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Publishing to pypi - pymerlin 0.0.2 documentation</title>
+        <title>Publishing to pypi - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -296,8 +296,8 @@
           <section id="publishing-to-pypi">
 <h1>Publishing to pypi<a class="headerlink" href="#publishing-to-pypi" title="Link to this heading">¶</a></h1>
 <p>Make sure your <code class="docutils literal notranslate"><span class="pre">.pypirc</span></code> file exists and includes your pypi API key.</p>
-<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span><span class="w"> </span>pymerlin
-rm<span class="w"> </span>-rf<span class="w"> </span>dist
+<p>Run these commands from the root of the repository</p>
+<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>rm<span class="w"> </span>-rf<span class="w"> </span>dist
 python3<span class="w"> </span>-m<span class="w"> </span>build<span class="w">     </span>
 python3<span class="w"> </span>-m<span class="w"> </span>twine<span class="w"> </span>upload<span class="w"> </span>dist/*
 </pre></div>
@@ -353,7 +353,7 @@ <h1>Publishing to pypi<a class="headerlink" href="#publishing-to-pypi" title="Li
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/py-modindex.html b/docs/py-modindex.html
index d35f267..fdf2f63 100644
--- a/docs/py-modindex.html
+++ b/docs/py-modindex.html
@@ -4,7 +4,7 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" />
 
-    <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 --><title>Python Module Index - pymerlin 0.0.2 documentation</title>
+    <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 --><title>Python Module Index - pymerlin 0.0.4-rc documentation</title>
 <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -177,7 +177,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -201,7 +201,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -349,7 +349,7 @@ <h1>Python Module Index</h1>
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/quickstart.html b/docs/quickstart.html
index 639dcf2..bad3165 100644
--- a/docs/quickstart.html
+++ b/docs/quickstart.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Tutorials" href="1_tutorials/index.html" /><link rel="prev" title="pymerlin 0.0.2" href="index.html" />
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
-        <title>Quickstart - pymerlin 0.0.2 documentation</title>
+        <title>Quickstart - pymerlin 0.0.4-rc documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -308,6 +308,11 @@ <h2>Installation<a class="headerlink" href="#installation" title="Link to this h
 <div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span>pymerlin
 </pre></div>
 </div>
+<p>Check that the installation succeeded by running:</p>
+<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>-c<span class="w"> </span><span class="s2">&quot;import pymerlin; pymerlin.checkout()&quot;</span>
+</pre></div>
+</div>
+<p>If that succeeds, you’re ready to get started with the <a class="reference internal" href="1_tutorials/1_gettingstarted.html"><span class="doc std std-doc">tutorial</span></a>!</p>
 </section>
 </section>
 
@@ -379,7 +384,7 @@ <h2>Installation<a class="headerlink" href="#installation" title="Link to this h
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/search.html b/docs/search.html
index 8eb90f0..a568575 100644
--- a/docs/search.html
+++ b/docs/search.html
@@ -7,7 +7,7 @@
 
     <!-- Generated with Sphinx 7.3.7 and Furo 2024.05.06 -->
 <meta name="robots" content="noindex" />
-<title>Search - pymerlin 0.0.2 documentation</title><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+<title>Search - pymerlin 0.0.4-rc documentation</title><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=387cc868" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=36a5483c" />
     
@@ -179,7 +179,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">pymerlin 0.0.2 documentation</div></a>
+      <a href="index.html"><div class="brand">pymerlin 0.0.4-rc documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -203,7 +203,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">pymerlin 0.0.2 documentation</span>
+  <span class="sidebar-brand-text">pymerlin 0.0.4-rc documentation</span>
   
 </a><form class="sidebar-search-container" method="get" action="#" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -330,7 +330,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=e3a6060d"></script>
+</div><script src="_static/documentation_options.js?v=126c459f"></script>
     <script src="_static/doctools.js?v=9a2dae69"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=4e2eecee"></script>
diff --git a/docs/searchindex.js b/docs/searchindex.js
index 7789045..97fe253 100644
--- a/docs/searchindex.js
+++ b/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"API": [[18, "api"], [19, "api"]], "API Reference": [[16, "api-reference"]], "Activity Planning": [[11, "activity-planning"]], "Approachability over performance": [[20, "approachability-over-performance"]], "Architecture": [[20, "architecture"]], "Avoiding Command Errors": [[11, "avoiding-command-errors"]], "Background": [[13, "background"]], "Building pymerlin": [[21, "building-pymerlin"]], "Classes": [[18, "classes"]], "Co-Simulation": [[10, "co-simulation"]], "Command Errors": [[11, "command-errors"]], "Contributing": [[21, "contributing"]], "Creating a Mission Model": [[0, "creating-a-mission-model"]], "Data": [[18, "data"]], "Developing pymerlin": [[22, "developing-pymerlin"]], "Discrete Event Simulation": [[15, "discrete-event-simulation"]], "Documentation": [[23, "documentation"]], "Functions": [[19, "functions"]], "Further Reading": [[10, "further-reading"]], "Getting Started": [[0, "getting-started"]], "Going further": [[2, "going-further"]], "Good Commit, PR, and Code Review Practices": [[21, "good-commit-pr-and-code-review-practices"]], "Got a Question or Problem?": [[21, "got-a-question-or-problem"]], "Guides": [[4, "guides"]], "How do you guarantee the safety of an autonomous spacecraft?": [[11, "how-do-you-guarantee-the-safety-of-an-autonomous-spacecraft"]], "How to get help, contribute, or provide feedback": [[24, "how-to-get-help-contribute-or-provide-feedback"]], "How to use pymerlin in Jupyter": [[5, "how-to-use-pymerlin-in-jupyter"]], "Install": [[25, "install"]], "Installation": [[28, "installation"]], "Integrated vs Partial validation": [[11, "integrated-vs-partial-validation"]], "License": [[26, "license"]], "Making changes to command files": [[11, "making-changes-to-command-files"]], "Methods of Validation": [[11, "methods-of-validation"]], "Modeling Data Volume": [[3, "modeling-data-volume"]], "Modeling Power": [[6, "modeling-power"]], "Modeling Telecom": [[9, "modeling-telecom"]], "Module Contents": [[18, "module-contents"], [19, "module-contents"]], "Planning and Scheduling": [[14, "planning-and-scheduling"]], "Publishing to pypi": [[27, "publishing-to-pypi"]], "Pull Request Guidelines": [[21, "pull-request-guidelines"]], "Quickstart": [[28, "quickstart"]], "Re-usable command files": [[11, "re-usable-command-files"]], "Scheduling": [[7, "scheduling"]], "Source code": [[24, "source-code"]], "Submitting a Pull Request": [[21, "submitting-a-pull-request"]], "Submodules": [[17, "submodules"]], "The Theory": [[15, "the-theory"]], "Tuning Fidelity": [[12, "tuning-fidelity"]], "Tutorials": [[1, "tutorials"]], "Using spice for geometry": [[8, "using-spice-for-geometry"]], "Your First Resource": [[0, "your-first-resource"]], "pymerlin": [[17, "module-pymerlin"]], "pymerlin 0.0.2": [[24, "pymerlin-0-0-2"]], "pymerlin.duration": [[18, "module-pymerlin.duration"]], "pymerlin.model_actions": [[19, "module-pymerlin.model_actions"]]}, "docnames": ["1_tutorials/1_gettingstarted", "1_tutorials/index", "1_tutorials/tutorial2", "2_guides/datamodel", "2_guides/index", "2_guides/jupyter", "2_guides/powermodel", "2_guides/scheduling", "2_guides/spice", "2_guides/telecom", "3_explanation/co-simulation", "3_explanation/command-errors", "3_explanation/fidelity", "3_explanation/index", "3_explanation/planning", "3_explanation/simulation", "apidocs/index", "apidocs/pymerlin/pymerlin", "apidocs/pymerlin/pymerlin.duration", "apidocs/pymerlin/pymerlin.model_actions", "architecture", "contribute", "developer", "documentation", "index", "install", "license", "publishing", "quickstart"], "envversion": {"sphinx": 61, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["1_tutorials/1_gettingstarted.md", "1_tutorials/index.md", "1_tutorials/tutorial2.md", "2_guides/datamodel.md", "2_guides/index.md", "2_guides/jupyter.md", "2_guides/powermodel.md", "2_guides/scheduling.md", "2_guides/spice.md", "2_guides/telecom.md", "3_explanation/co-simulation.md", "3_explanation/command-errors.md", "3_explanation/fidelity.md", "3_explanation/index.md", "3_explanation/planning.md", "3_explanation/simulation.md", "apidocs/index.rst", "apidocs/pymerlin/pymerlin.rst", "apidocs/pymerlin/pymerlin.duration.rst", "apidocs/pymerlin/pymerlin.model_actions.rst", "architecture.md", "contribute.md", "developer.md", "documentation.md", "index.md", "install.md", "license.md", "publishing.md", "quickstart.md"], "indexentries": {"__eq__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__eq__", false]], "__ge__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__ge__", false]], "__gt__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__gt__", false]], "__le__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__le__", false]], "__lt__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__lt__", false]], "__repr__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__repr__", false]], "_yield_with() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions._yield_with", false]], "call() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.call", false]], "delay() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.delay", false]], "duration (class in pymerlin.duration)": [[18, "pymerlin.duration.Duration", false]], "from_string() (pymerlin.duration.duration static method)": [[18, "pymerlin.duration.Duration.from_string", false]], "hour (in module pymerlin.duration)": [[18, "pymerlin.duration.HOUR", false]], "hours (in module pymerlin.duration)": [[18, "pymerlin.duration.HOURS", false]], "microsecond (in module pymerlin.duration)": [[18, "pymerlin.duration.MICROSECOND", false]], "microseconds (in module pymerlin.duration)": [[18, "pymerlin.duration.MICROSECONDS", false]], "millisecond (in module pymerlin.duration)": [[18, "pymerlin.duration.MILLISECOND", false]], "milliseconds (in module pymerlin.duration)": [[18, "pymerlin.duration.MILLISECONDS", false]], "minute (in module pymerlin.duration)": [[18, "pymerlin.duration.MINUTE", false]], "minutes (in module pymerlin.duration)": [[18, "pymerlin.duration.MINUTES", false]], "module": [[17, "module-pymerlin", false], [18, "module-pymerlin.duration", false], [19, "module-pymerlin.model_actions", false]], "negate() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.negate", false]], "of() (pymerlin.duration.duration static method)": [[18, "pymerlin.duration.Duration.of", false]], "plus() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.plus", false]], "pymerlin": [[17, "module-pymerlin", false]], "pymerlin.duration": [[18, "module-pymerlin.duration", false]], "pymerlin.model_actions": [[19, "module-pymerlin.model_actions", false]], "second (in module pymerlin.duration)": [[18, "pymerlin.duration.SECOND", false]], "seconds (in module pymerlin.duration)": [[18, "pymerlin.duration.SECONDS", false]], "spawn() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.spawn", false]], "times() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.times", false]], "wait_until() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.wait_until", false]], "zero (in module pymerlin.duration)": [[18, "pymerlin.duration.ZERO", false]]}, "objects": {"": [[17, 0, 0, "-", "pymerlin"]], "pymerlin": [[18, 0, 0, "-", "duration"], [19, 0, 0, "-", "model_actions"]], "pymerlin.duration": [[18, 1, 1, "", "Duration"], [18, 3, 1, "", "HOUR"], [18, 3, 1, "", "HOURS"], [18, 3, 1, "", "MICROSECOND"], [18, 3, 1, "", "MICROSECONDS"], [18, 3, 1, "", "MILLISECOND"], [18, 3, 1, "", "MILLISECONDS"], [18, 3, 1, "", "MINUTE"], [18, 3, 1, "", "MINUTES"], [18, 3, 1, "", "SECOND"], [18, 3, 1, "", "SECONDS"], [18, 3, 1, "", "ZERO"]], "pymerlin.duration.Duration": [[18, 2, 1, "", "__eq__"], [18, 2, 1, "", "__ge__"], [18, 2, 1, "", "__gt__"], [18, 2, 1, "", "__le__"], [18, 2, 1, "", "__lt__"], [18, 2, 1, "", "__repr__"], [18, 2, 1, "", "from_string"], [18, 2, 1, "", "negate"], [18, 2, 1, "", "of"], [18, 2, 1, "", "plus"], [18, 2, 1, "", "times"]], "pymerlin.model_actions": [[19, 4, 1, "", "_yield_with"], [19, 4, 1, "", "call"], [19, 4, 1, "", "delay"], [19, 4, 1, "", "spawn"], [19, 4, 1, "", "wait_until"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "data", "Python data"], "4": ["py", "function", "Python function"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:data", "4": "py:function"}, "terms": {"": [0, 8, 11, 12, 18, 21], "0": [0, 18], "00": [0, 18, 19], "000": 18, "000000": 18, "01": [0, 19], "01pre": 15, "03": 15, "1": [0, 18], "12": 28, "170215": 15, "2": [11, 18], "200": 11, "2017": 15, "2018": 15, "2021": 26, "21": [22, 28], "24": 18, "3": [15, 22], "30": 18, "3120": 28, "3rd": 15, "5": 18, "600": 18, "63": 18, "7": 18, "8601": 18, "9": 22, "A": [7, 11, 15, 18, 19, 24, 26], "AND": 26, "AS": 26, "As": [0, 11, 18, 21], "At": 21, "BE": 26, "BUT": 26, "Be": 21, "But": 0, "FOR": 26, "For": [0, 11, 18, 21, 22], "IN": 26, "If": [0, 11, 18, 21], "In": [0, 11, 15, 18, 21], "It": [10, 11, 12], "NO": 26, "NOT": 26, "No": 21, "Not": 11, "OF": 26, "OR": 26, "One": 11, "THE": 26, "TO": 26, "That": 11, "The": [0, 8, 9, 11, 13, 18, 20, 21, 26], "Then": 0, "There": [10, 11, 12, 15], "These": [0, 11, 21], "To": [11, 15, 18, 21, 24], "WITH": 26, "With": 0, "__eq__": 18, "__ge__": 18, "__gt__": 18, "__init__": 0, "__le__": 18, "__lt__": 18, "__main__": 0, "__name__": 0, "__repr__": 18, "_yield_with": 19, "abil": [11, 12, 21], "abl": [0, 9, 10, 11, 15], "about": [0, 11, 13, 21, 24], "abov": [0, 11, 21, 26], "absenc": [11, 15], "absolut": 11, "abstract": 11, "accept": 21, "access": 24, "accomplish": [0, 11], "accuraci": 18, "achiev": 11, "across": [11, 12], "act": 15, "action": [11, 15, 19, 26], "activ": [0, 12, 13, 20, 28], "activitytyp": 0, "actual": [0, 11, 21], "ad": [11, 21], "add": [0, 15, 21], "addit": [0, 12, 15, 22], "address": 11, "adher": 11, "adoptium": 28, "advanc": 15, "advantag": 0, "advers": 11, "aeri": [0, 12, 15, 20, 21, 24], "affect": 11, "after": [0, 11, 21, 28], "again": 15, "against": [11, 18], "aid": 21, "aim": 20, "all": [0, 11, 15, 21, 26], "alloc": [9, 11, 15], "allow": [0, 11, 15, 20, 21], "almost": [0, 18], "along": 0, "alreadi": 0, "also": [0, 11, 12], "although": 0, "altogeth": 18, "alwai": [18, 21], "ammo": 15, "an": [0, 9, 13, 15, 18, 21, 26], "analysi": 11, "analyz": 20, "ani": [0, 9, 11, 15, 18, 21, 26], "anoth": [11, 15], "anticip": 11, "apart": 0, "api": 27, "appear": [0, 21], "appli": [11, 15], "approv": [11, 21], "approxim": [12, 18], "ar": [0, 10, 11, 12, 15, 18, 19, 21, 23, 28], "arbitrari": 15, "arbitrarili": 15, "aren": 11, "argument": [0, 11], "aris": [10, 11, 26], "arithmet": 18, "around": 18, "assess": 11, "assign": 18, "associ": 26, "assum": 11, "astronom": 18, "async": [0, 19], "attent": [11, 21], "attribut": 15, "author": [11, 26], "auto": 0, "autodoc2": 23, "autom": 11, "automat": [11, 12, 21, 23], "autonom": 13, "autonomi": 11, "avail": [0, 9], "avoid": [13, 15], "awai": 0, "await": 19, "awar": [0, 11], "b": [7, 21], "back": 0, "bandwidth": 9, "base": [0, 18], "basi": 18, "basic": 0, "batteri": 11, "becam": 11, "becaus": 18, "becom": [18, 21], "been": [0, 9, 11, 21], "befor": [11, 15, 21], "begin": 0, "behavior": [0, 11, 12], "being": [0, 18], "benefit": 20, "best": [11, 12], "better": [11, 21], "between": [0, 9, 11, 12, 15, 18, 20, 21], "bind": 8, "bisect": 21, "board": [0, 11], "bodi": [9, 18], "bonu": 0, "boolean": 0, "borrow": 15, "both": [0, 11, 15], "bound": 11, "bracket": 21, "branch": 21, "bridg": 20, "brief": 0, "build": [0, 22, 27], "built": [0, 23, 24], "bulletproof": 11, "burden": 11, "busi": 9, "button": 21, "c": 26, "calcul": 8, "calendar": 18, "calendr": 18, "california": 26, "call": [0, 11, 12, 15, 18, 19], "camera": 0, "can": [0, 11, 12, 13, 15, 16, 18, 19, 21, 24], "cannot": [0, 11], "capabl": 11, "cardin": 11, "carlo": 12, "carol": 11, "carri": 11, "case": [0, 11, 18], "catch": 12, "categori": [0, 11], "caus": 11, "causal": 18, "caution": 11, "cd": [23, 27], "celesti": 18, "cell": [0, 15], "certain": [11, 15, 19], "cfdp": 11, "challeng": 10, "chang": [0, 13, 15, 21], "channel": 21, "character": 20, "characterist": 11, "charg": 26, "chat": 21, "check": [11, 21, 24], "checkout": 21, "child": [15, 19], "china": 18, "choic": [15, 18], "choos": 11, "cite": 11, "claim": [18, 26], "class": [0, 16], "clean": [21, 23], "clear": [11, 21], "climat": 11, "clipper": 11, "clock": [0, 18], "clone": 21, "close": [11, 21], "co": 13, "code": [0, 18, 20], "collectdata": 0, "collinear": 18, "com": [15, 24], "combin": [11, 18, 21], "come": [0, 10, 11, 12], "command": [12, 13, 21, 28], "comment": 21, "common": 0, "commun": [9, 11, 12, 20], "compar": 11, "complac": 11, "complet": 11, "complex": 0, "complic": [18, 21], "compon": 11, "compos": 12, "comput": [0, 11, 15], "concept": [12, 15, 18], "concurr": [11, 15], "condit": [11, 15, 19, 26], "config": 0, "configur": [0, 12, 18], "conflict": [11, 15, 21], "connect": 26, "consensu": 11, "consequ": 11, "consid": 20, "constant": 0, "constel": 11, "constitu": 11, "constrain": 11, "constraint": 11, "construct": 18, "constructor": 0, "contain": 11, "content": [0, 11, 15, 25], "continu": [0, 15, 21], "contract": 26, "contrib": 0, "contribut": 23, "contributor": 21, "control": 11, "convent": 21, "convers": 0, "convert": 18, "coordin": 11, "copi": 26, "copyright": 26, "core": 0, "coro": 19, "correct": 11, "correctli": [0, 11], "correspond": 11, "cost": 11, "could": [0, 11], "counter": 0, "coupl": [0, 18], "cours": 0, "cover": [0, 18], "creat": [1, 18, 21], "current": [0, 15, 18, 21], "custom": [0, 18], "cycl": 12, "d": [0, 15, 21], "dai": [12, 18], "damag": 26, "danger": 11, "data": [0, 11, 16], "datamodel": 0, "date": 18, "de": 18, "deadlin": 11, "deal": [18, 21, 26], "decid": 11, "decis": 11, "declar": [0, 11], "decreas": 0, "def": 0, "defer": 18, "defin": [0, 11, 18], "definit": [0, 11, 18], "delai": [11, 19], "deleg": 0, "delet": [11, 21], "delimit": 18, "deliv": 11, "depend": [9, 11, 12, 15, 18], "deploy": 0, "depth": 11, "deriv": [0, 18], "describ": [11, 15, 21, 28], "descript": [11, 21], "design": [0, 10, 11, 21], "desir": [11, 12], "detail": [0, 12, 16], "detect": 11, "determin": 9, "develop": 21, "deviat": 11, "did": 11, "differ": [0, 9, 11, 12, 18], "difficult": [11, 20], "direct": 0, "directli": [0, 11, 18, 20], "directori": 23, "discret": [0, 13, 18, 24], "discuss": 21, "disposit": 11, "dist": 27, "distanc": [9, 18], "distinct": 18, "distinguish": [0, 18], "distribut": [15, 26], "do": [0, 13, 17, 26], "doc": [15, 23, 24], "docstr": 23, "document": [0, 21, 26], "doe": [0, 11, 21], "domain": 18, "don": [0, 11, 21], "done": [11, 18], "doubl": [0, 20], "doublevaluemapp": 0, "download": 28, "draft": 11, "drop": 18, "duplic": [15, 21], "durat": [0, 11, 16, 17, 19], "duration_str": 18, "dure": [11, 12], "duti": 12, "dynam": [11, 15], "e": [0, 11, 18], "each": [0, 21], "earli": 11, "earth": [11, 18], "easi": 11, "easier": 21, "easiest": 0, "ecosystem": 24, "edit": 21, "effect": [0, 11, 21], "effort": 21, "either": [11, 21], "element": 18, "emit": [0, 15], "en": 15, "enabl": [11, 15, 20], "endpoint": 21, "engin": [12, 20], "enhanc": 15, "enough": [11, 12], "ensur": [0, 18, 21], "enter": 11, "enumer": [0, 11], "envelop": 11, "environ": [11, 28], "environment": 11, "epagomen": 18, "ephemerid": 18, "err": 11, "error": [0, 12, 13], "errorbehavior": 0, "errorregistrar": 0, "estim": 18, "evalu": 15, "even": [11, 15, 18, 21], "event": [0, 11, 13, 18, 24, 26], "eventu": 0, "everi": [11, 15, 21], "evid": 18, "evolut": 15, "evolv": 0, "exact": 18, "exampl": [0, 11, 18, 19], "except": 18, "execut": 11, "exhaust": 11, "exist": [10, 11, 15, 18, 27], "expect": [0, 11, 20], "explicitli": 0, "expos": 0, "express": [15, 26], "extend": 0, "extens": 23, "extern": 12, "f": [15, 21], "fact": 11, "factori": 18, "fail": 11, "failur": 11, "fall": [11, 21], "fals": [11, 19], "familiar": 11, "famous": 11, "far": [11, 18], "fashion": 11, "fast": 11, "fault": 11, "fdir": 11, "feasibl": 11, "featur": 21, "few": [0, 11, 21], "fewer": 11, "fidel": 13, "field": 18, "file": [0, 13, 21, 26, 27], "final": 0, "find": [0, 16], "fine": 11, "firesat": 0, "first": [1, 11, 15, 28], "fit": 26, "fix": [11, 18, 21], "flight": 11, "float": 18, "focu": 11, "focus": [0, 11], "follow": [0, 11, 15, 21, 23, 26, 28], "forc": 21, "forget": 15, "form": [0, 11], "formul": 15, "forward": 15, "found": 11, "framework": [0, 24], "free": [11, 26], "free_replicated_data_typ": 15, "frequent": 18, "from": [0, 11, 15, 18, 21, 26], "from_str": 18, "front": 21, "fsw": 11, "fulli": 0, "function": [0, 15, 16, 18], "fundament": [0, 18], "furnish": 26, "furo": 23, "further": [1, 11, 13, 15, 18], "futur": 15, "g": [11, 18], "gener": [0, 12, 15, 21], "get": [1, 10, 28], "git": 21, "github": [15, 21, 24], "give": [11, 18, 20, 21], "given": [0, 15], "go": [1, 11], "goe": 25, "gold": 18, "gone": 11, "good": 18, "gov": 0, "grain": 11, "grant": 26, "great": [10, 18], "greatest": 11, "gregorian": 18, "ground": 11, "guarante": [13, 15], "guardrail": 11, "guid": 24, "guidelin": 24, "ha": [0, 9, 11, 18, 20, 21], "had": 11, "hardwar": 11, "have": [0, 11, 12, 15, 20, 21, 28], "healthi": 11, "heater": 11, "held": 18, "help": 21, "helper": 0, "here": [11, 13, 16, 18, 21, 25], "herebi": 26, "hierarch": 21, "high": 11, "higher": 22, "histori": [15, 21], "hold": 11, "holder": 26, "horizon": 12, "host": 15, "hour": 18, "how": [0, 12, 13, 21, 28], "howev": [11, 18], "html": 23, "http": [15, 24, 28], "human": 11, "hybrid": [15, 20], "hybrid_system": 15, "i": [0, 2, 3, 5, 6, 8, 9, 11, 12, 14, 15, 17, 18, 20, 21, 23, 24, 26], "id": 0, "idea": 21, "ident": 11, "identifi": 11, "ii": 10, "imag": 0, "imbu": 11, "impact": 11, "imper": 11, "implement": [0, 10, 11, 15, 20], "impli": [11, 26], "implicitli": 0, "import": [0, 11], "importantli": 11, "imposs": 11, "incapacit": 11, "includ": [0, 11, 18, 21, 23, 26, 27], "incorrect": 11, "increas": [0, 11], "increment": 18, "increment_count": 0, "indefinit": 11, "independ": [11, 15], "indic": 11, "individu": [11, 12], "info": [0, 21], "inform": [11, 21], "initi": [0, 15, 18], "input": 11, "inspect": 11, "instant": 18, "instanti": 0, "instead": [10, 18], "institut": 26, "instruct": 21, "instrument": [0, 20], "integ": [0, 18], "integr": [0, 12, 13, 21], "intend": [0, 11], "intens": 11, "intent": 11, "intention": 18, "interact": [11, 21], "intercalari": 18, "interest": [0, 11], "interestingli": 0, "interfac": [15, 21], "intern": 18, "interpret": 11, "interspers": 11, "introduc": [0, 11, 15], "invalid": 11, "invok": 18, "involv": 11, "io": 15, "iso": 18, "isol": 11, "issu": [0, 21], "its": [11, 12, 15, 20], "itself": [0, 11], "jar": 20, "java": [18, 20, 22, 28], "jdk": 22, "jpl": [0, 8], "jre": 28, "just": [0, 18], "justifi": 11, "keep": [0, 11, 15], "kei": [9, 11, 27], "kernel": 18, "keyword": 19, "kind": [11, 26], "know": [0, 11], "known": 18, "komputasi": 15, "label": 19, "lack": 11, "languag": 11, "larg": [11, 12], "largest": 18, "last": 0, "later": 0, "latest": 21, "latitud": 18, "lead": 11, "learn": [0, 13, 24], "least": 21, "left": 21, "less": [11, 18], "let": 0, "level": [0, 11], "leverag": 10, "liabil": 26, "liabl": 26, "librari": 22, "lightweight": 11, "like": [0, 11, 15, 18, 21], "limit": [9, 11, 26], "line": [0, 21], "linear": [0, 21], "link": [0, 9, 18], "list": 15, "live": 23, "ll": [0, 22], "local": 21, "log": 0, "logic": 0, "long": [11, 18], "longest": 11, "look": [0, 18], "loss": 11, "lost": [11, 21], "love": 21, "low": 11, "lower": 11, "lunar": 18, "m": 27, "machin": 28, "made": [0, 21], "mai": [11, 12, 18, 20], "main": [0, 20], "maintain": 0, "major": 11, "make": [0, 13, 21, 23, 27, 28], "manag": [12, 15], "maneuv": 11, "mani": [0, 10, 11, 12], "map": 18, "mapper": 0, "mar": 11, "mark": 11, "martian": 18, "match": [0, 11], "matt": 11, "mattdaili": 24, "maxim": 11, "maximum": 18, "mayb": 11, "mean": [11, 15, 19, 20], "measur": [0, 18], "mechan": 11, "media": 9, "megabit": 0, "member": 0, "mental": 11, "mention": 11, "merchant": 26, "mere": [12, 21], "merg": [21, 26], "merlin": [0, 15, 18, 20], "messag": [11, 21], "met": 21, "method": [13, 18], "micro": 18, "microsecond": 18, "millisecond": 18, "mind": [0, 11], "minim": [11, 15], "minut": 18, "mirror": 11, "miss": 11, "mission": [1, 10, 11, 12, 15], "missionmodel": 0, "mit": 26, "mitig": 11, "mm": 11, "mode": 11, "model": [1, 10, 11, 12, 15, 20, 24], "model_act": [16, 17], "modifi": [0, 26], "modul": 17, "mont": 12, "month": 18, "moon": 18, "more": [0, 11, 12, 13, 15, 20, 21, 24], "most": [0, 11], "move": 15, "msl": 11, "much": [0, 12], "multipl": [11, 18], "multipli": 18, "must": [0, 11, 19, 21], "muszynski": 11, "mutabl": 15, "mutableresourc": 0, "mvsteen": 15, "my": 21, "myst": 23, "naif": 8, "name": [0, 11], "nasa": [0, 8, 15], "neatli": 21, "necessari": 18, "necessarili": 12, "need": [0, 11, 12, 18, 22], "needless": 15, "negat": 18, "net": 28, "new": [0, 11, 21], "newest": 11, "next": 0, "nice": 10, "nomin": 11, "none": 18, "noninfring": 26, "note": [11, 18, 21], "notic": 26, "notion": [12, 15, 18], "now": [0, 11], "number": [11, 18], "numer": 11, "object": 0, "observ": [11, 12], "obstruct": 9, "obtain": 26, "occult": 9, "occur": [0, 15], "off": [11, 12], "often": [11, 18], "old": 11, "onboard": 11, "onc": [11, 15, 21, 28], "one": [0, 11, 18, 21], "ones": [0, 11], "onli": 18, "onto": 21, "open": 21, "oper": [9, 11, 12, 15, 18], "opportun": [0, 11], "optim": 11, "option": 21, "orbit": [8, 11, 18], "order": [11, 15, 18], "ordin": 18, "org": [15, 28], "origin": [11, 21], "other": [0, 9, 11, 18, 26], "otherwis": 26, "our": [0, 21, 24], "out": [21, 24, 26], "outcom": 11, "outsid": 18, "outstand": 21, "over": [0, 21], "overhead": 20, "overview": 0, "own": [0, 18], "packag": [0, 16, 18, 22], "packet": 11, "padawan": 0, "pai": 21, "pair": 11, "palat": 11, "panel": 11, "paradigm": 11, "parallel": 15, "param": [18, 19], "paramet": [0, 11, 12, 18], "paraphras": 15, "parent": 15, "pars": 23, "part": [0, 11], "partial": 13, "particular": [11, 18, 26], "partit": 15, "pass": [0, 11, 21], "passag": 18, "patch": 21, "path": [9, 20], "pdf": 15, "perceiv": 11, "perform": [0, 9, 11, 12, 15, 18], "perhap": 11, "period": 18, "perman": 11, "permiss": 26, "permit": 26, "persist": 11, "person": 26, "peski": 0, "phase": 12, "phenomena": 15, "piec": 11, "piecewis": 0, "pip": 28, "place": 11, "plai": [9, 10, 12], "plan": [0, 12, 13], "pleas": 21, "plu": 18, "plugin": 23, "point": [0, 9, 11, 18], "polanskei": 11, "polynomi": 0, "popular": 8, "port": 20, "portion": 26, "posit": 11, "possibl": [0, 11, 20, 21], "power": 11, "powerless": 11, "practic": 11, "pre": 0, "precis": [11, 12, 18], "predict": 11, "prefer": 21, "prefix": 15, "preliminari": 15, "presenc": 18, "present": 21, "preserv": 18, "prevent": 0, "previou": [11, 21], "primari": 0, "primarili": 0, "primit": 0, "print": 0, "problem": 18, "process": [0, 10, 11, 12, 20], "profil": [0, 11], "progress": 0, "project": [21, 28], "promot": 11, "properti": [9, 11, 15, 18], "protect": 11, "prototyp": 20, "prove": 11, "proven": 11, "provid": [0, 8, 11, 12, 16, 18, 19, 26], "prudent": 11, "ptolemi": 10, "public": 0, "publish": [22, 26], "pull": 0, "purpos": [9, 11, 26], "push": 21, "put": [11, 15], "py": 0, "py4j": 20, "pymerlin": [0, 10, 12, 16, 20, 27, 28], "pypirc": 27, "pyspark": 20, "pytest": 22, "python": [8, 20, 22, 23, 24, 28], "python3": 27, "qualiti": 15, "quantiti": [0, 18], "queri": [15, 21], "quickli": [11, 12], "quickstart": 24, "rang": [11, 18], "rapid": 20, "rare": 11, "rate": 0, "rather": 20, "re": [10, 13, 18, 20, 21], "reach": 21, "read": [0, 13, 15, 21, 24], "readabl": 21, "readi": [21, 24, 28], "real": 21, "reason": [11, 21], "rebas": 21, "recal": 11, "receiv": [9, 11], "recent": 11, "recharg": 11, "recommend": 11, "record": [0, 11], "recording_r": 0, "recordingr": 0, "recoveri": 11, "reduc": 11, "refer": 18, "referenc": [11, 18], "regard": 15, "regist": 0, "registrar": 0, "regular": 18, "reject": 11, "rel": 12, "relat": 21, "releas": 28, "reli": [18, 21], "reliabl": [11, 12], "remind": 0, "remov": 20, "render": 0, "repo": 21, "repositori": 21, "repres": [0, 11, 18], "represent": [11, 18], "requir": [11, 12, 15, 21], "resembl": 11, "resolut": 18, "resourc": [1, 11, 15, 21], "respect": 11, "respons": 11, "restrict": [0, 11, 21, 26], "result": [11, 18], "retrospect": 18, "return": [18, 19], "reusabl": 11, "review": 11, "rf": 27, "right": 26, "risk": 11, "rm": [21, 27], "role": 9, "rough": 18, "run": [11, 12, 15, 20, 22, 23], "safe": [11, 21], "safeti": 13, "same": [11, 15, 18], "scalar": 18, "schedul": [0, 12, 13, 15], "scienc": 12, "scrutini": 11, "search": 21, "second": [0, 18], "section": [11, 28], "see": [0, 11, 21, 24], "seemingli": 18, "segment": 0, "self": 0, "sell": 26, "semant": [11, 15], "send": 21, "sens": 11, "sent": 11, "separ": [11, 15, 18, 21], "sequenc": 11, "serial": [0, 15], "serious": 20, "set": [0, 11, 18], "set_valu": 0, "sever": 12, "shall": 26, "share": 11, "short": 12, "should": [0, 11, 15, 18, 21], "shown": 0, "side": [11, 21], "sider": 18, "sift": 11, "sign": 18, "signal": 11, "similar": [11, 18], "simluat": 10, "simpl": 0, "simpli": 18, "simul": [0, 11, 12, 13, 18, 20, 24], "sinc": [0, 18], "singl": [0, 11, 15, 20, 21], "situat": 11, "skeleton": 11, "skew": 11, "skip": 11, "sky": 18, "slack": 21, "small": [11, 12], "smaller": 11, "so": [0, 11, 26], "socket": 20, "softwar": [0, 11, 26], "sol": 11, "solar": [11, 18], "solid": 0, "some": [0, 9, 10, 11, 13, 15, 21], "someon": 20, "someth": [0, 11], "sometim": [11, 12], "somewhat": 11, "sort": 11, "sound": 11, "spacecraft": [0, 13, 18], "span": [12, 18], "spark": 20, "spawn": [15, 19], "special": 0, "specif": [11, 18], "specifi": [0, 11], "sphinx": 23, "spice": 18, "spiceypi": 8, "squash": 21, "ssr": 0, "stai": [0, 11], "standard": 18, "star": 18, "start": [1, 20, 24, 28], "state": [0, 11, 15], "statement": 0, "static": [0, 18], "statu": 19, "step": [0, 11, 15], "still": 11, "stopwatch": 0, "store": 0, "stori": 21, "straightforward": 11, "strategi": 21, "streamlin": 0, "strength": 12, "strict": 12, "strictli": 0, "string": 0, "strive": 11, "structur": [0, 16], "subject": [11, 26], "sublicens": 26, "submiss": [21, 24], "submit": 11, "subprocess": 20, "substanti": 26, "subsystem": [11, 12], "suffici": 12, "suffix": 15, "suggest": 21, "summari": 21, "sun": [11, 18], "supersed": 11, "support": 11, "sure": [11, 21, 27, 28], "surviv": 11, "swap": 11, "sygyzi": 18, "symmetri": 18, "synod": 18, "syntact": 11, "syntax": 11, "system": [9, 10, 11, 12, 15, 18, 20], "syzygi": 18, "t": [0, 11, 15, 21], "take": [0, 11, 18, 19], "target": 21, "task": [15, 19], "team": 11, "teas": 0, "technologi": 26, "tele": 9, "telecommun": 9, "telemetri": 11, "tell": 21, "temperatur": 11, "tempor": 18, "temurin": 28, "tenet": 20, "term": 18, "tertiari": 18, "test": [0, 22], "than": [0, 20, 21], "thei": [0, 11, 19, 21], "them": [0, 9, 10, 11, 21], "theme": 23, "theori": 13, "therefor": 11, "thi": [0, 2, 3, 5, 6, 11, 14, 15, 17, 18, 19, 20, 21, 23, 26, 28], "thing": [0, 11, 17], "think": 0, "third": 0, "those": [0, 11, 28], "though": [11, 21], "through": [0, 11, 21], "tightli": 11, "time": [0, 11, 12, 15, 18, 21], "timelin": 0, "tip": 0, "todai": [0, 21], "todo": [0, 15], "togeth": [10, 11], "tool": [10, 12], "toolkit": [8, 18], "top": 0, "tort": 26, "toward": [9, 11], "track": [0, 15], "tractabl": 11, "trade": 12, "tradition": [0, 15, 18], "train": 0, "trajectori": 11, "transact": 15, "transaction": 15, "transform": 0, "transmit": 11, "transmitt": 9, "trigger": 11, "trivial": 11, "true": [11, 19], "trust": 11, "try": [10, 11], "tune": 13, "turn": 11, "tutori": [0, 2, 3, 5, 6, 14], "twine": [22, 27], "two": [0, 10, 11, 15, 18, 21], "ty": 11, "type": [0, 11, 18], "typic": [11, 12], "ui": 0, "ultim": 0, "uncertainti": 11, "uncondition": 11, "under": 11, "underli": 18, "understand": 11, "undesir": 11, "unexpect": 11, "unfortun": 18, "unintent": 11, "uniqu": 0, "unit": [0, 18], "unless": 15, "unlik": [0, 18], "unresolv": 21, "unsaf": 11, "unsurpris": 18, "until": [0, 11, 15], "up": [0, 11, 21], "updat": [0, 21], "upgrad": 11, "upload": [15, 27], "us": [0, 11, 18, 20, 21, 23, 24, 26], "usabl": 13, "user": [0, 21], "usual": 11, "v": [13, 21], "valid": 13, "valu": [0, 11, 15, 18], "variabl": [0, 15], "variat": 12, "variou": 0, "ve": 15, "vector": 11, "veri": 11, "verif": 11, "verifi": 11, "version": [0, 11, 15, 21], "via": [0, 11, 21], "view": [0, 11], "vike": 11, "virtual": 28, "volum": 0, "voyag": 11, "wa": [11, 18], "wai": [11, 15, 18], "wait_until": 19, "want": [0, 11, 20, 21], "warranti": 26, "wast": [11, 15], "we": [0, 11, 15, 18, 21], "week": [12, 18], "welcom": [0, 23], "well": [0, 9, 11, 18, 20], "went": 21, "were": 11, "what": [0, 11, 15, 21], "when": [0, 10, 11, 21], "whenev": 15, "where": [11, 15, 18, 20], "whether": [9, 11, 26], "which": [0, 11, 18, 19, 20, 21], "while": [11, 15, 20], "who": 20, "whole": 11, "whom": 26, "whose": [0, 18], "wiki": 15, "wikipedia": [15, 18], "within": [0, 11, 18], "without": [0, 11, 20, 26], "word": 0, "wordpress": 15, "work": [11, 15, 18, 21], "wors": 18, "worst": 11, "would": [10, 11, 21], "wp": 15, "write": [0, 11, 15, 21], "written": [0, 11], "wrong": 11, "www": 28, "x": [11, 15], "y": 11, "year": 18, "yield": 18, "you": [0, 13, 16, 18, 21, 22, 24, 28], "your": [1, 15, 18, 21, 27, 28], "zero": 18}, "titles": ["Getting Started", "Tutorials", "Going further", "Modeling Data Volume", "Guides", "How to use pymerlin in Jupyter", "Modeling Power", "Scheduling", "Using spice for geometry", "Modeling Telecom", "Co-Simulation", "Command Errors", "Tuning Fidelity", "Background", "Planning and Scheduling", "Discrete Event Simulation", "API Reference", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin.duration</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin.model_actions</span></code>", "Architecture", "Contributing", "Developing pymerlin", "Documentation", "pymerlin 0.0.2", "Install", "License", "Publishing to pypi", "Quickstart"], "titleterms": {"0": 24, "2": 24, "The": 15, "activ": 11, "an": 11, "api": [16, 18, 19], "approach": 20, "architectur": 20, "autonom": 11, "avoid": 11, "background": 13, "build": 21, "chang": 11, "class": 18, "co": 10, "code": [21, 24], "command": 11, "commit": 21, "content": [18, 19], "contribut": [21, 24], "creat": 0, "data": [3, 18], "develop": 22, "discret": 15, "do": 11, "document": 23, "durat": 18, "error": 11, "event": 15, "feedback": 24, "fidel": 12, "file": 11, "first": 0, "function": 19, "further": [2, 10], "geometri": 8, "get": [0, 24], "go": 2, "good": 21, "got": 21, "guarante": 11, "guid": 4, "guidelin": 21, "help": 24, "how": [5, 11, 24], "instal": [25, 28], "integr": 11, "jupyt": 5, "licens": 26, "make": 11, "method": 11, "mission": 0, "model": [0, 3, 6, 9], "model_act": 19, "modul": [18, 19], "over": 20, "partial": 11, "perform": 20, "plan": [11, 14], "power": 6, "pr": 21, "practic": 21, "problem": 21, "provid": 24, "publish": 27, "pull": 21, "pymerlin": [5, 17, 18, 19, 21, 22, 24], "pypi": 27, "question": 21, "quickstart": 28, "re": 11, "read": 10, "refer": 16, "request": 21, "resourc": 0, "review": 21, "safeti": 11, "schedul": [7, 14], "simul": [10, 15], "sourc": 24, "spacecraft": 11, "spice": 8, "start": 0, "submit": 21, "submodul": 17, "telecom": 9, "theori": 15, "tune": 12, "tutori": 1, "us": [5, 8], "usabl": 11, "v": 11, "valid": 11, "volum": 3, "you": 11, "your": 0}})
\ No newline at end of file
+Search.setIndex({"alltitles": {"API": [[17, "api"], [18, "api"], [19, "api"]], "API Reference": [[16, "api-reference"]], "Activity Planning": [[11, "activity-planning"]], "Approachability over performance": [[20, "approachability-over-performance"]], "Architecture": [[20, "architecture"]], "Avoiding Command Errors": [[11, "avoiding-command-errors"]], "Background": [[13, "background"]], "Building pymerlin": [[21, "building-pymerlin"]], "Classes": [[18, "classes"]], "Co-Simulation": [[10, "co-simulation"]], "Command Errors": [[11, "command-errors"]], "Contributing": [[21, "contributing"]], "Creating a Mission Model": [[0, "creating-a-mission-model"]], "Data": [[18, "data"]], "Developing pymerlin": [[22, "developing-pymerlin"]], "Discrete Event Simulation": [[15, "discrete-event-simulation"]], "Documentation": [[23, "documentation"]], "Functions": [[17, "functions"], [19, "functions"]], "Further Reading": [[10, "further-reading"]], "Getting Started": [[0, "getting-started"]], "Going further": [[2, "going-further"]], "Good Commit, PR, and Code Review Practices": [[21, "good-commit-pr-and-code-review-practices"]], "Got a Question or Problem?": [[21, "got-a-question-or-problem"]], "Guides": [[4, "guides"]], "How do you guarantee the safety of an autonomous spacecraft?": [[11, "how-do-you-guarantee-the-safety-of-an-autonomous-spacecraft"]], "How to get help, contribute, or provide feedback": [[24, "how-to-get-help-contribute-or-provide-feedback"]], "How to use pymerlin in Jupyter": [[5, "how-to-use-pymerlin-in-jupyter"]], "Install": [[25, "install"]], "Installation": [[28, "installation"]], "Installing pymerlin": [[0, "installing-pymerlin"]], "Integrated vs Partial validation": [[11, "integrated-vs-partial-validation"]], "License": [[26, "license"]], "Making changes to command files": [[11, "making-changes-to-command-files"]], "Methods of Validation": [[11, "methods-of-validation"]], "Modeling Data Volume": [[3, "modeling-data-volume"]], "Modeling Power": [[6, "modeling-power"]], "Modeling Telecom": [[9, "modeling-telecom"]], "Module Contents": [[18, "module-contents"], [19, "module-contents"]], "Package Contents": [[17, "package-contents"]], "Planning and Scheduling": [[14, "planning-and-scheduling"]], "Publishing to pypi": [[27, "publishing-to-pypi"]], "Pull Request Guidelines": [[21, "pull-request-guidelines"]], "Quickstart": [[28, "quickstart"]], "Re-usable command files": [[11, "re-usable-command-files"]], "Scheduling": [[7, "scheduling"]], "Source code": [[24, "source-code"]], "Submitting a Pull Request": [[21, "submitting-a-pull-request"]], "Submodules": [[17, "submodules"]], "The Theory": [[15, "the-theory"]], "Tuning Fidelity": [[12, "tuning-fidelity"]], "Tutorials": [[1, "tutorials"]], "Using spice for geometry": [[8, "using-spice-for-geometry"]], "Your First Resource": [[0, "your-first-resource"]], "pymerlin": [[17, "module-pymerlin"]], "pymerlin 0.0.2": [[24, "pymerlin-0-0-2"]], "pymerlin.duration": [[18, "module-pymerlin.duration"]], "pymerlin.model_actions": [[19, "module-pymerlin.model_actions"]]}, "docnames": ["1_tutorials/1_gettingstarted", "1_tutorials/index", "1_tutorials/tutorial2", "2_guides/datamodel", "2_guides/index", "2_guides/jupyter", "2_guides/powermodel", "2_guides/scheduling", "2_guides/spice", "2_guides/telecom", "3_explanation/co-simulation", "3_explanation/command-errors", "3_explanation/fidelity", "3_explanation/index", "3_explanation/planning", "3_explanation/simulation", "apidocs/index", "apidocs/pymerlin/pymerlin", "apidocs/pymerlin/pymerlin.duration", "apidocs/pymerlin/pymerlin.model_actions", "architecture", "contribute", "developer", "documentation", "index", "install", "license", "publishing", "quickstart"], "envversion": {"sphinx": 61, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["1_tutorials/1_gettingstarted.md", "1_tutorials/index.md", "1_tutorials/tutorial2.md", "2_guides/datamodel.md", "2_guides/index.md", "2_guides/jupyter.md", "2_guides/powermodel.md", "2_guides/scheduling.md", "2_guides/spice.md", "2_guides/telecom.md", "3_explanation/co-simulation.md", "3_explanation/command-errors.md", "3_explanation/fidelity.md", "3_explanation/index.md", "3_explanation/planning.md", "3_explanation/simulation.md", "apidocs/index.rst", "apidocs/pymerlin/pymerlin.rst", "apidocs/pymerlin/pymerlin.duration.rst", "apidocs/pymerlin/pymerlin.model_actions.rst", "architecture.md", "contribute.md", "developer.md", "documentation.md", "index.md", "install.md", "license.md", "publishing.md", "quickstart.md"], "indexentries": {"__eq__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__eq__", false]], "__ge__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__ge__", false]], "__gt__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__gt__", false]], "__le__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__le__", false]], "__lt__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__lt__", false]], "__repr__() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.__repr__", false]], "_yield_with() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions._yield_with", false]], "call() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.call", false]], "checkout() (in module pymerlin)": [[17, "pymerlin.checkout", false]], "delay() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.delay", false]], "duration (class in pymerlin.duration)": [[18, "pymerlin.duration.Duration", false]], "from_string() (pymerlin.duration.duration static method)": [[18, "pymerlin.duration.Duration.from_string", false]], "hour (in module pymerlin.duration)": [[18, "pymerlin.duration.HOUR", false]], "hours (in module pymerlin.duration)": [[18, "pymerlin.duration.HOURS", false]], "microsecond (in module pymerlin.duration)": [[18, "pymerlin.duration.MICROSECOND", false]], "microseconds (in module pymerlin.duration)": [[18, "pymerlin.duration.MICROSECONDS", false]], "millisecond (in module pymerlin.duration)": [[18, "pymerlin.duration.MILLISECOND", false]], "milliseconds (in module pymerlin.duration)": [[18, "pymerlin.duration.MILLISECONDS", false]], "minute (in module pymerlin.duration)": [[18, "pymerlin.duration.MINUTE", false]], "minutes (in module pymerlin.duration)": [[18, "pymerlin.duration.MINUTES", false]], "module": [[17, "module-pymerlin", false], [18, "module-pymerlin.duration", false], [19, "module-pymerlin.model_actions", false]], "negate() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.negate", false]], "of() (pymerlin.duration.duration static method)": [[18, "pymerlin.duration.Duration.of", false]], "plus() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.plus", false]], "pymerlin": [[17, "module-pymerlin", false]], "pymerlin.duration": [[18, "module-pymerlin.duration", false]], "pymerlin.model_actions": [[19, "module-pymerlin.model_actions", false]], "second (in module pymerlin.duration)": [[18, "pymerlin.duration.SECOND", false]], "seconds (in module pymerlin.duration)": [[18, "pymerlin.duration.SECONDS", false]], "spawn() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.spawn", false]], "times() (pymerlin.duration.duration method)": [[18, "pymerlin.duration.Duration.times", false]], "wait_until() (in module pymerlin.model_actions)": [[19, "pymerlin.model_actions.wait_until", false]], "zero (in module pymerlin.duration)": [[18, "pymerlin.duration.ZERO", false]]}, "objects": {"": [[17, 0, 0, "-", "pymerlin"]], "pymerlin": [[17, 1, 1, "", "checkout"], [18, 0, 0, "-", "duration"], [19, 0, 0, "-", "model_actions"]], "pymerlin.duration": [[18, 2, 1, "", "Duration"], [18, 4, 1, "", "HOUR"], [18, 4, 1, "", "HOURS"], [18, 4, 1, "", "MICROSECOND"], [18, 4, 1, "", "MICROSECONDS"], [18, 4, 1, "", "MILLISECOND"], [18, 4, 1, "", "MILLISECONDS"], [18, 4, 1, "", "MINUTE"], [18, 4, 1, "", "MINUTES"], [18, 4, 1, "", "SECOND"], [18, 4, 1, "", "SECONDS"], [18, 4, 1, "", "ZERO"]], "pymerlin.duration.Duration": [[18, 3, 1, "", "__eq__"], [18, 3, 1, "", "__ge__"], [18, 3, 1, "", "__gt__"], [18, 3, 1, "", "__le__"], [18, 3, 1, "", "__lt__"], [18, 3, 1, "", "__repr__"], [18, 3, 1, "", "from_string"], [18, 3, 1, "", "negate"], [18, 3, 1, "", "of"], [18, 3, 1, "", "plus"], [18, 3, 1, "", "times"]], "pymerlin.model_actions": [[19, 1, 1, "", "_yield_with"], [19, 1, 1, "", "call"], [19, 1, 1, "", "delay"], [19, 1, 1, "", "spawn"], [19, 1, 1, "", "wait_until"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "function", "Python function"], "2": ["py", "class", "Python class"], "3": ["py", "method", "Python method"], "4": ["py", "data", "Python data"]}, "objtypes": {"0": "py:module", "1": "py:function", "2": "py:class", "3": "py:method", "4": "py:data"}, "terms": {"": [0, 8, 11, 12, 18, 21], "0": [0, 18], "00": [0, 18, 19], "000": 18, "000000": 18, "01": [0, 19], "01pre": 15, "03": 15, "1": [0, 18], "12": 28, "170215": 15, "2": [11, 18], "200": 11, "2017": 15, "2018": 15, "2021": 26, "21": [22, 28], "24": 18, "3": [15, 22], "30": 18, "3120": 28, "3rd": 15, "5": 18, "600": 18, "63": 18, "7": 18, "8601": 18, "9": 22, "A": [7, 11, 15, 18, 19, 24, 26], "AND": 26, "AS": 26, "As": [0, 11, 18, 21], "At": 21, "BE": 26, "BUT": 26, "Be": 21, "But": 0, "FOR": 26, "For": [0, 11, 18, 21, 22], "IN": 26, "If": [0, 11, 18, 21, 28], "In": [0, 11, 15, 18, 21], "It": [10, 11, 12], "NO": 26, "NOT": 26, "No": 21, "Not": 11, "OF": 26, "OR": 26, "One": 11, "THE": 26, "TO": 26, "That": 11, "The": [0, 8, 9, 11, 13, 18, 20, 21, 26], "Then": 0, "There": [10, 11, 12, 15], "These": [0, 11, 21], "To": [11, 15, 18, 21, 24], "WITH": 26, "With": 0, "__eq__": 18, "__ge__": 18, "__gt__": 18, "__init__": 0, "__le__": 18, "__lt__": 18, "__main__": 0, "__name__": 0, "__repr__": 18, "_yield_with": 19, "abil": [11, 12, 21], "abl": [0, 9, 10, 11, 15], "about": [0, 11, 13, 21, 24], "abov": [0, 11, 21, 26], "absenc": [11, 15], "absolut": 11, "abstract": 11, "accept": 21, "access": 24, "accomplish": [0, 11], "accuraci": 18, "achiev": 11, "across": [11, 12], "act": 15, "action": [11, 15, 19, 26], "activ": [0, 12, 13, 20, 28], "activitytyp": 0, "actual": [0, 11, 21], "ad": [11, 21], "add": [0, 15, 21], "addit": [0, 12, 15, 22], "address": 11, "adher": 11, "adoptium": 28, "advanc": 15, "advantag": 0, "advers": 11, "aeri": [0, 12, 15, 20, 21, 24], "affect": 11, "after": [0, 11, 21, 28], "again": 15, "against": [11, 18], "aid": 21, "aim": 20, "all": [0, 11, 15, 21, 26], "alloc": [9, 11, 15], "allow": [0, 11, 15, 20, 21], "almost": [0, 18], "along": 0, "alreadi": 0, "also": [0, 11, 12], "although": 0, "altogeth": 18, "alwai": [18, 21], "ammo": 15, "an": [0, 9, 13, 15, 18, 21, 26], "analysi": 11, "analyz": 20, "ani": [0, 9, 11, 15, 18, 21, 26], "anoth": [11, 15], "anticip": 11, "apart": 0, "api": 27, "appear": [0, 21], "appli": [11, 15], "approv": [11, 21], "approxim": [12, 18], "ar": [0, 10, 11, 12, 15, 18, 19, 21, 23, 28], "arbitrari": 15, "arbitrarili": 15, "aren": 11, "argument": [0, 11], "aris": [10, 11, 26], "arithmet": 18, "around": 18, "assess": 11, "assign": 18, "associ": 26, "assum": 11, "astronom": 18, "async": [0, 19], "attent": [11, 21], "attribut": 15, "author": [11, 26], "auto": 0, "autodoc2": 23, "autom": 11, "automat": [11, 12, 21, 23], "autonom": 13, "autonomi": 11, "avail": [0, 9], "avoid": [13, 15], "awai": 0, "await": 19, "awar": [0, 11], "b": [7, 21], "back": 0, "bandwidth": 9, "base": [0, 18], "basi": 18, "basic": 0, "batteri": 11, "bear": 0, "becam": 11, "becaus": 18, "becom": [18, 21], "been": [0, 9, 11, 21], "befor": [11, 15, 21], "begin": 0, "behavior": [0, 11, 12], "being": [0, 18], "benefit": 20, "best": [11, 12], "better": [11, 21], "between": [0, 9, 11, 12, 15, 18, 20, 21], "bind": 8, "bisect": 21, "board": [0, 11], "bodi": [9, 18], "bonu": 0, "boolean": 0, "borrow": 15, "both": [0, 11, 15], "bound": 11, "bracket": 21, "branch": 21, "bridg": 20, "brief": 0, "build": [0, 22, 27], "built": [0, 23, 24], "bulletproof": 11, "burden": 11, "busi": 9, "button": 21, "c": [26, 28], "calcul": 8, "calendar": 18, "calendr": 18, "california": 26, "call": [0, 11, 12, 15, 18, 19], "camera": 0, "can": [0, 11, 12, 13, 15, 16, 18, 19, 21, 24], "cannot": [0, 11], "capabl": 11, "cardin": 11, "carlo": 12, "carol": 11, "carri": 11, "case": [0, 11, 18], "catch": 12, "categori": [0, 11], "caus": 11, "causal": 18, "caution": 11, "cd": 23, "celesti": 18, "cell": [0, 15], "certain": [11, 15, 19], "cfdp": 11, "challeng": 10, "chang": [0, 13, 15, 21], "channel": 21, "character": 20, "characterist": 11, "charg": 26, "chat": 21, "check": [11, 17, 21, 24, 28], "checkout": [17, 21, 28], "child": [15, 19], "china": 18, "choic": [15, 18], "choos": 11, "cite": 11, "claim": [18, 26], "class": [0, 16], "clean": [21, 23], "clear": [11, 21], "climat": 11, "clipper": 11, "clock": [0, 18], "clone": 21, "close": [11, 21], "co": 13, "code": [0, 18, 20], "collectdata": 0, "collinear": 18, "com": [15, 24], "combin": [11, 18, 21], "come": [0, 10, 11, 12], "command": [12, 13, 21, 27, 28], "comment": 21, "common": 0, "commun": [9, 11, 12, 20], "compar": 11, "complac": 11, "complet": 11, "complex": 0, "complic": [18, 21], "compon": 11, "compos": 12, "comput": [0, 11, 15], "concept": [12, 15, 18], "concurr": [11, 15], "condit": [11, 15, 19, 26], "config": 0, "configur": [0, 12, 18], "conflict": [11, 15, 21], "connect": 26, "consensu": 11, "consequ": 11, "consid": 20, "constant": 0, "constel": 11, "constitu": 11, "constrain": 11, "constraint": 11, "construct": [0, 18], "constructor": 0, "contain": 11, "content": [0, 11, 15, 25], "continu": [0, 15, 21], "contract": 26, "contrib": 0, "contribut": 23, "contributor": 21, "control": 11, "convent": 21, "convers": 0, "convert": 18, "coordin": 11, "copi": 26, "copyright": 26, "core": 0, "coro": 19, "correct": 11, "correctli": [0, 11], "correspond": 11, "cost": 11, "could": [0, 11], "counter": 0, "coupl": [0, 18], "cours": 0, "cover": [0, 18], "creat": [1, 18, 21], "current": [0, 15, 18, 21], "custom": [0, 18], "cycl": 12, "d": [0, 15, 21], "dai": [12, 18], "damag": 26, "danger": 11, "data": [0, 11, 16], "datamodel": 0, "date": 18, "de": 18, "deadlin": 11, "deal": [18, 21, 26], "decid": 11, "decis": 11, "declar": [0, 11], "decreas": 0, "def": 0, "defer": 18, "defin": [0, 11, 18], "definit": [0, 11, 18], "delai": [11, 19], "deleg": 0, "delet": [11, 21], "delimit": 18, "deliv": 11, "depend": [9, 11, 12, 15, 18], "deploy": 0, "depth": 11, "deriv": [0, 18], "describ": [11, 15, 21, 28], "descript": [11, 21], "design": [0, 10, 11, 21], "desir": [11, 12], "detail": [0, 12, 16], "detect": 11, "determin": 9, "develop": 21, "deviat": 11, "did": 11, "differ": [0, 9, 11, 12, 18], "difficult": [11, 20], "direct": 0, "directli": [0, 11, 18, 20], "directori": 23, "discret": [0, 13, 18, 24], "discuss": 21, "disposit": 11, "dist": 27, "distanc": [9, 18], "distinct": 18, "distinguish": [0, 18], "distribut": [15, 26], "do": [0, 13, 17, 26], "doc": [15, 23, 24], "docstr": 23, "document": [0, 21, 26], "doe": [0, 11, 21], "domain": 18, "don": [0, 11, 21], "done": [11, 18], "doubl": [0, 20], "doublevaluemapp": 0, "download": 28, "draft": 11, "drop": 18, "duplic": [15, 21], "durat": [0, 11, 16, 17, 19], "duration_str": 18, "dure": [11, 12], "duti": 12, "dynam": [11, 15], "e": [0, 11, 18], "each": [0, 21], "earli": 11, "earth": [11, 18], "easi": 11, "easier": 21, "easiest": 0, "ecosystem": 24, "edit": 21, "effect": [0, 11, 21], "effort": 21, "either": [11, 21], "element": 18, "emit": [0, 15], "en": 15, "enabl": [11, 15, 20], "endpoint": 21, "engin": [12, 20], "enhanc": 15, "enough": [11, 12], "ensur": [0, 18, 21], "enter": 11, "enumer": [0, 11], "envelop": 11, "environ": [11, 28], "environment": 11, "epagomen": 18, "ephemerid": 18, "err": 11, "error": [0, 12, 13], "errorbehavior": 0, "errorregistrar": 0, "estim": 18, "evalu": 15, "even": [11, 15, 18, 21], "event": [0, 11, 13, 18, 24, 26], "eventu": 0, "everi": [11, 15, 21], "evid": 18, "evolut": 15, "evolv": 0, "exact": 18, "exampl": [0, 11, 18, 19], "except": 18, "execut": 11, "exhaust": 11, "exist": [10, 11, 15, 18, 27], "expect": [0, 11, 20], "explicitli": 0, "expos": 0, "express": [15, 26], "extend": 0, "extens": 23, "extern": 12, "f": [15, 21], "fact": 11, "factori": 18, "fail": 11, "failur": 11, "fall": [11, 21], "fals": [11, 19], "familiar": 11, "famous": 11, "far": [11, 18], "fashion": 11, "fast": 11, "fault": 11, "fdir": 11, "feasibl": 11, "featur": 21, "few": [0, 11, 21], "fewer": 11, "fidel": 13, "field": 18, "file": [0, 13, 21, 26, 27], "final": 0, "find": [0, 16], "fine": 11, "firesat": 0, "first": [1, 11, 15, 28], "fit": 26, "fix": [11, 18, 21], "flight": 11, "float": 18, "focu": 11, "focus": [0, 11], "follow": [0, 11, 15, 21, 23, 26, 28], "forc": 21, "forget": 15, "form": [0, 11], "formul": 15, "forward": 15, "found": 11, "framework": [0, 24], "free": [11, 26], "free_replicated_data_typ": 15, "frequent": 18, "from": [0, 11, 15, 18, 21, 26, 27], "from_str": 18, "front": 21, "fsw": 11, "fulli": 0, "function": [0, 15, 16, 18], "fundament": [0, 18], "furnish": 26, "furo": 23, "further": [1, 11, 13, 15, 18], "futur": 15, "g": [11, 18], "gener": [0, 12, 15, 21], "get": [1, 10, 28], "git": 21, "github": [15, 21, 24], "give": [11, 18, 20, 21], "given": [0, 15], "go": [0, 1, 11], "goe": 25, "gold": 18, "gone": 11, "good": 18, "gov": 0, "grain": 11, "grant": 26, "great": [10, 18], "greatest": 11, "gregorian": 18, "ground": 11, "guarante": [13, 15], "guardrail": 11, "guid": [0, 24], "guidelin": 24, "ha": [0, 9, 11, 18, 20, 21], "had": 11, "hardwar": 11, "have": [0, 11, 12, 15, 20, 21, 28], "haven": 0, "healthi": 11, "heater": 11, "held": 18, "help": 21, "helper": 0, "here": [11, 13, 16, 18, 21, 25], "herebi": 26, "hierarch": 21, "high": 11, "higher": 22, "histori": [15, 21], "hold": 11, "holder": 26, "horizon": 12, "host": 15, "hour": 18, "how": [0, 12, 13, 21, 28], "howev": [11, 18], "html": 23, "http": [15, 24, 28], "human": 11, "hybrid": [15, 20], "hybrid_system": 15, "i": [0, 2, 3, 5, 6, 8, 9, 11, 12, 14, 15, 17, 18, 20, 21, 23, 24, 26], "id": 0, "idea": 21, "ident": 11, "identifi": 11, "ii": 10, "imag": 0, "imbu": 11, "impact": 11, "imper": 11, "implement": [0, 10, 11, 15, 20], "impli": [11, 26], "implicitli": 0, "import": [0, 11, 28], "importantli": 11, "imposs": 11, "incapacit": 11, "includ": [0, 11, 18, 21, 23, 26, 27], "incorrect": 11, "increas": [0, 11], "increment": 18, "increment_count": 0, "indefinit": 11, "independ": [11, 15], "indic": 11, "individu": [11, 12], "info": 21, "inform": [11, 21], "initi": [0, 15, 18], "input": 11, "inspect": 11, "instal": [1, 17], "instant": 18, "instanti": 0, "instead": [10, 18], "institut": 26, "instruct": 21, "instrument": [0, 20], "integ": [0, 18], "integr": [0, 12, 13, 21], "intend": [0, 11], "intens": 11, "intent": 11, "intention": 18, "interact": [11, 21], "intercalari": 18, "interest": [0, 11], "interestingli": 0, "interfac": [15, 21], "intern": 18, "interpret": 11, "interspers": 11, "introduc": [0, 11, 15], "invalid": 11, "invok": 18, "involv": 11, "io": 15, "iso": 18, "isol": 11, "issu": [0, 21], "its": [11, 12, 15, 20], "itself": [0, 11], "jar": 20, "java": [0, 18, 20, 22, 28], "jdk": 22, "jpl": [0, 8], "jre": 28, "just": [0, 18], "justifi": 11, "keep": [0, 11, 15], "kei": [9, 11, 27], "kernel": 18, "keyword": 19, "kind": [11, 26], "know": [0, 11], "known": 18, "komputasi": 15, "label": 19, "lack": 11, "languag": 11, "larg": [11, 12], "largest": 18, "last": 0, "later": 0, "latest": 21, "latitud": 18, "lead": 11, "learn": [0, 13, 24], "least": 21, "left": 21, "less": [11, 18], "let": 0, "level": [0, 11], "leverag": 10, "liabil": 26, "liabl": 26, "librari": 22, "lightweight": 11, "like": [0, 11, 15, 18, 21], "limit": [9, 11, 26], "line": [0, 21], "linear": [0, 21], "link": [0, 9, 18], "list": 15, "live": 23, "ll": [0, 22], "local": 21, "log": 0, "logic": 0, "long": [11, 18], "longest": 11, "look": [0, 18], "loss": 11, "lost": [11, 21], "love": 21, "low": 11, "lower": 11, "lunar": 18, "m": 27, "machin": 28, "made": [0, 21], "mai": [11, 12, 18, 20], "main": [0, 20], "maintain": 0, "major": 11, "make": [0, 13, 21, 23, 27, 28], "manag": [12, 15], "maneuv": 11, "mani": [0, 10, 11, 12], "map": 18, "mapper": 0, "mar": 11, "mark": 11, "martian": 18, "match": [0, 11], "matt": 11, "mattdaili": 24, "maxim": 11, "maximum": 18, "mayb": 11, "mean": [11, 15, 19, 20], "measur": [0, 18], "mechan": 11, "media": 9, "megabit": 0, "member": 0, "mental": 11, "mention": 11, "merchant": 26, "mere": [12, 21], "merg": [21, 26], "merlin": [0, 15, 18, 20], "messag": [11, 21], "met": 21, "method": [13, 18], "micro": 18, "microsecond": 18, "millisecond": 18, "mind": [0, 11], "minim": [11, 15], "minut": 18, "mirror": 11, "miss": 11, "mission": [1, 10, 11, 12, 15], "missionmodel": 0, "mit": 26, "mitig": 11, "mm": 11, "mode": 11, "model": [1, 10, 11, 12, 15, 20, 24], "model_act": [16, 17], "modifi": [0, 26], "modul": 17, "mont": 12, "month": 18, "moon": 18, "more": [0, 11, 12, 13, 15, 20, 21, 24], "most": [0, 11], "move": 15, "msl": 11, "much": [0, 12], "multipl": [11, 18], "multipli": 18, "must": [0, 11, 19, 21], "muszynski": 11, "mutabl": 15, "mutableresourc": 0, "mvsteen": 15, "my": 21, "myst": 23, "naif": 8, "name": [0, 11], "nasa": [0, 8, 15], "neatli": 21, "necessari": 18, "necessarili": 12, "need": [0, 11, 12, 18, 22], "needless": 15, "negat": 18, "net": 28, "new": [0, 11, 21], "newest": 11, "next": 0, "nice": 10, "nomin": 11, "none": 18, "noninfring": 26, "note": [11, 18, 21], "notic": 26, "notion": [12, 15, 18], "now": [0, 11], "number": [11, 18], "numer": 11, "object": 0, "observ": [11, 12], "obstruct": 9, "obtain": 26, "occult": 9, "occur": [0, 15], "off": [11, 12], "often": [11, 18], "old": 11, "onboard": 11, "onc": [11, 15, 21, 28], "one": [0, 11, 18, 21], "ones": [0, 11], "onli": 18, "onto": 21, "open": 21, "oper": [9, 11, 12, 15, 18], "opportun": [0, 11], "optim": 11, "option": 21, "orbit": [8, 11, 18], "order": [11, 15, 18], "ordin": 18, "org": [15, 28], "origin": [11, 21], "other": [0, 9, 11, 18, 26], "otherwis": 26, "our": [0, 21, 24], "out": [21, 24, 26], "outcom": 11, "outsid": 18, "outstand": 21, "over": [0, 21], "overhead": 20, "overview": 0, "own": [0, 18], "packag": [0, 16, 18, 22], "packet": 11, "padawan": 0, "page": 0, "pai": 21, "pair": 11, "palat": 11, "panel": 11, "paradigm": 11, "parallel": 15, "param": [18, 19], "paramet": [0, 11, 12, 18], "paraphras": 15, "parent": 15, "pars": 23, "part": [0, 11], "partial": 13, "particular": [11, 18, 26], "partit": 15, "pass": [0, 11, 21], "passag": 18, "patch": 21, "path": [9, 20], "pdf": 15, "perceiv": 11, "perform": [0, 9, 11, 12, 15, 18], "perhap": 11, "period": 18, "perman": 11, "permiss": 26, "permit": 26, "persist": 11, "person": 26, "peski": 0, "phase": 12, "phenomena": 15, "piec": 11, "piecewis": 0, "pip": 28, "place": 11, "plai": [9, 10, 12], "plan": [0, 12, 13], "pleas": [0, 21], "plu": 18, "plugin": 23, "point": [0, 9, 11, 18], "polanskei": 11, "polynomi": 0, "popular": 8, "port": [0, 20], "portion": 26, "posit": 11, "possibl": [0, 11, 20, 21], "power": 11, "powerless": 11, "practic": 11, "pre": 0, "precis": [11, 12, 18], "predict": 11, "prefer": 21, "prefix": 15, "preliminari": 15, "presenc": 18, "present": 21, "preserv": 18, "prevent": 0, "previou": [11, 21], "primari": 0, "primarili": 0, "primit": 0, "print": 0, "problem": 18, "process": [0, 10, 11, 12, 20], "profil": [0, 11], "progress": 0, "project": [21, 28], "promot": 11, "properti": [9, 11, 15, 18], "protect": 11, "prototyp": 20, "prove": 11, "proven": 11, "provid": [0, 8, 11, 12, 16, 18, 19, 26], "prudent": 11, "ptolemi": 10, "public": 0, "publish": [22, 26], "pull": 0, "purpos": [9, 11, 26], "push": 21, "put": [11, 15], "py": 0, "py4j": 20, "pymerlin": [1, 10, 12, 16, 20, 28], "pypirc": 27, "pyspark": 20, "pytest": 22, "python": [0, 8, 20, 22, 23, 24, 28], "python3": [27, 28], "qualiti": 15, "quantiti": [0, 18], "queri": [15, 21], "quickli": [11, 12], "quickstart": [0, 24], "rang": [11, 18], "rapid": 20, "rare": 11, "rate": 0, "rather": 20, "re": [10, 13, 18, 20, 21, 28], "reach": 21, "read": [0, 13, 15, 21, 24], "readabl": 21, "readi": [21, 24, 28], "real": 21, "reason": [11, 21], "rebas": 21, "recal": 11, "receiv": [9, 11], "recent": 11, "recharg": 11, "recommend": 11, "record": [0, 11], "recording_r": 0, "recordingr": 0, "recoveri": 11, "reduc": 11, "refer": 18, "referenc": [11, 18], "regard": 15, "regist": 0, "registrar": 0, "regular": 18, "reject": 11, "rel": 12, "relat": 21, "releas": 28, "reli": [18, 21], "reliabl": [11, 12], "remind": 0, "remov": 20, "render": 0, "repo": 21, "repositori": [21, 27], "repres": [0, 11, 18], "represent": [11, 18], "requir": [11, 12, 15, 21], "resembl": 11, "resolut": 18, "resourc": [1, 11, 15, 21], "respect": 11, "respons": 11, "restrict": [0, 11, 21, 26], "result": [11, 18], "retrospect": 18, "return": [18, 19], "reusabl": 11, "review": 11, "rf": 27, "right": 26, "risk": 11, "rm": [21, 27], "role": 9, "root": 27, "rough": 18, "run": [11, 12, 15, 20, 22, 23, 27, 28], "safe": [11, 21], "safeti": 13, "same": [11, 15, 18], "scalar": 18, "schedul": [0, 12, 13, 15], "scienc": 12, "scrutini": 11, "search": 21, "second": [0, 18], "section": [11, 28], "see": [0, 11, 21, 24], "seemingli": 18, "segment": 0, "self": 0, "sell": 26, "semant": [11, 15], "send": 21, "sens": 11, "sent": 11, "separ": [11, 15, 18, 21], "sequenc": 11, "serial": [0, 15], "serious": 20, "set": [0, 11, 18], "set_valu": 0, "sever": 12, "shall": 26, "share": 11, "short": 12, "should": [0, 11, 15, 18, 21], "shown": 0, "side": [11, 21], "sider": 18, "sift": 11, "sign": 18, "signal": 11, "similar": [11, 18], "simluat": 10, "simpl": 0, "simpli": 18, "simul": [0, 11, 12, 13, 18, 20, 24], "sinc": [0, 18], "singl": [0, 11, 15, 20, 21], "situat": 11, "skeleton": 11, "skew": 11, "skip": 11, "sky": 18, "slack": 21, "small": [11, 12], "smaller": 11, "so": [0, 11, 26], "socket": 20, "softwar": [0, 11, 26], "sol": 11, "solar": [11, 18], "solid": 0, "some": [0, 9, 10, 11, 13, 15, 21], "someon": 20, "someth": [0, 11], "sometim": [11, 12], "somewhat": 11, "sort": 11, "sound": 11, "spacecraft": [0, 13, 18], "span": [12, 18], "spark": 20, "spawn": [15, 19], "special": 0, "specif": [11, 18], "specifi": [0, 11], "sphinx": 23, "spice": 18, "spiceypi": 8, "squash": 21, "ssr": 0, "stai": [0, 11], "standard": 18, "star": 18, "start": [1, 20, 24, 28], "state": [0, 11, 15], "statement": 0, "static": [0, 18], "statu": 19, "step": [0, 11, 15], "still": 11, "stopwatch": 0, "store": 0, "stori": 21, "straightforward": 11, "strategi": 21, "streamlin": 0, "strength": 12, "strict": 12, "strictli": 0, "string": 0, "strive": 11, "structur": [0, 16], "subject": [11, 26], "sublicens": 26, "submiss": [21, 24], "submit": 11, "subprocess": 20, "substanti": 26, "subsystem": [11, 12], "succe": 28, "succeed": 28, "success": 17, "suffici": 12, "suffix": 15, "suggest": 21, "summari": 21, "sun": [11, 18], "supersed": 11, "support": 11, "sure": [11, 21, 27, 28], "surviv": 11, "swap": 11, "sygyzi": 18, "symmetri": 18, "synod": 18, "syntact": 11, "syntax": 11, "system": [9, 10, 11, 12, 15, 18, 20], "syzygi": 18, "t": [0, 11, 15, 21], "take": [0, 11, 18, 19], "target": 21, "task": [15, 19], "team": 11, "teas": 0, "technologi": 26, "tele": 9, "telecommun": 9, "telemetri": 11, "tell": 21, "temperatur": 11, "tempor": 18, "temurin": 28, "tenet": 20, "term": 18, "tertiari": 18, "test": [0, 22], "than": [0, 20, 21], "thei": [0, 11, 19, 21], "them": [0, 9, 10, 11, 21], "theme": 23, "theori": 13, "therefor": 11, "thi": [0, 2, 3, 5, 6, 11, 14, 15, 17, 18, 19, 20, 21, 23, 26, 28], "thing": [0, 11, 17], "think": 0, "third": 0, "those": [0, 11, 28], "though": [11, 21], "through": [0, 11, 21], "tightli": 11, "time": [0, 11, 12, 15, 18, 21], "timelin": 0, "todai": [0, 21], "todo": [0, 15], "togeth": [10, 11], "tool": [10, 12], "toolkit": [8, 18], "top": 0, "tort": 26, "toward": [9, 11], "track": [0, 15], "tractabl": 11, "trade": 12, "tradition": [0, 15, 18], "train": 0, "trajectori": 11, "transact": 15, "transaction": 15, "transform": 0, "transmit": 11, "transmitt": 9, "trigger": 11, "trivial": 11, "true": [11, 19], "trust": 11, "try": [10, 11], "tune": 13, "turn": 11, "tutori": [0, 2, 3, 5, 6, 14, 28], "twine": [22, 27], "two": [0, 10, 11, 15, 18, 21], "ty": 11, "type": [0, 11, 18], "typic": [11, 12], "u": 0, "ui": 0, "ultim": 0, "uncertainti": 11, "uncondition": 11, "under": [0, 11], "underli": 18, "understand": 11, "undesir": 11, "unexpect": 11, "unfortun": 18, "unintent": 11, "uniqu": 0, "unit": [0, 18], "unless": 15, "unlik": [0, 18], "unresolv": 21, "unsaf": 11, "unsurpris": 18, "until": [0, 11, 15], "up": [0, 11, 21], "updat": [0, 21], "upgrad": 11, "upload": [15, 27], "us": [0, 11, 18, 20, 21, 23, 24, 26], "usabl": 13, "user": [0, 21], "usual": 11, "v": [13, 21], "valid": 13, "valu": [0, 11, 15, 18], "variabl": [0, 15], "variat": 12, "variou": 0, "ve": 15, "vector": 11, "veri": 11, "verif": 11, "verifi": 11, "version": [0, 11, 15, 21], "via": [0, 11, 21], "view": [0, 11], "vike": 11, "virtual": 28, "volum": 0, "voyag": 11, "wa": [11, 17, 18], "wai": [11, 15, 18], "wait_until": 19, "want": [0, 11, 20, 21], "warranti": 26, "wast": [11, 15], "we": [0, 11, 15, 18, 21], "week": [12, 18], "welcom": [0, 23], "well": [0, 9, 11, 18, 20], "went": 21, "were": 11, "what": [0, 11, 15, 21], "when": [0, 10, 11, 21], "whenev": 15, "where": [11, 15, 18, 20], "whether": [9, 11, 26], "which": [0, 11, 18, 19, 20, 21], "while": [11, 15, 20], "who": 20, "whole": 11, "whom": 26, "whose": [0, 18], "wiki": 15, "wikipedia": [15, 18], "within": [0, 11, 18], "without": [0, 11, 20, 26], "word": 0, "wordpress": 15, "work": [11, 15, 18, 21], "wors": 18, "worst": 11, "would": [10, 11, 21], "wp": 15, "write": [0, 11, 15, 21], "written": [0, 11], "wrong": 11, "www": 28, "x": [11, 15], "y": 11, "year": 18, "yield": 18, "you": [0, 13, 16, 18, 21, 22, 24, 28], "your": [1, 15, 17, 18, 21, 27, 28], "zero": 18}, "titles": ["Getting Started", "Tutorials", "Going further", "Modeling Data Volume", "Guides", "How to use pymerlin in Jupyter", "Modeling Power", "Scheduling", "Using spice for geometry", "Modeling Telecom", "Co-Simulation", "Command Errors", "Tuning Fidelity", "Background", "Planning and Scheduling", "Discrete Event Simulation", "API Reference", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin.duration</span></code>", "<code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">pymerlin.model_actions</span></code>", "Architecture", "Contributing", "Developing pymerlin", "Documentation", "pymerlin 0.0.2", "Install", "License", "Publishing to pypi", "Quickstart"], "titleterms": {"0": 24, "2": 24, "The": 15, "activ": 11, "an": 11, "api": [16, 17, 18, 19], "approach": 20, "architectur": 20, "autonom": 11, "avoid": 11, "background": 13, "build": 21, "chang": 11, "class": 18, "co": 10, "code": [21, 24], "command": 11, "commit": 21, "content": [17, 18, 19], "contribut": [21, 24], "creat": 0, "data": [3, 18], "develop": 22, "discret": 15, "do": 11, "document": 23, "durat": 18, "error": 11, "event": 15, "feedback": 24, "fidel": 12, "file": 11, "first": 0, "function": [17, 19], "further": [2, 10], "geometri": 8, "get": [0, 24], "go": 2, "good": 21, "got": 21, "guarante": 11, "guid": 4, "guidelin": 21, "help": 24, "how": [5, 11, 24], "instal": [0, 25, 28], "integr": 11, "jupyt": 5, "licens": 26, "make": 11, "method": 11, "mission": 0, "model": [0, 3, 6, 9], "model_act": 19, "modul": [18, 19], "over": 20, "packag": 17, "partial": 11, "perform": 20, "plan": [11, 14], "power": 6, "pr": 21, "practic": 21, "problem": 21, "provid": 24, "publish": 27, "pull": 21, "pymerlin": [0, 5, 17, 18, 19, 21, 22, 24], "pypi": 27, "question": 21, "quickstart": 28, "re": 11, "read": 10, "refer": 16, "request": 21, "resourc": 0, "review": 21, "safeti": 11, "schedul": [7, 14], "simul": [10, 15], "sourc": 24, "spacecraft": 11, "spice": 8, "start": 0, "submit": 21, "submodul": 17, "telecom": 9, "theori": 15, "tune": 12, "tutori": 1, "us": [5, 8], "usabl": 11, "v": 11, "valid": 11, "volum": 3, "you": 11, "your": 0}})
\ No newline at end of file
diff --git a/java/pymerlin/src/main/java/gov/nasa/ammos/aerie/merlin/python/MerlinEntryPoint.java b/java/pymerlin/src/main/java/gov/nasa/ammos/aerie/merlin/python/MerlinEntryPoint.java
index e9418bd..db77333 100644
--- a/java/pymerlin/src/main/java/gov/nasa/ammos/aerie/merlin/python/MerlinEntryPoint.java
+++ b/java/pymerlin/src/main/java/gov/nasa/ammos/aerie/merlin/python/MerlinEntryPoint.java
@@ -27,6 +27,5 @@ public <T> int take(T object) {
     public static void main(String[] args) {
         GatewayServer gatewayServer = new GatewayServer(new MerlinEntryPoint());
         gatewayServer.start();
-        System.out.println("Gateway Server Started");
     }
 }
diff --git a/pymerlin/__init__.py b/pymerlin/__init__.py
index 96cadab..4d54ef5 100644
--- a/pymerlin/__init__.py
+++ b/pymerlin/__init__.py
@@ -3,5 +3,41 @@
 """
 
 from ._internal._decorators import MissionModel
-from ._internal._framework import simulate, Span
-from ._internal._schedule import Schedule, Directive
\ No newline at end of file
+from ._internal._framework import simulate, Span, ProfileSegment
+from ._internal._registrar import Registrar
+from ._internal._schedule import Schedule, Directive
+from .duration import Duration
+
+
+def checkout():
+    """
+    Check that your pymerlin installation was successful
+    """
+    # Exercise enough of the system to flush out any configuration issues, and ideally provide user with actionable
+    # feedback in the case of misconfiguration
+
+    success = True  # If this is False at the bottom of the function, checkout failed
+
+    @MissionModel
+    class TestMissionModel:
+        def __init__(self, registrar: Registrar):
+            self.counter = registrar.cell(0)
+            registrar.resource("counter", self.counter.get)
+
+    @TestMissionModel.ActivityType
+    async def test_activity(mission: TestMissionModel):
+        mission.counter.emit(lambda x: x + 1)
+
+
+    profiles, spans, events = simulate(TestMissionModel, Schedule.build(("00:00:00", Directive("test_activity"))), "00:00:01")
+    if profiles != {'counter': [ProfileSegment(extent=Duration.from_string("+00:00:01.000000"), dynamics=1.0)]}:
+        print("Profiles didn't check out: ", profiles)
+        success = False
+    if spans != [Span(type='test_activity', start=Duration.from_string("+00:00:00.000000"), duration=Duration.from_string("+00:00:00.000000"))]:
+        print("Spans didn't check out: ", profiles)
+        success = False
+
+    if success:
+        print("pymerlin checkout successful: All systems GO 🚀")
+    else:
+        print("Checkout detected issues ⚠️")
\ No newline at end of file
diff --git a/pymerlin/_internal/_gateway.py b/pymerlin/_internal/_gateway.py
index 47d1466..92843ab 100644
--- a/pymerlin/_internal/_gateway.py
+++ b/pymerlin/_internal/_gateway.py
@@ -13,11 +13,10 @@
 
 @contextmanager
 def start_gateway(jar_path, java_executable='java'):
-    print("Starting gateway at " + jar_path)
     process = subprocess.Popen(
         [java_executable, '-jar', jar_path],
         stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-    print(process.stdout.readline().decode())  # wait for server to be ready
+    process.stdout.readline()  # wait for server to be ready
     try:
         gateway = JavaGateway(gateway_parameters=GatewayParameters(auto_convert=True),
                               callback_server_parameters=CallbackServerParameters())
diff --git a/pyproject.toml b/pyproject.toml
index 048636c..9a972e2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pymerlin"
-version = "0.0.2"
+version = "0.0.4-rc"
 dependencies = [
   "bokeh>=3.4.2",
   "numpy>=2.0.0",
diff --git a/requirements.txt b/requirements.txt
index 749372f..ca708f4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,3 +1,12 @@
 bokeh==3.4.2
 numpy==2.0.0
 py4j==0.10.9.7
+
+
+# Dev dependencies
+myst-parser
+build
+twine
+sphinx
+pytest
+furo
\ No newline at end of file