Mlmodel Docs - Update Proto Pages Batch 1 (#2093)

* Mlmodel Docs - Update Proto Pages Batch 1

* Edit For Mlmodel Docs - Update Proto Pages Batch 1

---------

Co-authored-by: above3 <anthony_bove@apple.com>

Author: tonybove-apple

mlmodel/docs/Format/DataStructures.rst

@@ -12,9 +12,9 @@ to a 64-bit integer.
 
 .. code-block:: proto
 
-	message StringToInt64Map {
-	    map<string, int64> map = 1;
-	}
+    message StringToInt64Map {
+        map<string, int64> map = 1;
+    }
 
 
 
@@ -32,9 +32,9 @@ to a string.
 
 .. code-block:: proto
 
-	message Int64ToStringMap {
-	    map<int64, string> map = 1;
-	}
+    message Int64ToStringMap {
+        map<int64, string> map = 1;
+    }
 
 
 
@@ -52,9 +52,9 @@ to a double-precision floating point number.
 
 .. code-block:: proto
 
-	message StringToDoubleMap {
-	    map<string, double> map = 1;
-	}
+    message StringToDoubleMap {
+        map<string, double> map = 1;
+    }
 
 
 
@@ -72,9 +72,9 @@ to a double-precision floating point number.
 
 .. code-block:: proto
 
-	message Int64ToDoubleMap {
-	    map<int64, double> map = 1;
-	}
+    message Int64ToDoubleMap {
+        map<int64, double> map = 1;
+    }
 
 
 
@@ -91,9 +91,9 @@ A vector of strings.
 
 .. code-block:: proto
 
-	message StringVector {
-	    repeated string vector = 1;
-	}
+    message StringVector {
+        repeated string vector = 1;
+    }
 
 
 
@@ -108,9 +108,9 @@ A vector of 64-bit integers.
 
 .. code-block:: proto
 
-	message Int64Vector {
-	    repeated int64 vector = 1;
-	}
+    message Int64Vector {
+        repeated int64 vector = 1;
+    }
 
 
 
@@ -125,9 +125,9 @@ A vector of floating point numbers.
 
 .. code-block:: proto
 
-	message FloatVector {
-	    repeated float vector = 1;
-	}
+    message FloatVector {
+        repeated float vector = 1;
+    }
 
 
 
@@ -142,9 +142,9 @@ A vector of double-precision floating point numbers.
 
 .. code-block:: proto
 
-	message DoubleVector {
-	    repeated double vector = 1;
-	}
+    message DoubleVector {
+        repeated double vector = 1;
+    }
 
 
 
@@ -159,10 +159,10 @@ A range of int64 values
 
 .. code-block:: proto
 
-	message Int64Range {
-	    int64 minValue = 1;
-	    int64 maxValue = 2;
-	}
+    message Int64Range {
+        int64 minValue = 1;
+        int64 maxValue = 2;
+    }
 
 
 
@@ -177,9 +177,9 @@ A set of int64 values
 
 .. code-block:: proto
 
-	message Int64Set {
-	    repeated int64 values = 1;
-	}
+    message Int64Set {
+        repeated int64 values = 1;
+    }
 
 
 
@@ -194,7 +194,80 @@ A range of double values
 
 .. code-block:: proto
 
-	message DoubleRange {
-	    double minValue = 1;
-	    double maxValue = 2;
-	}
+    message DoubleRange {
+        double minValue = 1;
+        double maxValue = 2;
+    }
+
+
+
+PrecisionRecallCurve
+________________________________________________________________________________
+
+The syntax comprises two tables: one to look up the precision value threshold
+for a given precision, and the other for a given recall. 
+
+.. list-table:: Example
+   :widths: 55 5 5 5 5 5 5 5 5 5
+   :header-rows: 0
+
+   * - ``precisionValues``
+     - .1
+     - .2
+     - .3
+     - .4
+     - .5
+     - .6
+     - .7
+     -
+     -
+   * - ``precisionConfidence``
+     - .0
+     - .0
+     - .0
+     - .0
+     - .1
+     - .3
+     - .4
+     -
+     -
+   * - ``recallValues``
+     - .1
+     - .2
+     - .3
+     - .4
+     - .5
+     - .6
+     - .7
+     - .8
+     - .9
+   * - ``recallConfidence``
+     - .7
+     - .6
+     - .5
+     - .4
+     - .3
+     - .3
+     - .2
+     - .1
+     - .0
+
+The application expects that, when it filters out samples with
+confidence threshold = 0.1, it gets precision = 0.5. Likewise,
+with threshold = 0.2 it gets recall = 0.7.
+
+The table must have only valid values; do not use ``NaN``, ``+/- INF``,
+or negative values. The application is responsible for inter/extrapolating the
+appropriate confidence threshold based on the application's specific need.
+
+.. code-block:: proto
+
+    message PrecisionRecallCurve {
+        FloatVector precisionValues = 1;
+        FloatVector precisionConfidenceThresholds = 2;
+        FloatVector recallValues = 3;
+        FloatVector recallConfidenceThresholds = 4;
+    }
+
+
+