From 2b4586c805487390f69eae00c2ca63e7492e2db9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 6 May 2026 20:25:41 +0000
Subject: [PATCH 1/2] Initial plan


From 4d3afbca98e52ff0fa9051751661afc382b37633 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 6 May 2026 20:27:58 +0000
Subject: [PATCH 2/2] Add Label element to Related for keyword/filtering
 support

Agent-Logs-Url: https://github.com/modelica/fmi-ls-ref/sessions/095a984d-69ec-4017-9fd1-f9c8763422a3

Co-authored-by: pmai <91502+pmai@users.noreply.github.com>
---
 docs/examples/fmi_ls_ref_manifest_example.xml | 17 ++++++---
 docs/index.adoc                               | 35 +++++++++++++++++++
 .../fmi3LayeredStandardReferenceManifest.xsd  | 20 +++++++++++
 3 files changed, 68 insertions(+), 4 deletions(-)

diff --git a/docs/examples/fmi_ls_ref_manifest_example.xml b/docs/examples/fmi_ls_ref_manifest_example.xml
index db292e8..0d0f4a3 100644
--- a/docs/examples/fmi_ls_ref_manifest_example.xml
+++ b/docs/examples/fmi_ls_ref_manifest_example.xml
@@ -8,9 +8,18 @@
 	fmi-ls:fmi-ls-description="Layered Standard providing information on related files included in an FMU.">
 	
 	<Related type="text/modelica" source="modelica/mymodel.mo" role="model" description="Modelica Model Source"/>
-	<Related type="application/x-ssp-parameter-set" source="baseline-params.ssv" role="parameter" description="Baseline Model Parameters"/>
-	<Related type="application/x-ssp-parameter-set" source="midend-params.ssv" role="parameter" description="Midend Model Parameters"/>
-	<Related type="application/x-ssp-parameter-set" source="highend-params.ssv" role="parameter" description="Highend Model Parameters"/>
+	<Related type="application/x-ssp-parameter-set" source="baseline-params.ssv" role="parameter" description="Baseline Model Parameters">
+		<Label name="variant:baseline" description="Baseline variant parameters"/>
+	</Related>
+	<Related type="application/x-ssp-parameter-set" source="midend-params.ssv" role="parameter" description="Midend Model Parameters">
+		<Label name="variant:midend" description="Midend variant parameters"/>
+	</Related>
+	<Related type="application/x-ssp-parameter-set" source="highend-params.ssv" role="parameter" description="Highend Model Parameters">
+		<Label name="variant:highend" description="Highend variant parameters"/>
+	</Related>
 	<Related type="application/x-ssp-parameter-set" source="dynamic-params.ssv" role="parameter" description="Dynamic Model Parameters"/>
-	<Related type="application/x-ma-ls-experiments" source="smoke-tests.exp" role="experiment" description="Smoke Tests of FMU"/>
+	<Related type="application/x-ma-ls-experiments" source="smoke-tests.exp" role="experiment" description="Smoke Tests of FMU">
+		<Label name="simulation-type:SIL" description="Applicable for Software-in-the-Loop simulation"/>
+		<Label name="os:Win64" description="Applicable for Windows 64-bit target"/>
+	</Related>
 </fmiReferences>
diff --git a/docs/index.adoc b/docs/index.adoc
index b1566d9..f5a597b 100644
--- a/docs/index.adoc
+++ b/docs/index.adoc
@@ -148,6 +148,41 @@ No base requirements on supported URI schemes are given in this layered standard
 |Brief description of the related file that is suitable for display to users.
 |====
 
+The `<Related>` element can contain the following child elements:
+
+.Related Child Elements.
+[[table-schema-fmi-ls-ref-related-elements]]
+[cols="1,3"]
+|====
+|Element |Description
+
+|`<Label>`
+|Each element assigns a label to the related file, which can be used to categorize or filter related files for a certain use case.
+Zero or more `<Label>` elements may be present.
+|====
+
+==== Labels
+
+Labels can be used to categorize related files and to filter them for a certain use case.
+For example, labels can be used to filter for a certain variant, to filter files which are relevant for SIL or HIL simulation, or to filter for different target operating systems.
+
+The `<Label>` element contains the following attributes:
+
+.Label Attributes.
+[[table-schema-fmi-ls-ref-label-attributes]]
+[cols="1,1,2"]
+|====
+|Attribute |Presence |Description
+
+|`name`
+|Required
+|Name of the label.
+
+|`description`
+|Optional
+|Brief description of the label that is suitable for display to users.
+|====
+
 The `role` attribute is used to indicate the purpose of the related file.
 A role can consist of a main role and optionally one or more sub-roles, separated by a forward slash (`/`), that indicate more specific purposes of the related file.
 For example, the role `experiment/smoke-test` indicates that the related file is an experiment file that can be used to perform a smoke test validation of the FMU, while the role `experiment/validation` indicates that the related file is an experiment file that can be used to perform a detailed validation of the FMU.
diff --git a/schema/fmi3LayeredStandardReferenceManifest.xsd b/schema/fmi3LayeredStandardReferenceManifest.xsd
index ee81e6f..67cc36c 100644
--- a/schema/fmi3LayeredStandardReferenceManifest.xsd
+++ b/schema/fmi3LayeredStandardReferenceManifest.xsd
@@ -46,6 +46,9 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     </xs:element>
     
     <xs:complexType name="TRelated">
+        <xs:sequence>
+            <xs:element name="Label" minOccurs="0" maxOccurs="unbounded" type="TLabel"/>
+        </xs:sequence>
         <xs:attribute name="type" type="xs:string" use="optional" default="application/octet-stream">
             <xs:annotation>
                 <xs:documentation xml:lang="en">
@@ -77,4 +80,21 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
         </xs:attribute>
         <xs:attribute name="description" type="xs:string"/>
     </xs:complexType>
+
+    <xs:complexType name="TLabel">
+        <xs:attribute name="name" type="xs:string" use="required">
+            <xs:annotation>
+                <xs:documentation xml:lang="en">
+                    This attribute specifies the name of the label used to categorize or filter the related resource.
+                </xs:documentation>
+            </xs:annotation>
+        </xs:attribute>
+        <xs:attribute name="description" type="xs:string">
+            <xs:annotation>
+                <xs:documentation xml:lang="en">
+                    This optional attribute provides a brief description of the label.
+                </xs:documentation>
+            </xs:annotation>
+        </xs:attribute>
+    </xs:complexType>
 </xs:schema>