(formerly known as PyI40AAS – Python Industry 4.0 Asset Administration Shell)
The Eclipse BaSyx Python project focuses on providing a Python implementation of the Asset Administration Shell (AAS) for Industry 4.0 Systems. These are the currently implemented specifications:
Specification | Version |
---|---|
Part 1: Metamodel | v3.0 (01001-3-0) |
Part 2: API | not implemented yet |
Part 3a: Data Specification IEC 61360 | v3.0 (01003-a-3-0) |
Part 5: Package File Format (AASX) | v3.0 (01005-3-0) |
- Modelling of AASs as Python objects
- except for: HasDataSpecification
- Reading and writing of AASX package files
- (De-)serialization of AAS objects into/from JSON and XML
- Storing of AAS objects in CouchDB, Backend infrastructure for easy expansion
- Compliance checking of AAS XML and JSON files
The BaSyx Python SDK project provides the basax.aas
Python package with 6 submodules:
basyx.aas.model
: The AAS metamodel implemented in pythonbasyx.aas.adapter
: Adapters for various file formatsbasyx.aas.backend
: Backend infrastructure for storing and retrieving AAS objectsbasyx.aas.util
: Provides utilitiesbasyx.aas.examples
: Example data and tutorials
The BaSyx Python SDK project is licensed under the terms of the MIT License.
SPDX-License-Identifier: MIT
For more information, especially considering the licenses of included third-party works, please consult the NOTICE
file.
The Eclipse BaSyx-Python SDK Team evaluates bi-monthly the newly added commits to the main branch towards the need of releasing a new version. If decided the changes warrant a release, it is initiated, using semantic versioning for the new release number. If the changes do not warrant a release, the decision is postponed to the next meeting.
Additionally, security fixes may be released at any point.
The BaSyx Python SDK requires the following Python packages to be installed for production usage. These dependencies are listed in
setup.py
to be fetched automatically when installing with pip
:
lxml
(BSD 3-clause License, usinglibxml2
under MIT License)python-dateutil
(BSD 3-clause License)pyecma376-2
(Apache License v2.0)urllib3
(MIT License)
Optional production usage dependencies:
- For using the Compliance Tool to validate JSON files against the JSON Schema:
jsonschema
and its dependencies (MIT License, Apache License, PSF License)
Development/testing/documentation/example dependencies (see requirements.txt
):
jsonschema
and its dependencies (MIT License, Apache License, PSF License)
Dependencies for building the documentation (see docs/add-requirements.txt
):
Sphinx
and its dependencies (BSD 2-clause License, MIT License, Apache License)sphinx-rtd-theme
and its dependencies (MIT License, PSF License)sphinx-argparse
(MIT License)
Eclipse BaSyx Python SDK can be installed from PyPI, the Python Package Index, just as nearly every other Python package:
pip install basyx-python-sdk
For working with the current development version, you can also install the package directly from GitHub, using Pip's Git feature:
pip install git+https://github.com/eclipse-basyx/basyx-python-sdk.git@main
You may want to use a Python's venv
or a similar tool to install BaSyx Python SDK and its dependencies only in a project-specific local environment.
The following code example shows how to create a Submodel
with a Property
serialize it into an XML file using the
Eclipse BaSyx Python SDK:
Create a Submodel
:
from basyx.aas import model # Import all BaSyx Python SDK classes from the model package
identifier = 'https://acplt.org/Simple_Submodel'
submodel = model.Submodel(identifier)
Create a Property
and add it to the Submodel
:
# create an external reference to a semantic description of the property
semantic_reference = model.ExternalReference(
(model.Key(
type_=model.KeyTypes.GLOBAL_REFERENCE,
value='http:https://acplt.org/Properties/SimpleProperty'
),)
)
property = model.Property(
id_short='ExampleProperty', # Identifying string of the element within the submodel namespace
value_type=model.datatypes.String, # Data type of the value
value='exampleValue', # Value of the property
semantic_id=semantic_reference # set the semantic reference
)
submodel.submodel_element.add(property)
Serialize the Submodel
to XML:
from basyx.aas.adapter.xml import write_aas_xml_file
data: model.DictObjectStore[model.Identifiable] = model.DictObjectStore()
data.add(submodel)
write_aas_xml_file(file='Simple_Submodel.xml', data=data)
For further examples and tutorials, check out the basyx.aas.examples
-package. Here is a quick overview:
tutorial_create_simple_aas
: Create an Asset Administration Shell, including an Asset object and a Submodeltutorial_storage
: Manage a larger number of Asset Administration Shells in an ObjectStore and resolve referencestutorial_serialization_deserialization
: Use the JSON and XML serialization/deserialization for single objects or full standard-compliant filestutorial_aasx
: Export Asset Administration Shells with related objects and auxiliary files to AASX package filestutorial_backend_couchdb
: Use the Backends interface (update()/commit()
methods) to manage and retrieve AAS objects in a CouchDB document database
A detailed, complete API documentation is available on Read the Docs: https://basyx-python-sdk.readthedocs.io
The compliance tool functionality moved to github.com/rwth-iat/aas-compliance-tool.
For contributing with issues and code, please see our Contribution Guideline.
To contribute code to this project you need to sign the Eclipse Contributor Agreement (ECA). This is done by creating an Eclipse account for your git e-mail address and then submitting the following form: https://accounts.eclipse.org/user/eca