Skip to main content

WelDX - data and quality standards for welding research data

Zenodo License CF Documentation builds documentation builds pytest pre-commit.ci status codecov

Overview

Scientific welding data covers a wide range of physical domains and timescales and are measured using various different sensors. Complex and highly specialized experimental setups at different welding institutes complicate the exchange of welding research data further.

The WelDX research project aims to foster the exchange of scientific data inside the welding community by developing and establishing a new open source file format suitable for the documentation of experimental welding data and upholding associated quality standards. In addition to fostering scientific collaboration inside the national and international welding community an associated advisory committee will be established to oversee the future development of the file format. The proposed file format will be developed with regard to current needs of the community regarding interoperability, data quality and performance and will be published under an appropriate open source license. By using the file format objectivity, comparability and reproducibility across different experimental setups can be improved.

The project is under active development by the Welding Technology division at Bundesanstalt für Materialforschung und -prüfung (BAM).

Features

WelDX provides several Python API to perform standard tasks like experiment design, data analysis, and experimental data archiving.

Planning

  • Define measurement chains with all involved devices, error sources, and metadata annotations.
  • Handle complex coordinate transformations needed to describe the movement of welding robots, workpieces, and sensors.
  • Planing of welding experiments.
  • convenient creation of ISO 9692-1 welding groove types.

Data analysis

  • Plotting routines to inspect measurement chains, workpieces (planned and welded).
  • Analysis functions for standard measurements like track energy, welding speed to fill an ISO groove, and more to come.

Data archiving

The ultimate goal of this project is to store all information about the experiment in a single file. We choose the popular ASDF format for this task. This enables us to store arbitrary binary data, while maintaining a human readable text based header. All information is stored in a tree like structure, which makes it convenient to structure the data in arbitrary complex ways.

The ASDF format and the provided extensions for WelDX types like

  • workpiece information (used alloys, geometries)
  • welding process parameters (GMAW parameters)
  • measurement data
  • coordinate systems (robot movement, sensors)

enables us to store the whole experimental pipeline performed in a modern laboratory.

Design goals

We seek to provide a user-friendly, well documented programming interface. All functions and classes in WelDX have attached documentation about the involved parameters (types and explanation), see API docs. Further we provide rich Jupyter notebook tutorials about the handling of the basic workflows.

All involved physical quantities used in weldx (lengths, angles, voltages, currents, etc.) should be attached with a unit to ensure automatic conversion and correct mathematical handling. Units are being used in all standard features of WelDX and are also archived in the ASDF files. This is implemented by the popular Python library Pint, which flawlessly handles the creation and conversion of units and dimensions.

Publications

Installation

The WelDX package can be installed using any conda or mamba package manager from the Conda-Forge channel. If you have not yet installed a conda package manager, we recommend installing Miniforge. The installer can then be found here, and a detailed documentation for the installation process is provided here. Once this step has been completed, you will gain access to both the conda and the mamba command and will be able to proceed with the installation of the WelDX package.

In order to create a new conda environment called weldx containing the WeldX package, run the console command:

conda create --name weldx --channel conda-forge weldx weldx_widgets

To install the WeldX package into your existing environment instead, use:

conda install weldx weldx_widgets --channel conda-forge

If installed, all conda commands can be replaced by mamba to take advantage of its faster solver.

The package is also available on pypi and can be installed via:

pip install weldx weldx-widgets

As weldx currently depends on the package bottleneck, which contains C/C++ code, you will need a working C/C++ compiler. The conda package does not have this requirement as it only installs pre-compiled binaries. So if you do not know how to install a working compiler, we strongly encourage using the conda package.

Documentation

The full documentation is published on readthedocs.org. Click on one of the following links to get to the desired version:

Funding

This research is funded by the Federal Ministry of Education and Research of Germany under project number 16QK12.

Metadata

Release files for weldx 0.8.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for weldx 0.8.2
File Size Uploaded
weldx-0.8.2.tar.gz 720.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for weldx 0.8.2
File Interpreter ABI Platform
weldx-0.8.2-py3-none-any.whl Python 3 none any Details

Total release size: 1.1 MB

Release files / weldx-0.8.2.tar.gz

Download URL weldx-0.8.2.tar.gz
Size 720.1 kB
Tags Source
SHA-256 checksum
How to use checksums
01876eae8d40f0b17a27bd119274a38724ca3336b20b5e57a929205b41f66c61
BLAKE2b-256 checksum
How to use checksums
68dfeac260eaeda35ed8697242b5100b4c4876706ed5c970571fa56e1a0673c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release files / weldx-0.8.2-py3-none-any.whl

Download URL weldx-0.8.2-py3-none-any.whl
Size 351.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49a40d3ac8986ddea422736084125f70279018a8b79dc5087ae77fc762ddaa33
BLAKE2b-256 checksum
How to use checksums
b9302b5395ee95a973abc322fef914c47815101b531bd408c41618810b49c7d9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page