ReplaceToZero

Substitui valores pequenos na matriz/vetor por zero e retorna a quantidade de elementos substituídos.

ulong vector::ReplaceToZero(
  const double   abs_tol      // limiar do valor absoluto
   );
 
ulong vectorf::ReplaceToZero(
  const float    abs_tol      // limiar do valor absoluto
   );
 
ulong vectorc::ReplaceToZero(
  const double   abs_tol      // limiar do valor absoluto
   );
 
ulong vectorcf::ReplaceToZero(
  const float    abs_tol      // limiar do valor absoluto
   );
 
ulong matrix::ReplaceToZero(
  const double   abs_tol      // limiar do valor absoluto
   );
 
ulong matrixf::ReplaceToZero(
  const float    abs_tol      // limiar do valor absoluto
   );
 
ulong matrixc::ReplaceToZero(
  const double   abs_tol      // limiar do valor absoluto
   );
 
ulong matrixcf::ReplaceToZero(
  const float    abs_tol      // limiar do valor absoluto
   );

Parâmetros

abs_tol

[in] Limiar do valor absoluto para comparação com os elementos do vetor/matriz. Se o valor absoluto do elemento do vetor/matriz for menor ou igual a abs_tol, o elemento será substituído por zero. No caso de números complexos, com o limiar do valor absoluto é comparado ( sqrt(value.real*value.real+value.imag*value.imag) ).

Valor retornado

Quantidade de elementos pequenos da matriz/vetor que foram substituídos por zero.

Exemplo:

   matrixf a={{ 11234},
              { 12567},
              { 2539,10},
              { 36945},
              { 47,1055}};
   matrixf ai=a.Inv();
//--- o resultado deve ser a matriz identidade
   matrixf aai=a@ai;
   Print(aai);
//--- substituímos valores pequenos
   ulong replaced=aai.ReplaceToZero(1e-5);
   Print("replaced=",replaced);
//--- fica mais parecida com uma matriz identidade
   Print(aai);
 
  /*
[[0.99999976,0,0,-2.3841858e-07,0]
 [-4.1723251e-07,1,1.8626451e-09,-5.9604645e-08,2.3841858e-07]
 [-1.0728836e-06,-1.1920929e-07,0.99999994,-8.3446503e-07,4.7683716e-07]
 [-2.9802322e-07,5.9604645e-08,-3.9115548e-08,0.99999958,0]
 [-5.9604645e-08,-5.9604645e-08,4.2840838e-08,-6.5565109e-07,1.0000002]]
replaced=20
[[0.99999976,0,0,0,0]
 [0,1,0,0,0]
 [0,0,0.99999994,0,0]
 [0,0,0,0.99999958,0]
 [0,0,0,0,1.0000002]]
  */