The Image Plugin is an Content Based Image Retrieval Plugin for Elasticsearch using LIRE (Lucene Image Retrieval). It allows users to index images and search for similar images.

It adds an image field type and an image query

In order to install the plugin, simply run: bin\plugin install zengde/elasticsearch-image.

curl -XPUT 'localhost:9200/test/test/_mapping' -d '{
    "test": {
		"_source": {
            "excludes": ["my_img"]
        },
        "properties": {
            "my_img": {
                "type": "image",
                "feature": ["CEDD","JCD","FCTH"],
                "hash":"BitSampling",
                "store":false
            },
            "name": {
                "type": "string",
                "index": "not_analyzed"
            }
        }
    }
}'

type should be image. Mandatory

feature is a map of features for index. Mandatory, at least one is required

hash can be set if you want to search on hash. Optional

curl -XPOST 'localhost:9200/test/test' -d '{
    "my_img": "... base64 encoded image ..."
}'

curl -XPOST 'localhost:9200/test/test/_search' -d '{
    "query": {
        "image": {
            "my_img": {
                "feature": "CEDD",
                "image": "... base64 encoded image to search ...",
                "hash": "BIT_SAMPLING"
            }
        }
    }
}'

feature should be one of the features in the mapping. Mandatory

image base64 of image to search. Optional if search using existing image

hash should be same to the hash set in mapping. Optional

boost score boost Optional

####Global Features: SIMPLE_CENTRIST, SPATIAL_PYRAMID_CENTRIST, JOINT_HISTOGRAM, LOCAL_BINARY_PATTERNS_AND_OPPONENT, RANK_AND_OPPONENT, SPACC, SPCEDD, SPFCTH, SPJCD, SPLBP, AUTO_COLOR_CORRELOGRAM, BINARY_PATTERNS_PYRAMID, CEDD, COLOR_LAYOUT, EDGE_HISTOGRAM, FCTH, FUZZY_COLOR_HISTOGRAM, FUZZY_OPPONENT_HISTOGRAM, GABOR, JCD, JPEG_COEFFICIENT_HISTOGRAM, LOCAL_BINARY_PATTERNS, LUMINANCE_LAYOUT, OPPONENT_HISTOGRAM, PHOG, ROTATION_INVARIANT_LOCAL_BINARY_PATTERNS, SCALABLE_COLOR, SIMPLE_COLOR_HISTOGRAM, TAMURA

BitSampling, LSH, MetricSpaces

Hash will increase search speed with large data sets

See Large image data sets with LIRE ?some new numbers

• change mapping and search rest format and ralated code
• change indexed image document structure
• upgrade to LIRE1.0b2 , new Hash mode MetricSpaces and some Features
• change buld tools to gradle
• remove redundant files

• support es 2.1.1

• Use multi-thread when multiple features are required to improve index speed
• Allow index metadata
• Allow query by existing image in index

• Added limit in image query
• Added plugin version in es-plugin.properties

• initial release