Skip to content
Snippets Groups Projects
0003-add-gluon-hoodselector-Integrate-VPN-Mode.patch 443 KiB
Newer Older
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <dia:object type="Standard - Text" version="1" id="O20">
+      <dia:attribute name="obj_pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:point val="4.825,11.825"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:rectangle val="4.825,11.23;4.825,11.9775"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:point val="4.825,11.825"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <dia:object type="Standard - Text" version="1" id="O21">
+      <dia:attribute name="obj_pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:point val="4.775,12.575"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:rectangle val="4.775,11.98;4.775,12.7275"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>##</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:point val="4.775,12.575"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="0"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
+    </dia:object>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <dia:object type="Flowchart - Ellipse" version="0" id="O22">
+      <dia:attribute name="obj_pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:point val="1.83,5.245"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:rectangle val="1.805,5.22;5.1191,7.64236"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="1.83,5.245"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="3.2640983876135579"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="2.372360167974596"/>
+      </dia:attribute>
+      <dia:attribute name="border_width">
+        <dia:real val="0.05000000074505806"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.35355339059327379"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:string>#Start#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:point val="3.46205,6.62618"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Text" version="1" id="O23">
+      <dia:attribute name="obj_pos">
+        <dia:point val="33.97,3.865"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="30.5337,3.27;37.4062,4.0175"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#default domain mode#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="33.97,3.865"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+      <dia:attribute name="valign">
+        <dia:enum val="3"/>
+      </dia:attribute>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+      <dia:attribute name="fill_color">
+        <dia:color val="#00ff00"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <dia:object type="Flowchart - Ellipse" version="0" id="O24">
+      <dia:attribute name="obj_pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:point val="30.38,4.57"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:rectangle val="30.355,4.545;37.7359,8.26046"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:point val="30.38,4.57"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:real val="7.3309270381183858"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+        <dia:real val="3.6654635190591929"/>
+      </dia:attribute>
+      <dia:attribute name="border_width">
+        <dia:real val="0.05000000074505806"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.35355339059327379"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:string>#set defaultDomain#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+            <dia:point val="34.0455,6.59773"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <dia:object type="Flowchart - Ellipse" version="0" id="O25">
+      <dia:attribute name="obj_pos">
+        <dia:point val="40.5379,5.19393"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="40.5129,5.16893;44.9872,7.43106"/>
+      </dia:attribute>
+      <dia:attribute name="elem_corner">
+        <dia:point val="40.5379,5.19393"/>
+      </dia:attribute>
+      <dia:attribute name="elem_width">
+        <dia:real val="4.4242658164348629"/>
+      </dia:attribute>
+      <dia:attribute name="elem_height">
+        <dia:real val="2.2121329082174346"/>
+      </dia:attribute>
+      <dia:attribute name="border_width">
+        <dia:real val="0.05000000074505806"/>
+      </dia:attribute>
+      <dia:attribute name="show_background">
+        <dia:boolean val="true"/>
+      </dia:attribute>
+      <dia:attribute name="padding">
+        <dia:real val="0.35355339059327379"/>
+      </dia:attribute>
+      <dia:attribute name="text">
+        <dia:composite type="text">
+          <dia:attribute name="string">
+            <dia:string>#Exit#</dia:string>
+          </dia:attribute>
+          <dia:attribute name="font">
+            <dia:font family="sans" style="0" name="Helvetica"/>
+          </dia:attribute>
+          <dia:attribute name="height">
+            <dia:real val="0.80000000000000004"/>
+          </dia:attribute>
+          <dia:attribute name="pos">
+            <dia:point val="42.75,6.495"/>
+          </dia:attribute>
+          <dia:attribute name="color">
+            <dia:color val="#000000"/>
+          </dia:attribute>
+          <dia:attribute name="alignment">
+            <dia:enum val="1"/>
+          </dia:attribute>
+        </dia:composite>
+      </dia:attribute>
+    </dia:object>
+    <dia:object type="Standard - Line" version="0" id="O26">
+      <dia:attribute name="obj_pos">
+        <dia:point val="37.7352,6.35918"/>
+      </dia:attribute>
+      <dia:attribute name="obj_bb">
+        <dia:rectangle val="37.7352,6.08231;40.5139,6.58227"/>
+      </dia:attribute>
+      <dia:attribute name="conn_endpoints">
+        <dia:point val="37.7352,6.35918"/>
+        <dia:point val="40.5139,6.32639"/>
+      </dia:attribute>
+      <dia:attribute name="numcp">
+        <dia:int val="1"/>
+      </dia:attribute>
+      <dia:attribute name="line_width">
+        <dia:real val="0"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow">
+        <dia:enum val="3"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_length">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:attribute name="end_arrow_width">
+        <dia:real val="0.5"/>
+      </dia:attribute>
+      <dia:connections>
+        <dia:connection handle="0" to="O24" connection="16"/>
+        <dia:connection handle="1" to="O25" connection="16"/>
+      </dia:connections>
+    </dia:object>
+  </dia:layer>
+</dia:diagram>
diff --git a/docs/package/gluon-hoodselector.rst b/docs/package/gluon-hoodselector.rst
new file mode 100644
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
index 00000000..0776fc67
--- /dev/null
+++ b/docs/package/gluon-hoodselector.rst
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
@@ -0,0 +1,128 @@
+gluon-hoodselector
+==================
+
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+This package provides an automatism of selecting the right domain network in an
+intelligent way. The job of the hoodselector is to automatically detect in which
+domain the node is located by its geolocation settings. Therefore the domains
+needs to have geostationary fixed quadrants defined as polygons or rectangles.
+Based on this information the hoodselector will select a domain from a list of
+known domains and adjust the domain related settings e.g. VPN, wireless ...
+This package makes able to build scaled decentralised mesh-networks in a dynamical
+and easy extendable way.
+
+Background informations
+-----------------------
+
+The main problem of the Nordwest Freifunk community was the quickly rising
+number of nodes in the network. This indirectly affected the stability of the
+network because the noise inside the network, e.g. management traffic from
+the batman-adv protocol, was rising, too. Inside the community there were some
+ideas like building separate firmwares for each region. This kind of solution
+would have problems with splitting regions again and problems with scattered
+nodes, which belong to an other region. Therefore we decided to develop a
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+dynamic and decentralised management of regions called domains.
+The Hoodselector's task is to choose the "right" domains in an intelligent way
+and to hold the network together and accessible.
+
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+A domain is defined by geostationary fixed shapes by using longitude & latitude
+in combination with the domain configuration system. Below you can see a visual
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+example of regional domain:
+
+.. image:: hoodmap.jpeg
+
+Hoodselector logic
+------------------
+
+The following is an abstract state diagramm which gives an overview
+of the process:
+
+.. image:: gluon-hoodselector.svg
+
+The sequence of this diagramm is given the priority of running modes.
+Each mode will be explained seperatedly below.
+
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+geolocation mode
+^^^^^^^^^^^^^^^^
+
+This mode will be entered only if a node have set a geo location.
+Nodes which have a position will set their domain based on
+it. If a node has a position which is outside of all defined shapes,
+it will continue with the next mode. If no position is set,
+the node will continue with the next mode too.
+
+default domain mode
+^^^^^^^^^^^^^^^^^^^
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+This mode will be entered if no other modes before fits.
+It will simply set the default domain.
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+Domain shapes
+-------------
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+There are two types of domainss: one without any defined shapes
+which has to be unique and others which contain shapes.
+
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+* **default domain**
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+default domain: The default domain doesn’t have shapes and is the inverted form of
+all other domains with geo coordinates. It will be entered if no node matches to a
+real domain. A suggested approach is to define the "old" network as default domain
+and gradually migrate parts from there to shape defined domains ("real domain").
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+* **real domains**
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+A real domain contains shapes, which are described by three dimensional arrays and
+represents the geographical size of the domain. There are two possible
+definitions of these shapes. The first one is using rectangulars so that only
+two coordinates per box are needed to reconstruct it (see below for an example).
+The second one is using polygons which can have multible edges.
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+Each domain can have multiple defined shapes.
+
+.. image:: rectangle-example.svg
+
+site.conf
+---------
+
+The designer of the shapes should always ensure that no overlapping polygons
+will be created!
+Here is an example of a rectangular definition of a shape:
+Example::
+
+  hoodselector = {
+    shapes = {
+      {
+        {
+          lat = 53.128,
+          lon = 8.187
+        },
+        {
+          lat = 53.163,
+          lon = 8.216
+        },
+      },
+    },
+  },
+
+Here is an example of a triangle defined shape:
+Example::
+
+  hoodselector = {
+    shapes = {
+      {
+        {
+          lat = 53.128,
+          lon = 8.187
+        },
+        {
+          lat = 53.163,
+          lon = 8.216
+        },
+        {
+          lat = 53.196,
+          lon = 8.194
+        },
+      },
+    },
+  },
+
+This package is incompatible with the :doc:`gluon-config-mode-domain-select`.
diff --git a/docs/package/gluon-hoodselector.svg b/docs/package/gluon-hoodselector.svg
new file mode 100644
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
index 00000000..fbf79a14
--- /dev/null
+++ b/docs/package/gluon-hoodselector.svg
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+<svg width="44cm" height="21cm" viewBox="36 65 864 412" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="102.36" y1="128.823" x2="185.552" y2="129.326"/>
+    <polygon style="fill: #000000" points="185.521,134.325 195.551,129.386 185.582,124.326 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="185.521,134.325 195.551,129.386 185.582,124.326 "/>
+  </g>
+  <g>
+    <ellipse style="fill: #ffffff" cx="257.52" cy="129.76" rx="60.966" ry="46.2698"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="257.52" cy="129.76" rx="60.966" ry="46.2698"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="257.52" y="133.66">
+      <tspan x="257.52" y="133.66">Load domains</tspan>
+    </text>
+  </g>
+  <g>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="318.984" y1="129.76" x2="345.941" y2="129.76"/>
+    <polygon style="fill: #000000" points="345.941,134.76 355.941,129.76 345.941,124.76 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="345.941,134.76 355.941,129.76 345.941,124.76 "/>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <rect style="fill: #00ff00" x="106" y="65.1" width="77.75" height="14.95"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="106" y="77">
+      <tspan x="106" y="77">initialization</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <rect style="fill: #00ff00" x="360.45" y="65.1" width="115.1" height="14.95"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="418" y="77">
+      <tspan x="418" y="77">geolocation mode</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <ellipse style="fill: #ffffff" cx="420.521" cy="129.76" rx="63.5828" ry="36.4784"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="420.521" cy="129.76" rx="63.5828" ry="36.4784"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="420.521" y="133.66">
+      <tspan x="420.521" y="133.66">geo pos. exist</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="484.092" y1="129.344" x2="596.635" y2="128.607"/>
+    <polygon style="fill: #000000" points="596.668,133.607 606.635,128.541 596.602,123.607 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="596.668,133.607 606.635,128.541 596.602,123.607 "/>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="521" y="122">
+    <tspan x="521" y="122">false</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <ellipse style="fill: #ffffff" cx="419.999" cy="263.001" rx="64.5067" ry="32.2534"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="419.999" cy="263.001" rx="64.5067" ry="32.2534"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="419.999" y="266.901">
+      <tspan x="419.999" y="266.901">get geoDomain</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="420.376" y1="166.73" x2="420.169" y2="219.76"/>
+    <polygon style="fill: #000000" points="415.169,219.74 420.129,229.76 425.168,219.779 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="415.169,219.74 420.129,229.76 425.168,219.779 "/>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="428" y="195">
+    <tspan x="428" y="195">true</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="420" y1="295.735" x2="420" y2="321.575"/>
+    <polygon style="fill: #000000" points="415,321.575 420,331.575 425,321.575 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="415,321.575 420,331.575 425,321.575 "/>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="465.257" y1="239.593" x2="620.21" y2="159.449"/>
+    <polygon style="fill: #000000" points="622.507,163.89 629.092,154.855 617.913,155.008 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="622.507,163.89 629.092,154.855 617.913,155.008 "/>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <ellipse style="fill: #ffffff" cx="420.001" cy="364.499" rx="63.8471" ry="31.9236"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="420.001" cy="364.499" rx="63.8471" ry="31.9236"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="420.001" y="368.399">
+      <tspan x="420.001" y="368.399">set geoDomain</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="516" y="195.25">
+    <tspan x="516" y="195.25">false</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="430" y="313.25">
+    <tspan x="430" y="313.25">true</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <ellipse style="fill: #ffffff" cx="420.001" cy="453.499" rx="44.2427" ry="22.1213"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="420.001" cy="453.499" rx="44.2427" ry="22.1213"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="420.001" y="457.399">
+      <tspan x="420.001" y="457.399">Exit</tspan>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+    <line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="420.001" y1="396.929" x2="420.001" y2="420.38"/>
+    <polygon style="fill: #000000" points="415.001,420.38 420.001,430.38 425.001,420.38 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="415.001,420.38 420.001,430.38 425.001,420.38 "/>
+  </g>
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="912.352" y="129.946">
+    <tspan x="912.352" y="129.946"></tspan>
+  </text>
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="912.352" y="129.946">
+    <tspan x="912.352" y="129.946"></tspan>
+  </text>
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="96.5" y="236.5">
+    <tspan x="96.5" y="236.5"></tspan>
+  </text>
+  <text font-size="12.8" style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal" x="95.5" y="251.5">
+    <tspan x="95.5" y="251.5"></tspan>
+  </text>
+  <g>
+    <ellipse style="fill: #ffffff" cx="69.241" cy="128.624" rx="32.641" ry="23.7236"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="69.241" cy="128.624" rx="32.641" ry="23.7236"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="69.241" y="132.524">
+      <tspan x="69.241" y="132.524">Start</tspan>
+    </text>
+  </g>
Jan-Tarek Butt's avatar
Jan-Tarek Butt committed
+  <g>
+    <rect style="fill: #00ff00" x="610.675" y="65.4" width="137.45" height="14.95"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="679.4" y="77.3">
+      <tspan x="679.4" y="77.3">default domain mode</tspan>
+    </text>
+  </g>
+  <g>
+    <ellipse style="fill: #ffffff" cx="680.909" cy="128.055" rx="73.3093" ry="36.6546"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="680.909" cy="128.055" rx="73.3093" ry="36.6546"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="680.909" y="131.955">
+      <tspan x="680.909" y="131.955">set defaultDomain</tspan>
+    </text>
+  </g>
+  <g>
+    <ellipse style="fill: #ffffff" cx="855.001" cy="126" rx="44.2427" ry="22.1213"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" cx="855.001" cy="126" rx="44.2427" ry="22.1213"/>
+    <text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="855.001" y="129.9">
+      <tspan x="855.001" y="129.9">Exit</tspan>
+    </text>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 0.02; stroke: #000000" x1="754.705" y1="127.184" x2="800.277" y2="126.646"/>
+    <polygon style="fill: #000000" points="800.336,131.645 810.276,126.528 800.218,121.646 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 0.02; stroke: #000000" points="800.336,131.645 810.276,126.528 800.218,121.646 "/>
+  </g>
1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000
+</svg>
diff --git a/docs/package/hoodmap.jpeg b/docs/package/hoodmap.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..e2ffc3e6975d319600c6543b2448786b1b352c1b
GIT binary patch
literal 298171
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