Complex.FromPolarCoordinates(Double, Double) Méthode

Définition

Crée un nombre complexe à partir des coordonnées polaires d'un point.Creates a complex number from a point's polar coordinates.

public:
 static System::Numerics::Complex FromPolarCoordinates(double magnitude, double phase);
public static System.Numerics.Complex FromPolarCoordinates (double magnitude, double phase);
static member FromPolarCoordinates : double * double -> System.Numerics.Complex
Public Shared Function FromPolarCoordinates (magnitude As Double, phase As Double) As Complex

Paramètres

magnitude
Double

Grandeur, à savoir la distance entre l'origine (intersection de l'axe des abscisses et de l'axe des ordonnées) et le nombre.The magnitude, which is the distance from the origin (the intersection of the x-axis and the y-axis) to the number.

phase
Double

Phase, à savoir l'angle de la ligne par rapport à l'axe horizontal, mesurée en radians.The phase, which is the angle from the line to the horizontal axis, measured in radians.

Retours

Nombre complexe.A complex number.

Exemples

L’exemple suivant utilise la méthode FromPolarCoordinates pour instancier un nombre complexe en fonction de ses coordonnées polaires, puis affiche la valeur de ses propriétés Magnitude et Phase.The following example uses the FromPolarCoordinates method to instantiate a complex number based on its polar coordinates and then displays the value of its Magnitude and Phase properties.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex c1 = Complex.FromPolarCoordinates(10, 45 * Math.PI / 180);
      Console.WriteLine("{0}:", c1);
      Console.WriteLine("   Magnitude: {0}", Complex.Abs(c1));
      Console.WriteLine("   Phase:     {0} radians", c1.Phase);
      Console.WriteLine("   Phase      {0} degrees", c1.Phase * 180/Math.PI);
      Console.WriteLine("   Atan(b/a): {0}", Math.Atan(c1.Imaginary/c1.Real));
   }
}
// The example displays the following output:
//       (7.07106781186548, 7.07106781186547):
//          Magnitude: 10
//          Phase:     0.785398163397448 radians
//          Phase      45 degrees
//          Atan(b/a): 0.785398163397448
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c1 As Complex = Complex.FromPolarCoordinates(10, 45 * Math.Pi / 180)
      Console.WriteLine("{0}:", c1)
      Console.WriteLine("   Magnitude: {0}", Complex.Abs(c1))
      Console.WriteLine("   Phase:     {0} radians", c1.Phase)
      Console.WriteLine("   Phase      {0} degrees", c1.Phase * 180/Math.Pi)
      Console.WriteLine("   Atan(b/a): {0}", Math.Atan(c1.Imaginary/c1.Real))
   End Sub
End Module
' The example displays the following output:
'       (7.07106781186548, 7.07106781186547):
'          Magnitude: 10
'          Phase:     0.785398163397448 radians
'          Phase      45 degrees
'          Atan(b/a): 0.785398163397448

Remarques

La méthode FromPolarCoordinates instancie un nombre complexe en fonction de ses coordonnées polaires.The FromPolarCoordinates method instantiates a complex number based on its polar coordinates.

Étant donné qu’il existe plusieurs représentations d’un point sur un plan complexe, la valeur de retour de la méthode FromPolarCoordinates est normalisée.Because there are multiple representations of a point on a complex plane, the return value of the FromPolarCoordinates method is normalized. L’amplitude est normalisée en un nombre positif et la phase est normalisée en une valeur dans la plage de-PI à PI.The magnitude is normalized to a positive number, and the phase is normalized to a value in the range of -PI to PI. Par conséquent, les valeurs des propriétés Phase et Magnitude du nombre complexe résultant peuvent ne pas être égales aux valeurs d’origine des paramètres magnitude et phase.As a result, the values of the Phase and Magnitude properties of the resulting complex number may not equal the original values of the magnitude and phase parameters.

Pour convertir une valeur de degrés en radians pour le paramètre phase, multipliez-la par Math.PI/180.To convert a value from degrees to radians for the phase parameter, multiply it by Math.PI/180.

S’applique à

Voir aussi