prep for 2023. Fixed many bugs. Added pdf guide

vendor/markbaker/complex/classes/src/functions/ln.php

@@ -0,0 +1,33 @@
+<?php
+
+/**
+ *
+ * Function code for the complex ln() function
+ *
+ * @copyright  Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
+ * @license    https://opensource.org/licenses/MIT    MIT
+ */
+namespace Complex;
+
+/**
+ * Returns the natural logarithm of a complex number.
+ *
+ * @param     Complex|mixed    $complex    Complex number or a numeric value.
+ * @return    Complex          The natural logarithm of the complex argument.
+ * @throws    Exception        If argument isn't a valid real or complex number.
+ * @throws    \InvalidArgumentException  If the real and the imaginary parts are both zero
+ */
+function ln($complex)
+{
+    $complex = Complex::validateComplexArgument($complex);
+
+    if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
+        throw new \InvalidArgumentException();
+    }
+
+    return new Complex(
+        \log(rho($complex)),
+        theta($complex),
+        $complex->getSuffix()
+    );
+}