ibm-visual-recognition

Visual Recognition (IBM Cloud · Watson)

Table of Contents

• Classify an image
• Detect faces in an image
• Create a custom classifier

External links

• IBM Dashboard
• Best practices for custom classifiers (Blog post)
• Building Cognitive Applications: Visual Recognition (IBM Redbooks) (PDF)

Classify an image

make classify_fruits

This should return some like the following.

{
    "images": [
        {
            "classifiers": [
                {
                    "classifier_id": "default",
                    "name": "default",
                    "classes": [
                        {
                            "class": "banana",
                            "score": 0.562,
                            "type_hierarchy": "/fruit/banana"
                        },
                        {
                            "class": "fruit",
                            "score": 0.788
                        },
                        {
                            "class": "diet (food)",
                            "score": 0.528,
                            "type_hierarchy": "/food/diet (food)"
                        },
                        {
                            "class": "food",
                            "score": 0.528
                        },
                        {
                            "class": "honeydew",
                            "score": 0.5,
                            "type_hierarchy": "/fruit/melon/honeydew"
                        },
                        {
                            "class": "melon",
                            "score": 0.501
                        },
                        {
                            "class": "olive color",
                            "score": 0.973
                        },
                        {
                            "class": "lemon yellow color",
                            "score": 0.789
                        }
                    ]
                }
            ],
            "image": "fruitbowl.jpg"
        }
    ],
    "images_processed": 1,
    "custom_classes": 0
}

Detect faces in an image

make recognize_face

This should return some like the following.

{
    "images": [
        {
            "faces": [
                {
                    "age": {
                        "max": 44,
                        "min": 35,
                        "score": 0.446989
                    },
                    "face_location": {
                        "height": 159,
                        "left": 256,
                        "top": 64,
                        "width": 92
                    },
                    "gender": {
                        "gender": "MALE",
                        "score": 0.99593
                    },
                    "identity": {
                        "name": "Barack Obama",
                        "score": 0.970688,
                        "type_hierarchy": "/people/politicians/democrats/barack obama"
                    }
                }
            ],
            "image": "prez.jpg"
        }
    ],
    "images_processed": 1
}

Creating your own classifier

make create_circle_square_classifier

{
    "classifier_id": "circle_or_square_138209706",
    "name": "circle_or_square",
    "status": "training",
    "owner": "cbaacf2e-3e08-4ac6-939b-8e24abac56f7",
    "created": "2018-03-21T04:39:45.763Z",
    "updated": "2018-03-21T04:39:45.763Z",
    "classes": [
        {
            "class": "square"
        },
        {
            "class": "circle"
        }
    ],
    "core_ml_enabled": true
}

Your classifier should start training. You can check its status (and will know its done when status turns to ready from training.)

curl -X GET \
"https://gateway-a.watsonplatform.net/visual-recognition/api/v3/classifiers/{classifier_id}?api_key={api_key}&version=2016-05-20"