Metadata-Version: 1.2
Name: pyadrc
Version: 0.2.1
Summary: Active Disturbance Rejection Control for Python
Home-page: https://github.com/onguntoglu/pyadrc
Author: Ongun Türkcüoglu
Author-email: onguntoglu@gmail.com
License: MIT license
Description: ==================================
        Welcome to pyadrc's Documentation!
        ==================================
        
        
        .. image:: https://img.shields.io/pypi/v/pyadrc.svg
                :target: https://pypi.python.org/pypi/pyadrc
        
        .. image:: https://www.travis-ci.com/onguntoglu/pyadrc.svg?branch=master
            :target: https://www.travis-ci.com/onguntoglu/pyadrc
        
        .. image:: https://readthedocs.org/projects/pyadrc/badge/?version=latest
                :target: https://pyadrc.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://codecov.io/gh/onguntoglu/pyadrc/branch/master/graph/badge.svg?token=V8WT0V43QD
              :target: https://codecov.io/gh/onguntoglu/pyadrc
              :alt: Codecov
        
        .. image:: https://img.shields.io/github/license/onguntoglu/pyadrc.svg
                :target: https://github.com/onguntoglu/pyadrc/blob/master/LICENSE
                :alt: Licence
        
        .. image:: https://pepy.tech/badge/pyadrc
                :target: https://pepy.tech/project/pyadrc
                :alt: Downloads
        
        
        Active Disturbance Rejection Control for Python
        
        
        A simple, yet powerful control method for when a PID controller just doesn't cut it.
        
        
        Features
        --------
        
        * Discrete linear time invariant active disturbance rejection controller for digital control systems.
        * Implementation in state-space representation form of first- and second-order ADRC.
        * For practical application - half-gain tuning, magnitude and rate limiter for actuator limitations
        * User guide and/or theoretical background (for when you don't have anything else to read).
        * A first/second-order LTI model generator and a quadcopter altitude model for experimentation, testing and verification.
        
        
        Installation
        ------------
        
        Installing **pyadrc** is really simple, just run this command in your terminal:
        
        .. code-block:: bash
        
                pip install pyadrc
        
        or you can clone the repository and install it manually:
        
        .. code-block:: bash
        
                git clone git://github.com/onguntoglu/pyadrc
                cd pyadrc
                python setup.py install
        
        
        Guides
        ------
        
        Although ADRC is more complex than a standard PID controller, it can definitely be applied to various projects with relative ease. It is certainly advantageous to have some background in classical and modern control theory, which are commonly taught in undergradute electrical and/or computer engineering courses.
        
        If you are just interested in using the control method, head over to Section **Introduction**. However, if you want to learn more about the math and control theory, check out **Article** (written by me).
        
        
        Licence
        -------
        
        **pyadrc** is licenced under the MIT Licence
        
        
        Acknowledgements
        ----------------
        
        None of this work would be possible without **Gernot Herbst** and his papers:
        
        * *Practical Active Disturbance Rejection Control: Bumpless Transfer, Rate Limitation and Incremental Algorithm*, https://arxiv.org/abs/1908.04610
        * *A Simulative Study on Active Disturbance Rejection Control (ADRC) as a Control Tool for Practitioners*, https://arxiv.org/abs/1908.04596
        * *Transfer Function Analysis and Implementation of Active Disturbance Rejection Control*, https://arxiv.org/abs/2011.01044
        * *Half-Gain Tuning for Active Disturbance Rejection Control*, https://arxiv.org/abs/2003.03986
Keywords: pyadrc
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
