Release Notes#

0.6.2 (tba)#


  • New tutorial that demonstrates the usage of the CSM in conjunction with an existing WelDX file [PR 793]

  • New tutorial about the MeasurementChain class using an existing WelDX file [PR 796]


  • weldx now requires pip to install (previously it could be installed by directly invoking [PR 774]. From a users perspective nothing changes here, as the package was always recommended to be installed via pip.

  • Updated the outdated tutorial about the LocalCoordinateSystem [PR 775]

  • weld_seam is now a required field in the multi_pass_weld schema [PR 790]

  • Add section about time-dependent spatial data to the CoordinateSystemManager tutorial [PR 792]


0.6.1 (19.05.2022)#

Release 0.6.1 moves advanced plotting functions over to the weldx-widgets package and includes minor bugfixes.



  • Fix interactive view_tree display [PR 756].

  • Increase mypy coverage and update type hints and GH action [PR 753].


  • weldx now (optionally) requires weldx_widgets to visualize coordinate systems/manager [PR 749].

  • NumPy is not required as a build time dependency anymore, as Bottleneck now provides binaries on PyPI [PR 749].

0.6.0 (29.04.2022)#

This release includes major changes to the handling and support of units in the API and ASDF schemas. All classes now support and require quantities where appropriate. Plain numbers without units are no longer supported and will raise an exception. If the number is truly dimensionless, you still have to wrap it with the quantity class weldx.Q_ like this:

my_number = 42.0
my_number_wrapped = weldx.Q_(my_number, "meter")

Furthermore, a new class called GenericSeries was added. It provides a common interface to describe coordinate-based data either by discrete values or mathematical expressions. A built-in mechanism lets you derive specialized series with specific requirements. For more information, have a look at the new tutorial .



  • removed access to [PR 744]




  • update PR link format in the changelog [PR 658]

  • new tutorial that describes how to work with workpiece data from a WelDX file [PR 681]


  • update weldx extension and manifest version to 0.1.1 [PR 655]

  • removed legacy weldx tag and schema support [PR 600]

  • update core/geometry/spatial_data to version 0.1.1 with support for multidimensional data [PR 655]

  • add wx_shape validation support for core/data_array [PR 655]

  • update core/time_series schema to use time/time [PR 677]

  • update core/variable schema to allow single string as data [PR 707]

  • update the default sorting order of select_tag for WeldxConverter [PR 733]

  • add custom validation behavior to wx_unit [PR 739]



  • weldx now works with Python-3.10. [PR 696]

  • bump to asdf >=2.8.2 [PR 668]

  • add pint-xarray dependency [PR 518]

  • bump to numpy>=1.20 (for numpy.typing) [PR 656]

  • bump to pint >=0.18 for typing [PR 664]

  • bump to xarray >=0.19 for array creation compatibility [PR 618]

  • add bidict dependency [PR 618]

  • set networkx !=2.7 for plotting compatibility (for now) [PR 714, PR 722]

0.5.2 (18.11.2021)#



  • WeldxFile now raises an exception, if a warning is emitted during loading the weldx ASDF extension, this should prevent erroneous data during loading, for example missing dependencies. [PR 641]

  • WeldxFile now hides ASDF added fields like history and asdf_library from the dictionary interface. To access these, there are separate properties [PR 625].

  • Allow handling of time values as singular coordinates without dimensions in some classes [PR 635].



  • Removed ipykernel dependency. [PR 634]

  • The K3D implementation now uses the experimental weldx-widgets backend if available [PR 636]

0.5.1 (04.11.2021)#






  • fix process missing as required property in single_pass_weld-0.1.0.yaml [PR 627]


  • removed welding.util.lcs_coords_from_ts [PR 620]


  • adjust code to support pint 0.18 unit formatting. [PR 616]

0.5.0 (12.10.2021)#

Release 0.5.0 brings a major rework of the weldx standard and many API improvements:


  • weldx now internally uses the reworked ASDF extension API. The schema and tag naming patterns have also changed to the recommended asdf:// format.

  • New Time class to make handling of time related functionality easier and consistent.

  • many internal reworks to streamline the code.

  • rework the API documentation to show the most important classes.


  • the 0.5.x versions will retain backwards compatibility with files generated with the 0.4.x versions and convert them to the new naming schema on save. Support for the old schemas will be dropped in the 0.6 release.






  • added installation guide with complete environment setup (Jupyterlab with extensions) and possible problems and solutions [PR 450]

  • split API documentation into user classes/functions and a full API reference [PR 469].

  • added citation metadata in CITATION.cff [PR 568].


  • all schema version numbers set to 0.1.0 [PR 535].

  • add time/time schema to support Time class [PR 463].

  • rework ASDF extension to new asdf 2.8 API [PR 467]

    • move schema files to weldx/schemas

    • create extension manifest in weldx/manifests. The manifest also contains tag mappings for legacy tag names for backwards compatibility.

    • move tag module to weldx/tags

    • refactor all asdf uris to new asdf:// naming convention, see

    • replaced all referenced weldx tag versions in schemas with 0.1.*

    • refactor asdf:// to asdf:// and enable schema test

    • add legacy class for validators support in

    • asdf utility functions weldx.asdf.util.uri_match, weldx.asdf.util.get_converter_for_tag and weldx.asdf.util.get_weldx_extension

    • add devtools/scripts/ to auto update manifest from extension metadata

    • custom shape validation must now be implemented via staticmethod weldx.asdf.types.WeldxConverter.shape_from_tagged

  • provide legacy schema support in weldx/schemas/ [PR 533]

  • rewrote asdf:// schema for the CoordinateSystemManager. It uses the digraph schemas to serialize the coordinate system structure. [PR 497]

  • add asdf:// and asdf:// schemas [PR 522]

  • use asdf:// instead of [PR 542].

  • refactor properties named unit to units and use unit/unit tag [PR 551].

  • reworked the optional syntax for wx_shape validation [PR 571].


  • set k3d!=2.10 because of conda dependency bugs [GH 474, PR 577]

  • Python 3.10 is not supported in this version. [PR 575]

0.4.1 (20.07.2021)#



  • sort List[str] before serialization of most weldx classes to avoid random reordering in the same file and enforce consistency. [PR 430]


  • lcs_coords_from_ts will be removed in version 0.5.0 [PR 426]

0.4.0 (13.07.2021)#

Release 0.4.0 brings many new major features to weldx


full changelog below:







  • deprecate wx_tag validator (use default asdf uri pattern matching) [PR 410]

0.3.3 (30.03.2021)#

This is a bugfix release to correctly include the asdf schema files in conda builds. [PR 314]


  • fix required welding wire metadata in single-pass-weldx.1.0.0.schema [PR 316]

0.3.2 (29.03.2021)#



  • rotation_matrix_x, rotation_matrix_y and rotation_matrix_z [PR 317]


  • restrict scipy!=1.6.0,scipy!=1.6.1 [PR 300]


  • add validators to rotation-1.0.0.yaml & gas_component-1.0.0.yaml [PR 303]

  • update descriptions in single-pass-weldx.1.0.0.schema [PR 308]


0.3.1 (21.03.2021)#



  • remove the additionalProperties restriction from single_pass_weld-1.0.0.schema.yaml [PR 283]

  • allow scalar integer value in anyOf of time_series-1.0.0.yaml to fix [PR 282, PR 286]

  • add examples to schema files [PR 274]



  • A warning is now emitted if a LocalCoordinateSystem drops a provided time during construction. This usually happens if the coordinates and orientation only contain a single data point. [PR 285]

0.3.0 (12.03.2021)#



  • Add possibility to store meta data and content of an external file in an ASDF file [PR 215]

    • Python class: asdf.ExternalFile

    • Schema: core/file-1.0.0.yaml

  • Added support for serializing generic metadata and userdata attributes for weldx classes. [PR 209]

    • the provisional attribute names are wx_metadata and wx_user

  • None values are removed from the asdf tree for all weldx classes. [PR 212]

  • add datamodels directory and example schema [PR 190]

    • schemas in the datamodels directory do not define any tags and can be referenced in other schemas and as custom_schema when reading/writing ASDF-files

    • the single_pass_weld-1.0.0.schema is an example schema for a simple, linear, single pass GMAW application

    • add core/geometry/point_cloud-1.0.0.yaml schema [PR 234]

  • add file schema describing a simple linear welding application datamodels/single_pass_weld-1.0.0.schema [PR 256]


  • Simplify tutorial code and enhance plots by using newly implemented plot functions [PR 231] [PR 251]

  • add AWS shielding gas descriptions to documentation [PR 270]




0.2.2 (30.11.2020)#


  • Added util.ureg_check_class class decorator to enable pint dimensionality checks with @dataclass [PR 179].

  • Made coordinates and orientations optional for LCS schema. Missing values are interpreted as unity translation/rotation. An empty LCS object represents a unity transformation step. [PR 177]

  • added welding.util.lcs_coords_from_ts function [PR 199]

  • add a tutorial with advanced use case for combining groove interpolation with different TCP movements and distance calculations [PR 199]


  • refactor welding groove classes [PR 181]

    • refactor groove codebase to make use of subclasses and classnames for more generic functions

    • add _meta attribute to subclasses that map class attributes (dataclass parameters) to common names

    • rework get_groove to make use of new class layout and parse function arguments

  • create welding module (contains GMAW processes and groove definitions) [PR 181]

  • move GmawProcessTypeAsdf to asdf/tags folder [PR 181]

  • reorder module imports in weldx.__init__ [PR 181]

  • support timedelta dtypes in ASDF data_array/variable [PR 191]

  • add set_axes_equal option to some geometry plot functions (now defaults to False) [PR 199]

  • make welding.util.sine public function [PR 199]

  • switch to setuptools_scm versioning and move package metadata to setup.cfg [PR 206]


  • refactor ISO 9692-1 groove schema definitions and classes [PR 181]

    • move base schema definitions in file terms-1.0.0.yaml to weldx/groove

    • split old schema into multiple files (1 per groove type) and create folder iso_9692_1_2013_12

0.2.1 (26.10.2020)#


ASDF extension & schemas#

  • add weldx.asdf.types.WxSyntaxError exception for custom weldx ASDF syntax errors [PR 99]

  • add custom wx_tag validation and update wx_property_tag to allow new syntax [PR 99]
    the following syntax can be used:
    wx_tag:* # allow every version
    wx_tag: # fix major version
    wx_tag: # fix minor version
    wx_tag: # fix patch version
  • add basic schema layout and GmawProcess class for arc welding process implementation [PR 104]

  • add example notebook and documentation for arc welding process [PR 104]

  • allow optional properties for validation with wx_shape by putting the name in brackets like (optional_prop) [PR 176]


  • fix propagating the name attribute when reading an ndarray TimeSeries object back from ASDF files [PR 104]

  • fix pint regression in TimeSeries when mixing integer and float values [PR 121]

0.2.0 (30.07.2020)#


0.1.0 (05.05.2020)#


  • add basic file/directory layout for asdf files

    • asdf schemas are located in weldx/asdf/schemas/

    • tag implementations are in weldx/asdf/tags/weldx

  • implement support for pint quantities

  • implement support for basic pandas time class

  • implement base welding classes from AWS/NIST “A Welding Data Dictionary”

  • add and implement ISO groove types (DIN EN ISO 9692-1:2013)

  • add basic jinja templates and functions for adding simple dataclass objects

  • setup package to include and install ASDF extensions and schemas (see,

  • add basic tests for writing/reading all ASDF classes (these only run code without any real checks!)


  • add package configuration for install

    • required packages

    • package metadata

    • asdf extension entry points

    • version support

  • update pandas, scipy, xarray and pint minimum versions (in conda env and

  • add versioneer

  • update options in setup.cfg

  • update tool configurations