Add developer docs

author JvD_Ericsson <jeff.van.dam@est.tech>

Fri, 7 Jun 2024 12:53:56 +0000 (13:53 +0100)

committer JEFF VAN DAM <jeff.van.dam@est.tech>

Tue, 11 Jun 2024 15:04:39 +0000 (15:04 +0000)
author JvD_Ericsson <jeff.van.dam@est.tech>
Fri, 7 Jun 2024 12:53:56 +0000 (13:53 +0100)
committer JEFF VAN DAM <jeff.van.dam@est.tech>
Tue, 11 Jun 2024 15:04:39 +0000 (15:04 +0000)
diff --git a/.gitignore b/.gitignore

index 713206a..3569c70 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -31,3 +31,6 @@ yang-parser/src/test/resources/_orig-modules/_3gpp*.yang
  yang-parser/src/test/resources/_orig-modules/iana*.yang
  pgsql-schema-generator/src/test/resources/generate-defaults/import/*.yang
  teiv/src/main/resources/models/import/*.yang
+
+.tox
+docs/_build
+\ No newline at end of file
diff --git a/.readthedocs.yaml b/.readthedocs.yaml

new file mode 100644 (file)

index 0000000..10a0cdb
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,35 @@
+#  ============LICENSE_START=======================================================
+#  Copyright (C) 2024 Ericsson
+#  Modifications Copyright (C) 2024 OpenInfra Foundation Europe
+#  ================================================================================
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+#  SPDX-License-Identifier: Apache-2.0
+#  ============LICENSE_END=========================================================
+---
+version: 2
+
+formats:
+  - htmlzip
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+python:
+  install:
+  - requirements: docs/requirements-docs.txt
+
+sphinx:
+  configuration: docs/conf.py
diff --git a/docs/_static/data-model/equipment-ran.svg b/docs/_static/data-model/equipment-ran.svg

new file mode 100644 (file)

index 0000000..066132a
--- /dev/null
+++ b/docs/_static/data-model/equipment-ran.svg
@@ -0,0 +1 @@
+<svg width="2353" height="648" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="45" y="744" width="2353" height="648"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-45 -744)"><rect x="45" y="744" width="2353" height="568" fill="#FAFAFA"/><rect x="45" y="1312" width="2353" height="71.9999" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 926.094 1361)">Equipment</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1098.54 1361)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1112.29 1361)">RAN Object </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1302.5 1361)">R</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1325.99 1361)">elationships</text><rect x="988" y="1144" width="453" height="61.9999" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1067.2 1188)">AntennaCapability</text><path d="M982.491 1178.2 744.135 1178.2 744.135 969.671 749.865 969.671 749.865 1175.33 747 1172.47 982.491 1172.47ZM956.434 1156.82 988.176 1175.33 956.434 1193.85C955.068 1194.65 953.314 1194.19 952.516 1192.82 951.719 1191.45 952.181 1189.7 953.547 1188.9L981.047 1172.86 981.047 1177.81 953.547 1161.77C952.181 1160.97 951.719 1159.22 952.516 1157.85 953.314 1156.48 955.068 1156.02 956.434 1156.82ZM728.484 995.728 747 963.987 765.516 995.728C766.313 997.095 765.852 998.849 764.485 999.646 763.118 1000.44 761.364 999.982 760.567 998.615L744.526 971.115 749.474 971.115 733.433 998.615C732.635 999.982 730.881 1000.44 729.515 999.646 728.148 998.849 727.687 997.095 728.484 995.728Z"/><rect x="619" y="1051" width="256" height="47.0001" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 697.484 1085)">SERVES</text><rect x="1488" y="895" width="362" height="61.9999" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1619.19 939)">Sector</text><rect x="553" y="889" width="388" height="74.9999" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 620.83 939)">AntennaModule</text><path d="M5.67192-2.86458 276.46-2.86458 276.46 0.000360892 273.596-2.86422 541.519-2.86422 541.519 2.86494 270.731 2.86494 270.731 0 273.596 2.86458 5.67192 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM515.463-18.5157 547.204 0.000360892 515.463 18.5164C514.096 19.3136 512.342 18.852 511.545 17.4854 510.748 16.1189 511.209 14.3648 512.576 13.5677L540.076-2.47401 540.076 2.47473 512.576-13.5669C511.209-14.3641 510.748-16.1181 511.545-17.4847 512.342-18.8512 514.096-19.3128 515.463-18.5157Z" transform="matrix(-1 1.22465e-16 1.22465e-16 1 1488.19 926)"/><rect x="1081" y="903" width="256" height="47.0001" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1155.87 936)">GROUPS</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 1909.26 1274)">RAN</text><rect x="1848" y="1250" width="40.9999" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2095.72 1274)">Equipment</text><rect x="2034" y="1250" width="41" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/equipment-relationships.svg b/docs/_static/data-model/equipment-relationships.svg

new file mode 100644 (file)

index 0000000..b87aee0
--- /dev/null
+++ b/docs/_static/data-model/equipment-relationships.svg
@@ -0,0 +1 @@
+<svg width="2344" height="559" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="45" y="630" width="2344" height="559"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-45 -630)"><rect x="45" y="630" width="2344" height="478" fill="#FAFAFA"/><rect x="45" y="1109" width="2344" height="71.0001" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 964.348 1157)">Equipment </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1144.82 1157)">Object </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1254.82 1157)">R</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1278.31 1157)">elationships</text><rect x="399" y="738" width="559" height="78.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 552.259 790)">AntennaModule</text><rect x="1765" y="954" width="201" height="78" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1835.22 1006)">Site</text><path d="M5.67193-2.86458 179.862-2.86458 179.862 1081.31 174.133 1081.31 174.133 0 176.998 2.86458 5.67193 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM195.514 1055.26 176.998 1087 158.482 1055.26C157.685 1053.89 158.146 1052.14 159.513 1051.34 160.879 1050.54 162.633 1051 163.431 1052.37L179.472 1079.87 174.523 1079.87 190.565 1052.37C191.362 1051 193.116 1050.54 194.483 1051.34 195.849 1052.14 196.311 1053.89 195.514 1055.26Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 678 816)"/><rect x="1087" y="973" width="256" height="39.9999" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1119.91 1002)">INSTALLED_AT</text></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/equipment.svg b/docs/_static/data-model/equipment.svg

new file mode 100644 (file)

index 0000000..7e66d1a
--- /dev/null
+++ b/docs/_static/data-model/equipment.svg
@@ -0,0 +1 @@
+<svg width="2382" height="2035" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><g transform="translate(-46 -517)"><rect x="47.0001" y="517" width="2381" height="2030" fill="#FAFAFA"/><rect x="46.0001" y="2472" width="2380" height="71.0002" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 891.661 2520)">Equipment </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1072.13 2520)">M</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1101.92 2520)">anaged </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1228.54 2520)">O</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1254.32 2520)">bjects </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1354.58 2520)">and </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1422.75 2520)">Attributes</text><rect x="739" y="585" width="944" height="69.0001" fill="#0050CA"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1000.17 632)">o</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1020.23 632)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1033.98 632)">ran</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1086.68 632)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1100.43 632)">smo</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1166.89 632)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1180.64 632)">teiv</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1239.08 632)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1252.83 632)">equipment</text><rect x="651" y="756" width="389" height="78" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 719.676 808)">AntennaModule</text><rect x="1539" y="756" width="200" height="78" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1608.49 808)">Site</text><path d="M1214.15 654 1214.15 708.002 846 708.002 848.865 705.137 848.865 756.274 843.135 756.274 843.135 702.273 1211.29 702.273 1208.42 705.137 1208.42 654ZM859.75 756.274C859.75 763.868 853.594 770.024 846 770.024 838.406 770.024 832.25 763.868 832.25 756.274 832.25 748.68 838.406 742.524 846 742.524 853.594 742.524 859.75 748.68 859.75 756.274Z"/><path d="M0-2.86458 54.0016-2.86458 54.0016 427.852 51.137 424.987 102.274 424.987 102.274 430.717 48.2724 430.717 48.2724 0 51.137 2.86458 0 2.86458ZM102.274 414.102C109.868 414.102 116.024 420.258 116.024 427.852 116.024 435.446 109.868 441.602 102.274 441.602 94.6801 441.602 88.524 435.446 88.524 427.852 88.524 420.258 94.6801 414.102 102.274 414.102Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1211 654)"/><rect x="427" y="908" width="837" height="347" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1295" y="912" width="685" height="94.0002" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><path d="M848.865 834 848.865 907.516 843.136 907.516 843.135 834ZM859.75 907.516C859.75 915.11 853.594 921.266 846 921.266 838.406 921.266 832.25 915.11 832.25 907.516 832.25 899.922 838.406 893.766 846 893.766 853.594 893.766 859.75 899.922 859.75 907.516Z"/><path d="M2.86439-0.0329156 3.76193 78.0732-1.96685 78.139-2.86439 0.0329156ZM14.6466 77.9481C14.7339 85.5416 8.64895 91.768 1.05553 91.8552-6.53788 91.9425-12.7643 85.8575-12.8516 78.2641-12.9388 70.6707-6.85387 64.4443 0.739545 64.357 8.33296 64.2698 14.5594 70.3547 14.6466 77.9481Z" transform="matrix(-1 0 0 1 1638.9 834)"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 961)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 961)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 997)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 997)">antennaModelNumber: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1033)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1033)">mechanicalAntennaBearing: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1069)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1069)">mechanicalAntennaTilt: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1105)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1105)">positionWithinSector: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1141)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1141)">totalTilt: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1177)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1177)">electricalAntennaTilt: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 917.244 1214)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 473.052 1214)">antennaBeamWidth</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 721.125 1214)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1647.03 957)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1357.86 957)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1647.03 991)">String</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1357.86 991)">name:</text></g><rect x="1613" y="1318" width="331" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1774.02 1359)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1636.78 1359)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1651.68 1359)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1662.56 1359)">north:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1774.02 1394)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1636.78 1394)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1651.68 1394)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1662.56 1394)">east:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1774.02 1430)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1636.78 1430)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1651.68 1430)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1662.56 1430)">up:</text><rect x="1368" y="1845" width="253" height="62.0002" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1489.94 1882)">location</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1399.42 1882)">choice:</text></g><rect x="1365" y="1998" width="330" height="122" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1528.71 2034)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1384.85 2034)">latitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1528.71 2069)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1384.85 2069)">longitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1528.71 2104)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1384.85 2104)">height:</text></g><rect x="1710" y="1998" width="219" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1773.55 2037)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1737.14 2037)">x:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1773.55 2072)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1737.14 2072)">y:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1773.55 2107)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1737.14 2107)">z:</text></g><path d="M0-2.86458 5.72917-2.86458 5.72917 2.86458 0 2.86458ZM11.4583-2.86458 17.1875-2.86458 17.1875 2.86458 11.4583 2.86458ZM22.9167-2.86458 28.6458-2.86458 28.6458 2.86458 22.9167 2.86458ZM34.375-2.86458 40.1042-2.86458 40.1042 2.86458 34.375 2.86458ZM48.4193 0.278612 48.4193 6.00778 42.6901 6.00778 42.6901 0.278612ZM48.4193 11.7369 48.4193 17.4661 42.6901 17.4661 42.6901 11.7369ZM48.4193 23.1953 48.4193 28.9244 42.6901 28.9244 42.6901 23.1953ZM48.4193 34.6536 48.4193 40.3828 42.6901 40.3828 42.6901 34.6536ZM48.4193 46.1119 48.4193 51.8411 42.6901 51.8411 42.6901 46.1119ZM48.4193 57.5703 48.4193 63.2994 42.6901 63.2994 42.6901 57.5703ZM48.4193 69.0286 48.4193 74.7578 42.6901 74.7578 42.6901 69.0286ZM48.4193 80.4869 48.4193 86.2161 42.6901 86.2161 42.6901 80.4869ZM48.4193 91.9453 48.4193 97.6744 42.6901 97.6744 42.6901 91.9453ZM48.4193 103.404 48.4193 109.133 42.6901 109.133 42.6901 103.404ZM48.4193 114.862 48.4193 120.591 42.6901 120.591 42.6901 114.862ZM48.4193 126.32 48.4193 132.049 42.6901 132.049 42.6901 126.32ZM48.4193 137.779 48.4193 143.508 42.6901 143.508 42.6901 137.779ZM48.4193 149.237 48.4193 154.966 42.6901 154.966 42.6901 149.237ZM48.4193 160.695 48.4193 166.424 42.6901 166.424 42.6901 160.695ZM48.4193 172.154 48.4193 177.883 42.6901 177.883 42.6901 172.154ZM48.4193 183.612 48.4193 189.341 42.6901 189.341 42.6901 183.612ZM48.4193 195.07 48.4193 200.799 42.6901 200.799 42.6901 195.07ZM48.4193 206.529 48.4193 212.258 42.6901 212.258 42.6901 206.529ZM48.4193 217.987 48.4193 223.716 42.6901 223.716 42.6901 217.987ZM48.4193 229.445 48.4193 235.174 42.6901 235.174 42.6901 229.445ZM48.4193 240.904 48.4193 246.633 42.6901 246.633 42.6901 240.904ZM48.4193 252.362 48.4193 258.091 42.6901 258.091 42.6901 252.362ZM48.4193 263.82 48.4193 269.549 42.6901 269.549 42.6901 263.82ZM48.4193 275.279 48.4193 281.008 42.6901 281.008 42.6901 275.279ZM48.4193 286.737 48.4193 292.466 42.6901 292.466 42.6901 286.737ZM48.4193 298.195 48.4193 303.924 42.6901 303.924 42.6901 298.195ZM48.4193 309.654 48.4193 315.383 42.6901 315.383 42.6901 309.654ZM48.4193 321.112 48.4193 325.349 45.5547 322.485 47.0466 322.485 47.0466 328.214 42.6901 328.214 42.6901 321.112ZM52.7758 322.485 58.505 322.485 58.505 328.214 52.7758 328.214ZM64.2342 322.485 69.9633 322.485 69.9633 328.214 64.2342 328.214ZM75.6925 322.485 81.4217 322.485 81.4217 328.214 75.6925 328.214ZM87.1508 322.485 91.1091 322.485 91.1091 328.214 87.1508 328.214ZM91.1091 311.599C98.703 311.599 104.859 317.755 104.859 325.349 104.859 332.943 98.703 339.099 91.1091 339.099 83.5152 339.099 77.3591 332.943 77.3591 325.349 77.3591 317.755 83.5152 311.599 91.1091 311.599Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1494 1907)"/><path d="M0-2.86458 5.72917-2.86458 5.72917 2.86458 0 2.86458ZM11.4583-2.86458 17.1875-2.86458 17.1875 2.86458 11.4583 2.86458ZM22.9167-2.86458 28.6458-2.86458 28.6458 2.86458 22.9167 2.86458ZM34.375-2.86458 40.1042-2.86458 40.1042 2.86458 34.375 2.86458ZM48.1914 0.506512 48.1914 6.23568 42.4622 6.23568 42.4622 0.506512ZM48.1914 11.9648 48.1914 17.694 42.4622 17.694 42.4622 11.9648ZM48.1914 23.4232 48.1914 29.1523 42.4622 29.1523 42.4622 23.4232ZM48.1914 34.8815 48.1914 35.9579 45.3268 33.0933 49.9796 33.0933 49.9796 38.8225 42.4622 38.8225 42.4622 34.8815ZM55.7088 33.0933 61.438 33.0933 61.438 38.8225 55.7088 38.8225ZM67.1671 33.0933 72.8963 33.0933 72.8963 38.8225 67.1671 38.8225ZM78.6255 33.0933 84.3546 33.0933 84.3546 38.8225 78.6255 38.8225ZM90.0838 33.0933 90.6536 33.0933 90.6536 38.8225 90.0838 38.8225ZM90.6536 22.2079C98.2476 22.2079 104.404 28.364 104.404 35.9579 104.404 43.5518 98.2476 49.7079 90.6536 49.7079 83.0597 49.7079 76.9036 43.5518 76.9036 35.9579 76.9036 28.364 83.0597 22.2079 90.6536 22.2079Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1494 1907)"/><path d="M1496.86 1187 1496.86 1192.73 1491.14 1192.73 1491.14 1187ZM1496.86 1198.46 1496.86 1204.19 1491.14 1204.19 1491.14 1198.46ZM1496.86 1209.92 1496.86 1215.65 1491.14 1215.65 1491.14 1209.92ZM1496.86 1221.38 1496.86 1227.1 1491.14 1227.1 1491.14 1221.38ZM1496.86 1232.83 1496.86 1238.56 1491.14 1238.56 1491.14 1232.83ZM1496.86 1244.29 1496.86 1250.02 1491.14 1250.02 1491.14 1244.29ZM1496.86 1255.75 1496.86 1261.48 1491.14 1261.48 1491.14 1255.75ZM1496.86 1267.21 1496.86 1272.94 1491.14 1272.94 1491.14 1267.21ZM1496.86 1278.67 1496.86 1284.4 1491.14 1284.4 1491.14 1278.67ZM1496.86 1290.12 1496.86 1295.85 1491.14 1295.85 1491.14 1290.12ZM1496.86 1301.58 1496.86 1307.31 1491.14 1307.31 1491.14 1301.58ZM1496.86 1313.04 1496.86 1318.77 1491.14 1318.77 1491.14 1313.04ZM1496.86 1324.5 1496.86 1330.23 1491.14 1330.23 1491.14 1324.5ZM1496.86 1335.96 1496.86 1341.69 1491.14 1341.69 1491.14 1335.96ZM1496.86 1347.42 1496.86 1353.15 1491.14 1353.15 1491.14 1347.42ZM1496.86 1358.88 1496.86 1364.6 1491.14 1364.6 1491.14 1358.88ZM1496.86 1370.33 1496.86 1376.06 1491.14 1376.06 1491.14 1370.33ZM1496.86 1381.79 1496.86 1387.52 1491.14 1387.52 1491.14 1381.79ZM1496.86 1393.25 1496.86 1398.98 1491.14 1398.98 1491.14 1393.25ZM1496.86 1404.71 1496.86 1410.44 1491.14 1410.44 1491.14 1404.71ZM1496.86 1416.17 1496.86 1421.9 1491.14 1421.9 1491.14 1416.17ZM1496.86 1427.62 1496.86 1433.35 1491.14 1433.35 1491.14 1427.62ZM1496.86 1439.08 1496.86 1444.81 1491.14 1444.81 1491.14 1439.08ZM1496.86 1450.54 1496.86 1456.27 1491.14 1456.27 1491.14 1450.54ZM1496.86 1462 1496.86 1467.73 1491.14 1467.73 1491.14 1462ZM1496.86 1473.46 1496.86 1479.19 1491.14 1479.19 1491.14 1473.46ZM1496.86 1484.92 1496.86 1490.65 1491.14 1490.65 1491.14 1484.92ZM1496.86 1496.38 1496.86 1502.1 1491.14 1502.1 1491.14 1496.38ZM1496.86 1507.83 1496.86 1513.56 1491.14 1513.56 1491.14 1507.83ZM1496.86 1519.29 1496.86 1525.02 1491.14 1525.02 1491.14 1519.29ZM1496.86 1530.75 1496.86 1536.48 1491.14 1536.48 1491.14 1530.75ZM1496.86 1542.21 1496.86 1547.94 1491.14 1547.94 1491.14 1542.21ZM1496.86 1553.67 1496.86 1559.4 1491.14 1559.4 1491.14 1553.67ZM1496.86 1565.12 1496.86 1570.85 1491.14 1570.85 1491.14 1565.12ZM1496.86 1576.58 1496.86 1582.31 1491.14 1582.31 1491.14 1576.58ZM1496.86 1588.04 1496.86 1593.77 1491.14 1593.77 1491.14 1588.04ZM1496.86 1599.5 1496.86 1605.23 1491.14 1605.23 1491.14 1599.5ZM1496.86 1610.96 1496.86 1616.69 1491.14 1616.69 1491.14 1610.96ZM1496.86 1622.42 1496.86 1628.15 1491.14 1628.15 1491.14 1622.42ZM1496.86 1633.88 1496.86 1639.6 1491.14 1639.6 1491.14 1633.88ZM1496.86 1645.33 1496.86 1651.06 1491.14 1651.06 1491.14 1645.33ZM1496.86 1656.79 1496.86 1662.52 1491.14 1662.52 1491.14 1656.79ZM1496.86 1668.25 1496.86 1673.98 1491.14 1673.98 1491.14 1668.25ZM1496.86 1679.71 1496.86 1685.44 1491.14 1685.44 1491.14 1679.71ZM1496.86 1691.17 1496.86 1696.9 1491.14 1696.9 1491.14 1691.17ZM1496.86 1702.62 1496.86 1708.35 1491.14 1708.35 1491.14 1702.62ZM1496.86 1714.08 1496.86 1719.81 1491.14 1719.81 1491.14 1714.08ZM1496.86 1725.54 1496.86 1731.27 1491.14 1731.27 1491.14 1725.54ZM1496.86 1737 1496.86 1742.73 1491.14 1742.73 1491.14 1737ZM1496.86 1748.46 1496.86 1754.19 1491.14 1754.19 1491.14 1748.46ZM1496.86 1759.92 1496.86 1765.65 1491.14 1765.65 1491.14 1759.92ZM1496.86 1771.38 1496.86 1777.1 1491.14 1777.1 1491.14 1771.38ZM1496.86 1782.83 1496.86 1788.56 1491.14 1788.56 1491.14 1782.83ZM1496.86 1794.29 1496.86 1800.02 1491.14 1800.02 1491.14 1794.29ZM1496.86 1805.75 1496.86 1811.48 1491.14 1811.48 1491.14 1805.75ZM1496.86 1817.21 1496.86 1822.94 1491.14 1822.94 1491.14 1817.21ZM1496.86 1828.67 1496.86 1834.4 1491.14 1834.4 1491.14 1828.67ZM1496.86 1840.12 1496.86 1845.73 1491.14 1845.73 1491.14 1840.12ZM1507.75 1845.73C1507.75 1853.32 1501.59 1859.48 1494 1859.48 1486.41 1859.48 1480.25 1853.32 1480.25 1845.73 1480.25 1838.13 1486.41 1831.98 1494 1831.98 1501.59 1831.98 1507.75 1838.13 1507.75 1845.73Z"/><rect x="1364" y="1485" width="414" height="96.9999" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#FAFAFA"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1649.12 1524)">s</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1661.15 1524)">tring</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1391.21 1524)">alternate</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1503.5 1524)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1514.39 1524)">system:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1649.12 1558)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1391.21 1558)">astronomical</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1550.48 1558)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1561.37 1558)">body</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1621.52 1558)">:</text><rect x="1365" y="1637" width="412" height="122" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#FAFAFA"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1620.62 1673)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1391.21 1673)">geodetic</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1495.48 1673)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1506.37 1673)">datum:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1620.62 1708)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1391.21 1708)">coord</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1459.39 1708)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1470.27 1708)">accuracy:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1620.62 1743)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1391.21 1743)">height</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1469.13 1743)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1480.01 1743)">accuracy:</text><path d="M1573.86 1581.99 1573.97 1637.19 1568.25 1637.2 1568.14 1582.01ZM1584.86 1637.17C1584.88 1644.76 1578.73 1650.93 1571.14 1650.95 1563.54 1650.96 1557.38 1644.82 1557.36 1637.22 1557.34 1629.63 1563.49 1623.46 1571.08 1623.45 1578.68 1623.43 1584.84 1629.58 1584.86 1637.17Z"/><rect x="1324" y="1085" width="627" height="103" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1524.53 1129)">timestamp  </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1667.19 1129)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1785.21 1129)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1795.52 1129)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1840.21 1129)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1850.52 1129)">time</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1524.53 1162)">valid</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1585.26 1162)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1596.14 1162)">until: </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1664.89 1162)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1782.92 1162)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1793.23 1162)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1837.92 1162)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1848.23 1162)">time</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1368.36 1129)">geo</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1413.04 1129)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1368.36 1162)">location</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1466.33 1162)">:</text><path d="M2.86455-0.0137442 3.2471 79.716-2.482 79.7435-2.86455 0.0137442ZM14.1324 79.6638C14.1688 87.2576 8.04235 93.4432 0.448518 93.4796-7.14531 93.5161-13.3309 87.3896-13.3673 79.7958-13.4037 72.2019-7.27725 66.0164 0.316574 65.9799 7.9104 65.9435 14.096 72.07 14.1324 79.6638Z" transform="matrix(-1 0 0 1 1638.38 1006)"/><path d="M1781.86 1187 1781.86 1318.52 1776.14 1318.52 1776.14 1187ZM1792.75 1318.52C1792.75 1326.12 1786.59 1332.27 1779 1332.27 1771.41 1332.27 1765.25 1326.12 1765.25 1318.52 1765.25 1310.93 1771.41 1304.77 1779 1304.77 1786.59 1304.77 1792.75 1310.93 1792.75 1318.52Z"/><path d="M0-2.86458 152.04-2.86458 152.04 149.561 149.176 146.697 298.351 146.697 298.351 152.426 146.311 152.426 146.311 0 149.176 2.86458 0 2.86458ZM298.351 135.811C305.945 135.811 312.101 141.967 312.101 149.561 312.101 157.155 305.945 163.311 298.351 163.311 290.757 163.311 284.601 157.155 284.601 149.561 284.601 141.967 290.757 135.811 298.351 135.811Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1421 1187)"/><rect x="819" y="1565" width="331" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 979.46 1606)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 842.219 1606)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 857.115 1606)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 868 1606)">north:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 979.46 1642)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 842.219 1642)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 857.115 1642)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 868 1642)">east:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 979.46 1677)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 842.219 1677)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 857.115 1677)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 868 1677)">up:</text><rect x="573" y="2093" width="253" height="60.9998" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 695.374 2130)">location</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 604.853 2130)">choice:</text></g><rect x="571" y="2245" width="330" height="122" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 734.15 2281)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 590.286 2281)">latitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 734.15 2316)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 590.286 2316)">longitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 734.15 2352)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 590.286 2352)">height:</text></g><rect x="916" y="2245" width="219" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 978.987 2284)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 942.573 2284)">x:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 978.987 2319)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 942.573 2319)">y:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 978.987 2354)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 942.573 2354)">z:</text></g><path d="M0-2.86458 5.72917-2.86458 5.72917 2.86458 0 2.86458ZM11.4583-2.86458 17.1875-2.86458 17.1875 2.86458 11.4583 2.86458ZM22.9167-2.86458 28.6458-2.86458 28.6458 2.86458 22.9167 2.86458ZM34.375-2.86458 40.1042-2.86458 40.1042 2.86458 34.375 2.86458ZM48.4193 0.278612 48.4193 6.00778 42.6901 6.00778 42.6901 0.278612ZM48.4193 11.7369 48.4193 17.4661 42.6901 17.4661 42.6901 11.7369ZM48.4193 23.1953 48.4193 28.9244 42.6901 28.9244 42.6901 23.1953ZM48.4193 34.6536 48.4193 40.3828 42.6901 40.3828 42.6901 34.6536ZM48.4193 46.1119 48.4193 51.8411 42.6901 51.8411 42.6901 46.1119ZM48.4193 57.5703 48.4193 63.2994 42.6901 63.2994 42.6901 57.5703ZM48.4193 69.0286 48.4193 74.7578 42.6901 74.7578 42.6901 69.0286ZM48.4193 80.4869 48.4193 86.2161 42.6901 86.2161 42.6901 80.4869ZM48.4193 91.9453 48.4193 97.6744 42.6901 97.6744 42.6901 91.9453ZM48.4193 103.404 48.4193 109.133 42.6901 109.133 42.6901 103.404ZM48.4193 114.862 48.4193 120.591 42.6901 120.591 42.6901 114.862ZM48.4193 126.32 48.4193 132.049 42.6901 132.049 42.6901 126.32ZM48.4193 137.779 48.4193 143.508 42.6901 143.508 42.6901 137.779ZM48.4193 149.237 48.4193 154.966 42.6901 154.966 42.6901 149.237ZM48.4193 160.695 48.4193 166.424 42.6901 166.424 42.6901 160.695ZM48.4193 172.154 48.4193 177.883 42.6901 177.883 42.6901 172.154ZM48.4193 183.612 48.4193 189.341 42.6901 189.341 42.6901 183.612ZM48.4193 195.07 48.4193 200.799 42.6901 200.799 42.6901 195.07ZM48.4193 206.529 48.4193 212.258 42.6901 212.258 42.6901 206.529ZM48.4193 217.987 48.4193 223.716 42.6901 223.716 42.6901 217.987ZM48.4193 229.445 48.4193 235.174 42.6901 235.174 42.6901 229.445ZM48.4193 240.904 48.4193 246.633 42.6901 246.633 42.6901 240.904ZM48.4193 252.362 48.4193 258.091 42.6901 258.091 42.6901 252.362ZM48.4193 263.82 48.4193 269.549 42.6901 269.549 42.6901 263.82ZM48.4193 275.279 48.4193 281.008 42.6901 281.008 42.6901 275.279ZM48.4193 286.737 48.4193 292.466 42.6901 292.466 42.6901 286.737ZM48.4193 298.195 48.4193 303.924 42.6901 303.924 42.6901 298.195ZM48.4193 309.654 48.4193 315.383 42.6901 315.383 42.6901 309.654ZM48.4193 321.112 48.4193 325.349 45.5547 322.485 47.0466 322.485 47.0466 328.214 42.6901 328.214 42.6901 321.112ZM52.7758 322.485 58.505 322.485 58.505 328.214 52.7758 328.214ZM64.2342 322.485 69.9633 322.485 69.9633 328.214 64.2342 328.214ZM75.6925 322.485 81.4217 322.485 81.4217 328.214 75.6925 328.214ZM87.1508 322.485 91.1091 322.485 91.1091 328.214 87.1508 328.214ZM91.1091 311.599C98.703 311.599 104.859 317.755 104.859 325.349 104.859 332.943 98.703 339.099 91.1091 339.099 83.5152 339.099 77.3591 332.943 77.3591 325.349 77.3591 317.755 83.5152 311.599 91.1091 311.599Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 700 2154)"/><path d="M0-2.86458 5.72917-2.86458 5.72917 2.86458 0 2.86458ZM11.4583-2.86458 17.1875-2.86458 17.1875 2.86458 11.4583 2.86458ZM22.9167-2.86458 28.6458-2.86458 28.6458 2.86458 22.9167 2.86458ZM34.375-2.86458 40.1042-2.86458 40.1042 2.86458 34.375 2.86458ZM48.1914 0.506512 48.1914 6.23568 42.4622 6.23568 42.4622 0.506512ZM48.1914 11.9648 48.1914 17.694 42.4622 17.694 42.4622 11.9648ZM48.1914 23.4232 48.1914 29.1523 42.4622 29.1523 42.4622 23.4232ZM48.1914 34.8815 48.1914 35.9579 45.3268 33.0933 49.9796 33.0933 49.9796 38.8225 42.4622 38.8225 42.4622 34.8815ZM55.7088 33.0933 61.438 33.0933 61.438 38.8225 55.7088 38.8225ZM67.1671 33.0933 72.8963 33.0933 72.8963 38.8225 67.1671 38.8225ZM78.6255 33.0933 84.3546 33.0933 84.3546 38.8225 78.6255 38.8225ZM90.0838 33.0933 90.6536 33.0933 90.6536 38.8225 90.0838 38.8225ZM90.6536 22.2079C98.2476 22.2079 104.404 28.364 104.404 35.9579 104.404 43.5518 98.2476 49.7079 90.6536 49.7079 83.0597 49.7079 76.9036 43.5518 76.9036 35.9579 76.9036 28.364 83.0597 22.2079 90.6536 22.2079Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 700 2154)"/><path d="M702.864 1434 702.864 1439.73 697.135 1439.73 697.135 1434ZM702.864 1445.46 702.864 1451.19 697.135 1451.19 697.135 1445.46ZM702.865 1456.92 702.865 1462.65 697.135 1462.65 697.135 1456.92ZM702.865 1468.38 702.865 1474.1 697.135 1474.1 697.135 1468.38ZM702.865 1479.83 702.865 1485.56 697.135 1485.56 697.135 1479.83ZM702.865 1491.29 702.865 1497.02 697.135 1497.02 697.135 1491.29ZM702.865 1502.75 702.865 1508.48 697.135 1508.48 697.135 1502.75ZM702.865 1514.21 702.865 1519.94 697.135 1519.94 697.135 1514.21ZM702.865 1525.67 702.865 1531.4 697.135 1531.4 697.135 1525.67ZM702.865 1537.13 702.865 1542.85 697.135 1542.85 697.135 1537.13ZM702.865 1548.58 702.865 1554.31 697.135 1554.31 697.135 1548.58ZM702.865 1560.04 702.865 1565.77 697.135 1565.77 697.135 1560.04ZM702.865 1571.5 702.865 1577.23 697.135 1577.23 697.135 1571.5ZM702.865 1582.96 702.865 1588.69 697.135 1588.69 697.135 1582.96ZM702.865 1594.42 702.865 1600.15 697.135 1600.15 697.135 1594.42ZM702.865 1605.88 702.865 1611.6 697.135 1611.6 697.135 1605.88ZM702.865 1617.33 702.865 1623.06 697.135 1623.06 697.135 1617.33ZM702.865 1628.79 702.865 1634.52 697.135 1634.52 697.135 1628.79ZM702.865 1640.25 702.865 1645.98 697.135 1645.98 697.135 1640.25ZM702.865 1651.71 702.865 1657.44 697.135 1657.44 697.135 1651.71ZM702.865 1663.17 702.865 1668.9 697.135 1668.9 697.135 1663.17ZM702.865 1674.63 702.865 1680.35 697.135 1680.35 697.135 1674.63ZM702.865 1686.08 702.865 1691.81 697.135 1691.81 697.135 1686.08ZM702.865 1697.54 702.865 1703.27 697.135 1703.27 697.135 1697.54ZM702.865 1709 702.865 1714.73 697.135 1714.73 697.135 1709ZM702.865 1720.46 702.865 1726.19 697.135 1726.19 697.135 1720.46ZM702.865 1731.92 702.865 1737.65 697.135 1737.65 697.135 1731.92ZM702.865 1743.38 702.865 1749.1 697.135 1749.1 697.135 1743.38ZM702.865 1754.83 702.865 1760.56 697.135 1760.56 697.135 1754.83ZM702.865 1766.29 702.865 1772.02 697.135 1772.02 697.135 1766.29ZM702.865 1777.75 702.865 1783.48 697.135 1783.48 697.135 1777.75ZM702.865 1789.21 702.865 1794.94 697.135 1794.94 697.135 1789.21ZM702.865 1800.67 702.865 1806.4 697.135 1806.4 697.135 1800.67ZM702.865 1812.13 702.865 1817.85 697.135 1817.85 697.135 1812.13ZM702.865 1823.58 702.865 1829.31 697.135 1829.31 697.135 1823.58ZM702.865 1835.04 702.865 1840.77 697.135 1840.77 697.135 1835.04ZM702.865 1846.5 702.865 1852.23 697.135 1852.23 697.135 1846.5ZM702.865 1857.96 702.865 1863.69 697.136 1863.69 697.135 1857.96ZM702.865 1869.42 702.865 1875.15 697.136 1875.15 697.136 1869.42ZM702.865 1880.88 702.865 1886.6 697.136 1886.6 697.136 1880.88ZM702.865 1892.33 702.865 1898.06 697.136 1898.06 697.136 1892.33ZM702.865 1903.79 702.865 1909.52 697.136 1909.52 697.136 1903.79ZM702.865 1915.25 702.865 1920.98 697.136 1920.98 697.136 1915.25ZM702.865 1926.71 702.865 1932.44 697.136 1932.44 697.136 1926.71ZM702.865 1938.17 702.865 1943.9 697.136 1943.9 697.136 1938.17ZM702.865 1949.63 702.865 1955.35 697.136 1955.35 697.136 1949.63ZM702.865 1961.08 702.865 1966.81 697.136 1966.81 697.136 1961.08ZM702.865 1972.54 702.865 1978.27 697.136 1978.27 697.136 1972.54ZM702.865 1984 702.865 1989.73 697.136 1989.73 697.136 1984ZM702.865 1995.46 702.865 2001.19 697.136 2001.19 697.136 1995.46ZM702.865 2006.92 702.865 2012.65 697.136 2012.65 697.136 2006.92ZM702.865 2018.38 702.865 2024.1 697.136 2024.1 697.136 2018.38ZM702.865 2029.83 702.865 2035.56 697.136 2035.56 697.136 2029.83ZM702.865 2041.29 702.865 2047.02 697.136 2047.02 697.136 2041.29ZM702.865 2052.75 702.865 2058.48 697.136 2058.48 697.136 2052.75ZM702.865 2064.21 702.865 2069.94 697.136 2069.94 697.136 2064.21ZM702.865 2075.67 702.865 2081.4 697.136 2081.4 697.136 2075.67ZM702.865 2087.12 702.865 2092.73 697.136 2092.73 697.136 2087.12ZM713.75 2092.73C713.75 2100.32 707.594 2106.48 700 2106.48 692.406 2106.48 686.25 2100.32 686.25 2092.73 686.25 2085.13 692.406 2078.98 700 2078.98 707.594 2078.98 713.75 2085.13 713.75 2092.73Z"/><rect x="569" y="1732" width="414" height="96.9999" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#FAFAFA"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 854.556 1772)">s</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 866.588 1772)">tring</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 596.646 1772)">alternate</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 708.937 1772)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 719.823 1772)">system:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 854.556 1806)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 596.646 1806)">astronomical</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 755.917 1806)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 766.802 1806)">body</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 826.958 1806)">:</text><rect x="570" y="1884" width="412" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#FAFAFA"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 826.055 1920)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 596.646 1920)">geodetic</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 700.917 1920)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 711.802 1920)">datum:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 826.055 1955)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 596.646 1955)">coord</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 664.823 1955)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 675.708 1955)">accuracy:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 826.055 1990)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 596.646 1990)">height</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 674.562 1990)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 685.448 1990)">accuracy:</text><path d="M778.864 1828.99 778.974 1884.19 773.245 1884.2 773.135 1829.01ZM789.86 1884.17C789.875 1891.76 783.731 1897.93 776.137 1897.95 768.543 1897.96 762.375 1891.82 762.36 1884.22 762.345 1876.63 768.489 1870.46 776.082 1870.45 783.676 1870.43 789.845 1876.58 789.86 1884.17Z"/><rect x="529" y="1333" width="628" height="103" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 729.965 1377)">timestamp  </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 872.622 1377)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 990.643 1377)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1000.96 1377)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1045.64 1377)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1055.95 1377)">time</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 729.965 1410)">valid</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 790.695 1410)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 801.58 1410)">until: </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 870.33 1410)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 988.351 1410)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 998.663 1410)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1043.35 1410)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1053.66 1410)">time</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 573.793 1377)">geo</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 618.48 1377)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 573.793 1410)">location</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 671.762 1410)">:</text><path d="M2.86455-0.0137442 3.2471 79.716-2.482 79.7435-2.86455 0.0137442ZM14.1324 79.6638C14.1688 87.2576 8.04235 93.4432 0.448518 93.4796-7.14531 93.5161-13.3309 87.3896-13.3673 79.7958-13.4037 72.2019-7.27725 66.0164 0.316574 65.9799 7.9104 65.9435 14.096 72.07 14.1324 79.6638Z" transform="matrix(-1 0 0 1 843.382 1253)"/><path d="M986.865 1434 986.865 1565.52 981.136 1565.52 981.136 1434ZM997.751 1565.52C997.751 1573.12 991.594 1579.27 984.001 1579.27 976.407 1579.27 970.251 1573.12 970.251 1565.52 970.251 1557.93 976.407 1551.77 984 1551.77 991.594 1551.77 997.751 1557.93 997.751 1565.52Z"/><path d="M0-2.86458 152.04-2.86458 152.04 149.561 149.176 146.697 298.351 146.697 298.351 152.426 146.311 152.426 146.311 0 149.176 2.86458 0 2.86458ZM298.351 135.811C305.945 135.811 312.101 141.967 312.101 149.561 312.101 157.155 305.945 163.311 298.351 163.311 290.757 163.311 284.601 157.155 284.601 149.561 284.601 141.967 290.757 135.811 298.351 135.811Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 627 1434)"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/oam-ran.svg b/docs/_static/data-model/oam-ran.svg

new file mode 100644 (file)

index 0000000..0ee7127
--- /dev/null
+++ b/docs/_static/data-model/oam-ran.svg
@@ -0,0 +1 @@
+<svg width="2321" height="1146" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="72" y="483" width="2321" height="1146"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-72 -483)"><rect x="71.9998" y="483" width="2321" height="1065" fill="#FAFAFA"/><rect x="71.9998" y="1548" width="2321" height="72.0002" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 983.237 1597)">OAM</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1062.3 1597)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1076.05 1597)">RAN Object </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1266.26 1597)">R</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1289.75 1597)">elationships</text><rect x="371" y="573" width="448" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 455.307 626)">ManagedElement</text><path d="M5.67157-2.86458 171.114-2.86458 171.114 748.883 165.385 748.883 165.385 0 168.249 2.86458 5.67157 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM186.765 722.825 168.249 754.567 149.733 722.825C148.936 721.459 149.398 719.705 150.764 718.908 152.131 718.11 153.885 718.572 154.682 719.939L170.723 747.439 165.775 747.439 181.816 719.939C182.614 718.572 184.368 718.11 185.734 718.908 187.101 719.705 187.562 721.459 186.765 722.825Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 595 653)"/><rect x="820" y="781" width="255" height="61.9999" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 884.229 821)">MANAGES</text><rect x="1349" y="781" width="559" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1494.92 834)">ENodeBFunction</text><rect x="1349" y="1355" width="559" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1497.91 1408)">GNBDUFunction</text><path d="M5.6712-2.86458 554.551-2.86458 554.551 748.883 548.822 748.883 548.822 0 551.687 2.86458 5.6712 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM570.203 722.825 551.687 754.567 533.171 722.825C532.374 721.459 532.835 719.705 534.202 718.908 535.568 718.11 537.322 718.572 538.12 719.939L554.161 747.439 549.212 747.439 565.254 719.939C566.051 718.572 567.805 718.11 569.172 718.908 570.538 719.705 571 721.459 570.203 722.825Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 595 653)"/><rect x="820" y="1169" width="255" height="55" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 884.229 1202)">MANAGES</text><rect x="1349" y="1164" width="559" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1477.29 1217)">GNBCUCPFunction</text><path d="M5.6712-2.86458 745.121-2.86458 745.121 748.883 739.391 748.883 739.391 0 742.256 2.86458 5.6712 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM760.772 722.825 742.256 754.567 723.74 722.825C722.943 721.459 723.404 719.705 724.771 718.908 726.138 718.11 727.892 718.572 728.689 719.939L744.73 747.439 739.782 747.439 755.823 719.939C756.62 718.572 758.375 718.11 759.741 718.908 761.108 719.705 761.569 721.459 760.772 722.825Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 595 653)"/><rect x="820" y="1357" width="255" height="55" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 884.229 1390)">MANAGES</text><path d="M5.67048-2.86458 361.914-2.86458 361.914 748.883 356.185 748.883 356.185 0 359.05 2.86458 5.67048 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM377.566 722.825 359.05 754.567 340.534 722.825C339.736 721.459 340.198 719.705 341.565 718.908 342.931 718.11 344.685 718.572 345.482 719.939L361.524 747.439 356.575 747.439 372.617 719.939C373.414 718.572 375.168 718.11 376.535 718.908 377.901 719.705 378.363 721.459 377.566 722.825Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 595 653)"/><rect x="820" y="972" width="255" height="56" fill="#FAFAFA"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 884.229 1005)">MANAGES</text><rect x="1349" y="972" width="559" height="78.9998" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1475.85 1025)">GNBCUUPFunction</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2095.52 1501)">OAM</text><rect x="2034" y="1476" width="41" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2259.48 1501)">RAN</text><rect x="2198" y="1476" width="41" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/oam.svg b/docs/_static/data-model/oam.svg

new file mode 100644 (file)

index 0000000..d072b8b
--- /dev/null
+++ b/docs/_static/data-model/oam.svg
@@ -0,0 +1 @@
+<svg width="2350" height="626" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="45" y="383" width="2350" height="626"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-45 -383)"><rect x="45" y="383" width="2350" height="617" fill="#FAFAFA"/><rect x="45" y="929" width="2350" height="70.9998" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 922.427 978)">OAM </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1009.51 978)">Managed </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1165.92 978)">O</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1191.7 978)">bjects </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1291.96 978)">and </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1360.14 978)">Attributes</text><rect x="749" y="473" width="943" height="69.0001" fill="#0050CA"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1061.19 520)">o</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1080.67 520)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1094.42 520)">ran</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1146.55 520)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1160.3 520)">smo</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1225.04 520)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1238.79 520)">teiv</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1296.09 520)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="36" transform="matrix(1 0 0 1 1309.84 520)">oam</text><rect x="1062" y="620" width="317" height="78.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1112.47 670)">ManagedElement</text><rect x="973" y="764" width="489" height="70.9998" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><path d="M1222.86 542 1222.86 620.296 1217.14 620.296 1217.14 542ZM1233.75 620.296C1233.75 627.89 1227.59 634.046 1220 634.046 1212.41 634.046 1206.25 627.89 1206.25 620.296 1206.25 612.702 1212.41 606.546 1220 606.546 1227.59 606.546 1233.75 612.702 1233.75 620.296Z"/><path d="M2.86458-1.60597e-05 2.86494 64.3727-2.86422 64.3727-2.86458 1.60597e-05ZM13.7504 64.3727C13.7504 71.9666 7.59435 78.1227 0.000437979 78.1227-7.59348 78.1228-13.7496 71.9667-13.7496 64.3728-13.7497 56.7789-7.59363 50.6228 0.000283806 50.6227 7.5942 50.6227 13.7503 56.7787 13.7504 64.3727Z" transform="matrix(-1 0 0 1 1220 699)"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1204.21 809)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1106.5 809)">id:</text></g></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/ran-relationships.svg b/docs/_static/data-model/ran-relationships.svg

new file mode 100644 (file)

index 0000000..cf4f396
--- /dev/null
+++ b/docs/_static/data-model/ran-relationships.svg
@@ -0,0 +1 @@
+<svg width="2358" height="1445" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="41" y="1417" width="2358" height="1445"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-41 -1417)"><rect x="40.9999" y="1417" width="2358" height="1437" fill="#FAFAFA"/><rect x="40.9999" y="2782" width="2358" height="72.0002" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1017.96 2831)">RAN </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1098.16 2831)">Object </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1208.16 2831)">R</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1231.65 2831)">elationships</text><rect x="0" y="0" width="345" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 436 1879)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 132.843 1932)">GNBDUFunction</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 1531)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1254.78 1584)">NRCellCU</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 1752)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1253.35 1804)">NRCellDU</text><rect x="0" y="0" width="374" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 465 2253)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 143.919 2306)">ENodeBFunction</text><rect x="0" y="0" width="455" height="78.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 2139)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1246.47 2191)">EUtranCell</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 1964)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1208.95 2016)">NrSectorCarrier</text><rect x="0" y="0" width="455" height="78.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 2369)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1196.63 2422)">LTESectorCarrier</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1559 2592)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1184.03 2644)">AntennaCapability</text><path d="M470.672 2290.14 644.338 2290.14 644.338 2408.79 641.474 2405.93 1099 2405.93 1099 2411.66 638.609 2411.66 638.609 2293 641.474 2295.86 470.672 2295.86ZM496.729 2311.52 464.987 2293 496.729 2274.48C498.095 2273.69 499.849 2274.15 500.646 2275.52 501.443 2276.88 500.982 2278.64 499.615 2279.43L472.115 2295.47 472.115 2290.53 499.615 2306.57C500.982 2307.36 501.443 2309.12 500.646 2310.49 499.849 2311.85 498.095 2312.31 496.729 2311.52ZM1072.95 2390.28 1104.69 2408.79 1072.95 2427.31C1071.58 2428.11 1069.83 2427.64 1069.03 2426.28 1068.23 2424.91 1068.69 2423.16 1070.06 2422.36L1097.56 2406.32 1097.56 2411.27 1070.06 2395.23C1068.69 2394.43 1068.23 2392.67 1069.03 2391.31 1069.83 2389.94 1071.58 2389.48 1072.95 2390.28Z"/><path d="M5.67176-2.86458 179.338-2.86458 179.338 114.591 176.474 111.726 634.003 111.726 634.003 117.455 173.609 117.455 173.609 0 176.474 2.86458 5.67176 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM607.946 96.0749 639.687 114.591 607.946 133.107C606.579 133.904 604.825 133.443 604.028 132.076 603.231 130.709 603.692 128.955 605.059 128.158L632.559 112.117 632.559 117.065 605.059 101.024C603.692 100.226 603.231 98.4724 604.028 97.1059 604.825 95.7393 606.579 95.2777 607.946 96.0749Z" transform="matrix(1 0 0 -1 465 2292.59)"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 958 2159)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 764.288 2192)">PROVIDES</text><path d="M5.67192-2.86458 209.92-2.86458 209.92 127.788 207.056 124.924 662.703 124.924 662.703 130.653 204.191 130.653 204.191 0 207.056 2.86458 5.67192 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM636.646 109.272 668.387 127.788 636.646 146.304C635.279 147.102 633.525 146.64 632.728 145.273 631.931 143.907 632.392 142.153 633.759 141.356L661.259 125.314 661.259 130.263 633.759 114.221C632.392 113.424 631.931 111.67 632.728 110.303 633.525 108.937 635.279 108.475 636.646 109.272Z" transform="matrix(1 0 0 -1 436 1918.79)"/><path d="M441.672 1916.14 645.92 1916.14 645.92 2003.45 643.056 2000.59 1098.7 2000.59 1098.7 2006.32 640.191 2006.32 640.191 1919 643.056 1921.86 441.672 1921.86ZM467.728 1937.52 435.987 1919 467.728 1900.48C469.095 1899.69 470.849 1900.15 471.646 1901.52 472.443 1902.88 471.982 1904.64 470.615 1905.43L443.115 1921.47 443.115 1916.53 470.615 1932.57C471.982 1933.36 472.443 1935.12 471.646 1936.49 470.849 1937.85 469.095 1938.31 467.728 1937.52ZM1072.65 1984.94 1104.39 2003.45 1072.65 2021.97C1071.28 2022.77 1069.53 2022.3 1068.73 2020.94 1067.93 2019.57 1068.39 2017.82 1069.76 2017.02L1097.26 2000.98 1097.26 2005.93 1069.76 1989.89C1068.39 1989.09 1067.93 1987.33 1068.73 1985.97 1069.53 1984.6 1071.28 1984.14 1072.65 1984.94Z"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 958 1765)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 764.288 1799)">PROVIDES</text><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 958 1982)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 764.288 2016)">PROVIDES</text><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 958 2390)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 764.288 2423)">PROVIDES</text><path d="M-5.6718 2.86458-82.5 2.86458-79.6354 0-79.6354 628.044-82.5 625.18-5.67152 625.18-5.67152 630.909-85.3646 630.909-85.3646-2.86458-5.6718-2.86458ZM-31.7285-18.516 0.0132769 0-31.7285 18.516C-33.0951 19.3132-34.8491 18.8516-35.6462 17.485-36.4434 16.1185-35.9818 14.3645-34.6153 13.5673L-7.11526-2.47437-7.11526 2.47437-34.6153-13.5673C-35.9818-14.3645-36.4434-16.1185-35.6462-17.485-34.8491-18.8516-33.0951-19.3132-31.7285-18.516ZM-31.7281 609.528 0.0136378 628.044-31.7281 646.56C-33.0947 647.358-34.8487 646.896-35.6459 645.529-36.443 644.163-35.9814 642.409-34.6149 641.612L-7.11489 625.57-7.11489 630.519-34.6149 614.477C-35.9814 613.68-36.443 611.926-35.6459 610.559-34.8487 609.193-33.0947 608.731-31.7281 609.528Z" transform="matrix(-1 0 0 1 1559 2003)"/><rect x="0" y="0" width="153" height="54" fill="#FAFAFA" transform="matrix(-1 0 0 1 1713 2266)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1603.85 2302)">USES</text><path d="M1334.86 1836.67 1334.86 1958.28 1329.14 1958.28 1329.14 1836.67ZM1313.48 1862.73 1332 1830.99 1350.52 1862.73C1351.31 1864.1 1350.85 1865.85 1349.49 1866.65 1348.12 1867.44 1346.36 1866.98 1345.57 1865.62L1329.53 1838.12 1334.47 1838.12 1318.43 1865.62C1317.64 1866.98 1315.88 1867.44 1314.52 1866.65 1313.15 1865.85 1312.69 1864.1 1313.48 1862.73ZM1350.52 1932.22 1332 1963.96 1313.48 1932.22C1312.69 1930.85 1313.15 1929.1 1314.52 1928.3 1315.88 1927.51 1317.64 1927.97 1318.43 1929.33L1334.47 1956.83 1329.53 1956.83 1345.57 1929.33C1346.36 1927.97 1348.12 1927.51 1349.49 1928.3 1350.85 1929.1 1351.31 1930.85 1350.52 1932.22Z"/><rect x="0" y="0" width="153" height="30.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1408 1879)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1298.78 1904)">USES</text><path d="M1334.86 2223.67 1334.86 2363.42 1329.14 2363.42 1329.14 2223.67ZM1313.48 2249.73 1332 2217.99 1350.52 2249.73C1351.31 2251.09 1350.85 2252.85 1349.49 2253.65 1348.12 2254.44 1346.36 2253.98 1345.57 2252.61L1329.53 2225.11 1334.47 2225.11 1318.43 2252.61C1317.64 2253.98 1315.88 2254.44 1314.52 2253.65 1313.15 2252.85 1312.69 2251.09 1313.48 2249.73ZM1350.52 2337.36 1332 2369.1 1313.48 2337.36C1312.69 2336 1313.15 2334.24 1314.52 2333.45 1315.88 2332.65 1317.64 2333.11 1318.43 2334.48L1334.47 2361.98 1329.53 2361.98 1345.57 2334.48C1346.36 2333.11 1348.12 2332.65 1349.49 2333.45 1350.85 2334.24 1351.31 2336 1350.52 2337.36Z"/><rect x="0" y="0" width="153" height="40.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1409 2275)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1299.9 2305)">USES</text><path d="M2.8646 5.67192 2.86493 137.894-2.86424 137.894-2.86457 5.67194ZM-18.516 31.7285 1.34955e-07-0.0132769 18.5161 31.7284C19.3133 33.095 18.8517 34.849 17.4851 35.6462 16.1186 36.4434 14.3645 35.9818 13.5674 34.6152L-2.47435 7.11526 2.47438 7.11525-13.5672 34.6153C-14.3644 35.9818-16.1184 36.4434-17.485 35.6463-18.8515 34.8491-19.3131 33.0951-18.516 31.7285ZM18.5163 111.837 0.000361542 143.579-18.5158 111.837C-19.3129 110.471-18.8513 108.717-17.4848 107.92-16.1182 107.123-14.3642 107.584-13.567 108.951L2.47471 136.451-2.47402 136.451 13.5676 108.951C14.3647 107.584 16.1188 107.122 17.4853 107.92 18.8519 108.717 19.3135 110.471 18.5163 111.837Z" transform="matrix(-1 0 0 1 1332 2448)"/><rect x="0" y="0" width="153" height="41.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1408 2496)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1298.78 2526)">USES</text><rect x="0" y="0" width="405" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 496 1531)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 142.092 1584)">GNBCUCPFunction</text><path d="M5.67168-2.86362 602.709-2.76269 602.708 2.96648 5.67071 2.86554ZM31.7254 18.5214-0.0132765-2.23773e-06 31.7316-18.5107C33.0983-19.3076 34.8523-18.8457 35.6492-17.479 36.4461-16.1123 35.9842-14.3584 34.6175-13.5614L7.11484 2.47557 7.11567-2.47316 34.613 13.5732C35.9794 14.3705 36.4407 16.1247 35.6433 17.4911 34.8459 18.8575 33.0918 19.3188 31.7254 18.5214ZM576.654-18.4185 608.393 0.102856 576.648 18.6135C575.281 19.4104 573.527 18.9486 572.73 17.5819 571.933 16.2152 572.395 14.4612 573.762 13.6643L601.265-2.37271 601.264 2.57602 573.766-13.4703C572.4-14.2677 571.939-16.0218 572.736-17.3882 573.533-18.7546 575.288-19.2159 576.654-18.4185Z" transform="matrix(1 0 0 -1 496 1571.1)"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 958 1545)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 764.288 1578)">PROVIDES</text><rect x="0" y="0" width="405" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 2358 1954)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 2105.82 2007)">Sector</text><path d="M1947.89 1996.39 1753.42 1996.39 1753.42 1791 1756.28 1793.86 1564.67 1793.86 1564.67 1788.14 1759.15 1788.14 1759.15 1993.53 1756.28 1990.66 1947.89 1990.66ZM1921.84 1975.01 1953.58 1993.53 1921.84 2012.05C1920.47 2012.84 1918.72 2012.38 1917.92 2011.01 1917.12 2009.65 1917.58 2007.89 1918.95 2007.1L1946.45 1991.06 1946.45 1996 1918.95 1979.96C1917.58 1979.17 1917.12 1977.41 1917.92 1976.04 1918.72 1974.68 1920.47 1974.22 1921.84 1975.01ZM1590.73 1809.52 1558.99 1791 1590.73 1772.48C1592.09 1771.69 1593.85 1772.15 1594.65 1773.51 1595.44 1774.88 1594.98 1776.64 1593.62 1777.43L1566.12 1793.47 1566.12 1788.53 1593.62 1804.57C1594.98 1805.36 1595.44 1807.12 1594.65 1808.48 1593.85 1809.85 1592.09 1810.31 1590.73 1809.52Z"/><path d="M5.67192-2.86458 200.147-2.86458 200.147 184.515 197.283 181.65 388.893 181.65 388.893 187.379 194.418 187.379 194.418 0 197.283 2.86458 5.67192 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM362.837 165.999 394.578 184.515 362.837 203.031C361.47 203.828 359.716 203.366 358.919 202 358.122 200.633 358.583 198.879 359.95 198.082L387.45 182.041 387.45 186.989 359.95 170.948C358.583 170.15 358.122 168.396 358.919 167.03 359.716 165.663 361.47 165.202 362.837 165.999Z" transform="matrix(-1 1.22465e-16 1.22465e-16 1 1953.56 1994)"/><rect x="0" y="0" width="255" height="40.0002" fill="#FAFAFA" transform="matrix(-1 0 0 1 1884 1843)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1703.14 1877)">GROUPS</text><rect x="0" y="0" width="184" height="47.9998" fill="#FAFAFA" transform="matrix(-1 0 0 1 1848 2062)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1703.08 2095)">GROUPS</text></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/ran.svg b/docs/_static/data-model/ran.svg

new file mode 100644 (file)

index 0000000..3481cb2
--- /dev/null
+++ b/docs/_static/data-model/ran.svg
@@ -0,0 +1 @@
+<svg width="2365" height="4045" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><g transform="translate(-58 -321)"><rect x="58.0001" y="321" width="2362" height="4036" fill="#FAFAFA"/><rect x="58.0001" y="4286" width="2362" height="71" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 944.909 4334)">RAN </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1025.12 4334)">Managed </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1181.52 4334)">O</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1207.3 4334)">bjects </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1307.57 4334)">and </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1375.74 4334)">Attributes</text><rect x="215" y="396" width="496" height="61.9999" fill="#0050CA"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 310.072 440)">o</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 330.124 440)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 343.874 440)">ran</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 396.583 440)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 410.333 440)">smo</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 476.791 440)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 490.541 440)">teiv</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 548.978 440)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 562.728 440)">ran</text><rect x="228" y="654" width="451" height="78.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 323.096 707)">GNBDUFunction</text><rect x="228" y="1308" width="496" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 323.385 1361)">GNBCUUP</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 490.104 1361)">Function</text><rect x="228" y="1598" width="358" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 330.413 1651)">NRCellCU</text><rect x="228" y="1927" width="358" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 328.98 1980)">NRCellDU</text><rect x="228" y="2259" width="452" height="78.9998" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 320.218 2312)">ENodeBFunction</text><path d="M215 429.865 132.5 429.865 135.365 427 135.365 693.706 132.5 690.841 228.313 690.841 228.313 696.57 129.635 696.57 129.635 424.135 215 424.135ZM228.313 679.956C235.907 679.956 242.063 686.112 242.063 693.706 242.063 701.299 235.907 707.456 228.313 707.456 220.719 707.456 214.563 701.299 214.563 693.706 214.563 686.112 220.719 679.956 228.313 679.956Z"/><path d="M215 429.865 132.5 429.865 135.364 427 135.364 1347.55 132.5 1344.68 228.313 1344.68 228.313 1350.41 129.635 1350.41 129.635 424.135 215 424.135ZM228.313 1333.8C235.907 1333.8 242.063 1339.95 242.063 1347.55 242.063 1355.14 235.907 1361.3 228.313 1361.3 220.719 1361.3 214.563 1355.14 214.563 1347.55 214.563 1339.95 220.719 1333.8 228.313 1333.8Z"/><path d="M215 429.865 132.5 429.865 135.365 427 135.365 1637.72 132.5 1634.86 228.313 1634.86 228.313 1640.58 129.636 1640.58 129.636 424.135 215 424.135ZM228.313 1623.97C235.907 1623.97 242.063 1630.13 242.063 1637.72 242.063 1645.31 235.907 1651.47 228.313 1651.47 220.719 1651.47 214.563 1645.31 214.563 1637.72 214.563 1630.13 220.719 1623.97 228.313 1623.97Z"/><path d="M215 429.865 132.5 429.865 135.364 427 135.364 1966.88 132.5 1964.02 228.313 1964.02 228.313 1969.75 129.635 1969.75 129.635 424.135 215 424.135ZM228.313 1953.13C235.907 1953.13 242.063 1959.29 242.063 1966.88 242.063 1974.47 235.907 1980.63 228.313 1980.63 220.719 1980.63 214.563 1974.47 214.563 1966.88 214.563 1959.29 220.719 1953.13 228.313 1953.13Z"/><path d="M215 429.865 132.5 429.865 135.364 427 135.364 2298.89 132.5 2296.02 228.313 2296.02 228.313 2301.75 129.635 2301.75 129.635 424.135 215 424.135ZM228.313 2285.14C235.907 2285.14 242.063 2291.29 242.063 2298.89 242.063 2306.48 235.907 2312.64 228.313 2312.64 220.719 2312.64 214.563 2306.48 214.563 2298.89 214.563 2291.29 220.719 2285.14 228.313 2285.14Z"/><rect x="828" y="581" width="682" height="225" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="228" y="993" width="452" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 302.744 1046)">GNBCUCP</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 466.598 1046)">Function</text><path d="M215 429.865 132.499 429.865 135.364 427 135.364 1032.7 132.499 1029.84 228.313 1029.84 228.313 1035.57 129.635 1035.57 129.635 424.135 215 424.135ZM228.313 1018.95C235.907 1018.95 242.063 1025.11 242.063 1032.7 242.063 1040.3 235.907 1046.45 228.313 1046.45 220.719 1046.45 214.563 1040.3 214.563 1032.7 214.563 1025.11 220.719 1018.95 228.313 1018.95Z"/><rect x="228" y="2538" width="384" height="79" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 335.071 2591)">EUtranCell</text><path d="M215 429.865 132.5 429.865 135.364 427 135.364 2577.69 132.5 2574.83 228.313 2574.83 228.313 2580.56 129.635 2580.56 129.635 424.135 215 424.135ZM228.313 2563.94C235.907 2563.94 242.063 2570.1 242.063 2577.69 242.063 2585.29 235.907 2591.44 228.313 2591.44 220.719 2591.44 214.563 2585.29 214.563 2577.69 214.563 2570.1 220.719 2563.94 228.313 2563.94Z"/><rect x="228" y="2896" width="420" height="79" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 315.529 2949)">NrSectorCarrier</text><path d="M215 429.865 132.5 429.865 135.364 427 135.364 2935.58 132.5 2932.72 228.313 2932.72 228.313 2938.45 129.635 2938.45 129.635 424.135 215 424.135ZM228.313 2921.83C235.907 2921.83 242.063 2927.99 242.063 2935.58 242.063 2943.18 235.907 2949.33 228.313 2949.33 220.719 2949.33 214.563 2943.18 214.563 2935.58 214.563 2927.99 220.719 2921.83 228.313 2921.83Z"/><rect x="228" y="3190" width="452" height="80" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 319.072 3243)">LTESectorCarrier</text><path d="M215 429.865 132.5 429.865 135.364 427 135.364 3230.02 132.5 3227.15 228.313 3227.15 228.313 3232.88 129.635 3232.88 129.635 424.135 215 424.135ZM228.313 3216.27C235.907 3216.27 242.063 3222.42 242.063 3230.02 242.063 3237.61 235.907 3243.77 228.313 3243.77 220.719 3243.77 214.563 3237.61 214.563 3230.02 214.563 3222.42 220.719 3216.27 228.313 3216.27Z"/><rect x="228" y="3452" width="452" height="80" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 306.468 3505)">AntennaCapability</text><path d="M215 429.865 132.5 429.865 135.364 427 135.364 3492.12 132.5 3489.25 228.313 3489.25 228.313 3494.98 129.635 3494.98 129.635 424.135 215 424.135ZM228.313 3478.37C235.907 3478.37 242.063 3484.52 242.063 3492.12 242.063 3499.71 235.907 3505.87 228.313 3505.87 220.719 3505.87 214.563 3499.71 214.563 3492.12 214.563 3484.52 220.719 3478.37 228.313 3478.37Z"/><rect x="1770" y="642" width="472" height="105" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="852" y="920" width="682" height="225" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1749" y="979" width="472" height="105" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="850" y="1265" width="681" height="165" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="854" y="1541" width="682" height="193" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1749" y="1586" width="472" height="105" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="848" y="1813" width="681" height="308" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="841" y="2233" width="681" height="132" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1742" y="2237" width="591" height="125" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="839" y="2411" width="682" height="332" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="839" y="2797" width="682" height="277" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="834" y="3122" width="812" height="216" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="844" y="3387" width="734" height="210" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><path d="M586 1964.14 847.258 1964.14 847.258 1969.86 586 1969.86ZM847.258 1953.25C854.852 1953.25 861.008 1959.41 861.008 1967 861.008 1974.59 854.852 1980.75 847.258 1980.75 839.664 1980.75 833.508 1974.59 833.508 1967 833.508 1959.41 839.664 1953.25 847.258 1953.25Z"/><path d="M586 1635.14 854.059 1635.14 854.059 1640.86 586 1640.86ZM854.059 1624.25C861.653 1624.25 867.809 1630.41 867.809 1638 867.809 1645.59 861.653 1651.75 854.059 1651.75 846.465 1651.75 840.309 1645.59 840.309 1638 840.309 1630.41 846.465 1624.25 854.059 1624.25Z"/><path d="M680 2296.14 840.88 2296.14 840.88 2301.86 680 2301.86ZM840.88 2285.25C848.474 2285.25 854.63 2291.41 854.63 2299 854.63 2306.59 848.474 2312.75 840.88 2312.75 833.286 2312.75 827.13 2306.59 827.13 2299 827.13 2291.41 833.286 2285.25 840.88 2285.25Z"/><path d="M0.00878827-2.86457 226.925-2.16841 226.908 3.56073-0.00878827 2.86457ZM226.959-13.0538C234.553-13.0305 240.69-6.85554 240.666 0.738345 240.643 8.33222 234.468 14.4694 226.874 14.4461 219.28 14.4228 213.143 8.24786 213.167 0.653978 213.19-6.9399 219.365-13.0771 226.959-13.0538Z" transform="matrix(1 0 0 -1 612 2577.7)"/><path d="M680 3489.14 843.833 3489.14 843.833 3494.87 680 3494.86ZM843.833 3478.25C851.427 3478.25 857.583 3484.41 857.583 3492 857.583 3499.59 851.427 3505.75 843.833 3505.75 836.239 3505.75 830.083 3499.59 830.083 3492 830.083 3484.41 836.239 3478.25 843.833 3478.25Z"/><path d="M680 3227.14 833.681 3227.14 833.681 3232.86 680 3232.86ZM833.681 3216.25C841.275 3216.25 847.431 3222.41 847.431 3230 847.431 3237.59 841.275 3243.75 833.681 3243.75 826.087 3243.75 819.931 3237.59 819.931 3230 819.931 3222.41 826.087 3216.25 833.681 3216.25Z"/><path d="M648 2933.14 838.947 2933.14 838.947 2938.86 648 2938.86ZM838.947 2922.25C846.541 2922.25 852.697 2928.41 852.697 2936 852.697 2943.59 846.541 2949.75 838.947 2949.75 831.353 2949.75 825.197 2943.59 825.197 2936 825.197 2928.41 831.354 2922.25 838.947 2922.25Z"/><path d="M724 1345.14 849.57 1345.14 849.57 1350.86 724 1350.86ZM849.57 1334.25C857.164 1334.25 863.32 1340.41 863.32 1348 863.32 1355.59 857.163 1361.75 849.57 1361.75 841.976 1361.75 835.82 1355.59 835.82 1348 835.82 1340.41 841.976 1334.25 849.57 1334.25Z"/><path d="M6.95498e-06-2.86458 148.643-2.86422 148.643 2.86494-6.95498e-06 2.86458ZM148.643-13.7496C156.237-13.7496 162.393-7.59352 162.393 0.000394276 162.393 7.59431 156.236 13.7504 148.643 13.7504 141.049 13.7503 134.893 7.59424 134.893 0.000327508 134.893-7.59359 141.049-13.7497 148.643-13.7496Z" transform="matrix(1 0 0 -1 679 694)"/><path d="M0.00869083-2.86457 172.253-2.342 172.236 3.38714-0.00869083 2.86457ZM172.286-13.2274C179.88-13.2043 186.017-7.02959 185.994 0.564288 185.971 8.15817 179.796 14.2955 172.202 14.2725 164.609 14.2495 158.471 8.07474 158.494 0.480856 158.517-7.11303 164.692-13.2504 172.286-13.2274Z" transform="matrix(1 0 0 -1 680 1032.52)"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 648)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 648)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 684)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 684)">gNBDUId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 720)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 720)">gNBId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 756)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 756)">gNBIdLength:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1132.35 993)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 993)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1132.35 1029)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1029)">gNBCUName: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1132.35 1065)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1065)">gNBId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1132.35 1101)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1101)">gNBIdLength:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 1325)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1325)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 1358)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1358)">gNBId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1114.82 1391)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1391)">gNBIdLength:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1973.53 687)">mcc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2041.71 687)">Mcc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1973.53 720)">mnc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2038.27 720)">Mnc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1798.55 687)">dUpLMNId:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1952.67 1027)">mcc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2014.55 1027)">Mcc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1952.67 1060)">mnc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2017.41 1060)">Mnc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1787.05 1027)">pLMNId:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1092.52 1606)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1606)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1092.52 1639)">u</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1107.42 1639)">int32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1639)">cellLocalId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1092.52 1672)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1672)">nCI: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1092.52 1705)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 894.234 1705)">nRTAC:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1087.06 1916)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 882.3 1916)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1087.06 1952)">u</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1101.95 1952)">int32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 882.3 1952)">cellLocalId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1087.06 1987)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 882.3 1987)">nCI: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1087.06 2023)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 882.3 2023)">nRPCI:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1087.06 2058)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 882.3 2058)">nRTAC</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1094.91 2284)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 884.365 2284)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1094.91 2322)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 884.365 2322)">eNBId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2452)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2452)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2486)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2486)">cellId</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 940.603 2486)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2520)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2520)">earfcndl</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2555)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2555)">earfcnul</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2589)">uint32</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2589)">dlChannelBandwidth</text></g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1113.05 2589)">: </text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2624)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2624)">Earfcn</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2658)">uint32</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2658)">channelBandwidth</text></g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1088.42 2658)">: </text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2692)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2692)">tac:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1158.44 2727)">enum: {fdd, tdd}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 871.853 2727)">duplexType:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 2851)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 2851)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 2886)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 2886)">arfcnDL</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 972.043 2886)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 2920)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 2920)">arFcnUL</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 977.773 2920)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 2955)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 2955)">frequencyDL</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 2990)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 2990)">frequencyUL:</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1153.57 3025)">uint32</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 3025)">bSChannelBwDL</text></g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1060.85 3025)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1136.3 3212)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 867.668 3212)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1136.3 3249)">enum</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1205.05 3249)">: {</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1228.54 3249)">normal_sector</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1396.4 3249)">, </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1408.43 3249)">left_digital_sector</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1619.27 3249)">, </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1136.3 3282)">right_digital_sector</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1363.17 3282)">,...}</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 867.668 3249)">sectorCarrierType</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1139.64 3455)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 3455)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1139.64 3490)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 3490)">eUtranFqBands</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1071.73 3490)">[]</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1092.36 3490)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1139.64 3525)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 3525)">geranFqBands</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1059.13 3525)">[]:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1139.64 3560)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 874.648 3560)">nRFqBands</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1021.89 3560)">[]</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1042.51 3560)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1974.41 1631)">mcc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2036.28 1631)">Mcc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1974.41 1664)">mnc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2039.15 1664)">Mnc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1781.44 1631)">pLMNId:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 2002.76 2279)">mcc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2064.63 2279)">int32 [0..999]</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 2002.76 2312)">mnc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2067.5 2312)">int32 [0..999]</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 2002.76 2345)">mncLength: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2152.86 2345)">int32 [2..3]</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1773.84 2279)">eNodeBPlmnId:</text></g><rect x="223" y="3672" width="452" height="79" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 399.257 3725)">Sector</text><rect x="839" y="3650" width="735" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1744" y="3660" width="557" height="103" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><path d="M0.00215806-2.86458 163.835-2.74116 163.831 2.98801-0.00215806 2.86458ZM163.843-13.6266C171.437-13.6208 177.589-7.46013 177.583 0.133784 177.577 7.7277 171.416 13.8791 163.823 13.8734 156.229 13.8677 150.077 7.70698 150.083 0.113067 150.089-7.48085 156.249-13.6323 163.843-13.6266Z" transform="matrix(1 0 0 -1 675 3711.12)"/><path d="M1574 3708.14 1744.22 3708.26 1744.22 3713.99 1574 3713.86ZM1744.23 3697.37C1751.82 3697.38 1757.98 3703.54 1757.97 3711.13 1757.96 3718.73 1751.8 3724.88 1744.21 3724.87 1736.62 3724.87 1730.46 3718.71 1730.47 3711.11 1730.48 3703.52 1736.64 3697.37 1744.23 3697.37Z"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3689)">string {key}</text></g><g><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3689)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3725)">uint64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3725)">sectorid</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 966.864 3725)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3760)">decimal64 {degrees}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3760)">azimuth</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 970.874 3760)">:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1894.65 3708)">timestamp  </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2037.31 3708)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2155.33 3708)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2165.64 3708)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2210.33 3708)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2220.64 3708)">time</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1894.65 3741)">valid</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1955.38 3741)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1966.27 3741)">until: </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2035.02 3741)">yang:date</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2153.04 3741)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2163.35 3741)">and</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2208.04 3741)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2218.35 3741)">time</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1771.03 3708)">geo</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1815.72 3708)">-</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1771.03 3741)">location</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1869 3741)">:</text><path d="M215 429.865 132.5 429.865 135.364 427 135.364 3711.56 132.5 3708.69 223.706 3708.69 223.706 3714.42 129.635 3714.42 129.635 424.135 215 424.135ZM223.706 3697.81C231.3 3697.81 237.456 3703.96 237.456 3711.56 237.456 3719.15 231.3 3725.31 223.706 3725.31 216.112 3725.31 209.956 3719.15 209.956 3711.56 209.956 3703.96 216.112 3697.81 223.706 3697.81Z"/><rect x="839" y="3826" width="735" height="97" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3871)">s</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1147.06 3871)">tring</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3871)">alternate</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 982.333 3871)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 993.218 3871)">system:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3906)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3906)">astronomical</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1029.31 3906)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1040.2 3906)">body</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1100.35 3906)">:</text><rect x="834" y="3958" width="734" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 3997)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 3997)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 884.937 3997)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 895.822 3997)">north:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 4032)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 4032)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 884.937 4032)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 895.822 4032)">east:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1135.03 4067)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 870.041 4067)">v</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 884.937 4067)">-</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 895.822 4067)">up:</text><rect x="834" y="4139" width="734" height="62" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1132.66 4179)">location</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 867.668 4179)">choice</text></g><path d="M2024.91 3763 2024.91 3797.32 756.495 3797.32 759.359 3794.45 759.359 3874.25 756.495 3871.38 839 3871.38 839 3877.11 753.63 3877.11 753.63 3791.59 2022.04 3791.59 2019.18 3794.45 2019.18 3763ZM839 3860.5C846.594 3860.5 852.75 3866.65 852.75 3874.25 852.75 3881.84 846.594 3888 839 3888 831.406 3888 825.25 3881.84 825.25 3874.25 825.25 3866.65 831.406 3860.5 839 3860.5Z"/><path d="M2025.45 3763 2025.45 3796.62 755.815 3796.62 758.679 3793.76 758.679 4019.48 755.815 4016.61 834 4016.61 834 4022.34 752.95 4022.34 752.95 3790.89 2022.59 3790.89 2019.72 3793.76 2019.72 3763ZM834 4005.73C841.594 4005.73 847.75 4011.88 847.75 4019.48 847.75 4027.07 841.594 4033.23 834 4033.23 826.406 4033.23 820.25 4027.07 820.25 4019.48 820.25 4011.88 826.406 4005.73 834 4005.73Z"/><path d="M2025.45 3763 2025.45 3768.73 2019.72 3768.73 2019.72 3763ZM2025.45 3774.46 2025.45 3780.19 2019.72 3780.19 2019.72 3774.46ZM2025.45 3785.92 2025.45 3791.65 2019.72 3791.65 2019.72 3785.92ZM2018.67 3796.32 2012.94 3796.32 2012.94 3790.59 2018.67 3790.59ZM2007.21 3796.32 2001.48 3796.32 2001.48 3790.59 2007.21 3790.59ZM1995.76 3796.32 1990.03 3796.32 1990.03 3790.59 1995.76 3790.59ZM1984.3 3796.32 1978.57 3796.32 1978.57 3790.59 1984.3 3790.59ZM1972.84 3796.32 1967.11 3796.32 1967.11 3790.59 1972.84 3790.59ZM1961.38 3796.32 1955.65 3796.32 1955.65 3790.59 1961.38 3790.59ZM1949.92 3796.32 1944.19 3796.32 1944.19 3790.59 1949.92 3790.59ZM1938.46 3796.32 1932.73 3796.32 1932.73 3790.59 1938.46 3790.59ZM1927.01 3796.32 1921.28 3796.32 1921.28 3790.59 1927.01 3790.59ZM1915.55 3796.32 1909.82 3796.32 1909.82 3790.59 1915.55 3790.59ZM1904.09 3796.32 1898.36 3796.32 1898.36 3790.59 1904.09 3790.59ZM1892.63 3796.32 1886.9 3796.32 1886.9 3790.59 1892.63 3790.59ZM1881.17 3796.32 1875.44 3796.32 1875.44 3790.59 1881.17 3790.59ZM1869.71 3796.32 1863.98 3796.32 1863.98 3790.59 1869.71 3790.59ZM1858.26 3796.32 1852.53 3796.32 1852.53 3790.59 1858.26 3790.59ZM1846.8 3796.32 1841.07 3796.32 1841.07 3790.59 1846.8 3790.59ZM1835.34 3796.32 1829.61 3796.32 1829.61 3790.59 1835.34 3790.59ZM1823.88 3796.32 1818.15 3796.32 1818.15 3790.59 1823.88 3790.59ZM1812.42 3796.32 1806.69 3796.32 1806.69 3790.59 1812.42 3790.59ZM1800.96 3796.32 1795.23 3796.32 1795.23 3790.59 1800.96 3790.59ZM1789.51 3796.32 1783.78 3796.32 1783.78 3790.59 1789.51 3790.59ZM1778.05 3796.32 1772.32 3796.32 1772.32 3790.59 1778.05 3790.59ZM1766.59 3796.32 1760.86 3796.32 1760.86 3790.59 1766.59 3790.59ZM1755.13 3796.32 1749.4 3796.32 1749.4 3790.59 1755.13 3790.59ZM1743.67 3796.32 1737.94 3796.32 1737.94 3790.59 1743.67 3790.59ZM1732.21 3796.32 1726.48 3796.32 1726.48 3790.59 1732.21 3790.59ZM1720.76 3796.32 1715.03 3796.32 1715.03 3790.59 1720.76 3790.59ZM1709.3 3796.32 1703.57 3796.32 1703.57 3790.59 1709.3 3790.59ZM1697.84 3796.32 1692.11 3796.32 1692.11 3790.59 1697.84 3790.59ZM1686.38 3796.32 1680.65 3796.32 1680.65 3790.59 1686.38 3790.59ZM1674.92 3796.32 1669.19 3796.32 1669.19 3790.59 1674.92 3790.59ZM1663.46 3796.32 1657.73 3796.32 1657.73 3790.59 1663.46 3790.59ZM1652.01 3796.32 1646.28 3796.32 1646.28 3790.59 1652.01 3790.59ZM1640.55 3796.32 1634.82 3796.32 1634.82 3790.59 1640.55 3790.59ZM1629.09 3796.32 1623.36 3796.32 1623.36 3790.59 1629.09 3790.59ZM1617.63 3796.32 1611.9 3796.32 1611.9 3790.59 1617.63 3790.59ZM1606.17 3796.32 1600.44 3796.32 1600.44 3790.59 1606.17 3790.59ZM1594.71 3796.32 1588.98 3796.32 1588.98 3790.59 1594.71 3790.59ZM1583.26 3796.32 1577.53 3796.32 1577.53 3790.59 1583.26 3790.59ZM1571.8 3796.32 1566.07 3796.32 1566.07 3790.59 1571.8 3790.59ZM1560.34 3796.32 1554.61 3796.32 1554.61 3790.59 1560.34 3790.59ZM1548.88 3796.32 1543.15 3796.32 1543.15 3790.59 1548.88 3790.59ZM1537.42 3796.32 1531.69 3796.32 1531.69 3790.59 1537.42 3790.59ZM1525.96 3796.32 1520.23 3796.32 1520.23 3790.59 1525.96 3790.59ZM1514.51 3796.32 1508.78 3796.32 1508.78 3790.59 1514.51 3790.59ZM1503.05 3796.32 1497.32 3796.32 1497.32 3790.59 1503.05 3790.59ZM1491.59 3796.32 1485.86 3796.32 1485.86 3790.59 1491.59 3790.59ZM1480.13 3796.32 1474.4 3796.32 1474.4 3790.59 1480.13 3790.59ZM1468.67 3796.32 1462.94 3796.32 1462.94 3790.59 1468.67 3790.59ZM1457.21 3796.32 1451.48 3796.32 1451.48 3790.59 1457.21 3790.59ZM1445.76 3796.32 1440.03 3796.32 1440.03 3790.59 1445.76 3790.59ZM1434.3 3796.32 1428.57 3796.32 1428.57 3790.59 1434.3 3790.59ZM1422.84 3796.32 1417.11 3796.32 1417.11 3790.59 1422.84 3790.59ZM1411.38 3796.32 1405.65 3796.32 1405.65 3790.59 1411.38 3790.59ZM1399.92 3796.32 1394.19 3796.32 1394.19 3790.59 1399.92 3790.59ZM1388.46 3796.32 1382.73 3796.32 1382.73 3790.59 1388.46 3790.59ZM1377.01 3796.32 1371.28 3796.32 1371.28 3790.59 1377.01 3790.59ZM1365.55 3796.32 1359.82 3796.32 1359.82 3790.59 1365.55 3790.59ZM1354.09 3796.32 1348.36 3796.32 1348.36 3790.59 1354.09 3790.59ZM1342.63 3796.32 1336.9 3796.32 1336.9 3790.59 1342.63 3790.59ZM1331.17 3796.32 1325.44 3796.32 1325.44 3790.59 1331.17 3790.59ZM1319.71 3796.32 1313.98 3796.32 1313.98 3790.59 1319.71 3790.59ZM1308.26 3796.32 1302.53 3796.32 1302.53 3790.59 1308.26 3790.59ZM1296.8 3796.32 1291.07 3796.32 1291.07 3790.59 1296.8 3790.59ZM1285.34 3796.32 1279.61 3796.32 1279.61 3790.59 1285.34 3790.59ZM1273.88 3796.32 1268.15 3796.32 1268.15 3790.59 1273.88 3790.59ZM1262.42 3796.32 1256.69 3796.32 1256.69 3790.59 1262.42 3790.59ZM1250.96 3796.32 1245.23 3796.32 1245.23 3790.59 1250.96 3790.59ZM1239.5 3796.32 1233.78 3796.32 1233.78 3790.59 1239.5 3790.59ZM1228.05 3796.32 1222.32 3796.32 1222.32 3790.59 1228.05 3790.59ZM1216.59 3796.32 1210.86 3796.32 1210.86 3790.59 1216.59 3790.59ZM1205.13 3796.32 1199.4 3796.32 1199.4 3790.59 1205.13 3790.59ZM1193.67 3796.32 1187.94 3796.32 1187.94 3790.59 1193.67 3790.59ZM1182.21 3796.32 1176.48 3796.32 1176.48 3790.59 1182.21 3790.59ZM1170.75 3796.32 1165.03 3796.32 1165.03 3790.59 1170.75 3790.59ZM1159.3 3796.32 1153.57 3796.32 1153.57 3790.59 1159.3 3790.59ZM1147.84 3796.32 1142.11 3796.32 1142.11 3790.59 1147.84 3790.59ZM1136.38 3796.32 1130.65 3796.32 1130.65 3790.59 1136.38 3790.59ZM1124.92 3796.32 1119.19 3796.32 1119.19 3790.59 1124.92 3790.59ZM1113.46 3796.32 1107.73 3796.32 1107.73 3790.59 1113.46 3790.59ZM1102 3796.32 1096.28 3796.32 1096.28 3790.59 1102 3790.59ZM1090.55 3796.32 1084.82 3796.32 1084.82 3790.59 1090.55 3790.59ZM1079.09 3796.32 1073.36 3796.32 1073.36 3790.59 1079.09 3790.59ZM1067.63 3796.32 1061.9 3796.32 1061.9 3790.59 1067.63 3790.59ZM1056.17 3796.32 1050.44 3796.32 1050.44 3790.59 1056.17 3790.59ZM1044.71 3796.32 1038.98 3796.32 1038.98 3790.59 1044.71 3790.59ZM1033.25 3796.32 1027.53 3796.32 1027.53 3790.59 1033.25 3790.59ZM1021.8 3796.32 1016.07 3796.32 1016.07 3790.59 1021.8 3790.59ZM1010.34 3796.32 1004.61 3796.32 1004.61 3790.59 1010.34 3790.59ZM998.88 3796.32 993.151 3796.32 993.151 3790.59 998.88 3790.59ZM987.422 3796.32 981.693 3796.32 981.693 3790.59 987.422 3790.59ZM975.963 3796.32 970.234 3796.32 970.234 3790.59 975.963 3790.59ZM964.505 3796.32 958.776 3796.32 958.776 3790.59 964.505 3790.59ZM953.047 3796.32 947.318 3796.32 947.318 3790.59 953.047 3790.59ZM941.588 3796.32 935.859 3796.32 935.859 3790.59 941.588 3790.59ZM930.13 3796.32 924.401 3796.32 924.401 3790.59 930.13 3790.59ZM918.672 3796.32 912.943 3796.32 912.943 3790.59 918.672 3790.59ZM907.213 3796.32 901.484 3796.32 901.484 3790.59 907.213 3790.59ZM895.755 3796.32 890.026 3796.32 890.026 3790.59 895.755 3790.59ZM884.297 3796.32 878.568 3796.32 878.568 3790.59 884.297 3790.59ZM872.838 3796.32 867.109 3796.32 867.109 3790.59 872.838 3790.59ZM861.38 3796.32 855.651 3796.32 855.651 3790.59 861.38 3790.59ZM849.922 3796.32 844.193 3796.32 844.193 3790.59 849.922 3790.59ZM838.463 3796.32 832.734 3796.32 832.734 3790.59 838.463 3790.59ZM827.005 3796.32 821.276 3796.32 821.276 3790.59 827.005 3790.59ZM815.547 3796.32 809.818 3796.32 809.818 3790.59 815.547 3790.59ZM804.088 3796.32 798.359 3796.32 798.359 3790.59 804.088 3790.59ZM792.63 3796.32 786.901 3796.32 786.901 3790.59 792.63 3790.59ZM781.172 3796.32 775.443 3796.32 775.443 3790.59 781.172 3790.59ZM769.713 3796.32 763.984 3796.32 763.984 3790.59 769.713 3790.59ZM758.255 3796.32 755.826 3796.32 758.691 3793.46 758.691 3796.76 752.962 3796.76 752.962 3790.59 758.255 3790.59ZM758.691 3802.49 758.691 3808.22 752.962 3808.22 752.962 3802.49ZM758.691 3813.95 758.691 3819.68 752.962 3819.68 752.962 3813.95ZM758.691 3825.41 758.691 3831.13 752.962 3831.13 752.962 3825.41ZM758.691 3836.86 758.691 3842.59 752.962 3842.59 752.962 3836.86ZM758.691 3848.32 758.691 3854.05 752.962 3854.05 752.962 3848.32ZM758.691 3859.78 758.691 3865.51 752.962 3865.51 752.962 3859.78ZM758.691 3871.24 758.691 3876.97 752.962 3876.97 752.962 3871.24ZM758.691 3882.7 758.691 3888.43 752.962 3888.43 752.962 3882.7ZM758.691 3894.16 758.691 3899.88 752.962 3899.88 752.962 3894.16ZM758.691 3905.61 758.691 3911.34 752.962 3911.34 752.962 3905.61ZM758.691 3917.07 758.691 3922.8 752.962 3922.8 752.962 3917.07ZM758.691 3928.53 758.691 3934.26 752.962 3934.26 752.962 3928.53ZM758.691 3939.99 758.691 3945.72 752.962 3945.72 752.962 3939.99ZM758.691 3951.45 758.691 3957.18 752.962 3957.18 752.962 3951.45ZM758.691 3962.91 758.691 3968.63 752.962 3968.63 752.962 3962.91ZM758.691 3974.36 758.691 3980.09 752.962 3980.09 752.962 3974.36ZM758.691 3985.82 758.691 3991.55 752.962 3991.55 752.962 3985.82ZM758.691 3997.28 758.691 4003.01 752.962 4003.01 752.962 3997.28ZM758.691 4008.74 758.691 4014.47 752.962 4014.47 752.962 4008.74ZM758.691 4020.2 758.691 4025.93 752.962 4025.93 752.962 4020.2ZM758.691 4031.66 758.691 4037.38 752.962 4037.38 752.962 4031.66ZM758.691 4043.11 758.691 4048.84 752.962 4048.84 752.962 4043.11ZM758.691 4054.57 758.691 4060.3 752.962 4060.3 752.962 4054.57ZM758.691 4066.03 758.691 4071.76 752.962 4071.76 752.962 4066.03ZM758.691 4077.49 758.691 4083.22 752.962 4083.22 752.962 4077.49ZM758.691 4088.95 758.691 4094.68 752.962 4094.68 752.962 4088.95ZM758.691 4100.4 758.691 4106.13 752.962 4106.13 752.962 4100.4ZM758.691 4111.86 758.691 4117.59 752.962 4117.59 752.962 4111.86ZM758.691 4123.32 758.691 4129.05 752.962 4129.05 752.962 4123.32ZM758.691 4134.78 758.691 4140.51 752.962 4140.51 752.962 4134.78ZM758.691 4146.24 758.691 4151.97 752.962 4151.97 752.962 4146.24ZM758.691 4157.7 758.691 4163.43 752.962 4163.43 752.962 4157.7ZM758.691 4169.15 758.691 4169.71 755.826 4166.85 760.999 4166.85 760.999 4172.58 752.962 4172.58 752.962 4169.15ZM766.728 4166.85 772.457 4166.85 772.457 4172.58 766.728 4172.58ZM778.187 4166.85 783.916 4166.85 783.916 4172.58 778.187 4172.58ZM789.645 4166.85 795.374 4166.85 795.374 4172.58 789.645 4172.58ZM801.103 4166.85 806.832 4166.85 806.832 4172.58 801.103 4172.58ZM812.562 4166.85 818.291 4166.85 818.291 4172.58 812.562 4172.58ZM824.02 4166.85 829.749 4166.85 829.749 4172.58 824.02 4172.58ZM834 4155.96C841.594 4155.96 847.75 4162.12 847.75 4169.71 847.75 4177.31 841.594 4183.46 834 4183.46 826.406 4183.46 820.25 4177.31 820.25 4169.71 820.25 4162.12 826.406 4155.96 834 4155.96Z"/><rect x="1685" y="3961" width="735" height="122" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1974.45 3995)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1709.46 3995)">latitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1974.45 4031)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1709.46 4031)">longitude:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1974.45 4066)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1709.46 4066)">height:</text></g><rect x="1685" y="4110" width="735" height="122" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1973.17 4140)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1708.18 4140)">x:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1973.17 4175)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1708.18 4175)">y:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1973.17 4211)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1708.18 4211)">z:</text></g><path d="M0-2.86458 5.72917-2.86458 5.72917 2.86458 0 2.86458ZM11.4583-2.86458 17.1875-2.86458 17.1875 2.86458 11.4583 2.86458ZM22.9167-2.86458 28.6458-2.86458 28.6458 2.86458 22.9167 2.86458ZM34.375-2.86458 40.1042-2.86458 40.1042 2.86458 34.375 2.86458ZM45.8333-2.86458 51.5625-2.86458 51.5625 2.86458 45.8333 2.86458ZM57.2917-2.86458 61.2829-2.86458 61.2829 4.60256 55.5537 4.60256 55.5537 0 58.4183 2.86458 57.2917 2.86458ZM61.2829 10.3317 61.2829 16.0609 55.5537 16.0609 55.5537 10.3317ZM61.2829 21.7901 61.2829 27.5192 55.5537 27.5192 55.5537 21.7901ZM61.2829 33.2484 61.2829 38.9776 55.5537 38.9776 55.5537 33.2484ZM61.2829 44.7067 61.2829 50.4359 55.5537 50.4359 55.5537 44.7067ZM61.2829 56.1651 61.2829 61.8942 55.5537 61.8942 55.5537 56.1651ZM61.2829 67.6234 61.2829 73.3526 55.5537 73.3526 55.5537 67.6234ZM61.2829 79.0817 61.2829 84.8109 55.5537 84.8109 55.5537 79.0817ZM61.2829 90.5401 61.2829 96.2692 55.5537 96.2692 55.5537 90.5401ZM61.2829 101.998 61.2829 107.728 55.5537 107.728 55.5537 101.998ZM61.2829 113.457 61.2829 119.186 55.5537 119.186 55.5537 113.457ZM61.2829 124.915 61.2829 130.644 55.5537 130.644 55.5537 124.915ZM61.2829 136.373 61.2829 142.103 55.5537 142.103 55.5537 136.373ZM61.2829 147.832 61.2829 148.017 58.4183 145.152 63.9624 145.152 63.9624 150.881 55.5537 150.881 55.5537 147.832ZM69.6916 145.152 75.4207 145.152 75.4207 150.881 69.6916 150.881ZM81.1499 145.152 86.8791 145.152 86.8791 150.881 81.1499 150.881ZM92.6082 145.152 98.3374 145.152 98.3374 150.881 92.6082 150.881ZM104.067 145.152 109.796 145.152 109.796 150.881 104.067 150.881ZM115.525 145.152 116.836 145.152 116.836 150.881 115.525 150.881ZM116.836 134.267C124.43 134.267 130.586 140.423 130.586 148.017 130.586 155.611 124.43 161.767 116.836 161.767 109.242 161.767 103.086 155.611 103.086 148.017 103.086 140.423 109.242 134.267 116.836 134.267Z" transform="matrix(-1 1.22465e-16 1.22465e-16 1 1684.84 4022)"/><path d="M1684.84 4174.08 1679.11 4174.08 1679.11 4168.35 1684.84 4168.35ZM1673.38 4174.08 1667.65 4174.08 1667.65 4168.35 1673.38 4168.35ZM1661.92 4174.08 1656.19 4174.08 1656.19 4168.35 1661.92 4168.35ZM1650.46 4174.08 1644.73 4174.08 1644.73 4168.35 1650.46 4168.35ZM1639 4174.08 1633.27 4174.08 1633.27 4168.35 1639 4168.35ZM1627.54 4174.08 1623.55 4174.08 1623.55 4170 1626.42 4172.86 1623.03 4172.86 1623.03 4167.14 1629.28 4167.14 1629.28 4171.21 1626.42 4168.35 1627.54 4168.35ZM1617.3 4172.86 1611.57 4172.86 1611.57 4167.14 1617.3 4167.14ZM1605.84 4172.86 1600.11 4172.86 1600.11 4167.14 1605.84 4167.14ZM1594.38 4172.86 1588.65 4172.86 1588.65 4167.14 1594.38 4167.14ZM1582.92 4172.86 1577.19 4172.86 1577.19 4167.14 1582.92 4167.14ZM1571.46 4172.86 1568 4172.86 1568 4167.14 1571.46 4167.14ZM1568 4183.75C1560.41 4183.75 1554.25 4177.59 1554.25 4170 1554.25 4162.41 1560.41 4156.25 1568 4156.25 1575.59 4156.25 1581.75 4162.41 1581.75 4170 1581.75 4177.59 1575.59 4183.75 1568 4183.75Z"/><rect x="1685" y="3813" width="735" height="123" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1977.03 3848)">string</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1712.04 3848)">geodetic</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1816.31 3848)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1827.19 3848)">datum:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1977.03 3883)">decimal64</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1712.04 3883)">coord</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1780.21 3883)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1791.1 3883)">accuracy:</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1977.03 3918)">decimal64 {meters}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1712.04 3918)">height</text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1789.95 3918)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1800.84 3918)">accuracy:</text><path d="M1574.01 3871.14 1685.6 3871.34 1685.59 3877.07 1573.99 3876.86ZM1685.62 3860.46C1693.21 3860.47 1699.36 3866.64 1699.34 3874.23 1699.33 3881.82 1693.16 3887.97 1685.57 3887.96 1677.98 3887.94 1671.83 3881.77 1671.84 3874.18 1671.86 3866.59 1678.03 3860.44 1685.62 3860.46Z"/><path d="M1510.01 691.135 1769.98 691.671 1769.97 697.4 1509.99 696.865ZM1770 680.786C1777.59 680.801 1783.74 686.97 1783.72 694.564 1783.71 702.158 1777.54 708.301 1769.94 708.286 1762.35 708.27 1756.21 702.101 1756.22 694.507 1756.24 686.913 1762.41 680.77 1770 680.786Z"/><path d="M0.00452005-2.86458 214.997-2.52534 214.988 3.20382-0.00452005 2.86458ZM215.014-13.4107C222.608-13.3988 228.754-7.23297 228.742 0.360935 228.73 7.95484 222.564 14.1012 214.971 14.0892 207.377 14.0772 201.23 7.91145 201.242 0.317543 201.254-7.27636 207.42-13.4227 215.014-13.4107Z" transform="matrix(1 0 0 -1 1534 1032.34)"/><path d="M1536.01 1635.14 1748.81 1635.97 1748.79 1641.69 1535.99 1640.86ZM1748.85 1625.08C1756.45 1625.11 1762.58 1631.29 1762.55 1638.88 1762.52 1646.48 1756.34 1652.61 1748.75 1652.58 1741.15 1652.55 1735.02 1646.37 1735.05 1638.78 1735.08 1631.18 1741.26 1625.05 1748.85 1625.08Z"/><path d="M1522.01 2296.14 1742.11 2296.94 1742.09 2302.67 1521.99 2301.86ZM1742.15 2286.06C1749.74 2286.08 1755.88 2292.26 1755.85 2299.86 1755.82 2307.45 1749.64 2313.58 1742.05 2313.56 1734.45 2313.53 1728.32 2307.35 1728.35 2299.76 1728.38 2292.16 1734.55 2286.03 1742.15 2286.06Z"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/data-model/yang-types.svg b/docs/_static/data-model/yang-types.svg

new file mode 100644 (file)

index 0000000..8e0e621
--- /dev/null
+++ b/docs/_static/data-model/yang-types.svg
@@ -0,0 +1 @@
+<svg width="2387" height="772" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><g transform="translate(-45 -904)"><rect x="45" y="904" width="2381" height="763" fill="#FAFAFA"/><rect x="45" y="1595" width="2381" height="71.9999" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1061.67 1644)">Common YANG </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1314.9 1644)">Types</text><rect x="717" y="1011" width="890" height="79.0001" fill="#0050CA"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 871.177 1064)">o</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 891.229 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 904.979 1064)">ran</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 957.688 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 971.438 1064)">smo</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1037.9 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1051.65 1064)">teiv</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1110.08 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1123.83 1064)">common</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1260.76 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1274.51 1064)">yang</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1353 1064)">-</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1366.75 1064)">types</text><rect x="273" y="1222" width="427" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 401.935 1274)">decorators</text><rect x="829" y="1219" width="458" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 980.699 1272)">classifiers</text><rect x="1383" y="1219" width="356" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1484.46 1272)">sourceIds</text><rect x="1833" y="1219" width="296" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1904.04 1272)">metadata</text><path d="M1164.36 1090 1164.36 1156.63 486 1156.63 488.865 1153.77 488.865 1221.37 483.135 1221.37 483.135 1150.9 1161.49 1150.9 1158.63 1153.77 1158.63 1090ZM499.75 1221.37C499.75 1228.96 493.594 1235.12 486 1235.12 478.406 1235.12 472.25 1228.96 472.25 1221.37 472.25 1213.77 478.406 1207.62 486 1207.62 493.594 1207.62 499.75 1213.77 499.75 1221.37Z"/><path d="M1164.47 1090 1164.47 1157.48 1058 1157.48 1060.86 1154.62 1060.86 1219.24 1055.14 1219.24 1055.14 1151.76 1161.6 1151.76 1158.74 1154.62 1158.74 1090ZM1071.75 1219.24C1071.75 1226.83 1065.59 1232.99 1058 1232.99 1050.41 1232.99 1044.25 1226.83 1044.25 1219.24 1044.25 1211.65 1050.41 1205.49 1058 1205.49 1065.59 1205.49 1071.75 1211.65 1071.75 1219.24Z"/><path d="M0-2.86458 67.4847-2.86458 67.4847 399.299 64.6202 396.434 129.24 396.434 129.24 402.164 61.7556 402.164 61.7556 0 64.6202 2.86458 0 2.86458ZM129.24 385.549C136.834 385.549 142.99 391.705 142.99 399.299 142.99 406.893 136.834 413.049 129.24 413.049 121.646 413.049 115.49 406.893 115.49 399.299 115.49 391.705 121.646 385.549 129.24 385.549Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1162 1090)"/><path d="M0-2.86458 67.485-2.86458 67.485 819.449 64.6204 816.584 129.24 816.584 129.24 822.313 61.7558 822.313 61.7558 0 64.6204 2.86458 0 2.86458ZM129.24 805.699C136.834 805.699 142.99 811.855 142.99 819.449 142.99 827.043 136.834 833.199 129.24 833.199 121.646 833.199 115.49 827.043 115.49 819.449 115.49 811.855 121.646 805.699 129.24 805.699Z" transform="matrix(1.83697e-16 1 1 -1.83697e-16 1162 1090)"/><rect x="910" y="1393" width="296" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 974.397 1443)">type: </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1041.43 1443)">classifier[]</text><path d="M1060.86 1299 1060.87 1393.71 1055.14 1393.71 1055.14 1299ZM1071.75 1393.71C1071.75 1401.3 1065.59 1407.46 1058 1407.46 1050.41 1407.46 1044.25 1401.3 1044.25 1393.71 1044.25 1386.12 1050.41 1379.96 1058 1379.96 1065.59 1379.96 1071.75 1386.12 1071.75 1393.71Z"/><rect x="1411" y="1392" width="297" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1482.68 1442)">type: </text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1549.71 1442)">string[] </text><path d="M1561.86 1299 1561.86 1392.72 1556.14 1392.72 1556.14 1299ZM1572.75 1392.72C1572.75 1400.31 1566.59 1406.47 1559 1406.47 1551.41 1406.47 1545.25 1400.31 1545.25 1392.72 1545.25 1385.12 1551.41 1378.97 1559 1378.97 1566.59 1378.97 1572.75 1385.12 1572.75 1392.72Z"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2008.42 1559)">container</text><rect x="1947" y="1534" width="40.9999" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2194.88 1559)">leaf</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2232.12 1559)">-</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="23" transform="matrix(1 0 0 1 2240.72 1559)">list</text><rect x="2133" y="1534" width="41" height="33" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D6EDFC"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/logo.png b/docs/_static/logo.png

new file mode 100644 (file)

index 0000000..c3b6ce5

Binary files /dev/null and b/docs/_static/logo.png differ
diff --git a/docs/_static/sample-entities.svg b/docs/_static/sample-entities.svg

new file mode 100644 (file)

index 0000000..f6d4805
--- /dev/null
+++ b/docs/_static/sample-entities.svg
@@ -0,0 +1 @@
+<svg width="2303" height="831" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="86" y="1766" width="2303" height="831"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-86 -1766)"><rect x="85.9999" y="1766" width="2303" height="828" fill="#FAFAFA"/><rect x="85.9999" y="2533" width="2303" height="60.9998" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1031.71 2570)">Sample </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1138.84 2570)">Entities </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1245.4 2570)">with </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1311.29 2570)">Attributes</text><rect x="344" y="1944" width="496" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 439.697 1997)">GNBCUUP</text><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 606.416 1997)">Function</text><rect x="344" y="2234" width="359" height="80" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 446.724 2287)">NRCellCU</text><rect x="966" y="1901" width="681" height="165" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="971" y="2177" width="681" height="193" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><rect x="1865" y="2222" width="473" height="105" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="none"/><path d="M703 2271.14 971.059 2271.14 971.059 2276.86 703 2276.86ZM971.059 2260.25C978.652 2260.25 984.809 2266.41 984.809 2274 984.809 2281.59 978.652 2287.75 971.058 2287.75 963.465 2287.75 957.309 2281.59 957.309 2274 957.309 2266.41 963.465 2260.25 971.059 2260.25Z"/><path d="M840 1981.14 965.57 1981.14 965.57 1986.87 840 1986.86ZM965.57 1970.25C973.164 1970.25 979.32 1976.41 979.32 1984 979.32 1991.59 973.164 1997.75 965.57 1997.75 957.976 1997.75 951.82 1991.59 951.82 1984 951.82 1976.41 957.976 1970.25 965.57 1970.25Z"/><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1231.14 1961)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 1961)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1231.14 1994)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 1994)">gNBId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1231.14 2027)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 2027)">gNBIdLength:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1208.83 2242)">string {key}</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 2242)">id:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1208.83 2275)">u</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1223.73 2275)">int32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 2275)">cellLocalId: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1208.83 2308)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 2308)">nCI: </text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1208.83 2341)">uint32</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1010.55 2341)">nRTAC:</text></g><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 2090.72 2267)">mcc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2152.6 2267)">Mcc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 2090.72 2300)">mnc: </text></g><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 2155.46 2300)">Mnc</text><g><text font-family="Hilda_MSFontService,sans-serif" font-weight="700" font-size="28" transform="matrix(1 0 0 1 1897.76 2267)">pLMNId:</text></g><path d="M1652.01 2271.14 1864.81 2271.97 1864.79 2277.69 1651.99 2276.86ZM1864.85 2261.08C1872.45 2261.11 1878.58 2267.29 1878.55 2274.88 1878.52 2282.48 1872.34 2288.61 1864.75 2288.58 1857.15 2288.55 1851.02 2282.37 1851.05 2274.78 1851.08 2267.18 1857.26 2261.05 1864.85 2261.08Z"/></g></svg>
+\ No newline at end of file
diff --git a/docs/_static/sample-object-relationships.svg b/docs/_static/sample-object-relationships.svg

new file mode 100644 (file)

index 0000000..9cab9f4
--- /dev/null
+++ b/docs/_static/sample-object-relationships.svg
@@ -0,0 +1 @@
+<svg width="2391" height="1401" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="60" y="1196" width="2391" height="1401"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-60 -1196)"><rect x="60.0002" y="1196" width="2391" height="1398" fill="#FAFAFA"/><rect x="60.0002" y="2533" width="2391" height="60.9998" fill="#3B3838"/><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 929.096 2570)">Sample </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1036.23 2570)">Managed </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1169.72 2570)">O</text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1191.49 2570)">bjects </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1275.71 2570)">and their </text><text fill="#FFFFFF" font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="31" transform="matrix(1 0 0 1 1401.75 2570)">Relationships</text><rect x="0" y="0" width="345" height="78.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 476 1643)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 173.003 1695)">GNBDUFunction</text><rect x="0" y="0" width="455" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 1294)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1294.94 1347)">NRCellCU</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 1515)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1293.51 1567)">NRCellDU</text><rect x="0" y="0" width="374" height="79.9997" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 505 2016)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 184.08 2069)">ENodeBFunction</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 1902)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1286.63 1955)">EUtranCell</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 1727)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1249.11 1780)">NrSectorCarrier</text><rect x="0" y="0" width="455" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 2132)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1236.79 2185)">LTESectorCarrier</text><rect x="0" y="0" width="455" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 1599 2355)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 1224.19 2408)">AntennaCapability</text><path d="M510.672 2053.14 684.338 2053.14 684.338 2171.79 681.474 2168.93 1139 2168.93 1139 2174.66 678.609 2174.66 678.609 2056 681.474 2058.86 510.672 2058.86ZM536.728 2074.52 504.987 2056 536.728 2037.48C538.095 2036.69 539.849 2037.15 540.646 2038.51 541.443 2039.88 540.982 2041.64 539.615 2042.43L512.115 2058.47 512.115 2053.53 539.615 2069.57C540.982 2070.36 541.443 2072.12 540.646 2073.49 539.849 2074.85 538.095 2075.31 536.728 2074.52ZM1112.95 2153.28 1144.69 2171.79 1112.95 2190.31C1111.58 2191.11 1109.83 2190.64 1109.03 2189.28 1108.23 2187.91 1108.69 2186.16 1110.06 2185.36L1137.56 2169.32 1137.56 2174.27 1110.06 2158.23C1108.69 2157.43 1108.23 2155.67 1109.03 2154.31 1109.83 2152.94 1111.58 2152.48 1112.95 2153.28Z"/><path d="M5.67176-2.86458 179.338-2.86458 179.338 114.591 176.474 111.726 634.003 111.726 634.003 117.455 173.609 117.455 173.609 0 176.474 2.86458 5.67176 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM607.946 96.0749 639.687 114.591 607.946 133.107C606.579 133.904 604.825 133.443 604.028 132.076 603.231 130.709 603.692 128.955 605.059 128.158L632.559 112.117 632.559 117.065 605.059 101.024C603.692 100.226 603.231 98.4724 604.028 97.1059 604.825 95.7393 606.579 95.2777 607.946 96.0749Z" transform="matrix(1 0 0 -1 505 2056.59)"/><rect x="0" y="0" width="255" height="40.0002" fill="#FAFAFA" transform="matrix(-1 0 0 1 998 1922)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 804.449 1955)">PROVIDES</text><path d="M5.67192-2.86458 209.92-2.86458 209.92 127.788 207.056 124.924 662.703 124.924 662.703 130.653 204.191 130.653 204.191 0 207.056 2.86458 5.67192 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM636.646 109.272 668.387 127.788 636.646 146.304C635.279 147.102 633.525 146.64 632.728 145.273 631.931 143.907 632.392 142.153 633.759 141.356L661.259 125.314 661.259 130.263 633.759 114.221C632.392 113.424 631.931 111.67 632.728 110.303 633.525 108.937 635.279 108.475 636.646 109.272Z" transform="matrix(1 0 0 -1 476 1681.79)"/><path d="M481.672 1679.14 685.92 1679.14 685.92 1766.45 683.056 1763.59 1138.7 1763.59 1138.7 1769.32 680.191 1769.32 680.191 1682 683.056 1684.86 481.672 1684.86ZM507.729 1700.52 475.987 1682 507.729 1663.48C509.095 1662.69 510.849 1663.15 511.646 1664.51 512.443 1665.88 511.982 1667.64 510.615 1668.43L483.115 1684.47 483.115 1679.53 510.615 1695.57C511.982 1696.36 512.443 1698.12 511.646 1699.49 510.849 1700.85 509.095 1701.31 507.729 1700.52ZM1112.65 1747.94 1144.39 1766.45 1112.65 1784.97C1111.28 1785.77 1109.53 1785.3 1108.73 1783.94 1107.93 1782.57 1108.39 1780.82 1109.76 1780.02L1137.26 1763.98 1137.26 1768.93 1109.76 1752.89C1108.39 1752.09 1107.93 1750.33 1108.73 1748.97 1109.53 1747.6 1111.28 1747.14 1112.65 1747.94Z"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 998 1529)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 804.449 1562)">PROVIDES</text><rect x="0" y="0" width="255" height="40.0002" fill="#FAFAFA" transform="matrix(-1 0 0 1 998 1746)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 804.449 1779)">PROVIDES</text><rect x="0" y="0" width="255" height="40.0002" fill="#FAFAFA" transform="matrix(-1 0 0 1 998 2153)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 804.449 2186)">PROVIDES</text><path d="M-5.6718 2.86458-82.5 2.86458-79.6354 0-79.6354 628.044-82.5 625.18-5.67152 625.18-5.67152 630.909-85.3646 630.909-85.3646-2.86458-5.6718-2.86458ZM-31.7285-18.516 0.0132769 0-31.7285 18.516C-33.0951 19.3132-34.8491 18.8516-35.6462 17.485-36.4434 16.1185-35.9818 14.3645-34.6153 13.5673L-7.11526-2.47437-7.11526 2.47437-34.6153-13.5673C-35.9818-14.3645-36.4434-16.1185-35.6462-17.485-34.8491-18.8516-33.0951-19.3132-31.7285-18.516ZM-31.7281 609.528 0.0136378 628.044-31.7281 646.56C-33.0947 647.358-34.8487 646.896-35.6459 645.529-36.443 644.163-35.9814 642.409-34.6149 641.612L-7.11489 625.57-7.11489 630.519-34.6149 614.477C-35.9814 613.68-36.443 611.926-35.6459 610.559-34.8487 609.193-33.0947 608.731-31.7281 609.528Z" transform="matrix(-1 0 0 1 1599 1767)"/><rect x="0" y="0" width="153" height="54" fill="#FAFAFA" transform="matrix(-1 0 0 1 1753 2029)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1644.01 2066)">USES</text><path d="M1374.86 1599.67 1374.86 1721.28 1369.14 1721.28 1369.14 1599.67ZM1353.48 1625.73 1372 1593.99 1390.52 1625.73C1391.31 1627.09 1390.85 1628.85 1389.48 1629.65 1388.12 1630.44 1386.36 1629.98 1385.57 1628.62L1369.53 1601.12 1374.47 1601.12 1358.43 1628.62C1357.64 1629.98 1355.88 1630.44 1354.51 1629.65 1353.15 1628.85 1352.69 1627.1 1353.48 1625.73ZM1390.52 1695.22 1372 1726.96 1353.48 1695.22C1352.69 1693.85 1353.15 1692.1 1354.52 1691.3 1355.88 1690.51 1357.64 1690.97 1358.43 1692.33L1374.47 1719.83 1369.53 1719.83 1385.57 1692.33C1386.36 1690.97 1388.12 1690.51 1389.49 1691.3 1390.85 1692.1 1391.31 1693.85 1390.52 1695.22Z"/><rect x="0" y="0" width="153" height="30.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1448 1642)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1338.94 1667)">USES</text><path d="M1374.86 1986.67 1374.86 2126.42 1369.14 2126.42 1369.14 1986.67ZM1353.48 2012.73 1372 1980.99 1390.52 2012.73C1391.31 2014.09 1390.85 2015.85 1389.48 2016.65 1388.12 2017.44 1386.36 2016.98 1385.57 2015.62L1369.53 1988.12 1374.47 1988.12 1358.43 2015.62C1357.64 2016.98 1355.88 2017.44 1354.51 2016.65 1353.15 2015.85 1352.69 2014.1 1353.48 2012.73ZM1390.52 2100.36 1372 2132.1 1353.48 2100.36C1352.69 2099 1353.15 2097.24 1354.52 2096.45 1355.88 2095.65 1357.64 2096.11 1358.43 2097.48L1374.47 2124.98 1369.53 2124.98 1385.57 2097.48C1386.36 2096.11 1388.12 2095.65 1389.49 2096.45 1390.85 2097.24 1391.31 2099 1390.52 2100.36Z"/><rect x="0" y="0" width="153" height="40.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1449 2038)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1340.06 2068)">USES</text><path d="M2.8646 5.67192 2.86493 137.894-2.86424 137.894-2.86457 5.67194ZM-18.516 31.7285 1.34955e-07-0.0132769 18.5161 31.7284C19.3133 33.095 18.8517 34.849 17.4851 35.6462 16.1186 36.4434 14.3645 35.9818 13.5674 34.6152L-2.47435 7.11526 2.47438 7.11525-13.5672 34.6153C-14.3644 35.9818-16.1184 36.4434-17.485 35.6463-18.8515 34.8491-19.3131 33.0951-18.516 31.7285ZM18.5163 111.837 0.000361542 143.579-18.5158 111.837C-19.3129 110.471-18.8513 108.717-17.4848 107.92-16.1182 107.123-14.3642 107.584-13.567 108.951L2.47471 136.451-2.47402 136.451 13.5676 108.951C14.3647 107.584 16.1188 107.122 17.4853 107.92 18.8519 108.717 19.3135 110.471 18.5163 111.837Z" transform="matrix(-1 0 0 1 1372 2212)"/><rect x="0" y="0" width="153" height="41.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1448 2259)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1338.94 2290)">USES</text><rect x="0" y="0" width="405" height="79.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 536 1295)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 182.253 1347)">GNBCUCPFunction</text><path d="M5.67168-2.86362 602.709-2.76269 602.708 2.96648 5.67071 2.86554ZM31.7254 18.5214-0.0132765-2.23773e-06 31.7316-18.5107C33.0983-19.3076 34.8523-18.8457 35.6492-17.479 36.4461-16.1123 35.9842-14.3584 34.6175-13.5614L7.11484 2.47557 7.11567-2.47316 34.613 13.5732C35.9794 14.3705 36.4407 16.1247 35.6433 17.4911 34.8459 18.8575 33.0918 19.3188 31.7254 18.5214ZM576.654-18.4185 608.393 0.102856 576.648 18.6135C575.281 19.4104 573.527 18.9486 572.73 17.5819 571.933 16.2152 572.395 14.4612 573.762 13.6643L601.265-2.37271 601.264 2.57602 573.766-13.4703C572.4-14.2677 571.939-16.0218 572.736-17.3882 573.533-18.7546 575.288-19.2159 576.654-18.4185Z" transform="matrix(1 0 0 -1 536 1334.1)"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 998 1308)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 804.449 1341)">PROVIDES</text><rect x="0" y="0" width="405" height="80.0001" stroke="#000000" stroke-width="5.72917" stroke-miterlimit="8" fill="#D0CECE" transform="matrix(-1 0 0 1 2399 1717)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="37" transform="matrix(1 0 0 1 2145.98 1770)">Sector</text><path d="M1987.89 1759.39 1793.42 1759.39 1793.42 1554 1796.28 1556.86 1604.67 1556.86 1604.67 1551.14 1799.15 1551.14 1799.15 1756.53 1796.28 1753.67 1987.89 1753.67ZM1961.84 1738.01 1993.58 1756.53 1961.84 1775.05C1960.47 1775.84 1958.72 1775.38 1957.92 1774.01 1957.12 1772.65 1957.58 1770.89 1958.95 1770.1L1986.45 1754.06 1986.45 1759 1958.95 1742.96C1957.58 1742.17 1957.12 1740.41 1957.92 1739.04 1958.72 1737.68 1960.47 1737.22 1961.84 1738.01ZM1630.73 1572.52 1598.99 1554 1630.73 1535.48C1632.1 1534.69 1633.85 1535.15 1634.65 1536.52 1635.44 1537.88 1634.98 1539.64 1633.62 1540.43L1606.12 1556.47 1606.12 1551.53 1633.62 1567.57C1634.98 1568.36 1635.44 1570.12 1634.65 1571.49 1633.85 1572.85 1632.1 1573.31 1630.73 1572.52Z"/><path d="M5.67192-2.86458 200.147-2.86458 200.147 184.515 197.283 181.65 388.893 181.65 388.893 187.379 194.418 187.379 194.418 0 197.283 2.86458 5.67192 2.86458ZM31.7285 18.516-0.0132769 0 31.7285-18.516C33.0951-19.3132 34.8491-18.8516 35.6462-17.485 36.4434-16.1185 35.9818-14.3645 34.6153-13.5673L7.11526 2.47437 7.11526-2.47437 34.6153 13.5673C35.9818 14.3645 36.4434 16.1185 35.6462 17.485 34.8491 18.8516 33.0951 19.3132 31.7285 18.516ZM362.837 165.999 394.578 184.515 362.837 203.031C361.47 203.828 359.716 203.366 358.919 202 358.122 200.633 358.583 198.879 359.95 198.082L387.45 182.041 387.45 186.989 359.95 170.948C358.583 170.15 358.122 168.396 358.919 167.03 359.716 165.663 361.47 165.202 362.837 165.999Z" transform="matrix(-1 1.22465e-16 1.22465e-16 1 1993.57 1757)"/><rect x="0" y="0" width="255" height="39.9999" fill="#FAFAFA" transform="matrix(-1 0 0 1 1924 1607)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1743.31 1640)">GROUPS</text><rect x="0" y="0" width="183" height="48.0001" fill="#FAFAFA" transform="matrix(-1 0 0 1 1888 1825)"/><text font-family="Hilda_MSFontService,sans-serif" font-weight="400" font-size="28" transform="matrix(1 0 0 1 1743.25 1858)">GROUPS</text></g></svg>
+\ No newline at end of file
diff --git a/docs/conf.py b/docs/conf.py

new file mode 100644 (file)

index 0000000..8846070
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,30 @@
+#  ============LICENSE_START=======================================================
+#  Copyright (C) 2024 Ericsson
+#  Modifications Copyright (C) 2024 OpenInfra Foundation Europe
+#  ================================================================================
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+#  SPDX-License-Identifier: Apache-2.0
+#  ============LICENSE_END=========================================================
+
+from docs_conf.conf import *
+
+project = "teiv"
+release = "master"
+version = "master"
+
+author = "ORAN"
+
+extensions = [
+    'sphinx.ext.autosectionlabel',
+]
diff --git a/docs/conf.yaml b/docs/conf.yaml

new file mode 100644 (file)

index 0000000..83d5e1f
--- /dev/null
+++ b/docs/conf.yaml
@@ -0,0 +1,3 @@
+---
+project_cfg: oran
+project: teiv
diff --git a/docs/data-models-guide.rst b/docs/data-models-guide.rst

new file mode 100644 (file)

index 0000000..a953244
--- /dev/null
+++ b/docs/data-models-guide.rst
@@ -0,0 +1,75 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Topology & Inventory Data Models
+================================
+
+The following are the currently supported modules in Topology &
+Inventory.
+
+Common YANG extensions
+----------------------
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang
+   :language: yang
+
+Common YANG types
+-----------------
+
+.. image:: _static/data-model/yang-types.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang
+   :language: yang
+
+Equipment
+---------
+
+.. image:: _static/data-model/equipment.svg
+  :width: 900
+
+.. image:: _static/data-model/equipment-relationships.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang
+   :language: yang
+
+RAN
+---
+
+.. image:: _static/data-model/ran.svg
+  :width: 900
+
+.. image:: _static/data-model/ran-relationships.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang
+   :language: yang
+
+Relationship: Equipment RAN
+---------------------------
+
+.. image:: _static/data-model/equipment-ran.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang
+   :language: yang
+
+OAM
+---
+
+.. image:: _static/data-model/oam.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang
+   :language: yang
+
+Relationship: OAM RAN
+---------------------
+
+.. image:: _static/data-model/oam-ran.svg
+  :width: 900
+
+.. literalinclude:: ../teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang
+   :language: yang
diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst

new file mode 100644 (file)

index 0000000..c89590c
--- /dev/null
+++ b/docs/developer-guide.rst
@@ -0,0 +1,245 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Developer Guide
+###############
+
+Developer Guide Overview
+========================
+
+In this guide, we explore the use of Topology & Inventory to manage the
+topology and inventory data in your network.
+
+Introducing topology and inventory data
+=======================================
+
+Topology and inventory data is the information that represents entities
+in a telecommunications network and the relationships between them that
+provide insight into a particular aspect of the network of importance to
+specific use cases. Topology and inventory data can be derived from
+inventory, configuration, or other data. Topology & Inventory is being
+updated autonomously based on changes in the network.
+
+Topology & Inventory supports several topology and inventory domains,
+see the :doc:`Data Models </data-models-guide>` for
+details on the topology and inventory model. The understanding of the
+model is important to enable a user making queries on topology and
+inventory data. The entities are modeled as managed objects (found under
+the schema in the data dictionary) and grouped together in modules based
+on functionality. See
+:ref:`Supported domains <Supported domains>`
+for the list of the topology and inventory domains currently supported
+in Topology & Inventory capability.
+
+Concepts
+--------
+
+The building blocks of the Topology & Inventory are domains, entities,
+and the relationships between each other. From a graph perspective,
+entities are the vertices and relationships are the edges. These two
+components are part of a subgraph, or the so-called domain. A
+relationship can go beyond a single domain, since it can happen that the
+two entities come from two separate ones. In this particular case, they
+have a cross-domain relationship.
+
+Domain
+~~~~~~
+
+A domain is a grouping of topology and inventory entities that handles
+topology and inventory data. Topology and inventory data is the
+information that represents entities in a telecommunications network and
+the relationships between them that provides insight into a particular
+aspect of the network of import to specific use cases. Topology and
+inventory data can be derived from inventory, configuration, or other
+data. Therefore, the topology and inventory model must define what the
+telecoms network entities and relationships are. More information can be
+found in :ref:`Supported domains <Supported domains>`.
+The Topology Exposure and Inventory Management (TEIV) domain is the
+parent domain used for entities and relationships. This domain can be
+used in reading and querying topology and inventory data when the domain
+name of an entity or relationship is not known.
+
+Entity
+~~~~~~
+
+Entities are enabling the modelling and storage of complex network
+infrastructure and relationships. The following are two examples of the
+entities and their attributes from :doc:`Topology & Inventory Data
+Models <data-models-guide>`.
+
+.. image:: _static/sample-entities.svg
+  :width: 900
+
+Relationship
+~~~~~~~~~~~~
+
+It is a bi-directional connection between two entities, one of which is
+the originating side (A-side) and the other is the terminating side
+(B-side). The order of the sides matters since it defines the
+relationship itself which must be unique. A relationship between two
+entities is based on the effect that one has on the other. An entity can
+have one or multiple relationships which can be defined by the user. A
+possible relationship between ManagedElement and GNBDUFunction can be
+*MANAGEDELEMENT_MANAGES_GNBDUFUNCTION*.
+
+Topology & Inventory models
+---------------------------
+
+The Topology & Inventory objects are managed and standardized using YANG
+models. These YANG models describe managed network entities and their
+attributes, while also providing information on the relations between
+the network entities. YANG data models are structured into modules and
+submodules. Management instance data is a graph of objects which have
+attributes (see the **schema** in the data models).
+
+The :doc:`Topology & Inventory Data Models <data-models-guide>` includes:
+- Modules for each supported domain that describe the structure of the
+managed objects within it as well as any relationships between them. -
+Modules that describe cross-domain relationships. - Modules that define
+proprietary extensions and types used to describe the structure of
+objects and attributes within the domains.
+
+The following sample diagram shows some managed objects and their
+relationships in the RAN domain.
+
+.. image:: _static/sample-object-relationships.svg
+  :width: 900
+
+A direct relationship is a connection between two entities without any
+in-between entity and an indirect relationship contains at least one.
+NRCellDU has direct relationships with GNBDUFunction and
+NRSectorCarrier, while it also has indirect relationships with
+ManagedElement, AntennaCapability, and AntennaModule.
+
+Supported domains
+-----------------
+
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Domain            | Description                                                                                                                                                                                                                                                                 |
++===================+=============================================================================================================================================================================================================================================================================+
+| RAN               | This model contains the topology entities and relations in the RAN domain, which represents the functional capability of the deployed RAN that are relevant to rApps use cases.                                                                                             |
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| EQUIPMENT         | This model contains the topology entities and relations in the Equipment domain, which is modelled to understand the physical location of equipment such as antennas associated with a cell/carrier and their relevant properties, for example, tilt, max power, and so on. |
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| OAM               | This model contains the topology entities and relations in the O&M domain, which are intended to represent management systems and management interfaces.                                                                                                                    |
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| REL_EQUIPMENT_RAN | This model contains the topology relations between Equipment and RAN.                                                                                                                                                                                                       |
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| REL_OAM_RAN       | This model contains the topology relations between O&M and RAN.                                                                                                                                                                                                             |
++-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+
+Retrieving and using topology modules
+=====================================
+
+Topology & Inventory provides APIs to enable users :download:`query module
+data <../teiv/src/main/resources/v1/topology-exposure-inventory-openapi.yaml>`
+that can be used to understand the existing topology and inventory model,
+parse the modules, and understand what objects are supported over the R1
+interface, so adequate queries can be made on topology and inventory data.
+
+The API endpoints returning lists support pagination. The default value
+for number of items returned is 500, which is also the upper limit.
+
+**Sample request to fetch a list of all modules:**
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/schemas
+
+To get a list of all modules for a specific domain, use a *domain* query
+parameter. For example, /schemas?domain=<domain>
+
+**Sample request to fetch a list of all modules related to the RAN
+domain:**
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/schemas?domain=ran
+
+..
+
+   **Note:** - Partial matches are also supported in the query parameter
+   using the ’*’ symbol as a wild card. - If the specified domain does
+   not exist, an empty list is returned.
+
+To get a specific module, supply a module name in the path parameter.
+For example, /schemas/<name>/content
+
+**Sample request to fetch the module data for the o-ran-smo-teiv-ran
+module:**
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/schemas/o-ran-smo-teiv-ran/content
+
+..
+
+   **Note:** If the specified module does not exist, an
+   *INVALID_MODULE_NAME* error is returned.
+
+Reading and querying topology and inventory
+===========================================
+
+Reading entities and relationships
+----------------------------------
+
+To get a list of all entities with all properties in a specified domain
+name, use: > /domains/{domainName}/entities
+
+**Example:** Get all entities in the *RAN* domain:
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entities
+
+To get a list of all available entity types in a specified domain name,
+use: > /domains/{domainName}/entity-types
+
+**Example:** Get all entity types in the *RAN* domain:
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entity-types
+
+To get a list of all available relationship types in a specified domain
+name, use: > /domains/{domainName}/relationship-types
+
+**Example:** Get all relationship types in the *RAN* domain:
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/relationship-types
+
+Querying entities and relationships
+-----------------------------------
+
+Use the *targetFilter* parameter to narrow down the fields to return. To
+filter the results which match a given criteria, use the *scopeFilter*.
+Think of it as an SQL statement, where the *targetFilter* is the SELECT,
+and the *scopeFilter* is the WHERE tag.
+
+A detailed explanation about the *targetFilter* and *scopeFilter*
+parameters can be found in :doc:`Supported filter options </supported-filter-options>`.
+
+**Example:**
+
+In this example, the user is only interested in NRCellDU entities.
+Moreover, the user only wants those records that have sourceIds
+containing “SubNetwork=Ireland”. These fields and filters can be defined
+in the request as follows:
+
+   **Parameters:** - **targetFilter:** /NRCellDU - **scopeFilter:**
+   /sourceIds[contains(@item,'SubNetwork=Ireland')]
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN?targetFilter=/NRCellDU&scopeFilter=/sourceIds[contains(@item,'SubNetwork=Ireland')]
+
+..
+
+   **Note:** If the targetFilter is not used here, the result contains
+   all entities and relationships that matches the condition in the RAN
+   domain.
diff --git a/docs/favicon.ico b/docs/favicon.ico

new file mode 100644 (file)

index 0000000..00b0fd0

Binary files /dev/null and b/docs/favicon.ico differ
diff --git a/docs/geographical-location-enrichment-api.rst b/docs/geographical-location-enrichment-api.rst

new file mode 100644 (file)

index 0000000..1966fdc
--- /dev/null
+++ b/docs/geographical-location-enrichment-api.rst
@@ -0,0 +1,484 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Geographical Location Enrichment API 1.0.0beta1.0
+#################################################
+
+Geographical Location Enrichment API to enrich topology with
+geographical data.
+
+Operations
+==========
+
+.. _Ingestion Create:
+
+PUB ``ingestionCreate`` Operation
+---------------------------------
+
+*Topology & Inventory entities and relationships can be created.*
+
+-  Operation ID: ``Ingestion``
+
+Operation on Topology Inventory and Exposure input topic.
+
+Message Topology CREATE ``ingestionCreate``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+*Creates components in topology.*
+
+-  Message ID: ``create``
+-  Content type: application/json
+
+CREATE Headers
+^^^^^^^^^^^^^^
+
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| Name           | Type   | Description                                                                                                                                   | Value                        | Constraints          | Notes                                 |
++================+========+===============================================================================================================================================+==============================+======================+=======================================+
+| (root)         | object | -                                                                                                                                             | -                            | -                    | **additional properties are allowed** |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_id          | string | Unique identifier for the event.                                                                                                              | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_source      | string | Source of the CloudEvent.                                                                                                                     | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_type        | string | Event type. It can be one of topology-inventory-ingestion-merge, topology-inventory-ingestion-delete, or topology-inventory-ingestion-create. | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| content-type   | string | Content-type of the data contained within the cloud event. It is application/json.                                                            | const (`"application/json"`) | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_dataschema  | string | URI representing the schema of the data. This references the event-specific yang schema.                                                      | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_time        | string | Event timestamp.                                                                                                                              | -                            | format (`date-time`) | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_specversion | string | The version of the CloudEvents specification which the event uses.                                                                            | const (`"1.0"`)              | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+
+..
+
+   Examples of headers *(generated)*
+
+.. code:: json
+
+   {
+     "ce_specversion": "1.0",
+     "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd233",
+     "ce_source": "dmi-plugin:nm-1",
+     "ce_type": "topology-inventory-ingestion-create",
+     "ce_time": "2023-06-12T09:05:00Z",
+     "content-type": "application/json",
+     "ce_dataschema": "topology-inventory-ingestion:events:create:1.0.0"
+   }
+
+CREATE Payload
+^^^^^^^^^^^^^^
+
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Name                                                             | Type          | Description                                                                                                                                                                                                                                                                                                                               |
++==================================================================+===============+===========================================================================================================================================================================================================================================================================================================================================+
+| (root)                                                           | Object        | -                                                                                                                                                                                                                                                                                                                                         |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data                                                             | -             | The data part consists of the actual topology data. It contains all the entities and their associated relationships.                                                                                                                                                                                                                      |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities                                                    | Array<Object> | Entities are topology objects comprising of an id, consumer data, attributes and metadata for each. It contains the id only in case of delete cloud event.                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities.<module_name>:<mo_type>                            | Object        | Entities schema is adherent to the entity types and attributes mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                           |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships                                               | Array<Object> | Relationships comprising of an A-side and a B-side for each. The A-side is considered the originating side of the relationship; the B-side is considered the terminating side of the relationship. The order of A-side and B-side is of importance and MUST NOT be changed once defined. It contains the id only in case of delete event. |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships.<module_name>:<relationship_type>             | Object        | Relationship schema is adherent to the relationship types mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+   Examples of payload *(generated)*
+
+.. code:: json
+
+   {
+     "data": {
+       "entities": [
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=1",
+               "attributes": {
+                 "antennaModelNumber": "1",
+                 "mechanicalAntennaBearing": 50,
+                 "mechanicalAntennaTilt": 10,
+                 "positionWithinSector": "Unknown",
+                 "totalTilt": 14,
+                 "electricalAntennaTilt": 2,
+                 "antennaBeamWidth": [
+                   35,
+                   23,
+                   21
+                 ],
+                 "geo-location": {
+                   "latitude": 41.73297,
+                   "longitude": -73.007696,
+                   "height": 3000
+                 }
+               },
+               "sourceIds": [
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1,AntennaSubunit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaNearUnit=1,RetSubUnit=1"
+               ],
+               "metadata": {
+                 "trustLevel": "RELIABLE"
+               }
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=2",
+               "attributes": {
+                 "antennaModelNumber": "2",
+                 "mechanicalAntennaBearing": 61,
+                 "mechanicalAntennaTilt": 21,
+                 "positionWithinSector": "Unknown",
+                 "totalTilt": 25,
+                 "electricalAntennaTilt": 3,
+                 "antennaBeamWidth": [
+                   46,
+                   34,
+                   32
+                 ],
+                 "geo-location": {
+                   "latitude": 52.84308,
+                   "longitude": -84.118707,
+                   "height": 41111
+                 }
+               },
+               "sourceIds": [
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=2",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=2,AntennaSubunit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaNearUnit=2,RetSubUnit=1"
+               ],
+               "metadata": {
+                 "trustLevel": "RELIABLE"
+               }
+             }
+           ]
+         }
+       ],
+       "relationships": [
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs=",
+               "aSide": "urn:oran:smo:teiv:AntennaModule=1",
+               "bSide": "urn:oran:smo:teiv:Site=1"
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVsYW5kLE1lQ2=",
+               "aSide": "urn:oran:smo:teiv:AntennaModule=2",
+               "bSide": "urn:oran:smo:teiv:Site=2"
+             }
+           ]
+         }
+       ]
+     }
+   }
+
+.. _Ingestion Merge:
+
+PUB ``ingestionMerge`` Operation
+--------------------------------
+
+*Topology & Inventory entities and relationships can be updated.*
+
+-  Operation ID: ``Ingestion``
+
+Operation on Topology Inventory and Exposure input topic.
+
+Message Topology MERGE ``ingestionMerge``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+*Updates components in topology.*
+
+-  Message ID: ``merge``
+-  Content type: application/json
+
+MERGE Headers
+^^^^^^^^^^^^^
+
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| Name           | Type   | Description                                                                                                                                   | Value                        | Constraints          | Notes                                 |
++================+========+===============================================================================================================================================+==============================+======================+=======================================+
+| (root)         | object | -                                                                                                                                             | -                            | -                    | **additional properties are allowed** |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_id          | string | Unique identifier for the event.                                                                                                              | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_source      | string | Source of the CloudEvent.                                                                                                                     | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_type        | string | Event type. It can be one of topology-inventory-ingestion-merge, topology-inventory-ingestion-delete, or topology-inventory-ingestion-create. | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| content-type   | string | Content-type of the data contained within the cloud event. It is application/json.                                                            | const (`"application/json"`) | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_dataschema  | string | URI representing the schema of the data. This references the event-specific yang schema.                                                      | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_time        | string | Event timestamp.                                                                                                                              | -                            | format (`date-time`) | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_specversion | string | The version of the CloudEvents specification which the event uses.                                                                            | const (`"1.0"`)              | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+
+..
+
+   Examples of headers *(generated)*
+
+.. code:: json
+
+
+   {
+     "ce_specversion": "1.0",
+     "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd234",
+     "ce_source": "dmi-plugin:nm-1",
+     "ce_type": "topology-inventory-ingestion-merge",
+     "ce_time": "2023-06-12T09:05:00Z",
+     "content-type": "application/json",
+     "ce_dataschema": "topology-inventory-ingestion:events:merge:1.0.0"
+   }
+
+MERGE Payload
+^^^^^^^^^^^^^
+
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Name                                                             | Type          | Description                                                                                                                                                                                                                                                                                                                               |
++==================================================================+===============+===========================================================================================================================================================================================================================================================================================================================================+
+| (root)                                                           | Object        | -                                                                                                                                                                                                                                                                                                                                         |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data                                                             | -             | The data part consists of the actual topology data. It contains all the entities and their associated relationships.                                                                                                                                                                                                                      |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities                                                    | Array<Object> | Entities are topology objects comprising of an id, consumer data, attributes and metadata for each. It contains the id only in case of delete cloud event.                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities.<module_name>:<mo_type>                            | Object        | Entities schema is adherent to the entity types and attributes mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                           |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships                                               | Array<Object> | Relationships comprising of an A-side and a B-side for each. The A-side is considered the originating side of the relationship; the B-side is considered the terminating side of the relationship. The order of A-side and B-side is of importance and MUST NOT be changed once defined. It contains the id only in case of delete event. |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships.<module_name>:<relationship_type>             | Object        | Relationship schema is adherent to the relationship types mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+..
+
+   Examples of payload *(generated)*
+
+.. code:: json
+
+   {
+     "data": {
+       "entities": [
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=1",
+               "attributes": {
+                 "antennaModelNumber": "1",
+                 "mechanicalAntennaBearing": 50,
+                 "mechanicalAntennaTilt": 10,
+                 "positionWithinSector": "Unknown",
+                 "totalTilt": 14,
+                 "electricalAntennaTilt": 2,
+                 "antennaBeamWidth": [
+                   35,
+                   23,
+                   21
+                 ],
+                 "geo-location": {
+                   "latitude": 41.73297,
+                   "longitude": -73.007696,
+                   "height": 3000
+                 }
+               },
+               "sourceIds": [
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1,AntennaSubunit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaNearUnit=1,RetSubUnit=1"
+               ],
+               "metadata": {
+                 "trustLevel": "RELIABLE"
+               }
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=2",
+               "attributes": {
+                 "antennaModelNumber": "2",
+                 "mechanicalAntennaBearing": 61,
+                 "mechanicalAntennaTilt": 21,
+                 "positionWithinSector": "Unknown",
+                 "totalTilt": 25,
+                 "electricalAntennaTilt": 3,
+                 "antennaBeamWidth": [
+                   46,
+                   34,
+                   32
+                 ],
+                 "geo-location": {
+                   "latitude": 52.84308,
+                   "longitude": -84.118707,
+                   "height": 41111
+                 }
+               },
+               "sourceIds": [
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=2",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=2,AntennaSubunit=1",
+                 "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaNearUnit=2,RetSubUnit=1"
+               ],
+               "metadata": {
+                 "trustLevel": "RELIABLE"
+               }
+             }
+           ]
+         }
+       ],
+       "relationships": [
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs=",
+               "aSide": "urn:oran:smo:teiv:AntennaModule=1",
+               "bSide": "urn:oran:smo:teiv:Site=1"
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVsYW5kLE1lQ2=",
+               "aSide": "urn:oran:smo:teiv:AntennaModule=2",
+               "bSide": "urn:oran:smo:teiv:Site=2"
+             }
+           ]
+         }
+       ]
+     }
+   }
+
+.. _Ingestion Delete:
+
+PUB ``ingestionDelete`` Operation
+---------------------------------
+
+*Topology & Inventory entities and relationships can be deleted.*
+
+-  Operation ID: ``Ingestion``
+
+Operation on Topology Inventory and Exposure input topic.
+
+Message Topology DELETE ``ingestionDelete``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+*Deletes components in topology.*
+
+-  Message ID: ``delete``
+-  Content type: application/json
+
+DELETE Headers
+^^^^^^^^^^^^^^
+
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| Name           | Type   | Description                                                                                                                                   | Value                        | Constraints          | Notes                                 |
++================+========+===============================================================================================================================================+==============================+======================+=======================================+
+| (root)         | object | -                                                                                                                                             | -                            | -                    | **additional properties are allowed** |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_id          | string | Unique identifier for the event.                                                                                                              | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_source      | string | Source of the CloudEvent.                                                                                                                     | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_type        | string | Event type. It can be one of topology-inventory-ingestion-merge, topology-inventory-ingestion-delete, or topology-inventory-ingestion-create. | -                            | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| content-type   | string | Content-type of the data contained within the cloud event. It is application/json.                                                            | const (`"application/json"`) | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_dataschema  | string | URI representing the schema of the data. This references the event-specific yang schema.                                                      | -                            | format (`uri`)       | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_time        | string | Event timestamp.                                                                                                                              | -                            | format (`date-time`) | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+| ce_specversion | string | The version of the CloudEvents specification which the event uses.                                                                            | const (`"1.0"`)              | -                    | -                                     |
++----------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------+------------------------------+----------------------+---------------------------------------+
+
+..
+
+   Examples of headers *(generated)*
+
+.. code:: json
+
+   {
+     "ce_specversion": "1.0",
+     "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd235",
+     "ce_source": "dmi-plugin:nm-1",
+     "ce_type": "topology-inventory-ingestion-delete",
+     "ce_time": "2023-06-12T09:05:00Z",
+     "content-type": "application/json",
+     "ce_dataschema": "topology-inventory-ingestion:events:delete:1.0.0"
+   }
+
+DELETE Payload
+^^^^^^^^^^^^^^
+
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Name                                                             | Type          | Description                                                                                                                                                                                                                                                                                                                               |
++==================================================================+===============+===========================================================================================================================================================================================================================================================================================================================================+
+| (root)                                                           | Object        | -                                                                                                                                                                                                                                                                                                                                         |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data                                                             | -             | The data part consists of the actual topology data. It contains all the entities and their associated relationships.                                                                                                                                                                                                                      |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities                                                    | Array<Object> | Entities are topology objects comprising of an id, consumer data, attributes and metadata for each. It contains the id only in case of delete cloud event.                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.entities.<module_name>:<mo_type>                            | Object        | Entities schema is adherent to the entity types and attributes mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                           |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships                                               | Array<Object> | Relationships comprising of an A-side and a B-side for each. The A-side is considered the originating side of the relationship; the B-side is considered the terminating side of the relationship. The order of A-side and B-side is of importance and MUST NOT be changed once defined. It contains the id only in case of delete event. |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| data.relationships.<module_name>:<relationship_type>             | Object        | Relationship schema is adherent to the relationship types mentioned in the yang modules. For yang modules, see [Data Models][Data Models].                                                                                                                                                                                                |
++------------------------------------------------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+..
+
+   Examples of payload *(generated)*
+
+.. code:: json
+
+   {
+     "data": {
+       "entities": [
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=1"
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:oran:smo:teiv:AntennaModule=2"
+             }
+           ]
+         }
+       ],
+       "relationships": [
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs="
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:sha512:TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVsYW5kLE1lQ2="
+             }
+           ]
+         }
+       ]
+     }
+   }
+\ No newline at end of file
diff --git a/docs/geographical-location-enrichment-guide.rst b/docs/geographical-location-enrichment-guide.rst

new file mode 100644 (file)

index 0000000..64edd13
--- /dev/null
+++ b/docs/geographical-location-enrichment-guide.rst
@@ -0,0 +1,237 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Geographical enrichment guide
+#############################
+
+Geographical Enrichment Guide Overview
+======================================
+
+In this guide, we explore how to use the Geographical Location
+Enrichment API to enrich Topology & Inventory with geographical data.
+
+Geographical enrichment
+=======================
+
+Geographical enrichment is the adding, modifying, and removing of
+geographical entities that supports geographical information.
+Geographical entities are associated to topology data. The following
+geographical entities support geographical enrichment:
+
+-  Sector
+-  AntennaModule
+-  Site
+
+For information on the entity types and their supported relationships,
+see the :doc:`Data Models </data-models-guide>`.
+
+The format of the geographical enrichment message is CloudEvents.
+Topology & Inventory uses `CloudEvents
+Kafka® <https://cloudevents.github.io/sdk-java/kafka.html>`__ version
+2.5.x. The link provides a sample CloudEvents implementation in Java®.
+CloudEvents SDKs also supports other languages. See
+`CloudEvents <https://cloudevents.io/>`__.
+
+The “data” element consists of the actual topology and inventory data.
+It contains all the geographical entities and their associated
+relationships in application/json format, and each entity and
+relationships are represented in application/yang-data+json format.
+
+CloudEvents attributes are validated against the :doc:`Data Models
+</data-models-guide>`. If there
+is an unknown attribute in the CloudEvents, Topology & Inventory does
+not drop the whole event but parses and persists only valid attributes,
+and unknown parts are logged and ignored. If an empty or bad payload is
+sent, the data is not persisted.
+
+The value of non-mandatory fields can be deleted by sending a merge
+request to set it to null. Null means that the value is not set.
+
+Example of enrich Topology & Inventory with geographical data
+-------------------------------------------------------------
+
+This example creates a new topology Site entity and a relationship
+between the Site and an AntennaModule. Using the
+:ref:`create schema <Ingestion Create>`
+the data producer can create entities that support geographical
+enrichment. Attributes with null means not set.
+
+.. code:: json
+
+   {
+       "ce_specversion": "1.0",
+       "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd233",
+       "ce_source": "dmi-plugin:nm-1",
+       "ce_type": "topology-inventory-ingestion-create",
+       "ce_time": "2023-06-12T09:05:00Z",
+       "content-type": "application/json",
+       "ce_dataschema": "topology-inventory-ingestion:events:create:1.0.0",
+       "data": {
+         "entities": [
+           {
+             "o-ran-smo-teiv-equipment:Site": [
+               {
+                 "id": "urn:o-ran:smo:teiv:sha512:Site=1F137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC153",
+                 "attributes": {
+                   "name": "Dublin",
+                   "location": {
+                     "geo-location": {
+                       "latitude": 41.73297,
+                       "longitude": -73.007696
+                     }
+                   }
+                 }
+               }
+             ]
+           },
+           {
+             "o-ran-smo-teiv-equipment:AntennaModule": [
+               {
+                 "id": "urn:o-ran:smo:teiv:sha512:AntennaModule=1FEBF137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC15323F1906228E93CFA4A1DB37D50252B3AFE6AEC9860E2CEA4A77BB3A25C9EA45DEDA87E765",
+                 "attributes": {
+                   "geo-location": {
+                     "latitude": 41.73297,
+                     "longitude": -73.007696
+                   }
+                 }
+               }
+             ]
+           }
+         ],
+         "relationships": [
+           {
+             "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+               {
+                 "id": "urn:o-ran:smo:teiv:sha512:ANTENNAMODULE_INSTALLED_AT_SITE=TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs=",
+                 "aSide": "urn:o-ran:smo:teiv:sha512:AntennaModule=1FEBF137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC15323F1906228E93CFA4A1DB37D50252B3AFE6AEC9860E2CEA4A77BB3A25C9EA45DEDA87E765",
+                 "bSide": "urn:o-ran:smo:teiv:sha512:Site=1F137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC153"
+               }
+             ]
+           }
+         ]
+       }
+   }
+
+Example of modify enriched Topology & Inventory with geographical data
+----------------------------------------------------------------------
+
+This example updates an existing Site entity. Using the
+:ref:`merge schema <Ingestion Merge>`
+the data producer can update entities that support geographical
+enrichment.
+
+.. code:: json
+
+
+   {
+     "ce_specversion": "1.0",
+     "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd234",
+     "ce_source": "dmi-plugin:nm-1",
+     "ce_type": "topology-inventory-ingestion-merge",
+     "ce_time": "2023-06-12T09:05:00Z",
+     "content-type": "application/json",
+     "ce_dataschema": "topology-inventory-ingestion:events:merge:1.0.0",
+     "data": {
+       "entities": [
+         {
+           "o-ran-smo-teiv-equipment:Site": [
+             {
+               "id": "urn:o-ran:smo:teiv:sha512:Site=1F137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC153",
+               "attributes": {
+                 "name": "Dublin",
+                 "location": {
+                   "geo-location": {
+                     "latitude": 52.73297,
+                     "longitude": -84.007696
+                   }
+                 }
+               }
+             }
+           ]
+         },
+         {
+           "o-ran-smo-teiv-equipment:AntennaModule": [
+             {
+               "id": "urn:o-ran:smo:teiv:sha512:AntennaModule=1FEBF137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC15323F1906228E93CFA4A1DB37D50252B3AFE6AEC9860E2CEA4A77BB3A25C9EA45DEDA87E765",
+               "attributes": {
+                 "geo-location": {
+                   "latitude": 52.73297,
+                   "longitude": -84.007696
+                 }
+               }
+             }
+           ]
+         }
+       ],
+       "relationships": [
+         {
+           "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+             {
+               "id": "urn:o-ran:smo:teiv:sha512:ANTENNAMODULE_INSTALLED_AT_SITE=TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs=",
+               "aSide": "urn:o-ran:smo:teiv:sha512:AntennaModule=1FEBF137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC15323F1906228E93CFA4A1DB37D50252B3AFE6AEC9860E2CEA4A77BB3A25C9EA45DEDA87E765",
+               "bSide": "urn:o-ran:smo:teiv:sha512:Site=1F137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC153"
+             }
+           ]
+         }
+       ]
+     }
+   }
+
+Example of delete enriched data from Topology & Inventory
+---------------------------------------------------------
+
+This example deletes a topology Site entity and its relationship to an
+AntennaModule entity. Using the
+:ref:`delete schema <Ingestion Delete>`
+the data producer can delete entities that support geographical
+enrichment.
+
+.. code:: json
+
+   {
+       "ce_specversion": "1.0",
+       "ce_id": "a30e63c9-d29e-46ff-b99a-b63ed83fd235",
+       "ce_source": "dmi-plugin:nm-1",
+       "ce_type": "topology-inventory-ingestion-delete",
+       "ce_time": "2023-06-12T09:05:00Z",
+       "content-type": "application/json",
+       "ce_dataschema": "topology-inventory-ingestion:events:delete:1.0.0",
+       "data": {
+           "entities" : [
+             {
+               "o-ran-smo-teiv-equipment:Site": [
+                   {
+                       "id": "urn:o-ran:smo:teiv:sha512:Site=1F137533843657E9E9DBE60DBD86B045A057DB6D04B6A07AC153"
+                   }
+               ]
+             }
+           ],
+           "relationships": [
+             {
+               "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
+                   {
+                       "id" : "urn:o-ran:smo:teiv:sha512:ANTENNAMODULE_INSTALLED_AT_SITE=TlJDZWxsRFU6U3ViTmV0d29yaz1FdXJvcGUsU3ViTmV0d29yaz1JcmVs="
+                   }
+               ]
+             }
+           ]
+       }
+   }
+
+How to create and produce an event
+==================================
+
+To create and produce an event, you can use the `CloudEventBuilder.v1
+and
+KafkaProducer <https://cloudevents.github.io/sdk-java/kafka.html>`__.
+The link provides a sample CloudEvents implementation in Java.
+CloudEvents SDKs also supports other languages. See
+`CloudEvents <https://cloudevents.io/>`__.
+
+Troubleshooting
+===============
+
+If CloudEvents were sent but no data was persisted, check validation
+failures and logs. Update the CloudEvent based on the logs and send it again.
diff --git a/docs/index.rst b/docs/index.rst

new file mode 100644 (file)

index 0000000..f1568fd
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,23 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Topology Exposure & Inventory Overview
+======================================
+
+Topology & Inventory manages the representation of topology and
+inventory resources in a suite of evolving vendor-agnostic data models
+to share and operate on a common view of the topology.
+
+--------------
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   ./developer-guide.rst
+   ./data-models-guide.rst
+   ./geographical-location-enrichment-guide.rst
+   ./geographical-location-enrichment-api.rst
+   ./supported-filter-options.rst
diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt

new file mode 100644 (file)

index 0000000..fb15e65
--- /dev/null
+++ b/docs/requirements-docs.txt
@@ -0,0 +1,6 @@
+tox
+Sphinx
+doc8
+docutils < 0.17
+lfdocs-conf
+urllib3~=1.26.15
+\ No newline at end of file
diff --git a/docs/supported-filter-options.rst b/docs/supported-filter-options.rst

new file mode 100644 (file)

index 0000000..c76f9a0
--- /dev/null
+++ b/docs/supported-filter-options.rst
@@ -0,0 +1,124 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2024 Nordix Foundation. All rights Reserved
+.. Copyright (C) 2024 OpenInfra Foundation Europe. All Rights Reserved
+
+Supported filter options
+========================
+
+Using the filtering options, it is possible to define more specific
+requests in case of several endpoints. To perform filtering,
+*targetFilter* and *scopeFilter* parameters can be used in the path.
+
+Sample structure using target and scope filters:
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/<domainName>?targetFilter=<targetFilter>&scopeFilter=<scopeFilter>
+
+..
+
+   See :download:`Topology & Inventory
+   API <../teiv/src/main/resources/v1/topology-exposure-inventory-openapi.yaml>`
+   for all possible filter options and sample responses for each endpoint.
+
+Querying simple entities
+------------------------
+
+   This functionality is supported by the following endpoints:
+   **/domains/{domainName}/entity-types/{entityTypeName}/entities**
+
+The *entityTypeName* is used as the root of the queries (from here
+referred as RootObject). Every other object, either in *targetFilter* or
+*scopeFilter*, has to relate to the RootObject. The queries are
+constructed starting from the RootObject and all other objects are
+joined to it. If there is no connection between the RootObject and the
+other object(s), the query is not constructed. The RootObject still can
+be retrieved and filtered using the /attributes.
+
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| Use case                                                                                                                                                                                                                                                                                                                                                                                             | domainName | entityTypeName | targetFilter                    | scopeFilter                                                                             | Query result                                                                                                                          |
++======================================================================================================================================================================================================================================================================================================================================================================================================+============+================+=================================+=========================================================================================+=======================================================================================================================================+
+| To return the ids for all instances of the entityTypeName used in the query.                                                                                                                                                                                                                                                                                                                         | RAN        | GNBDUFunction  |                                 |                                                                                         | All ids of every GNBDUFunction                                                                                                        |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return all attributes of every instance of the entityTypeName used in the query.                                                                                                                                                                                                                                                                                                                  | RAN        | GNBDUFunction  | /attributes                     |                                                                                         | All GNBDUFunctions with every attribute                                                                                               |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return every instance of the entityTypeName used in the query, but only the attribute that was defined in the *targetFilter* parameter. <br/> Note: The attribute must be a valid field of the object.                                                                                                                                                                                            | RAN        | GNBDUFunction  | /attributes(gNBId)              |                                                                                         | All gNBIds of every GNBDUFunction                                                                                                     |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return every instance of the entityTypeName used in the query, but only the attributes that were defined in the *targetFilter* parameter. <br/> Note: The attributes must be separated by a comma "," when using parenthesis "()".                                                                                                                                                                | RAN        | GNBDUFunction  | /attributes(gNBId, gNBIdLength) |                                                                                         | All gNBIds and gNBIdLengths of every GNBDUFunction                                                                                    |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return the ids for all instances of the entityTypeName used in the query, that matches the given property in the *scopeFilter* parameter.                                                                                                                                                                                                                                                         | RAN        | GNBDUFunction  |                                 | /sourceIds[contains (@item, 'SubNetwork=Ireland')]                                      | Unique set of ids of GNBDUFunctions, where sourceIds contains *SubNetwork=Ireland*                                                    |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return the ids for all instances of the entityTypeName used in the query, that matches the given attributes in the *scopeFilter* parameter. <br/> Note: The attributes must be separated by a *AND* or *OR*".                                                                                                                                                                                     | RAN        | GNBDUFunction  |                                 | /attributes [@gNBIdLength=3 and @gNBId=111]                                             | Unique set of ids of GNBDUFunctions, where the gNBIdLength equals 3 and the gNBId equals 111                                          |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| To return the ids for all instances of the entityTypeName used in the query, that satisfies one of the conditions in the *scopeFilter* parameter. A condition is a complete unit of *scopeFilter* parameter surrounded by square brackets. <br/> Note: Multiple conditions can be given in the scopeFilter separated by a semicolon ";" to represent AND, or a pipe symbol "&#124;" to represent OR. | RAN        | GNBDUFunction  |                                 | /attributes [@gNBIdLength=3]  &#124; /sourceIds[contains (@item, 'SubNetwork=Ireland')] | Unique set of ids of GNBDUFunctions, where where the gNBIdLength equals 3 or the sourceIds contains an item with "SubNetwork=Ireland" |
++------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+---------------------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+
+
+Querying connected entities
+---------------------------
+
+   This functionality is achieved using associations and is supported by
+   the following endpoints:
+   **/domains/{domainName}/entity-types/{entityTypeName}/entities**
+
+The *entityTypeName* is used as the root of the queries.
+
++------------------------------------------------------------------------------------------------------------------------------------------------+-------------+----------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Use case                                                                                                                                       | domainName  | entityTypeName | targetFilter | scopeFilter                                                                                                                                                                                                                                      | Query result                                                                                                                                                                                                                  |
++================================================================================================================================================+=============+================+==============+==================================================================================================================================================================================================================================================+===============================================================================================================================================================================================================================+
+| To return the ids for all instances of an entityTypeName related by an association.                                                            | REL_OAM_RAN | ENodeBFunction |              | /managed-by-managedElement                                                                                                                                                                                                                       | All ENodeBFunction entities that are managed by any Managed Element.                                                                                                                                                          |
++------------------------------------------------------------------------------------------------------------------------------------------------+-------------+----------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| To return the ids for all instances of an entityTypeName related by an association to another entity specified by its *id*.                    | REL_OAM_RAN | ENodeBFunction |              | /managed-by-managedElement [@id = 'urn\:3gpp:dn: ManagedElement=1']                                                                                                                                                                              | All ENodeBFunction entities that are managed by by the Managed Element *urn\:3gpp:dn: ManagedElement=1*.                                                                                                                      |
++------------------------------------------------------------------------------------------------------------------------------------------------+-------------+----------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| To return the attributes for all instances of an entityTypeName related by one or more associations to other entities specified by their *id*. | REL_OAM_RAN | ENodeBFunction | /attributes  | /attributes [@enbId=1] ; /managed-by-managedElement [@id='urn\:3gpp:dn: ManagedElement=1'] &#124;  /managed-by-managedElement [@id='urn\:3gpp:dn: ManagedElement=2'] ; /provided-euTranCell [@id='urn\:3gpp:dn: ManagedElement=1, EUtranCell=2']    | All EnodeBFunction entities with enbId as *1* managed by the Managed Element *urn\:3gpp:dn: ManagedElement=1* or *urn\:3gpp:dn: ManagedElement=2*, and provides EuTranCell *urn\:3gpp:dn: ManagedElement=1, EUtranCell=2*. |
++------------------------------------------------------------------------------------------------------------------------------------------------+-------------+----------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+
+Querying entities for relationships
+-----------------------------------
+
+   This functionality is supported by the following endpoints:
+   **/domains/{domainName}/entity-types/{entityTypeName}/entities/{entityId}/relationships**\ 
+
+The *entityTypeName* is used as the root of the queries.
+
++--------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------------------------------------------+--------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Use case                                                                                                           | domainName | entityTypeName | entityId                                        | targetFilter | scopeFilter                                                         | Query result                                                                                                                                                                                          |
++====================================================================================================================+============+================+=================================================+==============+=====================================================================+=======================================================================================================================================================================================================+
+| To return the relationships for a given entity specified by its id.                                                | RAN        | GNBDUFunction  | urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1 |              |                                                                     | All relations for the GNBDUFunction with id *urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1*.                                                                                                        |
++--------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------------------------------------------+--------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| To return specific relationships for a given entity specified by its id.                                           | RAN        | GNBDUFunction  | urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1 |              | /MANAGEDELEMENT _MANAGES _GNBDUFUNCTION                             | All *MANAGEDELEMENT _MANAGES _GNBDUFUNCTION* relations for the GNBDUFunction with id *urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1*.                                                               |
++--------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------------------------------------------+--------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| To return specific relationships for an entity specified by its id to another entity using its id and association. | RAN        | GNBDUFunction  | urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1 |              | /managed-by-managedElement [@id = 'urn\:3gpp:dn: ManagedElement=1'] | All *MANAGEDELEMENT _MANAGES _GNBDUFUNCTION* relations for the GNBDUFunction with id *urn\:3gpp:dn: ManagedElement=1, GNBDUFunction=1* where the managed element is *urn\:3gpp:dn: ManagedElement=1*. |
++--------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------------------------------------------+--------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+
+Querying on relationships
+-------------------------
+
+   This functionality is supported by the following endpoints:
+   **/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships**
+
+Here, the *relationshipTypeName* is used as the root of the queries.
+
++----------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------+--------------+-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Use case                                                                                                 | domainName  | relationshipTypeName                    | targetFilter | scopeFilter                                                       | Query result                                                                                                                                                  |
++==========================================================================================================+=============+=========================================+==============+===================================================================+===============================================================================================================================================================+
+| To return all relationships for a specified relationship type.                                           | REL_OAM_RAN | MANAGEDELEMENT _MANAGES _ENODEBFUNCTION |              |                                                                   | All MANAGEDELEMENT_MANAGES_ENODEBFUNCTION relationships.                                                                                                      |
++----------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------+--------------+-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| To return all relationships for a specified relationship type with a specified association to an entity. | REL_OAM_RAN | MANAGEDELEMENT _MANAGES _ENODEBFUNCTION |              | /managed-by-managedElement [@id='urn\:3gpp:dn: ManagedElement=1'] | All MANAGEDELEMENT_MANAGES_ENODEBFUNCTION relationships having an association *managed-by-managedElement* to ManagedElement *urn\:3gpp:dn: ManagedElement=1*. |
++----------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------+--------------+-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+
+..
+
+   To get a relationship with a specific id, use:
+   **/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships/{relationshipId}**
+
+**Example:** Get the *MANAGEDELEMENT_MANAGES_ENODEBFUNCTION*
+relationship with id *rel1* in the *REL_OAM_RAN* domain:
+
+::
+
+   GET https://<host>/topology-inventory/<API_VERSION>/domains/REL_OAM_RAN/relationship-types/MANAGEDELEMENT_MANAGES_ENODEBFUNCTION/relationships/rel1
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-cloud-to-ran.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-cloud-to-ran.yang

index 8645592..da05846 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-cloud-to-ran.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-cloud-to-ran.yang
@@ -16,10 +16,24 @@ module o-ran-smo-teiv-cloud-to-ran {
      description
      "RAN Cloud to RAN Logical topology model.
  
+    This model contains the RAN Cloud to RAN Logical topology relations.
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-    This model contains the RAN Cloud to RAN Logical topology relations";
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-cloud.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-cloud.yang

index ef93698..75456b4 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-cloud.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-cloud.yang
@@ -17,12 +17,26 @@ module o-ran-smo-teiv-cloud {
      description
      "RAN Cloud topology model.
  
+    This model contains the topology entities and relations in the
+    RAN CLOUD domain, which comprises cloud infrastructure and
+    deployment aspects that can be used in the topology model.
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-    This model contains the topology entities and relations in the
-    RAN CLOUD domain, which comprises cloud infrastructure and
-    deployment aspects that can be used in the topology model.";
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang

index 92344b0..1b66c59 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang
@@ -9,11 +9,25 @@ module o-ran-smo-teiv-common-yang-extensions {
    description
    "Topology and Inventory YANG extensions model
  
+  This model contains extensions to the YANG language that topology and
+  inventory models will use to define and annotate types and relationships.
+
    Copyright (C) 2024 Ericsson
    Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-  This model contains extensions to the YANG language that topology and
-  inventory models will use to define and annotate types and relationships.";
+  Licensed under the Apache License, Version 2.0 (the \"License\");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an \"AS IS\" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+  SPDX-License-Identifier: Apache-2.0";
  
    revision "2024-05-02" {
      description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang

index 1b15ce7..7aeef7e 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang
@@ -13,11 +13,25 @@ module o-ran-smo-teiv-common-yang-types {
    description
    "Topology and Inventory common types model
  
+  This model contains re-usable data types that topology and inventory models
+  will frequently use as part of types and relationships.
+
    Copyright (C) 2024 Ericsson
    Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-  This model contains re-usable data types that topology and inventory models
-  will frequently use as part of types and relationships.";
+  Licensed under the Apache License, Version 2.0 (the \"License\");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an \"AS IS\" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+  SPDX-License-Identifier: Apache-2.0";
  
    revision "2024-05-02" {
      description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang

index f518785..a676f50 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang
@@ -17,11 +17,25 @@ module o-ran-smo-teiv-equipment-to-ran {
      description 
      "RAN Equipment to Logical topology model.
  
+    This model contains the RAN Equipment to Logical topology
+    entities and relations.
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-    This model contains the RAN Equipment to Logical topology
-    entities and relations.";
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang

index 9401f38..d231491 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang
@@ -17,13 +17,27 @@ module o-ran-smo-teiv-equipment {
      description
      "RAN Equipment topology model.
  
-    Copyright (C) 2024 Ericsson
-    Modifications Copyright (C) 2024 OpenInfra Foundation Europe
-
      This model contains the topology entities and relations in the
      RAN Equipment domain, which is modelled to understand the physical
      location of equipment such as antennas associated with a cell/carrier
-    and their relevant properties e.g. tilt, max power etc.";
+    and their relevant properties e.g. tilt, max power etc.
+
+    Copyright (C) 2024 Ericsson
+    Modifications Copyright (C) 2024 OpenInfra Foundation Europe
+
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-cloud.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-cloud.yang

index 7d99b9d..8b318c7 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-cloud.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-cloud.yang
@@ -16,10 +16,24 @@ module o-ran-smo-teiv-oam-to-cloud {
      description 
      "RAN O&M to Cloud topology model.
  
+    This model contains the RAN O&M to Cloud topology relations
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
-    
-    This model contains the RAN O&M to Cloud topology relations";
+
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang

index fb166ff..4a03cdc 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang
@@ -16,10 +16,24 @@ module o-ran-smo-teiv-oam-to-ran {
      description
      "RAN O&M to Logical topology model.
  
+    This model contains the RAN O&M to Logical topology relations
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
-    
-    This model contains the RAN O&M to Logical topology relations";
+
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang

index 4d34953..b439513 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang
@@ -12,12 +12,26 @@ module o-ran-smo-teiv-oam {
      description 
      "RAN O&M topology model.
  
+    This model contains the topology entities and relations in the
+    RAN O&M domain, which are intended to represent management systems
+    and management interfaces.
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-    This model contains the topology entities and relations in the
-    RAN O&M domain, which are intended to represent management systems
-    and management interfaces.";
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang b/teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang

index 7ddbcb9..3b3eeba 100644 (file)
--- a/teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang
+++ b/teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang
@@ -19,12 +19,26 @@ module o-ran-smo-teiv-ran {
      description
      "RAN Logical topology model.
  
+    This model contains the topology entities and relations in the
+    RAN Logical domain, which represents the functional capability
+    of the deployed RAN that are relevant to rApps use cases.
+
      Copyright (C) 2024 Ericsson
      Modifications Copyright (C) 2024 OpenInfra Foundation Europe
  
-    This model contains the topology entities and relations in the
-    RAN Logical domain, which represents the functional capability
-    of the deployed RAN that are relevant to rApps use cases.";
+    Licensed under the Apache License, Version 2.0 (the \"License\");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an \"AS IS\" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+    SPDX-License-Identifier: Apache-2.0";
  
      revision "2024-05-02" {
          description "Initial revision.";
diff --git a/tox.ini b/tox.ini

new file mode 100644 (file)

index 0000000..1d20dcd
--- /dev/null
+++ b/tox.ini
@@ -0,0 +1,39 @@
+#  ============LICENSE_START=======================================================
+#  Copyright (C) 2024 Ericsson
+#  Modifications Copyright (C) 2024 OpenInfra Foundation Europe
+#  ================================================================================
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+#  SPDX-License-Identifier: Apache-2.0
+#  ============LICENSE_END=========================================================
+
+[tox]
+minversion = 4.0
+envlist =
+    docs,
+    docs-linkcheck,
+skipsdist = true
+
+[testenv:docs]
+basepython = python3
+deps = -r{toxinidir}/docs/requirements-docs.txt
+
+commands =
+    sphinx-build -W -b html -n -d {envtmpdir}/docs/doctrees ./docs/ {toxinidir}/docs/_build/html
+    echo "Generated docs available in {toxinidir}/docs/_build/html"
+allowlist_externals = echo
+
+[testenv:docs-linkcheck]
+basepython = python3
+deps = -r{toxinidir}/docs/requirements-docs.txt
+commands = sphinx-build -W -b linkcheck -d {envtmpdir}/docs/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck
+\ No newline at end of file
author	JvD_Ericsson <jeff.van.dam@est.tech>
	Fri, 7 Jun 2024 12:53:56 +0000 (13:53 +0100)
committer	JEFF VAN DAM <jeff.van.dam@est.tech>
	Tue, 11 Jun 2024 15:04:39 +0000 (15:04 +0000)
.gitignore		patch \| blob \| history
.readthedocs.yaml	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/equipment-ran.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/equipment-relationships.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/equipment.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/oam-ran.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/oam.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/ran-relationships.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/ran.svg	[new file with mode: 0644]	patch \| blob
docs/_static/data-model/yang-types.svg	[new file with mode: 0644]	patch \| blob
docs/_static/logo.png	[new file with mode: 0644]	patch \| blob
docs/_static/sample-entities.svg	[new file with mode: 0644]	patch \| blob
docs/_static/sample-object-relationships.svg	[new file with mode: 0644]	patch \| blob
docs/conf.py	[new file with mode: 0644]	patch \| blob
docs/conf.yaml	[new file with mode: 0644]	patch \| blob
docs/data-models-guide.rst	[new file with mode: 0644]	patch \| blob
docs/developer-guide.rst	[new file with mode: 0644]	patch \| blob
docs/favicon.ico	[new file with mode: 0644]	patch \| blob
docs/geographical-location-enrichment-api.rst	[new file with mode: 0644]	patch \| blob
docs/geographical-location-enrichment-guide.rst	[new file with mode: 0644]	patch \| blob
docs/index.rst	[new file with mode: 0644]	patch \| blob
docs/requirements-docs.txt	[new file with mode: 0644]	patch \| blob
docs/supported-filter-options.rst	[new file with mode: 0644]	patch \| blob
teiv/src/main/resources/models/o-ran-smo-teiv-cloud-to-ran.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-cloud.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-extensions.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-common-yang-types.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-equipment-to-ran.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-equipment.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-cloud.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-oam-to-ran.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-oam.yang		patch \| blob \| history
teiv/src/main/resources/models/o-ran-smo-teiv-ran.yang		patch \| blob \| history
tox.ini	[new file with mode: 0644]	patch \| blob