Skip to content

Commit d656829

Browse files
committed
the docs
1 parent f19907d commit d656829

File tree

5 files changed

+24
-22
lines changed

5 files changed

+24
-22
lines changed

docs/assets/pa-example.jpg

560 KB
Loading

docs/domain-examples.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Domain Examples
2+
The following modeling examples illustrate how research data can be represented using the CTO, with respect to the subject areas of performing arts, musicology, media studies, art history, and architecture. They also demonstrate the alignment of CTO with NFDIcore and the Basic Formal Ontology (BFO 2020).
3+
4+
## Performing Arts
5+
![Basic Structure](assets/pa-example.jpg)

docs/index.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,6 @@ CTO represents the research data of the NFDI4Culture community within a research
88
The ontology’s latest version is always accessible at: [cto.owl](https://github.com/ISE-FIZKarlsruhe/nfdi4culture/blob/main/cto.owl)
99
A generated list of resources via Widoco is available at: [https://nfdi4culture.de/ontology](https://nfdi4culture.de/ontology)
1010

11-
## Ontology Scope
12-
The main focus of CTO is the creation of a light-weight index of cultural heritage research data provided by the culture community. This includes but is not limited to the subject areas musicology, performing arts, media studies, architecture, and art history. The key aspects of CTO concern:
13-
14-
- **The consortium and its infrastructure:** persons and organizations involved in research processes, services, guidelines, standards, and events
15-
- **The content of cultural heritage research data:** cultural heritage objects, persons, locations and events referenced in the provided data, associated media, references to external vocabularies used for the identification and classification of the provided research data
16-
- **Access and reuse:** legal statements, contact persons, standards, and export formats
17-
1811
## Ontology Metadata
1912

2013
- **Title:** NFDI4Culture Ontology

docs/structure.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,25 @@
1-
# Ontology Structure
2-
3-
![Basic Structure](assets/core-structure.jpg)
4-
5-
The core structure of CTO consists of four main elements. `schema:DataFeed` represents a data feed in the Research Information Graph (RIG). This data feed is created in the Culture Information Portal using TYPO3 and its LOD extension. The metadata associated with the data feed include contact persons, export formats, licenses, and related projects and organizations. For each item (`cto: source item`) in the data feed, a permanent ARK (`schema:DataFeedItem`) is created as its stable reference entity. The `schema:DataFeedItem` does not contain content-related information about the source item, aside from a license issued by NFDI4Culture and the creation and modification dates. This stable reference entity functions as a persistent identifier in the knowledge graph, remaining valid even if the content of the source item is changed or deleted. The main content-related metadata are associated with `cto: source item`. This includes associated media, related entities and their identifiers in external vocabularies, temporal data, and subject-area-specific metadata, such as musical incipits. Furthermore, it is possible to express which real-world entity `cto: source item` is about. These entities could be sculptures, buildings, persons, books, etc. However, since this information is often not provided in the research data, this aspect currently serves as a proof of concept and is only materialized when clearly stated by the data providers.
6-
7-
1+
# Ontology Scope and Structure
82

3+
**The main scope of CTO** is the representation of cultural heritage research data within a data index, i.e. a single point of access to decentralized cultural heritage research resources. The ontology supports the integration of research (meta)data harvested through a dedicated ETL pipeline. Its main focus is the creation of a lightweight index of cultural heritage research data provided by the culture community, including but not limited to the subject areas of musicology, performing arts, media studies, architecture, and art history.
94

5+
The key aspects of CTO concern:
106

7+
- **The consortium and its infrastructure:** persons and organizations involved in research processes, services, guidelines, standards, and events
8+
- **The content of cultural heritage research data:** cultural heritage objects, persons, locations and events referenced in the provided data, associated media, references to external vocabularies used for the identification and classification of the provided research data
9+
- **Access and reuse:** legal statements, contact persons, standards, and export formats
1110

1211
## Reused Ontologies
1312

13+
Building CTO based on standardized upper-level ontologies provides a well-defined and standardized semantic structure, ensuring clear definitions of entities and their relationships. These ontologies enhance interoperability across different domains, support ontology development, and promote consistency in knowledge representation. The following ontologies have been reused in CTO:
1414

15+
- **Basic Formal Ontology (BFO 2020):** BFO was selected as the top-level ontology due to its well-structured design, broad applicability, and ability to integrate with various ontologies. As a foundational framework, BFO provides abstract, cross-domain semantic structures, ensuring comprehensive integration and compliance with top-level ontology standards. Its adherence to the ISO/IEC 21838-2 standars further enhances interoperability in developed ontologies, facilitating knowledge representation, data exchange, and interdisciplinary collaboration.
16+
- **NFDIcore ontology v3.0:**: As a mid-level ontology, NFDIcore plays a central role in structuring and integrating research data across consortia. NFDIcore features a modular structure for improved interoperability among NFDI consortia. It provides a shared vocabulary that represents both the organizational structure of the NFDI and the diverse datasets contributed by project partners. The ontology encompasses key concepts such as organizations, consortia, projects, datasets, research outputs, geographical locations, and technical standards. These structured representations enable efficient data management, integration, and reuse across disciplines.
17+
- **Information Artefact Ontology (IAO):** The Information Artefact Ontology was partially reused. The most central IAO class supporting CTO’s alignment with BFO is `iao:information content entity`. Since IAO does not yet fully support BFO 2020, certain relevant concepts could not be reused directly. In these cases, NFDIcore-specific classes—such as `dataset`, `document`, and `identifier`—were introduced to fill the gaps.
18+
- **Schema.org:** In CTO, schema.org was particularly used for describing creative works and to ensure the alignment with the Culture Information Portal’s existing data model.
19+
- Further reused ontologies and vocabularies include the Software Ontology (SWO), Data Catalog Vocabulary (DCAT), and skos.
1520

16-
## Key Concepts
17-
18-
### Classes
19-
20-
### Properties
21+
## Core Structure
22+
![Basic Structure](assets/core-structure.jpg)
2123

24+
The core structure of CTO consists of four main elements. `schema:DataFeed` represents a data feed in the Research Information Graph (RIG). This data feed is created in the Culture Information Portal using TYPO3 and its LOD extension. The metadata associated with the data feed include contact persons, export formats, licenses, and related projects and organizations. For each item (`cto: source item`) in the data feed, a permanent ARK (`schema:DataFeedItem`) is created as its stable reference entity. The `schema:DataFeedItem` does not contain content-related information about the source item, aside from a license issued by NFDI4Culture and the creation and modification dates. This stable reference entity functions as a persistent identifier in the knowledge graph, remaining valid even if the content of the source item is changed or deleted. The main content-related metadata are associated with `cto: source item`. This includes associated media, related entities and their identifiers in external vocabularies, temporal data, and subject-area-specific metadata, such as musical incipits. Furthermore, it is possible to express which real-world entity `cto: source item` is about. These entities could be sculptures, buildings, persons, books, etc. However, since this information is often not provided in the research data, this aspect currently serves as a proof of concept and is only materialized when clearly stated by the data providers.
2225

mkdocs.yml

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,11 @@ theme:
55
name: material
66
custom_dir: docs/overrides
77
nav:
8-
- Introduction: index.md
9-
- Ontology: /4culture/ontology/
8+
- Intro and Metadata: index.md
9+
- Widoco Documentation: /4culture/ontology/
1010
- NFDI Context: nfdi-context.md
11-
- Ontology Structure: structure.md
11+
- Scope and Structure: structure.md
12+
- Domain Examples: domain-examples.md
1213

1314
# - Sample Applications: rdg.md
1415
# - Sample Queries: queries.md

0 commit comments

Comments
 (0)