update docs

Change-Log.md

@@ -1,6 +1,6 @@
 # @vladmandic/human  
 
-Version: **0.40.6**  
+Version: **0.40.7**  
 Description: **Human: AI-powered 3D Face Detection, Face Embedding & Recognition, Body Pose Tracking, Hand & Finger Tracking, Iris Analysis, Age & Gender & Emotion Prediction & Gesture Recognition**  
 
 Author: **Vladimir Mandic <mandic00@live.com>**  
@@ -11,6 +11,10 @@ Repository: **<git+https://github.com/vladmandic/human.git>**
 
 ### **HEAD -> main** 2021/03/06 mandic00@live.com
 
+- implemented 3d face angle calculations
+
+### **0.40.6** 2021/03/06 mandic00@live.com
+
 - add curve draw output
 
 ### **0.40.5** 2021/03/05 mandic00@live.com

Configuration.md

@@ -97,6 +97,9 @@ config = {
     enabled: true,           // controls if specified modul is enabled
                              // face.enabled is required for all face models:
                              // detector, mesh, iris, age, gender, emotion
+                             // running detector only with mesh disabled is not recommended as detector prepares list of candidates
+                             // which are then validated and stabilized by mesh
+                             // running detetor-only produces fast but unreliable results with false positives
                              // (note: module is not loaded until it is required)
     detector: {
       modelPath: '../models/blazeface-back.json', // can be 'blazeface-front', 'blazeface-back' or 'faceboxes'

Outputs.md

@@ -20,7 +20,8 @@ result = {
       age,         // <number> estimated age
       gender,      // <string> 'male', 'female'
       embedding,   // <array>[float] vector of 192 values used for face simmilarity compare
-      angle:       // 3d face rotation values in radians
+      angle:       // 3d face rotation values in radians in range of -pi/2 to pi/2 which is -90 to +90 degrees
+                   // value of 0 means center
         {
           roll,    // roll is face lean left/right
           yaw,     // yaw is face turn left/right