ipf(arg1,arg2,arg3,​arg4)

Keyboard operated peak fitting function for time-series signals.
6.8K Downloads
Updated 23 Dec 2018

View License

An interactive peak fitting program for time-series signals, written as a self-contained function in a single m-file. Uses a non-linear optimization algorithm to decompose a complex, overlapping-peak signal into its component parts. The objective is to determine whether your signal can be represented as the sum of fundamental underlying peaks shapes. Accepts signals of any length, including those with non-integer and non-uniform x-values. See http://www.wam.umd.edu/~toh/spectrum/InteractivePeakFitter.htm for more information. Version 13.2, December 2018: D key saves model to disc as SavedModel.mat, containing two matrices: DataSegment and ModelMatrix. To place model in the workspace, type load SavedModel; to plot saved DataSegment, type plot(DataSegment(:,1), DataSegment(:,2)); to plot SavedModel, type plot(ModelX,ModelMatrix); each component in the model will be plotted in a different color.

Cite As

Tom O'Haver (2024). ipf(arg1,arg2,arg3,arg4) (https://www.mathworks.com/matlabcentral/fileexchange/23452-ipf-arg1-arg2-arg3-arg4), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2017b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Acknowledgements

Inspired: peakfit.m

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
13.2.0.0

Version 13.2, December 2018. Modified "d" key to save the model to disc as SavedModel.mat.

13.1.0.0

Version 13, November, 2017: 24 peak shapes selectable by single-keypress; 49 peak shapes selectable from menu (press "-")
Version 13, November, 2017. 24 peak shapes selectable by single-keypress; 49 peak shapes selectable from menu (press "-")

11.3.0.0

October, 2015. Version 113 adds lognormal model(o); minimum peak width constraint (Shift-W); saturation maximum (shift-M) to ignore points above saturation maximum.

1.49.0.0

Version 11 adds polynomial fits (Shift-o, for pOlyminial), bug fixes, adds Shift-Ctrl-S and Shift-Ctrl-P keys to transfer the current signal to iSignal and iPeak.

1.48.0.0

Version 10.4, June, 2014. Moves fitting result text to bottom panel of graph. Log mode (M key) toggles log mode on/off, fits log(model) to log(y). Replaces bifurcated Lorentzian with Breit-Wigner-Fano resonance peak (Shift-B key; Shape=15).

1.47.0.0

Version 10.3 adds a "down step" sigmoid (Shift-D; shape #23).

1.46.0.0

Version 10.2 fixes some bugs in the X key and C key functions in the bipolar (+ and -) mode.

1.45.0.0

Version 10 adds support for multiple-shape models.

1.44.0.0

Version 9.84 has some bug fixes related to starting values.

1.43.0.0

Version 9.8 adds Shift-C to specify custom first guess ('start' vector).

1.42.0.0

Version 9.7 adds Voigt profile shape; corrects for flat baseline if autozero mode 3.

1.41.0.0

Version 9.5 adds two new peak shapes: exponentially broadened Lorentzian and the alpha function.

1.39.0.0

Version 9.2: bug fixes; Reorganized peak shape table ('-' key)

1.37.0.0

Version 9.1 Adds fixed-position Gaussians (shape 16) and fixed-position Lorentzians (shape 17). Adds peak shape selection menu (activated by '-' key)

1.36.0.0

Version 9: Accepts additional input arguments to set the initial pan and zoom to focus on the data segment 'window' points wide, centered at x=center.

1.35.0.0

Version 8.94: Improved accuracy of autozero calculation.

1.34.0.0

Version 8.92: Added elapsed time to Q and R reports; Bug fixes; Slight improvement in speed of exponentially broadened shapes.

1.33.0.0

Added Gaussian/Lorentzian blend, bifurcated Gaussian, and bifurcated Lorentzian. Shift-X to enter value of 'Extra' for variable shapes; Shift-A and Shift-Z fine-tune the 'extra' variable. Bug fixes.

1.32.0.0

Version 8.8 has no limit in the number of peaks in the model.

1.31.0.0

Version 8.61 adds a simple built-in IQR function for those without the Statistics Toolbox.

1.30.0.0

Version 8.6 adds Fixed-width Gaussian (Shift-G key; shape number 11) and Fixed-width Lorentzian (Shift-L key; shape number 12)

1.29.0.0

Version 8.5, June 2012, Exponential
broadening uses normal rather than circular convolution.

1.27.0.0

Enhancements to the bootstrap statistics function.

1.26.0.0

Version 8, April 2012, Added bootstrap
sampling estimation of standard deviations of peak parameters ('v' key).

1.25.0.0

Version 7.1, Jan. 2012, Bug fixes in
background subtraction modes and in handlng very small data sets.

1.24.0.0

Version 7, Oct. 2011, adds linear/log
mode (M key) and exponential pulse and sigmoid models (U and S keys)

1.23.0.0

Version 6: T key (autozero) cycles through none, linear, and quadratic background subtraction. Minor bug fixes.

1.18.0.0

Version 5.9 adds user-selected number of points in background subtraction.

1.17.0.0

Add exponentially-broadened equal width Gaussians peak shape (J key)

1.16.0.0

Version 5.5 adds equal-width Gaussian and
Lortentzians and an 8-point baseline subtraction option.

1.14.0.0

Version 5.4, August, 2011: improved flexibility for data input arguments.

1.13.0.0

Bug fixes in Print peakfit function (W) and exponentially-broadened Gaussian.

1.12.0.0

Version 5.1 July 20, 2011: reformatted peak table on figure window, bug fixes

1.10.0.0

bug fix

1.9.0.0

Version 5.0 adds: graph of fitted peaks on the full signal display; Y command to display the entire signal full screen without cursors; various UI improvements and bug fixes.

1.8.0.0

Some minor big fixes and display improvements.

1.7.0.0

Expanded description

1.6.0.0

Improved performance on newer versions of Matlab; tested on 7.8 (R2009a).

1.5.0.0

Version 4.1, April 18: Added Autozero ON/OFF notification at top, and "k" keypress to print out list of commands.

1.4.0.0

Version 4: April 2008: Added keypress function "x" to refine the fit by performing 10 trial fits with slightly different first guesses and take the one with the lowest fitting error.

1.3.0.0

Version 3.5 computes the model at 100 points regardless of number of data points; adds keypress functions "t" to toggle between normal and autozero mode, and "d" to print out x,y values of the current data segment.

1.0.0.0