Rename Absolute::squared() to Absolute::abs_sqr()

For complex numbers, the result of this function is actually the
square of the absolute value of the number, not the square of the
number.

|a + bi|^2 == a^2 + b^2 == (a + bi)(a - bi) != (a + bi)^2

Author: jturner314

src/norm.rs

@@ -33,7 +33,7 @@ where
         self.iter().map(|x| x.abs()).sum()
     }
     fn norm_l2(&self) -> Self::Output {
-        self.iter().map(|x| x.squared()).sum::<A::Real>().sqrt()
+        self.iter().map(|x| x.abs_sqr()).sum::<A::Real>().sqrt()
     }
     fn norm_max(&self) -> Self::Output {
         self.iter().fold(A::Real::zero(), |f, &val| {

src/types.rs

@@ -18,7 +18,7 @@ pub use num_complex::Complex64 as c64;
 /// You can use the following operations with `A: Scalar`:
 ///
 /// - [abs](trait.Absolute.html#method.abs)
-/// - [squared](trait.Absolute.html#tymethod.squared)
+/// - [abs_sqr](trait.Absolute.html#tymethod.abs_sqr)
 /// - [sqrt](trait.SquareRoot.html#tymethod.sqrt)
 /// - [exp](trait.Exponential.html#tymethod.exp)
 /// - [conj](trait.Conjugate.html#tymethod.conj)
@@ -100,9 +100,9 @@ pub trait AssociatedComplex: Sized {
 
 /// Define `abs()` more generally
 pub trait Absolute: AssociatedReal {
-    fn squared(&self) -> Self::Real;
+    fn abs_sqr(&self) -> Self::Real;
     fn abs(&self) -> Self::Real {
-        self.squared().sqrt()
+        self.abs_sqr().sqrt()
     }
 }
 
@@ -164,7 +164,7 @@ impl AssociatedComplex for $complex {
 }
 
 impl Absolute for $real {
-    fn squared(&self) -> Self::Real {
+    fn abs_sqr(&self) -> Self::Real {
         *self * *self
     }
     fn abs(&self) -> Self::Real{
@@ -173,7 +173,7 @@ impl Absolute for $real {
 }
 
 impl Absolute for $complex {
-    fn squared(&self) -> Self::Real {
+    fn abs_sqr(&self) -> Self::Real {
         self.norm_sqr()
     }
     fn abs(&self) -> Self::Real {