feat: New Tensor operation magnitude, sqrt and cosSimilarity

Author: CodeWithKyrian

src/Tensor/Tensor.php

@@ -640,6 +640,26 @@ public function sigmoid(): self
         return new static($ndArray->buffer(), $ndArray->dtype(), $ndArray->shape(), $ndArray->offset());
     }
 
+    /**
+     * Calculates the magnitude of the tensor
+     *
+     * @return float The magnitude of the tensor.
+     */
+    public function magnitude(): float
+    {
+        $mo = self::mo();
+
+        return $mo->la()->nrm2($this);
+    }
+
+
+    public function sqrt(): NDArray
+    {
+        $mo = self::mo();
+
+        return $mo->la()->sqrt($this);
+    }
+
     /**
      * Return a new Tensor with every element multiplied by a constant.
      *
@@ -750,6 +770,20 @@ public function reciprocal(): self
         return new static($ndArray->buffer(), $ndArray->dtype(), $ndArray->shape(), $ndArray->offset());
     }
 
+    /**
+     * Calculates the cosine similarity between this Tensor and another Tensor.
+     *
+     * @param Tensor $other The Tensor to calculate the cosine similarity with.
+     * @return float|int The cosine similarity between this Tensor and the other Tensor.
+     */
+    public function cosSimilarity(Tensor $other): float|int
+    {
+        $dotProduct = $this->dot($other);
+        $magnitude = $this->magnitude();
+        $otherMagnitude = $other->magnitude();
+        return $dotProduct / ($magnitude * $otherMagnitude);
+    }
+
     /**
      * Performs `L_p` normalization of inputs over specified dimension.
      *