deploy: 2b955e6

open223 · Oct 16, 2024 · 961abb7 · 961abb7
1 parent 723afc1
commit 961abb7
Show file tree

Hide file tree

Showing 30 changed files with 61 additions and 99 deletions.
diff --git a/_images/connection-relationships.png b/_images/connection-relationships.png
diff --git a/_images/ex-1.svg b/_images/ex-1.svg
diff --git a/_images/glycol_example.png b/_images/glycol_example.png
diff --git a/_images/mixed_medium.png b/_images/mixed_medium.png
diff --git a/_sources/explanation/medium_mixtures.md b/_sources/explanation/medium_mixtures.md
@@ -0,0 +1,13 @@
+# Medium Mixtures
+
+The 223 standard includes a large set of enumerations, defined as a hierarchy of subclasses under the class `s223:EnumerationKind`.
+One important piece of this hierarchy is the class `s223:EnumerationKind-Substance` and its direct subclass `s223:Substance-Medium`. 
+It is this branch of the hierarchy where you can find what you would expect to be flowing in a building, such as water, air and electricity. It is important to understand how a medium is modeled, especially when that medium is a mixture. The diagram below sketches the structure of the hierarchy. The names of the classes are abbreviated for clarity, so `s223:Substance-Medium` is shown as Medium for example. In the standard, each of the names follows the hyphenated naming convention of \<parent class>-\<local class>.
+
+![MixedMedium](_static/images/mixed_medium.png)
+
+Note in the figure that there is a division of the Medium class into Mix and Constituent. The Mix class is further divided into Fluid and Power&Signal. Fluid means what you might think - a liquid or gas that typically flows inside some sort of conduit like a duct or a pipe. You can find Water and Air here. To capture the description of what is in a mixture, the model contains the class Constituent and its subclasses. These subclasses are intended to identify the constituents of a mixture. So, for example, a water-glycol mixture would be defined as `s223:Water-GlycolSolution`, with two Properties via the relation `s223:composedOf`. Each of these Properties has a relation `s223:ofConstituent` that identifies one of the constituents from the Medium-Constituent hierarchy. Each Property also captures any other defining information. This is illustrated in the following figure for a 30%  Water-Glycol mixture.
+
+![GlycolExample](_static/images/glycol_example.png)
+
+Mixtures (`s223:Medium-Mix`) and constituents (`s223:Medium-Constituent`) are modeled this way to allow for compatibility validation among ConnectionPoints and Connections. Two mediums are deemed compatible if they share at least one common constituent. 
diff --git a/_sources/explanation/mixed_media.md b/_sources/explanation/mixed_media.md
diff --git a/_sources/tutorials/model_exploration.ipynb b/_sources/tutorials/model_exploration.ipynb
@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "36c5d40d",
+   "id": "4bd770e0",
    "metadata": {},
    "source": [
     "# Model Exploration\n",
@@ -23,7 +23,7 @@
   {
    "cell_type": "code",
    "execution_count": 1,
-   "id": "e1de523f",
+   "id": "e0e180c7",
    "metadata": {},
    "outputs": [
     {
@@ -61,7 +61,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "3e38c285",
+   "id": "b3934c32",
    "metadata": {},
    "source": [
     "Next, we'll explore the model's size by printing the number of triples in it."
@@ -70,7 +70,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "3bc94386",
+   "id": "73ea9479",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -80,7 +80,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "047c0609",
+   "id": "ab5af9ca",
    "metadata": {},
    "source": [
     "Finally, we'll print the contents of the model since it's not that large."
@@ -89,7 +89,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "1ebe9ccd",
+   "id": "8a6b5069",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -99,7 +99,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "77690306",
+   "id": "a8f85ba2",
    "metadata": {},
    "source": [
     "## Model Querying\n",
@@ -114,7 +114,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "fce73811",
+   "id": "56dd90b9",
    "metadata": {},
    "outputs": [],
    "source": [