Documentation

To load example data to use in the Curve Fitting app, enter load franke at the MATLAB^® command line. The variables x, y, and z appear in your workspace.

The example data is generated from Franke's bivariate test function, with added noise and scaling, to create suitable data for trying various fit settings in Curve Fitting app. For details on the Franke function, see the following paper:

Franke, R., Scattered Data Interpolation: Tests of Some Methods, Mathematics of Computation 38 (1982), pp. 181–200.

To divide the data into fitting and validation data, enter the following syntax:

xv = x(200:293);
yv = y(200:293);
zv = z(200:293);
x = x(1:199);
y = y(1:199);
z = z(1:199); 

To fit a surface using this example data:

The Curve Fitting app plots the data points as you select variables. When you select x, y, and z, the tool automatically creates a default surface fit. The default fit is an interpolating surface that passes through the data points.

Try a Lowess fit type. Select the Lowess fit type from the drop-down list in the Curve Fitting app.

The Curve Fitting app creates a local smoothing regression fit.

Try altering the fit settings. Enter 10 in the Span edit box.

By reducing the span from the default to 10% of the total number of data points you produce a surface that follows the data more closely. The span defines the neighboring data points the toolbox uses to determine each smoothed value.

Edit the Fit name to Smoothing regression.

If you divided your data into fitting and validation data in step 2, select this validation data. Use the validation data to help you check that your surface is a good model, by comparing it against some other data not used for fitting.

Review your selected validation data in the plots and the validation statistics (SSE and RMSE) in the Results pane and the Table of Fits.

Create another fit to compare by making a copy of the current surface fit. Either select Fit > Duplicate "Smoothing regression", or right-click the fit in the Table of Fits, and select Duplicate

The tool creates a new fit figure with the same fit settings, data, and validation data. It also adds a new row to the table of fits at the bottom.

Change the fit type to Polynomial and edit the fit name to Polynomial.

Change the Degrees of x and y to 3, to fit a cubic polynomial in both dimensions.

Look at the scales on the x and y axes, and read the warning message in the Results pane:

Equation is badly conditioned. Remove repeated data points
         or try centering and scaling.

Select the Center and scale check box to normalize and correct for the large difference in scales in x and y.

Normalizing the surface fit removes the warning message from the Results pane.

Look at the Results pane. You can view (and copy if desired):

Linear model Poly33:
     f(x,y) = p00 + p10*x + p01*y + p20*x^2 + p11*x*y...
                    + p02*y^2 + p30*x^3 + p21*x^2*y 
                    + p12*x*y^2 + p03*y^3
       where x is normalized by mean 1977 and std 866.5
       and where y is normalized by mean 0.4932 and std 0.29
Coefficients (with 95% confidence bounds):
       p00 =      0.4359  (0.3974, 0.4743)
       p10 =     -0.1375  (-0.194, -0.08104)
       p01 =     -0.4274  (-0.4843, -0.3706)
       p20 =      0.0161  (-0.007035, 0.03923)
       p11 =     0.07158  (0.05091, 0.09225)
       p02 =    -0.03668  (-0.06005, -0.01332)
       p30 =     0.02081  (-0.005475, 0.04709)
       p21 =     0.02432  (0.0012, 0.04745)
       p12 =    -0.03949  (-0.06287, -0.01611)
       p03 =      0.1185  (0.09164, 0.1453)

Goodness of fit:
  SSE: 4.125
  R-square: 0.776
  Adjusted R-square: 0.7653
  RMSE: 0.1477

Goodness of validation:
  SSE : 2.26745
  RMSE : 0.155312

To export this fit information to the workspace, select Fit > Save to Workspace. Executing this command also exports other information such as the numbers of observations and parameters, residuals, and the fitted model.

You can treat the fitted model as a function to make predictions or evaluate the surface at values of X and Y. For details see Exporting a Fit to the Workspace.

Display the residuals plot to check the distribution of points relative to the surface. Click the toolbar button or select View > Residuals Plot.

Right-click the residuals plot to select the Go to X-Z view. The X-Z view is not required, but the view makes it easier to see to remove outliers.

To remove outliers, click the toolbar button or select Tools > Exclude Outliers.

When you move the mouse cursor to the plot, it changes to a cross-hair to show you are in outlier selection mode.

To compare your fits side-by-side, use the tile tools. Select Window > Left/Right Tile, or use the toolbar buttons.

Review the information in the Table of Fits. Compare goodness-of-fit statistics for all fits in your session to determine which is best.

To save your interactive surface fitting session, select File > Save Session. You can save and reload sessions to access multiple fits. The session file contains all the fits and variables in your session and remembers your layout.

After interactively creating and comparing fits, you can generate code for all fits and plots in your Curve Fitting app session. Select File > Generate Code.

The Curve Fitting app generates code from your session and displays the file in the MATLAB Editor. The file includes all fits and plots in your current session.

Save the file with the default name, createFits.m.

You can recreate your fits and plots by calling the file from the command line (with your original data or new data as input arguments). In this case, your original variables still appear in the workspace.