<!--
~ SPDX-FileCopyrightText: Copyright DB InfraGO AG
~ SPDX-License-Identifier: Apache-2.0
-->
Python-Capellambse
==================
*A Python 3 headless implementation of the Capella modeling tool*
Intro
-----
`capellambse` allows you reading and writing Capella models from Python without
Java or the [Capella tool](https://www.eclipse.org/capella/) on any
(reasonable) platform. We wanted to "talk" to Capella models from Python, but
without any Java on the way. We thought this project will help individuals and
organisations getting through the MBSE adoption journey with Capella faster and
so we made it public and open-source.
With `capellambse` you can access all (or almost all) Capella model elements,
and render diagrams as SVG and PNG. We made it for automation of Systems
Engineering work, so it integrates nicely into most CI/CD toolchains. We also
found it at the core of our artifact generation pipelines (model to documents,
model to SW interfaces).
The library works with [PVMT](https://www.eclipse.org/capella/addons.html) and
[Requirements](https://github.com/eclipse/capella-requirements-vp) extensions
without any additional efforts.
It started as a basic library somewhere mid 2019. Since then it was
re-architected a few times and now has a full read/write capability for most of
the present Capella ontology. We are continuously improving the API
(introducing shortcuts), increasing the meta-model coverage and have more
engineering automations and improvements in the pipeline to share.
Related projects
----------------
- [`capellambse-context-diagrams`](https://github.com/DSD-DBS/capellambse-context-diagrams)
— A capellambse extension that visualizes the context of Capella objects, and
exposes it on element attributes like `.context_diagram`, `.tree_view`, etc.
- [`capella-diff-tools`](https://github.com/DSD-DBS/capella-diff-tools) — A set
of tools to compare Capella models.
- [`capella-polarion`](https://github.com/DSD-DBS/capella-polarion/) —
Synchronize information from the Capella model into a
[Polarion](https://plm.sw.siemens.com/de-DE/polarion/) project
- [`capella-ros-tools`](https://github.com/DSD-DBS/capella-ros-tools) — Import
and export ROS `*.msg` files to/from Capella models, or transform `*.msg`
files into a declarative YAML file.
Did you make something cool that is using or extending capellambse? [Tell us
about it](https://github.com/DSD-DBS/py-capellambse/issues), so we can add it
to this list!
Documentation and examples
--------------------------
The library is designed to be easy to use and discover, especially in an
interactive environment such as JupyterLab. Additionally, [API
documentation](https://dsd-dbs.github.io/py-capellambse/) is automatically
generated and published whenever new features and bug fixes are added.
You are encouraged to explore our test models and demo notebooks. Click on the
button below to launch a [Jupyter notebook server] on the public myBinder
service, and get started in seconds:
[](https://mybinder.org/v2/gh/DSD-DBS/py-capellambse/HEAD?labpath=docs%2Fsource%2Fexamples%2F01%20Introduction.ipynb)
*Warning:* [Do not enter confidential
information](https://github.com/alan-turing-institute/the-turing-way/blob/b36c3ac1c78acbbe18441beaa89514544ed12021/workshops/boost-research-reproducibility-binder/workshop-presentations/zero-to-binder-python.md#private-files),
such as passwords for non-public models, into a notebook hosted on myBinder. If
you want to try out `capellambse` with those models, please [install and
run](#installation) it in a local, trusted environment!
The `docs/source/examples` directory contains several hands-on example
notebooks that you can immediately run and start experimenting with. Below is a
short summary of each notebook's goal. If you are in the JupyterLab
environment, you can click the notebook names to directly open them in a new
lab tab. On Github, you will be shown a statically rendered preview of the
notebook.
- [01
Introduction.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/01%20Introduction.html)
provides a high-level overview of the library features. It visualizes
examples like a Component - Function allocation table by leveraging Jupyter's
and IPython's rich display functionality.
- [02 Intro to Physical
Architecture.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/02%20Intro%20to%20Physical%20Architecture%20API.html)
explores some more advanced concepts on the example of the Physical
Architecture Layer. It shows how to derive tabular data, like a Bill of
Materials or a Software to Hardware allocation table, by using `pandas`
dataframes.
- [03 Data
Values.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/03%20Data%20Values.html)
shows how the API can be used to explore classes, class instances and other
objects related to data modeling.
- [04 Intro to Jinja
templating.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/04%20Intro%20to%20Jinja%20templating.html)
demonstrates how to effectively combine `capellambse` with the powerful
[Jinja](https://palletsprojects.com/p/jinja/) templating engine. This enables
the creation of all sorts of model-derived documents and artifacts, including
interactive web pages, PDF documents and any other textual representations of
your models.
- [05 Introduction to
Libraries.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/05%20Introduction%20to%20Libraries.html)
shows how to use Capella Library Projects within capellambse. In this example
you'll learn how the API can be used to open a project that is based on a
library and find objects in both models.
- [06 Introduction to Requirement access and
management.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/06%20Introduction%20to%20Requirement%20access%20and%20management.html)
shows how the API can be used to work with requirements objects, introduced
by the Capella [Requirements
Viewpoint](https://www.eclipse.org/capella/addons.html). In this example
you'll see how to find requirements in the model, see which objects
requirements are linked / traced to and even export requirements to Excel or
ReqIF formats.
- [07 Code
Generation.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/07%20Code%20Generation.html)
shows how to generate code from class diagrams. In particular, we focus on
Interface Descriptive Languages with concrete examples for `Class` to [ROS2
IDL](https://docs.ros.org/en/rolling/Concepts/About-ROS-Interfaces.html) and
Google [Protocol Buffers](https://developers.google.com/protocol-buffers). We
also show how simple Python stubs could be generated given a `Class`
object.
- [08 Property
Values.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/08%20Property%20Values.html)
shows how to access property values and property value groups, as well as the
[Property Value Management (PVMT)](https://eclipse.dev/capella/addons.html)
extension.
- [09 Context
Diagrams.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/09%20Context%20Diagrams.html)
shows the [capellambse-context-diagrams
extension](https://dsd-dbs.github.io/capellambse-context-diagrams/) that
visualizes contexts of Capella objects. The extension is external to the
capellambse library and needs to be installed separately.
- [10 Declarative
Modeling.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/10%20Declarative%20Modeling.html)
demonstrates a basic application of the declarative approach to modeling on a
coffee machine example.
- [11 Complexity
Assessment.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/11%20Complexity%20Assessment.html)
quickly demonstrates how to use and view the model complexity badge for a
Capella model.
We are constantly working on improving everything shown here, as well as adding
even more useful functionality and helpful demos. If you have any new ideas
that were not mentioned yet, [don't hesitate to contribute](CONTRIBUTING.md)!
Installation
------------
In order to use private models that are not publicly available, please install
and use `capellambse` in a local, trusted environment.
You can install the latest released version directly from PyPI.
```bash
pip install capellambse
```
To set up a development environment, clone the project and install it into a
virtual environment.
```bash
git clone https://github.com/DSD-DBS/py-capellambse
cd capellambse
python -m venv .venv
source .venv/bin/activate.sh # for Linux / Mac
.venv\Scripts\activate # for Windows
pip install -U pip pre-commit
pip install -e '.[docs,test]'
pre-commit install
```
We recommend developing within a local [Jupyter notebook server] environment.
In order to install and run it in the same virtual environment, execute the
following additional commands:
```bash
pip install jupyter capellambse
cd docs/source/examples
jupyter-notebook
```
If your browser did not open automatically, follow the instructions in the
terminal to start it manually.
Once in the browser, simply click on the [01
Introduction.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/01%20Introduction.html)
notebook to start!
Current limitations
-------------------
We are continuously improving coverage of Capella onthology with our
[high-level API](#TODO) (the current coverage map is available [here](#TODO)),
however it is still incomplete. It covers most of the commonly used paths but
when you need to get to an ontology element that isnt covered yet you may do so
by using the [low-level
API](https://dsd-dbs.github.io/py-capellambse/development/low-level-api.html).
Also, as we started in mid 2019 and there was no such thing as
[Python4Capella](https://github.com/labs4capella/python4capella) yet, we are
not API compatible with that project.
The generated diagrams are currently not persisted in `.aird` files, and
currently there is no plan to implement this. If there is a genuine usecase for
that we may re-consider it - feel free to create an issue or add comments to an
existing one.
Contributing
------------
We'd love to see your bug reports and improvement suggestions! Please take a
look at our [guidelines for contributors](CONTRIBUTING.md) for details.
Licenses
--------
This project is compliant with the [REUSE Specification Version
3.0](https://git.fsfe.org/reuse/docs/src/commit/d173a27231a36e1a2a3af07421f5e557ae0fec46/spec.md).
Copyright DB InfraGO AG, licensed under Apache 2.0 (see full text in
[LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt))
Dot-files are licensed under CC0-1.0 (see full text in
[LICENSES/CC0-1.0.txt](LICENSES/CC0-1.0.txt))
To provide the same look and feel across platforms, we distribute our library
bundled with the OpenSans font (`capellambse/OpenSans-Regular.ttf`). The
OpenSans font is Copyright 2020 [The Open Sans Project
Authors](https://github.com/googlefonts/opensans), licensed under OFL-1.1 (see
full text in [LICENSES/OFL-1.1.txt](LICENSES/OFL-1.1.txt)).
[Jupyter notebook server]: https://jupyter.org/
Raw data
{
"_id": null,
"home_page": null,
"name": "capellambse",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.10",
"maintainer_email": null,
"keywords": "arcadia, capella, mbse, model-based systems engineering",
"author": "DB InfraGO AG",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/cb/26/a8c4e618b2274f866c3d7ea0c07b81d6e4c7653ae7881bd75ff204a46329/capellambse-0.6.11.tar.gz",
"platform": "any",
"description": "<!--\n ~ SPDX-FileCopyrightText: Copyright DB InfraGO AG\n ~ SPDX-License-Identifier: Apache-2.0\n -->\n\nPython-Capellambse\n==================\n\n\n\n\n\n\n\n\n*A Python 3 headless implementation of the Capella modeling tool*\n\nIntro\n-----\n\n`capellambse` allows you reading and writing Capella models from Python without\nJava or the [Capella tool](https://www.eclipse.org/capella/) on any\n(reasonable) platform. We wanted to \"talk\" to Capella models from Python, but\nwithout any Java on the way. We thought this project will help individuals and\norganisations getting through the MBSE adoption journey with Capella faster and\nso we made it public and open-source.\n\nWith `capellambse` you can access all (or almost all) Capella model elements,\nand render diagrams as SVG and PNG. We made it for automation of Systems\nEngineering work, so it integrates nicely into most CI/CD toolchains. We also\nfound it at the core of our artifact generation pipelines (model to documents,\nmodel to SW interfaces).\n\nThe library works with [PVMT](https://www.eclipse.org/capella/addons.html) and\n[Requirements](https://github.com/eclipse/capella-requirements-vp) extensions\nwithout any additional efforts.\n\nIt started as a basic library somewhere mid 2019. Since then it was\nre-architected a few times and now has a full read/write capability for most of\nthe present Capella ontology. We are continuously improving the API\n(introducing shortcuts), increasing the meta-model coverage and have more\nengineering automations and improvements in the pipeline to share.\n\nRelated projects\n----------------\n\n- [`capellambse-context-diagrams`](https://github.com/DSD-DBS/capellambse-context-diagrams)\n \u2014 A capellambse extension that visualizes the context of Capella objects, and\n exposes it on element attributes like `.context_diagram`, `.tree_view`, etc.\n\n- [`capella-diff-tools`](https://github.com/DSD-DBS/capella-diff-tools) \u2014 A set\n of tools to compare Capella models.\n\n- [`capella-polarion`](https://github.com/DSD-DBS/capella-polarion/) \u2014\n Synchronize information from the Capella model into a\n [Polarion](https://plm.sw.siemens.com/de-DE/polarion/) project\n\n- [`capella-ros-tools`](https://github.com/DSD-DBS/capella-ros-tools) \u2014 Import\n and export ROS `*.msg` files to/from Capella models, or transform `*.msg`\n files into a declarative YAML file.\n\nDid you make something cool that is using or extending capellambse? [Tell us\nabout it](https://github.com/DSD-DBS/py-capellambse/issues), so we can add it\nto this list!\n\nDocumentation and examples\n--------------------------\n\nThe library is designed to be easy to use and discover, especially in an\ninteractive environment such as JupyterLab. Additionally, [API\ndocumentation](https://dsd-dbs.github.io/py-capellambse/) is automatically\ngenerated and published whenever new features and bug fixes are added.\n\nYou are encouraged to explore our test models and demo notebooks. Click on the\nbutton below to launch a [Jupyter notebook server] on the public myBinder\nservice, and get started in seconds:\n\n[](https://mybinder.org/v2/gh/DSD-DBS/py-capellambse/HEAD?labpath=docs%2Fsource%2Fexamples%2F01%20Introduction.ipynb)\n\n*Warning:* [Do not enter confidential\ninformation](https://github.com/alan-turing-institute/the-turing-way/blob/b36c3ac1c78acbbe18441beaa89514544ed12021/workshops/boost-research-reproducibility-binder/workshop-presentations/zero-to-binder-python.md#private-files),\nsuch as passwords for non-public models, into a notebook hosted on myBinder. If\nyou want to try out `capellambse` with those models, please [install and\nrun](#installation) it in a local, trusted environment!\n\nThe `docs/source/examples` directory contains several hands-on example\nnotebooks that you can immediately run and start experimenting with. Below is a\nshort summary of each notebook's goal. If you are in the JupyterLab\nenvironment, you can click the notebook names to directly open them in a new\nlab tab. On Github, you will be shown a statically rendered preview of the\nnotebook.\n\n- [01\n Introduction.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/01%20Introduction.html)\n provides a high-level overview of the library features. It visualizes\n examples like a Component - Function allocation table by leveraging Jupyter's\n and IPython's rich display functionality.\n\n- [02 Intro to Physical\n Architecture.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/02%20Intro%20to%20Physical%20Architecture%20API.html)\n explores some more advanced concepts on the example of the Physical\n Architecture Layer. It shows how to derive tabular data, like a Bill of\n Materials or a Software to Hardware allocation table, by using `pandas`\n dataframes.\n\n- [03 Data\n Values.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/03%20Data%20Values.html)\n shows how the API can be used to explore classes, class instances and other\n objects related to data modeling.\n\n- [04 Intro to Jinja\n templating.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/04%20Intro%20to%20Jinja%20templating.html)\n demonstrates how to effectively combine `capellambse` with the powerful\n [Jinja](https://palletsprojects.com/p/jinja/) templating engine. This enables\n the creation of all sorts of model-derived documents and artifacts, including\n interactive web pages, PDF documents and any other textual representations of\n your models.\n\n- [05 Introduction to\n Libraries.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/05%20Introduction%20to%20Libraries.html)\n shows how to use Capella Library Projects within capellambse. In this example\n you'll learn how the API can be used to open a project that is based on a\n library and find objects in both models.\n\n- [06 Introduction to Requirement access and\n management.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/06%20Introduction%20to%20Requirement%20access%20and%20management.html)\n shows how the API can be used to work with requirements objects, introduced\n by the Capella [Requirements\n Viewpoint](https://www.eclipse.org/capella/addons.html). In this example\n you'll see how to find requirements in the model, see which objects\n requirements are linked / traced to and even export requirements to Excel or\n ReqIF formats.\n\n- [07 Code\n Generation.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/07%20Code%20Generation.html)\n shows how to generate code from class diagrams. In particular, we focus on\n Interface Descriptive Languages with concrete examples for `Class` to [ROS2\n IDL](https://docs.ros.org/en/rolling/Concepts/About-ROS-Interfaces.html) and\n Google [Protocol Buffers](https://developers.google.com/protocol-buffers). We\n also show how simple Python stubs could be generated given a `Class`\n object.\n\n- [08 Property\n Values.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/08%20Property%20Values.html)\n shows how to access property values and property value groups, as well as the\n [Property Value Management (PVMT)](https://eclipse.dev/capella/addons.html)\n extension.\n\n- [09 Context\n Diagrams.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/09%20Context%20Diagrams.html)\n shows the [capellambse-context-diagrams\n extension](https://dsd-dbs.github.io/capellambse-context-diagrams/) that\n visualizes contexts of Capella objects. The extension is external to the\n capellambse library and needs to be installed separately.\n\n- [10 Declarative\n Modeling.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/10%20Declarative%20Modeling.html)\n demonstrates a basic application of the declarative approach to modeling on a\n coffee machine example.\n\n- [11 Complexity\n Assessment.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/11%20Complexity%20Assessment.html)\n quickly demonstrates how to use and view the model complexity badge for a\n Capella model.\n\nWe are constantly working on improving everything shown here, as well as adding\neven more useful functionality and helpful demos. If you have any new ideas\nthat were not mentioned yet, [don't hesitate to contribute](CONTRIBUTING.md)!\n\nInstallation\n------------\n\nIn order to use private models that are not publicly available, please install\nand use `capellambse` in a local, trusted environment.\n\nYou can install the latest released version directly from PyPI.\n\n```bash\npip install capellambse\n```\n\nTo set up a development environment, clone the project and install it into a\nvirtual environment.\n\n```bash\ngit clone https://github.com/DSD-DBS/py-capellambse\ncd capellambse\npython -m venv .venv\n\nsource .venv/bin/activate.sh # for Linux / Mac\n.venv\\Scripts\\activate # for Windows\n\npip install -U pip pre-commit\npip install -e '.[docs,test]'\npre-commit install\n```\n\nWe recommend developing within a local [Jupyter notebook server] environment.\nIn order to install and run it in the same virtual environment, execute the\nfollowing additional commands:\n\n```bash\npip install jupyter capellambse\ncd docs/source/examples\njupyter-notebook\n```\n\nIf your browser did not open automatically, follow the instructions in the\nterminal to start it manually.\n\nOnce in the browser, simply click on the [01\nIntroduction.ipynb](https://dsd-dbs.github.io/py-capellambse/examples/01%20Introduction.html)\nnotebook to start!\n\nCurrent limitations\n-------------------\n\nWe are continuously improving coverage of Capella onthology with our\n[high-level API](#TODO) (the current coverage map is available [here](#TODO)),\nhowever it is still incomplete. It covers most of the commonly used paths but\nwhen you need to get to an ontology element that isnt covered yet you may do so\nby using the [low-level\nAPI](https://dsd-dbs.github.io/py-capellambse/development/low-level-api.html).\n\nAlso, as we started in mid 2019 and there was no such thing as\n[Python4Capella](https://github.com/labs4capella/python4capella) yet, we are\nnot API compatible with that project.\n\nThe generated diagrams are currently not persisted in `.aird` files, and\ncurrently there is no plan to implement this. If there is a genuine usecase for\nthat we may re-consider it - feel free to create an issue or add comments to an\nexisting one.\n\nContributing\n------------\n\nWe'd love to see your bug reports and improvement suggestions! Please take a\nlook at our [guidelines for contributors](CONTRIBUTING.md) for details.\n\nLicenses\n--------\n\nThis project is compliant with the [REUSE Specification Version\n3.0](https://git.fsfe.org/reuse/docs/src/commit/d173a27231a36e1a2a3af07421f5e557ae0fec46/spec.md).\n\nCopyright DB InfraGO AG, licensed under Apache 2.0 (see full text in\n[LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt))\n\nDot-files are licensed under CC0-1.0 (see full text in\n[LICENSES/CC0-1.0.txt](LICENSES/CC0-1.0.txt))\n\nTo provide the same look and feel across platforms, we distribute our library\nbundled with the OpenSans font (`capellambse/OpenSans-Regular.ttf`). The\nOpenSans font is Copyright 2020 [The Open Sans Project\nAuthors](https://github.com/googlefonts/opensans), licensed under OFL-1.1 (see\nfull text in [LICENSES/OFL-1.1.txt](LICENSES/OFL-1.1.txt)).\n\n[Jupyter notebook server]: https://jupyter.org/\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Provides access to Capella MBSE projects in Python",
"version": "0.6.11",
"project_urls": {
"Documentation": "https://dsd-dbs.github.io/py-capellambse",
"Homepage": "https://github.com/DSD-DBS/py-capellambse"
},
"split_keywords": [
"arcadia",
" capella",
" mbse",
" model-based systems engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ac0d8414f0d1c91f9e491d800652220526895603aee190a4c6da6f88f37605fb",
"md5": "fa8e487177b36fc34b829c7a06b4c43a",
"sha256": "84685a8b53b366725fdabba68beacca8b6218011c9b08228f2f12eb8d7feb1d6"
},
"downloads": -1,
"filename": "capellambse-0.6.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fa8e487177b36fc34b829c7a06b4c43a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.10",
"size": 370094,
"upload_time": "2024-12-13T14:30:25",
"upload_time_iso_8601": "2024-12-13T14:30:25.220563Z",
"url": "https://files.pythonhosted.org/packages/ac/0d/8414f0d1c91f9e491d800652220526895603aee190a4c6da6f88f37605fb/capellambse-0.6.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cb26a8c4e618b2274f866c3d7ea0c07b81d6e4c7653ae7881bd75ff204a46329",
"md5": "63d539192c1dcb4d6e183643e53ecbaf",
"sha256": "5f272b9653b081338272b3ded749564d9e450d3d833e837f4dbb92acf968f923"
},
"downloads": -1,
"filename": "capellambse-0.6.11.tar.gz",
"has_sig": false,
"md5_digest": "63d539192c1dcb4d6e183643e53ecbaf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.10",
"size": 5681435,
"upload_time": "2024-12-13T14:30:29",
"upload_time_iso_8601": "2024-12-13T14:30:29.009469Z",
"url": "https://files.pythonhosted.org/packages/cb/26/a8c4e618b2274f866c3d7ea0c07b81d6e4c7653ae7881bd75ff204a46329/capellambse-0.6.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-13 14:30:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DSD-DBS",
"github_project": "py-capellambse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "capellambse"
}
JSON
