First Commit

2026-05-31 10:17:09 +07:00
commit 17a9c69379
4547 changed files with 1170384 additions and 0 deletions
@@ -0,0 +1,88 @@
+# IfcOpenShell - IFC toolkit and geometry engine
+# Copyright (C) 2021 Thomas Krijnen <thomas@aecgeeks.com>
+#
+# This file is part of IfcOpenShell.
+#
+# IfcOpenShell is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# IfcOpenShell is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with IfcOpenShell.  If not, see <http://www.gnu.org/licenses/>.
+
+
+###############################################################################
+#                                                                             #
+# This files uses the documentation files from buildingSMART to generate      #
+# descriptions from EXPRESS names that are suitable for comments in the C++   #
+# code. The .csv files used by this file are generated from the MS Office     #
+# Access database, which in turn has been generated from the IFC baseline     #
+# documentation by the IFCDOC utility provided by buildingSMART.              #
+#                                                                             #
+###############################################################################
+
+import re
+import os
+import csv
+
+from schema import OrderedCaseInsensitiveDict
+
+try:
+    from html.entities import entitydefs
+except:
+    from htmlentitydefs import entitydefs
+
+make_absolute = lambda fn: os.path.join(os.path.dirname(os.path.realpath(__file__)), fn)
+
+name_to_oid = OrderedCaseInsensitiveDict()
+oid_to_desc = {}
+oid_to_name = {}
+oid_to_pid = {}
+regices = list(
+    zip(
+        [re.compile(s, re.M) for s in [r'<[\w\n=" \-/\.;_\t:%#,\?\(\)]+>', r"(\n[\t ]*){2,}", r"^[\t ]+"]],
+        ["", "\n\n", "  "],
+    )
+)
+
+definition_files = ["DocEntity.csv", "DocEnumeration.csv", "DocDefined.csv", "DocSelect.csv"]
+definition_files = map(make_absolute, definition_files)
+for fn in definition_files:
+    with open(fn, encoding="utf8", errors="ignore") as f:
+        for oid, name, desc in csv.reader(f, delimiter=";", quotechar='"'):
+            name_to_oid[name] = oid
+            oid_to_name[oid] = name
+            oid_to_desc[oid] = desc
+
+with open(make_absolute("DocEntityAttributes.csv")) as f:
+    for pid, x, oid in csv.reader(f, delimiter=";", quotechar='"'):
+        oid_to_pid[oid] = pid
+
+with open(make_absolute("DocAttribute.csv")) as f:
+    for oid, name, desc in csv.reader(f, delimiter=";", quotechar='"'):
+        pid = oid_to_pid[oid]
+        pname = oid_to_name[pid]
+        name_to_oid[".".join((pname, name))] = oid
+        oid_to_desc[oid] = desc
+
+
+def description(item):
+    global name_to_oid, oid_to_desc, oid_to_name, oid_to_pid
+    oid = name_to_oid.get(item, 0)
+    desc = oid_to_desc.get(oid, None)
+    if desc:
+        for a, b in entitydefs.items():
+            desc = desc.replace("&%s;" % a, b)
+        desc = desc.replace("\r", "")
+        for r, s in regices:
+            desc = r.sub(s, desc)
+        desc = desc.strip()
+        return desc.split("\n")
+    else:
+        return []