Complex.Atan(Complex) Method

Reference

Definition

Namespace:: System.Numerics

Assemblies:: System.Numerics.dll, System.Runtime.Numerics.dll

Assemblies:: netstandard.dll, System.Runtime.Numerics.dll

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns the angle that is the arc tangent of the specified complex number.

public:
 static System::Numerics::Complex Atan(System::Numerics::Complex value);

public static System.Numerics.Complex Atan(System.Numerics.Complex value);

static member Atan : System.Numerics.Complex -> System.Numerics.Complex

Public Shared Function Atan (value As Complex) As Complex

Parameters

value: Complex

A complex number.

Returns

Complex

The angle that is the arc tangent of value.

Examples

The following example illustrates the Atan method. It shows that passing the value returned by the Atan method to the Tan method returns the original Complex value.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] values = { new Complex(2.5, 1.5),
                           new Complex(2.5, -1.5),
                           new Complex(-2.5, 1.5),
                           new Complex(-2.5, -1.5) };
      foreach (Complex value in values)
         Console.WriteLine("Tan(Atan({0})) = {1}",
                            value, Complex.Tan(Complex.Atan(value)));
   }
}
// The example displays the following output:
//       Tan(Atan((2.5, 1.5))) = (2.5, 1.5)
//       Tan(Atan((2.5, -1.5))) = (2.5, -1.5)
//       Tan(Atan((-2.5, 1.5))) = (-2.5, 1.5)
//       Tan(Atan((-2.5, -1.5))) = (-2.5, -1.5)

open System.Numerics

let values =
    [ Complex(2.5, 1.5)
      Complex(2.5, -1.5)
      Complex(-2.5, 1.5)
      Complex(-2.5, -1.5) ]

for value in values do
    printfn $"Tan(Atan({value})) = {Complex.Atan value |> Complex.Tan}"
// The example displays the following output:
//       Tan(Atan((2.5, 1.5))) = (2.5, 1.5)
//       Tan(Atan((2.5, -1.5))) = (2.5, -1.5)
//       Tan(Atan((-2.5, 1.5))) = (-2.5, 1.5)
//       Tan(Atan((-2.5, -1.5))) = (-2.5, -1.5)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim values() As Complex = { New Complex(2.5, 1.5), 
                                  New Complex(2.5, -1.5), 
                                  New Complex(-2.5, 1.5), 
                                  New Complex(-2.5, -1.5) }
      For Each value As Complex In values
         Console.WriteLine("Tan(Atan({0})) = {1}", 
                            value, Complex.Tan(Complex.Atan(value)))
      Next                               
   End Sub
End Module
' The example displays the following example:
'       Tan(Atan((2.5, 1.5))) = (2.5, 1.5)
'       Tan(Atan((2.5, -1.5))) = (2.5, -1.5)
'       Tan(Atan((-2.5, 1.5))) = (-2.5, 1.5)
'       Tan(Atan((-2.5, -1.5))) = (-2.5, -1.5)

Remarks

The Atan method for complex numbers corresponds to the Math.Atan method for real numbers.

The Atan method uses the following formula:

(ImaginaryOne / new Complex(2.0, 0.0)) * (Log(One - ImaginaryOne * value) - Log(One + ImaginaryOne * value))

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Share via