Skip to content

Latest commit

 

History

History
85 lines (65 loc) · 4 KB

README.md

File metadata and controls

85 lines (65 loc) · 4 KB

GEARS

by Jake Alan Pitt and Julio R. Banga

DOI

GEARS (Global parameter Estimation with Automated Regularisation via Sampling) is a Matlab toolbox for parameter estimation in nonlinear dynamic models composed of deterministic ordinary differential equations (ODEs). GEARS is based on the combination of three main strategies: (i) global optimisation (to avoid convergence to local solutions), (ii) reduction of the search space (i.e. tighter bounds on parameters), (iii) regularised estimation, a strategy used to handle overfitting (i.e. fitting the noise rather than the signal). As a result, GEARS can allow the user to avoid both underfitting and overfitting problems while requiring minimum supervision from the user. These capabilities are especially useful when calibrating ODE-based models with highly nonlinear and flexible dynamics (e.g. models of biological oscillators).

Features

  • Unsupervised parameter estimation
    • Efficient Global optimisation
    • Automated regularisation tuning
    • Parameter bounding
  • Post-fit analyses
    • Normalised root mean square error (NRMSE)
    • R2 test
    • chi2 test
    • Parameter uncertainty (using Fisher information)
    • Correlation matrix (using Fisher information)
    • Active bounds
  • Post-fit plotting
    • Trajectories for Fitting and cross-validation
    • Parameter space samples
    • Visualisation of parameter bound reduction
    • Residuals
    • Predictions vs measurements
    • Trajectory uncertainty (via Fisher information)
    • Convergence curves
  • Results reports
    • html markup of results
    • xls markup of results
    • Combined pdf report of all plotted Figures

Requirements

GEARS runs on Matlab R2015b or later and is multi-platform (Windows and Linux). Both the optimisation and symbolic mathematics Matlab toolboxes are required to run GEARS.

GEARS requires that the AMICI package has been correctly installed.

Optionally, users can use Ghostscript for the exportation of figure reports.

Citations

If you use this toolbox and publish the results, please cite it with the following references.

Regarding the methodology:
Pitt, J.A. and Banga, J.R. (2018) Parameter estimation in models of biological oscillators: an automated regularised estimation approach. Submitted.

Regarding the software:
Pitt, J.A. and Banga, J.R. (2018) GEARS - a toolbox for Global parameter Estimation with Automated Regularisation via Sampling.
doi: 10.5281/zenodo.1420465

Documentation

GEARS' documentation is available in PDF format. Said documentation gives a detailed description of how to install and use the GEARS package with illustrative examples.

License

GEARS is distributed under the GNU General Public License version 3 (GPL v3). Copyright 2018 Jake Alan Pitt and Julio R. Banga.

Acknowledgements

GEARS was developed at (Bio)Process Engineering group - IIM-CSIC, Spanish National Research Council c/Eduardo Cabello, 6. 36208, Vigo (Spain). This research received funding from the European Union's Horizon 2020 research and innovation program under grant agreement No 675585 (MSCA ITN \SyMBioSys") and from the Spanish MINECO/FEDER project SYNBIOCONTROL (DPI2017-82896-C2-2-R). Jake Alan Pitt is a Marie Sklodowska-Curie Early Stage Researcher under the supervision of Prof. Julio R. Banga.

Support

Please check the document and examples carefully before contacting the authors. Please pay special attention to section 9 of the documentation. If needed, they can be contacted by email at:

Jake Alan Pitt - jp00191.su@gmail.com
Julio R. Banga - julio@iim.csic.es.