Metadata-Version: 2.1
Name: weldx
Version: 0.4.0
Summary: Python API for the WelDX file format and standard
Home-page: https://www.bam.de/weldx
Author: Cagtay Fabry
Author-email: Cagtay.Fabry@bam.de
License: BSD License
Project-URL: Documentation, https://weldx.readthedocs.io
Project-URL: Source Code, https://github.com/BAMweldx/weldx
Project-URL: Bug Tracker, https://github.com/BAMweldx/weldx/issues
Project-URL: Changelog, https://github.com/BAMweldx/weldx/blob/master/CHANGELOG.md
Description: # WelDX - data and quality standards for welding research data
        
        [![Documentation](https://readthedocs.org/projects/weldx/badge/?version=latest)](https://weldx.readthedocs.io/en/latest/?badge=latest)
        [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/BAMWelDX/weldx/master?urlpath=lab/tree/tutorials/welding_example_01_basics.ipynb)
        [![Anaconda-Server Badge](https://anaconda.org/conda-forge/weldx/badges/version.svg)](https://anaconda.org/conda-forge/weldx)
        [![License](https://img.shields.io/badge/License-BSD%203--Clause-orange.svg)](https://opensource.org/licenses/BSD-3-Clause)
        
        ## 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](https://www.bam.de/Navigation/EN/About-us/Organisation/Organisation-Chart/President/Department-9/Division-93/division93.html)
        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](https://www.iso.org/standard/62520.html) 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](https://en.wikipedia.org/wiki/Advanced_Scientific_Data_Format) 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](https://weldx.readthedocs.io/en/stable/api.html). Further we provide
        rich [Jupyter notebook tutorials](https://weldx.readthedocs.io/en/stable/tutorials.html) 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](https://pint.readthedocs.io/en/stable/), which flawlessly handles the creation and conversion of units and
        dimensions.
        
        ## Publications
        
        - Recommendations for an Open Science approach to welding process research data. Fabry, C., Pittner, A., Hirthammer, V.
          et al. *Weld World* (2021). https://doi.org/10.1007/s40194-021-01151-x
        
        ## Installation
        
        The WelDX package can be installed using conda or mamba package manager from the :code:`conda-forge` channel. These
        managers originate from the freely available [Anaconda Python stack](https://docs.conda.io/en/latest/miniconda.html). If
        you do not have Anaconda or Miniconda installed yet, we ask you to install `Miniconda-3`. Documentation for the
        installation procedure can be
        found [here](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html#regular-installation). After
        this step you have access to the conda command and can proceed to installing the WelDX package.
        
        ```console
        conda install weldx -c conda-forge
        ```
        
        The package is also available on pypi.
        
        ```console
        pip install weldx
        ```
        
        ## Documentation
        
        The full documentation is published on readthedocs.org. Click on one of the following links to get to the desired
        version:
        
        - [latest](https://weldx.readthedocs.io/en/latest/)
        - [stable](https://weldx.readthedocs.io/en/stable/)
        
        ## Funding
        
        This research is funded by the Federal Ministry of Education and Research of Germany under project number 16QK12.
        
        ## Repository status
        
        ### Continuous Integration
        
        [![pytest](https://github.com/BAMWelDX/weldx/workflows/pytest/badge.svg?branch=master)](https://github.com/BAMWelDX/weldx/actions?query=workflow%3Apytest+branch%3Amaster)
        [![conda build](https://github.com/BAMWelDX/weldx/workflows/conda%20build/badge.svg?branch=master)](https://github.com/BAMWelDX/weldx/actions?query=workflow%3A%22conda+build%22+branch%3Amaster)
        
        ### Code Status
        
        [![static analysis](https://github.com/BAMWelDX/weldx/workflows/static%20analysis/badge.svg?branch=master)](https://github.com/BAMWelDX/weldx/actions?query=workflow%3A%22static+analysis%22+branch%3Amaster)
        [![Codacy Badge](https://api.codacy.com/project/badge/Grade/5e7ede6d978249a781e5c580ed1c813f)](https://www.codacy.com/gh/BAMWelDX/weldx?utm_source=github.com&utm_medium=referral&utm_content=BAMWelDX/weldx&utm_campaign=Badge_Grade)
        [![codecov](https://codecov.io/gh/BAMWelDX/weldx/branch/master/graph/badge.svg)](https://codecov.io/gh/BAMWelDX/weldx)
        [![DeepSource](https://static.deepsource.io/deepsource-badge-light-mini.svg)](https://deepsource.io/gh/BAMWelDX/weldx/?ref=repository-badge)
        
        ### Documentation build
        
        [![Documentation Status](https://readthedocs.org/projects/weldx/badge/?version=latest)](https://weldx.readthedocs.io/en/latest/?badge=latest)
        [![documentation](https://github.com/BAMWelDX/weldx/workflows/documentation/badge.svg?branch=master)](https://github.com/BAMWelDX/weldx/actions?query=workflow%3Adocumentation+branch%3Amaster)
        
Keywords: welding,weldx,bam
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: test
