[](https://www.repostatus.org/#active)
[](https://github.com/pre-commit/pre-commit)
[](https://results.pre-commit.ci/latest/github/OntoUML/ontouml-vocabulary-lib/main)
# ontouml-vocabulary-lib
<p align="center"><img src="https://raw.githubusercontent.com/OntoUML/ontouml-vocabulary-lib/main/resources/logo-ontouml-vocabulary-lib-reduced.png" width="740"></p>
**📦 PyPI Package:**
The library is conveniently [available as a PyPI package](https://pypi.org/project/ontouml-vocabulary-lib/), 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](https://w3id.org/ontouml/vocabulary-lib/docs) available for this project.
## Contents
<!-- TOC -->
* [ontouml-vocabulary-lib](#ontouml-vocabulary-lib)
* [Contents](#contents)
* [Installation and Use](#installation-and-use)
* [Prerequisites](#prerequisites)
* [Instructions for Users](#instructions-for-users)
* [Instructions for Contributors](#instructions-for-contributors)
* [Technological Background](#technological-background)
* [The OntoUML Vocabulary](#the-ontouml-vocabulary)
* [The RDFLib](#the-rdflib)
* [Concepts](#concepts)
* [OntoUML Terms](#ontouml-terms)
* [Methods](#methods)
* [Usage Examples](#usage-examples)
* [OntoUML Constants](#ontouml-constants)
* [Usage Examples](#usage-examples-1)
* [Code Testing](#code-testing)
* [How to Contribute](#how-to-contribute)
* [Reporting Issues](#reporting-issues)
* [Code Contributions](#code-contributions)
* [Test Contributions](#test-contributions)
* [General Guidelines](#general-guidelines)
* [License](#license)
* [Author](#author)
<!-- TOC -->
## 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](https://www.python.org/downloads/).
### Instructions for Users
1. Install ontouml-vocabulary-lib: Execute the following command to install the library:
```shell
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:
```python
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](https://python-poetry.org/) for dependency management. If not installed, refer to Poetry’s [documentation](https://python-poetry.org/docs/#installation) for installation instructions. Then, install all dependencies with:
```shell
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](https://rdflib.readthedocs.io/en/stable/) graphs.
The library complies with the [OntoUML vocabulary](https://w3id.org/ontouml/vocabulary)—ensuring compatibility with its [version 1.1.0](https://w3id.org/ontouml/vocabulary/v1.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](https://w3id.org/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](https://w3id.org/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](https://rdflib.readthedocs.io/en/stable/) is a Python library that provides a comprehensive toolkit for working with [Resource Description Framework (RDF)](https://www.w3.org/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](https://rdflib.readthedocs.io/en/stable/apidocs/rdflib.namespace.html#rdflib.namespace.Namespace)). 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](https://rdflib.readthedocs.io/en/stable/rdf_terms.html#uriref) 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:
```python
# 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](https://rdflib.readthedocs.io/en/stable/rdf_terms.html#uriref), 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
```python
# 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:
```python
# 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**:
```python
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:
```txt
(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**:
```python
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:
```txt
Is https://w3id.org/ontouml#kind a base sortal stereotype?
No
```
3. Comparing Values between Different Sets of Stereotypes:
```python
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:
```txt
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:
```bash
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](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new).
- If you notice any discrepancies in the documentation created with the aid of AI, feel free to [report them by opening an issue](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new).
### 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](https://github.com/OntoUML/ontouml-vocabulary-lib/blob/main/LICENSE) file for details.
## Author
This project is an initiative of the [Semantics, Cybersecurity & Services (SCS) Group](https://www.utwente.nl/en/eemcs/scs/) at the [University of Twente](https://www.utwente.nl/), The Netherlands. The main developer is:
- Pedro Paulo Favato Barcelos [[GitHub](https://github.com/pedropaulofb)] [[LinkedIn](https://www.linkedin.com/in/pedro-paulo-favato-barcelos/)]
Feel free to reach out using the provided links. For inquiries, contributions, or to report any issues, you can [open a new issue](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new) on this repository.
Raw data
{
"_id": null,
"home_page": "https://w3id.org/ontouml/vocabulary-lib",
"name": "ontouml_vocabulary_lib",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.09,<4.0",
"maintainer_email": "",
"keywords": "semantic-web,knowledge-graph,ontouml,ontology-driven-development,ontouml-vocabulary,rdflib",
"author": "Pedro Paulo F. Barcelos",
"author_email": "p.p.favatobarcelos@utwente.nl",
"download_url": "https://files.pythonhosted.org/packages/4b/f2/eb69e03eb5879b12227b01db0261f4c531244de6cbd5e0d2c5ce163b67c9/ontouml_vocabulary_lib-1.0.1.tar.gz",
"platform": null,
"description": "[](https://www.repostatus.org/#active)\n\n\n\n\n\n\n\n\n\n[](https://github.com/pre-commit/pre-commit)\n[](https://results.pre-commit.ci/latest/github/OntoUML/ontouml-vocabulary-lib/main)\n\n\n\n# ontouml-vocabulary-lib\n\n<p align=\"center\"><img src=\"https://raw.githubusercontent.com/OntoUML/ontouml-vocabulary-lib/main/resources/logo-ontouml-vocabulary-lib-reduced.png\" width=\"740\"></p>\n\n**\ud83d\udce6 PyPI Package:**\nThe library is conveniently [available as a PyPI package](https://pypi.org/project/ontouml-vocabulary-lib/), allowing users to easily import it into other RDFLib/Python projects.\n\n**\ud83d\udcda Documentation:**\nFor inquiries and further information, please refer to the [comprehensive docstring-generated documentation](https://w3id.org/ontouml/vocabulary-lib/docs) available for this project.\n\n## Contents\n\n<!-- TOC -->\n* [ontouml-vocabulary-lib](#ontouml-vocabulary-lib)\n * [Contents](#contents)\n * [Installation and Use](#installation-and-use)\n * [Prerequisites](#prerequisites)\n * [Instructions for Users](#instructions-for-users)\n * [Instructions for Contributors](#instructions-for-contributors)\n * [Technological Background](#technological-background)\n * [The OntoUML Vocabulary](#the-ontouml-vocabulary)\n * [The RDFLib](#the-rdflib)\n * [Concepts](#concepts)\n * [OntoUML Terms](#ontouml-terms)\n * [Methods](#methods)\n * [Usage Examples](#usage-examples)\n * [OntoUML Constants](#ontouml-constants)\n * [Usage Examples](#usage-examples-1)\n * [Code Testing](#code-testing)\n * [How to Contribute](#how-to-contribute)\n * [Reporting Issues](#reporting-issues)\n * [Code Contributions](#code-contributions)\n * [Test Contributions](#test-contributions)\n * [General Guidelines](#general-guidelines)\n * [License](#license)\n * [Author](#author)\n<!-- TOC -->\n\n## Installation and Use\n\n### Prerequisites\n\nEnsure 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](https://www.python.org/downloads/).\n\n### Instructions for Users\n\n1. Install ontouml-vocabulary-lib: Execute the following command to install the library:\n\n```shell\npip install ontouml-vocabulary-lib\n```\n\nAll dependencies will be installed automatically.\n\n2. Usage: To use ontouml-vocabulary-lib, you simply have to make the following import in your Python code:\n\n```python\nfrom ontouml_vocabulary_lib import *\n```\n\nNow all concepts\n\n### Instructions for Contributors\n\n1. **Fork the Project:**\n Fork the `ontouml-vocabulary-lib` repository to your own GitHub account.\n\n2. **Clone and Setup:**\n Clone your forked repository and navigate to the project directory.\n\n3. **Install Dependencies:**\n Use [Poetry](https://python-poetry.org/) for dependency management. If not installed, refer to Poetry\u2019s [documentation](https://python-poetry.org/docs/#installation) for installation instructions. Then, install all dependencies with:\n\n```shell\npoetry install\n```\n\nNow, you're ready to make enhancements or fixes and contribute back to ontouml-vocabulary-lib!\n\n## Technological Background\n\nThe **ontouml-vocabulary-lib** is a Python library tailored for managing OntoUML concepts on [RDFLib](https://rdflib.readthedocs.io/en/stable/) graphs.\n\nThe library complies with the [OntoUML vocabulary](https://w3id.org/ontouml/vocabulary)\u2014ensuring compatibility with its [version 1.1.0](https://w3id.org/ontouml/vocabulary/v1.1.0).\n\n### The OntoUML Vocabulary\n\nOntoUML 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](https://w3id.org/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](https://w3id.org/ontouml/metamodel).\n\nThe 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.\n\n### The RDFLib\n\n[RDFLib](https://rdflib.readthedocs.io/en/stable/) is a Python library that provides a comprehensive toolkit for working with [Resource Description Framework (RDF)](https://www.w3.org/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.\n\n## Concepts\n\nWhen 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.\n\n### OntoUML Terms\n\nThe `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](https://rdflib.readthedocs.io/en/stable/apidocs/rdflib.namespace.html#rdflib.namespace.Namespace)). Similarly, with this library, you can access OntoUML terms directly, e.g., `OntoUML.kind`.\n\nAdditionally, 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](https://rdflib.readthedocs.io/en/stable/rdf_terms.html#uriref) is a unique identifier used to identify resources in semantic web technologies.\n\n#### Methods\n\nHere are the methods provided by the `OntoUML` class:\n\n- **`get_list_all`**: Retrieves all OntoUML terms as a list of `URIRef` objects.\n- **`get_namespace`**: Returns the OntoUML namespace as a string.\n- **`get_term`**: Given a term name as a string, retrieves the corresponding OntoUML term as a `URIRef`.\n\n| Method Name | Description | Arguments | Return Type |\n|-----------------|------------------------------|------------------|-------------------|\n| `get_list_all` | Lists all OntoUML terms | None | List of `URIRef` |\n| `get_namespace` | Gets OntoUML namespace | None | `str` |\n| `get_term` | Gets a specific OntoUML term | `term_name: str` | `URIRef` or Error |\n\n#### Usage Examples\n\nBelow are some practical examples illustrating how to utilize the OntoUML Terms concept.\n\n1. Accessing a specific OntoUML Term:\n\n```python\n# Accessing a specific OntoUML term\nfrom ontouml_vocabulary_lib import OntoUML\nmy_ontouml_class = OntoUML.Class\n\n# Output\nprint(my_ontouml_class) # https://w3id.org/ontouml#Class\n```\n\nThe result \"https://w3id.org/ontouml#Class\" from box 1 is of [type URIRef in RDFLib](https://rdflib.readthedocs.io/en/stable/rdf_terms.html#uriref), 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.\n\n2. Accessing all OntoUML Terms\n\n```python\n# Accessing all OntoUML terms\nfrom ontouml_vocabulary_lib import OntoUML\nall_terms = OntoUML.get_list_all()\n\n# Output\nprint(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'), ...]\n```\n\nAs can be seen, the result is a list of URIRefs.\n\n3. Accessing the OntoUML Vocabulary base namespace\n\nThe `get_namespace` method is used to retrieve the namespace URI for OntoUML Vocabulary. Here is an example demonstrating how to use this method:\n\n```python\n# Getting the namespace for OntoUML\nfrom ontouml_vocabulary_lib import OntoUML\nnamespace_uri = OntoUML.get_namespace()\n\n# Output\nprint(namespace_uri) # https://w3id.org/ontouml#\n```\n\nThese methods ease the process of working with OntoUML terms, making it intuitive to use them within your projects.\n\n### OntoUML Constants\n\nThe `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.\n\n- **Class Stereotypes**:\n - Base Sortal Class Stereotypes: `ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES`\n - Ultimate Sortal Class Stereotypes: `ONTOUML_ULTIMATE_SORTAL_CLASS_STEREOTYPES`\n - Sortal Class Stereotypes: `ONTOUML_SORTAL_CLASS_STEREOTYPES`\n - Non-Sortal Class Stereotypes: `ONTOUML_NON_SORTAL_CLASS_STEREOTYPES`\n - Abstract Class Stereotypes: `ONTOUML_ABSTRACT_CLASS_STEREOTYPES`\n - Rigid Class Stereotypes: `ONTOUML_RIGID_CLASS_STEREOTYPES`\n - Anti-Rigid Class Stereotypes: `ONTOUML_ANTI_RIGID_CLASS_STEREOTYPES`\n - Semi-Rigid Class Stereotypes: `ONTOUML_SEMI_RIGID_CLASS_STEREOTYPES`\n - All Class Stereotypes: `ONTOUML_CLASS_STEREOTYPES`\n\n- **Miscellaneous Stereotypes**:\n - Relation Stereotypes: `ONTOUML_RELATION_STEREOTYPES`\n - Property Stereotypes: `ONTOUML_PROPERTY_STEREOTYPES`\n - Aggregation Kinds: `ONTOUML_AGGREGATION_KINDS`\n - Ontological Natures: `ONTOUML_ONTOLOGICAL_NATURES`\n - Abstract Elements: `ONTOUML_ABSTRACT_ELEMENTS`\n - Concrete Elements: `ONTOUML_CONCRETE_ELEMENTS`\n\n#### Usage Examples\n\nBelow 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.\n\n1. **Listing All Base Sortal Class Stereotypes**:\n```python\nfrom ontouml_vocabulary_lib.constants.constants_classes import *\n\n# Listing all base sortal class stereotypes\n# The tuple contains stereotypes that are considered as base sortals in OntoUML\nprint(ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES)\n```\n\nOutput:\n```txt\n(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'))\n```\n\n2. **Validating an OntoUML Concept against a Set of Stereotypes**:\n\n```python\nfrom ontouml_vocabulary_lib.constants.constants_classes import *\nfrom ontouml_vocabulary_lib.terms import OntoUML\n\n# A given OntoUML Concept (Assume OntoUML.kind is of type URIRef)\ngiven_ontouml_concept = OntoUML.kind\n\n# Validate if it's a base sortal\n# Checking if the given OntoUML concept is part of the base sortal class stereotypes\nis_base_sortal = given_ontouml_concept in ONTOUML_BASE_SORTAL_CLASS_STEREOTYPES\n\n# Output the validation result\nprint(f\"Is {given_ontouml_concept} a base sortal stereotype?\")\nprint(\"Yes\" if is_base_sortal else \"No\")\n```\nOutput:\n```txt\nIs https://w3id.org/ontouml#kind a base sortal stereotype?\nNo\n```\n3. Comparing Values between Different Sets of Stereotypes:\n\n```python\nfrom ontouml_vocabulary_lib.constants.constants_classes import *\n\n# Retrieve all ultimate sortals and rigid types\nall_ultimate_sortal_classes = ONTOUML_ULTIMATE_SORTAL_CLASS_STEREOTYPES\nall_rigid_types = ONTOUML_RIGID_CLASS_STEREOTYPES\n\n# Find common stereotypes between both, if any\n# Using set intersection to find common elements between the two tuples\ncommon_stereotypes = set(all_ultimate_sortal_classes).intersection(set(all_rigid_types))\n\n# Output common stereotypes\nprint(\"Common stereotypes between Ultimate Sortals and Rigid types:\")\nprint(common_stereotypes)\n```\n\nOutput:\n```txt\nCommon stereotypes between Ultimate Sortals and Rigid types:\n{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')}\n```\n\n## Code Testing\n\nThe 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:\n\n```bash\nontouml-vocabulary-lib> pytest .\\ontouml_vocabulary_lib\\tests\n```\n\n## How to Contribute\n\n### Reporting Issues\n- If you encounter a bug or wish to suggest a feature, please [open a new issue](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new).\n- If you notice any discrepancies in the documentation created with the aid of AI, feel free to [report them by opening an issue](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new).\n\n### Code Contributions\n1. Fork the project repository and create a new feature branch for your work: `git checkout -b feature/YourFeatureName`.\n2. Make and commit your changes with descriptive commit messages.\n3. Push your work back up to your fork: `git push origin feature/YourFeatureName`.\n4. Submit a pull request to propose merging your feature branch into the main project repository.\n\n### Test Contributions\n- Enhance the project's reliability by adding new tests or improving existing ones.\n\n### General Guidelines\n- Ensure your code follows our coding standards.\n- Update the documentation as necessary.\n- Make sure your contributions do not introduce new issues.\n\nWe appreciate your time and expertise in contributing to this project!\n\n## License\n\nThis project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/OntoUML/ontouml-vocabulary-lib/blob/main/LICENSE) file for details.\n\n## Author\n\nThis project is an initiative of the [Semantics, Cybersecurity & Services (SCS) Group](https://www.utwente.nl/en/eemcs/scs/) at the [University of Twente](https://www.utwente.nl/), The Netherlands. The main developer is:\n\n- Pedro Paulo Favato Barcelos [[GitHub](https://github.com/pedropaulofb)] [[LinkedIn](https://www.linkedin.com/in/pedro-paulo-favato-barcelos/)]\n\nFeel free to reach out using the provided links. For inquiries, contributions, or to report any issues, you can [open a new issue](https://github.com/OntoUML/ontouml-vocabulary-lib/issues/new) on this repository.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "OntoUML Python Library",
"version": "1.0.1",
"project_urls": {
"Documentation": "https://w3id.org/ontouml/vocabulary-lib/docs",
"Homepage": "https://w3id.org/ontouml/vocabulary-lib",
"PyPi Project": "https://pypi.org/project/ontouml-vocabulary-lib/",
"Repository": "https://w3id.org/ontouml/vocabulary-lib"
},
"split_keywords": [
"semantic-web",
"knowledge-graph",
"ontouml",
"ontology-driven-development",
"ontouml-vocabulary",
"rdflib"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "33abed82d25ba1a8e5d74d0342fd86b1b66fcb469c8999ada338f8cea76b0dfe",
"md5": "2b2a68599b6b975863104b2324433da7",
"sha256": "6ba97bcf74be699c31d80013861e4758c10e8114d27f79bdb56b39a4084bcde4"
},
"downloads": -1,
"filename": "ontouml_vocabulary_lib-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b2a68599b6b975863104b2324433da7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.09,<4.0",
"size": 17982,
"upload_time": "2023-10-14T20:26:18",
"upload_time_iso_8601": "2023-10-14T20:26:18.515659Z",
"url": "https://files.pythonhosted.org/packages/33/ab/ed82d25ba1a8e5d74d0342fd86b1b66fcb469c8999ada338f8cea76b0dfe/ontouml_vocabulary_lib-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4bf2eb69e03eb5879b12227b01db0261f4c531244de6cbd5e0d2c5ce163b67c9",
"md5": "69d73a362ab7780ef5dce0aec617d953",
"sha256": "3d5e11a56e8ee46f766719ba24daba3918c0487c31f0869508d8d61d87a2dc93"
},
"downloads": -1,
"filename": "ontouml_vocabulary_lib-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "69d73a362ab7780ef5dce0aec617d953",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.09,<4.0",
"size": 16786,
"upload_time": "2023-10-14T20:26:20",
"upload_time_iso_8601": "2023-10-14T20:26:20.256013Z",
"url": "https://files.pythonhosted.org/packages/4b/f2/eb69e03eb5879b12227b01db0261f4c531244de6cbd5e0d2c5ce163b67c9/ontouml_vocabulary_lib-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-14 20:26:20",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ontouml_vocabulary_lib"
}
JSON