generate Visual Recogntion

Author: mediumTaj

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/IVisualRecognitionService.cs

@@ -22,13 +22,48 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3
 {
     public partial interface IVisualRecognitionService
     {
-        ClassifiedImages Classify(System.IO.Stream imagesFile = null, string acceptLanguage = null, string url = null, float? threshold = null, List<string> owners = null, List<string> classifierIds = null, string imagesFileContentType = null);
-        DetectedFaces DetectFaces(System.IO.Stream imagesFile = null, string url = null, string imagesFileContentType = null);
-
-        object DeleteClassifier(string classifierId);
-
-        Classifier GetClassifier(string classifierId);
-
-        Classifiers ListClassifiers(bool? verbose = null);
+        /// <summary>
+        /// Classify images. Classify images with built-in or custom classifiers.
+        /// </summary>
+        /// <param name="imagesFile">An image file (.jpg, .png) or .zip file with images. Maximum image size is 10 MB. Include no more than 20 images and limit the .zip file to 100 MB. Encode the image and .zip file names in UTF-8 if they contain non-ASCII characters. The service assumes UTF-8 encoding if it encounters non-ASCII characters.  You can also include an image with the **url** parameter. (optional)</param>
+        /// <param name="acceptLanguage">The language of the output class names. The full set of languages is supported only for the built-in `default` classifier ID. The class names of custom classifiers are not translated.  The response might not be in the specified language when the requested language is not supported or when there is no translation for the class name. (optional, default to en)</param>
+        /// <param name="url">The URL of an image to analyze. Must be in .jpg, or .png format. The minimum recommended pixel density is 32X32 pixels per inch, and the maximum image size is 10 MB.  You can also include images with the **images_file** parameter. (optional)</param>
+        /// <param name="threshold">The minimum score a class must have to be displayed in the response. Set the threshold to `0.0` to ignore the classification score and return all values. (optional, default to 0.5)</param>
+        /// <param name="owners">The categories of classifiers to apply. Use `IBM` to classify against the `default` general classifier, and use `me` to classify against your custom classifiers. To analyze the image against both classifier categories, set the value to both `IBM` and `me`.   The built-in `default` classifier is used if both **classifier_ids** and **owners** parameters are empty.  The **classifier_ids** parameter overrides **owners**, so make sure that **classifier_ids** is empty. (optional)</param>
+        /// <param name="classifierIds">Which classifiers to apply. Overrides the **owners** parameter. You can specify both custom and built-in classifier IDs. The built-in `default` classifier is used if both **classifier_ids** and **owners** parameters are empty.  The following built-in classifier IDs require no training: - `default`: Returns classes from thousands of general tags. - `food`: (Beta) Enhances specificity and accuracy for images of food items. - `explicit`: (Beta) Evaluates whether the image might be pornographic. (optional)</param>
+        /// <param name="imagesFileContentType">The content type of imagesFile. (optional)</param>
+        /// <param name="customData">Custom data object to pass data including custom request headers.</param>
+        /// <returns><see cref="ClassifiedImages" />ClassifiedImages</returns>
+        ClassifiedImages Classify(System.IO.Stream imagesFile = null, string acceptLanguage = null, string url = null, float? threshold = null, List<string> owners = null, List<string> classifierIds = null, string imagesFileContentType = null, Dictionary<string, object> customData = null);
+        /// <summary>
+        /// Detect faces in images. **Important:** On April 2, 2018, the identity information in the response to calls to the Face model was removed. The identity information refers to the `name` of the person, `score`, and `type_hierarchy` knowledge graph. For details about the enhanced Face model, see the [Release notes](https://console.bluemix.net/docs/services/visual-recognition/release-notes.html#2april2018).  Analyze and get data about faces in images. Responses can include estimated age and gender. This feature uses a built-in model, so no training is necessary. The Detect faces method does not support general biometric facial recognition.  Supported image formats include .gif, .jpg, .png, and .tif. The maximum image size is 10 MB. The minimum recommended pixel density is 32X32 pixels per inch.
+        /// </summary>
+        /// <param name="imagesFile">An image file (gif, .jpg, .png, .tif.) or .zip file with images. Limit the .zip file to 100 MB. You can include a maximum of 15 images in a request.  Encode the image and .zip file names in UTF-8 if they contain non-ASCII characters. The service assumes UTF-8 encoding if it encounters non-ASCII characters.  You can also include an image with the **url** parameter. (optional)</param>
+        /// <param name="url">The URL of an image to analyze. Must be in .gif, .jpg, .png, or .tif format. The minimum recommended pixel density is 32X32 pixels per inch, and the maximum image size is 10 MB. Redirects are followed, so you can use a shortened URL.  You can also include images with the **images_file** parameter. (optional)</param>
+        /// <param name="imagesFileContentType">The content type of imagesFile. (optional)</param>
+        /// <param name="customData">Custom data object to pass data including custom request headers.</param>
+        /// <returns><see cref="DetectedFaces" />DetectedFaces</returns>
+        DetectedFaces DetectFaces(System.IO.Stream imagesFile = null, string url = null, string imagesFileContentType = null, Dictionary<string, object> customData = null);
+        /// <summary>
+        /// Delete a classifier. 
+        /// </summary>
+        /// <param name="classifierId">The ID of the classifier.</param>
+        /// <param name="customData">Custom data object to pass data including custom request headers.</param>
+        /// <returns><see cref="BaseModel" />BaseModel</returns>
+        BaseModel DeleteClassifier(string classifierId, Dictionary<string, object> customData = null);
+        /// <summary>
+        /// Retrieve classifier details. Retrieve information about a custom classifier.
+        /// </summary>
+        /// <param name="classifierId">The ID of the classifier.</param>
+        /// <param name="customData">Custom data object to pass data including custom request headers.</param>
+        /// <returns><see cref="Classifier" />Classifier</returns>
+        Classifier GetClassifier(string classifierId, Dictionary<string, object> customData = null);
+        /// <summary>
+        /// Retrieve a list of classifiers. 
+        /// </summary>
+        /// <param name="verbose">Specify `true` to return details about the classifiers. Omit this parameter to return a brief list of classifiers. (optional)</param>
+        /// <param name="customData">Custom data object to pass data including custom request headers.</param>
+        /// <returns><see cref="Classifiers" />Classifiers</returns>
+        Classifiers ListClassifiers(bool? verbose = null, Dictionary<string, object> customData = null);
     }
 }

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/IVisualRecognitionServiceExtension.cs

@@ -16,13 +16,17 @@
 */
 
 using IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model;
+using System.Collections.Generic;
+using System.Threading.Tasks;
 
 namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3
 {
     public partial interface IVisualRecognitionService
     {
-        Classifier CreateClassifier(CreateClassifier createClassifier);
+        Classifier CreateClassifier(CreateClassifier createClassifier, Dictionary<string, object> customData = null);
 
-        Classifier UpdateClassifier(UpdateClassifier updateClassifier);
+        Classifier UpdateClassifier(UpdateClassifier updateClassifier, Dictionary<string, object> customData = null);
+
+        Task<System.IO.Stream> GetCoreMlModel(string classifierId, Dictionary<string, object> customData = null);
     }
 }

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/ClassResult.cs

@@ -22,7 +22,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Result of a class within a classifier.
     /// </summary>
-    public class ClassResult
+    public class ClassResult : BaseModel
     {
         /// <summary>
         /// The name of the class.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/ClassifiedImage.cs

@@ -23,7 +23,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Classifier results for one image.
     /// </summary>
-    public class ClassifiedImage
+    public class ClassifiedImage : BaseModel
     {
         /// <summary>
         /// Source of the image before any redirects. Not returned when the image is uploaded.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/ClassifiedImages.cs

@@ -23,7 +23,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Classify results for multiple images.
     /// </summary>
-    public class ClassifiedImages
+    public class ClassifiedImages : BaseModel
     {
         /// <summary>
         /// The number of custom classes identified in the images.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/Classifier.cs

@@ -26,7 +26,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Information about a classifier.
     /// </summary>
-    public class Classifier
+    public class Classifier : BaseModel
     {
         /// <summary>
         /// The training status of classifier.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/ClassifierResult.cs

@@ -23,7 +23,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Classifier and score combination.
     /// </summary>
-    public class ClassifierResult
+    public class ClassifierResult : BaseModel
     {
         /// <summary>
         /// Name of the classifier.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/Classifiers.cs

@@ -23,7 +23,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// List of classifiers.
     /// </summary>
-    public class Classifiers
+    public class Classifiers : BaseModel
     {
         /// <summary>
         /// Gets or Sets Classifiers

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/DetectedFaces.cs

@@ -23,7 +23,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// DetectedFaces.
     /// </summary>
-    public class DetectedFaces
+    public class DetectedFaces : BaseModel
     {
         /// <summary>
         /// Number of images processed for the API call.

src/IBM.WatsonDeveloperCloud.VisualRecognition.v3/Model/ErrorInfo.cs

@@ -22,7 +22,7 @@ namespace IBM.WatsonDeveloperCloud.VisualRecognition.v3.Model
     /// <summary>
     /// Information about what might have caused a failure, such as an image that is too large. Not returned when there is no error.
     /// </summary>
-    public class ErrorInfo
+    public class ErrorInfo : BaseModel
     {
         /// <summary>
         /// HTTP status code.