integral — Approximate real, complex-valued, and finite complex-contour integrals with adaptive quadrature.
q = integral(fun, a, b) uses an interior-sampling adaptive Gauss–Kronrod rule. Finite real and complex bounds, ordered finite complex contours, infinite real bounds, endpoint singularities with integrable interior values, and real or complex scalar and fixed-shape array-valued callbacks are supported. Real waypoints define an initial sorted mesh; complex-contour waypoints retain their given order.
Syntax
q = integral(fun, xmin, xmax)
q = integral(fun, xmin, xmax, options)
q = integral(fun, xmin, xmax, name, value, ...)Inputs
fun- Type
Any- Required
- Yes
- Description
- Integrand callback.
xmin- Type
Any- Required
- Yes
- Description
- Lower integration bound.
xmax- Type
Any- Required
- Yes
- Description
- Upper integration bound.
options- Type
Any- Required
- No
- Description
- Scalar options struct.
name- Type
PropertyName- Required
- No
- Description
- Option name.
value- Type
PropertyValue- Required
- Variadic
- Description
- Option value and further name/value pairs.
Returns
q- Type
NumericArray- Description
- Real or complex double scalar estimate, or a double array with the callback's shape when ArrayValued is true.
Errors
RunMat:integral:InvalidArgument- When
- Option grammar/name-value parsing is invalid.
- Message
integral: invalid argument
RunMat:integral:InvalidInput- When
- Bounds/integrand/adaptive solver semantics are invalid.
- Message
integral: invalid input
RunMat:integral:TooManyOutputs- When
- The caller requests more than the one supported numerical output.
- Message
integral: too many output arguments
Behavior
The callback can be a named function handle, anonymous function, or function-handle string. By default it receives row-vector batches of interior real or complex sample locations and must return a numeric row vector of the same shape. The current rule begins with 15 samples per initial subinterval and checks MaxFunEvals before invoking any batch. Real and imaginary values are accumulated in one callback traversal, with a real absolute-error estimate.
Vectorized=false selects scalar callback calls and is available in the current MATLAB compatibility mode. With ArrayValued=true, each scalar sample must return a finite numeric array of a fixed shape; the result has that shape. Vectorized does not change this array-valued callback form.
RunMat currently publishes scalar and array estimates in double precision, including when callback values use Single storage; known array-valued callback geometry is retained even for N-D singleton and empty arrays. This describes the current RunMat result boundary, not an unverified MATLAB result-class parity claim.
Real Waypoints must be finite and within the bounds; RunMat sorts and deduplicates them into an initial mesh. Complex contours require finite bounds and finite waypoints; their supplied order defines consecutive directed line segments, including repeated or nonmonotone points. These policies are documented RunMat behavior, not an unverified MATLAB ordering-parity claim. All spans share one global error test, function-evaluation limit, interval limit, and invocation cancellation budget.
Finite reversed bounds negate the result. Equal bounds return zero without a callback in scalar mode; array-valued mode evaluates once to determine the result shape and returns an array of zeros.
AbsTol and RelTol set the global acceptance tolerance. The newer synonymous AbsoluteTolerance and RelativeTolerance spellings use a typed release-feature gate: they are available in RunMat extension mode before the compatible MATLAB release reaches their introduction, and are admitted in strict mode once the central compatibility pin reaches it. Ordered last-value-wins semantics apply. MaxFunEvals limits callback sample evaluations. RunMat's MaxIntervalCount extension separately limits adaptive subintervals; it is a positive structural integer and is not a synonym for MaxFunEvals or a claim of MATLAB integral option parity. These controls accept name/value pairs or scalar options-struct fields.
Typed-integer bounds and numeric options are separately gated RunMat extensions; floating conversions require exact binary64 representation. Counts remain structural integers.
Execution
The adaptive solver runs on the host and invokes user code. A callback may itself call GPU-aware builtins, but integral does not provide a GPU quadrature kernel or fuse callback calls.
Resident operands use the existing owning gather boundary; callback effects, cancellation, and source errors must be preserved through the runtime call path.
Examples
Integrate a polynomial anonymous function
q = integral(@(x) x.^2, 0, 1)Expected output:
q =
0.3333Integrate sine over one half-period
q = integral(@sin, 0, pi)Expected output:
q =
2.0000Set tighter tolerances
q = integral(@sin, 0, pi, 'AbsTol', 1e-12, 'RelTol', 1e-8)Expected output:
q =
2.0000Integrate a fixed-shape array-valued function
q = integral(@(x) [x, x.^2], 0, 1, 'ArrayValued', true)Expected output:
q =
0.5000 0.3333Use real waypoints as an initial integration mesh
q = integral(@(x) x.^2, 0, 1, 'Waypoints', [0.75 0.25 0.25])Expected output:
q =
0.3333Integrate an endpoint singularity without sampling the endpoint
q = integral(@(x) 1./sqrt(x), 0, 1)Expected output:
q =
2.0000Integrate a decaying infinite tail
q = integral(@(x) exp(-x), 0, Inf)Expected output:
q =
1.0000Use the renamed tolerance options in RunMat mode
q = integral(@sin, 0, pi, 'AbsoluteTolerance', 1e-12, 'RelativeTolerance', 1e-8)Expected output:
q =
2.0000Integrate a complex-valued callback on a real interval
q = integral(@(x) (1+1i)+0.*x, 0, 1)Follow ordered complex waypoints
q = integral(@(z) 1+0.*z, 0+0i, 0+1i, 'Waypoints', 1+1i)Integrate a complex-valued infinite tail
q = integral(@(x) (1+1i).*exp(-x), 0, Inf)Using integral with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how integral changes the result.
Run a small integral example, explain the result, then change one input and compare the output.
FAQ
Is this the same as trapz?⌄
No. integral adaptively evaluates a function over continuous bounds; trapz integrates sampled data.
Does integral support vector-valued functions?⌄
Yes. With ArrayValued=true, the callback receives one scalar location and returns a fixed-shape real or complex numeric array. Otherwise, the default callback receives a row vector of locations and returns one value per location.
Does integral run on the GPU?⌄
The adaptive solver runs on the host. Its callback may call GPU-aware builtins.
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 · 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
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
Source you can read
Every RunMat function's source is public. Read exactly how integral is executed, line by line, in Rust.
- View the source for integral 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.