Add A.hat and hat(A), equivalent to A.norm() and norm(A); A.hat is easier to type than A.norm()

BruceSherwood · BruceSherwood · commit 828caccfee56 · 2016-04-12T10:54:24.000-06:00
diff --git a/docs/GlowScriptDocs/vector.html b/docs/GlowScriptDocs/vector.html
@@ -61,6 +61,9 @@ <h1 class="Heading-1"> <font color="#0000a0">The vector object</font></h1>
         <strong>mag2(A) = A.mag2</strong> = |A|*|A|, the vector's magnitude squared<br />
         <br />
         <strong>norm(A) = A.norm()</strong> = A/|A|,  a unit vector in the direction of the vector<br />
+        <br />
+        <strong>hat(A) = A.hat</strong> = 
+A/|A|,  a unit vector in the direction of the vector; an alternative to A.norm(), based on the fact that unit vectors are customarily written in the form <strong>ĉ</strong>, with a &quot;hat&quot; over the vector<br />
         <br />
         <strong>dot(A,B) = A.dot(B)</strong> = A dot B, the scalar dot product between two vectors<br />
         <br />
diff --git a/docs/VPythonDocs/vector.html b/docs/VPythonDocs/vector.html
@@ -69,6 +69,9 @@ <h1 class="Heading-1"> <font color="#0000a0">The vector Object</font></h1>
         <strong>mag2(A) = A.mag2</strong> = |A|*|A|, the vector's magnitude squared<br />
         <br />
         <strong>norm(A) = A.norm()</strong> = A/|A|,  a unit vector in the direction of the vector<br />
+        <br />
+        <strong>hat(A) = A.hat</strong> = 
+A/|A|,  a unit vector in the direction of the vector; an alternative to A.norm(), based on the fact that unit vectors are customarily written in the form <strong>ĉ</strong>, with a &quot;hat&quot; over the vector<br />
         <br />
         <strong>dot(A,B) = A.dot(B)</strong> = A dot B, the scalar dot product between two vectors<br />
         <br />
diff --git a/lib/glow/vectors.js b/lib/glow/vectors.js
@@ -309,6 +309,10 @@
         mag2: {
         	get: function () { return this.x * this.x + this.y * this.y + this.z * this.z },
         	set: function (value) { return this.norm().multiply(Math.sqrt(value)) }
+        },
+        hat: {
+        	get: function () { return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z) },
+        	set: function (value) { throw new Error("Cannot assign a value to v.hat") }
         }
     })
 
@@ -421,6 +425,9 @@
     function norm(A) {
         return A.norm();
     }
+    function hat(A) {
+        return A.hat;
+    }
     function dot(A,B) {
         return A.dot(B);
     }
@@ -458,6 +465,7 @@
         mag: mag,
         mag2: mag2,
         norm: norm,
+        hat: hat,
         dot: dot,
         cross: cross,
         comp: comp,
diff --git a/package/glow.2.1.min.js b/package/glow.2.1.min.js
