Histogram

a histogram is a type of opensearch aggregation that groups different items in a particular range bucket based on values provided by the user they differ from a typical range aggregation because histograms do not require the definition of every specific interval explicitly users can set the maximum and minimum values and define the intervals for each bucket histograms are essentially an easier way to define the ranges for example, in a price based histogram, users can set the minimum value at $10, the maximum value at $1000, and set the interval value at 10 in this scenario, 100 buckets will be created within the ranges of 10 20, 20 30, and so on the api call of a histogram is post https //api upstartcommerce com/v1/search/aggregation to understand the concept of histogram better, consider the following example code block in it an example histogram for the property of "price" is created { "id" "histogramexample", "displayname" "histo example price", "status" "active", "aggregation" { "name" "histo example price", "priority" 0, "aggregation" { "histogram" { "field" "productitems pricing price", "interval" 10, "min doc count" 1, "extended bounds" { "min" 1, "max" 100 } } }, "metadata" { "type" "histogram" }, "type" "managedaggregation" } } notice that the type field correlates nochannel search aggregations called "managed aggregation" metadata for histograms is generated after its creation the following is the explanation of the important parameters involved in the code block above field this value defines the property on which the buckets will be created in this example, the value is set to "price" this means that the buckets of items will be created on the basis of their prices interval this value defines the interval size of each bucket for example, it is set to 10 in the above example this means that a bucket will be created from 1 to 10, 11 to 20, and so on min doc count this field controls the total number of documents retrieved in a specific interval in the example above the value is set to 1 this means that the retrieved document should contain at least 1 product that falls in the range extended bounds in this block, users set the max and min values for the ranges in the example, the minimum value is 1 and the maximum is at 100 remember that histogram can round off the values of item properties to the nearest number this helps each product fit in the nearest bucket for example, if you set the interval value at 5 on the property of prices ranging from 1 to 20, all items that cost $12 will be placed in the bucket with value 10 automatically