Top - 图表函数
Top() 用于评估表格中列段数据第一(顶部)行的表达式。要计算的行取决于 offset 值,如果存在,则默认计算顶行。对于除表格以外的图表,Top() 用于计算图表的等效垂直表中当前列的第一行的值。
语法:
Top([TOTAL] expr [ , offset [,count
]])
返回数据类型: 双
参数
expr
|
表达式或字段包含要度量的数据。 |
offset
|
指定 n 的 offset 大于 1 后,将表达式评估向下移到顶行下面的 n 行。
指定负偏移量数值后,使 Top 函数效果类似于具有相应正偏移量数值的 Bottom 函数。
|
count
|
通过指定第三个参数 count 大于 1,函数将返回一连串 count 值,每个值对应当前列段数据的最后一个 count 行中的一行。 此时,可以将该函数用作任何特殊范围函数的参数。 范围函数 |
TOTAL
|
如果表格是单维度或如果将 TOTAL 限定符用作参数,则当前列段数据总是与整列相等。
定义聚合范围
|
信息注释列段数据是指按当前排序顺序拥有与维度相同的值的连续单元格子集。内部记录图表函数在列段数据中进行计算,不包括等效垂直表图表中的最右侧维度。如果图表中只有一个维度,或者如果已指定 TOTAL 限定符,则计算整个表格中的表达式。
信息注释如果表格或表格等同物有多个垂直维度,当前列段数据将只包括值与所有维度列的当前行相同的行,但按内部字段排序显示最后维度的列除外。
限制:
示例:图表表达式
Top( Sum(Sales) )
|
返回表中列段的第一行(顶部)Sales 的值。 |
示例 - Top 基本原理
概览
打开数据加载编辑器,并将下面的加载脚本添加到新部分。
加载脚本包含:
-
加载到名为 Example 的数据表中的数据集。
-
数据表中有以下字段:
加载脚本
Example:
LOAD * INLINE [
Year, Sales
2019, 1000
2020, 1500
2021, 1200
2022, 1800
2023, 1700
];
结果
加载数据并打开工作表。创建新表并将该字段添加为维度:
创建以下度量:
-
=Sum(Sales),用于查找年销售额。
-
=Top(Sum(Sales)),用于查找第一年的销售额值,即表中列的第一(顶部)行。
-
=Sum(Sales) - Top(Sum(Sales)),用于计算当前行的 Sales 值与列的第一(顶部)行的值之间的差异。
-
=Sum(Sales)-Top(Sum(Sales), 3),用于计算当前行的销售额值与从上到下第三行的值之间的差异。
-
=(Sales - Top(Sales)) / Top(Sales),用于和第一行相比以比率/百分比返回 Sales 的变化。 要将此值显示为百分比,可在数字格式设定下选择数字 > 简单格式 > 12.34%。
按升序对表格在维度 Year 上进行排序。
结果表
Year |
Sum(Sales) |
Top(Sum(Sales)) |
Sum(Sales) - Top(Sum(Sales)) |
Sum(Sales)-Top(Sum(Sales), 3) |
(Sales - Top(Sales)) / Top(Sales) |
Totals | 7200 | 1000 | 6200 | 6000 | - |
2019 |
1000 |
1000 |
0 |
-200 |
0.00% |
2020 | 1500 | 1000 | 500 | 300 | 50.00% |
2021 | 1200 | 1000 | 200 | 0 | 20.00% |
2022 | 1800 | 1000 | 800 | 600 | 80.00% |
2023 | 1700 | 1000 | 700 | 500 | 70.00% |
查看结果后,您可以将当前期间的 Sales 值与顶部(或第一)期间进行比较。
-
Sum(Sales) - Top(Sum(Sales)) 度量值返回 Sales 值中的变化,将当前期间与第一期间进行比较。
-
Sum(Sales)-Top(Sum(Sales), 3) 度量返回当前行 Sales 的总和减去从顶部开始的第三期间的值。
-
=(Sales - Top(Sales)) / Top(Sales) 度量以百分比形式返回与第一期间相比 Sales 的变化。
提示注释此函数也可以用于图表(如条形图),但不能用于表格。
执行以下操作:
创建条形图,然后将此字段添加为维度:
创建以下度量:
显示 Top 函数结果的条形图
在条形图中使用 Top 函数,可以直观地比较当前期间销售额与顶部(或第一)期间销售额之间的差异。
示例 – Top 场景
概览
打开数据加载编辑器,并将下面的加载脚本添加到新部分。
加载脚本包含:
-
加载到名为 Example 的数据表中的数据集。
-
数据表中有以下字段:
-
OrderID
-
Product
-
SalesValue
-
OrderDate
加载脚本
Example:
LOAD * INLINE [
OrderID, Product, SalesValue, OrderDate
1, "Product A", 500, '2023-01-10'
2, "Product B", 300, '2023-01-15'
3, "Product C", 450, '2023-02-01'
4, "Product D", 700, '2023-02-20'
5, "Product E", 350, '2023-03-05'
];
结果
加载数据并打开工作表。创建新表并将该字段添加为维度:
创建以下度量:
-
=RangeAvg(Top(Sum(SalesValue),1,3)),用于返回最上面三行的平均值。
-
=Sum(SalesValue) - RangeAvg (Top(Sum(SalesValue),1,3)),用于计算当前行与最上面三行平均值之间的差异。
-
=Sum(SalesValue),用于计算当前行的总计 SalesValue。
结果表
Product |
RangeAvg(Top(Sum(SalesValue),1,3)) |
Sum(SalesValue) - RangeAvg (Top(Sum(SalesValue),1,3)) |
Sum(SalesValue) |
Totals | 416.67 | 1883.33 | 2300 |
2019 |
416.67 |
83.33 |
500 |
2020 | 416.67 | --116.67 | 300 |
2021 | 416.67 | 33.33 | 450 |
2022 | 416.67 | 283.33 | 700 |
2023 | 416.67 | -66.67 | 350 |
结果显示了如何使用 RangeSum 和 Top 函数的组合来分析和比较销售额值。
示例 - 使用 Top 的图表表达式
概览
打开数据加载编辑器,并将下面的加载脚本添加到新部分。
加载脚本包含:
加载脚本
Monthnames:
LOAD *, Dual(MonthText,MonthNumber) as Month INLINE [
MonthText, MonthNumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
Crosstable (MonthText, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
结果
加载数据并打开工作表。创建新表并将该字段添加为维度:
创建以下度量:
-
=Sum(Sales),用于计算销售额的总和。
-
=Top(Sum(Sales)),用于显示顶部行 Customer 的销售额总和。
-
=Sum(Sales)+Top(Sum(Sales)),用于将当前 Customer 的 Sum(Sales) 值与顶部行中的 Customer 相加。
-
=Sum(Sales)+Top(Sum(Sales), 3),用于将当前 Customer 的 Sum(Sales) 值与从顶部行起第三行的 Customer 的值相加。
结果表
Customer |
Sum(Sales) |
Top(Sum(Sales)) |
Sum(Sales)+Top(Sum(Sales)) |
Sum(Sales)+Top(Sum(Sales), 3) |
Totals | 2566 | 587 | 3153 | 3249 |
Astrida |
587 |
587 |
1174 |
1270 |
Betacab | 539 | 587 | 1126 | 1222 |
Canutilty | 683 | 587 | 1270 | 1366 |
Divadip | 757 | 587 | 1344 | 1440 |
度量 Top(Sum(Sales)) 返回所有行的 587,因为这是顶部行的值:Astrida。
对于度量 Sum(Sales)+Top(Sum(Sales)),行 Betacab 返回 1126,这是将 Betacab 和 Astrida 的 Sum(Sales) 值,和顶部行中 Customer 相加的结果。
对于度量 Sum(Sales)+Top(Sum(Sales), 3),参数 offset 设置为 3。该表达式将当前行的 Sum(Sales) 值和从顶部开始的第三行 Canutility 相加。例如,客户Divadip 会返回1440 的值。这是 Divadip 的 Sum(Sales) 值和 Canutility 的 SumSales 相加的结果 (757+683)。