Name: unity-sdk
Owner: International Business Machines
Description: Use only for vr-speech-sandbox-cardboard. This is not the Official Watson unity-sdk! For official sdk use: https://github.com/watson-developer-cloud/unity-sdk
Forked from: scottdangelo/unity-sdk
Created: 2017-06-02 13:53:02.0
Updated: 2018-01-22 18:48:42.0
Pushed: 2017-12-01 21:10:10.0
Size: 310297
Language: C#
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
https://github.com/IBM/vr-speech-sandbox-carboard It should only be used with the vr-speech-sandbox-cardboard project. If you are looking for the official Watson unity-sdk, you will find it here: https://github.com/watson-developer-cloud/unity-sdk
Ensure that you have the following prerequisites:
You can get the latest SDK release by clicking here.
Move the unity-sdk directory into the Assets directory of the Unity project. Rename the SDK directory from unity-sdk to Watson.
You will need the 'username' and 'password' credentials for each service. Service credentials are different from your Bluemix account username and password.
Note: The Config.json file is saved as plain text in the StreamingAssets directory. It is the user's responsibility to secure the credentials.
Use the Speech to Text service to recognize the text from a .wav file. Assign the .wav file to the script in the Unity Editor. Speech to text can also be used to convert an audio stream into text. When using the Microphone Widget and publishing to iOS, the XCode project plist must be updated with a NSMicrophoneUsageDescription or the application will crash silently.
ializeField]
ate AudioClip m_AudioClip = new AudioClip();
ate SpeechToText m_SpeechToText = new SpeechToText();
Start()
SpeechToText.Recognize(m_AudioClip, HandleOnRecognize);
HandleOnRecognize (SpeechResultList result)
(result != null && result.Results.Length > 0)
foreach( var res in result.Results )
{
foreach( var alt in res.Alternatives )
{
string text = alt.Transcript;
Debug.Log(string.Format( "{0} ({1}, {2:0.00})\n", text, res.Final ? "Final" : "Interim", alt.Confidence));
}
}
Use the Text to Speech service to get the available voices to synthesize. The Text to Speech service also supports Speech Synthesis Markup Language (SSML). In addition, the service supports a service-specific expressive SSML element. See Text To Speech service examples for examples on how to create custom Text to Speech voice models.
ToSpeech m_TextToSpeech = new TextToSpeech();
ng m_TestString = "Hello! This is Text to Speech!";
ng m_ExpressiveText = "<speak version=\"1.0\"><prosody pitch=\"150Hz\">Hello! This is the </prosody><say-as interpret-as=\"letters\">IBM</say-as> Watson <express-as type=\"GoodNews\">Unity</express-as></prosody><say-as interpret-as=\"letters\">SDK</say-as>!</speak>";
Start ()
TextToSpeech.Voice = VoiceType.en_GB_Kate;
TextToSpeech.ToSpeech(m_TestString, HandleToSpeechCallback);
TextToSpeech.Voice = VoiceType.en_US_Allison;
TextToSpeech.ToSpeech(m_ExpressiveText, HandleToSpeechCallback);
HandleToSpeechCallback (AudioClip clip)
ayClip(clip);
ate void PlayClip(AudioClip clip)
(Application.isPlaying && clip != null)
GameObject audioObject = new GameObject("AudioObject");
AudioSource source = audioObject.AddComponent<AudioSource>();
source.spatialBlend = 0.0f;
source.loop = false;
source.clip = clip;
source.Play();
GameObject.Destroy(audioObject, clip.length);
Select a domain, then identify or select the language of text, and then translate the text from one supported language to another.
Example: Ask how to get to the disco in Spanish using Language Translator service.
ate LanguageTranslator m_Translate = new LanguageTranslator();
ate string m_PhraseToTranslate = "How do I get to the disco?";
Start ()
bug.Log("English Phrase to translate: " + m_PhraseToTranslate);
Translate.GetTranslation(m_PhraseToTranslate, "en", "es", OnGetTranslation);
ate void OnGetTranslation(Translations translation)
(translation != null && translation.translations.Length > 0)
Debug.Log("Spanish Translation: " + translation.translations[0].translation);
The Dialog service was deprecated on August 15, 2016, existing instances of the service will continue to function until August 9, 2017. Users of the Dialog service should migrate their applications to use the Conversation service. See the migration documentation to learn how to migrate your dialogs to the Conversation service.
Use Natural Language Classifier service to create a classifier instance by providing a set of representative strings and a set of one or more correct classes for each as training. Then use the trained classifier to classify your new question for best matching answers or to retrieve next actions for your application.
The SDK contains a Test Natural Language Classifier, which contains classes for temperature and conditions. Before you develop a sample application in the next section, train the classifier on the test data.
ate NaturalLanguageClassifier m_NaturalLanguageClassifier = new NaturalLanguageClassifier();
ate string m_InputString = "Is it hot outside?";
ate string m_ClassifierId = <ClassifierID>;
Start ()
bug.Log("Input String: " + m_InputString);
NaturalLanguageClassifier.Classify(m_ClassifierId, m_InputString, OnClassify);
ate void OnClassify(ClassifyResult result)
(result != null)
Debug.Log("Classify Result: " + result.top_class);
You can use the Natural Language Classifier Editor to import and export classifier files, and create new classifiers and edit them.
The Tone Analyzer service detects emotions, social tendencies and writing style from text input.
Analyzer m_ToneAnalyzer = new ToneAnalyzer();
string m_StringToTestTone = "This service enables people to discover and understand, and revise the impact of tone in their content. It uses linguistic analysis to detect and interpret emotional, social, and language cues found in text.";
void Start () {
m_ToneAnalyzer.GetToneAnalyze( OnGetToneAnalyze, m_StringToTestTone, "TEST");
}
private void OnGetToneAnalyze( ToneAnalyzerResponse resp , string data)
{
Debug.Log("Response: " +resp + " - " + data);
}
The Tradeoff Analytics service helps people make better decisions when faced with multiple, sometimes conflicting, goals and alternatives.
Start () {
Problem problemToSolve = new Problem();
problemToSolve.subject = "Test Subject";
List<Column> listColumn = new List<Column>();
Column columnPrice = new Column();
columnPrice.description = "Price Column to minimize";
columnPrice.range = new ValueRange();
((ValueRange)columnPrice.range).high = 600;
((ValueRange)columnPrice.range).low = 0;
columnPrice.type = "numeric";
columnPrice.key = "price";
columnPrice.full_name = "Price";
columnPrice.goal = "min";
columnPrice.is_objective = true;
columnPrice.format = "$####0.00";
Column columnWeight = new Column();
columnWeight.description = "Weight Column to minimize";
columnWeight.type = "numeric";
columnWeight.key = "weight";
columnWeight.full_name = "Weight";
columnWeight.goal = "min";
columnWeight.is_objective = true;
columnWeight.format = "####0 g";
Column columnBrandName = new Column();
columnBrandName.description = "All Brand Names";
columnBrandName.type = "categorical";
columnBrandName.key = "brand";
columnBrandName.full_name = "Brand";
columnBrandName.goal = "max";
columnBrandName.is_objective = true;
columnBrandName.preference = new string[]{"Samsung", "Apple", "HTC"};
columnBrandName.range = new CategoricalRange();
((CategoricalRange)columnBrandName.range).keys = new string[]{"Samsung", "Apple", "HTC"};
listColumn.Add(columnPrice);
listColumn.Add(columnWeight);
problemToSolve.columns = listColumn.ToArray();
List<Option> listOption = new List<Option>();
Option option1 = new Option();
option1.key = "1";
option1.name = "Samsung Galaxy S4";
option1.values = new TestDataValue();
(option1.values as TestDataValue).weight = 130;
(option1.values as TestDataValue).brand = "Samsung";
(option1.values as TestDataValue).price = 249;
listOption.Add(option1);
Option option2 = new Option();
option2.key = "2";
option2.name = "Apple iPhone 5";
option2.values = new TestDataValue();
(option2.values as TestDataValue).weight = 112;
(option2.values as TestDataValue).brand = "Apple";
(option2.values as TestDataValue).price = 599;
listOption.Add(option2);
Option option3 = new Option();
option3.key = "3";
option3.name = "HTC One";
option3.values = new TestDataValue();
(option3.values as TestDataValue).weight = 143;
(option3.values as TestDataValue).brand = "HTC";
(option3.values as TestDataValue).price = 299;
listOption.Add(option3);
problemToSolve.options = listOption.ToArray();
m_TradeoffAnalytics.GetDilemma( OnGetDilemma, problemToSolve, false );
}
private void OnGetDilemma( DilemmasResponse resp )
{
Debug.Log("Response: " + resp);
}
/// <summary>
/// Application data value.
/// </summary>
public class TestDataValue : IBM.Watson.DeveloperCloud.Services.TradeoffAnalytics.v1.ApplicationDataValue
{
public double price { get; set; }
public double weight { get; set; }
public string brand { get; set; }
}
With the IBM Watson? Conversation service you can create cognitive agents - virtual agents that combine machine learning, natural language understanding, and integrated dialog scripting tools to provide outstanding customer engagements. A workspace should be created using Conversation tooling and a variable ConversationV1_ID should be set in the Config Editor with the Workspace ID (In the Config Editor, click Advanced Mode and click Add Variable). This is required for the service status check in the Config Editor.
ate Conversation m_Conversation = new Conversation();
ate string m_WorkspaceID = "car_demo_1";
ate string m_Input = "Can you unlock the door?";
Start () {
Debug.Log("User: " + m_Input);
m_Conversation.Message(OnMessage, m_WorkspaceID, m_Input);
OnMessage (MessageResponse resp, string customData)
oreach(Intent mi in resp.intents)
Debug.Log("intent: " + mi.intent + ", confidence: " + mi.confidence);
ebug.Log("response: " + resp.output.text);
Use the Visual Recognition service to classify an image against a default or custom trained classifier. In addition, the service can detect faces and text in an image.
You can train and delete classifiers by directly accessing low level Visual Recognition methods.
Get a list of all available classifiers
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
if(!m_VisualRecognition.GetClassifiers(OnGetClassifiers))
Log.Debug("ExampleVisualRecognition", "Getting classifiers failed!");
ate void OnGetClassifiers (GetClassifiersTopLevelBrief classifiers)
if(classifiers != null && classifiers.classifiers.Length > 0)
{
foreach(GetClassifiersPerClassifierBrief classifier in classifiers.classifiers)
{
Log.Debug("ExampleVisualRecognition", "Classifier: " + classifier.name + ", " + classifier.classifier_id);
}
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to get classifiers!");
}
Find a classifier by name
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_classifierName = <Classifier Name>;
Start()
m_VisualRecognition.FindClassifier(m_classifierName, OnFindClassifier);
ate void OnFindClassifier(GetClassifiersPerClassifierVerbose classifier)
if(classifier != null)
{
Log.Debug("ExampleVisualRecognition", "Classifier " + m_classifierName + " found! ClassifierID: " + classifier.classifier_id);
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to find classifier by name!");
}
Find a classifier by ID
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_classifierID = <Classifier ID>;
Start()
if(!m_VisualRecognition.GetClassifier(m_classifierID, OnGetClassifier))
Log.Debug("ExampleVisualRecognition", "Getting classifier failed!");
ate void OnGetClassifier(GetClassifiersPerClassifierVerbose classifier)
if(classifier != null)
{
Log.Debug("ExampleVisualRecognition", "Classifier " + m_classifierID + " found! Classifier name: " + classifier.name);
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to find classifier by ID!");
}
Train a new classifier by uploading image data. Two compressed zip files containing at least two positive example files or one positive and one negative example file. The prefix of the positive example file is used as the classname for the new classifier <Class Name>_positive_examples. Negative examples zip must be named negative_examples. After a successful call, training the classifier takes a few minutes.
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
string m_positiveExamplesPath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/<Class Name>_positive_examples.zip";
string m_negativeExamplesPath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/negative_examples.zip";
if(!m_VisualRecognition.TrainClassifier("<Classifier Name>", "<Class Name>", m_positiveExamplesPath, m_negativeExamplesPath, OnTrainClassifier))
Log.Debug("ExampleVisualRecognition", "Train classifier failed!");
ate void OnTrainClassifier(GetClassifiersPerClassifierVerbose classifier)
if(classifier != null)
{
Log.Debug("ExampleVisualRecognition", "Classifier is training! " + classifier);
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to train classifier!");
}
Update an existing classifier by adding new classes, or by adding new images to existing classes. To update the existing classifier, use several compressed .zip files, including files containing positive or negative images .jpg or .png. You must supply at least one compressed file, with additional positive or negative examples.
Compressed files containing positive examples are used to add or create classes that define the updated classifier. The prefix that you specify for each positive example parameter is used as the class name within the classifier. The _positive_examples suffix is required. There is no limit on the number of positive example files you can upload in a single call.
The compressed file containing negative examples is not used to create a class within the created classifier, but does define what the new classifier is not. Negative example files should contain images that do not depict the subject of any of the positive examples. You can only specify one negative example file in a single call.
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
string m_positiveExamplesPath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/<Class Name>_positive_examples.zip";
f(!m_VisualRecognition.UpdateClassifier(OnUpdateClassifier, "<ClassifierID>", "<Classifier Name>", "<Class Name>", m_positiveExamplesPath))
Log.Debug("ExampleVisualRecognition", "Update classifier failed!");
ate void OnUpdateClassifier(GetClassifiersPerClassifierVerbose classifier)
if(classifier != null)
{
Log.Debug("ExampleVisualRecognition", "Classifier is retraining! " + classifier);
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to update classifier!");
}
Delete a classifier by Classifier ID
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_classifierToDelete = "<Classifier ID>";
Start()
if(!m_VisualRecognition.DeleteClassifier(m_classifierToDelete, OnDeleteClassifier))
Log.Debug("ExampleVisualRecognition", "Deleting classifier failed!");
ate void OnDeleteClassifier(bool success)
if(success)
{
Log.Debug("ExampleVisualRecognition", "Deleted classifier " + m_classifierToDelete);
}
else
{
Log.Debug("ExampleVisualRecognition", "Failed to delete classifier by ID!");
}
You can classify an image via URL or by posting an image. You may also define multiple owners and classifiers to classify against in the call. Supported filetypes are .gif, .jpg, .png or .zip.
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_imageURL = "https://upload.wikimedia.org/wikipedia/commons/e/e9/Official_portrait_of_Barack_Obama.jpg";
Start()
if(!m_VisualRecognition.Classify(m_imageURL, OnClassify))
Log.Debug("ExampleVisualRecognition", "Classify image failed!");
ate void OnClassify(ClassifyTopLevelMultiple classify)
if(classify != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: " + classify.images_processed);
foreach(ClassifyTopLevelSingle image in classify.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: " + image.source_url + ", resolved_url: " + image.resolved_url);
foreach(ClassifyPerClassifier classifier in image.classifiers)
{
Log.Debug("ExampleVisualRecognition", "\t\tclassifier_id: " + classifier.classifier_id + ", name: " + classifier.name);
foreach(ClassResult classResult in classifier.classes)
Log.Debug("ExampleVisualRecognition", "\t\t\tclass: " + classResult.m_class + ", score: " + classResult.score + ", type_hierarchy: " + classResult.type_hierarchy);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "Classification failed!");
}
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
string m_imagesPath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/obama.jpg";
string[] m_owners = {"IBM", "me"};
string[] m_classifierIDs = {"default"};
if(!m_VisualRecognition.Classify(OnClassify, m_imagesPath, m_owners, m_classifierIDs, 0.5f))
Log.Debug("ExampleVisualRecognition", "Classify image failed!");
ate void OnClassify(ClassifyTopLevelMultiple classify)
if(classify != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: " + classify.images_processed);
foreach(ClassifyTopLevelSingle image in classify.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: " + image.source_url + ", resolved_url: " + image.resolved_url);
foreach(ClassifyPerClassifier classifier in image.classifiers)
{
Log.Debug("ExampleVisualRecognition", "\t\tclassifier_id: " + classifier.classifier_id + ", name: " + classifier.name);
foreach(ClassResult classResult in classifier.classes)
Log.Debug("ExampleVisualRecognition", "\t\t\tclass: " + classResult.m_class + ", score: " + classResult.score + ", type_hierarchy: " + classResult.type_hierarchy);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "Classification failed!");
}
You can detect faces via URL or by posting an image. Supported filetypes are .gif, .jpg, .png or .zip.
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_imageURL = "https://upload.wikimedia.org/wikipedia/commons/e/e9/Official_portrait_of_Barack_Obama.jpg";
Start()
if(!m_VisualRecognition.DetectFaces(m_imageURL, OnDetectFaces))
Log.Debug("ExampleVisualRecognition", "Detect faces failed!");
ate void OnDetectFaces(FacesTopLevelMultiple multipleImages)
if(multipleImages != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: {0}", multipleImages.images_processed);
foreach(FacesTopLevelSingle faces in multipleImages.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: {0}, resolved_url: {1}", faces.source_url, faces.resolved_url);
foreach(OneFaceResult face in faces.faces)
{
Log.Debug("ExampleVisualRecognition", "\t\tFace location: {0}, {1}, {2}, {3}", face.face_location.left, face.face_location.top, face.face_location.width, face.face_location.height);
Log.Debug("ExampleVisualRecognition", "\t\tGender: {0}, Score: {1}", face.gender.gender, face.gender.score);
Log.Debug("ExampleVisualRecognition", "\t\tAge Min: {0}, Age Max: {1}, Score: {2}", face.age.min, face.age.max, face.age.score);
Log.Debug("ExampleVisualRecognition", "\t\tName: {0}, Score: {1}, Type Hierarchy: {2}", face.identity.name, face.identity.score, face.identity.type_hierarchy);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "Detect faces failed!");
}
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
string m_faceExamplePath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/obama.jpg";
if(!m_VisualRecognition.DetectFaces(OnDetectFaces, m_faceExamplePath))
Log.Debug("ExampleVisualRecognition", "Detect faces failed!");
ate void OnDetectFaces(FacesTopLevelMultiple multipleImages)
if(multipleImages != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: {0}", multipleImages.images_processed);
foreach(FacesTopLevelSingle faces in multipleImages.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: {0}, resolved_url: {1}", faces.source_url, faces.resolved_url);
foreach(OneFaceResult face in faces.faces)
{
Log.Debug("ExampleVisualRecognition", "\t\tFace location: {0}, {1}, {2}, {3}", face.face_location.left, face.face_location.top, face.face_location.width, face.face_location.height);
Log.Debug("ExampleVisualRecognition", "\t\tGender: {0}, Score: {1}", face.gender.gender, face.gender.score);
Log.Debug("ExampleVisualRecognition", "\t\tAge Min: {0}, Age Max: {1}, Score: {2}", face.age.min, face.age.max, face.age.score);
Log.Debug("ExampleVisualRecognition", "\t\tName: {0}, Score: {1}, Type Hierarchy: {2}", face.identity.name, face.identity.score, face.identity.type_hierarchy);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "Detect faces failed!");
}
You can recognize text via URL or by posting an image. Supported filetypes are .gif, .jpg, .png or .zip.
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
ate string m_imageTextURL = "http://i.stack.imgur.com/ZS6nH.png";
Start()
if(!m_VisualRecognition.RecognizeText(m_imageTextURL, OnRecognizeText))
Log.Debug("ExampleVisualRecognition", "Recognize text failed!");
ate void OnRecognizeText(TextRecogTopLevelMultiple multipleImages)
if(multipleImages != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: {0}", multipleImages.images_processed);
foreach(TextRecogTopLevelSingle texts in multipleImages.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: {0}, resolved_url: {1}", texts.source_url, texts.resolved_url);
Log.Debug("ExampleVisualRecognition", "\ttext: {0}", texts.text);
foreach(TextRecogOneWord text in texts.words)
{
Log.Debug("ExampleVisualRecognition", "\t\ttext location: {0}, {1}, {2}, {3}", text.location.left, text.location.top, text.location.width, text.location.height);
Log.Debug("ExampleVisualRecognition", "\t\tLine number: {0}", text.line_number);
Log.Debug("ExampleVisualRecognition", "\t\tword: {0}, Score: {1}", text.word, text.score);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "RecognizeText failed!");
}
ate VisualRecognition m_VisualRecognition = new VisualRecognition();
Start()
string m_textExamplePath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/from_platos_apology.png";
if(!m_VisualRecognition.RecognizeText(OnRecognizeText, m_textExamplePath))
Log.Debug("ExampleVisualRecognition", "Recognize text failed!");
ate void OnRecognizeText(TextRecogTopLevelMultiple multipleImages)
if(multipleImages != null)
{
Log.Debug("ExampleVisualRecognition", "images processed: {0}", multipleImages.images_processed);
foreach(TextRecogTopLevelSingle texts in multipleImages.images)
{
Log.Debug("ExampleVisualRecognition", "\tsource_url: {0}, resolved_url: {1}", texts.source_url, texts.resolved_url);
Log.Debug("ExampleVisualRecognition", "\ttext: {0}", texts.text);
foreach(TextRecogOneWord text in texts.words)
{
Log.Debug("ExampleVisualRecognition", "\t\ttext location: {0}, {1}, {2}, {3}", text.location.left, text.location.top, text.location.width, text.location.height);
Log.Debug("ExampleVisualRecognition", "\t\tLine number: {0}", text.line_number);
Log.Debug("ExampleVisualRecognition", "\t\tword: {0}, Score: {1}", text.word, text.score);
}
}
}
else
{
Log.Debug("ExampleVisualRecognition", "RecognizeText failed!");
}
Beta. You can create and add images to a collection and then search that collection with your own image to find similar images.
Beta. List all custom collections.
Start()
VisualRecognition.GetCollections(OnGetCollections);
ate void OnGetCollections(GetCollections collections, string customData)
(collections != null)
foreach (CreateCollection collection in collections.collections)
{
Log.Debug("VisualRecognitionExample", "collectionID: {0} | collection name: {1} | number of images: {2}", collection.collection_id, collection.name, collection.images);
}
se
Log.Debug("VisualRecognitionExample", "Get Collections failed!");
Beta. Create a new collection of images to search. You can create a maximum of 5 collections.
Start()
VisualRecognition.CreateCollection(OnCreateCollection, "unity-integration-test-collection");
ate void OnCreateCollection(CreateCollection collection, string customData)
(collection != null)
Log.Debug("VisualRecognitionExample", "Create Collection succeeded!");
Log.Debug("VisualRecognitionExample", "collectionID: {0} | collection name: {1} | collection images: {2}", collection.collection_id, collection.name, collection.images);
se
Log.Debug("VisualRecognitionExample", "Create Collection failed!");
Beta. Retrieve information about a specific collection.
Start()
VisualRecognition.GetCollection(OnGetCollection, m_CreatedCollectionID);
ate void OnGetCollection(CreateCollection collection, string customData)
(collection != null)
Log.Debug("VisualRecognitionExample", "Get Collection succeded!");
Log.Debug("VisualRecognitionExample", "collectionID: {0} | collection name: {1} | collection images: {2}", collection.collection_id, collection.name, collection.images);
se
Log.Debug("VisualRecognitionExample", "Get Collection failed!");
Beta. Add images to a collection. Each collection can contain 1000000 images.
Start()
ring m_collectionImagePath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/visual-recognition-classifiers/giraffe_to_classify.jpg";
ctionary<string, string> imageMetadata = new Dictionary<string, string>();
ageMetadata.Add("key1", "value1");
ageMetadata.Add("key2", "value2");
ageMetadata.Add("key3", "value3");
VisualRecognition.AddCollectionImage(OnAddImageToCollection, m_CreatedCollectionID, m_collectionImagePath, imageMetadata);
ate void OnAddImageToCollection(CollectionsConfig images, string customData)
(images != null)
Log.Debug("VisualRecognitionExample", "Add image to collection succeeded!");
m_CreatedCollectionImage = images.images[0].image_id;
Log.Debug("VisualRecognitionExample", "images processed: {0}", images.images_processed);
foreach (CollectionImagesConfig image in images.images)
Log.Debug("VisualRecognitionExample", "imageID: {0} | image_file: {1} | image metadata: {1}", image.image_id, image.image_file, image.metadata.ToString());
se
Log.Debug("VisualRecognitionExample", "Add image to collection failed!");
Beta. List the first 100 images in a collection. Each collection can contain 1000000 images.
Start()
VisualRecognition.GetCollectionImages(OnGetCollectionImages, m_CreatedCollectionID);
ate void OnGetCollectionImages(GetCollectionImages collections, string customData)
(collections != null)
Log.Debug("VisualRecognitionExample", "Get Collections succeded!");
foreach(GetCollectionsBrief collection in collections.images)
Log.Debug("VisualRecognitionExample", "imageID: {0} | image file: {1} | image metadataOnGetCollections: {2}", collection.image_id, collection.image_file, collection.metadata.ToString());
se
Log.Debug("VisualRecognitionExample", "Get Collections failed!");
Beta. List details about a specific image in a collection.
Start()
VisualRecognition.GetImage(OnGetImage, m_CreatedCollectionID, m_CreatedCollectionImage);
ate void OnGetImage(GetCollectionsBrief image, string customData)
(image != null)
Log.Debug("VisualRecognitionExample", "GetImage succeeded!");
Log.Debug("VisualRecognitionExample", "imageID: {0} | created: {1} | image_file: {2} | metadata: {3}", image.image_id, image.created, image.image_file, image.metadata);
se
Log.Debug("VisualRecognitionExample", "GetImage failed!");
Beta. View the metadata for a specific image in a collection.
Start()
VisualRecognition.GetMetadata(OnGetMetadata, m_CreatedCollectionID, m_CreatedCollectionImage);
ate void OnGetMetadata(object responseObject, string customData)
(responseObject != null)
Log.Debug("VisualRecognitionExample", "ResponseObject: {0}", responseObject);
Beta. Upload an image to find similar images in your custom collection.
Start()
VisualRecognition.FindSimilar(OnFindSimilar, m_CreatedCollectionID, m_collectionImagePath);
ate void OnFindSimilar(SimilarImagesConfig images, string customData)
(images != null)
Log.Debug("VisualRecognitionExample", "GetSimilar succeeded!");
Log.Debug("VisualRecognitionExample", "images processed: {0}", images.images_processed);
foreach (SimilarImageConfig image in images.similar_images)
Log.Debug("VisualRecognitionExample", "image ID: {0} | image file: {1} | score: {2} | metadata: {3}", image.image_id, image.image_file, image.score, image.metadata.ToString());
se
Log.Debug("VisualRecognitionExample", "GetSimilar failed!");
Beta. Delete all metadata associated with an image.
Start()
VisualRecognition.DeleteCollectionImageMetadata(OnDeleteMetadata, m_CreatedCollectionID, m_CreatedCollectionImage);
ate void OnDeleteMetadata(bool success, string customData)
(success)
Log.Debug("VisualRecognitionExample", "Delete image metadata succeeded!");
se
Log.Debug("VisualRecognitionExample", "Delete image metadata failed!");
Beta. Delete an image from a collection.
Start()
VisualRecognition.DeleteCollectionImage(OnDeleteCollectionImage, m_CreatedCollectionID, m_CreatedCollectionImage);
ate void OnDeleteCollectionImage(bool success, string customData)
(success)
Log.Debug("VisualRecognitionExample", "Delete collection image succeeded!");
se
Log.Debug("VisualRecognitionExample", "Delete collection image failed!");
Beta. Delete a user created collection.
Start()
VisualRecognition.DeleteCollection(OnDeleteCollection, m_CreatedCollectionID);
ate void OnDeleteCollection(bool success, string customData)
(success)
Log.Debug("VisualRecognitionExample", "Delete Collection succeeded!");
se
Log.Debug("VisualRecognitionExample", "Delete Collection failed!");
Use the Alchemy Language service to extract semantic meta-data from content such as information on people, places, companies, topics, facts, relationships, authors and languages.
You can extract Authors from a URL or HTML source.
Start()
if(!m_AlchemyLanguage.GetAuthors(OnGetAuthors, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get authors URL POST!");
ate void OnGetAuthors(AuthorsData authors, string data)
if(authors != null)
{
Log.Debug("ExampleAlchemyLanguage", "data: {0}", data);
if(authors.authors.names.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No authors found!");
foreach(string name in authors.authors.names)
Log.Debug("ExampleAlchemyLanguage", "Author " + name + " found!");
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Author!");
}
You can get Concepts from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetRankedConcepts(OnGetConcepts, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get concepts HTML POST!");
ate void OnGetConcepts(ConceptsData concepts, string data)
if(concepts != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", concepts.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", concepts.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", concepts.language);
if(concepts.concepts.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No concepts found!");
foreach(Concept concept in concepts.concepts)
Log.Debug("ExampleAlchemyLanguage", "Concept: {0}, Relevance: {1}", concept.text, concept.relevance);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Concepts!");
}
You can extract Dates from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetDates(OnGetDates, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get dates by URL POST");
ate void OnGetDates(DateData dates, string data)
if(dates != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", dates.status);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", dates.language);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", dates.url);
if(dates.dates == null || dates.dates.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No dates found!");
else
foreach(Date date in dates.dates)
Log.Debug("ExampleAlchemyLanguage", "Text: {0}, Date: {1}", date.text, date.date);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Dates!");
}
You can get Emotions from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetEmotions(OnGetEmotions, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get emotions by URL POST");
ate void OnGetEmotions(EmotionData emotions, string data)
if(emotions != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", emotions.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", emotions.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", emotions.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", emotions.text);
if(emotions.docEmotions == null)
Log.Debug("ExampleAlchemyLanguage", "No emotions found!");
else
{
Log.Debug("ExampleAlchemyLanguage", "anger: {0}", emotions.docEmotions.anger);
Log.Debug("ExampleAlchemyLanguage", "disgust: {0}", emotions.docEmotions.disgust);
Log.Debug("ExampleAlchemyLanguage", "fear: {0}", emotions.docEmotions.fear);
Log.Debug("ExampleAlchemyLanguage", "joy: {0}", emotions.docEmotions.joy);
Log.Debug("ExampleAlchemyLanguage", "sadness: {0}", emotions.docEmotions.sadness);
}
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Emotions!");
}
You can extract Entities from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.ExtractEntities(OnExtractEntities, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get entities by URL POST");
ate void OnExtractEntities(EntityData entityData, string data)
if(entityData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", entityData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", entityData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", entityData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", entityData.text);
if(entityData == null || entityData.entities.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No entities found!");
else
foreach(Entity entity in entityData.entities)
Log.Debug("ExampleAlchemyLanguage", "text: {0}, type: {1}", entity.text, entity.type);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Emotions!");
}
You can detect RSS Feeds from a URL source.
Start()
if(!m_AlchemyLanguage.DetectFeeds(OnDetectFeeds, "http://time.com/newsfeed/"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get feeds by URL POST");
ate void OnDetectFeeds(FeedData feedData, string data)
if(feedData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", feedData.status);
if(feedData == null || feedData.feeds.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No feeds found!");
else
foreach(Feed feed in feedData.feeds)
Log.Debug("ExampleAlchemyLanguage", "text: {0}", feed.feed);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Feeds!");
}
You can extract Keywords form a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.ExtractKeywords(OnExtractKeywords, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get keywords by URL POST");
ate void OnExtractKeywords(KeywordData keywordData, string data)
if(keywordData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", keywordData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", keywordData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", keywordData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", keywordData.text);
if(keywordData == null || keywordData.keywords.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No keywords found!");
else
foreach(Keyword keyword in keywordData.keywords)
Log.Debug("ExampleAlchemyLanguage", "text: {0}, relevance: {1}", keyword.text, keyword.relevance);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Keywords!");
}
You can extract the language of a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetLanguages(OnGetLanguages, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get languages by text POST");
ate void OnGetLanguages(LanguageData languages, string data)
if(languages != null)
{
if(string.IsNullOrEmpty(languages.language))
Log.Debug("ExampleAlchemyLanguage", "No languages detected!");
else
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", languages.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", languages.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", languages.language);
Log.Debug("ExampleAlchemyLanguage", "ethnologue: {0}", languages.ethnologue);
Log.Debug("ExampleAlchemyLanguage", "iso_639_1: {0}", languages.iso_639_1);
Log.Debug("ExampleAlchemyLanguage", "iso_639_2: {0}", languages.iso_639_2);
Log.Debug("ExampleAlchemyLanguage", "iso_639_3: {0}", languages.iso_639_3);
Log.Debug("ExampleAlchemyLanguage", "native_speakers: {0}", languages.native_speakers);
Log.Debug("ExampleAlchemyLanguage", "wikipedia: {0}", languages.wikipedia);
}
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Dates!");
}
You can get the Microformat of a URL source.
Start()
if(!m_AlchemyLanguage.GetMicroformats(OnGetMicroformats, "http://microformats.org/wiki/hcard"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get microformats by text POST");
ate void OnGetMicroformats(MicroformatData microformats, string data)
if(microformats != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", microformats.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", microformats.url);
if(microformats.microformats.Length == 0)
Log.Warning("ExampleAlchemyLanguage", "No microformats found!");
else
{
foreach(Microformat microformat in microformats.microformats)
Log.Debug("ExampleAlchemyLanguage", "field: {0}, data: {1}.", microformat.field, microformat.data);
}
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Microformats!");
}
You can extract the publication date from a URL or HTML source.
Start()
if(!m_AlchemyLanguage.GetPublicationDate(OnGetPublicationDate, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get publication dates by url POST");
ate void OnGetPublicationDate(PubDateData pubDates, string data)
if(pubDates != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", pubDates.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", pubDates.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", pubDates.language);
if(pubDates.publicationDate != null)
Log.Debug("ExampleAlchemyLanguage", "date: {0}, confident: {1}", pubDates.publicationDate.date, pubDates.publicationDate.confident);
else
Log.Debug("ExampleAlchemyLanguage", "Failed to find Publication Dates!");
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Publication Dates!");
}
You can extract Relations from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetRelations(OnGetRelations, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get relations by text POST");
ate void OnGetRelations(RelationsData relationsData, string data)
if(relationsData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", relationsData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", relationsData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", relationsData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", relationsData.text);
if(relationsData.relations == null || relationsData.relations.Length == 0)
Log.Debug("ExampleAlchemyLanguage", "No relations found!");
else
foreach(Relation relation in relationsData.relations)
if(relation.subject != null && !string.IsNullOrEmpty(relation.subject.text))
Log.Debug("ExampleAlchemyLanguage", "Text: {0}, Date: {1}", relation.sentence, relation.subject.text);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Relations!");
}
You can extract the Sentiment from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetTextSentiment(OnGetTextSentiment, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get sentiment by text POST");
ate void OnGetTextSentiment(SentimentData sentimentData, string data)
if(sentimentData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", sentimentData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", sentimentData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", sentimentData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", sentimentData.text);
if(sentimentData.docSentiment == null)
Log.Debug("ExampleAlchemyLanguage", "No sentiment found!");
else
if(sentimentData.docSentiment != null && !string.IsNullOrEmpty(sentimentData.docSentiment.type))
Log.Debug("ExampleAlchemyLanguage", "Sentiment: {0}, Score: {1}", sentimentData.docSentiment.type, sentimentData.docSentiment.score);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Relations!");
}
You can extract a Targeted Sentiment from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetTargetedSentiment(OnGetTargetedSentiment, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html", "Jeopardy|Jennings|Watson"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get targeted sentiment by text POST");
ate void OnGetTargetedSentiment(TargetedSentimentData sentimentData, string data)
if(sentimentData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", sentimentData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", sentimentData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", sentimentData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", sentimentData.text);
if(sentimentData.results == null)
Log.Debug("ExampleAlchemyLanguage", "No sentiment found!");
else
if(sentimentData.results == null || sentimentData.results.Length == 0)
Log.Warning("ExampleAlchemyLanguage", "No sentiment results!");
else
foreach(TargetedSentiment result in sentimentData.results)
Log.Debug("ExampleAlchemyLanguage", "text: {0}, sentiment: {1}, score: {2}", result.text, result.sentiment.score, result.sentiment.type);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Relations!");
}
You can get the Taxonomy of entities from a URL, HTML or Text source.
Start()
if(!m_AlchemyLanguage.GetRankedTaxonomy(OnGetRankedTaxonomy, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get ranked taxonomy by text POST");
ate void OnGetRankedTaxonomy(TaxonomyData taxonomyData, string data)
if(taxonomyData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", taxonomyData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", taxonomyData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", taxonomyData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", taxonomyData.text);
if(taxonomyData.taxonomy == null)
Log.Debug("ExampleAlchemyLanguage", "No taxonomy found!");
else
if(taxonomyData.taxonomy == null || taxonomyData.taxonomy.Length == 0)
Log.Warning("ExampleAlchemyLanguage", "No taxonomy results!");
else
foreach(Taxonomy taxonomy in taxonomyData.taxonomy)
Log.Debug("ExampleAlchemyLanguage", "label: {0}, score: {1}", taxonomy.label, taxonomy.score);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find Relations!");
}
You can exctract the Text from a URL or HTML source.
Start()
if(!m_AlchemyLanguage.GetText(OnGetText, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get text by text POST");
ate void OnGetText(TextData textData, string data)
if(textData != null)
{
Log.Debug("ExampleAlchemyLanuguage", "status: {0}", textData.status);
Log.Debug("ExampleAlchemyLanuguage", "url: {0}", textData.url);
Log.Debug("ExampleAlchemyLanuguage", "text: {0}", textData.text);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find text!");
}
You can exctract the Raw Text from a URL or HTML source.
Start()
if(!m_AlchemyLanguage.GetRawText(OnGetText, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get raw text by text POST");
ate void OnGetText(TextData textData, string data)
if(textData != null)
{
Log.Debug("ExampleAlchemyLanuguage", "status: {0}", textData.status);
Log.Debug("ExampleAlchemyLanuguage", "url: {0}", textData.url);
Log.Debug("ExampleAlchemyLanuguage", "text: {0}", textData.text);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find text!");
}
You can extract the Title form a URL or HTML source.
Start()
if(!m_AlchemyLanguage.GetTitle(OnGetTitle, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get title by text POST");
ate void OnGetTitle(Title titleData, string data)
if(titleData != null)
{
Log.Debug("ExampleAlchemyLanuguage", "status: {0}", titleData.status);
Log.Debug("ExampleAlchemyLanuguage", "url: {0}", titleData.url);
Log.Debug("ExampleAlchemyLanuguage", "text: {0}", titleData.title);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to find title!");
}
You can combine multiple requests into one call using a Combined Data call from a URL, HTML or Text source. Allowed services in Combined Call are authors, concepts, dates, doc-emotion, entities, feeds, keywords, pub-dates, releations, doc-sentiment, taxonomy, title, page-image and image-keywords.
Start()
if(!m_AlchemyLanguage.GetCombinedData(OnGetCombinedData, "http://www.nytimes.com/2011/02/17/science/17jeopardy-watson.html"))
Log.Debug("ExampleAlchemyLanguage", "Failed to get combined data by text POST");
ate void OnGetCombinedData(CombinedCallData combinedData, string data)
if(combinedData != null)
{
Log.Debug("ExampleAlchemyLanguage", "status: {0}", combinedData.status);
Log.Debug("ExampleAlchemyLanguage", "url: {0}", combinedData.url);
Log.Debug("ExampleAlchemyLanguage", "language: {0}", combinedData.language);
Log.Debug("ExampleAlchemyLanguage", "text: {0}", combinedData.text);
Log.Debug("ExampleAlchemyLanguage", "image: {0}", combinedData.image);
if(combinedData.imageKeywords != null && combinedData.imageKeywords.Length > 0)
foreach(ImageKeyword imageKeyword in combinedData.imageKeywords)
Log.Debug("ExampleAlchemyLanguage", "ImageKeyword: {0}, Score: {1}", imageKeyword.text, imageKeyword.score);
if(combinedData.publicationDate != null)
Log.Debug("ExampleAlchemyLanguage", "publicationDate: {0}, Score: {1}", combinedData.publicationDate.date, combinedData.publicationDate.confident);
if(combinedData.authors != null && combinedData.authors.names.Length > 0)
foreach(string authors in combinedData.authors.names)
Log.Debug("ExampleAlchemyLanguage", "Authors: {0}", authors);
if(combinedData.docSentiment != null)
Log.Debug("ExampleAlchemyLanguage", "DocSentiment: {0}, Score: {1}, Mixed: {2}", combinedData.docSentiment.type, combinedData.docSentiment.score, combinedData.docSentiment.mixed);
if(combinedData.feeds != null && combinedData.feeds.Length > 0)
foreach(Feed feed in combinedData.feeds)
Log.Debug("ExampleAlchemyLanguage", "Feeds: {0}", feed.feed);
if(combinedData.keywords != null && combinedData.keywords.Length > 0)
foreach(Keyword keyword in combinedData.keywords)
Log.Debug("ExampleAlchemyLanguage", "Keyword: {0}, relevance: {1}", keyword.text, keyword.relevance);
if(combinedData.concepts != null && combinedData.concepts.Length > 0)
foreach(Concept concept in combinedData.concepts)
Log.Debug("ExampleAlchemyLanguage", "Concept: {0}, Relevance: {1}", concept.text, concept.relevance);
if(combinedData.entities != null && combinedData.entities.Length > 0)
foreach(Entity entity in combinedData.entities)
Log.Debug("ExampleAlchemyLanguage", "Entity: {0}, Type: {1}, Relevance: {2}", entity.text, entity.type, entity.relevance);
if(combinedData.relations != null && combinedData.relations.Length > 0)
foreach(Relation relation in combinedData.relations)
Log.Debug("ExampleAlchemyLanguage", "Relations: {0}", relation.subject.text);
if(combinedData.taxonomy != null && combinedData.taxonomy.Length > 0)
foreach(Taxonomy taxonomy in combinedData.taxonomy)
Log.Debug("ExampleAlchemyLanguage", "Taxonomy: {0}, Score: {1}, Confident: {2}" ,taxonomy.label, taxonomy.score, taxonomy.confident);
if(combinedData.dates != null && combinedData.dates.Length > 0)
foreach(Date date in combinedData.dates)
Log.Debug("ExampleAlchemyLanguage", "Dates", date.text, date.date);
if(combinedData.docEmotions != null && combinedData.docEmotions.Length > 0)
foreach(DocEmotions emotions in combinedData.docEmotions)
Log.Debug("ExampleAlchemyLanguage", "Doc Emotions: anger: {0}, disgust: {1}, fear: {2}, joy: {3}, sadness: {4}", emotions.anger, emotions.disgust, emotions.fear, emotions.joy, emotions.sadness);
}
else
{
Log.Debug("ExampleAlchemyLanguage", "Failed to get combined data!");
}
The IBM Watson? Personality Insights service provides a Representational State Transfer (REST) Application Programming Interface (API) that enables applications to derive insights from social media, enterprise data, or other digital communications. The service uses linguistic analytics to infer individuals' intrinsic personality characteristics, including Big Five, Needs, and Values, from digital communications such as email, text messages, tweets, and forum posts. The service can automatically infer, from potentially noisy social media, portraits of individuals that reflect their personality characteristics. The service can report consumption preferences based on the results of its analysis, and for JSON content that is timestamped, it can report temporal behavior.
onalityInsights m_personalityInsights = new PersonalityInsights();
private string testString = "<text-here>"";
ivate string dataPath;
void Start () {
LogSystem.InstallDefaultReactors();
dataPath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/personalityInsights.json";
if(!m_personalityInsights.GetProfile(OnGetProfileJson, dataPath, ContentType.TEXT_HTML, ContentLanguage.ENGLISH, ContentType.APPLICATION_JSON, AcceptLanguage.ENGLISH, true, true, true))
Log.Debug("ExamplePersonalityInsights", "Failed to get profile!");
if (!m_personalityInsights.GetProfile(OnGetProfileText, testString, ContentType.TEXT_HTML, ContentLanguage.ENGLISH, ContentType.APPLICATION_JSON, AcceptLanguage.ENGLISH, true, true, true))
Log.Debug("ExamplePersonalityInsights", "Failed to get profile!");
}
private void OnGetProfileText(Profile profile, string data)
{
if (profile != null)
{
if (!string.IsNullOrEmpty(profile.processed_language))
Log.Debug("TestPersonalityInsightsV3", "processed_language: {0}", profile.processed_language);
Log.Debug("TestPersonalityInsightsV3", "word_count: {0}", profile.word_count);
if (!string.IsNullOrEmpty(profile.word_count_message))
Log.Debug("TestPersonalityInsightsV3", "word_count_message: {0}", profile.word_count_message);
if (profile.personality != null && profile.personality.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Personality trait tree");
foreach (TraitTreeNode node in profile.personality)
LogTraitTree(node);
}
if (profile.values != null && profile.values.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Values trait tree");
foreach (TraitTreeNode node in profile.values)
LogTraitTree(node);
}
if (profile.needs != null && profile.personality.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Needs trait tree");
foreach (TraitTreeNode node in profile.needs)
LogTraitTree(node);
}
if (profile.behavior != null && profile.behavior.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Behavior tree");
foreach (BehaviorNode behavior in profile.behavior)
{
Log.Debug("TestPersonalityInsightsV3", "trait_id: {0}", behavior.trait_id);
Log.Debug("TestPersonalityInsightsV3", "name: {0}", behavior.name);
Log.Debug("TestPersonalityInsightsV3", "category: {0}", behavior.category);
Log.Debug("TestPersonalityInsightsV3", "percentage: {0}", behavior.percentage.ToString());
Log.Debug("TestPersonalityInsightsV3", "----------------");
}
}
if (profile.consumption_preferences != null && profile.consumption_preferences.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "ConsumptionPreferencesCategories");
foreach (ConsumptionPreferencesCategoryNode categoryNode in profile.consumption_preferences)
LogConsumptionPreferencesCategory(categoryNode);
}
}
}
private void OnGetProfileJson(Profile profile, string data)
{
if (profile != null)
{
if (!string.IsNullOrEmpty(profile.processed_language))
Log.Debug("TestPersonalityInsightsV3", "processed_language: {0}", profile.processed_language);
Log.Debug("TestPersonalityInsightsV3", "word_count: {0}", profile.word_count);
if (!string.IsNullOrEmpty(profile.word_count_message))
Log.Debug("TestPersonalityInsightsV3", "word_count_message: {0}", profile.word_count_message);
if (profile.personality != null && profile.personality.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Personality trait tree");
foreach (TraitTreeNode node in profile.personality)
LogTraitTree(node);
}
if (profile.values != null && profile.values.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Values trait tree");
foreach (TraitTreeNode node in profile.values)
LogTraitTree(node);
}
if (profile.needs != null && profile.personality.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Needs trait tree");
foreach (TraitTreeNode node in profile.needs)
LogTraitTree(node);
}
if (profile.behavior != null && profile.behavior.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "Behavior tree");
foreach (BehaviorNode behavior in profile.behavior)
{
Log.Debug("TestPersonalityInsightsV3", "trait_id: {0}", behavior.trait_id);
Log.Debug("TestPersonalityInsightsV3", "name: {0}", behavior.name);
Log.Debug("TestPersonalityInsightsV3", "category: {0}", behavior.category);
Log.Debug("TestPersonalityInsightsV3", "percentage: {0}", behavior.percentage.ToString());
Log.Debug("TestPersonalityInsightsV3", "----------------");
}
}
if (profile.consumption_preferences != null && profile.consumption_preferences.Length > 0)
{
Log.Debug("TestPersonalityInsightsV3", "ConsumptionPreferencesCategories");
foreach (ConsumptionPreferencesCategoryNode categoryNode in profile.consumption_preferences)
LogConsumptionPreferencesCategory(categoryNode);
}
}
}
private void LogTraitTree(TraitTreeNode traitTreeNode)
{
Log.Debug("TestPersonalityInsightsV3", "trait_id: {0} | name: {1} | category: {2} | percentile: {3} | raw_score: {4}",
string.IsNullOrEmpty(traitTreeNode.trait_id) ? "null" : traitTreeNode.trait_id,
string.IsNullOrEmpty(traitTreeNode.name) ? "null" : traitTreeNode.name,
string.IsNullOrEmpty(traitTreeNode.category) ? "null" : traitTreeNode.category,
string.IsNullOrEmpty(traitTreeNode.percentile.ToString()) ? "null" : traitTreeNode.percentile.ToString(),
string.IsNullOrEmpty(traitTreeNode.raw_score.ToString()) ? "null" : traitTreeNode.raw_score.ToString());
if (traitTreeNode.children != null && traitTreeNode.children.Length > 0)
foreach (TraitTreeNode childNode in traitTreeNode.children)
LogTraitTree(childNode);
}
private void LogConsumptionPreferencesCategory(ConsumptionPreferencesCategoryNode categoryNode)
{
Log.Debug("TestPersonalityInsightsV3", "consumption_preference_category_id: {0} | name: {1}", categoryNode.consumption_preference_category_id, categoryNode.name);
foreach (ConsumptionPreferencesNode preferencesNode in categoryNode.consumption_preferences)
Log.Debug("TestPersonalityInsightsV3", "\t consumption_preference_id: {0} | name: {1} | score: {2}",
string.IsNullOrEmpty(preferencesNode.consumption_preference_id) ? "null" : preferencesNode.consumption_preference_id,
string.IsNullOrEmpty(preferencesNode.name) ? "null" : preferencesNode.name,
string.IsNullOrEmpty(preferencesNode.score.ToString()) ? "null" : preferencesNode.score.ToString());
}
The IBM Watson? Document conversion service converts a single HTML, PDF, or Microsoft Word? document into a normalized HTML, plain text, or a set of JSON-formatted Answer units that can be used with other Watson services. Carefully inspect output to make sure that it contains all elements and metadata required by the security standards of you or your organization.
Convert a single document
ate DocumentConversion m_DocumentConversion = new DocumentConversion();
void Start ()
{
LogSystem.InstallDefaultReactors(); LogSystem.InstallDefaultReactors();
string examplePath = Application.dataPath + "/Watson/Examples/ServiceExamples/TestData/watson_beats_jeopardy.html";
if (!m_DocumentConversion.ConvertDocument(OnConvertDocument, examplePath, ConversionTarget.NORMALIZED_TEXT))
Log.Debug("ExampleDocumentConversion", "Document conversion failed!");
}
private void OnConvertDocument(ConvertedDocument documentConversionResponse, string data)
{
if (documentConversionResponse != null)
{
if(!string.IsNullOrEmpty(documentConversionResponse.media_type_detected))
Log.Debug("ExampleDocumentConversion", "mediaTypeDetected: {0}", documentConversionResponse.media_type_detected);
if (!string.IsNullOrEmpty(documentConversionResponse.source_document_id))
Log.Debug("ExampleDocumentConversion", "mediaTypeDetected: {0}", documentConversionResponse.source_document_id);
if(!string.IsNullOrEmpty(documentConversionResponse.timestamp))
Log.Debug("ExampleDocumentConversion", "mediaTypeDetected: {0}", documentConversionResponse.timestamp);
if (documentConversionResponse.metadata != null && documentConversionResponse.metadata.Length > 0)
{
Log.Debug("ExampleDocumentConversion", "mediaTypeDetected: {0}", documentConversionResponse.metadata.Length);
foreach (Metadata metadata in documentConversionResponse.metadata)
Log.Debug("ExampleDocumentConversion", "metadata | name: {0}, content: {1}", metadata.name, metadata.content);
}
if (documentConversionResponse.answer_units != null && documentConversionResponse.answer_units.Length > 0)
{
Log.Debug("ExampleDocumentConversion", "mediaTypeDetected: {0}", documentConversionResponse.answer_units.Length);
foreach (AnswerUnit answerUnit in documentConversionResponse.answer_units)
{
Log.Debug("ExampleDocumentConversion", "answerUnit | type: {0}, title: {1}, parent_id: {2}, id: {3}, direction: {4}", answerUnit.type, answerUnit.title, answerUnit.parent_id, answerUnit.id, answerUnit.direction);
if (answerUnit.content != null && answerUnit.content.Length > 0)
foreach (Content content in answerUnit.content)
Log.Debug("ExampleDocumentConversion", "content | mediaType: {0}, text: {1}", content.media_type, content.text);
}
}
if (!string.IsNullOrEmpty(documentConversionResponse.htmlContent))
Log.Debug("ExampleDocumentConversion", "HTMLContent: {0}", documentConversionResponse.htmlContent);
if (!string.IsNullOrEmpty(documentConversionResponse.textContent))
Log.Debug("ExampleDocumentConversion", "TextContent: {0}", documentConversionResponse.textContent);
}
}
Use the AlchemyData News service to provide news and blog content enriched with natural language processing to allow for highly targeted search and trend analysis. Now you can query the world's news sources and blogs like a database.
AlchemyData News indexes 250k to 300k English language news and blog articles every day with historical search available for the past 60 days. You can query the News API directly with no need to acquire, enrich and store the data yourself - enabling you to go beyond simple keyword-based searches. You can request which fields to return and filter fields by string. All available fields can be accessed using Fields constants in the AlchemyData News Data Model.
ate AlchemyAPI m_AlchemyAPI = new AlchemyAPI();
Start()
string[] returnFields = {Fields.ENRICHED_URL_ENTITIES, Fields.ENRICHED_URL_KEYWORDS};
Dictionary<string, string> queryFields = new Dictionary<string, string>();
queryFields.Add(Fields.ENRICHED_URL_RELATIONS_RELATION_SUBJECT_TEXT, "Obama");
queryFields.Add(Fields.ENRICHED_URL_CLEANEDTITLE, "Washington");
if (!m_AlchemyAPI.GetNews(OnGetNews, returnFields, queryFields))
Log.Debug("ExampleAlchemyData", "Failed to get news!");
OnGetNews(NewsResponse newsData, string data)
// Access requested fields
if(newsData != null)
Log.Debug("ExampleAlchemyData", "status: {0}", newsData.status);
The IBM Watson? Retrieve and Rank service combines two information retrieval components in a single service: the power of Apache Solr and a sophisticated machine learning capability. This combination provides users with more relevant results by automatically reranking them by using these machine learning algorithms.
Retrieves the list of Solr clusters for the service instance.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get clusters!");
(!m_RetrieveAndRank.GetClusters(OnGetClusters))
Log.Debug("ExampleRetrieveAndRank", "Failed to get clusters!");
ate void OnGetClusters(SolrClusterListResponse resp, string data)
if (resp != null)
{
foreach (SolrClusterResponse cluster in resp.clusters)
Log.Debug("ExampleRetrieveAndRank", "OnGetClusters | cluster name: {0}, size: {1}, ID: {2}, status: {3}.", cluster.cluster_name, cluster.cluster_size, cluster.solr_cluster_id, cluster.solr_cluster_status);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetClusters | Get Cluster Response is null!");
}
Provisions a Solr cluster asynchronously. When the operation is successful, the status of the cluster is set to NOT_AVAILABLE. The status must be READY before you can use the cluster.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to create cluster!");
(!m_RetrieveAndRank.CreateCluster(OnCreateCluster, "unity-test-cluster", "1"))
Log.Debug("ExampleRetrieveAndRank", "Failed to create cluster!");
ate void OnCreateCluster(SolrClusterResponse resp, string data)
if (resp != null)
{
Log.Debug("ExampleRetrieveAndRank", "OnCreateClusters | name: {0}, size: {1}, ID: {2}, status: {3}.", resp.cluster_name, resp.cluster_size, resp.solr_cluster_id, resp.solr_cluster_status);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnCreateClusters | Get Cluster Response is null!");
}
Stops and deletes a Solr Cluster asynchronously.
Start()
ring clusterToDelete = "<cluster-to-delete>";
g.Debug("ExampleRetrieveAndRank", "Attempting to delete cluster {0}!", clusterToDelete);
(!m_RetrieveAndRank.DeleteCluster(OnDeleteCluster, clusterToDelete))
Log.Debug("ExampleRetrieveAndRank", "Failed to delete cluster!");
ate void OnDeleteCluster(bool success, string data)
if (success)
{
Log.Debug("ExampleRetrieveAndRank", "OnDeleteCluster | Success!");
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnDeleteCluster | Failure!");
}
Returns status and other information about a cluster.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get cluster {0}!", <testClusterID>);
(!m_RetrieveAndRank.GetCluster(OnGetCluster, testClusterID))
Log.Debug("ExampleRetrieveAndRank", "Failed to get cluster!");
ate void OnGetCluster(SolrClusterResponse resp, string data)
if (resp != null)
{
Log.Debug("ExampleRetrieveAndRank", "OnGetClusters | name: {0}, size: {1}, ID: {2}, status: {3}.", resp.cluster_name, resp.cluster_size, resp.solr_cluster_id, resp.solr_cluster_status);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetClusters | Get Cluster Response is null!");
}
Retrieves all configurations for a cluster.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get cluster configs for {0}!", <testClusterID>);
(!m_RetrieveAndRank.GetClusterConfigs(OnGetClusterConfigs, <testClusterID>))
Log.Debug("ExampleRetrieveAndRank", "Failed to get cluster configs!");
ate void OnGetClusterConfigs(SolrConfigList resp, string data)
if (resp != null)
{
if (resp.solr_configs.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "OnGetClusterConfigs | no cluster configs!");
foreach (string config in resp.solr_configs)
Log.Debug("ExampleRetrieveAndRank", "OnGetClusterConfigs | solr_config: " + config);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetClustersConfigs | Get Cluster Configs Response is null!");
}
Deletes the configuration for a cluster. Before you delete the configuration, delete any collections that point to it.
Start()
ring clusterConfigToDelete = "test-config";
g.Debug("ExampleRetrieveAndRank", "Attempting to delete cluster {0} config {1}!", <testClusterID>, clusterConfigToDelete);
(!m_RetrieveAndRank.DeleteClusterConfig(OnDeleteClusterConfig, <testClusterID>, clusterConfigToDelete))
Log.Debug("ExampleRetriveAndRank", "Failed to delete cluster config {0}", clusterConfigToDelete);
ate void OnDeleteClusterConfig(bool success, string data)
if (success)
{
Log.Debug("ExampleRetrieveAndRank", "OnDeleteClusterConfig | Success!");
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnDeleteClusterConfig | Failure!");
}
Retrieves the configuration for a cluster by its name.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get cluster {0} config {1}!", <testClusterID>, <testClusterConfigName>);
(!m_RetrieveAndRank.GetClusterConfig(OnGetClusterConfig, <testClusterID>, <testClusterConfigName>))
Log.Debug("ExampleRetrieveAndRank", "Failed to get cluster config {0}!", <testClusterConfigName>);
ate void OnGetClusterConfig(byte[] respData, string data)
if(respData != null)
{
Log.Debug("ExampleRetrieveAndRank", "OnGetClusterConfig | success!");
string currentDirectory = Application.dataPath;
var path = EditorUtility.SaveFilePanel("Save Config", currentDirectory, "config", "zip");
if (!string.IsNullOrEmpty(path))
{
currentDirectory = Path.GetDirectoryName(path);
m_RetrieveAndRank.SaveConfig(OnSaveConfig, respData, path, data);
}
}
else
Log.Debug("ExampleRetrieveAndRank", "OnGetClusterConfig | respData is null!");
ate void OnSaveConfig(bool success, string data)
if (success)
Log.Debug("ExampleRetrieveAndRank", "OnSaveConfig | success!");
else
Log.Debug("ExampleRetrieveAndRank", "OnSaveConfig | fail!");
Uploads a zip file containing the configuration files for your Solr collection. The zip file must include schema.xml, solrconfig.xml, and other files you need for your configuration. Configuration files on the zip file's path are not uploaded. The request fails if a configuration with the same name exists. To update an existing config, use the Solr configuration API.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to upload cluster {0} config {1}!", <testClusterID>, <testClusterConfigName>);
(!m_RetrieveAndRank.UploadClusterConfig(OnUploadClusterConfig, <testClusterID>, <testClusterConfigName>, <testClusterConfigPath>))
Log.Debug("ExampleRetrieveAndRank", "Failed to upload cluster config {0}!", <testClusterConfigPath>);
ate void OnUploadClusterConfig(UploadResponse resp, string data)
if (resp != null)
{
Log.Debug("ExampleRetrieveAndRank", "OnUploadClusterConfig | Success! {0}, {1}", resp.message, resp.statusCode);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnUploadClusterConfig | Failure!");
}
An example of a method that forwards to the Solr Collections API. This Retrieve and Rank resource improves error handling and resiliency of the Solr Collections API.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to list collections!");
(!m_RetrieveAndRank.ForwardCollectionRequest(OnGetCollections, <testClusterID>, CollectionsAction.LIST))
Log.Debug("ExampleRetrieveAndRank", "Failed to get collections!");
ate void OnGetCollections(CollectionsResponse resp, string data)
if(resp != null)
{
if(resp.responseHeader != null)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | status: {0}, QTime: {1}.", resp.responseHeader.status, resp.responseHeader.QTime);
if(resp.collections != null)
{
if (resp.collections.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | There are no collections!");
else
foreach (string collection in resp.collections)
Log.Debug("ExampleRetrieveAndRank", "\tOnGetCollections | collection: {0}", collection);
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | GetCollections Response is null!");
}
An example of a method that forwards to the Solr Collections API. This Retrieve and Rank resource improves error handling and resiliency of the Solr Collections API.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to create collection!");
(!m_RetrieveAndRank.ForwardCollectionRequest(OnGetCollections, <testClusterID>, CollectionsAction.CREATE, "TestCollectionToDelete", <testClusterConfigName>))
Log.Debug("ExampleRetrieveAndRank", "Failed to create collections!");
ate void OnGetCollections(CollectionsResponse resp, string data)
if(resp != null)
{
if(resp.responseHeader != null)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | status: {0}, QTime: {1}.", resp.responseHeader.status, resp.responseHeader.QTime);
if(resp.collections != null)
{
if (resp.collections.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | There are no collections!");
else
foreach (string collection in resp.collections)
Log.Debug("ExampleRetrieveAndRank", "\tOnGetCollections | collection: {0}", collection);
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | GetCollections Response is null!");
}
An example of a method that forwards to the Solr Collections API. This Retrieve and Rank resource improves error handling and resiliency of the Solr Collections API.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to delete collection!");
(!m_RetrieveAndRank.ForwardCollectionRequest(OnGetCollections, <testClusterID>, CollectionsAction.DELETE, "TestCollectionToDelete"))
Log.Debug("ExampleRetrieveAndRank", "Failed to delete collections!");
ate void OnGetCollections(CollectionsResponse resp, string data)
if(resp != null)
{
if(resp.responseHeader != null)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | status: {0}, QTime: {1}.", resp.responseHeader.status, resp.responseHeader.QTime);
if(resp.collections != null)
{
if (resp.collections.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | There are no collections!");
else
foreach (string collection in resp.collections)
Log.Debug("ExampleRetrieveAndRank", "\tOnGetCollections | collection: {0}", collection);
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnGetCollections | GetCollections Response is null!");
}
Adds content to a Solr index so you can search it.
An example of a method that forwards to Solr. For more information about indexing, see Indexing and Basic Data Operations in the Apache Solr Reference.
You must commit your documents to the index to search for them. For more information about when to commit, see UpdateHandlers in SolrConfig in the Solr Reference.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to index documents!");
(!m_RetrieveAndRank.IndexDocuments(OnIndexDocuments, <indexDataPath>, <testClusterID>, <testCollectionName>))
Log.Debug("ExampleRetrieveAndRank", "Failed to index documents!");
ate void OnIndexDocuments(IndexResponse resp, string data)
if(resp != null)
{
if (resp.responseHeader != null)
Log.Debug("ExampleRetrieveAndRank", "OnIndexDocuments | status: {0}, QTime: {1}", resp.responseHeader.status, resp.responseHeader.QTime);
else
Log.Debug("ExampleRetrieveAndRank", "OnIndexDocuments | Response header is null!");
}
else
{
Log.Debug("ExampleRetrieveAndRank", "OnIndexDocuments | response is null!");
}
Forwards to the Solr standard query parser.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to search!");
ring[] fl = { "title", "id", "body", "author", "bibliography" };
(!m_RetrieveAndRank.Search(OnSearch, <testClusterID>, <testCollectionName>, <testQuery>, fl))
Log.Debug("ExampleRetrieveAndRank", "Failed to search!");
g.Debug("ExampleRetrieveAndRank", "Attempting to search!");
ring[] fl = { "title", "id", "body", "author", "bibliography" };
(!m_RetrieveAndRank.Search(OnSearch, <testClusterID>, <testCollectionName>, <testQuery>, fl, true, <rankerID>))
Log.Debug("ExampleRetrieveAndRank", "Failed to search!");
ate void OnSearch(SearchResponse resp, string data)
if(resp != null)
{
if(resp.responseHeader != null)
{
Log.Debug("ExampleRetrieveAndRank", "Search | status: {0}, QTime: {1}.", resp.responseHeader.status, resp.responseHeader.QTime);
if (resp.responseHeader._params != null)
Log.Debug("ExampleRetrieveAndRank", "\tSearch | params.q: {0}, params.fl: {1}, params.wt: {2}.", resp.responseHeader._params.q, resp.responseHeader._params.fl, resp.responseHeader._params.wt);
else
Log.Debug("ExampleRetrieveAndRank", "Search | responseHeader.params is null!");
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | response header is null!");
}
if (resp.response != null)
{
Log.Debug("ExampleRetrieveAndRank", "Search | numFound: {0}, start: {1}.", resp.response.numFound, resp.response.start);
if(resp.response.docs != null)
{
if (resp.response.docs.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "Search | There are no docs!");
else
foreach (Doc doc in resp.response.docs)
{
Log.Debug("ExampleRetrieveAndRank", "\tSearch | id: {0}.", doc.id);
if (doc.title != null)
{
if (doc.title.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "Search | There are no title");
else
foreach (string s in doc.title)
Log.Debug("ExampleRetrieveAndRank", "\tSearch | title: {0}.", s);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | title is null");
}
if (doc.author != null)
{
if (doc.author.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "Search | There are no authors");
else
foreach (string s in doc.author)
Log.Debug("ExampleRetrieveAndRank", "\tSearch | Author: {0}.", s);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | Authors is null");
}
if (doc.body != null)
{
if (doc.body.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "Search | There are no body");
else
foreach (string s in doc.body)
Log.Debug("ExampleRetrieveAndRank", "\tSearch | body: {0}.", s);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | Body is null");
}
if (doc.bibliography != null)
{
if (doc.bibliography.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "Search | There are no bibliographies");
else
foreach (string s in doc.bibliography)
Log.Debug("ExampleRetrieveAndRank", "\tSearch | bibliography: {0}.", s);
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | Bibliography is null");
}
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | docs are null!");
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search | response is null!");
}
}
else
{
Log.Debug("ExampleRetrieveAndRank", "Search response is null!");
}
Retrieves the list of rankers for the service instance.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get rankers!");
(!m_RetrieveAndRank.GetRankers(OnGetRankers))
Log.Debug("ExampleRetrieveAndRank", "Failed to get rankers!");
ate void OnGetRankers(ListRankersPayload resp, string data)
if (resp != null)
{
if (resp.rankers.Length == 0)
Log.Debug("ExampleRetrieveAndRank", "OnGetRankers | no rankers!");
foreach (RankerInfoPayload ranker in resp.rankers)
Log.Debug("ExampleRetrieveAndRank", "OnGetRankers | ranker name: {0}, ID: {1}, created: {2}, url: {3}.", ranker.name, ranker.ranker_id, ranker.created, ranker.url);
}
else
Log.Debug("ExampleRetrieveAndRank", "OnGetRankers | Get Ranker Response is null!");
Sends data to create and train a ranker and returns information about the new ranker.
When the operation is successful, the status of the ranker is set to Training. The status must be Available before you can use the ranker.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to create rankers!");
(!m_RetrieveAndRank.CreateRanker(OnCreateRanker, <testRankerTrainingPath>, "testRanker"))
Log.Debug("ExampleRetrieveAndRank", "Failed to create ranker!");
ate void OnCreateRanker(RankerStatusPayload resp, string data)
if (resp != null)
Log.Debug("ExampleRetrieveAndRank", "OnCreateRanker | ID: {0}, url: {1}, name: {2}, created: {3}, status: {4}, statusDescription: {5}.", resp.ranker_id, resp.url, resp.name, resp.created, resp.status, resp.status_description);
else
Log.Debug("ExampleRetrieveAndRank", "OnCreateRanker | Get Cluster Response is null!");
Returns the top answer and a list of ranked answers with their ranked scores and confidence values. Use the Get information about a ranker method to retrieve the status.
Use this method to return answers when you train the ranker with custom features. However, in most cases, you can use the Search and rank method.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to rank!");
(!m_RetrieveAndRank.Rank(OnRank, <testRankerID>, <testAnswerDataPath>))
Log.Debug("ExampleRetriveAndRank", "Failed to rank!");
ate void OnRank(RankerOutputPayload resp, string data)
if (resp != null)
{
Log.Debug("ExampleRetrieveAndRank", "OnRank | ID: {0}, url: {1}, name: {2}, top_answer: {3}.", resp.ranker_id, resp.url, resp.name, resp.top_answer);
if (resp.answers != null)
if (resp.answers.Length == 0)
{
Log.Debug("ExampleRetrieveAndRank", "\tThere are no answers!");
}
else
{
foreach (RankedAnswer answer in resp.answers)
Log.Debug("ExampleRetrieveAndRank", "\tOnRank | answerID: {0}, score: {1}, confidence: {2}.", answer.answer_id, answer.score, answer.confidence);
}
}
else
Log.Debug("ExampleRetrieveAndRank", "OnRank | Rank response is null!");
Deletes a ranker.
Start()
g.Debug("ExampleRetriveAndRank", "Attempting to delete ranker {0}!", <rankerToDelete>);
(!m_RetrieveAndRank.DeleteRanker(OnDeleteRanker, <rankerToDelete>))
Log.Debug("ExampleRetrieveAndRank", "Failed to delete ranker {0}!", <rankerToDelete>);
ate void OnDeleteRanker(bool success, string data)
if (success)
Log.Debug("ExampleRetrieveAndRank", "OnDeleteRanker | Success!");
else
Log.Debug("ExampleRetrieveAndRank", "OnDeleteRanker | Failure!");
Returns status and other information about a ranker.
Start()
g.Debug("ExampleRetrieveAndRank", "Attempting to get Ranker Info!");
(!m_RetrieveAndRank.GetRanker(OnGetRanker, <testRankerID>))
Log.Debug("ExampleRetrieveAndRank", "Failed to get ranker!");
ate void OnGetRanker(RankerStatusPayload resp, string data)
if(resp != null)
Log.Debug("ExampleRetrieveAndRank", "GetRanker | ranker_id: {0}, url: {1}, name: {2}, created: {3}, status: {4}, status_description: {5}.", resp.ranker_id, resp.url, resp.name, resp.created, resp.status, resp.status_description);
else
Log.Debug("ExampleRetrieveAndRank", "GetRanker | GetRanker response is null!");
The IBM Watson? Discovery Service uses data analysis combined with cognitive intuition in order to take your unstructured data and enrich it so that you can query it to return the information that you need from it.
Creates an environment for the service instance. Note: You can create only one environment per service instance. Attempting to create another environment for the same service instance results in an error.
ate Discovery m_Discovery = new Discovery();
ate void CreateEnvironment()
(!m_Discovery.AddEnvironment(OnAddEnvironment, <environment-name>, <environment-description>, <environment-size>))
Log.Debug("ExampleDiscoveryV1", "Failed to add environment");
ate void OnAddEnvironment(Environment resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Added {0}", resp.environment_id, data);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
List existing environments for the service instance.
ate Discovery m_Discovery = new Discovery();
ate void GetEnvironments()
(!m_Discovery.GetEnvironments(OnGetEnvironments))
Log.Debug("ExampleDiscoveryV1", "Failed to get environments");
ate void OnGetEnvironments(GetEnvironmentsResponse resp, string data)
(resp != null)
foreach (Environment environment in resp.environments)
Log.Debug("ExampleDiscoveryV1", "environment_id: {0}", environment.environment_id);
se
Log.Debug("ExampleDiscoveryV1", "resp is null");
Gets detailed information about the specified environment.
ate Discovery m_Discovery = new Discovery();
ate void GetEnvironment()
(!m_Discovery.GetEnvironment(OnGetEnvironment, <environment-id>))
Log.Debug("ExampleDiscoveryV1", "Failed to get environment");
ate void OnGetEnvironment(Environment resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "environment_name: {0}", resp.name);
se
Log.Debug("ExampleDiscoveryV1", "resp is null");
Updates an existing environment.
ate Discovery m_Discovery = new Discovery();
ate void DeleteEnvironment()
(!m_Discovery.DeleteEnvironment(OnDeleteEnvironment, <environment-id>))
Log.Debug("ExampleDiscoveryV1", "Failed to delete environment");
ate void OnDeleteEnvironment(bool success, string data)
(success)
Log.Debug("ExampleDiscoveryV1", "Delete environment successful");
se
Log.Debug("ExampleDiscoveryV1", "Delete environment failed");
Adds a configuration to the service instance.
ate Discovery m_Discovery = new Discovery();
ate void AddConfiguration()
(!m_Discovery.AddConfiguration(OnAddConfiguration, <environment-id>, <configuration-json-path>))
Log.Debug("ExampleDiscoveryV1", "Failed to add configuration");
ate void OnAddConfiguration(Configuration resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Configuration: {0}, {1}", resp.configuration_id, resp.name);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Lists existing configurations for the service instance.
ate Discovery m_Discovery = new Discovery();
ate void GetConfigurations()
(!m_Discovery.GetConfigurations(OnGetConfigurations, <environment-id>))
Log.Debug("ExampleDiscoveryV1", "Failed to get configurations");
ate void OnGetConfigurations(GetConfigurationsResponse resp, string data)
(resp != null)
if (resp.configurations != null && resp.configurations.Length > 0)
{
foreach (ConfigurationRef configuration in resp.configurations)
{
Log.Debug("ExampleDiscoveryV1", "Configuration: {0}, {1}", configuration.configuration_id, configuration.name);
}
}
else
Log.Debug("ExampleDiscoveryV1", "There are no configurations for this environment.");
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Get information about the specified configuration.
ate Discovery m_Discovery = new Discovery();
ate void GetConfiguration()
(!m_Discovery.GetConfiguration(OnGetConfiguration, <environment-id>, <configuration-id>))
Log.Debug("ExampleDiscoveryV1", "Failed to get configuration");
ate void OnGetConfiguration(Configuration resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Configuration: {0}, {1}", resp.configuration_id, resp.name);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Deletes an existing configuration from the service instance.
ate Discovery m_Discovery = new Discovery();
ate void DeleteConfiguration()
(!m_Discovery.DeleteConfiguration(OnDeleteConfiguration, <environment-id>, <configuration-id>))
Log.Debug("ExampleDiscoveryV1", "Failed to delete configuration");
ate void OnDeleteConfiguration(bool success, string data)
(success)
Log.Debug("ExampleDiscoveryV1", "Delete configuration successful");
se
Log.Debug("ExampleDiscoveryV1", "Delete configuration failed");
Run a sample document against your configuration or the default configuration and return diagnostic information designed to help you understand how the document was processed. The document is not added to a collection.
ate Discovery m_Discovery = new Discovery();
ate void PreviewConfiguration()
(!m_Discovery.PreviewConfiguration(OnPreviewConfiguration, <environment-id>, <configuration-id>, null, <content-file-path>, <metadata>))
Log.Debug("ExampleDiscoveryV1", "Failed to preview configuration");
ate void OnPreviewConfiguration(TestDocument resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Preview succeeded: {0}", resp.status);
se
Log.Debug("ExampleDiscoveryV1", "Failed to preview configuration");
Creates a new collection for storing documents.
ate Discovery m_Discovery = new Discovery();
ate void CreateCollection()
(!m_Discovery.AddCollection(OnAddCollection, <environment-id>, <collection-name>, <collection-description>, <configuration-id>))
Log.Debug("ExampleDiscovery", "Failed to add collection");
ate void OnAddCollection(CollectionRef resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Collection: {0}, {1}", resp.collection_id, resp.name);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Display a list of existing collections.
ate Discovery m_Discovery = new Discovery();
ate void GetCollections()
(!m_Discovery.GetCollections(OnGetCollections, m_DefaultEnvironmentID))
Log.Debug("ExampleDiscovery", "Failed to get collections");
ate void OnGetCollections(GetCollectionsResponse resp, string data)
(resp != null)
if (resp.collections != null && resp.collections.Length > 0)
{
foreach (CollectionRef collection in resp.collections)
Log.Debug("ExampleDiscoveryV1", "Collection: {0}, {1}", collection.collection_id, collection.name);
}
else
Log.Debug("ExampleDiscoveryV1", "There are no collections");
se
Log.Debug("ExampleDiscoveryV1", "Failed to get collections");
Show detailed information about an existing collection.
ate Discovery m_Discovery = new Discovery();
ate void GetCollection()
(!m_Discovery.GetCollection(OnGetCollection, <environment-id>, <collection-id>))
Log.Debug("ExampleDiscovery", "Failed to get collection");
ate void OnGetCollection(Collection resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Collection: {0}, {1}", resp.collection_id, resp.name);
se
Log.Debug("ExampleDiscoveryV1", "Failed to get collections");
Deletes an existing collection.
ate Discovery m_Discovery = new Discovery();
ate void DeleteCollection()
(!m_Discovery.DeleteCollection(OnDeleteCollection, <environment-id>, <collection-id>))
Log.Debug("ExampleDiscovery", "Failed to add collection");
ate void OnDeleteCollection(bool success, string data)
if (success)
Log.Debug("ExampleDiscoveryV1", "Delete collection successful");
else
Log.Debug("ExampleDiscoveryV1", "Delete collection failed");
Gets a list of the unique fields, and each field's type, that are stored in a collection's index.
ate Discovery m_Discovery = new Discovery();
ate void Start()
(!m_Discovery.GetFields(OnGetFields, m_CreatedEnvironmentID, m_CreatedCollectionID))
Log.Debug("ExampleDiscoveryV1", "Failed to get fields");
ate void OnGetFields(GetFieldsResponse resp, string customData)
(resp != null)
oreach (Field field in resp.fields)
Log.Debug("ExampleDiscoveryV1", "Field: {0}, type: {1}", field.field, field.type);
se
og.Debug("ExampleDiscoveryV1", "Discovery.GetFields(); resp is null");
Add a document to your collection.
ate Discovery m_Discovery = new Discovery();
ate void AddDocument()
(!m_Discovery.AddDocument(OnAddDocument, <environment-id>, <collection-id>, <document-file-path>, <configuration-id>, <configuration>))
Log.Debug("ExampleDiscovery", "Failed to add document");
ate void OnAddDocument(DocumentAccepted resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Added Document {0} {1}", resp.document_id, resp.status);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Update or partially update a document to create or replace an existing document.
ate Discovery m_Discovery = new Discovery();
ate void UpdateDocument()
(!m_Discovery.UpdateDocument(OnUpdateDocument, <environment-id>, <collection-id>, <document-id>, <document-file-path>, <configuration-id>, <configuration>))
Log.Debug("ExampleDiscovery", "Failed to update document");
ate void OnUpdateDocument(DocumentAccepted resp, string data)
if (resp != null)
Log.Debug("ExampleDiscoveryV1", "Updated Document {0} {1}", resp.document_id, resp.status);
else
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Display status information about a submitted document.
ate Discovery m_Discovery = new Discovery();
ate void GetDocument()
(!m_Discovery.GetDocument(OnGetDocument, <environment-id>, <collection-id>, <document-id>))
Log.Debug("ExampleDiscovery", "Failed to get document");
ate void OnGetDocument(DocumentStatus resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "Got Document {0} {1}", resp.document_id, resp.status);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
Delete a document from a collection.
ate Discovery m_Discovery = new Discovery();
ate void DeleteDocument()
(!m_Discovery.DeleteDocument(OnDeleteDocument, <environment-id>, <collection-id>, <document-id>))
Log.Debug("ExampleDiscovery", "Failed to delete document");
ate void OnDeleteDocument(bool success, string data)
if (success)
Log.Debug("ExampleDiscoveryV1", "Delete document successful");
else
Log.Debug("ExampleDiscoveryV1", "Delete collection failed");
Delete a document from a collection.
Once your content is uploaded and enriched by the Discovery service, you can build queries to search your content. For a deep dive into queries, see Building Queries and Delivering Content.
ate Discovery m_Discovery = new Discovery();
ate void Query()
(!m_Discovery.Query(OnQuery, <environment-id>, <collection-id>, <filter>, <query>, <aggregation>, <count>, <return>, <offset>))
Log.Debug("ExampleDiscovery", "Failed to query");
ate void OnQuery(QueryResponse resp, string data)
(resp != null)
Log.Debug("ExampleDiscoveryV1", "key: {0}, matching results: {1}", resp.aggregations.term.results.key, resp.aggregations.term.results.matching_results);
foreach(QueryResult result in resp.results)
Log.Debug("ExampleDiscoveryV1", "Query response: id: {0}, score: {1}", result.id, result.score);
se
Log.Debug("ExampleDiscoveryV1", "resp is null, {0}", data);
You can quickly develop a basic application that uses the Speech to Text service and the Natural Language Classifier service by using the prefabs that come with the SDK. Ensure that you prepare the test data before you complete the the following steps:
Create a new scene and drag the following prefabs from Assets -> Watson -> Prefabs, and drop them in the Hierarchy tab:
Select the Natural Language Classifier Widget.
In the Classifier Name field in the Inspector tab, specify TestNaturalLanguageClassifier.
In the Natural Language Classifier Editor, expand the Test Natural Language Classifier , expand the classes, and determine which questions about the weather to ask to test the classifier.
Run the application.
Say your questions into the microphone to test the MicWidget, the SpeechToTextWidget, and the NaturalLanguageClassifierWidget.
To read the documentation you need to have a chm reader installed. Open the documentation by selecting API Reference the Watson menu (Watson -> API Reference).
If you are having difficulties using the APIs or have a question about the IBM Watson Services, please ask a question on dW Answers or Stack Overflow.
Find more open source projects on the IBM Github Page.
This library is licensed under Apache 2.0. Full license text is available in LICENSE.
See CONTRIBUTING.md.