VisualRecognition (ibm-watson 7.3.0 API)

java.lang.Object
- com.ibm.cloud.sdk.core.service.BaseService
- - com.ibm.watson.visual_recognition.v3.VisualRecognition

```
public class VisualRecognition
extends com.ibm.cloud.sdk.core.service.BaseService
```
The IBM Watson™ Visual Recognition service uses deep learning algorithms to identify scenes, objects, and faces in images you upload to the service. You can create and train a custom classifier to identify subjects that suit your needs.

See Also:

Visual Recognition

Field Summary
- Fields inherited from class com.ibm.cloud.sdk.core.service.BaseService
  JSON_MIME_PATTERN, JSON_PATCH_MIME_PATTERN

Constructor Summary

Constructors
Constructor and Description
`VisualRecognition(java.lang.String versionDate)` Deprecated. Use VisualRecognition(String versionDate, AuthenticatorConfig authenticatorConfig) instead
`VisualRecognition(java.lang.String versionDate, com.ibm.cloud.sdk.core.security.AuthenticatorConfig authenticatorConfig)` Instantiates a new `VisualRecognition` with the specified authentication configuration.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`com.ibm.cloud.sdk.core.http.ServiceCall<ClassifiedImages>`	`classify()` Classify images.
`com.ibm.cloud.sdk.core.http.ServiceCall<ClassifiedImages>`	`classify(ClassifyOptions classifyOptions)` Classify images.
`com.ibm.cloud.sdk.core.http.ServiceCall<Classifier>`	`createClassifier(CreateClassifierOptions createClassifierOptions)` Create a classifier.
`com.ibm.cloud.sdk.core.http.ServiceCall<java.lang.Void>`	`deleteClassifier(DeleteClassifierOptions deleteClassifierOptions)` Delete a classifier.
`com.ibm.cloud.sdk.core.http.ServiceCall<java.lang.Void>`	`deleteUserData(DeleteUserDataOptions deleteUserDataOptions)` Delete labeled data.
`com.ibm.cloud.sdk.core.http.ServiceCall<DetectedFaces>`	`detectFaces()` Detect faces in images.
`com.ibm.cloud.sdk.core.http.ServiceCall<DetectedFaces>`	`detectFaces(DetectFacesOptions detectFacesOptions)` Detect faces in images.
`com.ibm.cloud.sdk.core.http.ServiceCall<Classifier>`	`getClassifier(GetClassifierOptions getClassifierOptions)` Retrieve classifier details.
`com.ibm.cloud.sdk.core.http.ServiceCall<java.io.InputStream>`	`getCoreMlModel(GetCoreMlModelOptions getCoreMlModelOptions)` Retrieve a Core ML model of a classifier.
`com.ibm.cloud.sdk.core.http.ServiceCall<Classifiers>`	`listClassifiers()` Retrieve a list of classifiers.
`com.ibm.cloud.sdk.core.http.ServiceCall<Classifiers>`	`listClassifiers(ListClassifiersOptions listClassifiersOptions)` Retrieve a list of classifiers.
`com.ibm.cloud.sdk.core.http.ServiceCall<Classifier>`	`updateClassifier(UpdateClassifierOptions updateClassifierOptions)` Update a classifier.

Methods inherited from class com.ibm.cloud.sdk.core.service.BaseService
configureClient, configureHttpClient, createServiceCall, getApiKey, getAuthenticator, getClient, getEndPoint, getName, getPassword, getUsername, isJsonMimeType, isJsonPatchMimeType, isSkipAuthentication, isTokenManagerSet, processServiceCall, setApiKey, setAuthentication, setAuthenticator, setClient, setDefaultHeaders, setDefaultHeaders, setEndPoint, setIamCredentials, setSkipAuthentication, setUsernameAndPassword, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - VisualRecognition
```
@Deprecated
public VisualRecognition(java.lang.String versionDate)
```
    Deprecated. Use VisualRecognition(String versionDate, AuthenticatorConfig authenticatorConfig) instead
    
    Instantiates a new `VisualRecognition`.
    
    Parameters:
    
    versionDate - The version date (yyyy-MM-dd) of the REST API to use. Specifying this value will keep your API calls from failing when the service introduces breaking changes.
  - VisualRecognition
```
public VisualRecognition(java.lang.String versionDate,
                         com.ibm.cloud.sdk.core.security.AuthenticatorConfig authenticatorConfig)
```
    Instantiates a new `VisualRecognition` with the specified authentication configuration.
    
    Parameters:
    
    versionDate - The version date (yyyy-MM-dd) of the REST API to use. Specifying this value will keep your API calls from failing when the service introduces breaking changes.
    
    authenticatorConfig - the authentication configuration for this service
- Method Detail
  - classify
```
public com.ibm.cloud.sdk.core.http.ServiceCall<ClassifiedImages> classify(ClassifyOptions classifyOptions)
```
    Classify images. Classify images with built-in or custom classifiers.
    
    Parameters:
    
    classifyOptions - the ClassifyOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of ClassifiedImages
  - classify
```
public com.ibm.cloud.sdk.core.http.ServiceCall<ClassifiedImages> classify()
```
    Classify images. Classify images with built-in or custom classifiers.
    
    Returns:
    
    a ServiceCall with a response type of ClassifiedImages
  - detectFaces
```
public com.ibm.cloud.sdk.core.http.ServiceCall<DetectedFaces> detectFaces(DetectFacesOptions detectFacesOptions)
```
    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://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-release-notes#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, but the service tends to perform better with images that are at least 224 x 224 pixels.
    
    Parameters:
    
    detectFacesOptions - the DetectFacesOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of DetectedFaces
  - detectFaces
```
public com.ibm.cloud.sdk.core.http.ServiceCall<DetectedFaces> detectFaces()
```
    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://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-release-notes#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, but the service tends to perform better with images that are at least 224 x 224 pixels.
    
    Returns:
    
    a ServiceCall with a response type of DetectedFaces
  - createClassifier
```
public com.ibm.cloud.sdk.core.http.ServiceCall<Classifier> createClassifier(CreateClassifierOptions createClassifierOptions)
```
    Create a classifier. Train a new multi-faceted classifier on the uploaded image data. Create your custom classifier with positive or negative examples. Include at least two sets of examples, either two positive example files or one positive and one negative file. You can upload a maximum of 256 MB per call. Encode all names in UTF-8 if they contain non-ASCII characters (.zip and image file names, and classifier and class names). The service assumes UTF-8 encoding if it encounters non-ASCII characters.
    
    Parameters:
    
    createClassifierOptions - the CreateClassifierOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Classifier
  - listClassifiers
```
public com.ibm.cloud.sdk.core.http.ServiceCall<Classifiers> listClassifiers(ListClassifiersOptions listClassifiersOptions)
```
    Retrieve a list of classifiers.
    
    Parameters:
    
    listClassifiersOptions - the ListClassifiersOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Classifiers
  - listClassifiers
```
public com.ibm.cloud.sdk.core.http.ServiceCall<Classifiers> listClassifiers()
```
    Retrieve a list of classifiers.
    
    Returns:
    
    a ServiceCall with a response type of Classifiers
  - getClassifier
```
public com.ibm.cloud.sdk.core.http.ServiceCall<Classifier> getClassifier(GetClassifierOptions getClassifierOptions)
```
    Retrieve classifier details. Retrieve information about a custom classifier.
    
    Parameters:
    
    getClassifierOptions - the GetClassifierOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Classifier
  - updateClassifier
```
public com.ibm.cloud.sdk.core.http.ServiceCall<Classifier> updateClassifier(UpdateClassifierOptions updateClassifierOptions)
```
    Update a classifier. Update a custom classifier by adding new positive or negative classes or by adding new images to existing classes. You must supply at least one set of positive or negative examples. For details, see [Updating custom classifiers] (https://cloud.ibm.com/docs/services/visual-recognition ?topic=visual-recognition-customizing#updating-custom-classifiers). Encode all names in UTF-8 if they contain non-ASCII characters (.zip and image file names, and classifier and class names). The service assumes UTF-8 encoding if it encounters non-ASCII characters. **Tip:** Don't make retraining calls on a classifier until the status is ready. When you submit retraining requests in parallel, the last request overwrites the previous requests. The retrained property shows the last time the classifier retraining finished.
    
    Parameters:
    
    updateClassifierOptions - the UpdateClassifierOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Classifier
  - deleteClassifier
```
public com.ibm.cloud.sdk.core.http.ServiceCall<java.lang.Void> deleteClassifier(DeleteClassifierOptions deleteClassifierOptions)
```
    Delete a classifier.
    
    Parameters:
    
    deleteClassifierOptions - the DeleteClassifierOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Void
  - getCoreMlModel
```
public com.ibm.cloud.sdk.core.http.ServiceCall<java.io.InputStream> getCoreMlModel(GetCoreMlModelOptions getCoreMlModelOptions)
```
    Retrieve a Core ML model of a classifier. Download a Core ML model file (.mlmodel) of a custom classifier that returns \"core_ml_enabled\": true in the classifier details.
    
    Parameters:
    
    getCoreMlModelOptions - the GetCoreMlModelOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of InputStream
  - deleteUserData
```
public com.ibm.cloud.sdk.core.http.ServiceCall<java.lang.Void> deleteUserData(DeleteUserDataOptions deleteUserDataOptions)
```
    Delete labeled data. Deletes all data associated with a specified customer ID. The method has no effect if no data is associated with the customer ID. You associate a customer ID with data by passing the `X-Watson-Metadata` header with a request that passes data. For more information about personal data and customer IDs, see [Information security](https://cloud.ibm.com/docs/services/visual-recognition?topic=visual-recognition-information-security).
    
    Parameters:
    
    deleteUserDataOptions - the DeleteUserDataOptions containing the options for the call
    
    Returns:
    
    a ServiceCall with a response type of Void

Class VisualRecognition

Field Summary

Fields inherited from class com.ibm.cloud.sdk.core.service.BaseService

Constructor Summary

Method Summary

Methods inherited from class com.ibm.cloud.sdk.core.service.BaseService

Methods inherited from class java.lang.Object

Constructor Detail

VisualRecognition

VisualRecognition

Method Detail

classify

classify

detectFaces

detectFaces

createClassifier

listClassifiers

listClassifiers

getClassifier

updateClassifier

deleteClassifier

getCoreMlModel

deleteUserData