BottomSum (DMX)


Updated: March 2, 2016

Returns, in order of increasing rank, the bottom-most rows of a table whose cumulative total is at least a specified value.

BottomSum(<table expression>, <rank expression>, <sum>)  

An expression that returns a table, such as a <table column reference>, or a function that returns a table.

<table expression>

The BottomSum function returns the bottom-most rows in increasing order of rank. The rank is based on the evaluated value of the <rank expression> argument for each row, such that the sum of the <rank expression> values is at least the given total that is specified by the <sum> argument. BottomSum returns the smallest number of elements possible while still meeting the specified sum value.

The following example creates a prediction query against the Association model that you build by using the Basic Data Mining Tutorial.

To understand how BottomSum works, it might be helpful to first execute a prediction query that returns only the nested table.

SELECT Predict ([Association].[v Assoc Seq Line Items], INCLUDE_STATISTICS, 10)  
SELECT (SELECT 'Women''s Mountain Shorts' as [Model]) AS [v Assoc Seq Line Items]) AS t  

System_CAPS_ICON_note.jpg Note

In this example, the value supplied as input contains a single quotation mark, and therefore must be escaped by prefacing it with another single quotation mark. If you are not sure of the syntax for inserting an escape character, you can use the Prediction Query Builder to create the query. When you select the value from the dropdown list, the required escape character is inserted for you. For more information, see Create a Singleton Query in the Data Mining Designer.

Example results:

Water Bottle28660.1926204720.175205052
Patch kit21130.1420122320.132389356
Mountain Tire Tube19920.1338799650.125304948
Road Tire Tube15880.1067276030.101229538
Cycling Cap14730.0989985890.094256014
Fender Set - Mountain14150.0951004770.090718432
Mountain Bottle Cage13670.0918744540.087780332
Road Bottle Cage11950.0803145370.077173962

The BottomSum function takes the results of this query and returns the rows with the lowest values that sum to the specified count.

    Predict([Association].[v Assoc Seq Line Items],INCLUDE_STATISTICS,10),  
(SELECT (SELECT 'Women''s Mountain Shorts' as [Model]) AS [v Assoc Seq Line Items]) AS t  

The first argument to the BottomSum function is the name of a table column. In this example, the nested table is returned by calling the Predict function and using the INCLUDE_STATISTICS argument.

The second argument to the BottomSum function is the column in the nested table that you use to order the results. In this example, the INCLUDE_STATISTICS option returns the columns $SUPPORT, $PROBABILTY, and $ADJUSTED PROBABILITY. This example uses $PROBABILITY to return rows that sum to at least 50% probability.

The third argument to the BottomSum function specifies the target sum, as a double. To get the rows for the lowest-count products that sum to 10 percent probability, you type .1.

Example results:

Road Bottle Cage11950.08…0.07…
Mountain Bottle Cage13670.09…0.08…

Note This example is provided only to illustrate the usage of BottomSum. Depending on the size of your data set, this query might take a long time to run.

Functions (DMX)
General Prediction Functions (DMX)
BottomPercent (DMX)

Community Additions