surrogateoptplot — Plot surrogate optimization samples, best/incumbent values and resets.
Display the measured values and algorithm phases of surrogate optimization.
Syntax
stop = surrogateoptplot(x,optimValues,state)Inputs
x- Type
Any- Required
- Yes
- Default
- —
- Description
- Ignored; plotted values come from measured optimValues metadata.
optimValues- Type
Any- Required
- Yes
- Default
- —
- Description
- Best/incumbent/current values, phase flag, actual function count and reset metadata.
state- Type
Any- Required
- Yes
- Default
- —
- Description
- init, iter or done.
Returns
stop- Type
Any- Description
- Logical false after successful scene publication.
Errors
RunMat:surrogateoptplot:InvalidArgument- When
- Callback metadata, scalar classes, state, counts or selected residency are invalid.
- Message
surrogateoptplot: invalid callback argument
Callback
stop = surrogateoptplot(x,optimValues,state) returns logical false. state is init, iter or done. x is not read. Function counts, not model-probe counts, form the horizontal axis. Repeated updates at the same count replace their last sample.
optimValues is a scalar struct containing funccount, fval, constrviolation, incumbentFval, incumbentConstrviolation, currentFval, currentConstrviolation, currentFlag, surrogateReset and surrogateResetCount. Value fields are real floating scalars or []. Counts are nonnegative platform-representable integers. surrogateReset is a logical scalar; a true reset has positive reset count.
currentFlag is initial, random or adaptive when a current measurement is available. Initial samples use diamonds, random samples triangles, adaptive samples filled circles, best values circles and incumbents crosses. Feasible and infeasible samples have separate colors. Surrogate resets are actual vertical reference-line annotations, independent of objective-value scale.
Missing values and feasibility
Empty initialization creates axes without a synthetic objective sample. NaN measurements do not produce a finite sample. For an absent objective, the corresponding raw maximum nonlinear constraint value is plotted instead. Signed constraint maxima are not clamped to zero.
The nonlinear feasibility tolerance is 1e-3 unless optimValues.constraintTolerance supplies a finite nonnegative selected tolerance. The title reports the available best, incumbent and current measured values. Init retires only this callback's series and reset annotations; unrelated charts on the same axes are preserved.
Execution and graphics
The callback uses ordinary receiver-backed scene payloads and the standard renderer. It does not retain a separate solver history. Figure/axes/child retirement is checked against the original selected graphics authority. Closing the retained target does not create a replacement figure.
Only consumed floating metadata may be gathered from authenticated automatic residency through the original context. Explicit or unproven device metadata requires an explicit gather. Unused x, Ineq arrays, captures and unrelated fields are not inspected or downloaded. Finite host-memory execution refuses before transfer or scene work because chart history and scene allocation have no complete bound.
plot-core and UI capability are required. Cancellation, provider and graphics failures propagate without replay. RunMat provides its normal rendering and execution cancellation controls, not MATLAB-specific optimization Pause/Stop widgets or an identical plot-window layout.
Example
Plot measured random and adaptive samples
v.funccount=0; v.fval=[]; v.constrviolation=[]; v.incumbentFval=[]; v.incumbentConstrviolation=[]; v.currentFval=[]; v.currentConstrviolation=[]; v.currentFlag=[]; v.surrogateReset=false; v.surrogateResetCount=0; stop=surrogateoptplot([],v,'init');
v.funccount=1; v.fval=2; v.constrviolation=-0.1; v.incumbentFval=2; v.incumbentConstrviolation=-0.1; v.currentFval=2; v.currentConstrviolation=-0.1; v.currentFlag='random'; surrogateoptplot([],v,'iter');
v.funccount=2; v.currentFval=3; v.currentConstrviolation=0.2; v.currentFlag='adaptive'; v.surrogateReset=true; v.surrogateResetCount=1; surrogateoptplot([],v,'iter'); v.surrogateReset=false; stop=surrogateoptplot([],v,'done');Using surrogateoptplot with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how surrogateoptplot changes the result.
Run a small surrogateoptplot 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 · surrogateopt · 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
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
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
Ops
cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose
Interpolation
griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline
Integer Division
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.