Package: kontrol
Python package for KAGRA suspension and seismic isolation control.KontrolThe 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 MatricesSystem 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-steptutorialsare 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.gitGetting StartedDependenciesRequiredcontrol>=0.9numpymatplotlibscipyOptionalezca (Needed for accessing EPICs records/real-time model process variables.
Use conda to install it.)vishackordttxml(For extracting data from diaggui xml files.)If you would like to install Kontrol on your local machine with, then pip
should install the required dependencies automatically for you. However, if
you use Kontrol in a Conda environment, you should install the dependencies
before installing Kontrol to avoid using pip. In Conda environment, simply typecondainstall-cconda-forgenumpyscipymatplotlibcontrolezcaUsingCondais strongly recommended becausecontroldepends onslycotwhich can be cumbersome to install without conda.
Checkthis issueout
if you wish to installslycoton a Linux machine.Install from PyPIpipinstallkontrolInstall from sourceFor local usage, type$gitclonehttps://github.com/terrencetec/kontrol.git$cdkontrol$pipinstall.For k1ctr workstations, make sure a virtual environment is enabled before
installing any packages.For DevelopersStandards and ToolsPlease comply with the following standards/guides as much as possible.Coding stylePEP 8:https://www.python.org/dev/peps/pep-0008/CHANGELOGKeep a Changelog:https://keepachangelog.com/en/1.0.0/VersioningSemantic Versioning:https://semver.org/spec/v2.0.0.htmlPackagingPyPA:https://www.pypa.iopython-packaging:https://python-packaging.readthedocs.ioDocumentationNumPy docstrings:https://numpydoc.readthedocs.io/en/latest/format.htmlSphinx:https://www.sphinx-doc.org/Read The Docs:https://readthedocs.org/Documenting Python Code: A Complete Guide:https://realpython.com/documenting-python-code/[1]T. T. L. Tsang, T. G. F. Li, T. Dehaeze, C. Collette.
Optimal Sensor Fusion Method for Active Vibration Isolation Systems in
Ground-Based Gravitational-Wave Detectors.https://arxiv.org/pdf/2111.14355.pdf[2]Terrence Tak Lun Tsang. Optimizing Active Vibration Isolation Systems in
Ground-Based Interferometric Gravitational-Wave Detectors.https://gwdoc.icrr.u-tokyo.ac.jp/cgi-bin/DocDB/ShowDocument?docid=14296