Update docs, test fixtures, and test loader

docs/about.md

@@ -1,14 +1,14 @@
-# About CatCore
-Robust data-sharing guidelines are essential in catalysis research to guarantee high-quality metadata, reproducibility, and the sustained progress of digital catalysis. To establish community-accepted guidelines for reporting metadata in this field, CatCore (an initiative under NFDI4Cat) specifies the minimum information that go beyond the conventional field-independent metadata, and should be reported with the catalysis research data. This guideline should help users to handle and standarise data in this versatile research field based on the FAIR principle (F-indable, A-ccessible, I-nteroperable, R-eusable). Integration of CatCore into data repositories ensures the availability of high-quality metadata and facilitates efficient access to and querying of published datasets.
-The terminology employed in CatCore is based on Voc4Cat (developed under NFDI4Cat), which supports standardized semantic representation and advances ontology development efforts. Terms not yet covered by Voc4Cat are provisionally defined within the model and incorporated as the vocabulary is updated. Structurally, the model consists of two parts: “Inner CatCore” and “Expanded CatCore”. Within these layers, data fields are organized hierarchically, following a parent–child relationship. The inner CatCore describes the most fundamental metadata which is mandatory to describe the research on the most general level with the goal of facilitating a categorization of the research data and help researchers to make their data findable. The expanded CatCore contains the data classes 'Synthesis', 'Reaction', 'Characterization' and 'Simulation'. The data fields are classified as “Mandatory,” “Recommended,” and “Optional” to reflect their relative priority. This classification helps users identify the minimum required metadata necessary to ensure data quality, while also allowing the inclusion of additional information that, although not mandatory, further enhances the value and usability of the data. Moreover, this prioritization facilitates the efficient handling and management of the large volumes of metadata generated by experimental devices and computation. 
-The CatCore model is a “living organism” that evolves through user feedback on the addition, removal, and modification of data fields, for which provisions are provided on this webpage through the “Submit Term Feedback” button. All feedback and suggestions are reviewed by the CatCore development team and incorporated as appropriate based on their relevance and impact. 
+# About CoreMeta4Cat
+Robust data-sharing guidelines are essential in catalysis research to guarantee high-quality metadata, reproducibility, and the sustained progress of digital catalysis. To establish community-accepted guidelines for reporting metadata in this field, CoreMeta4Cat (an initiative under NFDI4Cat) specifies the minimum information that go beyond the conventional field-independent metadata, and should be reported with the catalysis research data. This guideline should help users to handle and standarise data in this versatile research field based on the FAIR principle (F-indable, A-ccessible, I-nteroperable, R-eusable). Integration of CoreMeta4Cat into data repositories ensures the availability of high-quality metadata and facilitates efficient access to and querying of published datasets.
+The terminology employed in CoreMeta4Cat is based on Voc4Cat (developed under NFDI4Cat), which supports standardized semantic representation and advances ontology development efforts. Terms not yet covered by Voc4Cat are provisionally defined within the model and incorporated as the vocabulary is updated. Structurally, the model consists of two parts: “Inner CoreMeta4Cat” and “Expanded CoreMeta4Cat”. Within these layers, data fields are organized hierarchically, following a parent–child relationship. The inner CoreMeta4Cat describes the most fundamental metadata which is mandatory to describe the research on the most general level with the goal of facilitating a categorization of the research data and help researchers to make their data findable. The expanded CoreMeta4Cat contains the data classes 'Synthesis', 'Reaction', 'Characterization' and 'Simulation'. The data fields are classified as “Mandatory,” “Recommended,” and “Optional” to reflect their relative priority. This classification helps users identify the minimum required metadata necessary to ensure data quality, while also allowing the inclusion of additional information that, although not mandatory, further enhances the value and usability of the data. Moreover, this prioritization facilitates the efficient handling and management of the large volumes of metadata generated by experimental devices and computation. 
+The CoreMeta4Cat model is a “living organism” that evolves through user feedback on the addition, removal, and modification of data fields, for which provisions are provided on this webpage through the “Submit Term Feedback” button. All feedback and suggestions are reviewed by the CoreMeta4Cat development team and incorporated as appropriate based on their relevance and impact. 
 
 
 
 <img width="410" height="315" alt="image" src="https://github.com/user-attachments/assets/5426ea14-5847-4da3-a898-d66b3c192c77" />
 
 
-Inner CatCore: The inner CatCore defines the most fundamental metadata, which are mandatory for describing research at a general level. Its goal is to facilitate consistent categorization of research data and assist researchers in making their datasets more easily findable. The data classes in the inner CatCore consists of Catalysis Research Field (Mandatory), Reaction type (Mandatory), Active Site (Recommended) and Identifier (Recommended).
+Inner CoreMeta4Cat: The inner CoreMeta4Cat defines the most fundamental metadata, which are mandatory for describing research at a general level. Its goal is to facilitate consistent categorization of research data and assist researchers in making their datasets more easily findable. The data classes in the inner CoreMeta4Cat consists of Catalysis Research Field (Mandatory), Reaction type (Mandatory), Active Site (Recommended) and Identifier (Recommended).
 Catalysis Research Field: This section describes the different types of catalysis, including homogeneous, heterogeneous, electrocatalysis, and hybrid catalysis. It also provides provisions for specifying other types of catalysis that do not fall within these categories. 
 Reaction type: The catalytic reaction under investigation (examples: hydrogenation, oxidation, hydroformylation, etc.)
 Active Site: It is recommended to specify the primary species in the catalyst responsible for catalytic activity. The expected value for this field is a text entry identifying a molecule, element, or other relevant species, with the option to provide multiple entries if applicable.  

docs/index.md

@@ -1,8 +1,19 @@
-# CatCore
+# CoreMeta4Cat
 
-Catcore is a metadata collection for catalysis related research, which is intended to be developed into several schema's, such that we can harmonize Metadata representation of various research topics int the domain of catalysis.
+Robust data-sharing guidelines are essential in catalysis research to guarantee high-quality metadata, reproducibility, and the sustained progress of digital catalysis. To establish community-accepted guidelines for reporting metadata in this field, CoreMeta4Cat (an initiative under NFDI4Cat) specifies the minimum information that go beyond the conventional field-independent metadata, and should be reported with the catalysis research data. This guideline should help users to handle and standarise data in this versatile research field based on the FAIR principle (F-indable, A-ccessible, I-nteroperable, R-eusable). Integration of CoreMeta4Cat into data repositories ensures the availability of high-quality metadata and facilitates efficient access to and querying of published datasets.
+The terminology employed in CoreMeta4Cat is based on Voc4Cat (developed under NFDI4Cat), which supports standardized semantic representation and advances ontology development efforts. Terms not yet covered by Voc4Cat are provisionally defined within the model and incorporated as the vocabulary is updated. Structurally, the model consists of two parts: “Inner CoreMeta4Cat” and “Expanded CoreMeta4Cat”. Within these layers, data fields are organized hierarchically, following a parent–child relationship. The inner CoreMeta4Cat describes the most fundamental metadata which is mandatory to describe the research on the most general level with the goal of facilitating a categorization of the research data and help researchers to make their data findable. The expanded CoreMeta4Cat contains the data classes 'Synthesis', 'Reaction', 'Characterization' and 'Simulation'. The data fields are classified as “Mandatory,” “Recommended,” and “Optional” to reflect their relative priority. This classification helps users identify the minimum required metadata necessary to ensure data quality, while also allowing the inclusion of additional information that, although not mandatory, further enhances the value and usability of the data. Moreover, this prioritization facilitates the efficient handling and management of the large volumes of metadata generated by experimental devices and computation. 
+The CoreMeta4Cat model is a “living organism” that evolves through user feedback on the addition, removal, and modification of data fields, for which provisions are provided on this webpage through the “Submit Term Feedback” button. All feedback and suggestions are reviewed by the CoreMeta4Cat development team and incorporated as appropriate based on their relevance and impact. 
 
-As bepicted below, CatCore is devided into four major branches, Reaction, Synthesis, Characterisation and Simulation, each described with respective metadata terminology.
+
+
+<img width="410" height="315" alt="image" src="https://github.com/user-attachments/assets/5426ea14-5847-4da3-a898-d66b3c192c77" />
+
+
+Inner CoreMeta4Cat: The inner CoreMeta4Cat defines the most fundamental metadata, which are mandatory for describing research at a general level. Its goal is to facilitate consistent categorization of research data and assist researchers in making their datasets more easily findable. The data classes in the inner CoreMeta4Cat consists of Catalysis Research Field (Mandatory), Reaction type (Mandatory), Active Site (Recommended) and Identifier (Recommended).
+Catalysis Research Field: This section describes the different types of catalysis, including homogeneous, heterogeneous, electrocatalysis, and hybrid catalysis. It also provides provisions for specifying other types of catalysis that do not fall within these categories. 
+Reaction type: The catalytic reaction under investigation (examples: hydrogenation, oxidation, hydroformylation, etc.)
+Active Site: It is recommended to specify the primary species in the catalyst responsible for catalytic activity. The expected value for this field is a text entry identifying a molecule, element, or other relevant species, with the option to provide multiple entries if applicable.  
+Identifier: It is the identification of the catalyst through user defined labels. 
 
 
 <div style="text-align: center;">

docs/overview.md

@@ -19,7 +19,7 @@ description: Comprehensive Metadata Guidelines for Catalysis Research Data
 
     Eight reactor design types, flattened operation parameter slots, and product identification links.
 
--   :material-cpu-64-bit: **Simulation**
+-   :octicons-cpu-16: **Simulation**
 
     Four computational methods (DFT, MD, Microkinetics, Monte Carlo) with 12 calculated property classes.
 

mkdocs.yml

@@ -70,3 +70,6 @@ markdown_extensions:
   - md_in_html
   - admonition
   - attr_list
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg

src/catcore/datamodel/catcore.py

@@ -1,5 +1,5 @@
 # Auto generated from catcore.yaml by pythongen.py version: 0.0.1
-# Generation date: 2026-03-04T09:35:08
+# Generation date: 2026-03-04T22:31:48
 # Schema: catcore-metadata
 #
 # id: https://w3id.org/nfdi4cat/catcore

tests/data/valid/Synthesis-001.yaml

@@ -1,20 +1,30 @@
 ---
-# Complete Synthesis Instance
-# This represents a Synthesis object as defined in the schema
+# Synthesis-001 -- Incipient wetness impregnation of 5 wt% Pt/Al2O3
+# Target class: Synthesis
+#
+# NOTE: realized_plan range is PreparationMethod (abstract, no domain slots).
+# Domain synthesis parameters that live on catcore_common ARE accepted on Synthesis directly.
+# realized_plan: title/description only — the loader cannot dispatch to Impregnation subclass.
 
+id: "catcore:SYNTH_001_Pt_Al2O3"
+nominal_composition:
+  - "5 wt% Pt/Al2O3"
+catalyst_measured_properties:
+  - "BET surface area: 185 m2/g, Pt particle size: 2.3 nm (TEM), Pt loading: 4.8 wt% (ICP-AES)"
+storage_conditions:
+  - "stored in desiccator under argon atmosphere at room temperature"
+support:
+  - "gamma-Al2O3, Sasol Puralox, 200 m2/g"
+solvent:
+  - "deionized water"
+sample_pretreatment:
+  - "reduction in H2 at 400 deg C for 2 hours prior to catalytic testing"
+had_input_entity:
+  - id: "catcore:PREC_001_H2PtCl6"
+    title: "chloroplatinic acid hexahydrate"
+    precursor_quantity:
+      - 0.0485
 
-
-identifier: "SYNTH_001_Pt_Al2O3"
-nominal_composition: "5 wt% Pt/Al2O3"
-catalyst_measured_properties: "BET surface area: 185 m²/g, Pt particle size: 2.3 nm (TEM), Pt loading: 4.8 wt% (ICP-AES)"
-storage_conditions: ["stored in desiccator under argon atmosphere at room temperature"]
-support: ["γ-Al2O3, Sasol Puralox, 200 m²/g"]
-solvent: ["deionized water", "ethanol"]
-sample_pretreatment: ["reduction in H2 at 400°C for 2 hours prior to catalytic testing"]
-
-precursor:
-  - identifier: "PREC_001"
-    precursor_quantity: [0.0485]
-
-preparation_method:
-  - identifier: "PREP_001"
+realized_plan:
+  title: "incipient wetness impregnation"
+  description: "incipient_wetness, 25 deg C, 12 h"