RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • acceptancesa
    • annealingboltz
    • annealingfast
    • coneprog
    • crossoverarithmetic
    • crossoverheuristic
    • crossoverintermediate
    • crossoverlaplace
    • crossoverscattered
    • crossoversinglepoint
    • crossovertwopoint
    • eqnproblem
    • EquationProblem.solve
    • EquationProblem.subsasgn
    • EquationProblem.subsref
    • evaluate
    • fgoalattain
    • fitscalingprop
    • fitscalingrank
    • fitscalingshiftlinear
    • fitscalingtop
    • fminbnd
    • fmincon
    • fminimax
    • fminsearch
    • fminunc
    • fseminf
    • fsolve
    • fzero
    • ga
    • gacreationlinearfeasible
    • gacreationnonlinearfeasible
    • gacreationsobol
    • gacreationuniform
    • gacreationuniformint
    • gaplotbestf
    • gaplotbestindiv
    • gaplotdistance
    • gaplotexpectation
    • gaplotgenealogy
    • gaplotmaxconstr
    • gaplotrange
    • gaplotscorediversity
    • gaplotscores
    • gaplotselection
    • gaplotstopping
    • integerConstraint
    • integral
    • intlinprog
    • linprog
    • lsqcurvefit
    • lsqlin
    • LsqlinWarmStart.subsasgn
    • LsqlinWarmStart.subsref
    • lsqnonlin
    • lsqnonneg
    • mutationadaptfeasible
    • mutationgaussian
    • mutationpositivebasis
    • mutationpower
    • mutationuniform
    • optimexpr
    • optimget
    • OptimizationConstraint.evaluate
    • OptimizationConstraint.subsasgn
    • OptimizationConstraint.subsref
    • OptimizationExitflag.double
    • OptimizationExitflag.eq
    • OptimizationExitflag.ne
    • OptimizationExitflag.string
    • OptimizationExpression.acos
    • OptimizationExpression.acosh
    • OptimizationExpression.acot
    • OptimizationExpression.acoth
    • OptimizationExpression.acsc
    • OptimizationExpression.acsch
    • OptimizationExpression.asec
    • OptimizationExpression.asech
    • OptimizationExpression.asin
    • OptimizationExpression.asinh
    • OptimizationExpression.atan
    • OptimizationExpression.atanh
    • OptimizationExpression.cat
    • OptimizationExpression.cos
    • OptimizationExpression.cosh
    • OptimizationExpression.cot
    • OptimizationExpression.coth
    • OptimizationExpression.csc
    • OptimizationExpression.csch
    • OptimizationExpression.ctranspose
    • OptimizationExpression.cumprod
    • OptimizationExpression.cumsum
    • OptimizationExpression.diag
    • OptimizationExpression.diff
    • OptimizationExpression.dot
    • OptimizationExpression.eq
    • OptimizationExpression.evaluate
    • OptimizationExpression.exp
    • OptimizationExpression.ge
    • OptimizationExpression.horzcat
    • OptimizationExpression.ldivide
    • OptimizationExpression.le
    • OptimizationExpression.log
    • OptimizationExpression.mean
    • OptimizationExpression.minus
    • OptimizationExpression.mldivide
    • OptimizationExpression.mpower
    • OptimizationExpression.mrdivide
    • OptimizationExpression.mtimes
    • OptimizationExpression.norm
    • OptimizationExpression.plus
    • OptimizationExpression.power
    • OptimizationExpression.prod
    • OptimizationExpression.rdivide
    • OptimizationExpression.reshape
    • OptimizationExpression.sec
    • OptimizationExpression.sech
    • OptimizationExpression.sin
    • OptimizationExpression.sinh
    • OptimizationExpression.sqrt
    • OptimizationExpression.subsasgn
    • OptimizationExpression.subsref
    • OptimizationExpression.sum
    • OptimizationExpression.tan
    • OptimizationExpression.tanh
    • OptimizationExpression.times
    • OptimizationExpression.trace
    • OptimizationExpression.transpose
    • OptimizationExpression.uminus
    • OptimizationExpression.uplus
    • OptimizationExpression.vertcat
    • OptimizationExpression.zeros
    • OptimizationExpression.zerosLike
    • OptimizationProblem.solve
    • OptimizationProblem.subsasgn
    • OptimizationProblem.subsref
    • OptimizationVariable.subsasgn
    • OptimizationVariable.subsref
    • optimoptions
    • optimplotconstrviolation
    • optimplotfirstorderopt
    • optimplotfunccount
    • optimplotfval
    • optimplotfvalconstr
    • optimplotmilp
    • optimplotstepsize
    • optimplotx
    • optimproblem
    • optimset
    • optimvar
    • optimwarmstart
    • particleswarm
    • patternsearch
    • psplotbestf
    • psplotbestx
    • psplotfuncount
    • psplotmaxconstr
    • psplotmeshsize
    • pswcreationuniform
    • pswplotbestf
    • quad
    • quadprog
    • QuadprogWarmStart.subsasgn
    • QuadprogWarmStart.subsref
    • saplotbestf
    • saplotbestx
    • saplotf
    • saplotstopping
    • saplottemperature
    • saplotx
    • savemilpsolutions
    • secondordercone
    • selectionremainder
    • selectionroulette
    • selectionstochunif
    • selectiontournament
    • selectionuniform
    • simulannealbnd
    • solve
    • surrogateopt
    • surrogateoptplot
    • temperatureboltz
    • temperatureexp
    • temperaturefast

surrogateopt — Minimize an expensive objective with cubic surrogate models and bounded global sampling.

Search a finite bounded domain with optional integer, linear and nonlinear inequality constraints, retaining actual evaluations and resumable checkpoints.

Syntax

[x,fval,exitflag,output,trials] = surrogateopt(objconstr,lb,ub)
[...] = surrogateopt(objconstr,lb,ub,intcon)
[...] = surrogateopt(objconstr,lb,ub,intcon,A,b,Aeq,beq)
[...] = surrogateopt(objconstr,lb,ub,options)
[...] = surrogateopt(objconstr,lb,ub,intcon,options)
[...] = surrogateopt(objconstr,lb,ub,intcon,A,b,Aeq,beq,options)
All supported surrogateopt forms
[x,fval,exitflag,output,trials] = surrogateopt(objconstr,lb,ub)
[...] = surrogateopt(objconstr,lb,ub,intcon)
[...] = surrogateopt(objconstr,lb,ub,intcon,A,b,Aeq,beq)
[...] = surrogateopt(objconstr,lb,ub,options)
[...] = surrogateopt(objconstr,lb,ub,intcon,options)
[...] = surrogateopt(objconstr,lb,ub,intcon,A,b,Aeq,beq,options)
[...] = surrogateopt(problem)
[...] = surrogateopt(checkpointFile)
[...] = surrogateopt(checkpointFile,opts)

Inputs

objconstr
Type
Any
Required
Yes
Default
—
Description
Selected function returning Fval and/or nonlinear Ineq in one result.
lb
Type
Any
Required
Yes
Default
—
Description
Nonempty finite real double lower-bound vector.
ub
Type
Any
Required
Yes
Default
—
Description
Finite real double upper bounds with the same original variable extent.
intcon
Type
Any
Required
Yes
Default
—
Description
Double one-based integer coordinate indices, or [].
A
Type
Any
Required
Yes
Default
—
Description
Linear inequality matrix, or [].
b
Type
Any
Required
Yes
Default
—
Description
Linear inequality right-hand sides, or [].
Aeq
Type
Any
Required
Yes
Default
—
Description
Linear equality matrix, or [].
beq
Type
Any
Required
Yes
Default
—
Description
Linear equality right-hand sides, or [].
options
Type
Any
Required
Yes
Default
—
Description
Selected canonical surrogate options, or [].
problem
Type
Any
Required
Yes
Default
—
Description
objective,lb,ub,solver='surrogateopt',options; optional intcon,Aineq,bineq,Aeq,beq,rngstate.
checkpointFile
Type
Any
Required
Yes
Default
—
Description
Authenticated solver checkpoint path.
opts
Type
Any
Required
Yes
Default
—
Description
Permitted resume-option overrides.
NameTypeRequiredDefaultDescription
objconstrAnyYes—Selected function returning Fval and/or nonlinear Ineq in one result.
lbAnyYes—Nonempty finite real double lower-bound vector.
ubAnyYes—Finite real double upper bounds with the same original variable extent.
intconAnyYes—Double one-based integer coordinate indices, or [].
AAnyYes—Linear inequality matrix, or [].
bAnyYes—Linear inequality right-hand sides, or [].
AeqAnyYes—Linear equality matrix, or [].
beqAnyYes—Linear equality right-hand sides, or [].
optionsAnyYes—Selected canonical surrogate options, or [].
problemAnyYes—objective,lb,ub,solver='surrogateopt',options; optional intcon,Aineq,bineq,Aeq,beq,rngstate.
checkpointFileAnyYes—Authenticated solver checkpoint path.
optsAnyYes—Permitted resume-option overrides.

Returns

x
Type
Any
Description
Best measured original-space point; least maximum nonlinear violation when no feasible point is available.
fval
Type
Any
Description
Measured Fval at x, or [] when no objective value is present.
exitflag
Type
Any
Description
10 unique solution; 3 too few new sites; 1 objective limit; 0 function/time limit; -1 observer; -2 no feasible point.
output
Type
Any
Description
funccount, elapsedtime, message, constrviolation, ineq, and initial rngstate.
trials
Type
Any
Description
X rows, corresponding Fval column (or []), and Ineq rows from the retained measured trial history.
NameTypeDescription
xAnyBest measured original-space point; least maximum nonlinear violation when no feasible point is available.
fvalAnyMeasured Fval at x, or [] when no objective value is present.
exitflagAny10 unique solution; 3 too few new sites; 1 objective limit; 0 function/time limit; -1 observer; -2 no feasible point.
outputAnyfunccount, elapsedtime, message, constrviolation, ineq, and initial rngstate.
trialsAnyX rows, corresponding Fval column (or []), and Ineq rows from the retained measured trial history.

Returned values from surrogateopt depend on how many outputs the caller requests.

Errors

RunMat:surrogateopt:InvalidArgument
When
An input, selected option, callback result or numerical extent is invalid.
Message
surrogateopt: invalid argument
RunMat:surrogateopt:NumericalFailure
When
The selected original geometry or interpolant cannot be represented by the numerical solver.
Message
surrogateopt: numerical failure
RunMat:surrogateopt:Checkpoint
When
A checkpoint record, selected code capture or MAT-file publication is invalid or unavailable.
Message
surrogateopt: checkpoint operation failed
IdentifierWhenMessage
RunMat:surrogateopt:InvalidArgumentAn input, selected option, callback result or numerical extent is invalid.surrogateopt: invalid argument
RunMat:surrogateopt:NumericalFailureThe selected original geometry or interpolant cannot be represented by the numerical solver.surrogateopt: numerical failure
RunMat:surrogateopt:CheckpointA checkpoint record, selected code capture or MAT-file publication is invalid or unavailable.surrogateopt: checkpoint operation failed

Calling forms and inputs

Use surrogateopt(objconstr,lb,ub), add intcon as a fourth input, or use the full form surrogateopt(objconstr,lb,ub,intcon,A,b,Aeq,beq). Append an options structure to any of these forms. Missing integer or linear constraints use []. Bounds are required, nonempty finite real double vectors with the same number of elements. Their elements are read in column-major order. Equal bounds fix a coordinate.

intcon contains one-based integer-valued double indices into the original coordinates. Duplicate indices are normalized. The original inequalities are A*x(:)<=b and equalities are Aeq*x(:)=beq; dense and sparse real double matrices are accepted. A row's right-hand side must match its matrix. Bounds, linear data, decision points and callback measurements do not have logical, single or native-integer overloads.

surrogateopt(problem) takes a scalar structure with objective,lb,ub,solver='surrogateopt',options. Optional fields are intcon,Aineq,bineq,Aeq,beq,rngstate. Unknown fields are rejected. rngstate is a valid rng snapshot applied to the current original random stream before numerical work. A checkpoint can instead be continued with surrogateopt(checkpointFile) or surrogateopt(checkpointFile,opts).

Objective and constraint results

objconstr is an actual function handle or scalar function name selected at entry. A scalar call receives a 1-by-nvars row. It returns either a real double scalar Fval or one scalar structure with Fval and Ineq. Ineq is a real double vector interpreted as Ineq<=0. Fval=[] selects feasibility-only search; there are no nonlinear equality constraints. The objective-presence and inequality-count schema must remain fixed across actual calls.

Fval and Ineq may contain NaN to mark an unusable measured row. Such a row is retained in trials but does not train a surrogate or establish an incumbent. Infinite measurements, complex values, invalid classes/shapes, callback errors and cancellation are errors. Sparse real double measurements are decoded without a dense mirror. Feasibility-only search continues until a stopping condition; it does not automatically stop at its first feasible point.

With UseVectorized=true and requested UseParallel='off', the callback receives M-by-nvars rows and returns an M-by-1 Fval column, or a structure with that column and M-by-q Ineq. Fval=[] still denotes an absent objective. M is at most BatchUpdateInterval and can be one; the final batch can be shorter. Each row consumes one function evaluation, not one batch. Missing initial measurement lanes use the same actual scalar, vectorized or worker route.

Surrogate search

Construction obtains distinct feasible sites and fits a cubic radial-basis interpolant with an affine tail. Distances use full normalized physical coordinates. Fixed coordinates and exact linear equalities reduce the independent affine tail and sampling span without changing the radial metric. Factorizations use the shared LU/QR owners; no inverse or dense normal-equation model is formed.

Adaptive search alternates random, crossover, random-orthogonal and coordinate proposals. Merit balances predicted improvement against distance from evaluated sites, with a changing sampling scale. Small spacing or stalled construction can reset the surrogate phase. The measured history, lifetime best and original evaluation allowance survive resets. Work accepted before a reset keeps its original phase and can improve the returned best without being relabeled as new-phase training data.

Bounds, original sparse linear rows and integer membership are checked before an expensive call. Mixed-integer repair uses the existing feasibility owner. Modeled refinement uses SQP subproblems with the same Clock and CPU cooperation. RunMat's internal branch selection limits a refinement search to 30 or 60 actual branch steps; a finite search that finds no usable proposal is not an infeasibility certificate. Numerical models propose points but never supply public objective values.

Options and stopping

Display is off/none/iter/final, default final. MaxFunctionEvaluations is a nonnegative exact count, default max(200,50*nvars). MaxTime defaults to Inf and accepts nonnegative seconds or a genuine scalar duration. ObjectiveLimit defaults to -Inf; a feasible actual objective strictly below it stops search. ConstraintTolerance defaults to 1e-3 and applies to nonlinear inequalities, not the original linear/integer feasibility owner.

BatchUpdateInterval is positive, default 1. It controls the measured model/observer update interval and the vectorized row target. MinSurrogatePoints defaults to max(20,2*nvars), must be at least nvars+1, and is effectively at least BatchUpdateInterval. MinSampleDistance is nonnegative, default 1e-6; zero permits exact-site adaptive revisits rather than imposing a hidden positive spacing rule. InitialPoints, CheckpointFile, OutputFcn, PlotFcn, UseParallel and UseVectorized are described below. Other solver options are rejected.

InitialPoints is an M-by-nvars real double matrix or a scalar structure with X and optional Fval and Ineq. Complete supplied measurements consume no objective allowance. Partial fields are retained only at the exact unchanged supplied point. If repair changes a point's bits, all supplied measurement lanes for that point are discarded. Missing schema is learned from a real new evaluation, not a callback replay. Known rows can determine the returned solution even with MaxFunctionEvaluations=0.

Flags are 10 for a unique feasible point, 3 when too few usable new sites remain, 1 for ObjectiveLimit, 0 for the evaluation/time boundary, -1 for a logical observer stop, and -2 when no feasible point is found. An observer stop retains -1 even before feasibility. Inconsistent bound or integer-bound intervals return x=[] and fval=[] without objective, RNG, Clock, UI, pool or checkpoint-file effects. Time checks are cooperative boundaries, not hard preemption of an in-flight callback or numerical kernel.

Parallel work and observers

UseParallel is off/auto/on; false is off and true is auto. Requested parallel mode takes precedence over UseVectorized, including when auto has no pool and uses scalar serial execution. Inactive vectorized operands are not gathered or inspected for provider facts. On requires an actual selected worker route. Auto falls back only before submission for known ineligibility or missing authority. Errors or partial acceptance are not replayed serially.

Parallel execution uses one original-source CallbackBatch and the actual pool width. A FIFO retains a small surplus of unsubmitted proposals; only pool-width accepted calls run concurrently. Completions update the measured history in actual completion order. Cancellation and failures propagate as errors while accepted work retains its source, receipt and physical retirement owners.

OutputFcn and PlotFcn are handles/names or cells of them, called as stop=f(x,optimValues,state). state is init/iter/done and every stop result must be a logical scalar. x is the best actual point, or []. optimValues contains funccount,elapsedtime,fval,constrviolation,ineq,incumbentX/Fval/Ineq/Constrviolation,currentX/Fval/Ineq/Constrviolation, the corresponding sample flags, feasibleCount,surrogateReset,surrogateResetCount,iteration and constraintTolerance. Calls occur at measured update boundaries. A done return is validated without changing the completed termination reason.

PlotFcn defaults to optimplotfvalconstr; [] disables plotting. Selected predefined charts include optimplotfval,optimplotfvalconstr,optimplotx,optimplotfunccount and surrogateoptplot. They use actual receiver-backed graphics scenes. Missing plot/UI service is an error when a chart is selected, not a hidden no-op. Custom observers retain their originally selected definitions and rooted return payloads through stop decoding.

Checkpoint save and resume

CheckpointFile defaults to empty. A nonempty path selects the original filesystem provider; a missing extension adds .mat. Saving uses an exclusive staged replacement and one publish decision. It occurs after an iteration when at least ten solver seconds have elapsed since the previous saved cut, and after final callbacks. A save cut drains already accepted work without submitting queued surplus. Partial measured batches and all accepted results are included; the live continuation retains its unsubmitted proposals.

A checkpoint is a RunMat Level-5 MAT file with one versioned uint8 record, not a MATLAB checkpoint file. It contains one measured history, the original sparse domain, prepared initial template, actual callback code/captures, total point evaluations, saved solver time, RNG state and small observer-frame metadata. Resume checks the execution environment and admits the saved original code/source/static/class graph under the current original context. Old RuntimeContexts, worker grants, cancellation tokens, clocks and service handles are not restored.

Resume keeps total limits: a saved count of 30 with MaxFunctionEvaluations=100 leaves at most 70 new point evaluations. Saved measured objective values are not reevaluated. Initial rows already saved are matched once, while unsubmitted repeated occurrences retain their own calls. Internal models and sampling trajectories are rebuilt, so the later trajectory can differ from uninterrupted execution. Current callbacks replay saved observer frames without objective calls, then receive an iteration marked checkpointResume; checkpointReplay identifies historical frames. surrogateoptplot displays actual resume reference lines.

Only BatchUpdateInterval,CheckpointFile,Display,MaxFunctionEvaluations,MaxTime,MinSurrogatePoints,ObjectiveLimit,OutputFcn,PlotFcn,UseParallel and UseVectorized can change on resume. A full options structure may repeat unchanged frozen controls and InitialPoints. A dormant vectorized value that is not portable must be replaced explicitly before activating vectorization. CheckpointFile='' disables subsequent saves. Failure before publication leaves the previous checkpoint. An interrupted publish reports its actual disposition, including whether publication occurred. Cancellation can prevent a final save. Work after the last successful saved cut is not recoverable as a committed checkpoint.

Checkpoint captures support sessionless scalar/array, selected object and lexical-cell payloads with their admitted code. Declared foreign interop and external/resident/distributed service references require a fresh portable service projection and are rejected by this checkpoint path. A serialized display name, digest or old session ID never substitutes for that projection. Version/environment mismatches are errors; records are not loaded into the workspace and do not run object load hooks.

Outputs and execution services

Up to five outputs are x,fval,exitflag,output,trials. x is the best measured feasible row, or the row of least maximum nonlinear infeasibility when none is feasible. fval is its actual scalar measurement, or [] for an absent objective or absent point. output contains funccount,elapsedtime,message,constrviolation,ineq,rngstate. rngstate is the initial state of the original stream; resumed output retains the original saved initial state. trials.X has actual point rows, trials.Fval their column or [], and trials.Ineq their measured inequality rows. Publication does not call the objective.

Numerical work uses the original RuntimeContext, CPU budget, cancellation, Clock and random stream. Host decision data and results require the declared double classes; authenticated automatic-residency inputs can gather under that context. Explicit resident numeric options and exact native-integer controls require their declared RunMat extensions. Captures and inactive operands are not recursively gathered. Finite host-memory policies are refused before provider, callback, file, pool, RNG or UI effects because the complete solver/checkpoint workspace has no finite allocation bound. This is a host solver, not a GPU-native or distributed algorithm.

Examples

Evaluate a fixed feasible point

opts=optimoptions('surrogateopt','Display','off','PlotFcn',[]);
[x,f,flag,out,trials]=surrogateopt(@(x)sum(x.^2),[2 -1],[2 -1],opts);

Reuse complete initial measurements without a call

initial=struct('X',[-1;0;1],'Fval',[1;0;1],'Ineq',zeros(3,0));
opts=optimoptions('surrogateopt','Display','off','PlotFcn',[],'InitialPoints',initial,'MaxFunctionEvaluations',0);
[x,f,flag,out,trials]=surrogateopt(@(x)error('unexpected objective call'),-2,2,opts);

Count rows across a partial final batch

opts=optimoptions('surrogateopt','Display','off','PlotFcn',[],'InitialPoints',[-2;-1;0;1;2],...
'UseVectorized',true,'BatchUpdateInterval',3,'MaxFunctionEvaluations',5);
[x,f,flag,out,trials]=surrogateopt(@(x)x.^2,-3,3,opts);

Continue saved initial rows with a total budget

opts=optimoptions('surrogateopt','Display','off','PlotFcn',[],'InitialPoints',[0;1;2],...
'MaxFunctionEvaluations',1,'CheckpointFile','checkpoints/surrogate-checkpoint.mat');
[x,f,flag,out]=surrogateopt(@(x)x(1)^2,-3,3,opts);
more=opts; more.MaxFunctionEvaluations=3;
[xr,fr,flagr,outr,trials]=surrogateopt('checkpoints/surrogate-checkpoint.mat',more);

Using surrogateopt with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how surrogateopt changes the result.

Run a small surrogateopt example, explain the result, then change one input and compare the output.

Related Math functions

Optim

acceptancesa · annealingboltz · annealingfast · coneprog · crossoverarithmetic · crossoverheuristic · crossoverintermediate · crossoverlaplace · crossoverscattered · crossoversinglepoint · crossovertwopoint · eqnproblem · EquationProblem.solve · EquationProblem.subsasgn · EquationProblem.subsref · evaluate · fgoalattain · fitscalingprop · fitscalingrank · fitscalingshiftlinear · fitscalingtop · fminbnd · fmincon · fminimax · fminsearch · fminunc · fseminf · fsolve · fzero · ga · gacreationlinearfeasible · gacreationnonlinearfeasible · gacreationsobol · gacreationuniform · gacreationuniformint · gaplotbestf · gaplotbestindiv · gaplotdistance · gaplotexpectation · gaplotgenealogy · gaplotmaxconstr · gaplotrange · gaplotscorediversity · gaplotscores · gaplotselection · gaplotstopping · integerConstraint · integral · intlinprog · linprog · lsqcurvefit · lsqlin · LsqlinWarmStart.subsasgn · LsqlinWarmStart.subsref · lsqnonlin · lsqnonneg · mutationadaptfeasible · mutationgaussian · mutationpositivebasis · mutationpower · mutationuniform · optimexpr · optimget · OptimizationConstraint.evaluate · OptimizationConstraint.subsasgn · OptimizationConstraint.subsref · OptimizationExitflag.double · OptimizationExitflag.eq · OptimizationExitflag.ne · OptimizationExitflag.string · OptimizationExpression.acos · OptimizationExpression.acosh · OptimizationExpression.acot · OptimizationExpression.acoth · OptimizationExpression.acsc · OptimizationExpression.acsch · OptimizationExpression.asec · OptimizationExpression.asech · OptimizationExpression.asin · OptimizationExpression.asinh · OptimizationExpression.atan · OptimizationExpression.atanh · OptimizationExpression.cat · OptimizationExpression.cos · OptimizationExpression.cosh · OptimizationExpression.cot · OptimizationExpression.coth · OptimizationExpression.csc · OptimizationExpression.csch · OptimizationExpression.ctranspose · OptimizationExpression.cumprod · OptimizationExpression.cumsum · OptimizationExpression.diag · OptimizationExpression.diff · OptimizationExpression.dot · OptimizationExpression.eq · OptimizationExpression.evaluate · OptimizationExpression.exp · OptimizationExpression.ge · OptimizationExpression.horzcat · OptimizationExpression.ldivide · OptimizationExpression.le · OptimizationExpression.log · OptimizationExpression.mean · OptimizationExpression.minus · OptimizationExpression.mldivide · OptimizationExpression.mpower · OptimizationExpression.mrdivide · OptimizationExpression.mtimes · OptimizationExpression.norm · OptimizationExpression.plus · OptimizationExpression.power · OptimizationExpression.prod · OptimizationExpression.rdivide · OptimizationExpression.reshape · OptimizationExpression.sec · OptimizationExpression.sech · OptimizationExpression.sin · OptimizationExpression.sinh · OptimizationExpression.sqrt · OptimizationExpression.subsasgn · OptimizationExpression.subsref · OptimizationExpression.sum · OptimizationExpression.tan · OptimizationExpression.tanh · OptimizationExpression.times · OptimizationExpression.trace · OptimizationExpression.transpose · OptimizationExpression.uminus · OptimizationExpression.uplus · OptimizationExpression.vertcat · OptimizationExpression.zeros · OptimizationExpression.zerosLike · OptimizationProblem.solve · OptimizationProblem.subsasgn · OptimizationProblem.subsref · OptimizationVariable.subsasgn · OptimizationVariable.subsref · optimoptions · optimplotconstrviolation · optimplotfirstorderopt · optimplotfunccount · optimplotfval · optimplotfvalconstr · optimplotmilp · optimplotstepsize · optimplotx · optimproblem · optimset · optimvar · optimwarmstart · particleswarm · patternsearch · psplotbestf · psplotbestx · psplotfuncount · psplotmaxconstr · psplotmeshsize · pswcreationuniform · pswplotbestf · quad · quadprog · QuadprogWarmStart.subsasgn · QuadprogWarmStart.subsref · saplotbestf · saplotbestx · saplotf · saplotstopping · saplottemperature · saplotx · savemilpsolutions · secondordercone · selectionremainder · selectionroulette · selectionstochunif · selectiontournament · selectionuniform · simulannealbnd · solve · surrogateoptplot · temperatureboltz · temperatureexp · temperaturefast

Elementwise

abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · hypot · imag · int16 · int32 · int64 · int8 · intmax · intmin · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · realmax · realmin · realsqrt · rescale · sign · single · sqrt · times · typecast · uint16 · uint32 · uint64 · uint8

Trigonometry

acos · acosd · acosh · acotd · acscd · asecd · asin · asind · asinh · atan · atan2 · atan2d · atand · atanh · cos · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · sin · sind · sinh · sinpi · tan · tand · tanh

Reduction

all · any · bounds · cummax · cummin · cumprod · cumsum · cumtrapz · diff · gradient · max · maxk · mean · median · min · mink · movmax · movmean · movmedian · movmin · movprod · movstd · movsum · movvar · nnz · prod · rms · std · sum · trapz · var

Structure

bandwidth · isdiag · ishermitian · issymmetric · istril · istriu · symrcm

Bitwise

bitand · bitcmp · bitget · bitor · bitset · bitshift · bitxor · swapbytes

Signal

blackman · butter · buttord · cheb2ord · conv · conv2 · deconv · downsample · envelope · filter · filtfilt · fir1 · freqz · gauspuls · hamming · hann · hilbert · periodogram · pulstran · pwelch · rectpuls · resample · sawtooth · sinc · spectrogram · square · tripuls · unwrap · upsample · zplane

Rounding

ceil · fix · floor · mod · rem · round

Factor

chol · decomposition · decomposition.ctranspose · decomposition.mldivide · decomposition.mrdivide · decomposition.mtimes · decomposition.rdivide · decomposition.subsref · decomposition.times · decomposition.uminus · decomposition.uplus · eig · eigs · gmres · ichol · ilu · lu · ordeig · ordqz · ordschur · pcg · qr · qz · rsf2csf · schur · svd

Solve

cond · det · inv · linsolve · norm · null · pinv · rank · rcond · rref · vecnorm

Ops

cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose

Symbolic

digits · int · limit · piecewise · sym · syms · vpa

Discrete

factor · factorial · gcd · isprime · lcm · primes

Fft

fft · fft2 · fftn · fftshift · ifft · ifft2 · ifftn · ifftshift

Interpolation

griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline

Integer Division

idivide

Ode

ode15s · ode23 · ode45 · odeset

Poly

poly · polyder · polyfit · polyint · polyval · roots

Source you can read

Every RunMat function's source is public. Read exactly how surrogateopt is executed, line by line, in Rust.

  • View the source for surrogateopt in Rust on GitHub
  • Learn how the RunMat runtime works
  • Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.

  • RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
  • Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Calling forms and inputs
  • Objective and constraint results
  • Surrogate search
  • Options and stopping
  • Parallel work and observers
  • Checkpoint save and resume
  • Outputs and execution services
  • Examples
  • Evaluate a fixed feasible point
  • Reuse complete initial measurements without a call
  • Count rows across a partial final batch
  • Continue saved initial rows with a total budget
  • Using surrogateopt with coding agents
  • Related Math functions
  • Optim
  • Elementwise
  • Trigonometry
  • Reduction
  • Structure
  • Bitwise
  • Signal
  • Rounding
  • Factor
  • Solve
  • Ops
  • Symbolic
  • Discrete
  • Fft
  • Interpolation
  • Integer Division
  • Ode
  • Poly
  • Source you can read
  • About RunMat