acot

Inverse cotangent in radians

Syntax

Y = acot(X)

Description

Y = acot(X) returns the Inverse Cotangent (cot^-1) of the elements of X in radians. The function accepts both real and complex inputs.

• For real values of X, acot(X) returns values in the interval [-π/2, π/2].

• For complex values of X, acot(X) returns complex values.

Examples

Inverse Cotangent of a Value

Find the inverse cotangent of a value.

acot(2.6)

ans = 
0.3672

Inverse Cotangent of a Vector of Complex Values

Find the inverse cotangent of the elements of vector x. The acot function acts on x element-wise.

x = [0.5i 1+3i -2.2+i];
Y = acot(x)

Y = 1×3 complex

   1.5708 - 0.5493i   0.1093 - 0.3059i  -0.3689 - 0.1506i

Plot the Inverse Cotangent Function

Plot the inverse cotangent function over the intervals $$-2\pi \le x<0$$ and $$0<x\le 2\pi$$.

x1 = -2*pi:pi/30:-0.1;
x2 = 0.1:pi/30:2*pi;
plot(x1,acot(x1),'b')
hold on
plot(x2,acot(x2),'b')
grid on

Input Arguments

X — Cotangent of angle

scalar | vector | matrix | multidimensional array | table | timetable

Cotangent of angle, specified as a scalar, vector, matrix, multidimensional array, table, or timetable. The acot operation is element-wise when X is nonscalar.

Data Types: single | double | table | timetable
Complex Number Support: Yes

More About

Inverse Cotangent

The inverse cotangent is defined as

$${\cot }^{-1}(z)={\tan }^{-1}\left(\frac{1}{z}\right).$$

Extended Capabilities

Tall Arrays

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

The acot function fully supports tall arrays. For more information, see Tall Arrays.

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.

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

GPU Arrays

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

The acot function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run 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, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a

R2023a: Perform calculations directly on tables and timetables

The acot function can calculate on all variables within a table or timetable without indexing to access those variables. All variables must have data types that support the calculation. For more information, see Direct Calculations on Tables and Timetables.