Partial work results of Ben Wegener's internship

.gitignore

@@ -0,0 +1,3 @@
+.vscode
+.idea
+*.log

Converter/conceptDrescriptionParser.py

@@ -0,0 +1,64 @@
+from xml.etree import ElementTree
+
+
+class AAS:
+    id_short = "{http://www.admin-shell.io/aas/1/0}idShort"
+    description = "{http://www.admin-shell.io/aas/1/0}description"
+    identification = "{http://www.admin-shell.io/aas/1/0}identification"
+    embedded_data_specification = "{http://www.admin-shell.io/aas/1/0}embeddedDataSpecification"
+    data_specification_content = "{http://www.admin-shell.io/aas/1/0}dataSpecificationContent"
+    preferred_name = "{http://www.admin-shell.io/IEC61360/1/0}preferredName"
+    short_name = "{http://www.admin-shell.io/IEC61360/1/0}shortName"
+    unit = "{http://www.admin-shell.io/IEC61360/1/0}unit"
+    source_of_definiton = "{http://www.admin-shell.io/IEC61360/1/0}sourceOfDefinition"
+    datatype = "{http://www.admin-shell.io/IEC61360/1/0}dataType"
+    definition = "{http://www.admin-shell.io/IEC61360/1/0}definition"
+
+
+for concept_description in ElementTree.parse("conceptDescriptions.xml").getroot():
+
+    uri = None
+    id_short = None
+    preferred_name = None
+    short_name = None
+    definition = None
+    isCaseOf = None
+
+    for child in concept_description:
+        if child.tag == AAS.id_short:
+            id_short = child.text
+        elif child.tag == AAS.identification:
+            uri = child.text
+        elif child.tag == AAS.embedded_data_specification:
+            for prop in child:
+                if prop.tag == AAS.data_specification_content:
+                    for propchild in prop[0]:
+                        if propchild.tag == AAS.preferred_name:
+                            preferred_name = propchild.text
+                        elif propchild.tag == AAS.short_name:
+                            short_name = propchild.text
+                        elif propchild.tag == AAS.datatype:
+                            isCaseOf = str(propchild.text).lower()
+                        elif propchild.tag == AAS.definition:
+                            definition = propchild[0].text
+    rdf = ""
+    rdf += "<"+str(uri)+">\n"
+    rdf += "    a rami:conceptDictionary ;\n"
+    rdf += "    rami:idShort \""+id_short+"\"^^xsd:string ;\n"
+    rdf += "    rdfs:label \""+id_short+"-ConceptDictionary\"^^xsd:string ;\n"
+    rdf += "    rdfs:coment \"The ConceptDictionary contains the ConceptDescription of the property '"+str(id_short)+"'\"@en ;\n"
+    rdf += "    rami:hasConceptDescription [\n"
+    rdf += "        a rami:conceptDescription ;\n"
+    if preferred_name is not None and str(preferred_name).strip(" ").strip("\n") is not "" :
+        rdf += "        rami:preferredName \""+preferred_name+"\"@en ;\n"
+    else :
+        if short_name is not None:
+            rdf += "        rami:preferredName \"" + short_name + "\"@en ;\n"
+    if short_name is not None:
+        rdf += "        rami:shortName \""+short_name+"\"^^xsd:string ;\n"
+    if definition is not None:
+        rdf += "        rami:definition \""+definition+"\"@en ;\n"
+    rdf += "    ] ; \n"
+    rdf += "    rami:hasDataSpecification _:DataSpecificationIEC61360 ."
+
+    print(rdf)

README.md

@@ -1,2 +1,49 @@
-# RAMIVocabulary
-Repository containing the developing of the RAMI vocabulary
+# RAMIOntology
+Repository containing the developing of the RAMI vocabulary.
+
+The Reference Architecture Model Industry 4.0 that was developed by the [**`Platform Industry 4.0`**](https://www.plattform-i40.de/PI40/Navigation/DE/Home/home.html) is a three-dimensional map showing how to approach the issue of Industry 4.0 in a structured manner. RAMI ensures that all participants involved in Industry 4.0 discussions understand each other. The concept of the RAMI is based on data and is closely associated with the Industrial Data Space (IDS).
+
+The main question is: *Who provides the data for intepretation?* It is the "digital-twin" of each asset. The official name for this is **Asset-Administration-Shell** (AAS).
+The AAS provides organizations the opportunity to share data and exchange it in "value chains"/"value networks".
+
+![example](https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ0v_gGsBH7qGsdDBYS_z-OuqsvYXvjgImxHlZLQZ_Rv6oCtdqjYQ "AAS example")
+
+The RAMIOntology is based on the document [**`details_of_the_AAS.pdf`**](https://www.zvei.org/fileadmin/user_upload/Presse_und_Medien/Publikationen/2018/November/Details_of-the_Asset_Administration_Shell/Details_of-the_Asset_Administration_Shell.PDF). This document specifies the structural principles of the AAS and and outlines a metamodel. The goal of this document was to specify mandatory and optional attributes using RDF-serialization. Furthermore it was necessary to check all dependecies and modify the metamodel to provide a transparent model that can be integrated into the reference architecture model.
+
+The [**`shapes`**](schema/) in this repository are available for validation and are all based on the metamodel. There were some iterations, so they don't match 100%. The annotated version of this document can be downloaded [here](http://116.203.149.114/2018-verwaltungsschale-im-detail-annotated-umls.pdf).
+
+The Ontology contains the vocabulary that is necessary for the RAMI-AAS.
+
+Use the [shacl-playground](http://shacl.org/playground/) to check if your RDF-model is conform to the shape.
+
+We tested some shapes using the shacl playground. The tested files are stored with their output in the [tests-directory](tests).
+
+***
+## The Example
+The **`Raspberry Pi 3b+`** was used as an example of an asset that is described in an AAS
+- we created a valid [**`AASX-archive`**](RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus.aasx)
+    - this AASX-archive contains a [**`XML-model`**](RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/aasx/iais_fraunhofer_de_en_aas_examples/iais_fraunhofer_de_en_aas_examples_raspberry_pi_3b_plus.aas.xml) which contains all conceptDescriptions and information about the asset
+- we created also a [**`RDF-model`**](RaspberryPi3bPlus_EXAMPLE/rdfttlsolution.ttl)
+    - based on the [**`modified metamodel`**](http://116.203.149.114/2018-verwaltungsschale-im-detail-annotated-umls.pdf)
+    - conform to [**`shapes`**](schema/)
+
+The information content is almost the same. The models match from the raw data, but the asset can still be displayed more clearly with all dependencies by using RDF.
+
+### Reasoning
+We created a rami-ruleset that contains:
+- basic rules that are extensions of the metamodel
+
+In addition we created a domain-specific-ruleset for all computing devices, i.e. Raspberry Pis
+These rules detect if the asset is for example:
+- a computer
+- carriable by a human
+- a powered device
+- PoE suppliable
+- ...
+
+We evaluated the rdf-model of the Raspberry Pi 3b+. The output file is called [**`rdfttlsolution_with_reasoning.nt`**](RaspberryPi3bPlus_EXAMPLE/evaluated/rdfttlsolution_with_reasoning.nt) and contains around 334 derived triples.
+
+***
+We used [Linked-Data-Fu](https://linked-data-fu.github.io) for reasoning.
+
+We edited the Ontology with [Protégé](https://protege.stanford.edu).

RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/[Content_Types].xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml" /><Default Extension="xml" ContentType="text/xml" /><Default Extension="jpg" ContentType="image/jpeg" /><Default Extension="pdf" ContentType="application/pdf" /><Override PartName="/aasx/aasx-origin" ContentType="text/plain" /></Types>

RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/_rels/.rels

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+    <Relationship Type="http://www.admin-shell.io/aasx/relationships/aasx-origin" Target="/aasx/aasx-origin" Id="R15e3f3de7cb643e7" />
+    <Relationship Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail" Target="/RASPBERRY_PI_3B_PLUS_001.jpg" Id="R3c534e7bd5b14ad7" />
+</Relationships>

RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/aasx/_rels/aasx-origin.rels

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+    <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+    <Relationship Type="http://www.admin-shell.io/aasx/relationships/aas-spec" Target="/aasx/iais_fraunhofer_de_en_aas_examples/iais_fraunhofer_de_en_aas_examples_raspberry_pi_3b_plus.aas.xml" Id="Re6c8316736fc4ac4" />
+</Relationships>

RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/aasx/aasx-origin

@@ -0,0 +1 @@
+Intentionally empty.

RaspberryPi3bPlus_EXAMPLE/Raspberry_Pi_3b_plus/aasx/iais_fraunhofer_de_en_aas_examples/_rels/iais_fraunhofer_de_en_aas_examples_rspbryp3bp.rels

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+    <Relationship Type="http://www.admin-shell.io/aasx/relationships/aas-suppl" Target="/aasx/documents/product_sheet.pdf" Id="Rd37d67ad7bdd44e5" />
+    <Relationship Type="http://www.admin-shell.io/aasx/relationships/aas-suppl" Target="/aasx/documents/review_and_guide.pdf" Id="Rd37d67ad7bdr44e5" />
+</Relationships>