Metadata-Version: 2.1
Name: ubermagutil
Version: 0.4.1
Summary: Utility package used across Ubermag.
Home-page: https://ubermag.github.io
Author: Marijan Beg, Martin Lang, and Hans Fangohr
License: UNKNOWN
Description: # ubermagutil
        Marijan Beg<sup>1,2</sup>, Martin Lang<sup>1</sup>, and Hans Fangohr<sup>1,2,3</sup>
        
        <sup>1</sup> *Faculty of Engineering and Physical Sciences, University of Southampton, Southampton SO17 1BJ, United Kingdom*  
        <sup>2</sup> *European XFEL GmbH, Holzkoppel 4, 22869 Schenefeld, Germany*  
        <sup>3</sup> *Max Planck Institute for the Structure and Dynamics of Matter, Luruper Chaussee 149, 22761 Hamburg, Germany*   
        
        | Description | Badge |
        | --- | --- |
        | Tests | [![workflow](https://github.com/ubermag/ubermagutil/workflows/workflow/badge.svg)](https://github.com/ubermag/ubermagutil/actions?query=workflow%3Aworkflow) |
        |       | [![conda](https://github.com/ubermag/ubermagutil/workflows/conda/badge.svg)](https://github.com/ubermag/ubermagutil/actions?query=workflow%3Aconda) |
        | Releases | [![PyPI version](https://badge.fury.io/py/ubermagutil.svg)](https://badge.fury.io/py/ubermagutil) |
        |          | [![Anaconda-Server Badge](https://anaconda.org/conda-forge/ubermagutil/badges/version.svg)](https://anaconda.org/conda-forge/ubermagutil) |
        | Coverage | [![codecov](https://codecov.io/gh/ubermag/ubermagutil/branch/master/graph/badge.svg?token=PFdiNjYmWJ)](https://codecov.io/gh/ubermag/ubermagutil) |
        | Documentation | [![Documentation Status](https://readthedocs.org/projects/ubermagutil/badge/?version=latest)](https://ubermagutil.readthedocs.io/en/latest/?badge=latest) |
        | YouTube | [![YouTube](https://img.shields.io/badge/YouTube-ubermag-blue)](https://www.youtube.com/channel/UC7MSqVQSMFV42R1jAYmKGLg) |
        | Binder | [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/ubermag/ubermagutil/HEAD?urlpath=lab/tree/docs/ipynb/index.ipynb) |
        | Platforms | [![Platforms](https://anaconda.org/conda-forge/ubermagutil/badges/platforms.svg)](https://anaconda.org/conda-forge/ubermagutil) |
        | Downloads | [![Downloads](https://anaconda.org/conda-forge/ubermagutil/badges/downloads.svg)](https://anaconda.org/conda-forge/ubermagutil) |
        | License | [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause) |
        | DOI | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3539490.svg)](https://doi.org/10.5281/zenodo.3539490) |
        
        ## About
        
        `ubermagutil` is a Python package used across [Ubermag](http://ubermag.github.io), providing:
        
        - definition of typesystem descriptors and decorators,
        
        - documentation inheritance decorators,
        
        - determining SI prefixes, and
        
        - various convenience functions.
        
        It is available on Windows, MacOS, and Linux. It requires Python 3.8+.
        
        ## Documentation
        
        APIs and tutorials are available in the documentation. To access the documentation, use the badge in the table above.
        
        ## Installation, testing, and upgrade
        
        We recommend installation using `conda` package manager. Instructions can be found in the documentation.
        
        ## Binder
        
        This package can be used in the cloud via Binder. To access Binder, use the badge in the table above.
        
        ## YouTube
        
        YouTube video tutorials are available on the [Ubermag channel](https://www.youtube.com/channel/UC7MSqVQSMFV42R1jAYmKGLg).
        
        ## Support
        
        If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in [ubermag/help](https://github.com/ubermag/help) repository.
        
        ## Contributions
        
        All contributions are welcome, however small they are. If you would like to contribute, please fork the repository and create a pull request. If you are not sure how to contribute, please contact us by raising an issue in [ubermag/help](https://github.com/ubermag/help) repository, and we are going to help you get started and assist you on the way.
        
        **Contributors**:
        
        - Thomas Kluyver ([@takluyver](https://github.com/takluyver)), European XFEL, Germany
        - Natalie Downing ([@gamdow](https://github.com/gamdow)), University of Southampton, United Kingdom
        
        ## License
        
        Licensed under the BSD 3-Clause "New" or "Revised" License. For details, please refer to the [LICENSE](LICENSE) file.
        
        ## How to cite
        
        1. M. Beg, R. A. Pepper, and H. Fangohr. User interfaces for computational science: A domain specific language for OOMMF embedded in Python. [*AIP Advances* **7**, 56025](http://aip.scitation.org/doi/10.1063/1.4977225) (2017).
        
        2. M. Beg and H. Fangohr. ubermagutil: Utility package used across Ubermag. DOI: [10.5281/zenodo.3539490](http://doi.org/10.5281/zenodo.3539490) (2021).
        
        ## Acknowledgements
        
        - [OpenDreamKit](http://opendreamkit.org/) – Horizon 2020 European Research Infrastructure project (676541)
        
        - EPSRC Programme Grant on [Skyrmionics](http://www.skyrmions.ac.uk) (EP/N032128/1)
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.8
Description-Content-Type: text/markdown
