MathArctan2

Devuelve en radianes el valor del ángulo cuya tangente es igual al cociente de los dos números especificados.

double  MathArctan2(
   double  y      // coordenada Y del punto
   double  x      // coordenada X del punto
   );

Parámetros

y

[in]  Número que representa la coordenada Y.

x

[in]  Número que representa la coordenada X.

Valor retornado

MathArctan2 devuelve el valor del ángulo θ en un intervalo de π a π radianes, así que MathTan(θ)=y/x.

Preste atención a lo siguiente:

  • Para (x, y) en el cuadrante 1, 0 < θ < π/2
  • Para (x, y) en el cuadrante 2, π/2 < θ≤π
  • Para (x, y) en el cuadrante 3, -π < θ < -π/2
  • Para (x, y) en el cuadrante 4, -π/2 < θ < 0

Más abajo se muestra el valor devuelto para los puntos fuera de los cuadrantes indicados:

  • Si Y es igual a 0, y X no es negativo, entonces θ = 0.
  • Si Y es igual a 0, y X es negativo, entonces θ = π.
  • Si Y es un número positivo, y X es igual a 0, entonces θ = π/2.
  • Si Y es un número negativo, y X es igual a 0, entonces θ = -π/2.
  • Si Y es igual 0, y X es igual a 0, entonces θ = 0.

Observación

En lugar de la función MathArctan2(), se puede utilizar la función atan2().

 

Ejemplo:

#define GRAPH_WIDTH  750
#define GRAPH_HEIGHT 350
 
#include <Graphics\Graphic.mqh>
 
CGraphic ExtGraph;
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
   vector delta=vector::Full(10,10);
   delta[0]=0;
//--- obtenemos 101 valores de -1 a 2 pi con paso delta
   vector X=delta.CumSum();
//--- calculamos el valor del arcotangente para cada valor del vector X
   vector Y=delta.CumSum();
   
   Print("vector delta = \n",delta);
   Print("vector X = \n",X);
   Print("vector Y = \n",Y);
   
//--- transferimos los valores calculados de vectores a arrays
   double x_array[];;
   double y_array[];;
   X.Swap(x_array);
   Y.Swap(y_array);
   
   double array[10];
   for(int i=0i<10i++)
     {
      array[i]=MathArctan2(y_array[i],x_array[i]);
     }
 
//--- dibujamos el gráfico de los valores calculados del vector
   CurvePlot(x_array,y_array,clrDodgerBlue);
 
//--- esperamos la pulsación de Escape o PgDn para eliminar el gráfico (crear una captura de pantalla) y finalizar el funcionamiento
   while(!IsStopped())
     {
      if(StopKeyPressed())
         break;
      Sleep(16);
     }
 
//--- limpiamos
   ExtGraph.Destroy();
  }
//+------------------------------------------------------------------+
//| Al pulsar ESC, retorna true                                      |
//| Al pulsar PgDn hace una captura del gráfico y retorna true       |
//| Si no, retorna false                                             |
//+------------------------------------------------------------------+
bool StopKeyPressed()
  {
//--- si ESC está pulsado, retornamos true
   if(TerminalInfoInteger(TERMINAL_KEYSTATE_ESCAPE)!=0)
      return(true);
//--- si PgDn está pulsado y se realiza correctamente la captura de pantalla, retornamos true
   if(TerminalInfoInteger(TERMINAL_KEYSTATE_PAGEDOWN)!=0 && MakeAndSaveScreenshot(MQLInfoString(MQL_PROGRAM_NAME)+"_Screenshot"))
      return(true);
//--- retornamos false
   return(false);
  }
//+------------------------------------------------------------------+
//| Crea un objeto de gráfico y dibuja una curva                     |
//+------------------------------------------------------------------+
void CurvePlot(double &x_array[], double &y_array[], const color colour)
  {
   ExtGraph.Create(ChartID(), "Graphic"000GRAPH_WIDTHGRAPH_HEIGHT);
   ExtGraph.CurveAdd(x_arrayy_arrayColorToARGB(colour), CURVE_LINES);
   ExtGraph.IndentUp(30);
   ExtGraph.CurvePlotAll();
   string text1="Press ESC to delete the graph and stop the script, or";
   string text2="Press PgDn to create a screen, delete the graph and stop the script";
   ExtGraph.TextAdd(549text1ColorToARGB(clrBlack));
   ExtGraph.TextAdd(54,21text2ColorToARGB(clrBlack));
   ExtGraph.Update();
  }
//+------------------------------------------------------------------+
//| Crea una captura de pantalla y guarda la imagen en un archivo    |
//+------------------------------------------------------------------+
bool MakeAndSaveScreenshot(const string file_name)
  {
   string file_names[];
   ResetLastError();
   int selected=FileSelectDialog("Save Picture"NULL"All files (*.*)|*.*"FSD_WRITE_FILEfile_namesfile_name+".png");
   if(selected<1)
     {
      if(selected<0)
         PrintFormat("%s: FileSelectDialog() function returned error %d"__FUNCTION__GetLastError());
      return false;
     }
   
   bool res=false;
   if(ChartSetInteger(0,CHART_SHOW,false))
      res=ChartScreenShot(0file_names[0], GRAPH_WIDTHGRAPH_HEIGHT);
   ChartSetInteger(0,CHART_SHOW,true);
   return(res);
  }

 

Resultado:

MathArctan2_Screenshot

Vea también

Tipos reales (double, float), Estadística, Gráficos científicos, Estado del terminal de cliente