SysML v2 Python Units

Convert units and quantities between standard SysML v2 and Python with Syside Automator and Pint.

Get/set quantity* as attribute value, specified using Pint Quantity objects
Get/set unit as attribute value, specified using Pint Unit objects
Supports numerical values, as well as inf (* in SysML v2) and NaN (set as null in SysML v2)
Supports compound units, for example K·kg·s²/m³
Supports unit prefixes (kilo, mega, milli, etc.)
Supports percentages
Conversion functions between SysML v2 units and Pint Unit, and string parsing functions
Derive preferred units for a quantity type, for example kg for an ISQ::mass quantity
Syside Automator ReferencePrinter for printing unit references using their short name
Extensive caching to make units lookup fast

*: a quantity is a combination of a numerical value (the "magnitude") and units, for example: 10 kg, -1.0 m/s**2.

Note: this package uses Syside Automator for parsing SysML v2 models. Syside Automator is commercial software, so you have to obtain a license first. For academic uses you can request an academic license.

Installation

Install the package from PyPI:
```
pip install sysmlv2-units
```
Note: currently Syside Automator only supports Python 3.12
Make sure you activate Syside Automator

Usage

Refer to the documentation.

Citing

If you use this library in your work, please cite the paper that first introduces the use of these capabilities:

Bussemaker, J.H. et al., 2026, April. System Architecture Optimization Using SysML v2: Language Extension and Implementation. IEEE SysCon 2026, Halifax, Canada. doi: 10.1109/SysCon66367.2026.11503593

Contributing

The project is coordinated by: Jasper Bussemaker (jasper.bussemaker at dlr.de)

If you find a bug or have a feature request, please file an issue using the Github issue tracker. If you require support for using the library or want to collaborate, feel free to contact me.

Contributions are appreciated too:

Fork the repository
Add your contributions to the fork
- Update/add documentation
- Add tests and make sure they pass (tests are run using pytest)
Sign a Contributor License Agreement (CLA): please contact me for the template
Issue a pull request

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sysmlv2_units-1.2.1.tar.gz (22.0 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sysmlv2_units-1.2.1-py3-none-any.whl (19.5 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file sysmlv2_units-1.2.1.tar.gz.

File metadata

Download URL: sysmlv2_units-1.2.1.tar.gz
Upload date: Aug 30, 2026
Size: 22.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sysmlv2_units-1.2.1.tar.gz
Algorithm	Hash digest
SHA256	`f714482a9df3ecca77809c2f3831da5c840257362eaa3a33113245bb0d8ffcaf`
MD5	`d4f01b691965b8e177ae785aaf182982`
BLAKE2b-256	`47b2f5d37869e3bac40bf815c0dfea81366086e11c24f3e9f582552b998499ce`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sysmlv2_units-1.2.1.tar.gz:

Publisher: publish.yml on jbussemaker/SysML-v2-Python-Units

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sysmlv2_units-1.2.1.tar.gz
- Subject digest: f714482a9df3ecca77809c2f3831da5c840257362eaa3a33113245bb0d8ffcaf
- Sigstore transparency entry: 2648272643
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: jbussemaker/SysML-v2-Python-Units@b5dee49a90fbfee9ed342f4736bbec07f9fd6ecc
- Branch / Tag: refs/tags/v1.2.1
- Owner: https://github.com/jbussemaker
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@b5dee49a90fbfee9ed342f4736bbec07f9fd6ecc
- Trigger Event: push