util.doc: fix the same truncation in pset and property descriptions

The property-set and property extraction sites had the identical first-paragraph truncation: descriptions ending at a colon lost their bulleted lists and follow-up paragraphs. Route all four sites (IFC2X3 + IFC4, pset-level and property-level including recursive children) through extract_full_description, and make the existing HISTORY: changelog split case-insensitive, since 21 pset docs use "History:" which only becomes reachable once the walk passes the first paragraph. Data refreshed from the same local buildingSMART doc sources with the merge-only-description discipline: IFC4 376 descriptions completed (34 pset + 342 property/child), IFC2X3 147 (20 + 127), zero artifact regressions, all other fields byte-identical. Example: Pset_DamperOccurrence.SizingMethod previously ended at "...nominally or with exact measurements:" and now includes "NOMINAL: Nominal sizing method. EXACT: Exact sizing method." Generated with the assistance of an AI coding tool. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-30 20:19:59 +00:00 · 2026-07-12 15:17:55 +03:00
parent 5977587f03
commit 3d15f581d1
3 changed files with 539 additions and 529 deletions
@@ -480,9 +480,14 @@ class DocExtractor:
                    with open(md_path, "r", encoding="utf-8-sig") as fi:
                        # convert markdown to html for easier parsing
                        html = markdown(fi.read())
-                        property_set_description = BeautifulSoup(html, features="lxml").find("p").text
+                        property_set_description = self.extract_full_description(html)
                        property_set_description = property_set_description.replace("\n", " ")
-                        property_set_description = property_set_description.split("HISTORY:", 1)[0]
+                        # case-insensitive: some pset docs use "History:" instead of "HISTORY:",
                        # which only becomes reachable now that extract_full_description() walks
                        # past the first paragraph.
                        property_set_description = re.split(
                            r"HISTORY:", property_set_description, maxsplit=1, flags=re.IGNORECASE
                        )[0]
                        property_set_description = property_set_description.strip()
                        property_set_dict["description"] = property_set_description
                else:
@@ -554,7 +559,7 @@ class DocExtractor:
                with open(md_path, "r", encoding="utf-8-sig") as fi:
                    # convert markdown to html for easier parsing
                    html = markdown(fi.read())
-                    description = BeautifulSoup(html, features="lxml").find("p").text
+                    description = self.extract_full_description(html)
                    description = description.replace("\n", " ")
                    description = description.replace("\u00a0", " ")
                    property_dict["description"] = description
@@ -807,9 +812,14 @@ class DocExtractor:
                    with open(md_path, "r", encoding="utf-8-sig") as fi:
                        # convert markdown to html for easier parsing
                        html = markdown(fi.read())
-                        property_set_description = BeautifulSoup(html, features="lxml").find("p").text
+                        property_set_description = self.extract_full_description(html)
                        property_set_description = property_set_description.replace("\n", " ")
-                        property_set_description = property_set_description.split("HISTORY:", 1)[0]
+                        # case-insensitive: some pset docs use "History:" instead of "HISTORY:",
                        # which only becomes reachable now that extract_full_description() walks
                        # past the first paragraph.
                        property_set_description = re.split(
                            r"HISTORY:", property_set_description, maxsplit=1, flags=re.IGNORECASE
                        )[0]
                        property_set_description = property_set_description.strip()
                        property_set_dict["description"] = property_set_description
                else:
@@ -892,7 +902,7 @@ class DocExtractor:
                with open(md_path, "r", encoding="utf-8-sig") as fi:
                    # convert markdown to html for easier parsing
                    html = markdown(fi.read())
-                    description = BeautifulSoup(html, features="lxml").find("p").text
+                    description = self.extract_full_description(html)
                    description = description.replace("\n", " ")
                    description = description.replace("\u00a0", " ")
                    property_dict["description"] = description
@@ -75,7 +75,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcBuildingControlsDomain/Pset_ActuatorTypeHydraulicActuator.xml"
    },
    "Pset_ActuatorTypeLinearActuation": {
-        "description": "Characteristics of linear actuation of an actuator History: Replaces Pset_LinearActuator",
+        "description": "Characteristics of linear actuation of an actuator",
        "properties": {
            "Force": {
                "description": "Indicates the maximum close-off force for the actuator."
@@ -99,7 +99,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcBuildingControlsDomain/Pset_ActuatorTypePneumaticActuator.xml"
    },
    "Pset_ActuatorTypeRotationalActuation": {
-        "description": "Characteristics of rotational actuation of an actuator History: Replaces Pset_RotationalActuator",
+        "description": "Characteristics of rotational actuation of an actuator",
        "properties": {
            "RangeAngle": {
                "description": "Indicates the maximum rotation the actuator must traverse."
@@ -3234,19 +3234,19 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_FireSuppressionTerminalTypeBreechingInlet.xml"
    },
    "Pset_FireSuppressionTerminalTypeFireHydrant": {
-        "description": "Device, fitted to a pipe, through which a temporary supply of water may be provided (BS6100 330 6107)",
+        "description": "Device, fitted to a pipe, through which a temporary supply of water may be provided (BS6100 330 6107) For further details on fire hydrants, see www.firehydrant.org",
        "properties": {
            "BodyColor": {
-                "description": "Color of the body of the hydrant."
+                "description": "Color of the body of the hydrant. Note: Consult local fire regulations for statutory colors that may be required for hydrant bodies in particular circumstances."
            },
            "CapColor": {
-                "description": "Color of the caps of the hydrant."
+                "description": "Color of the caps of the hydrant. Note: Consult local fire regulations for statutory colors that may be required for hydrant caps in particular circumstances."
            },
            "DischargeFlowRate": {
                "description": "The volumetric rate of fluid discharge."
            },
            "FireHydrantType": {
-                "description": "Defines the range of hydrant types from which the required type can be selected where:"
+                "description": "Defines the range of hydrant types from which the required type can be selected where: DryBarrel = A hydrant that has isolating valves fitted below ground and that may be used where the possibility of water freezing is a consideration. WetBarrel = A hydrant that has isolating valves fitted above ground and that may be used where there is no possibility of water freezing."
            },
            "FlowClass": {
                "description": "Alphanumeric indication of the flow class of a hydrant (may be used in connection with or instead of the FlowRate property)"
@@ -3270,7 +3270,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_FireSuppressionTerminalTypeFireHydrant.xml"
    },
    "Pset_FireSuppressionTerminalTypeHoseReel": {
-        "description": "A supporting framework on which a hose may be wound (BS6100 155 8201).",
+        "description": "A supporting framework on which a hose may be wound (BS6100 155 8201). Note that the service provided by the hose (water/foam) is determined by the context of the system onto which the hose reel is connected.",
        "properties": {
            "ClassOfService": {
                "description": "A classification of usage of the hose reel that may be applied."
@@ -3372,7 +3372,7 @@
                "description": "The absolute roughness factor of the duct fitting."
            },
            "Color": {
-                "description": "The color of the duct fitting."
+                "description": "The color of the duct fitting. Note: This is typically used for any duct fittings with a painted surface which is not otherwise specified as a covering."
            },
            "HasLiner": {
                "description": "TRUE if the fitting has interior duct insulating lining, FALSE if it does not."
@@ -3384,7 +3384,7 @@
        "description": "Pipe fitting occurrence attributes attached to an instance of IfcFlowFitting.",
        "properties": {
            "Color": {
-                "description": "The color of the pipe fitting."
+                "description": "The color of the pipe fitting. Note: This is typically used only for plastic pipe fittings. However, it may be used for any pipe fittings with a painted surface which is not otherwise specified as a covering."
            },
            "InteriorRoughnessCoefficient": {
                "description": "The interior roughness of the pipe fitting material."
@@ -3561,7 +3561,7 @@
        "description": "Duct segment occurrence attributes attached to an instance of IfcFlowSegment.",
        "properties": {
            "Color": {
-                "description": "The color of the duct segment."
+                "description": "The color of the duct segment. Note: This is typically used for any duct segments with a painted surface which is not otherwise specified as a covering."
            },
            "HasLiner": {
                "description": "TRUE if the fitting has interior duct insulating lining, FALSE if it does not."
@@ -3582,7 +3582,7 @@
        "description": "Pipe segment occurrence attributes attached to an instance of IfcFlowSegment.",
        "properties": {
            "Color": {
-                "description": "The color of the pipe segment."
+                "description": "The color of the pipe segment. Note: This is typically used only for plastic pipe segments. However, it may be used for any pipe segments with a painted surface which is not otherwise specified as a covering."
            },
            "Gradient": {
                "description": "The gradient of the pipe segment."
@@ -3603,13 +3603,13 @@
        "description": "Properties that relate to an instance of a flow storage device that is typed as a tank. Note that a partial tank may be considered as a compartment within a compartmentalized tank.",
        "properties": {
            "HasLadder": {
-                "description": "Indication of whether the tank is provided with a ladder (set TRUE) for access to the top. If no ladder is provided then value is set FALSE."
+                "description": "Indication of whether the tank is provided with a ladder (set TRUE) for access to the top. If no ladder is provided then value is set FALSE. Note: No indication is given of the type of ladder (gooseneck etc.)"
            },
            "HasVisualIndicator": {
                "description": "Indication of whether the tank is provided with a visual indicator (set TRUE) that shows the water level in the tank. If no visual indicator is provided then value is set FALSE."
            },
            "TankComposition": {
-                "description": "Defines the level of element composition where:"
+                "description": "Defines the level of element composition where: COMPLEX = A set of elementary units aggregated together to fulfill the overall required purpose. ELEMENT = A single elementary unit that may exist of itself or as an aggregation of partial units.. PARTIAL"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcSharedBldgServiceElements/Pset_FlowStorageDeviceTank.xml"
@@ -3717,7 +3717,7 @@
        "description": "Piece of equipment for occupants use that is connected to a gas installation (definition is a modification from that found in BS6100).",
        "properties": {
            "FlueType": {
-                "description": "Defines the types of flue that may be specified for connection to gas appliances where:"
+                "description": "Defines the types of flue that may be specified for connection to gas appliances where: BalancedFlue = Room sealed appliance that has its inlet for combustion air and its outlet for products of combustion in adjacent external positions, disposed so that wind effects are substantially balanced between them. Flued = Gas burning appliance designed for connection to a flue system Flueless = Gas burning appliance designed for use without connection to a flue system OpenFlued = Gas burning appliance designed to be connected to an open flue system, combustion air being drawn from a room or internal space in which the gas burning appliance is installed RoomSealed = Gas burning appliance that has its combustion system, including air inlet and products outlet, isolated from a room or internal space in which the gas burning appliance is installed"
            },
            "GasApplianceType": {
                "description": "Selection of the type of gas appliance from the enumerated list of types."
@@ -4074,7 +4074,7 @@
                "description": "Special requirements for material used to contain an artefact."
            },
            "PackingCareType": {
-                "description": "Identifies the predefined types of care that may be required when handling the artefact during a move where:"
+                "description": "Identifies the predefined types of care that may be required when handling the artefact during a move where: Fragile = artefact may be broken during a move through careless handling. HandleWithCare = artefact may be damaged during a move through careless handling."
            },
            "SpecialInstructions": {
                "description": "Special instructions for packing."
@@ -4092,16 +4092,16 @@
                "description": "End time."
            },
            "EscortRequirement": {
-                "description": "Indicates whether or not an escort is required to accompany persons carrying out a work order at or to/from the place of work (= TRUE) or not (= FALSE)."
+                "description": "Indicates whether or not an escort is required to accompany persons carrying out a work order at or to/from the place of work (= TRUE) or not (= FALSE). NOTE - There are many instances where escorting is required, particularly in a facility that has a high security rating. Escorting may require that persons are escorted to and from the place of work. Alternatively, it may involve the escort remaining at the place of work at all times."
            },
            "PermitDuration": {
                "description": "Permit duration."
            },
            "PermitType": {
-                "description": "Identifies the predefined types of permits that can be granted where:"
+                "description": "Identifies the predefined types of permits that can be granted where: Access = enables access to an identified area, Work = enables work to be carried out in an identified area"
            },
            "SpecialRequirements": {
-                "description": "Any additional special requirements that need to be included in the permit to work."
+                "description": "Any additional special requirements that need to be included in the permit to work. NOTE - Additional permit requirements may be imposed according to the nature of the facility at which the work is carried out. For instance, in clean areas, special clothing may be required whilst in corrective institutions, it may be necessary to check in and check out tools that will be used for work as a safety precaution."
            },
            "StartDate": {
                "description": "Start date."
@@ -4359,19 +4359,19 @@
                "description": "The contractual type of the work."
            },
            "FaultPriorityType": {
-                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where:"
+                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where: High = action is required urgently. Medium = action can occur within a reasonable period of time. Low = action can occur when convenient."
            },
            "IfNotAccomplished": {
                "description": "Comments if the job is not accomplished."
            },
            "LocationPriorityType": {
-                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where:"
+                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where: High = action is required urgently. Medium = action can occur within a reasonable period of time. Low = action can occur when convenient."
            },
            "LongJobDescription": {
                "description": "Description of the job requested."
            },
            "MaintenaceType": {
-                "description": "Identifies the predefined types of maintenance that can be done from which the type that generates the maintenance work order may be set where:"
+                "description": "Identifies the predefined types of maintenance that can be done from which the type that generates the maintenance work order may be set where: ConditionBased = generated as a result of the condition of an asset or artefact being less than a determined value. Corrective = generated as a result of an immediate and urgent need for maintenance action. PlannedCorrective = generated as a result of immediate corrective action being needed but with sufficient time available for the work order to be included in maintenance planning. Scheduled = generated as a result of a fixed, periodic maintenance requirement."
            },
            "ProductDescription": {
                "description": "A textual description of the products that require the work."
@@ -4449,7 +4449,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcHvacDomain/Pset_ProjectionElementShadingDevicePHistory.xml"
    },
    "Pset_PropertyAgreement": {
-        "description": "A property agreement is an agreement that enables the occupation of a property for a period of time.",
+        "description": "A property agreement is an agreement that enables the occupation of a property for a period of time. The objective is to capture the information within an agreement that is relevant to a facilities manager. Design and construction information associated with the property is not considered. A property agreement may be applied to an instance of IfcSpatialStructureElement including to compositions defined through the IfcSpatialStructureElement.Element.CompositionEnum. Note that the associated actors are captured by the IfcOccupant class.",
        "properties": {
            "AgreementType": {
                "description": "Identifies the predefined types of property agreement from which the type required may be set."
@@ -4494,7 +4494,7 @@
        "description": "Definition from IEC 441-14-20: A circuit breaker is a mechanical switching device capable of making, carrying, and breaking currents under normal circuit conditions and also making, carrying for a specified time and breaking, current under specified abnormal circuit conditions such as those of short circuit.",
        "properties": {
            "CircuitBreakerType": {
-                "description": "A list of the available types of circuit breaker from which that required may be selected where:"
+                "description": "A list of the available types of circuit breaker from which that required may be selected where: ACB - Air Circuit Breaker; MCB - Miniature Circuit Breaker (up to 125A); MCCB - Moulded Case Circuit Breaker (40A - 1600A); Vacuum - Generally used for high voltage (> 1000V) but may be used for installations close to/up to 1000V."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcElectricalDomain/Pset_ProtectiveDeviceTypeCircuitBreaker.xml"
@@ -4533,7 +4533,7 @@
        "description": "An earth failure device acts to protect people and equipment from the effects of current leakage.",
        "properties": {
            "EarthFailureDeviceType": {
-                "description": "A list of the available types of circuit breaker from which that required may be selected where:"
+                "description": "A list of the available types of circuit breaker from which that required may be selected where: Standard - Device that operates without a time delay; TimeDelayed - Device that operates after a time delay."
            },
            "Sensitivity": {
                "description": "Current leakage to an unwanted leading path during normal operation (IEC 151-14-49)"
@@ -4545,7 +4545,7 @@
        "description": "A device that will electrically open the circuit after a period of prolonged, abnormal current flow.",
        "properties": {
            "FuseDisconnectorType": {
-                "description": "A list of the available types of fuse disconnector from which that required may be selected where:"
+                "description": "A list of the available types of fuse disconnector from which that required may be selected where: EngineProtectionDevice - A fuse whose characteristic is specifically designed for the protection of a motor or generator. FuseSwitchDisconnector - A switch disconnector in which a fuse link or a fuse carrier with fuse link forms the moving contact, HRC - A standard fuse (High Rupturing Capacity) OverloadProtectionDevice - A device that disconnects the supply when the operating conditions in an electrically undamaged circuit causes an overcurrent, SemiconductorFuse - A fuse whose characteristic is specifically designed for the protection of sem-conductor devices. SwitchDisconnectorFuse - A switch disconnector in which one or more poles have a fuse in series in a composite unit."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcElectricalDomain/Pset_ProtectiveDeviceTypeFuseDisconnector.xml"
@@ -5051,13 +5051,13 @@
        "description": "An indication of exposure to mischance, peril, menace, hazard or loss.",
        "properties": {
            "AffectsSurroundings": {
-                "description": "Indicates wether the risk affects only to the person assigned to that task (FALSE) or if it can also affect to the people in the surroundings (TRUE)."
+                "description": "Indicates wether the risk affects only to the person assigned to that task (FALSE) or if it can also affect to the people in the surroundings (TRUE). For example, the process of painting would affect all the people in the vicinity of the process"
            },
            "AssessmentOfRisk": {
-                "description": "Likelihood of risk event occurring."
+                "description": "Likelihood of risk event occurring. Note that assessment of risk may frequently be associated with the physical location of the object for which the risk is assessed."
            },
            "NatureOfRisk": {
-                "description": "An indication of the generic nature of the risk that might be encountered. "
+                "description": "An indication of the generic nature of the risk that might be encountered. NOTE: It is anticipated that there will be a local agreement that constrains the values that might be assigned to this property. An example might be 'Fall' or 'Fall of grille unit' causing injury and damage to person and property"
            },
            "PreventiveMeassures": {
                "description": "Identifies preventive measures to be taken to mitigate risk"
@@ -5078,7 +5078,7 @@
                "description": "Identifies the predefined types of risk from which the type required may be set."
            },
            "SubNatureOfRisk1": {
-                "description": "A first subsidiary value that might be assigned to designate a more specific type of risk."
+                "description": "A first subsidiary value that might be assigned to designate a more specific type of risk. NOTE: Nature of risk may be identified in various ways depending upon the place where risk assessment takes place and according to local agreement. This property set allows for a generic nature of risk and up to two subsidiary natures. An example might be 'causing injury and damage'"
            },
            "SubNatureOfRisk2": {
                "description": "A second subsidiary value that might be assigned to designate a more specific type of risk. An example might be 'o person and property'"
@@ -5111,7 +5111,7 @@
        "description": "Sanitary appliance for immersion of the human body or parts of it (BS6100).",
        "properties": {
            "BathType": {
-                "description": "The property enumeration defines the types of bath that may be specified within the property set where:"
+                "description": "The property enumeration defines the types of bath that may be specified within the property set where: Domestic = Bath, for one person at a time, into which the whole body can be easily immersed. DomesticCorner = Bath, for one person at a time, into which the whole body can be easily immersed and in which the immersion trough is at an angle. Foot = Shallow bath for washing the feet. Jacuzzi = Whirlpool bath for more than one person Plunge = Bath, usually for more than one person at a time, into which the whole body can be easily immersed. Sitz = Bath in which a bather sits as in a chair. Treatment = Bath used for hydrotherapy purposes. Whirlpool = Bath in which an integrated device agitates the water by pumped circulation or induction of water and/or air."
            },
            "Color": {
                "description": "Principal color of the object."
@@ -5144,7 +5144,7 @@
        "description": "Waste water appliance for washing the excretory organs while sitting astride the bowl (BS6100)",
        "properties": {
            "BidetMounting": {
-                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:-"
+                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor"
            },
            "Color": {
                "description": "Color selection for this object"
@@ -5189,7 +5189,7 @@
                "description": "The minimum and maximum volume of water used at each flush. Where a single flush is used, the value of upper bound and lower bound should be equal. For a dual flush toilet, the lower bound should be used for the lesser flush rate and the upper bound for the greater flush rate. Where flush is achieved using mains pressure water through a flush valve, the value of upper and lower bound should be equal and should be the same as the flush rate property of the flush valve (see relevant valve property set). Alternatively, in this case, do not assert the flush rate property; refer to the flush rate of the flush valve."
            },
            "FlushType": {
-                "description": "The property enumeration Pset_FlushTypeEnum defines the types of flushing mechanism that may be specified for cisterns and sanitary terminals where:-"
+                "description": "The property enumeration Pset_FlushTypeEnum defines the types of flushing mechanism that may be specified for cisterns and sanitary terminals where:- Lever = Flushing is achieved by twisting a lever that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Pull = Flushing is achieved by pulling a handle or knob vertically upwards that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Push = Flushing is achieved by pushing a button or plate that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Sensor = Flush is activated through an automatic sensing mechanism."
            },
            "IsAutomaticFlush": {
                "description": "Boolean value that determines if the cistern is flushed automatically either after each use or periodically (TRUE) or whether manual flushing is required (FALSE)"
@@ -5210,13 +5210,13 @@
                "description": "The size of the drain outlet connection from the object"
            },
            "FountainType": {
-                "description": "Selection of the type of fountain from the enumerated list of types where:-"
+                "description": "Selection of the type of fountain from the enumerated list of types where:- DrinkingWater = Sanitary appliance that provides a low pressure jet of drinking water. Eyewash = Waste water appliance, usually installed in work places where there is a risk of injury to eyes by solid particles or dangerous liquids, with which the user can wash the eyes without touching them."
            },
            "Material": {
                "description": "Material from which the object is constructed"
            },
            "Mounting": {
-                "description": "Selection of the form of mounting of the fountain from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting of the fountain from the enumerated list of mountings where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor"
            },
            "NominalDepth": {
                "description": "Nominal or quoted depth of the object."
@@ -5261,7 +5261,7 @@
                "description": "A description of the shower head(s) that emit the spray of water"
            },
            "ShowerType": {
-                "description": "Selection of the type of shower from the enumerated list of types where:-"
+                "description": "Selection of the type of shower from the enumerated list of types where:- Drench = Shower that rapidly gives a thorough soaking in an emergency Individual = Shower unit that is typically enclosed and is for the use of one person at a time Tunnel = Shower that has a succession of shower heads or spreaders that operate simultaneously along its length"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_SanitaryTerminalTypeShower.xml"
@@ -5288,10 +5288,10 @@
                "description": "Nominal or quoted width of the object."
            },
            "SinkMounting": {
-                "description": "Selection of the form of mounting of the sink from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting of the sink from the enumerated list of mountings where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor"
            },
            "SinkType": {
-                "description": "Selection of the type of sink from the enumerated list of types where:-"
+                "description": "Selection of the type of sink from the enumerated list of types where:- Belfast = Deep sink that has a plain edge and a weir overflow . Bucket = Sink at low level, with protected front edge, that facilitates filling and emptying buckets, usually with a hinged grid on which to stand them. Cleaners = Sink, usually fixed at normal height (900mm), with protected front edge. Combination_Left = Sink with integral drainer on left hand side . Combination_Right = Sink with integral drainer on right hand side . Combination_Double = Sink with integral drainer on both sides . Drip = Small sink that catches drips or flow from a faucet . Laboratory = Sink, of acid resisting material, with a top edge shaped to facilitate fixing to the underside of a desktop . London = Deep sink that has a plain edge and no overflow . Plaster = Sink with sediment receiver to prevent waste plaster passing into drains . Pot = Large metal sink, with a standing waste, for washing cooking utensils . Rinsing = Metal sink in which water can be heated and culinary utensils and tableware immersed at high temperature that destroys most harmful bacteria and allows subsequent self drying. . Shelf = Ceramic sink with an integral back shelf through which water fittings are mounted . VegetablePreparation = Large metal sink, with a standing waste, for washing and preparing vegetables ."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_SanitaryTerminalTypeSink.xml"
@@ -5315,16 +5315,16 @@
                "description": "Material from which the object is constructed"
            },
            "PanMounting": {
-                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:-"
+                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor"
            },
            "SpilloverLevel": {
                "description": "The level at which water spills out of the terminal."
            },
            "ToiletPanType": {
-                "description": "The property enumeration Pset_ToiletPanTypeEnum defines the types of toilet pan that may be specified within the property set Pset_Toilet:-"
+                "description": "The property enumeration Pset_ToiletPanTypeEnum defines the types of toilet pan that may be specified within the property set Pset_Toilet:- Siphonic = Toilet pan in which excrement is removed by siphonage induced by the flushing water. Squat = Toilet pan with an elongated bowl installed with its top edge at or near floor level, so that the user has to squat. WashDown = Toilet pan in which excrement is removed by the momentum of the flushing water. WashOut = A washdown toilet pan in which excrement falls first into a shallow water filled bowl."
            },
            "ToiletType": {
-                "description": "Enumeration that defines the types of toilet (water closet) arrangements that may be specified where:-"
+                "description": "Enumeration that defines the types of toilet (water closet) arrangements that may be specified where:- BedPanWasher = Enclosed soil appliance in which bedpans and urinal bottles are emptied and cleansed Chemical = Portable receptacle or soil appliance that receives and retains excrement in either an integral or a separate container, in which it is chemically treated and from which it has to be emptied periodically. CloseCoupled = Toilet suite in which a flushing cistern is connected directly to the water closet pan. LooseCoupled = Toilet arrangement in which a flushing cistern is connected to the water closet pan through a flushing pipe. SlopHopper = Hopper shaped soil appliance with a flushing rim and outlet similar to those of a toilet pan, into which human excrement is emptied for disposal"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_SanitaryTerminalTypeToiletPan.xml"
@@ -5351,7 +5351,7 @@
                "description": "Material from which the object is constructed"
            },
            "UrinalType": {
-                "description": "Selection of the type of urinal from the enumerated list of types where:-"
+                "description": "Selection of the type of urinal from the enumerated list of types where:- Bowl = Individual wall mounted urinal Slab = Urinal that consists of a slab or sheet fixed to a wall and down which urinal flows into a floor channel Stall = Floor mounted urinal that consists of an elliptically shaped sanitary stall fixed to a wall and down which urine flows into a floor channel Trough = Wall mounted urinal of elongated rectangular shape on plan, that can be used by more than one person at a time."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_SanitaryTerminalTypeUrinal.xml"
@@ -5369,7 +5369,7 @@
                "description": "Material from which the object is constructed"
            },
            "SeatType": {
-                "description": "The property enumeration Pset_ToiletSeatTypeEnum defines the types of seat that may be attached to the toilet pan and specified within the property set Pset_Toilet where:-"
+                "description": "The property enumeration Pset_ToiletSeatTypeEnum defines the types of seat that may be attached to the toilet pan and specified within the property set Pset_Toilet where:- Extension = WC seat that is attached at the back, by means of side or top hinges, to a flat piece of material secured to the water closet pan Inset = Seat that consists of pads of impervious material fixed to the top of a water closet pan OpenFrontSeat = Hinged WC seat shaped like a horseshoe with the gap at the front RingSeat = WC seat in the shape of a ring SelfRaising = WC seat with balanced weights or springs to raise it when not in use None = There is no seat attached to the water closet pan"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcPlumbingFireProtectionDomain/Pset_SanitaryTerminalTypeWCSeat.xml"
@@ -5396,7 +5396,7 @@
                "description": "Nominal or quoted width of the object."
            },
            "WashHandBasinMounting": {
-                "description": "Selection of the form of mounting from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting from the enumerated list of mountings where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor"
            },
            "WashHandBasinType": {
                "description": "Defines the types of wash hand basin that may be specified where: DentalCuspidor = Waste water appliance that receives and flushes away mouth washings HandRinse = Wall mounted wash hand basin that has an overall width of 500mm or less Hospital = Wash hand basin that has a smooth easy clean surface without tapholes or overflow slot for use where hygiene is of prime importance. Tipup = Wash hand basin mounted on pivots so that it can be emptied by tilting Vanity = Wash hand basin for installation into a horizontal surface Washfountain = Wash hand basin that is circular, semi-circular or polygonal on plan, at which more than one person can wash at the same time. WashingTrough = Wash hand basin of elongated rectangular shape in plan, at which more than one person can wash at the same time."
@@ -6132,7 +6132,7 @@
        "description": "An electrical device used to control the flow of power in a circuit on or off.",
        "properties": {
            "ContactorType": {
-                "description": "A list of the available types of contactor from which that required may be selected where:"
+                "description": "A list of the available types of contactor from which that required may be selected where: CapacitorSwitching - for switching 3 phase single or multi-step capacitor banks LowCurrent - requires the use of low resistance contacts MagneticLatching - enables the contactor to remain in the on position when the coil is no longer energized MechanicalLatching - requires that the contactor is mechanically retained in the on position Modular - are totally enclosed and self contained Reversing - has a double set of contactors that are prewired Standard - is a generic device that controls the flow of power in a circuit on or off"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcElectricalDomain/Pset_SwitchingDeviceTypeContactor.xml"
@@ -6150,7 +6150,7 @@
        "description": "A starter is a switch which in the closed position controls the application of power to an electrical device.",
        "properties": {
            "StarterType": {
-                "description": "A list of the available types of starter from which that required may be selected where:"
+                "description": "A list of the available types of starter from which that required may be selected where: AutoTransformer - A starter for an induction motor which uses for starting one or more reduced voltages derived from an auto transformer. (IEC 441-14-45) Manual - A starter in which the force for closing the main contacts is provided exclusively by manual energy. (IEC 441-14-39) DirectOnLine - A starter which connects the line voltage across the motor terminals in one step. (IEC 441-14-40) Frequency - A starter in which the frequency of the power supply is progressively increased until the normal operation frequency is attained. nStep - A starter in which there are (n-1) intermediate accelerating positions between the off and full on positions. (IEC 441-14-41) Rheostatic - A starter using one or several resistors for obtaining, during starting, stated motor torque characteristics and for limiting the current. (IEC 441-14-425) StarDelta - A starter for a 3 phase induction motor such that in the starting position the stator windings are connected in star and in the final running position they are connected in delta. (IEC 441-14-44)"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcElectricalDomain/Pset_SwitchingDeviceTypeStarter.xml"
@@ -6165,7 +6165,7 @@
                "description": "A list of the available types of load disconnection from which that required may be selected."
            },
            "SwitchDisconnectorType": {
-                "description": "A list of the available types of switch disconnector from which that required may be selected where:"
+                "description": "A list of the available types of switch disconnector from which that required may be selected where: CenterBreak - A disconnector in which both contacts of each pole are movable and engage at a point substantially midway between their supports. (IEC 441-14-08) DividedSupport - A disconnector in which the fixed and moving contacts of each pole are not supported by a common base or frame. (IEC 441-14-06) DoubleBreak - A disconnector that opens a circuit at two points. (IEC 441-14-09) EarthingSwitch - A disconnector in which the fixed and moving contacts of each pole are not supported by a common base or frame. (IEC 441-14-07) Isolator - A disconnector which in the open position satisfies isolating requirements. (IEC 441-14-12)"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcElectricalDomain/Pset_SwitchingDeviceTypeSwitchDisconnector.xml"
@@ -6252,7 +6252,7 @@
        "description": "Common attributes of a tank type.",
        "properties": {
            "AccessType": {
-                "description": "Defines the types of access (or cover) to a tank that may be specified."
+                "description": "Defines the types of access (or cover) to a tank that may be specified. Note that covers are generally specified for rectangular tanks. For cylindrical tanks, access will normally be via a manhole."
            },
            "EffectiveCapacity": {
                "description": "The effective or actual volumetric capacity of the tank."
@@ -6267,19 +6267,19 @@
                "description": "The nominal or design volumetric capacity of the tank."
            },
            "NominalDepth": {
-                "description": "The nominal depth of the tank."
+                "description": "The nominal depth of the tank. Note: Not required for a horizontal cylindrical tank."
            },
            "NominalLengthOrDiameter": {
                "description": "The nominal length or, in the case of a vertical cylindrical tank, the nominal diameter of the tank"
            },
            "NominalWidthOrDiameter": {
-                "description": "The nominal width or, in the case of a horizontal cylindrical tank, the nominal diameter of the tank."
+                "description": "The nominal width or, in the case of a horizontal cylindrical tank, the nominal diameter of the tank. Note: Not required for a vertical cylindrical tank."
            },
            "OperatingWeight": {
                "description": "Operating weight of the tank including all of its contents."
            },
            "Type": {
-                "description": "Defines the types of tank that may be specified where: "
+                "description": "Defines the types of tank that may be specified where: BreakPressure = Tank that breaks the hydraulic pressure in a distribution system Expansion = Tank, connected to the primary circuit of a hot water system that accommodates increase in volume of the water when heated FeedAndExpansion = Tank that supplies cold water to a hot water system and also accommodates increase in volume of the water when heated GasStorage_Butane = Main tank to which commercial butane is delivered and from which it is supplied to a gas distribution system. GasStorage_LPG = Main tank to which liquefied petroleum gas is delivered and from which it is supplied to a gas distribution system. GasStorage_Propane = Main tank to which commercial propane is delivered and from which it is supplied to a gas distribution system. OilService = Secondary tank from which oil fuel is fed to a single oil fuel burning appliance OilStorage = Main tank to which oil fuel is delivered and from which it is supplied to an oil fuel burning appliance or oil service tank. PressureVessel = Tank that stores fluid under pressure. WaterStorage_General = Tank that stores water sufficient to meet general requirements for a designated period of time and supplies it to points of outlet WaterStorage_Potable = Tank that stores water sufficient to meet potable water requirements for a designated period of time and supplies it to points of outlet WaterStorage_Process = Tank that stores water sufficient to meet process and/or production requirements for a designated period of time and supplies it to points of outlet WaterStorage_CoolingTowerMakeup = Tank that stores water sufficient to meet cooling tower make up water requirements for a designated period of time and supplies it to points of outlet"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcHvacDomain/Pset_TankTypeCommon.xml"
@@ -6300,7 +6300,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcHvacDomain/Pset_TankTypeExpansion.xml"
    },
    "Pset_TankTypePreformed": {
-        "description": "Fixed vessel manufactured as a single unit with one or more compartments for storing a liquid.",
+        "description": "Fixed vessel manufactured as a single unit with one or more compartments for storing a liquid. Pset renamed from Pset_TankTypePreformedTank to Pset_TankTypePreformed in IFC2x2 Pset Addendum.",
        "properties": {
            "EndShapeType": {
                "description": "Defines the types of end shapes that can be used for preformed tanks. The convention for reading these enumerated values is that for a vertical cylinder, the first value is the base and the second is the top; for a horizontal cylinder, the order of reading should be left to right. For a speherical tank, the value UNSET should be used."
@@ -6333,10 +6333,10 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/psd/IfcHvacDomain/Pset_TankTypePressureVessel.xml"
    },
    "Pset_TankTypeSectional": {
-        "description": "Fixed vessel constructed from sectional parts with one or more compartments for storing a liquid.",
+        "description": "Fixed vessel constructed from sectional parts with one or more compartments for storing a liquid. Note (1): All sectional construction tanks are considered to be rectangular by default. Note (2): Generally, it is not expected that sectional construction tanks will be used for the purposes of gas storage. Pset renamed from Pset_TankTypeSectionalTank to Pset_TankTypeSectional in IFC2x2 Pset Addendum.",
        "properties": {
            "NumberOfSections": {
-                "description": "Number of sections used in the construction of the tank"
+                "description": "Number of sections used in the construction of the tank Note: All sections assumed to be the same size."
            },
            "SectionLength": {
                "description": "The length of a section used in the construction of the tank"
@@ -6660,13 +6660,13 @@
                "description": "The maximum pressure to which the valve has been subjected under test"
            },
            "ValveMechanism": {
-                "description": "The mechanism by which the valve function is achieved where:"
+                "description": "The mechanism by which the valve function is achieved where: BALL Valve that has a ported ball that can be turned relative to the body seat ports BUTTERFLY Valve in which a streamlined disc pivots about a diametric axis CONFIGUREDGATE Screwdown valve in which the closing gate is shaped in a configured manner to have a more precise control of pressure and flow change across the valve. GLAND Valve with a tapered seating, in which a rotatable plug is retained by means of a gland and gland packing GLOBE Screwdown valve that has a spherical body LUBRICATEDPLUG Plug valve in which a lubricant is injected under pressure between the plug face and the body NEEDLE Valve for regulating the flow in or from a pipe, in which a slender cone moves along the axis of flow to close against a fixed conical seat PARALLELSLIDE Screwdown valve that has a machined plate that slides in formed grooves to form a seal PLUG Valve that has a ported plug that can be turned relative to the body seat ports WEDGEGATE Screwdown valve that has a wedge shaped plate fitting into tapered guides to form a seal"
            },
            "ValveOperation": {
-                "description": "The method of valve operation where:"
+                "description": "The method of valve operation where: DROPWEIGHT = A valve that is closed by the action of a weighted lever being released, the weight normally being prevented from dropping by being held by a wire, the closure normally being made by the action of heat on a fusible link in the wire FLOAT = A valve that is opened and closed by the action of a float that rises and falls with water level. The float may be a ball attached to a lever or other mechanism HYDRAULIC = A valve that is opened and closed by hydraulic actuation LEVER = A valve that is opened and closed by the action of a lever rotating the gate within the valve. LOCKSHIELD = A valve that requires the use of a special lockshield key for opening and closing, the operating mechanism being protected by a shroud during normal operation. MOTORIZED = A valve that is opened and closed by the action of an electric motor on an actuator PNEUMATIC = A valve that is opened and closed by pneumatic actuation SOLENOID = A valve that is normally held open by a magnetic field in a coil acting on the gate but that is closed immediately if the electrical current generating the magnetic field is removed. SPRING = A valve that is normally held in position by the pressure of a spring on a plate but that may be caused to open if the pressure of the fluid is sufficient to overcome the spring pressure. THERMOSTATIC = A valve in which the ports are opened or closed to maintain a required predetermined temperature. WHEEL = A valve that is opened and closed by the action of a wheel moving the gate within the valve."
            },
            "ValvePattern": {
-                "description": "The configuration of the ports of a valve according to either the linear route taken by a fluid flowing through the valve or by the number of ports where:"
+                "description": "The configuration of the ports of a valve according to either the linear route taken by a fluid flowing through the valve or by the number of ports where: SINGLEPORT = Valve that has a single entry port from the system that it serves, the exit port being to the surrounding environment. ANGLED_2_PORT = Valve in which the direction of flow is changed through 90 degrees STRAIGHT_2_PORT = Valve in which the flow is straight through STRAIGHT_3_PORT = Valve with three separate ports CROSSOVER_4_PORT = Valve with 4 separate ports"
            },
            "WorkingPressure": {
                "description": "The normally expected maximum working pressure of the valve"
@@ -6690,13 +6690,13 @@
                "description": "Defines the operating temperature of a faucet that may be specified."
            },
            "FaucetOperation": {
-                "description": "Defines the range of ways in which a faucet can be operated that may be specified where:"
+                "description": "Defines the range of ways in which a faucet can be operated that may be specified where: CeramicDisc = Quick action faucet with a ceramic seal to open or close the orifice LeverHandle = Quick action faucet that is operated by a lever handle NonConcussiveSelfClosing = Self closing faucet that does not induce surge pressure QuarterTurn = Quick action faucet that can be fully opened or shut by turning the operating mechanism through 90 degrees. QuickAction = Faucet that can be opened or closed fully with a single small movement of the operating mechanism ScrewDown = Faucet in which a plate or disc is moved, by the rotation of a screwed spindle, to close or open the orifice. SelfClosing = Faucet that is opened by pressure of the top of an operating spindle and is closed under the action of a spring or weight when the pressure is released TimedSelfClosing = Self closing faucet that discharges for a predetermined period of time"
            },
            "FaucetTopDescription": {
                "description": "Description of the operating mechanism/top of the faucet"
            },
            "FaucetType": {
-                "description": "Defines the range of faucet types that may be specified where:"
+                "description": "Defines the range of faucet types that may be specified where: Bib = Faucet with a horizontal inlet and a nozzle that discharges downwards. Globe = Faucet fitted through the end of a bath, with a horizontal inlet, a partially spherical body and a vertical nozzle. Diverter = Combination faucet assembly with a valve to enable the flow of mixed water to be transferred to a showerhead. DividedFlowCombination = Combination faucet assembly in which hot and cold water are kept separate until emerging from a common nozzle Pillar = Faucet that has a vertical inlet and a nozzle that discharges downwards SingleOutletCombination = Combination faucet assembly in which hot and cold water mix before emerging from a common nozzle Spray = Faucet with a spray outlet SprayMixing = Spray faucet connected to hot and cold water supplies that delivers water at a temperature determined during use."
            },
            "Finish": {
                "description": "Description of the finish applied to the faucet"
@@ -6852,10 +6852,10 @@
                "description": "Indicates whether the gully trap has a strainer (= TRUE) or not (= FALSE)"
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "InletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a trap."
+                "description": "Identifies the pattern of inlet connections to a trap. A trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south)."
            },
            "IsForSullageWater": {
                "description": "Indicates if the purpose of the floor trap is to receive sullage water, or if that is amongst its purposes (= TRUE), or not (= FALSE). Note that if TRUE, it is expected that an upstand or kerb will be placed around the floor trap to prevent the ingress of surface water runoff; the provision of the upstand or kerb is not dealt with in this property set."
@@ -6957,7 +6957,7 @@
        "description": "Pipe fitting or assembly of fittings to receive surface water or waste water, fitted with a grating or sealed cover.",
        "properties": {
            "BackInletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a gully trap."
+                "description": "Identifies the pattern of inlet connections to a gully trap. A gulley trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the gully trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south). ! | 1-| |-3 ! |"
            },
            "CoverLength": {
                "description": "The length measured along the x-axis in the local coordinate system or the radius (in the case of a circular shape in plan) of the cover of the gully trap."
@@ -6972,7 +6972,7 @@
                "description": "Identifies the predefined types of gully from which the type required may be set."
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "NominalSumpDepth": {
                "description": "Nominal or quoted length measured along the z-axis in the local coordinate system of the sump."
@@ -6999,7 +6999,7 @@
        "description": "Pipe fitting or assembly of fittings to receive surface water or waste water, fitted with a grating or sealed cover and discharging through a trap (BS6100 330 3504 modified)",
        "properties": {
            "BackInletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a gully trap."
+                "description": "Identifies the pattern of inlet connections to a gully trap. A gulley trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the gully trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south)."
            },
            "BodyMaterial": {
                "description": "The primary material used to construct the object"
@@ -7020,7 +7020,7 @@
                "description": "Indicates whether the gully trap has a strainer (= TRUE) or not (= FALSE)"
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "NominalBodyDepth": {
                "description": "Nominal or quoted length measured along the z-axis in the local coordinate system of the chamber of the gully trap."
@@ -7158,7 +7158,7 @@
        "description": "Pipe fitting, set adjacent to a sanitary terminal, that retains liquid to prevent the passage of foul air.",
        "properties": {
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "OutletConnectionSize": {
                "description": "Size of the outlet connection from the object"
@@ -90,7 +90,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcbuildingcontrolsdomain/pset/pset_actuatortypehydraulicactuator.htm"
    },
    "Pset_ActuatorTypeLinearActuation": {
-        "description": "Characteristics of linear actuation of an actuator History: Replaces Pset_LinearActuator",
+        "description": "Characteristics of linear actuation of an actuator",
        "properties": {
            "Force": {
                "description": "Indicates the maximum close-off force for the actuator."
@@ -114,7 +114,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcbuildingcontrolsdomain/pset/pset_actuatortypepneumaticactuator.htm"
    },
    "Pset_ActuatorTypeRotationalActuation": {
-        "description": "Characteristics of rotational actuation of an actuator History: Replaces Pset_RotationalActuator",
+        "description": "Characteristics of rotational actuation of an actuator",
        "properties": {
            "RangeAngle": {
                "description": "Indicates the maximum rotation the actuator must traverse."
@@ -318,7 +318,7 @@
                "description": "Identifies the way the core of the AirTerminal is constructed."
            },
            "DischargeDirection": {
-                "description": "Discharge direction of the air terminal."
+                "description": "Discharge direction of the air terminal. Parallel: discharges parallel to mounting surface designed so that flow attaches to the surface. Perpendicular: discharges away from mounting surface. Adjustable: both parallel and perpendicular discharge."
            },
            "EffectiveArea": {
                "description": "Effective discharge area of the air terminal."
@@ -348,7 +348,7 @@
                "description": "If TRUE, the air terminal has thermal insulation."
            },
            "MountingType": {
-                "description": "The way the air terminal is mounted to the ceiling, wall, etc."
+                "description": "The way the air terminal is mounted to the ceiling, wall, etc. Surface: mounted to the surface of something (e.g., wall, duct, etc.). Flat flush: mounted flat and flush with a surface. Lay-in: mounted in a lay-in type ceiling (e.g., a dropped ceiling grid)."
            },
            "NeckArea": {
                "description": "Neck area of the air terminal."
@@ -792,19 +792,19 @@
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1'), Also referred to as \"construction type\". It should be provided as an alternative to the name of the \"object type\", if the software does not support object types."
            },
            "Roll": {
-                "description": "Rotation against the longitudinal axis - relative to the global Z direction for all beams that are non-vertical in regard to the global coordinate system (Profile direction equals global Z is Roll = 0.)"
+                "description": "Rotation against the longitudinal axis - relative to the global Z direction for all beams that are non-vertical in regard to the global coordinate system (Profile direction equals global Z is Roll = 0.) The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only. Note: new property in IFC4"
            },
            "Slope": {
-                "description": "Slope angle - relative to horizontal (0.0 degrees)."
+                "description": "Slope angle - relative to horizontal (0.0 degrees). The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only."
            },
            "Span": {
-                "description": "Clear span for this object."
+                "description": "Clear span for this object. The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only."
            },
            "Status": {
                "description": "Status of the element, predominately used in renovation or retrofitting projects. The status can be assigned to as \"New\" - element designed as new addition, \"Existing\" - element exists and remains, \"Demolish\" - element existed but is to be demolished, \"Temporary\" - element will exists only temporary (like a temporary support structure)."
            },
            "ThermalTransmittance": {
-                "description": "Thermal transmittance coefficient (U-Value) of the element. Here the total thermal transmittance coefficient through the beam within the direction of the thermal flow (including all materials)."
+                "description": "Thermal transmittance coefficient (U-Value) of the element. Here the total thermal transmittance coefficient through the beam within the direction of the thermal flow (including all materials). Note: new property in IFC4"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedbldgelements/pset/pset_beamcommon.htm"
@@ -997,7 +997,7 @@
                "description": "Status of the element, predominately used in renovation or retrofitting projects. The status can be assigned to as \"New\" - element designed as new addition, \"Existing\" - element exists and remains, \"Demolish\" - element existed but is to be demolished, \"Temporary\" - element will exists only temporary (like a temporary support structure)."
            },
            "ThermalTransmittance": {
-                "description": "Thermal transmittance coefficient (U-Value) of the element. It is the total thermal transmittance coefficient through the building element proxy within the direction of the thermal flow (including all materials)."
+                "description": "Thermal transmittance coefficient (U-Value) of the element. It is the total thermal transmittance coefficient through the building element proxy within the direction of the thermal flow (including all materials). Note: new property in IFC4"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedbldgelements/pset/pset_buildingelementproxycommon.htm"
@@ -1584,7 +1584,7 @@
                "description": "Coil face area in the direction against air the flow."
            },
            "CoilFluidArrangement": {
-                "description": "Fluid flow arrangement of the coil."
+                "description": "Fluid flow arrangement of the coil. CrossCounterFlow: Air and water flow enter in different directions. CrossFlow: Air and water flow are perpendicular. CrossParallelFlow: Air and water flow enter in same directions."
            },
            "FluidPressureRange": {
                "description": "Allowable water working pressure range inside the tube."
@@ -1629,16 +1629,16 @@
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1'), Also referred to as \"construction type\". It should be provided as an alternative to the name of the \"object type\", if the software does not support object types."
            },
            "Roll": {
-                "description": "Rotation against the longitudinal axis - relative to the global  X direction for all columns that are vertical in regard to the global coordinate system (Profile direction equals global X is Roll = 0.). For all non-vertical columns the following applies:  Roll is relative to the global Z direction f(Profile direction of non-vertical columns that equals global Z is Roll = 0.)"
+                "description": "Rotation against the longitudinal axis - relative to the global X direction for all columns that are vertical in regard to the global coordinate system (Profile direction equals global X is Roll = 0.). For all non-vertical columns the following applies: Roll is relative to the global Z direction f(Profile direction of non-vertical columns that equals global Z is Roll = 0.) The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only. Note: new property in IFC4"
            },
            "Slope": {
-                "description": "Slope angle - relative to horizontal (0.0 degrees)."
+                "description": "Slope angle - relative to horizontal (0.0 degrees). The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only."
            },
            "Status": {
                "description": "Status of the element, predominately used in renovation or retrofitting projects. The status can be assigned to as \"New\" - element designed as new addition, \"Existing\" - element exists and remains, \"Demolish\" - element existed but is to be demolished, \"Temporary\" - element will exists only temporary (like a temporary support structure)."
            },
            "ThermalTransmittance": {
-                "description": "Thermal transmittance coefficient (U-Value) of the element. Here the total thermal transmittance coefficient through the column within the direction of the thermal flow (including all materials)."
+                "description": "Thermal transmittance coefficient (U-Value) of the element. Here the total thermal transmittance coefficient through the column within the direction of the thermal flow (including all materials). Nore: new property in IFC4"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedbldgelements/pset/pset_columncommon.htm"
@@ -1746,7 +1746,7 @@
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1'), provided, if there is no classification reference to a recognized classification system used."
            },
            "RefrigerantClass": {
-                "description": "Refrigerant class used by the compressor."
+                "description": "Refrigerant class used by the compressor. CFC: Chlorofluorocarbons. HCFC: Hydrochlorofluorocarbons. HFC: Hydrofluorocarbons."
            },
            "Status": {
                "description": "Status of the element, predominately used in renovation or retrofitting projects. The status can be assigned to as \"New\" - element designed as new addition, \"Existing\" - element exists and remains, \"Demolish\" - element existed but is to be demolished, \"Temporary\" - element will exists only temporary (like a temporary support structure)."
@@ -1860,7 +1860,7 @@
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1'), provided, if there is no classification reference to a recognized classification system used."
            },
            "RefrigerantClass": {
-                "description": "Refrigerant class used by the condenser."
+                "description": "Refrigerant class used by the condenser. CFC: Chlorofluorocarbons. HCFC: Hydrochlorofluorocarbons. HFC: Hydrofluorocarbons."
            },
            "Status": {}
        },
@@ -1942,7 +1942,7 @@
        "description": "Properties for signal handling for an analog controller taking disparate valued multiple inputs and creating a single valued output.",
        "properties": {
            "ControlType": {
-                "description": "The type of signal modification effected and applicable ports: "
+                "description": "The type of signal modification effected and applicable ports: CONSTANT: No inputs; SignalOffset is written to the output value. MODIFIER: Single analog input is read, added to SignalOffset, multiplied by SignalFactor, and written to the output value. ABSOLUTE: Single analog input is read and absolute value is written to the output value. INVERSE: Single analog input is read, 1.0 is divided by the input value and written to the output value. HYSTERISIS: Single analog input is read, delayed according to SignalTime, and written to the output value. RUNNINGAVERAGE: Single analog input is read, averaged over SignalTime, and written to the output value. DERIVATIVE: Single analog input is read and the rate of change during the SignalTime is written to the output value. INTEGRAL: Single analog input is read and the average value during the SignalTime is written to the output value. BINARY: Single binary input is read and SignalOffset is written to the output value if True. ACCUMULATOR: Single binary input is read, and for each pulse the SignalOffset is added to the accumulator, and while the accumulator is greater than the SignalFactor, the accumulator is decremented by SignalFactor and the integer result is incremented by one. PULSECONVERTER: Single integer input is read, and for each increment the SignalMultiplier is added and written to the output value. SUM: Two analog inputs are read, added, and written to the output value. SUBTRACT: Two analog inputs are read, subtracted, and written to the output value. PRODUCT: Two analog inputs are read, multiplied, and written to the output value. DIVIDE: Two analog inputs are read, divided, and written to the output value. AVERAGE: Two analog inputs are read and the average is written to the output value. MAXIMUM: Two analog inputs are read and the maximum is written to the output value. MINIMUM: Two analog inputs are read and the minimum is written to the output value.. INPUT: Controller element is a dedicated input. OUTPUT: Controller element is a dedicated output. VARIABLE: Controller element is an in-memory variable."
            },
            "Labels": {
                "description": "Table mapping values to labels, where such labels indicate transition points such as 'Hi', 'Lo', 'HiHi', or 'LoLo'."
@@ -1969,7 +1969,7 @@
        "description": "Properties for discrete inputs, outputs, and values within a programmable logic controller.",
        "properties": {
            "ControlType": {
-                "description": "The type of signal modification effected and applicable ports:"
+                "description": "The type of signal modification effected and applicable ports: INPUT: Controller element is a dedicated input. OUTPUT: Controller element is a dedicated output. VARIABLE: Controller element is an in-memory variable."
            },
            "Labels": {
                "description": "Table mapping values to labels, where each entry corresponds to an integer within the ValueRange."
@@ -1990,7 +1990,7 @@
                "description": "Indicates application of controller."
            },
            "ControlType": {
-                "description": "The type of discrete digital controller: "
+                "description": "The type of discrete digital controller: PRIMARY: Controller has built-in communication interface for PC connection, may manage secondary controllers. SECONDARY: Controller communicates with primary controller and its own managed devices."
            },
            "FirmwareVersion": {
                "description": "Indicates version of device firmware according to device manufacturer."
@@ -2038,7 +2038,7 @@
        "description": "Properties for signal handling for an analog controller taking disparate valued multiple inputs and creating a single valued binary output.",
        "properties": {
            "ControlType": {
-                "description": "The type of signal modification effected and applicable ports:"
+                "description": "The type of signal modification effected and applicable ports: LOWERLIMITSWITCH: Single analog input is read and if less than Value.LowerBound then True is written to the output value. UPPERLIMITSWITCH: Single analog input is read and if more than Value.UpperBound then True is written to the output value. LOWERBANDSWITCH: Single analog input is read and if less than Value.LowerBound+BandWidth then True is written to the output value. UPPERBANDSWITCH: Single analog input is read and if more than Value.UpperBound-BandWidth then True is written to the output value. NOT: Single binary input is read and the opposite value is written to the output value. AND: Two binary inputs are read and if both are True then True is written to the output value. OR: Two binary inputs are read and if either is True then True is written to the output value. XOR: Two binary inputs are read and if one is true then True is written to the output value. CALENDAR: No inputs; the current time is compared with an IfcWorkCalendar to which the IfcController is assigned and True is written if active. INPUT: Controller element is a dedicated input. OUTPUT: Controller element is a dedicated output. VARIABLE: Controller element is an in-memory variable."
            },
            "Labels": {
                "description": "Table mapping values to labels, where such labels indicate the meanings of True and False, such as 'Open' and 'Closed'"
@@ -2371,7 +2371,7 @@
        "description": "Damper occurrence attributes attached to an instance of IfcDamper",
        "properties": {
            "SizingMethod": {
-                "description": "Identifies whether the damper is sized nominally or with exact measurements:"
+                "description": "Identifies whether the damper is sized nominally or with exact measurements: NOMINAL: Nominal sizing method. EXACT: Exact sizing method."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_damperoccurrence.htm"
@@ -3019,10 +3019,10 @@
                "description": "The physical connection gender."
            },
            "ConnectionSubtype": {
-                "description": "The physical port connection subtype that further qualifies the ConnectionType. The following values are recommended:"
+                "description": "The physical port connection subtype that further qualifies the ConnectionType. The following values are recommended: - ACPLUG: A, B, C, D, E, F, EF, G, H, I, J, K, L, M - DIN: Mini3P, Mini4P, Mini5P, Mini6P, Mini7P, Mini8P, Mini9P - DSub: DA15, DB25, DC37, DD50, DE9, DE15 - EIAJ: RC5720 - HDMI: A, B, C - RADIO: IEEE802.11g, IEEE802.11n - RJ: 4P4C, 6P2C, 8P8C - SOCKET: E-11, E-12, E-14, E-17, E-26, E-27, E-39, E-40 - TRS: TS_Mini, TS_SubMini, TRS_Mini, TRS_SubMini"
            },
            "ConnectionType": {
-                "description": "The physical port connection:"
+                "description": "The physical port connection: ACPLUG: AC plug DCPLUG: DC plug CRIMP: bare wire"
            },
            "Current": {
                "description": "The actual current and operable range."
@@ -3049,7 +3049,7 @@
                "description": "The physical port connection subtype that further qualifies the ConnectionType."
            },
            "ConnectionType": {
-                "description": "The end-style treatment of the duct port:"
+                "description": "The end-style treatment of the duct port: BEADEDSLEEVE: Beaded Sleeve. COMPRESSION: Compression. CRIMP: Crimp. DRAWBAND: Drawband. DRIVESLIP: Drive slip. FLANGED: Flanged. OUTSIDESLEEVE: Outside Sleeve. SLIPON: Slipon. SOLDERED: Soldered. SSLIP: S-Slip. STANDINGSEAM: Standing seam. SWEDGE: Swedge. WELDED: Welded. OTHER: Another type of end-style has been applied. NONE: No end-style has been applied."
            },
            "DryBulbTemperature": {
                "description": "Dry bulb temperature of the air."
@@ -3085,7 +3085,7 @@
                "description": "The physical port connection subtype that further qualifies the ConnectionType."
            },
            "ConnectionType": {
-                "description": "The end-style treatment of the pipe port:"
+                "description": "The end-style treatment of the pipe port: BRAZED: Brazed. COMPRESSION: Compression. FLANGED: Flanged. GROOVED: Grooved. OUTSIDESLEEVE: Outside Sleeve. SOLDERED: Soldered. SWEDGE: Swedge. THREADED: Threaded. WELDED: Welded. OTHER: Another type of end-style has been applied. NONE: No end-style has been applied. USERDEFINED: User-defined port connection type. NOTDEFINED: Undefined port connection type."
            },
            "FlowCondition": {
                "description": "Defines the flow condition as a percentage of the cross-sectional area."
@@ -3136,7 +3136,7 @@
                "description": "Designates the voltage range of the circuit, according to IEC. HIGHVOLTAGE indicates >1000V AC or >1500V DV; LOWVOLTAGE indicates 50-1000V AC or 120-1500V DC; EXTRALOWVOLTAGE indicates <50V AC or <120V DC."
            },
            "ElectricalSystemType": {
-                "description": "For certain purposes of electrical regulations, IEC 60364 defines types of system using type identifiers. Assignment of identifiers depends upon the relationship of the source, and of exposed conductive parts of the installation, to Ground (Earth).   Identifiers that may be assigned through IEC 60364 are: "
+                "description": "For certain purposes of electrical regulations, IEC 60364 defines types of system using type identifiers. Assignment of identifiers depends upon the relationship of the source, and of exposed conductive parts of the installation, to Ground (Earth). Identifiers that may be assigned through IEC 60364 are: \u2022TN type system, a system having one or more points of the source of energy directly earthed, the exposed conductive parts of the installation being connected to that point by protective conductors, \u2022TN C type system, a TN type system in which neutral and protective functions are combined in a single conductor throughout the system, \u2022TN S type system, a TN type system having separate neutral and protective conductors throughout the system, \u2022TN C S type system, a TN type system in which neutral and protective functions are combined in a single conductor in part of the system, \u2022TT type system, a system having one point of the source of energy directly earthed, the exposed conductive parts of the installation being connected to earth electrodes electrically independent of the earth electrodes of the source, \u2022IT type system, a system having no direct connection between live parts and Earth, the exposed conductive parts of the electrical installation being earthed."
            },
            "MaximumAllowedVoltageDrop": {
                "description": "The maximum voltage drop across the circuit that must not be exceeded. There are two voltage drop limit settings that may be applied; one for sub-main circuits, and one in each Distribution Board or Consumer Unit for final circuits connected to that board. The settings should limit the overall voltage drop to the required level. Default settings of 1.5% for sub-main circuits and 2.5% for final circuits, giving an overall limit of 4% may be applied. NOTE: This value may also be specified as a constraint within an IFC model if required but is included within the property set at this stage pending implementation of the required capabilities within software applications."
@@ -3319,7 +3319,7 @@
        "description": "Duct fitting occurrence attributes.",
        "properties": {
            "Color": {
-                "description": "The color of the duct segment."
+                "description": "The color of the duct segment. Note: This is typically used for any duct segments with a painted surface which is not otherwise specified as a covering."
            },
            "HasLiner": {
                "description": "TRUE if the fitting has interior duct insulating lining, FALSE if it does not."
@@ -3370,7 +3370,7 @@
        "description": "Duct segment occurrence attributes attached to an instance of IfcDuctSegment.",
        "properties": {
            "Color": {
-                "description": "The color of the duct segment."
+                "description": "The color of the duct segment. Note: This is typically used for any duct segments with a painted surface which is not otherwise specified as a covering."
            },
            "HasLiner": {
                "description": "TRUE if the fitting has interior duct insulating lining, FALSE if it does not."
@@ -3941,7 +3941,7 @@
                "description": "Total heat transfer effectiveness curve as a function of the primary air flow rate."
            },
            "FlowArrangement": {
-                "description": "CounterFlow: Air and water flow enter in different directions."
+                "description": "CounterFlow: Air and water flow enter in different directions. CrossFlow: Air and water flow are perpendicular. ParallelFlow: Air and water flow enter in same directions."
            },
            "HeatExchangeArea": {
                "description": "Heat exchange area."
@@ -4046,13 +4046,13 @@
        "description": "Centrifugal fan occurrence attributes attached to an instance of IfcFan.",
        "properties": {
            "Arrangement": {
-                "description": "Defines the fan and motor drive arrangement as defined by AMCA."
+                "description": "Defines the fan and motor drive arrangement as defined by AMCA. ARRANGEMENT1: Arrangement 1. ARRANGEMENT2: Arrangement 2. ARRANGEMENT3: Arrangement 3. ARRANGEMENT4: Arrangement 4. ARRANGEMENT7: Arrangement 7. ARRANGEMENT8: Arrangement 8. ARRANGEMENT9: Arrangement 9. ARRANGEMENT10: Arrangement 10. OTHER: Other type of fan drive arrangement."
            },
            "DirectionOfRotation": {
-                "description": "The direction of the centrifugal fan wheel rotation when viewed from the drive side of the fan."
+                "description": "The direction of the centrifugal fan wheel rotation when viewed from the drive side of the fan. CLOCKWISE: Clockwise. COUNTERCLOCKWISE: Counter-clockwise. OTHER: Other type of fan rotation."
            },
            "DischargePosition": {
-                "description": "Centrifugal fan discharge position."
+                "description": "Centrifugal fan discharge position. TOPHORIZONTAL: Top horizontal discharge. TOPANGULARDOWN: Top angular down discharge. DOWNBLAST: Downblast discharge. BOTTOMANGULARDOWN: Bottom angular down discharge. BOTTOMHORIZONTAL: Bottom horizontal discharge. BOTTOMANGULARUP: Bottom angular up discharge. UPBLAST: Upblast discharge. TOPANGULARUP: Top angular up discharge. OTHER: Other type of fan arrangement."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_fancentrifugal.htm"
@@ -4061,13 +4061,13 @@
        "description": "Fan occurrence attributes attached to an instance of IfcFan.",
        "properties": {
            "ApplicationOfFan": {
-                "description": "The functional application of the fan."
+                "description": "The functional application of the fan. SupplyAir: Supply air fan. ReturnAir: Return air fan. ExhaustAir: Exhaust air fan. Other: Other type of application not defined above."
            },
            "CoilPosition": {
-                "description": "Defines the relationship between a fan and a coil."
+                "description": "Defines the relationship between a fan and a coil. DrawThrough: Fan located downstream of the coil. BlowThrough: Fan located upstream of the coil."
            },
            "DischargeType": {
-                "description": "Defines the type of connection at the fan discharge."
+                "description": "Defines the type of connection at the fan discharge. Duct: Discharge into ductwork. Screen: Discharge into screen outlet. Louver: Discharge into a louver. Damper: Discharge into a damper."
            },
            "FanMountingType": {
                "description": "Defines the method of mounting the fan in the building."
@@ -4079,7 +4079,7 @@
                "description": "Diameter of fan wheel - used to scale performance of geometrically similar fans."
            },
            "MotorPosition": {
-                "description": "Defines the location of the motor relative to the air stream."
+                "description": "Defines the location of the motor relative to the air stream. InAirStream: Fan motor is in the air stream. OutOfAirStream: Fan motor is out of the air stream."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_fanoccurrence.htm"
@@ -4235,7 +4235,7 @@
        "description": "Air particle filter type attributes.",
        "properties": {
            "AirParticleFilterType": {
-                "description": "A panel dry type extended surface filter is a dry-type air filter with random fiber mats or blankets in the forms of pockets, V-shaped or radial pleats, and include the following:"
+                "description": "A panel dry type extended surface filter is a dry-type air filter with random fiber mats or blankets in the forms of pockets, V-shaped or radial pleats, and include the following: CoarseFilter: Filter with a efficiency lower than 30% for atmosphere dust-spot. CoarseMetalScreen: Filter made of metal screen. CoarseCellFoams: Filter made of cell foams. CoarseSpunGlass: Filter made of spun glass. MediumFilter: Filter with an efficiency between 30-98% for atmosphere dust-spot. MediumElectretFilter: Filter with fine electret synthetic fibers. MediumNaturalFiberFilter: Filter with natural fibers. HEPAFilter: High efficiency particulate air filter. ULPAFilter: Ultra low penetration air filter. MembraneFilters: Filter made of membrane for certain pore diameters in flat sheet and pleated form. A renewable media with a moving curtain viscous filter are random-fiber media coated with viscous substance in roll form or curtain where fresh media is fed across the face of the filter and the dirty media is rewound onto a roll at the bottom or to into a reservoir: RollForm: Viscous filter used in roll form. AdhesiveReservoir: Viscous filter used in moving curtain form. A renewable moving curtain dry media filter is a random-fiber dry media of relatively high porosity used in moving-curtain(roll) filters. An electrical filter uses electrostatic precipitation to remove and collect particulate contaminants."
            },
            "CountedEfficiencyCurve": {
                "description": "Counted efficiency curve as a function of dust holding weight, efficiency = f (dust holding weight)."
@@ -4379,19 +4379,19 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_firesuppressionterminaltypecommon.htm"
    },
    "Pset_FireSuppressionTerminalTypeFireHydrant": {
-        "description": "Device, fitted to a pipe, through which a temporary supply of water may be provided (BS6100 330 6107)",
+        "description": "Device, fitted to a pipe, through which a temporary supply of water may be provided (BS6100 330 6107) For further details on fire hydrants, see www.firehydrant.org",
        "properties": {
            "BodyColor": {
-                "description": "Color of the body of the hydrant."
+                "description": "Color of the body of the hydrant. Note: Consult local fire regulations for statutory colors that may be required for hydrant bodies in particular circumstances."
            },
            "CapColor": {
-                "description": "Color of the caps of the hydrant."
+                "description": "Color of the caps of the hydrant. Note: Consult local fire regulations for statutory colors that may be required for hydrant caps in particular circumstances."
            },
            "DischargeFlowRate": {
                "description": "The volumetric rate of fluid discharge."
            },
            "FireHydrantType": {
-                "description": "Defines the range of hydrant types from which the required type can be selected where."
+                "description": "Defines the range of hydrant types from which the required type can be selected where. DryBarrel: A hydrant that has isolating valves fitted below ground and that may be used where the possibility of water freezing is a consideration. WetBarrel: A hydrant that has isolating valves fitted above ground and that may be used where there is no possibility of water freezing."
            },
            "FlowClass": {
                "description": "Alphanumeric indication of the flow class of a hydrant (may be used in connection with or instead of the FlowRate property)."
@@ -4415,7 +4415,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_firesuppressionterminaltypefirehydrant.htm"
    },
    "Pset_FireSuppressionTerminalTypeHoseReel": {
-        "description": "A supporting framework on which a hose may be wound (BS6100 155 8201).",
+        "description": "A supporting framework on which a hose may be wound (BS6100 155 8201). Note that the service provided by the hose (water/foam) is determined by the context of the system onto which the hose reel is connected.",
        "properties": {
            "ClassOfService": {
                "description": "A classification of usage of the hose reel that may be applied."
@@ -4720,7 +4720,7 @@
        "description": "Heat exchanger type common attributes.",
        "properties": {
            "Arrangement": {
-                "description": "Defines the basic flow arrangements for the heat exchanger:"
+                "description": "Defines the basic flow arrangements for the heat exchanger: COUNTERFLOW: Counterflow heat exchanger arrangement. CROSSFLOW: Crossflow heat exchanger arrangement. PARALLELFLOW: Parallel flow heat exchanger arrangement. MULTIPASS: Multipass flow heat exchanger arrangement. OTHER: Other type of heat exchanger flow arrangement not defined above."
            },
            "Reference": {
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1')."
@@ -4759,7 +4759,7 @@
                "description": "Air pressure drop versus air-flow rate."
            },
            "Application": {
-                "description": "Humidifier application."
+                "description": "Humidifier application. Fixed: Humidifier installed in a ducted flow distribution system. Portable: Humidifier is not installed in a ducted flow distribution system."
            },
            "InternalControl": {
                "description": "Internal modulation control."
@@ -4912,7 +4912,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcproductextension/pset/pset_landregistration.htm"
    },
    "Pset_LightFixtureTypeCommon": {
-        "description": "Common data for light fixtures. History: IFC4 - Article number and manufacturer specific information deleted. Use Pset_ManufacturerTypeInformation. ArticleNumber instead.   Load properties moved from Pset_LightFixtureTypeThermal (deleted).",
+        "description": "Common data for light fixtures.",
        "properties": {
            "LightFixtureMountingType": {
                "description": "A list of the available types of mounting for light fixtures from which that required may be selected."
@@ -5302,7 +5302,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcmaterialresource/pset/pset_materialwood.htm"
    },
    "Pset_MaterialWoodBasedBeam": {
-        "description": "This is a collection of mechanical properties applicable to wood-based materials for beam-like products, especially laminated materials like glulam and LVL. Anisotropy of such materials is taken into account by different properties according to grain direction and load types.",
+        "description": "This is a collection of mechanical properties applicable to wood-based materials for beam-like products, especially laminated materials like glulam and LVL. Anisotropy of such materials is taken into account by different properties according to grain direction and load types. All values shall be given for a standardized service condition, a standardized load duration and a standardized reference size of the member according to local design codes. NOTE: In cases where mechanical material properties are graduated for different given reference sizes, separate instances of IfcExtendedMaterialProperties and IfcMaterial have to be used for each required graduation. Mechanically differing versions of a material are treated as different materials. References to the orientation of grain or lay-up correspond to material orientation given by geometrical or topological representation of element objects or types, especially IfcMemberType and IfcStructuralMember.",
        "properties": {
            "ApplicableStructuralDesignMethod": {
                "description": "Determines whether mechanical material properties are applicable to 'ASD' = allowable stress design (working stress design), 'LSD' = limit state design, or 'LRFD' = load and resistance factor design."
@@ -5794,7 +5794,7 @@
                "description": "Special requirements for material used to contain an artefact."
            },
            "PackingCareType": {
-                "description": "Identifies the predefined types of care that may be required when handling the artefact during a move where:"
+                "description": "Identifies the predefined types of care that may be required when handling the artefact during a move where: Fragile: artefact may be broken during a move through careless handling. HandleWithCare: artefact may be damaged during a move through careless handling."
            },
            "SpecialInstructions": {
                "description": "Special instructions for packing."
@@ -5812,10 +5812,10 @@
                "description": "Date and time at which the permit ceases to be valid."
            },
            "EscortRequirement": {
-                "description": "Indicates whether or not an escort is required to accompany persons carrying out a work order at or to/from the place of work (= TRUE) or not (= FALSE)."
+                "description": "Indicates whether or not an escort is required to accompany persons carrying out a work order at or to/from the place of work (= TRUE) or not (= FALSE). NOTE - There are many instances where escorting is required, particularly in a facility that has a high security rating. Escorting may require that persons are escorted to and from the place of work. Alternatively, it may involve the escort remaining at the place of work at all times."
            },
            "SpecialRequirements": {
-                "description": "Any additional special requirements that need to be included in the permit to work."
+                "description": "Any additional special requirements that need to be included in the permit to work. NOTE - Additional permit requirements may be imposed according to the nature of the facility at which the work is carried out. For instance, in clean areas, special clothing may be required whilst in corrective institutions, it may be necessary to check in and check out tools that will be used for work as a safety precaution."
            },
            "StartDate": {
                "description": "Date and time from which the permit becomes valid."
@@ -5870,7 +5870,7 @@
        "description": "Pipe segment occurrence attributes attached to an instance of IfcPipeSegment.",
        "properties": {
            "Color": {
-                "description": "The color of the pipe segment."
+                "description": "The color of the pipe segment. Note: This is typically used only for plastic pipe segments. However, it may be used for any pipe segments with a painted surface which is not otherwise specified as a covering."
            },
            "InteriorRoughnessCoefficient": {
                "description": "The interior roughness coefficient of the pipe segment."
@@ -5951,7 +5951,7 @@
        "description": "Pipe segment occurrence attributes attached to an instance of IfcPipeSegment.",
        "properties": {
            "Color": {
-                "description": "The color of the pipe segment."
+                "description": "The color of the pipe segment. Note: This is typically used only for plastic pipe segments. However, it may be used for any pipe segments with a painted surface which is not otherwise specified as a covering."
            },
            "Gradient": {
                "description": "The gradient of the pipe segment."
@@ -6233,7 +6233,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcprofileresource/pset/pset_profilearbitrarydoublet.htm"
    },
    "Pset_ProfileArbitraryHollowCore": {
-        "description": "This is a collection of geometric properties of hollow core section profiles of precast concrete elements, to be used in conjunction with IfcArbitraryProfileDefWithVoids when profile designation alone does not fulfill the information requirements.",
+        "description": "This is a collection of geometric properties of hollow core section profiles of precast concrete elements, to be used in conjunction with IfcArbitraryProfileDefWithVoids when profile designation alone does not fulfill the information requirements. In all cases, the cores are symmetrically distributed on either side of the plank center line, irrespective of whether the number of cores is odd or even. For planks with a center core with different geometry to that of the other cores, provide the property CenterCoreSpacing. When the number of cores is even, no Center Core properties shall be asserted. Key chamfers and draft chamfer are all 45 degree chamfers. The CoreTopRadius and CoreBaseRadius parameters can be derived and are therefore not listed in the property set. They are shown to define that the curves are arcs. The parameters for the center core are the same as above, but with the prefix \"Center\".",
        "properties": {
            "BaseChamfer": {
                "description": "Base chamfer of the profile."
@@ -6407,16 +6407,16 @@
                "description": "The contractual type of the work."
            },
            "FaultPriorityType": {
-                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where:"
+                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where: High: action is required urgently. Medium: action can occur within a reasonable period of time. Low: action can occur when convenient."
            },
            "IfNotAccomplished": {
                "description": "Comments if the job is not accomplished."
            },
            "LocationPriorityType": {
-                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where:"
+                "description": "Identifies the predefined types of priority that can be assigned from which the type may be set where: High: action is required urgently. Medium: action can occur within a reasonable period of time. Low: action can occur when convenient."
            },
            "MaintenaceType": {
-                "description": "Identifies the predefined types of maintenance that can be done from which the type that generates the maintenance work order may be set where:"
+                "description": "Identifies the predefined types of maintenance that can be done from which the type that generates the maintenance work order may be set where: ConditionBased: generated as a result of the condition of an asset or artefact being less than a determined value. Corrective: generated as a result of an immediate and urgent need for maintenance action. PlannedCorrective: generated as a result of immediate corrective action being needed but with sufficient time available for the work order to be included in maintenance planning. Scheduled: generated as a result of a fixed, periodic maintenance requirement."
            },
            "ProductDescription": {
                "description": "A textual description of the products that require the work."
@@ -6470,7 +6470,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedmgmtelements/pset/pset_projectorderworkorder.htm"
    },
    "Pset_PropertyAgreement": {
-        "description": "A property agreement is an agreement that enables the occupation of a property for a period of time.",
+        "description": "A property agreement is an agreement that enables the occupation of a property for a period of time. The objective is to capture the information within an agreement that is relevant to a facilities manager. Design and construction information associated with the property is not considered. A property agreement may be applied to an instance of IfcSpatialStructureElement including to compositions defined through the IfcSpatialStructureElement.Element.CompositionEnum. Note that the associated actors are captured by the IfcOccupant class.",
        "properties": {
            "AgreementType": {
                "description": "Identifies the predefined types of property agreement from which the type required may be set."
@@ -6515,7 +6515,7 @@
        "description": "A coherent set of attributes representing a curve for let-through energy of a protective device. Note - A protective device may be associated with different instances of this pSet providing information related to different basic characteristics",
        "properties": {
            "BreakerUnitCurve": {
-                "description": "A curve that establishes the let through energy of a breaker unit when a particular prospective current is applied.  Note that the breaker unit curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set:"
+                "description": "A curve that establishes the let through energy of a breaker unit when a particular prospective current is applied. Note that the breaker unit curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set: (1) Defining value: ProspectiveCurrent: A list of minimum 2 and maximum 16 numbers providing the currents in [A] for points in the current/I2t log/log coordinate space. The curve is drawn as a straight line between two consecutive points. (2) Defined value: LetThroughEnergy: A list of minimum 2 and maximum 16 numbers providing the let-through energy, I2t, in [A2s] for points in the current/I2t log/log coordinate space. The curve is drawn as a straight line between two consecutive points."
            },
            "NominalCurrent": {
                "description": "A set of nominal currents in [A] for which the data of this instance is valid. At least one value shall be provided. Any value in the set shall not exceed the value of the UltimateRatedCurrent associated with the same breaker unit."
@@ -6530,10 +6530,10 @@
        "description": "A coherent set of attributes representing curves for melting- and breaking-energy of a fuse. Note - A fuse may be associated with different instances of this property set providing information related to different basic characteristics.",
        "properties": {
            "BreakerUnitFuseBreakingingCurve": {
-                "description": "A curve that establishes the let through breaking energy of a breaker unit when a particular prospective breaking current is applied.  Note that the breaker unit fuse breaking curve is defined within a Cartesian coordinate system and this fact must be:"
+                "description": "A curve that establishes the let through breaking energy of a breaker unit when a particular prospective breaking current is applied. Note that the breaker unit fuse breaking curve is defined within a Cartesian coordinate system and this fact must be: (1) Defining value: ProspectiveCurrentBreaking: A list of minimum 2 and maximum 8 numbers providing the currents in [A] for points in the current/breaking energy log/log coordinate space. The curve is drawn as a straight line between two consecutive points. (2) Defined value: LetThroughBreakingEnergy: A list of minimum 2 and maximum 8 numbers providing the breaking energy whereby the fuse has provided a break, I2t, in [A2s] for points in the current/breakting_energy log/log coordinate space. The curve is drawn as a straight line between two consecutive."
            },
            "BreakerUnitFuseMeltingCurve": {
-                "description": "A curve that establishes the energy required to melt the fuse of a breaker unit when a particular prospective melting current is applied.  Note that the breaker unit fuse melting curve is defined within a Cartesian coordinate system and this fact must be:"
+                "description": "A curve that establishes the energy required to melt the fuse of a breaker unit when a particular prospective melting current is applied. Note that the breaker unit fuse melting curve is defined within a Cartesian coordinate system and this fact must be: (1) Defining value: ProspectiveCurrentMelting :A list of minimum 2 and maximum 8 numbers providing the currents in [A] for points in the current/melting_energy log/log coordinate space. The curve is drawn as a straight line between two consecutive points. (2) Defined value: MeltingEnergy: A list of minimum 2 and maximum 8 numbers providing the energy whereby the fuse is starting to melt, I2t, in [A2s] for points in the current/melting_energy log/log coordinate space. The curve is drawn as a straight line between two consecutive points."
            },
            "VoltageLevel": {
                "description": "The voltage levels of the fuse for which the data of the instance is valid. More than one value may be selected in the enumeration."
@@ -6545,7 +6545,7 @@
        "description": "A coherent set of attributes representing curves for let-through currents of a protective device. Note - A protective device may be associated with different instances of this pSet providing information related to different basic characteristics.",
        "properties": {
            "BreakerUnitIPICurve": {
-                "description": "A curve that establishes the let through peak current of a breaker unit when a particular prospective current is applied.  Note that the breaker unit IPI curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set:"
+                "description": "A curve that establishes the let through peak current of a breaker unit when a particular prospective current is applied. Note that the breaker unit IPI curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set: (1) Defining value: A list of minimum 2 and maximum 16 numbers providing the currents in [A] for points in the I/\u00ce log/log coordinate space. The curve is drawn as a straight line between two consecutive points. (2) Defined value: A list of minimum 2 and maximum 16 numbers providing the let-through peak currents, \u00ce, in [A] for points in the I/\u00ce log/log coordinate space. The curve is drawn as a straight line between two consecutive points."
            },
            "NominalCurrent": {
                "description": "A set of nominal currents in [A] for which the data of this instance is valid. At least one value shall be provided. Any value in the set shall not exceed the value of the UltimateRatedCurrent associated with the same breaker unit."
@@ -6659,7 +6659,7 @@
        "description": "Tripping curves are applied to thermal, thermal magnetic or MCB_RCD tripping units (i.e. tripping units having type property sets for thermal, thermal magnetic or MCB_RCD tripping defined). They are not applied to electronic tripping units.",
        "properties": {
            "TrippingCurve": {
-                "description": "A curve that establishes the release time of a tripping unit when a particular prospective current is applied.  Note that the tripping curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set: "
+                "description": "A curve that establishes the release time of a tripping unit when a particular prospective current is applied. Note that the tripping curve is defined within a Cartesian coordinate system and this fact must be asserted within the property set: (1) Defining value is the Prospective Current which is a list of minimum 2 and maximum 16 numbers providing the currents in [x In] for points in the current/time log/log coordinate space. The curve is drawn as a straight line between two consecutive points. (2) Defined value is a list of minimum 2 and maximum 16 numbers providing the release_time in [s] for points in the current/time log/log coordinate space. The curve is drawn as a straight line between two consecutive points. Note that a defined interpolation."
            },
            "TrippingCurveType": {
                "description": "The type of tripping curve that is represented by the property set."
@@ -7073,7 +7073,7 @@
        "description": "An earth failure device acts to protect people and equipment from the effects of current leakage.",
        "properties": {
            "EarthFailureDeviceType": {
-                "description": "A list of the available types of circuit breaker from which that required may be selected where:"
+                "description": "A list of the available types of circuit breaker from which that required may be selected where: Standard: Device that operates without a time delay. TimeDelayed: Device that operates after a time delay."
            },
            "Sensitivity": {
                "description": "The rated rms value of the vector sum of the instantaneous currents flowing in the main circuits of the device which causes the device to operate under specified conditions. (IEC 61008-1)."
@@ -7085,7 +7085,7 @@
        "description": "A coherent set of attributes representing the breakeing capacity of a fuse, defined in accordance with IEC 60269. Note - A protective device may be associated with different instances of this pSet providing information related to different basic characteristics.",
        "properties": {
            "FuseDisconnectorType": {
-                "description": "A list of the available types of fuse disconnector from which that required may be selected where:"
+                "description": "A list of the available types of fuse disconnector from which that required may be selected where: EngineProtectionDevice: A fuse whose characteristic is specifically designed for the protection of a motor or generator. FuseSwitchDisconnector: A switch disconnector in which a fuse link or a fuse carrier with fuse link forms the moving contact, HRC: A standard fuse (High Rupturing Capacity) OverloadProtectionDevice: A device that disconnects the supply when the operating conditions in an electrically undamaged circuit causes an overcurrent, SemiconductorFuse: A fuse whose characteristic is specifically designed for the protection of sem-conductor devices. SwitchDisconnectorFuse: A switch disconnector in which one or more poles have a fuse in series in a composite unit."
            },
            "IC60269": {
                "description": "The breaking capacity in [A] for fuses in accordance with the IEC 60269 series."
@@ -7130,10 +7130,10 @@
        "description": "Pump occurrence attributes attached to an instance of IfcPump.",
        "properties": {
            "BaseType": {
-                "description": "Defines general types of pump bases."
+                "description": "Defines general types of pump bases. FRAME: Frame. BASE: Base. NONE: There is no pump base, such as an inline pump. OTHER: Other type of pump base."
            },
            "DriveConnectionType": {
-                "description": "The way the pump drive mechanism is connected to the pump."
+                "description": "The way the pump drive mechanism is connected to the pump. DIRECTDRIVE: Direct drive. BELTDRIVE: Belt drive. COUPLING: Coupling. OTHER: Other type of drive connection."
            },
            "ImpellerDiameter": {
                "description": "Diameter of pump impeller - used to scale performance of geometrically similar pumps."
@@ -7501,13 +7501,13 @@
        "description": "An indication of exposure to mischance, peril, menace, hazard or loss.",
        "properties": {
            "AffectsSurroundings": {
-                "description": "Indicates wether the risk affects only to the person assigned to that task (FALSE) or if it can also affect to the people in the surroundings (TRUE)."
+                "description": "Indicates wether the risk affects only to the person assigned to that task (FALSE) or if it can also affect to the people in the surroundings (TRUE). For example, the process of painting would affect all the people in the vicinity of the process."
            },
            "AssessmentOfRisk": {
-                "description": "Likelihood of risk event occurring."
+                "description": "Likelihood of risk event occurring. Note that assessment of risk may frequently be associated with the physical location of the object for which the risk is assessed."
            },
            "NatureOfRisk": {
-                "description": "An indication of the generic nature of the risk that might be encountered. "
+                "description": "An indication of the generic nature of the risk that might be encountered. NOTE: It is anticipated that there will be a local agreement that constrains the values that might be assigned to this property. An example might be 'Fall' or 'Fall of grille unit' causing injury and damage to person and property."
            },
            "PreventiveMeassures": {
                "description": "Identifies preventive measures to be taken to mitigate risk."
@@ -7528,7 +7528,7 @@
                "description": "Identifies the predefined types of risk from which the type required may be set."
            },
            "SubNatureOfRisk1": {
-                "description": "A first subsidiary value that might be assigned to designate a more specific type of risk."
+                "description": "A first subsidiary value that might be assigned to designate a more specific type of risk. NOTE: Nature of risk may be identified in various ways depending upon the place where risk assessment takes place and according to local agreement. This property set allows for a generic nature of risk and up to two subsidiary natures. An example might be 'causing injury and damage'."
            },
            "SubNatureOfRisk2": {
                "description": "A second subsidiary value that might be assigned to designate a more specific type of risk. An example might be 'o person and property'."
@@ -7583,7 +7583,7 @@
                "description": "The size of the drain outlet connection from the object."
            },
            "Mounting": {
-                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:-"
+                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:- BackToWall: A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections . Pedestal: A floor mounted sanitary terminal that has an integral base . CounterTop: A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung: A sanitary terminal cantilevered clear of the floor. Note that BackToWall, Pedestal and WallHung are allowable values for a bidet."
            },
            "SpilloverLevel": {
                "description": "The level at which water spills out of the object."
@@ -7604,7 +7604,7 @@
                "description": "The minimum and maximum volume of water used at each flush. Where a single flush is used, the value of upper bound and lower bound should be equal. For a dual flush toilet, the lower bound should be used for the lesser flush rate and the upper bound for the greater flush rate. Where flush is achieved using mains pressure water through a flush valve, the value of upper and lower bound should be equal and should be the same as the flush rate property of the flush valve (see relevant valve property set). Alternatively, in this case, do not assert the flush rate property; refer to the flush rate of the flush valve."
            },
            "FlushType": {
-                "description": "The property enumeration Pset_FlushTypeEnum defines the types of flushing mechanism that may be specified for cisterns and sanitary terminals where:-"
+                "description": "The property enumeration Pset_FlushTypeEnum defines the types of flushing mechanism that may be specified for cisterns and sanitary terminals where:- Lever: Flushing is achieved by twisting a lever that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Pull: Flushing is achieved by pulling a handle or knob vertically upwards that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Push: Flushing is achieved by pushing a button or plate that causes a predetermined flow of water to be passed from a cistern to the sanitary terminal. Sensor: Flush is activated through an automatic sensing mechanism."
            },
            "IsAutomaticFlush": {
                "description": "Boolean value that determines if the cistern is flushed automatically either after each use or periodically (TRUE) or whether manual flushing is required (FALSE)."
@@ -7644,10 +7644,10 @@
                "description": "The size of the drain outlet connection from the object."
            },
            "FountainType": {
-                "description": "Selection of the type of fountain from the enumerated list of types where:-"
+                "description": "Selection of the type of fountain from the enumerated list of types where:- DrinkingWater: Sanitary appliance that provides a low pressure jet of drinking water. Eyewash: Waste water appliance, usually installed in work places where there is a risk of injury to eyes by solid particles or dangerous liquids, with which the user can wash the eyes without touching them."
            },
            "Mounting": {
-                "description": "Selection of the form of mounting of the fountain from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting of the fountain from the enumerated list of mountings where:- BackToWall: A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections. Pedestal: A floor mounted sanitary terminal that has an integral base . CounterTop: A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung: A sanitary terminal cantilevered clear of the floor."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypesanitaryfountain.htm"
@@ -7665,7 +7665,7 @@
                "description": "A description of the shower head(s) that emit the spray of water."
            },
            "ShowerType": {
-                "description": "Selection of the type of shower from the enumerated list of types where:-"
+                "description": "Selection of the type of shower from the enumerated list of types where:- Drench: Shower that rapidly gives a thorough soaking in an emergency. Individual: Shower unit that is typically enclosed and is for the use of one person at a time. Tunnel: Shower that has a succession of shower heads or spreaders that operate simultaneously along its length."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypeshower.htm"
@@ -7680,13 +7680,13 @@
                "description": "The size of the drain outlet connection from the object."
            },
            "Mounting": {
-                "description": "Selection of the form of mounting of the sink from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting of the sink from the enumerated list of mountings where:- BackToWall: A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections. Pedestal: A floor mounted sanitary terminal that has an integral base. CounterTop: A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung: A sanitary terminal cantilevered clear of the floor."
            },
            "MountingOffset": {
                "description": "For cunter top maounted sinks, the vertical offset between the top of the sink and the counter top."
            },
            "SinkType": {
-                "description": "Selection of the type of sink from the enumerated list of types where:-"
+                "description": "Selection of the type of sink from the enumerated list of types where:- Belfast: Deep sink that has a plain edge and a weir overflow . Bucket: Sink at low level, with protected front edge, that facilitates filling and emptying buckets, usually with a hinged grid on which to stand them. Cleaners: Sink, usually fixed at normal height (900mm), with protected front edge. Combination_Left: Sink with integral drainer on left hand side . Combination_Right: Sink with integral drainer on right hand side . Combination_Double: Sink with integral drainer on both sides . Drip: Small sink that catches drips or flow from a faucet . Laboratory: Sink, of acid resisting material, with a top edge shaped to facilitate fixing to the underside of a desktop . London: Deep sink that has a plain edge and no overflow . Plaster: Sink with sediment receiver to prevent waste plaster passing into drains . Pot: Large metal sink, with a standing waste, for washing cooking utensils . Rinsing: Metal sink in which water can be heated and culinary utensils and tableware immersed at high temperature that destroys most harmful bacteria and allows subsequent self drying. . Shelf: Ceramic sink with an integral back shelf through which water fittings are mounted . VegetablePreparation: Large metal sink, with a standing waste, for washing and preparing vegetables ."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypesink.htm"
@@ -7695,16 +7695,16 @@
        "description": "Soil appliance for the disposal of excrement.",
        "properties": {
            "PanMounting": {
-                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:-"
+                "description": "The property enumeration Pset_SanitaryMountingEnum defines the forms of mounting or fixing of the sanitary terminal that may be specified within property sets used to define sanitary terminals (WC\u2019s, basins, sinks, etc.) where:- BackToWall: A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections. Pedestal: A floor mounted sanitary terminal that has an integral base. CounterTop: A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung: A sanitary terminal cantilevered clear of the floor."
            },
            "SpilloverLevel": {
                "description": "The level at which water spills out of the terminal."
            },
            "ToiletPanType": {
-                "description": "The property enumeration Pset_ToiletPanTypeEnum defines the types of toilet pan that may be specified within the property set Pset_Toilet:-"
+                "description": "The property enumeration Pset_ToiletPanTypeEnum defines the types of toilet pan that may be specified within the property set Pset_Toilet:- Siphonic: Toilet pan in which excrement is removed by siphonage induced by the flushing water. Squat: Toilet pan with an elongated bowl installed with its top edge at or near floor level, so that the user has to squat. WashDown: Toilet pan in which excrement is removed by the momentum of the flushing water. WashOut: A washdown toilet pan in which excrement falls first into a shallow water filled bowl."
            },
            "ToiletType": {
-                "description": "Enumeration that defines the types of toilet (water closet) arrangements that may be specified where:-"
+                "description": "Enumeration that defines the types of toilet (water closet) arrangements that may be specified where:- BedPanWasher: Enclosed soil appliance in which bedpans and urinal bottles are emptied and cleansed. Chemical: Portable receptacle or soil appliance that receives and retains excrement in either an integral or a separate container, in which it is chemically treated and from which it has to be emptied periodically. CloseCoupled: Toilet suite in which a flushing cistern is connected directly to the water closet pan. LooseCoupled: Toilet arrangement in which a flushing cistern is connected to the water closet pan through a flushing pipe. SlopHopper: Hopper shaped soil appliance with a flushing rim and outlet similar to those of a toilet pan, into which human excrement is emptied for disposal."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypetoiletpan.htm"
@@ -7713,13 +7713,13 @@
        "description": "Soil appliance that receives urine and directs it to a waste outlet (BS6100).",
        "properties": {
            "Mounting": {
-                "description": "Selection of the form of mounting from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting from the enumerated list of mountings where:- BackToWall = A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections Pedestal = A floor mounted sanitary terminal that has an integral base CounterTop = A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung = A sanitary terminal cantilevered clear of the floor . Note that BackToWall, Pedestal and WallHung are allowable values for a urinal."
            },
            "SpilloverLevel": {
                "description": "The level at which water spills out of the object."
            },
            "UrinalType": {
-                "description": "Selection of the type of urinal from the enumerated list of types where:-"
+                "description": "Selection of the type of urinal from the enumerated list of types where:- Bowl: Individual wall mounted urinal. Slab: Urinal that consists of a slab or sheet fixed to a wall and down which urinal flows into a floor channel. Stall: Floor mounted urinal that consists of an elliptically shaped sanitary stall fixed to a wall and down which urine flows into a floor channel. Trough: Wall mounted urinal of elongated rectangular shape on plan, that can be used by more than one person at a time."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypeurinal.htm"
@@ -7731,13 +7731,13 @@
                "description": "The size of the drain outlet connection from the object."
            },
            "Mounting": {
-                "description": "Selection of the form of mounting from the enumerated list of mountings where:-"
+                "description": "Selection of the form of mounting from the enumerated list of mountings where:- BackToWall: A pedestal mounted sanitary terminal that fits flush to the wall at the rear to cover its service connections. Pedestal: A floor mounted sanitary terminal that has an integral base CounterTop: A sanitary terminal that is installed into a horizontal surface that is installed into a horizontal surface. Note: When applied to a wash hand basin, the term more normally used is \u2018vanity\u2019. See also Wash Hand Basin Type specification. WallHung: A sanitary terminal cantilevered clear of the floor."
            },
            "MountingOffset": {
                "description": "For counter top mounted basins the vertical offset between the top of the sink and the counter top."
            },
            "WashHandBasinType": {
-                "description": "Defines the types of wash hand basin that may be specified where:"
+                "description": "Defines the types of wash hand basin that may be specified where: DentalCuspidor: Waste water appliance that receives and flushes away mouth washings . HandRinse: Wall mounted wash hand basin that has an overall width of 500mm or less . Hospital: Wash hand basin that has a smooth easy clean surface without tapholes or overflow slot for use where hygiene is of prime importance. Tipup: Wash hand basin mounted on pivots so that it can be emptied by tilting. Vanity: Wash hand basin for installation into a horizontal surface. Washfountain: Wash hand basin that is circular, semi-circular or polygonal on plan, at which more than one person can wash at the same time. WashingTrough: Wash hand basin of elongated rectangular shape in plan, at which more than one person can wash at the same time."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcplumbingfireprotectiondomain/pset/pset_sanitaryterminaltypewashhandbasin.htm"
@@ -8025,7 +8025,7 @@
                "description": "The average time duration between instances of failure of a product."
            },
            "ServiceLifeDuration": {
-                "description": "The length or duration of a service life.  "
+                "description": "The length or duration of a service life. The lower bound indicates pessimistic service life, the upper bound indicates optimistic service life, and the setpoint indicates the typical service life."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedfacilitieselements/pset/pset_servicelife.htm"
@@ -8157,7 +8157,7 @@
                "description": "Indicates whether the object is intended to carry loads (TRUE) or not (FALSE)."
            },
            "PitchAngle": {
-                "description": "Angle of the slab to the horizontal when used as a component for the roof (specified as 0 degrees or not asserted for cases where the slab is not used as a roof component).      "
+                "description": "Angle of the slab to the horizontal when used as a component for the roof (specified as 0 degrees or not asserted for cases where the slab is not used as a roof component). The shape information is provided in addition to the shape representation and the geometric parameters used within. In cases of inconsistency between the geometric parameters and the shape properties, provided in the attached property, the geometric parameters take precedence. For geometry editing applications, like CAD: this value should be write-only."
            },
            "Reference": {
                "description": "Reference ID for this specified type in this project (e.g. type 'A-1'), Also referred to as \"construction type\". It should be provided as an alternative to the name of the \"object type\", if the software does not support object types."
@@ -8202,7 +8202,7 @@
                "description": "A time series of sound pressure values measured in decibels at a reference pressure of 20 microPascals for the referenced octave band frequency. Each value in IfcTimeSeries.ListValues is correlated to the sound frequency at the same position within SoundFrequencies."
            },
            "SoundScale": {
-                "description": "The reference sound scale.  "
+                "description": "The reference sound scale. DBA: Decibels in an A-weighted scale DBB: Decibels in an B-weighted scale DBC: Decibels in an C-weighted scale NC: Noise criteria NR: Noise rating"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcsharedbldgserviceelements/pset/pset_soundattenuation.htm"
@@ -8244,10 +8244,10 @@
        "description": "Properties common to the definition of covering requirements of IfcSpace. Those properties define the requirements coming from a space program in early project phases and can later be used to define the room book information, if such coverings are not modeled explicitly as covering elements.",
        "properties": {
            "CeilingCovering": {
-                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp."
+                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp. The material information is provided in absence of an IfcCovering (type=CEILING) object with own shape representation and material assignment. In case of inconsistency the material assigned to IfcCovering elements takes precedence."
            },
            "CeilingCoveringThickness": {
-                "description": "Thickness of the material layer(s) for the space ceiling.  "
+                "description": "Thickness of the material layer(s) for the space ceiling. The thickness information is provided in absence of an IfcCovering (type=CEILING) object with own shape representation. In cases of inconsistency between the geometric parameters of an assigned IfcCovering and this attached property, the geometric parameters take precedence."
            },
            "ConcealedCeiling": {
                "description": "Indication whether this space is designed to have a concealed flooring space (TRUE) or not (FALSE). A concealed ceiling space is normally meant to be the space between a slab and a ceiling."
@@ -8262,28 +8262,28 @@
                "description": "Distance between the floor slab and the floor covering, often used for cables and other installations. Often referred to as raised flooring."
            },
            "FloorCovering": {
-                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp."
+                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp. The material information is provided in absence of an IfcCovering (type=FLOORING) object with own shape representation and material assignment. In case of inconsistency the material assigned to IfcCovering elements takes precedence."
            },
            "FloorCoveringThickness": {
-                "description": "Thickness of the material layer(s) for the space flooring.  "
+                "description": "Thickness of the material layer(s) for the space flooring. The thickness information is provided in absence of an IfcCovering (type=FLOORING) object with own shape representation. In cases of inconsistency between the geometric parameters of an assigned IfcCovering and this attached property, the geometric parameters take precedence."
            },
            "Molding": {
-                "description": "Label to indicate the material or construction of the molding around the space ceiling. The label is used for room book information."
+                "description": "Label to indicate the material or construction of the molding around the space ceiling. The label is used for room book information. The material information is provided in absence of an IfcCovering (type=MOLDING) object with own shape representation and material assignment. In case of inconsistency the material assigned to IfcCovering elements takes precedence."
            },
            "MoldingHeight": {
-                "description": "Height of the molding."
+                "description": "Height of the molding. The height information is provided in absence of an IfcCovering (type=MOLDING) object with own shape representation and material assignment. In case of inconsistency the height assigned to IfcCovering elements takes precedence."
            },
            "SkirtingBoard": {
-                "description": "Label to indicate the material or construction of the skirting board around the space flooring. The label is used for room book information."
+                "description": "Label to indicate the material or construction of the skirting board around the space flooring. The label is used for room book information. The material information is provided in absence of an IfcCovering (type=SKIRTINGBOARD) object with own shape representation and material assignment. In case of inconsistency the material assigned to IfcCovering elements takes precedence."
            },
            "SkirtingBoardHeight": {
-                "description": "Height of the skirting board."
+                "description": "Height of the skirting board. The height information is provided in absence of an IfcCovering (type=SKIRTINGBOARD) object with own shape representation and material assignment. In case of inconsistency the height assigned to IfcCovering elements takes precedence."
            },
            "WallCovering": {
-                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp."
+                "description": "Label to indicate the material or finish of the space flooring. The label is used for room book information and often displayed in room stamp. The material information is provided in absence of an IfcCovering (type=CLADDING) object with own shape representation and material assignment. In case of inconsistency the material assigned to IfcCovering elements takes precedence."
            },
            "WallCoveringThickness": {
-                "description": "Thickness of the material layer(s) for the space cladding.  "
+                "description": "Thickness of the material layer(s) for the space cladding. The thickness information is provided in absence of an IfcCovering (type=CLADDING) object with own shape representation. In cases of inconsistency between the geometric parameters of an assigned IfcCovering and this attached property, the geometric parameters take precedence."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcproductextension/pset/pset_spacecoveringrequirements.htm"
@@ -8894,7 +8894,7 @@
        "description": "An electrical device used to control the flow of power in a circuit on or off.",
        "properties": {
            "ContactorType": {
-                "description": "A list of the available types of contactor from which that required may be selected where:"
+                "description": "A list of the available types of contactor from which that required may be selected where: CapacitorSwitching: for switching 3 phase single or multi-step capacitor banks. LowCurrent: requires the use of low resistance contacts. MagneticLatching: enables the contactor to remain in the on position when the coil is no longer energized. MechanicalLatching: requires that the contactor is mechanically retained in the on position. Modular: are totally enclosed and self contained. Reversing: has a double set of contactors that are prewired. Standard: is a generic device that controls the flow of power in a circuit on or off."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcelectricaldomain/pset/pset_switchingdevicetypecontactor.htm"
@@ -8963,7 +8963,7 @@
        "description": "A starter is a switch which in the closed position controls the application of power to an electrical device.",
        "properties": {
            "StarterType": {
-                "description": "A list of the available types of starter from which that required may be selected where:"
+                "description": "A list of the available types of starter from which that required may be selected where: AutoTransformer: A starter for an induction motor which uses for starting one or more reduced voltages derived from an auto transformer. (IEC 441-14-45) Manual: A starter in which the force for closing the main contacts is provided exclusively by manual energy. (IEC 441-14-39) DirectOnLine: A starter which connects the line voltage across the motor terminals in one step. (IEC 441-14-40) Frequency: A starter in which the frequency of the power supply is progressively increased until the normal operation frequency is attained. nStep: A starter in which there are (n-1) intermediate accelerating positions between the off and full on positions. (IEC 441-14-41) Rheostatic: A starter using one or several resistors for obtaining, during starting, stated motor torque characteristics and for limiting the current. (IEC 441-14-425) StarDelta: A starter for a 3 phase induction motor such that in the starting position the stator windings are connected in star and in the final running position they are connected in delta. (IEC 441-14-44)"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcelectricaldomain/pset/pset_switchingdevicetypestarter.htm"
@@ -8975,7 +8975,7 @@
                "description": "A list of the available types of load disconnection from which that required may be selected."
            },
            "SwitchDisconnectorType": {
-                "description": "A list of the available types of switch disconnector from which that required may be selected where:"
+                "description": "A list of the available types of switch disconnector from which that required may be selected where: CenterBreak: A disconnector in which both contacts of each pole are movable and engage at a point substantially midway between their supports. (IEC 441-14-08) DividedSupport: A disconnector in which the fixed and moving contacts of each pole are not supported by a common base or frame. (IEC 441-14-06) DoubleBreak: A disconnector that opens a circuit at two points. (IEC 441-14-09) EarthingSwitch: A disconnector in which the fixed and moving contacts of each pole are not supported by a common base or frame. (IEC 441-14-07) Isolator: A disconnector which in the open position satisfies isolating requirements. (IEC 441-14-12)"
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcelectricaldomain/pset/pset_switchingdevicetypeswitchdisconnector.htm"
@@ -9056,13 +9056,13 @@
        "description": "Properties that relate to a tank. Note that a partial tank may be considered as a compartment within a compartmentalized tank.",
        "properties": {
            "HasLadder": {
-                "description": "Indication of whether the tank is provided with a ladder (set TRUE) for access to the top. If no ladder is provided then value is set FALSE."
+                "description": "Indication of whether the tank is provided with a ladder (set TRUE) for access to the top. If no ladder is provided then value is set FALSE. Note: No indication is given of the type of ladder (gooseneck etc.)"
            },
            "HasVisualIndicator": {
                "description": "Indication of whether the tank is provided with a visual indicator (set TRUE) that shows the water level in the tank. If no visual indicator is provided then value is set FALSE."
            },
            "TankComposition": {
-                "description": "Defines the level of element composition where."
+                "description": "Defines the level of element composition where. COMPLEX: A set of elementary units aggregated together to fulfill the overall required purpose. ELEMENT: A single elementary unit that may exist of itself or as an aggregation of partial units.. PARTIAL: A partial elementary unit."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_tankoccurrence.htm"
@@ -9086,7 +9086,7 @@
        "description": "Common attributes of a tank type.",
        "properties": {
            "AccessType": {
-                "description": "Defines the types of access (or cover) to a tank that may be specified."
+                "description": "Defines the types of access (or cover) to a tank that may be specified. Note that covers are generally specified for rectangular tanks. For cylindrical tanks, access will normally be via a manhole."
            },
            "EffectiveCapacity": {
                "description": "The total effective or actual volumetric capacity of the tank."
@@ -9101,16 +9101,16 @@
                "description": "The total nominal or design volumetric capacity of the tank."
            },
            "NominalDepth": {
-                "description": "The nominal depth of the tank."
+                "description": "The nominal depth of the tank. Note: Not required for a horizontal cylindrical tank."
            },
            "NominalLengthOrDiameter": {
                "description": "The nominal length or, in the case of a vertical cylindrical tank, the nominal diameter of the tank."
            },
            "NominalWidthOrDiameter": {
-                "description": "The nominal width or, in the case of a horizontal cylindrical tank, the nominal diameter of the tank."
+                "description": "The nominal width or, in the case of a horizontal cylindrical tank, the nominal diameter of the tank. Note: Not required for a vertical cylindrical tank."
            },
            "NumberOfSections": {
-                "description": "Number of sections used in the construction of the tank. Default is 1."
+                "description": "Number of sections used in the construction of the tank. Default is 1. Note: All sections assumed to be the same size."
            },
            "OperatingWeight": {
                "description": "Operating weight of the tank including all of its contents."
@@ -9149,7 +9149,7 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_tanktypeexpansion.htm"
    },
    "Pset_TankTypePreformed": {
-        "description": "Fixed vessel manufactured as a single unit with one or more compartments for storing a liquid.",
+        "description": "Fixed vessel manufactured as a single unit with one or more compartments for storing a liquid. Pset renamed from Pset_TankTypePreformedTank to Pset_TankTypePreformed in IFC2x2 Pset Addendum.",
        "properties": {
            "EndShapeType": {
                "description": "Defines the types of end shapes that can be used for preformed tanks. The convention for reading these enumerated values is that for a vertical cylinder, the first value is the base and the second is the top; for a horizontal cylinder, the order of reading should be left to right. For a speherical tank, the value UNSET should be used."
@@ -9182,10 +9182,10 @@
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifchvacdomain/pset/pset_tanktypepressurevessel.htm"
    },
    "Pset_TankTypeSectional": {
-        "description": "Fixed vessel constructed from sectional parts with one or more compartments for storing a liquid.",
+        "description": "Fixed vessel constructed from sectional parts with one or more compartments for storing a liquid. Note (1): All sectional construction tanks are considered to be rectangular by default. Note (2): Generally, it is not expected that sectional construction tanks will be used for the purposes of gas storage. Pset renamed from Pset_TankTypeSectionalTank to Pset_TankTypeSectional in IFC2x2 Pset Addendum.",
        "properties": {
            "NumberOfSections": {
-                "description": "Number of sections used in the construction of the tank"
+                "description": "Number of sections used in the construction of the tank Note: All sections assumed to be the same size."
            },
            "SectionLength": {
                "description": "The length of a section used in the construction of the tank."
@@ -9338,7 +9338,7 @@
                "description": "Status of the element, predominately used in renovation or retrofitting projects. The status can be assigned to as \"New\" - element designed as new addition, \"Existing\" - element exists and remains, \"Demolish\" - element existed but is to be demolished, \"Temporary\" - element will exists only temporary (like a temporary support structure)."
            },
            "TransformerVectorGroup": {
-                "description": "List of the possible vector groups for the transformer from which that required may be set. Values in the enumeration list follow a standard international code where the first letter  describes how the primary windings are connected, the second letter describes how the secondary windings are connected, and the numbers describe the rotation of voltages and currents from the primary to the secondary side in multiples of 30 degrees."
+                "description": "List of the possible vector groups for the transformer from which that required may be set. Values in the enumeration list follow a standard international code where the first letter describes how the primary windings are connected, the second letter describes how the secondary windings are connected, and the numbers describe the rotation of voltages and currents from the primary to the secondary side in multiples of 30 degrees. D: means that the windings are delta-connected. Y: means that the windings are star-connected. Z: means that the windings are zig-zag connected (a special start-connected providing low reactance of the transformer); The connectivity is only relevant for three-phase transformers."
            }
        },
        "spec_url": "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/schema/ifcelectricaldomain/pset/pset_transformertypecommon.htm"
@@ -9642,13 +9642,13 @@
                "description": "The maximum pressure to which the valve has been subjected under test."
            },
            "ValveMechanism": {
-                "description": "The mechanism by which the valve function is achieved where:"
+                "description": "The mechanism by which the valve function is achieved where: BALL: Valve that has a ported ball that can be turned relative to the body seat ports. BUTTERFLY: Valve in which a streamlined disc pivots about a diametric axis. CONFIGUREDGATE: Screwdown valve in which the closing gate is shaped in a configured manner to have a more precise control of pressure and flow change across the valve. GLAND: Valve with a tapered seating, in which a rotatable plug is retained by means of a gland and gland packing. GLOBE: Screwdown valve that has a spherical body. LUBRICATEDPLUG: Plug valve in which a lubricant is injected under pressure between the plug face and the body. NEEDLE: Valve for regulating the flow in or from a pipe, in which a slender cone moves along the axis of flow to close against a fixed conical seat. PARALLELSLIDE: Screwdown valve that has a machined plate that slides in formed grooves to form a seal. PLUG: Valve that has a ported plug that can be turned relative to the body seat ports. WEDGEGATE: Screwdown valve that has a wedge shaped plate fitting into tapered guides to form a seal."
            },
            "ValveOperation": {
-                "description": "The method of valve operation where:"
+                "description": "The method of valve operation where: DROPWEIGHT: A valve that is closed by the action of a weighted lever being released, the weight normally being prevented from dropping by being held by a wire, the closure normally being made by the action of heat on a fusible link in the wire FLOAT: A valve that is opened and closed by the action of a float that rises and falls with water level. The float may be a ball attached to a lever or other mechanism HYDRAULIC: A valve that is opened and closed by hydraulic actuation LEVER: A valve that is opened and closed by the action of a lever rotating the gate within the valve. LOCKSHIELD: A valve that requires the use of a special lockshield key for opening and closing, the operating mechanism being protected by a shroud during normal operation. MOTORIZED: A valve that is opened and closed by the action of an electric motor on an actuator PNEUMATIC: A valve that is opened and closed by pneumatic actuation SOLENOID: A valve that is normally held open by a magnetic field in a coil acting on the gate but that is closed immediately if the electrical current generating the magnetic field is removed. SPRING: A valve that is normally held in position by the pressure of a spring on a plate but that may be caused to open if the pressure of the fluid is sufficient to overcome the spring pressure. THERMOSTATIC: A valve in which the ports are opened or closed to maintain a required predetermined temperature. WHEEL: A valve that is opened and closed by the action of a wheel moving the gate within the valve."
            },
            "ValvePattern": {
-                "description": "The configuration of the ports of a valve according to either the linear route taken by a fluid flowing through the valve or by the number of ports where:"
+                "description": "The configuration of the ports of a valve according to either the linear route taken by a fluid flowing through the valve or by the number of ports where: SINGLEPORT: Valve that has a single entry port from the system that it serves, the exit port being to the surrounding environment. ANGLED_2_PORT: Valve in which the direction of flow is changed through 90 degrees. STRAIGHT_2_PORT: Valve in which the flow is straight through. STRAIGHT_3_PORT: Valve with three separate ports. CROSSOVER_4_PORT: Valve with 4 separate ports."
            },
            "WorkingPressure": {
                "description": "The normally expected maximum working pressure of the valve."
@@ -9672,13 +9672,13 @@
                "description": "Defines the operating temperature of a faucet that may be specified."
            },
            "FaucetOperation": {
-                "description": "Defines the range of ways in which a faucet can be operated that may be specified where:"
+                "description": "Defines the range of ways in which a faucet can be operated that may be specified where: CeramicDisc: Quick action faucet with a ceramic seal to open or close the orifice . LeverHandle: Quick action faucet that is operated by a lever handle . NonConcussiveSelfClosing: Self closing faucet that does not induce surge pressure . QuarterTurn: Quick action faucet that can be fully opened or shut by turning the operating mechanism through 90 degrees. QuickAction: Faucet that can be opened or closed fully with a single small movement of the operating mechanism . ScrewDown: Faucet in which a plate or disc is moved, by the rotation of a screwed spindle, to close or open the orifice. SelfClosing: Faucet that is opened by pressure of the top of an operating spindle and is closed under the action of a spring or weight when the pressure is released. TimedSelfClosing: Self closing faucet that discharges for a predetermined period of time ."
            },
            "FaucetTopDescription": {
                "description": "Description of the operating mechanism/top of the faucet."
            },
            "FaucetType": {
-                "description": "Defines the range of faucet types that may be specified where:"
+                "description": "Defines the range of faucet types that may be specified where: Bib: Faucet with a horizontal inlet and a nozzle that discharges downwards. Globe: Faucet fitted through the end of a bath, with a horizontal inlet, a partially spherical body and a vertical nozzle. Diverter: Combination faucet assembly with a valve to enable the flow of mixed water to be transferred to a showerhead. DividedFlowCombination: Combination faucet assembly in which hot and cold water are kept separate until emerging from a common nozzle . Pillar: Faucet that has a vertical inlet and a nozzle that discharges downwards . SingleOutletCombination = Combination faucet assembly in which hot and cold water mix before emerging from a common nozzle . Spray: Faucet with a spray outlet . SprayMixing: Spray faucet connected to hot and cold water supplies that delivers water at a temperature determined during use."
            },
            "Finish": {
                "description": "Description of the finish applied to the faucet."
@@ -9877,10 +9877,10 @@
                "description": "Indicates whether the gully trap has a strainer (= TRUE) or not (= FALSE)."
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "InletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a trap."
+                "description": "Identifies the pattern of inlet connections to a trap. A trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south)."
            },
            "IsForSullageWater": {
                "description": "Indicates if the purpose of the floor trap is to receive sullage water, or if that is amongst its purposes (= TRUE), or not (= FALSE). Note that if TRUE, it is expected that an upstand or kerb will be placed around the floor trap to prevent the ingress of surface water runoff; the provision of the upstand or kerb is not dealt with in this property set."
@@ -9934,7 +9934,7 @@
        "description": "Pipe fitting or assembly of fittings to receive surface water or waste water, fitted with a grating or sealed cover.",
        "properties": {
            "BackInletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a gully trap."
+                "description": "Identifies the pattern of inlet connections to a gully trap. A gulley trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the gully trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south). ! | 1-| |-3 ! |"
            },
            "CoverLength": {
                "description": "The length measured along the x-axis in the local coordinate system or the radius (in the case of a circular shape in plan) of the cover of the gully trap."
@@ -9946,7 +9946,7 @@
                "description": "Identifies the predefined types of gully from which the type required may be set."
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "NominalSumpDepth": {
                "description": "Nominal or quoted length measured along the z-axis in the local coordinate system of the sump."
@@ -9970,7 +9970,7 @@
        "description": "Pipe fitting or assembly of fittings to receive surface water or waste water, fitted with a grating or sealed cover and discharging through a trap (BS6100 330 3504 modified)",
        "properties": {
            "BackInletPatternType": {
-                "description": "Identifies the pattern of inlet connections to a gully trap."
+                "description": "Identifies the pattern of inlet connections to a gully trap. A gulley trap may have 0,1,2,3 or 4 inlet connections and the pattern of their arrangement may vary. The enumeration makes the convention that an outlet is either vertical or is placed at the bottom (south side) of the gully trap (when viewed in plan). Position 1 is to the left (west), position 2 is to the top (north), position 3 is to the right (east) and position 4 is to the bottom (south)."
            },
            "CoverLength": {
                "description": "The length measured along the x-axis in the local coordinate system or the radius (in the case of a circular shape in plan) of the cover of the gully trap."
@@ -9985,7 +9985,7 @@
                "description": "Indicates whether the gully trap has a strainer (= TRUE) or not (= FALSE)."
            },
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "NominalBodyDepth": {
                "description": "Nominal or quoted length measured along the z-axis in the local coordinate system of the chamber of the gully trap."
@@ -10048,7 +10048,7 @@
        "description": "Pipe fitting, set adjacent to a sanitary terminal, that retains liquid to prevent the passage of foul air.",
        "properties": {
            "InletConnectionSize": {
-                "description": "Size of the inlet connection(s), where used, of the inlet connections."
+                "description": "Size of the inlet connection(s), where used, of the inlet connections. Note that all inlet connections are assumed to be the same size."
            },
            "OutletConnectionSize": {
                "description": "Size of the outlet connection from the object."