kontrol 1.0.0b1

Kontrol

The name “Kontrol” is a blend word combining KAGRA, the gravitational-wave detector in Japan, and control, as in control system. The package contains necessary features for commissioning a KAGRA suspension. These features include:

• Sensor and actuation utilities (kontrol.sensact): Calibration and Sensing/Actuation Matrices

• System Modeling (kontrol.curvefit): Fitting frequency response data using Transfer function model.

• Basic suspension controller design (kontrol.regulator): Damping and position controller with stabilizing post filters such as low-pass and notch filters.

To interface the results generated from the above functionalities to the KAGRA control system, Kontrol also provides:

• Foton utilities (kontrol.foton): converting transfer function to/from Foton strings.

• Ezca wrapper (kontrol.ezca): Fetch/put control matrices to/from the digital system.

The above features form a control design pipeline from calibration to controller design for commissioning KAGRA suspension with basic functionality.

Besides the basic functionalities, Kontrol also contains advanced features are being continuously developed in order to further enhance seismic isolation performance. Currently, Kontrol contains:

• H-infinity optimal complementary filters (kontrol.ComplementaryFilter): Solves complementary control problems, optimizing control filters for sensor fusion, sensor correction, and vibration isolation control problems [1] [2].

• Dynamic mode decomposition (kontrol.dmd): Dynamic mode decomposition for time-series forecasting and modeling. For future model predictive control work.

To familiarize users with the package, step-by-step tutorials are provided. Upon finishing the tutorials, the users should be able to convert the scripts into usable ones interfacing real data that can be used for the physical systems.

While Kontrol was created for setting up active isolation systems for systems in gravitational-wave detectors, it is not exclusive for usage in gravitaional-wave detectors or suspensions. The setup of an active isolation system is similar to many control systems. Kontrol is coded with no presumption of the system in question. So users outside the gravitational-wave and active isolation community may also find this tutorial/package useful.

• Documentation: https://kontrol.readthedocs.io/

• Repository: https://github.com/terrencetec/kontrol.git

Getting Started

conda install -c conda-forge numpy scipy matplotlib control ezca

pip install kontrol

$ git clone https://github.com/terrencetec/kontrol.git
$ cd kontrol
$ pip install .

For Developers

Standards and Tools

Please comply with the following standards/guides as much as possible.