HysTool Toolbox

Download

Toolbox

Download HysTool Toolbox [version v1.4]

Description

Overview

HysTool is an Object-Oriented-Programming-based MATLAB toolbox which allows to:

• Fit hysteresis and creep models (Prandtl-Ishlinskii, power-law, Kuhnen and Preisach) based on experimental data;
• Simulate hysteresis and creep models in MATLAB or Simulink;
• Generate inverse models, i.e., compensators;
• Simulate hysteresis and creep compensators in MATLAB or Simulink;
• Generate C files for the microcontroller implementation of the compensators, useful for a real-time compensation of hysteretic systems;

Requirements

The toolbox has been tested on MATLAB R2015b with Windows 10 and Ubuntu 16.04 operating systems.
No compatibility issues are expected with different MATLAB versions (not older than MATLAB R2009) and different operating systems.
The toolbox employes MEX files, i.e., functions written in C which are called by MATLAB.
This allows to really increase the computation speed. Nevertheless, a C compiler is required to compile mex files. Type

>> mex -setup

to configure your compiler.

Installation instructions

In order to install HysTool toolbox follow these steps:

1. Open MATLAB;
2. Move to the HysTool folder;
3. Type
   >> setup
   
4. When asked, type
   >> y
   to compile mex files (if you use Windows 10 64 bit or Ubuntu 16.04 64 bit, you can type n, since compiled mex files are included in the toolbox).
   If the MATLAB path cannot be saved, you will need to perform the installation every time you run MATLAB.

Acknowledgements

Developers

• Alberto Oliveri - University of Genoa, Italy
• Matteo Lodi - University of Genoa, Italy

Reference

If you use the toolbox for research, please cite the following paper:

1. Oliveri A., Lodi M., Stellino F., Storace M., "Modeling and compensation of hysteresis and creep: the HysTool toolbox",
   2018 International Symposium on Circuits and Systems (ISCAS), Florence (Italy), May 27-30, 2018. In the press.
   [bibtex]