MQL5 RiferimentoFunzioni MatematicheMathArctan2

MathArctan2

Restituisce l'arcotangente del quoziente di due argomenti (x, y).

double  MathArctan2(
   const double       y,         // Coordinate Y
   const double       x          // Coordinate X
  );

Valore di ritorno

Restituisce true in caso di successo, altrimenti false.

Parametri

[in] Le coordinate Y del punto.

[in] Le coordinate X del punto.

Nota

Si prega di notare quanto segue.

Per (x, y) nel quadrante 1, il valore restituito sarà: 0 < θ < π/2.
Per (x, y) nel quadrante 2, il valore restituito sarà: π/2 <θ≤π.
Per (x, y) nel quadrante 3, il valore restituito sarà: -π <θ <-π/2.
Per (x, y) nel quadrante 4, il valore restituito sarà: -π/2 <θ <0.

Il valore di ritorno per i punti fuori questi quadranti è indicato di seguito.

Se y è 0 e x non è negativo, allora θ = 0.
Se y è 0 e x è negativo, allora θ = π.
Se y è un numero positivo, e x è 0, allora θ = π/2.
Se y è negativo e х è 0, allora θ = -π/2.
Se y è 0 e х è 0, allora θ = -π/2.

Se il valore del parametro X o Y è NaN, o se i valori dei parametri x ed y sono uguali al valore PositiveInfinity o NegativeInfinity, il metodo restituisce il valore NaN.

Esempio:

#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;
//--- ottenere 101 valori da 0 a 2 pi greco con passo delta
   vector X=delta.CumSum();
//--- calcola il valore dell'arcotangente per ogni valore del vettore X
   vector Y=delta.CumSum();

   Print("vector delta = \n",delta);
   Print("vector X = \n",X);
   Print("vector Y = \n",Y);

//-- trasferire i valori calcolati dai vettori agli array
   double x_array[];;
   double y_array[];;
   X.Swap(x_array);
   Y.Swap(y_array);

   double array[10];
   for(int i=0; i<10; i++)
     {
      array[i]=MathArctan2(y_array[i],x_array[i]);
     }

//--- traccia un grafico dei valori vettoriali calcolati
   CurvePlot(x_array,y_array,clrDodgerBlue);

//--- attendere di aver premuto i tasti Escape o PgDn per eliminare il grafico (prendere uno screenshot) ed uscire
   while(!IsStopped())
     {
      if(StopKeyPressed())
         break;
      Sleep(16);
     }

//--- pulire
   ExtGraph.Destroy();
  }
//+-----------------------------------------------------------------------------------------------------------+
//| Quando si preme ESC, restituire 'true'                                                                    |
//| Quando si preme PgDn, prendere uno screenshot del grafico e restituire 'true'                             |
//| Altrimenti restituire 'false'                                                                             |
//+-----------------------------------------------------------------------------------------------------------+
bool StopKeyPressed()
  {
//--- se viene premuto ESC, restituisce 'true'
   if(TerminalInfoInteger(TERMINAL_KEYSTATE_ESCAPE)!=0)
      return(true);
//--- se PgDn viene premuto e uno screenshot del grafico viene preso correttamente, restituisce 'true'
   if(TerminalInfoInteger(TERMINAL_KEYSTATE_PAGEDOWN)!=0 && MakeAndSaveScreenshot(MQLInfoString(MQL_PROGRAM_NAME)+"_Screenshot"))
      return(true);
//--- restituisce 'false'
   return(false);
  }
//+------------------------------------------------------------------+
//| Crea un oggetto grafico e disegna una curva                      |
//+------------------------------------------------------------------+
void CurvePlot(double &x_array[], double &y_array[], const color colour)
  {
   ExtGraph.Create(ChartID(), "Graphic", 0, 0, 0, GRAPH_WIDTH, GRAPH_HEIGHT);
   ExtGraph.CurveAdd(x_array, y_array, ColorToARGB(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(54, 9, text1, ColorToARGB(clrBlack));
   ExtGraph.TextAdd(54,21, text2, ColorToARGB(clrBlack));
   ExtGraph.Update();
  }
//+------------------------------------------------------------------+
//| Fa uno screenshot e salva l'immagine in un file                  |
//+------------------------------------------------------------------+
bool MakeAndSaveScreenshot(const string file_name)
  {
   string file_names[];
   ResetLastError();
   int selected=FileSelectDialog("Save Picture", NULL, "All files (*.*)|*.*", FSD_WRITE_FILE, file_names, file_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(0, file_names[0], GRAPH_WIDTH, GRAPH_HEIGHT);
   ChartSetInteger(0,CHART_SHOW,true);
   return(res);
  }

Risultato:

MathArctan2_Screenshot

MathArctan

MathClassify