written by: Renato Naville Watanabe
##Files to perform discrete nonlinear system identification and analysis
The files in this repository were written to perform the system identification of nonlinear systems. An updated version can be found in https://github.com/rnwatanabe/FROLSIdentification. The method used is the algorithm known as Forward Regression with Orthogonal Least Squares (FROLS), developed by Stephen Billings and his group. All the files were written by me, Renato Naville Watanabe, except the v2struct.m file, used to deal with the structs from Matlab.
How to use the files
Download all the files in the same directory. The files were written to run in the Matlab® platform, so if you want to run them on Matlab®, you will need a license of the Matlab® software. To run the functions that compute the Generalized Frequency Response Function (GFRF) and Nonlinear Output Frequency Response Function (NOFRF), you will need a license of the Matlab® Symbolic Math Toolbox™.
Once you have downloaded all the files in the same directory, run the FROLSTest.m file to execute an example.
Although all the files were written in Matlab®, they work equally well in the free software GNU Octave. To use the files from this repository in Octave you must have installed the symbolic package (http://octave.sourceforge.net/symbolic/). To use the symbolic package from Octave you must have a Python installation with the SymPy library. I recommend the use of the Anaconda distribution of Python (https://www.continuum.io/downloads). The files were tested in the Octave 4.0 version on Ubuntu (https://www.gnu.org/software/octave/download.html).
To execute an example on GNU Octave, download all the files in the same directory and run the FROLSTest.m file.
An explanation of the algorithm implementation is also available in the format of notebook. You can also download the notebook file and execute in your own computer. In this case you will need to install the Jupyter environment and either the Matlab or Octave kernel.
How to cite this work
If you use the codes from this repository, please cite the following paper as the used implementation of the algorithm:
"WATANABE, R. N.; KOHN, A. F. System identification of a motor unit pool using a realistic neuromusculoskeletal model. In: 5th IEEE RAS & EMBS International Conference on Biomedical Robotics and Biomechatronics, 2014. p. 610–615."
If you use the GFRF part of this repository, please cite the following paper as the used implementation of the algorithm:
"WATANABE, R. N, ; KOHN, A.F .(2017). Nonlinear frequency-domain analysis of the transformation of cortical inputs by a motoneuron pool-muscle complex. IEEE Transactions on Neural Systems and Rehabilitation Engineering, 4320(c), 1–1."
You can find the Bibtex file of this reference here.
The development of the software presented here was fully funded by the São Paulo Research Foundation (FAPESP, grant number 2011/21103-7).
This work is licensed under the GNU GENERAL PUBLIC LICENSE 3.