ontouml-vocabulary-lib

The OntoUML Vocabulary Library is a Python library crafted for handling OntoUML vocabulary's concepts on RDFLib graphs. This library advances the utilization of OntoUML in Semantic Web applications, bridging the gap between conceptual modeling in OntoUML and the Semantic Web technologies.

📦 PyPI Package: The library is conveniently available as a PyPI package, allowing users to easily import it into other RDFLib/Python projects.

📚 Documentation: For inquiries and further information, please refer to the comprehensive docstring-generated documentation available for this project.

Contents

• ontouml-vocabulary-lib
  • Contents
  • Installation and Use
    • Prerequisites
    • Instructions for Users
    • Instructions for Contributors
  • Technological Background
    • The OntoUML Vocabulary
    • The RDFLib
  • Concepts
    • OntoUML Terms
      • Methods
      • Usage Examples
    • OntoUML Constants
      • Usage Examples
  • Code Testing
  • How to Contribute
    • Reporting Issues
    • Code Contributions
    • Test Contributions
    • General Guidelines
  • License
  • Author

Installation and Use

Prerequisites

Ensure you have Python installed on your system before utilizing the ontouml-vocabulary-lib. It has been tested with Python versions 3.9 to 3.11 on Mac, Windows, and Linux. If not installed, download and install Python.

Instructions for Users

1. Install ontouml-vocabulary-lib: Execute the following command to install the library:

pip install ontouml-vocabulary-lib

All dependencies will be installed automatically.

2. Usage: To use ontouml-vocabulary-lib, you simply have to make the following import in your Python code:

from ontouml_vocabulary_lib import *

Now all concepts

Instructions for Contributors

1. Fork the Project: Fork the ontouml-vocabulary-lib repository to your own GitHub account.

2. Clone and Setup: Clone your forked repository and navigate to the project directory.

3. Install Dependencies: Use Poetry for dependency management. If not installed, refer to Poetry’s documentation for installation instructions. Then, install all dependencies with:

poetry install

Now, you're ready to make enhancements or fixes and contribute back to ontouml-vocabulary-lib!

Technological Background

The ontouml-vocabulary-lib is a Python library tailored for managing OntoUML concepts on RDFLib graphs.

The library complies with the OntoUML vocabulary—ensuring compatibility with its version 1.1.0.

The OntoUML Vocabulary

OntoUML is a modeling language that has been developed to support the representation of domain ontologies in the conceptual modeling phase of system development. The OntoUML Vocabulary, on the other hand, is an OWL vocabulary designed to allow the serialization and exchanging of OntoUML models in conformance with the OntoUML Metamodel.

The OntoUML Vocabulary provides the necessary resources for mapping OntoUML models to OWL ontologies, which is a crucial step for utilizing OntoUML in Semantic Web applications.

The RDFLib

RDFLib is a Python library that provides a comprehensive toolkit for working with Resource Description Framework (RDF) data, which is fundamental to the Semantic Web and linked data technologies. RDFLib enables developers to create, manipulate, and query RDF graphs, making it a powerful tool for managing knowledge graphs within the Python ecosystem.

Concepts

When working with the ontouml-vocabulary-lib library, users will primarily engage with five fundamental concepts, each contributing to the seamless manipulation of OntoUML models and RDF graphs. These key concepts include OUTerm, which represents OntoUML terms and ensures semantic consistency; OUElement, serving as a container for various OntoUML model elements and maintaining their structured details; OUGraph, a pivotal orchestrator for OntoUML vocabulary elements within RDF graphs, enabling systematic access and manipulation; OUEnumeration, which provides organized enumerations for OntoUML concepts and stereotypes; and Graph, a core concept from RDFLib, offering a structured framework for managing RDF data. Together, these concepts empower users to efficiently handle OntoUML models, navigate their semantic complexities, and interact with RDF graphs, making ontouml-vocabulary-lib a valuable tool for ontology-driven conceptual modeling and semantic web technologies.

OntoUML Terms

The OntoUML class in this library encapsulates the OntoUML vocabulary, enabling easy interaction with ontological terms to enhance the accuracy and consistency of your model. This class is designed to operate similarly to how RDFLib handles vocabularies like OWL, RDF, and RDFS. In RDFLib, you can access concepts from these vocabularies directly, for instance, RDFS.subClassOf or RDF.type (for more information, access here). Similarly, with this library, you can access OntoUML terms directly, e.g., OntoUML.kind.

Additionally, this library integrates the URIRef concept from RDFLib, which allows for the clear and unambiguous definition of relationships and properties through universal resource identifiers (URIs). A URIRef in RDFLib is a unique identifier used to identify resources in semantic web technologies.

Methods

Here are the methods provided by the OntoUML class:

• get_list_all: Retrieves all OntoUML terms as a list of URIRef objects.
• get_namespace: Returns the OntoUML namespace as a string.
• get_term: Given a term name as a string, retrieves the corresponding OntoUML term as a URIRef.

Method Name	Description	Arguments	Return Type
get_list_all	Lists all OntoUML terms	None	List of URIRef
get_namespace	Gets OntoUML namespace	None	str
get_term	Gets a specific OntoUML term	term_name: str	URIRef or Error

Usage Examples

Below are some practical examples illustrating how to utilize the OntoUML Terms concept.

1. Accessing a specific OntoUML Term:

# Accessing a specific OntoUML term
from ontouml_vocabulary_lib import OntoUML
my_ontouml_class = OntoUML.Class

# Output
print(my_ontouml_class)  # https://w3id.org/ontouml#Class

The result "https://w3id.org/ontouml#Class" from box 1 is of type URIRef in RDFLib, which represents a Uniform Resource Identifier (URI) within the Resource Description Framework (RDF) data model, serving as a unique identifier for resources in semantic web technologies.

2. Accessing all OntoUML Terms

# Accessing all OntoUML terms
from ontouml_vocabulary_lib import OntoUML
all_terms = OntoUML.get_list_all()

# Output
print(all_terms)  # [rdflib.term.URIRef('https://w3id.org/ontouml#abstract'), rdflib.term.URIRef('https://w3id.org/ontouml#abstractNature'), rdflib.term.URIRef('https://w3id.org/ontouml#aggregationKind'), ...]

As can be seen, the result is a list of URIRefs.

3. Accessing the OntoUML Vocabulary base namespace

The get_namespace method is used to retrieve the namespace URI for OntoUML Vocabulary. Here is an example demonstrating how to use this method:

# Getting the namespace for OntoUML
from ontouml_vocabulary_lib import OntoUML
namespace_uri = OntoUML.get_namespace()

# Output
print(namespace_uri)  # https://w3id.org/ontouml#

These methods ease the process of working with OntoUML terms, making it intuitive to use them within your projects.

OntoUML Constants

The ontouml-vocabulary-lib library includes a set of predefined constants that group OntoUML stereotypes into semantically relevant categories, allowing for a structured approach to accessing and utilizing OntoUML concepts in your Python programs. These constants are organized into tuples with alphabetically sorted elements. Each tuple represents a different categorization of OntoUML stereotypes.

• Class Stereotypes:

  • Base Sortal Class Stereotypes: ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES
  • Ultimate Sortal Class Stereotypes: ONTOUML_ULTIMATE_SORTAL_CLASS_STEREOTYPES
  • Sortal Class Stereotypes: ONTOUML_SORTAL_CLASS_STEREOTYPES
  • Non-Sortal Class Stereotypes: ONTOUML_NON_SORTAL_CLASS_STEREOTYPES
  • Abstract Class Stereotypes: ONTOUML_ABSTRACT_CLASS_STEREOTYPES
  • Rigid Class Stereotypes: ONTOUML_RIGID_CLASS_STEREOTYPES
  • Anti-Rigid Class Stereotypes: ONTOUML_ANTI_RIGID_CLASS_STEREOTYPES
  • Semi-Rigid Class Stereotypes: ONTOUML_SEMI_RIGID_CLASS_STEREOTYPES
  • All Class Stereotypes: ONTOUML_CLASS_STEREOTYPES

• Miscellaneous Stereotypes:

  • Relation Stereotypes: ONTOUML_RELATION_STEREOTYPES
  • Property Stereotypes: ONTOUML_PROPERTY_STEREOTYPES
  • Aggregation Kinds: ONTOUML_AGGREGATION_KINDS
  • Ontological Natures: ONTOUML_ONTOLOGICAL_NATURES
  • Abstract Elements: ONTOUML_ABSTRACT_ELEMENTS
  • Concrete Elements: ONTOUML_CONCRETE_ELEMENTS

Usage Examples

Below are some practical examples illustrating how to utilize the OntoUML Terms concept. In these examples, we are utilizing the * import statement to import all the constants from the constants_classes and constants_misc modules within the ontouml_vocabulary_lib.constants sub-package. Ensure you have the ontouml-vocabulary-lib library installed and accessible in your environment.

1. Listing All Base Sortal Class Stereotypes:

from ontouml_vocabulary_lib.constants.constants_classes import *

# Listing all base sortal class stereotypes
# The tuple contains stereotypes that are considered as base sortals in OntoUML
print(ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES)

Output:

(rdflib.term.URIRef('https://w3id.org/ontouml#historicalRole'), rdflib.term.URIRef('https://w3id.org/ontouml#phase'), rdflib.term.URIRef('https://w3id.org/ontouml#role'), rdflib.term.URIRef('https://w3id.org/ontouml#subkind'))

2. Validating an OntoUML Concept against a Set of Stereotypes:

from ontouml_vocabulary_lib.constants.constants_classes import *
from ontouml_vocabulary_lib.terms import OntoUML

# A given OntoUML Concept (Assume OntoUML.kind is of type URIRef)
given_ontouml_concept = OntoUML.kind

# Validate if it's a base sortal
# Checking if the given OntoUML concept is part of the base sortal class stereotypes
is_base_sortal = given_ontouml_concept in ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES

# Output the validation result
print(f"Is {given_ontouml_concept} a base sortal stereotype?")
print("Yes" if is_base_sortal else "No")

Output:

Is https://w3id.org/ontouml#kind a base sortal stereotype?
No

3. Comparing Values between Different Sets of Stereotypes:

from ontouml_vocabulary_lib.constants.constants_classes import *

# Retrieve all ultimate sortals and rigid types
all_ultimate_sortal_classes = ONTOUML_ULTIMATE_SORTAL_CLASS_STEREOTYPES
all_rigid_types = ONTOUML_RIGID_CLASS_STEREOTYPES

# Find common stereotypes between both, if any
# Using set intersection to find common elements between the two tuples
common_stereotypes = set(all_ultimate_sortal_classes).intersection(set(all_rigid_types))

# Output common stereotypes
print("Common stereotypes between Ultimate Sortals and Rigid types:")
print(common_stereotypes)

Output:

Common stereotypes between Ultimate Sortals and Rigid types:
{rdflib.term.URIRef('https://w3id.org/ontouml#quality'), rdflib.term.URIRef('https://w3id.org/ontouml#collective'), rdflib.term.URIRef('https://w3id.org/ontouml#relator'), rdflib.term.URIRef('https://w3id.org/ontouml#kind'), rdflib.term.URIRef('https://w3id.org/ontouml#quantity'), rdflib.term.URIRef('https://w3id.org/ontouml#mode')}

Code Testing

The code provided has undergone rigorous testing to ensure its reliability and correctness. The tests can be found in the 'tests' directory of the project. To run the tests, navigate to the project root directory and execute the following command:

ontouml-vocabulary-lib> pytest .\ontouml_vocabulary_lib\tests

How to Contribute

Reporting Issues

• If you encounter a bug or wish to suggest a feature, please open a new issue.
• If you notice any discrepancies in the documentation created with the aid of AI, feel free to report them by opening an issue.

Code Contributions

1. Fork the project repository and create a new feature branch for your work: git checkout -b feature/YourFeatureName.
2. Make and commit your changes with descriptive commit messages.
3. Push your work back up to your fork: git push origin feature/YourFeatureName.
4. Submit a pull request to propose merging your feature branch into the main project repository.

Test Contributions

• Enhance the project's reliability by adding new tests or improving existing ones.

General Guidelines

• Ensure your code follows our coding standards.
• Update the documentation as necessary.
• Make sure your contributions do not introduce new issues.

We appreciate your time and expertise in contributing to this project!

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Author

This project is an initiative of the Semantics, Cybersecurity & Services (SCS) Group at the University of Twente, The Netherlands. The main developer is:

• Pedro Paulo Favato Barcelos [GitHub] [LinkedIn]

Feel free to reach out using the provided links. For inquiries, contributions, or to report any issues, you can open a new issue on this repository.