Weldx

Added

- Added `util.ureg_check_class` class decorator to enable `pint`
dimensionality checks with `dataclass` \[{pull}`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. \[{pull}`177`\]
- added `welding.util.lcs_coords_from_ts` function \[{pull}`199`\]
- add a tutorial with advanced use case for combining groove
interpolation with different TCP movements and distance calculations
\[{pull}`199`\]

Changes

- refactor welding groove classes \[{pull}`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) \[{pull}`181`\]

- move `GmawProcessTypeAsdf` to `asdf/tags` folder \[{pull}`181`\]

- reorder module imports in `weldx.__init__` \[{pull}`181`\]

- support timedelta dtypes in ASDF `data_array/variable` \[{pull}`191`\]

- add `set_axes_equal` option to some geometry plot functions (now
defaults to `False`) \[{pull}`199`\]

- make `welding.util.sine` public function \[{pull}`199`\]

- switch to setuptools_scm versioning and move package metadata to
setup.cfg \[{pull}`206`\]

ASDF

- refactor ISO 9692-1 groove schema definitions and classes \[{pull}`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`

Changes

- Documentation

- Documentation is [published on readthedocs](https://weldx.readthedocs.io/en/latest/)
- API documentation is now available
- New tutorial about 3 dimensional geometries \[{pull}`105`\]

- `CoordinateSystemManager`

- supports multiple time formats and can get a reference time
\[{pull}`162`\]
- each instance can be named
- gets a `CoordinateSystemManager.plot` function to visualize the
graph
- coordinate systems can be updated using
`CoordinateSystemManager.add_cs`
- supports deletion of coordinate systems
- instances can now be merged and unmerged

- `LocalCoordinateSystem`

- `LocalCoordinateSystem` now accepts `pandas.TimedeltaIndex` and
`pint.Quantity` as time inputs when provided with a reference
`pandas.Timestamp` as `time_ref` \[{pull}`97`\]
- `LocalCoordinateSystem` now accepts `WXRotation`-objects as
`orientation` \[{pull}`97`\]
- Internal structure of `LocalCoordinateSystem` is now based on
`pandas.TimedeltaIndex` and a reference `pandas.Timestamp` instead
of `pandas.DatetimeIndex`. As a consequence, providing a reference
timestamp is now optional. \[{pull}`126`\]

- `util.xr_interp_like` now accepts non-iterable scalar inputs for
interpolation. \[{pull}`97`\]

- add `pint` compatibility to some `geometry` classes
(**experimental**)

- when passing quantities to constructors (and some functions),
values get converted to default unit `mm` and passed on as
magnitude.
- old behavior is preserved.

- add `weldx.utility.xr_check_coords` function to check coordinates
of xarray object against dtype and value restrictions \[{pull}`125`\]

- add `weldx.utility._sine` to easily create sine TimeSeries \[{pull}`168`\]

- enable `force_ndarray_like=True` as default option when creating
the global `pint.UnitRegistry` \[{pull}`167`\]

- `util.xr_interp_like` keeps variable and coordinate attributes from
original DataArray \[{pull}`174`\]

- rework `util.to_pandas_time_index` to accept many different formats
(LCS, DataArray) \[{pull}`174`\]

- add utility functions for handling time coordinates to "weldx"
accessor \[{pull}`174`\]

ASDF extension & schemas

- add `weldx.asdf.types.WxSyntaxError` exception for custom weldx
ASDF syntax errors \[{pull}`99`\]
- add custom
`wx_tag`
validation and update
`wx_property_tag`
to
allow new syntax \[
{pull}`99`
\]
the following syntax can be used:
yaml
wx_tag: http://stsci.edu/schemas/asdf/core/software-* # allow every version
wx_tag: http://stsci.edu/schemas/asdf/core/software-1 # fix major version
wx_tag: http://stsci.edu/schemas/asdf/core/software-1.2 # fix minor version
wx_tag: http://stsci.edu/schemas/asdf/core/software-1.2.3 # fix patch version

- add basic schema layout and `GmawProcess` class for arc welding
process implementation \[{pull}`104`\]
- add example notebook and documentation for arc welding process
\[{pull}`104`\]
- allow optional properties for validation with `wx_shape` by putting
the name in brackets like `(optional_prop)` \[{pull}`176`\]

Fixes

- fix propagating the `name` attribute when reading an ndarray
`TimeSeries` object back from ASDF files \[{pull}`104`\]
- fix `pint` regression in `TimeSeries` when mixing integer and float
values \[{pull}`121`\]

ASDF

- add `wx_unit` and `wx_shape` validators

- add `doc/shape-validation.md` documentation for `wx_shape` \[{pull}`75`\]

- add `doc/unit-validation.md` documentation for `wx_unit`

- add unit validation to `iso_groove-1.0.0.yaml`

- fixed const/enum constraints and properties in
`iso_groove-1.0.0.yaml`

- add NetCDF inspired common types (`Dimension`, `Variable`) with
corresponding asdf serialization classes

- add asdf serialization classes and schemas for `xarray.DataArray`,
`xarray.Dataset`, `weldx.transformations.LocalCoordinateSystem` and
`weldx.transformations.CoordinateSystemManager`.

- add test for `xarray.DataArray`, `xarray.Dataset`,
`weldx.transformations.LocalCoordinateSystem` and
`weldx.transformations.CoordinateSystemManager` serialization.

- allow using `pint.Quantity` coordinates in `LocalCoordinateSystem`
\[{pull}`70`\]

- add measurement related ASDF serialization classes: \[{pull}`70`\]

- `equipment/generic_equipment-1.0.0`
- `measurement/data-1.0.0`
- `data_transformation-1.0.0`
- `measurement/error-1.0.0`
- `measurement/measurement-1.0.0`
- `measurement/measurement_chain-1.0.0`
- `measurement/signal-1.0.0`
- `measurement/source-1.0.0`

- add example notebook for measurement chains in tutorials \[{pull}`70`\]

- add support for `sympy` expressions with
`weldx.core.MathematicalExpression` and ASDF serialization in
`core/mathematical_expression-1.0.0` \[{pull}`70`\], \[{pull}`76`\]

- add class to describe time series - `weldx.core.TimeSeries` \[{pull}`76`\]

- add `wx_property_tag` validator \[{pull}`72`\]

the `wx_property_tag` validator restricts **all** properties of an
object to a single tag. For example the following object can have any
number of properties but all must be of type
`tag:weldx.bam.de:weldx/time/timestamp-1.0.0`

yaml
type: object
additionalProperties: true must be true to allow any property
wx_property_tag: tag:weldx.bam.de:weldx/time/timestamp-1.0.0


It can be used as a "named" mapping replacement instead of YAML
`arrays`.

- add `core/transformation/rotation-1.0.0` schema that implements
`scipy.spatial.transform.Rotation` and `WXRotation` class to create
custom tagged `Rotation` instances for custom serialization. \[{pull}`79`\]

- update requirements to `asdf>=2.7` \[{pull}`83`\]

- update `anyOf` to `oneOf` in ASDF schemas \[{pull}`83`\]

- add `__eq__` methods to `LocalCoordinateSystem` and
`CoordinateSystemManager` \[{pull}`87`\]

ASDF

- add basic file/directory layout for asdf files

- asdf schemas are located in
`weldx/asdf/schemas/weldx.bam.de/weldx`
- 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
setup.py, MANIFEST.in)

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

module:

- add setup.py 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 setup.py)

- add versioneer

- update options in setup.cfg

- update tool configurations