Is tzinfo required in Date, GYearMonth, GYear, GMonthDay, GDay, GMonth?

Eclipse BaSyx Python SDK

(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)

Features

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

Project Structure

The BaSyx Python SDK project provides the basax.aas Python package with 6 submodules:

basyx.aas.model: The AAS metamodel implemented in python
basyx.aas.adapter: Adapters for various file formats
basyx.aas.backend: Backend infrastructure for storing and retrieving AAS objects
basyx.aas.util: Provides utilities
basyx.aas.examples: Example data and tutorials

License

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.

Release Schedule

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.

Dependencies

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, using libxml2 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)

Getting Started

Installation

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.

Example

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://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)

Examples and Tutorials

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 Submodel
tutorial_storage: Manage a larger number of Asset Administration Shells in an ObjectStore and resolve references
tutorial_serialization_deserialization: Use the JSON and XML serialization/deserialization for single objects or full standard-compliant files
tutorial_aasx: Export Asset Administration Shells with related objects and auxiliary files to AASX package files
tutorial_backend_couchdb: Use the Backends interface (update()/commit() methods) to manage and retrieve AAS objects in a CouchDB document database

Documentation

A detailed, complete API documentation is available on Read the Docs: https://basyx-python-sdk.readthedocs.io

Compliance Tool

The compliance tool functionality moved to github.com/rwth-iat/aas-compliance-tool.

Contributing

For contributing with issues and code, please see our Contribution Guideline.

Eclipse Contributor Agreement

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

	def _collect_supplementary_files(self, part_name: str, submodel: model.Submodel,
	file_store: "AbstractSupplementaryFileContainer") -> None:
	"""
	Helper function to search File objects within a single parsed Submodel, extract the referenced supplementary
	files and update the File object's values with the absolute path.

	:param part_name: The OPC part name of the part the submodel has been parsed from. This is used to resolve
	relative file paths.
	:param submodel: The Submodel to process
	:param file_store: The SupplementaryFileContainer to add the extracted supplementary files to
	"""
	for element in traversal.walk_submodel(submodel):
	if isinstance(element, model.File):
	if element.value is None:
	continue
	# Only absolute-path references and relative-path URI references (see RFC 3986, sec. 4.2) are considered
	# to refer to files within the AASX package. Thus, we must skip all other types of URIs (esp. absolute
	# URIs and network-path references)
	if element.value.startswith('//') or ':' in element.value.split('/')[0]:
	logger.info("Skipping supplementary file %s, since it seems to be an absolute URI or network-path "
	"URI reference", element.value)
	continue
	absolute_name = pyecma376_2.package_model.part_realpath(element.value, part_name)
	logger.debug("Reading supplementary file {} from AASX package ...".format(absolute_name))
	with self.reader.open_part(absolute_name) as p:
	final_name = file_store.add_file(absolute_name, p, self.reader.get_content_type(absolute_name))
	element.value = final_name

	value='https://www.plattform-i40.de/PI40/Redaktion/DE/Downloads/Publikation/Details-of-the-Asset-'
	'Administration-Shell-Part1.pdf?__blob=publicationFile&v=5',

eclipse-basyx / basyx-python-sdk Goto Github PK

basyx-python-sdk's Introduction

Eclipse BaSyx Python SDK

Features

Project Structure

License

Release Schedule

Dependencies

Getting Started

Installation

Example

Examples and Tutorials

Documentation

Compliance Tool

Contributing

Eclipse Contributor Agreement

basyx-python-sdk's People

Contributors

Stargazers

Watchers

Forkers

basyx-python-sdk's Issues

Recommend Projects

Recommend Topics

Recommend Org