minus,-

Subtraction

Syntax

C = A - B

C = minus(A,B)

描述

C =A-Bsubtracts arrayBfrom arrayAby subtracting corresponding elements. The sizes ofAandBmust be the same or becompatible.

If the sizes ofAandBare compatible, then the two arrays implicitly expand to match each other. For example, ifAorBis a scalar, then the scalar is combined with each element of the other array. Also, vectors with different orientations (one row vector and one column vector) implicitly expand to form a matrix.

C = minus(A,B)is an alternate way to executeA - B, but is rarely used. It enables operator overloading for classes.

Examples

collapse all

Subtract Scalar from Array

Open Live Script

Create an array,A, and subtract a scalar value from it.

A = [2 1; 3 5]; C = A - 2

C =2×20 -1 1 3

The scalar is subtracted from each entry ofA.

Subtract Two Arrays

Open Live Script

Create two arrays,AandB, and subtract the second,B, from the first,A.

A = [1 0; 2 4]; B = [5 9; 2 1]; C = A - B

C =2×2-4 -9 0 3

The elements ofBare subtracted from the corresponding elements ofA.

Use the syntax-Cto negate the elements ofC.

-C

ans =2×24 9 0 -3

Subtract Row and Column Vectors

Open Live Script

Create a 1-by-2 row vector and 3-by-1 column vector and subtract them.

a = 1:2; b = (1:3)'; a - b

ans =3×20 1 -1 0 -2 -1

The result is a 3-by-2 matrix, where each (i,j) element in the matrix is equal to a(j) - b(i):

$a = [a_{1} a_{2}], b = [\begin{matrix} b_{1} \\ b_{2} \\ b_{3} \end{matrix}], a - b = [\begin{matrix} a_{1} - b_{1} & a_{2} - b_{1} \\ a_{1} - b_{2} & a_{2} - b_{2} \\ a_{1} - b_{3} & a_{2} - b_{3} \end{matrix}] .$

Subtract Mean from Matrix

Open Live Script

Create a matrix,A. Scale the elements in each column by subtracting the mean.

A = [1 9 3; 2 7 8]

A =2×31 9 3 2 7 8

A - mean(A)

ans =2×3-0.5000 1.0000 -2.5000 0.5000 -1.0000 2.5000

Input Arguments

collapse all

`A`,`B`—Operands
scalars|vectors|matrices|multidimensional arrays

Operands, specified as scalars, vectors, matrices, or multidimensional arrays. InputsAandBmust either be the same size or have sizes that are compatible (for example,Ais anM-by-Nmatrix andBis a scalar or1-by-Nrow vector). For more information, seeCompatible Array Sizes for Basic Operations.

Operands with an integer data type cannot be complex.
If one input is adatetimearray,durationarray, orcalendarDurationarray, then numeric values in the other input are treated as a number of 24-hour days.

Extended Capabilities

Tall Arrays
Calculate with arrays that have more rows than fit in memory.

This function fully supports tall arrays. For more information, seeTall Arrays.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

If you useminuswith single type and double type operands, the generated code might not produce the same result as MATLAB^®. SeeBinary Element-Wise Operations with Single and Double Operands(MATLAB Coder).

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Usage notes and limitations:

If you useminuswith single type and double type operands, the generated code might not produce the same result as MATLAB. SeeBinary Element-Wise Operations with Single and Double Operands(MATLAB Coder).

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

This function fully supports thread-based environments. For more information, seeRun MATLAB Functions in Thread-Based Environment.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Usage notes and limitations:

64-bit integers are not supported.

For more information, seeRun MATLAB Functions on a GPU(Parallel Computing Toolbox).

Distributed Arrays
Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, seeRun MATLAB Functions with Distributed Arrays(Parallel Computing Toolbox).

Version History

Introduced before R2006a

expand all

R2020b: Implicit expansion change affects`calendarDuration`,`datetime`, and`duration`arrays

Behavior changed in R2020b

Starting in R2020b,minussupports implicit expansion when the arguments arecalendarDuration,datetime, ordurationarrays. Between R2020a and R2016b, implicit expansion was supported only for numeric data types.

R2016b: Implicit expansion change affects arguments for operators

Behavior changed in R2016b

与一个R2016b开始ddition of implicit expansion, some combinations of arguments for basic operations that previously returned errors now produce results. For example, you previously could not add a row and a column vector, but those operands are now valid for addition. In other words, an expression like[1 2] + [1; 2]previously returned a size mismatch error, but now it executes.

If your code uses element-wise operators and relies on the errors that MATLAB previously returned for mismatched sizes, particularly within atry/catchblock, then your code might no longer catch those errors.

For more information on the required input sizes for basic array operations, seeCompatible Array Sizes for Basic Operations.

minus,-

Syntax

描述

Examples

Subtract Scalar from Array

Subtract Two Arrays

Subtract Row and Column Vectors

Subtract Mean from Matrix

Input Arguments

`A`,`B`—Operands
scalars|vectors|matrices|multidimensional arrays

Extended Capabilities

Tall Arrays
Calculate with arrays that have more rows than fit in memory.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Distributed Arrays
Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

Version History

R2020b: Implicit expansion change affects`calendarDuration`,`datetime`, and`duration`arrays

R2016b: Implicit expansion change affects arguments for operators

See Also

Topics

minus,-

Syntax

描述

Examples

Subtract Scalar from Array

Subtract Two Arrays

Subtract Row and Column Vectors

Subtract Mean from Matrix

Input Arguments

A,B—Operandsscalars|vectors|matrices|multidimensional arrays

Extended Capabilities

Tall ArraysCalculate with arrays that have more rows than fit in memory.

C/C++ Code GenerationGenerate C and C++ code using MATLAB® Coder™.

GPU Code GenerationGenerate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based EnvironmentRun code in the background using MATLAB®backgroundPoolor accelerate code with Parallel Computing Toolbox™ThreadPool.

GPU ArraysAccelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Distributed ArraysPartition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

Version History

R2020b: Implicit expansion change affectscalendarDuration,datetime, anddurationarrays

R2016b: Implicit expansion change affects arguments for operators

See Also

Topics

`A`,`B`—Operands
scalars|vectors|matrices|multidimensional arrays

Tall Arrays
Calculate with arrays that have more rows than fit in memory.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Distributed Arrays
Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

R2020b: Implicit expansion change affects`calendarDuration`,`datetime`, and`duration`arrays