Spline Toolbox™ Release
Notes
How to Contact The MathWorks
www.mathworks.
comp.soft-sys.matlab Newsgroup
www.mathworks.com/contact_TS.html Technical Support
suggest@mathworks.com Product enhancement suggestions
bugs@mathwo
doc@mathworks.com Documentation error reports
service@mathworks.com Order status, license renewals, passcodes
info@mathwo
com
rks.com
rks.com
Web
Bug reports
Sales, prici
ng, and general information
508-647-7000 (Phone)
508-647-7001 (Fax)
The MathWorks, Inc.
3 Apple Hill Drive
Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site.
Spline Toolbox™ Release Notes
© COPYRIGHT 2002–20 10 by The Mathworks, Inc.
The software described in this document is furnished under a license agreement. The software may be used
or copied only under the terms of the license agreement. No part of this manual may be photocopied or
reproduced in any form without prior written consent from The MathW orks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation
by, for, or through the federal government of the United States. By accepting delivery of the Program
or Documentation, the government hereby agrees that this software or documentation qualifies as
commercial computer software or commercial computer software documentation as such terms are used
or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and
conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern
theuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramand
Documentation by the federal government (or other entity acquiring for or through the federal government)
and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the
government’s needs or is inconsistent in any respect with federal procurement law, the government agrees
to return the Program and Docu mentation, unused, to The Mat hWorks, Inc.
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See
www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand
names may be trademarks or registered trademarks of their respective holders.
Patents
The MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.
Summary by Version ............................... 1
Contents
Version 3.3.8 (R2010a) Spline Toolbox Software
Version 3.3.7 (R2009b) Spline Toolbox Software
Version 3.3.6 (R2009a) Spline Toolbox Software
Version 3.3.5 (R2008b) Spline Toolbox Software
Version 3.3.4 (R2008a) Spline Toolbox Software
Version 3.3.3 (R2007b) Spline Toolbox Software
Version 3.3.2 (R2007a) Spline Toolbox Software
Version 3.3.1 (R2006b) Spline Toolbox Software
Version 3.3 (R2006a) Spline Toolbox Software
Version 3.2.2 (R14SP3) Spline Toolbox Software
...... 4
...... 5
...... 6
...... 7
...... 8
...... 9
...... 10
...... 12
........ 13
...... 18
Version 3.2.1(R14SP1) Spline Toolbox Software
Version 3.2 (R13+) Spline Toolbox Software
Version 3.1.1 (R13) Spline Toolbox Software
Compatibility S umm ary for Spline Toolbox
Software
........................................ 29
.......... 21
.......... 25
...... 20
iii
iv Contents
SummarybyVersion
This table provides quick access to what’s new in each version. For
clarification, see “Using Release Notes” on page 2.
Spline Toolbox™ Release Notes
Version
(Release)
Latest
Version
V3.3.8
(R2010a)
V3.3.7
(R2009b)
V3.3.6
(R2009a
V3.3.5
(R2008b)
V3.3.4
(R2008a)
V3.3.
(R200
V3.3.2
(R2007a)
)
3
7b)
New
Features
and
Changes
Yes
Details
No No
No No
No No
No No Bug Reports No
No No Bug Re
Yes
Details
Version
Compatibilit
Consideratio
No Bug Reports
No Bug Reports No
Fixed
y
Bugs and
ns
Known
Problems
No bug fixes
No bug fixes
No bug fi
ports
Related
Documentation
at Web Site
Printable Release
Notes: PDF
Current product
documentation
No
No
No
xes
No
V3.3.1
(R2006b)
3
V3.
006a)
(R2
V3.2.2
(R14SP3)
V3.2.1
(R14SP1)
Yes
Details
Yes
ails
Det
Yes
Details
No No
No Bug Reports No
Yes
Sum
Yes
Summary
mary
Reports
Bug
Bug Reports No
No bug fixes
No
No
1
Spline Toolbox™ Release N o tes
Version
(Release)
V3.2
(R13+)
V3.1.1
(R13)
New
Features
and
Changes
Yes
Details
Yes
Details
Version
Compatibility
Considerations
Yes
Summary
Yes
Summary
Fixed
Bugs and
Known
Problems
No bug fixes
Fixed bugs
Related
Documentation
at Web Site
No
No
Using Release Notes
Use release notes when upgrading to a newer version to learn about:
• New features
• Changes
• Potential impact on your existing files and practices
Review the release notes for other MathWorks™ products required for this
product (for example, MATLAB
bugs, or compatibility considerations in other products impact you.
If you are upgrading from a software version other than the m ost recent one,
review the current release notes and all interim versions. For example, when
you upg rade from V1.0 to V1.2, review the release notes for V1.1 and V1.2.
®
or Simulink®). Determine if enhancements,
What Is in the Release Notes
New Features and Changes
• New functionality
• Changes to existing functionality
2
SummarybyVersion
Version Compatibility Con si derations
When a new feature or change introduces a reported incompatibility between
versions, the Compatibility Considerations subsection explains the
impact.
Compatibility issues reported after the product release appear under Bug
Reports at The MathWorks™ Web site. Bug fixes can sometimes result
in incompatibilities, so review the fixed bugs in Bug Reports for any
compatibility impact.
Fixed Bugs and Known Problems
The MathWorks offers a user-searchable Bug Reports database so you can
view Bug Reports. The development team updates this database at release
time and as more information becomes available. Bug Reports include
provisions for any known workarounds or file replacem ents. Information is
available for bugs existing in or fixed in Release 14SP2 or later. Information
is not avail able for all bugs in earlier release s.
Access Bug Reports using y our MathWorks Account.
3
Spline Toolbox™ Release N o tes
Version 3.3.8 (R2010a) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.8 (R2010a):
New Features
and Changes
Yes
Details below
Version
Compatibility
Considerations
No Bug Reports
Fixed Bugs
and Known
Problems
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
New Algorithm for Finding Zeros
There is a new algorithm for the fnzeros function, for finding zeros of a spline
function in a given interval. The new algorithm can handle discontinuous
functions. The old version was restricted to continuous spline functions.
The
fnzeros algorithm has changed and so produces different results. The
new algorithm should detect all cases the old algorithm found, and may also
detect some cases the old algorithm missed.
See
fnzeros in the Spline Toolbox™ reference documentation.
4
Version 3.3.7 (R2009b) Spline Toolbox™ Software
Version 3.3.7 (R2009b) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.7 (R2009b):
New Features
and Changes
No No
There are no new features or changes in this version.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
No bug fixes
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
5
Spline Toolbox™ Release N o tes
Version 3.3.6 (R2009a) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.6 (R2009a):
New Features
and Changes
No No
There are no new features or changes in this version.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
No bug fixes
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
6
Version 3.3.5 (R2008b) Spline Toolbox™ Software
Version 3.3.5 (R2008b) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.5 (R2008b):
New Features
and Changes
No No
There are no new features or changes in this version.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
No bug fixes
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
7
Spline Toolbox™ Release N o tes
Version 3.3.4 (R2008a) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.4 (R2008a):
New Features
and Changes
No No Bug Reports
There are no new features or changes in this version.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
8
Version 3.3.3 (R2007b) Spline Toolbox™ Software
Version 3.3.3 (R2007b) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.3 (R2007b):
New Features
and Changes
No No Bug Reports
There are no new features or changes in this version.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
9
Spline Toolbox™ Release N o tes
Version 3.3.2 (R2007a) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.2 (R2007a):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “spapi Data with Repeated Sites” on page 10
• “New Reference Pages” on page 10
Version
Compatibility
Considerations
No Bug Reports
Fixed Bugs
and Known
Problems
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
spapi Data with Repeated Sites
For the spapi command, which provides spline interpolation, you can now
choose that, at a repeated data site, the average of the corresponding data
values be interpolated.Usethenew(fourth)
specify this choice. If you omit the
sites are taken in the osculatory sense, as prescribing values of successive
derivatives at such a site.
'noderiv' argument, data with repeated
spapi argument 'noderiv' to
10
New Reference Pages
Existing Spline Toolbox commands shown in the following table, now are
documented in reference pages.
Function Description
franke
spterms
Franke’s bivariate test function
Explanation of Spline Toolbox terms
Version 3.3.2 (R2007a) Spline Toolbox™ Software
Function Description
subplus
titanium
Positive part
Titanium heat data
11
Spline Toolbox™ Release N o tes
Version 3.3.1 (R2006b) Spline Toolbox Software
This table summarizes what’s new in Version 3.3.1 (R2006b):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “Significant Speedup in Spline Evaluation” on page 12
Version
Compatibility
Considerations
No Bug Reports
Fixed Bugs
and Known
Problems
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
Significant Speedup in Spline Evaluation
Spline evaluation requires the determination of the knot or break in terval
within which a given evaluation site lies. The determination of this interval
is now calculated more efficiently to provide an overall speedup of the spline
evaluation.
12
Version 3.3 (R2006a) Spline Toolbox™ Software
Version 3.3 (R2006a) Spline Toolbox Software
This table summarizes what’s new in Version 3.3 (R2006a):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “Controlled Extrapolation Beyond the Basic Interval” on page 13
• “Interpolating Planar Tangent-Continuous Piecewise B iarc Curve” on
page 14
• “rsmakNowProvidesaTorusAsWell As a Longer Arc” on page 15
• “rsmak Input and Output For Getting an Arc Is Changed” on page 15
• “Part ’k...’ For a Ppform D isallowed” on page 16
• “Strange Error Message from fnval Elimina ted” on page 16
• “Changes to Spline Tool” on page 16
Version
Compatibility
Considerations
Yes—Details
labeled as
Compatibility
Considerations,
below. S e e als o
Summary.
Fixed Bugs
and Known
Problems
Bug Reports
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
Controlled Extrapolation Beyond the B asic Interval
When a spline in ppform is e valuated at some site outside its basic interval,
the value at that site of the ’nearest’ polynomial piece is returned. On the
other hand, when a spline in B-form is evaluated outside its basic interval,
thevalue0isreturned. Thesearethetwoextremewaysofextrapolatinga
spline beyond its basic interval. Assuming the spline to be of order k, we use,
in the first case, a polynomial of order k that matches k-fold the spline at the
relevant endpoint of its basic interval, and this we call extrapolation of order
k. In the second case, we use a polynomial of order 0 (i.e., the zero polynomial)
13
Spline Toolbox™ Release N o tes
that matches the spline 0-fold (i.e., perhaps not at all) at the relevant endpoint
of its basic interval, and this we call extrapolation of order 0.
The new toolbox function,
extrapolates the spline in
fnxtr(f,j), returns a spline in ppform that
f to order j,with2 the default value for j in case j
is not explicitly given. This new feature is of immediate use for the evaluation
of smoothing splines since, by its definition, a smoothing spline of order 2m is
to be extrapolated beyond its basic interval to order m, not 0 nor 2m.
A new example, Least-Squares Approximation by "Natural" Cubic Splines in
the Sp line Toolbox docum entation makes essential use of this new feature.
For more information, see the
fnxtr reference page.
Interpolating Planar Tangent-Continuous Piecewise
Biarc Curve
The new to olbox function, r scvn (p,u), provides the planar tangent-continuous
piecewise biarc curve that passes, in order, through the given points
p(:,2),...,p(:,n) in the plane and, for all j,is,atthepointp(:,j),
perpendicular to the vector
u(:,j). Default values for the vectors u(:,j) are
used when the user does not supply them.
rscvn makesuseofthefactthatSplineToolbox can handle rational splines,
hence can represent exactly curves made up of circular arcs. The particular
rational spline used here is piecewise quadratic, with two pieces between
neighboring data points, hence the term biarc. Because of the geometry of the
construction used, users need not provide parameter values associated with
the given data points, as they would have to if they wanted to use
spapi for the construction of a smooth interpolating curve.
p(:,1),
csapi or
14
An added example, in the Spline Toolbox demo "More Spline Curves",
illustrates what may have been a very early use of a tangent-continuous
piecewise circular arc curve.
For more information, see the
rscvn reference page.
Version 3.3 (R2006a) Spline Toolbox™ Software
rsmak Now Provid
rsmak now provid
of the outer and t
Precisely,
rsmak('torus',radius,ratio)
returns a desc
itsaxiswhos
has the radiu
Also,
rsmak('arc',radius,center,[alpha,beta])
returns th
at angle
beta is (in
e circular arc, of the given
pha
al
rsmak Inp
es the rBform of a torus for which you can specify the radii
he inner circle (of which it is, in a way, the tensor product).
ription of the torus centered at the origin and with the
e m ajor circle has the specified
s
radius*ratio.
and ends at angle beta. If the difference between alpha and
absolute va lue ) greater than
ut and Output For Getting an Arc Is
es a Torus As Well As a Longer Arc
radius and the given center,thatstarts
2*pi, the arc includes a full circle.
Changed
Getting
an arc of specified extent used to require the following command:
rsmak('arc',radius,center,alpha,beta)
z-axis
radius, and whose minor circle
in whic
speci
combi
Furt
and m
arc p
h the beginning angle,
fied by two separate input arguments. These two arguments are now
ned into one 2-vector argument, as follows:
rsmak('arc',radius,center,[alpha,beta])
her, the arc now produced starts at angle
ay well cover an entire circle and even more than one. Formerly, the
roduced would never exceed a half circle.
alpha,andendangle,beta,forthearcare
alpha and ends at angle beta
15
Spline Toolbox™ Release N o tes
Compatibility Consideration
You are encouraged to change to the new rsmak syntax. The earlier syntax,
which required separate arguments for
but may be removed in a future release.
Part ’k...’ For a Ppform Disallowed
The request fnbrk(f,part),forthepart'k...' of a ppform now produces
an error message.
Compatibility Consideration
The request fnbrk(f,part),withpart a string starting with 'k',usedto
return the order of the spline in
returns the knot sequence of that spline in case the spline is in B-form. As
this can lead to co nfusion when a user forgets whether the spline of interest is
in ppform or B-form, and the former response was undocumented anyway,
asking for the part
alpha and beta, continues to be valid
f incasethesplineisinppform,whileit
'k...' of a ppform now produces an error message.
16
Strange Error Message from fnval Eliminated
Specifying the evaluation sites for fnval as a column cell array does not
automatically result in an error message.
Compatibility Consideration
When the evaluation sites for fnval are specified by a column cell array
rather than the required row cell array, a mysterious error message would
result. In this situation,
changing the column cell array to a row cell array and give an error message
only if the lengt h of the resulting row cell array is incompatibl e with the
number of variables for the function being evaluated.
fnval now tries to make sense of the input by
Changes to Spline Tool
• Proposed names under which to save the data are now serialized.
• The proposed increments/decrements in a knot’s location to be used now
change suitably when the number of knots changes.
Version 3.3 (R2006a) Spline Toolbox™ Software
• Thelegendinthemaingraphstaysputwhenanapproximationisrenamed.
• A point highlighted in the main graph now always shows in the visible
part of the data point list.
17
Spline Toolbox™ Release N o tes
Version 3.2.2 (R14SP3) Spline Toolbox Software
This table summarizes what’s new in Version 3.2.2 (R14SP3):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “rsmak Now Provides an Arc” on page 18
• “Changes to Spline Tool” on page 19
• “Compatibility Considerations” on page 19
Version
Compatibility
Considerations
Yes—Details
listed under
Compatibility
Considerations,
below. S e e als o
Summary
Fixed Bugs
and Known
Problems
Bug Reports
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
rsmak Now Provides an Arc
rsmak now provides the rBform of an arc for which you can specify the center,
radius, and extent.
rsmak(object,varargin) returns the specific geometric shape specified by
the string
object. For example,
18
rsmak('arc',radius,center,alpha,beta)
provides a quadratic rational that describes the arc of the given radius
(default 1) and center (default (0,0)) of total arc length <= radi us*pi that
covers the angle interval between the given
(default pi).
alpha (default 0) and beta
Version 3.2.2 (R14SP3) S pline Toolbox™ Software
Changes to Splin
• The last of the ex
with spline int
• Deleting the S
generated now
• During longer
to inform the
Compatibili
erpolation rather than cubic spline interpolation.
pline Tool wi ndow after a spline approximation has been
brings up a request for confirmation.
calculations, the cursor now becomes the hour glass symbol
user that the Spline Tool is working.
ty Considerations
eTool
amples offered during startup now starts, appropriately,
B-form Evaluation Outside the Basic Interval Returns 0
Evaluatio
to the defi
returns th
Although
enforced
n of a multivariate spline in B-form at scattered sites now conforms
nition that such a spline is zero outside its basic interval.
e value 0 at any site outside the basic interval of a spline in B-form.
this has been the documented behavior, it was not previously
.
fnval now
spaps Handles Vector-Valued Data Correctly in the Case of
Zero Tolerance.
For the smoothing spline function, spaps, if you prov ide vector-valued data
and specify a tolerance of 0 as a way of interpolating the data,
handles the data correctly. Prior to this change,
message.
spaps produced an error
spaps now
fncmb Returns Error if Only One Coefficient Array Is a Scalar
fncmb now performs stricter input checking to enforce that the two splines f
and g in the command fncmb(f,g) have the same order and the same knot
or break sequences. Previously, if one but not the other of the coefficient
arrays of the splines
results or a confusing error message.
f or g was a scalar, fncmb may have produced incorrect
19
Spline Toolbox™ Release N o tes
Version 3.2.1(R14SP1) Spline Toolbox Software
This table summarizes what’s new in Version 3.2.1 (R14SP1):
New Features
and Changes
No No
This version includes only minor b u g fixes.
Version
Compatibility
Considerations
Fixed Bugs
and Known
Problems
No bug fixes
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
20
Version 3.2 (R13+) Spline Toolbox™ Software
Version 3.2 (R13+) Spline Toolbox Software
This table summarizes what’s new in Version 3.2 (R13+):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “ND-Valued Data and Spline Functions” on page 21
• “Repeated Sites” on page 21
• “Updated Demos” on page 22
• “Toolbox Function Summary” on page 22
• “Compatibility Considerations” on page 23
Version
Compatibility
Considerations
Yes—Details
listed under
Compatibility
Considerations,
below. S e e als o
Summary
Fixed Bugs
and Known
Problems
No bug fixes
Related
Documentation
at Web Site
Printable
Release Notes:
PDF
Current product
documentation
ND-Valued Data and Spline Functions
All *ap* toolbox functions now accept matrix- and ND-valued data. These
functions are:
fn* functions can now handle the resulting matrix- or ND-valued spline
functions.
csape, csapi, csaps, spap2, spapi, spaps, tpaps.Alltoolbox
Repeated Sites
All *ap* toolbox functions now accept data with repeated sites, hence so does
the GUI
splinetool. Specifically,
21
Spline Toolbox™ Release N o tes
csape, csapi
csaps, spaps, spap2, tpaps
spaps
spapi
Replace d ata points having the same
site by their average.
Replace data p oints with the same
site by their weighted average,
with its weight the average
of the corresponding weights.
These functions are concerned
with smoothing or least-squares
approximation.
Adjusts the given tolerance in order
to make up for the resulting change
in the value of the error measure.
Continues
repeated s
osculator
to interpret data with
ites as a request for
y interpolation
Updated Demos
Several demos hav e been enlarged to include additional illustrations and
examples. You can now access the Spline Toolbox demos from the Demos tab
in the Help browser, or you can run them by typing
at the command line.
playshow demoname
22
Toolbox Function Summary
Version 3.2 of Spline To olbox provides the following:
• “New Functions ” on page 22
• “Functions with New or Changed Capabilities ” on page 23
New F
Function Purpose
fnchg
unctions
A new toolbox function fnchg(fn,part,value) enables
you to change the target dimension or the basic interval of
the form in
fn.
Version 3.2 (R13+) Spline Toolbox™ Software
Functions with New or Changed Capabilities
Function Purpose
csape
Input of specifi
now the same as f
you now supply s
additional dat
c end conditions for the univariate case is
or the multivariate case. In both cases,
pecific values for endpoint conditions as
a values. See the reference page for details.
fnbrk
fnval
spap2,
splin
spapi
etool
In earlier ver
to supply spec
the univariat
backward com
release, and
An expanded
[out1,...,
returns th
part1,...
used when t
rpmak, rs
from thes
You can n
sites at
Now req
data va
See “sp
24 for mor
outn] = fnbrk(f,part1,...,partm),
e part(s) of the form in
,partn
he form was put together, in
mak
e.
ow use a multidimensional array to specify the
which
uire that, in case of data
lue corresponding to
ap2, spapi Input Requirements Updated” on page
einformation.
sions, you used a fourth argument,
ific values for endpoint conditions in
e case. This argument remains valid for
patibility, but it may be removed in a future
you are encouraged to discontinue its use.
syntax,
f specified by
,wheren<=m.Thesearetheparts
,orstmak, but also other parts derived
fnval is to evaluate a s pline function.
x,y with y an array, the
x(j) is y(:,j),noty(j,:).
valconds,
spmak, ppmak,
From the new Tools menu, you can now toggle the grid
and the legend. From the Help menu, you can also look up
short descriptions of technical terms used.
Compatibility Considerations
NaNs and Infs
Prior to Version 3.2, NaNsorInfs in the given data would propagate in the
normal way through the calculations, leading to
numbers that make up the output.
NaNsand/orInfsinthe
23
Spline Toolbox™ Release N o tes
Now, any data point containing NaN or Inf is ignored, but a warning to that
effect is printed in the command window. This a ffects all
csape, csapi, csaps, spap2, spapi, spaps,andtpaps.
csape Input Simplified
In the multivariate case, you supply specific values for endpoint conditions as
additional data values. Starting w ith Version 3.2, you should use the same
scheme in the univariate case.
*ap* commands, i.e.,
In earlier versions, you used a fourth argument,
valconds, to supply specific
values for endpoint conditions in the univariate case. This argument remains
valid for backward compatibility, but it may be remo ved in a future release,
and you are encouraged to discontinue its use.
spap2, spapi Input Requirements Updated
For the sake of uniformity with other *ap* commands,
spap2(knots,order,x,y) and spapi(knots,x,y) now require
that, when
in the vector
y(j,:). This change originally appeared in Version 3.2 Release 13+.
Prior to Version 3.2, if
and spapi would take y(j,:), rather than y(:,j),tobethedatavalueat
x(j).
y is an array, y must have as many columns as there are data sites
x. That is, the data value corresponding to x(j) is y(:,j),not
x was a column vector, and y was an array, then spap2
24
Version 3.1.1 (R13) Spline Toolbox™ Software
Version 3.1.1 (R13) Spline Toolbox Software
This table summarizes what’s new in Version 3.1.1 (R13):
New Features
and Changes
Yes
Details below
New features and changes introduced in this version are
• “Smoothing Splines for Scattered Bivariate Data” on page 25
• “splinetool Command History M-File” on page 26
• “Spline-Specif ic Zero Finder” on pa ge 26
• “Spline-Specific Minimum F i n der” on page 26
• “Function Summary” on page 26
• “Compatibility Consideration” on page 27
Version
Compatibility
Considerations
Yes—Details
listed under
Compatibility
Consideration,
below. S e e als o
Summary
Fixed Bugs
and Known
Problems
Fixed bugs Printable
Related
Documentation
at Web Site
Release Notes:
PDF
Current product
documentation
Smoothing Splines for Scattered Bivariate Data
The new command tpaps enables you to create thin-plate spline
approximations f that satisfy, approximately or exactly, the equation
for given data values z at given scattered data sites (x,y)inthe
plane. The associated collocation matrix is provided by
create the first-order derivatives of a thin-plate spline.
stcol.Youcanalso
The spline created by
can create an stform d irectly from its centers and coefficients using
As with all forms, you can evaluate the splines in stform with
them with
fnplt,etc.
tpaps is in stform, as are its first-order derivatives. You
fnval,plot
stmak.
25
Spline Toolbox™ Release N o tes
See "Fitting Values at Scattered 2-D Sites" and "The stform" in the S pline
Toolbox documentation for more information.
splinetool Command History M-File
In the Spline Tool GUI (splinetool), you can now generate a function
M-file that you can use to generate, from the original data, any or all graphs
currently in the GUI. Select File -> Save M-File to save the M-file.
This M-file also provides you with a written record of the Spline Toolbox
commands used to generate the current graph(s), and can be edited, or
executed in a loop over different data sets.
Spline-Specific Zero Finder
A new command fnzeros enables you to find an ordered list of the zeros of a
univariate, scalar-valued spline, in its basic interval or in a specified interval.
Spline-Specific Minimum Finder
A new command fnmin enables y ou to obtain the minimum or maximum
value of a univariate, scalar-valued spline as well as its location, in its basic
interval or in a specified interval.
26
Function Summary
Version 3.1 of Spline To olbox provides the following:
• “New Functions ” on page 26
• “Functions with New or Changed Capabilities ” on page 27
New Functions
Function Purpose
fnmin
fnzeros
stcol
Minimum of a function in a given interval
Find zeros of a function in a given interval
Scattered translates collocation matrix
Version 3.1.1 (R13) Spline Toolbox™ Software
Function Purpose
stmak
tpaps
Put together a function in stform
Thin-plate smoothing spline
Functions with New or Changed Capabilities
Function Purpose
fnbrk
fnrfn
splinetool
csaps
fnbrk
fnplt
optknt
slvblk
spaps
spcol
spcrv
Anewvalueofthepart argum ent, 'variables',causes
fnbrk to return the number of variables of the specified
function.
As a new default, fnrfn now refines the partition (breaks
or knots) of the given form by adding to it every midpoint.
fnrfn previously had no default.
splinetool
now permits the entry of a vector whose
elements replace that many entries in the weights display,
starting with the marked entry.
These functions now treat an empty optional argument the
same as not having that optional argument.
Compatibility Consideration
playshow Command Needed to Run Slideshow Style Demos
Starting in R13, to run slideshow style demos from the command line, you
must use the
playshow splexmpl
playshow command. For example,
27
Spline Toolbox™ Release N o tes
You can continue to run other styles of demos from the command line by
typing just the demo name. Spline Toolbox demos that are affected:
histodem, ppalldem, spap idem , getcurv2,andspalldem.
splexmpl,
28
Compatibility Summary for Spline Toolbox™ Software
Compatibility Summary for Spline Toolbox Software
This table summarizes new features and changes that might cause
incompatibilities when you upgrade from an earlier version, or wh en you
use files on multiple versions. Details are provided with the description of
the new feature or change.
Version (Release) New Features and Changes with Version
Compatibility Impact
Latest Version
V3.3.8 (R2010a)
V3.3.7 (R2009b)
V3.3.6 (R2009a)
V3.3.5 (R2008b)
V3.3.4 (R2008a)
V3.3.3 (R2007b)
V3.3.2 (R2007a)
V3.3.1 (R2006b)
V3.3 (R2006a) See the Compatibility Considerations
None
None
None
None
None
None
None
None
subheading for each of these new f eatures or
changes:
• “rsmak Input and Output For Getting an Arc
Is Changed” o n page 15
• “Part ’k...’ For a Ppform Disallowed” on page
16
• “Strange Error Message from fnval
Eliminated” on page 16
29
Spline Toolbox™ Release N o tes
Version (Release) New Features and Changes with Version
V3.2.2 (R14SP3) See these Compatibility Considerations
Compatibility Impact
subheadings:
• “B-form Evaluation Outside the Basic
Interval Returns 0” on page 19
• “spaps Handles V ector-Valued Data Correctly
in the Case of Zero Tolerance.” on page 19
• “fncmb Returns Error if Only One Coefficient
Array Is a Scalar” on page 19
V3.2.1 (R14SP1)
None
V3.2 (R13+) See these Compatibility Considerations
subheadings:
• “NaNs and Infs” on page 23
• “csape Input Simplified” on page 24
• “spap2, spapi Input Requirements Updated”
on page 24
V3.1.1 (R13) See this Compatibility Considerations
subheading:
• “playshow Command Needed to Run
Slideshow Style Demos” on page 27
30
Loading...