Funções de compartimentalização

O Binning é uma forma de agrupar um número de valores contínuos maiores ou menores para um número menor de "compartimentos".


Função	Descrição
`AutoBinNumeric`	Tenta agrupar os valores da coluna especificada no número definido de compartimentos. No entanto, pode haver mais ou menos compartimentos do que o número definido, pois o método sempre resultará em compartimentos com limites que são fáceis de ler (com a maior quantidade de possível de números pares). O primeiro argumento é a coluna a ser compartimentada, enquanto o segundo é o número de compartimentos pretendido. Exemplo: `AutoBinNumeric([Column], 10)`
`BinByDateTime`	Agrupa os valores em compartimentos com base em uma hierarquia de data natural, data/hora ou tempo. O primeiro argumento é a coluna `Data`, `Hora` ou `DateTime` para armazenar. O segundo argumento é a definição dos níveis na hierarquia. Os níveis da hierarquia devem ser escritos na forma de caracteres que contenham as partes da data desejada, separadas por pontos, por exemplo, "`Year.Quarter.Month`". O terceiro argumento é o nível de poda que especifica o nível da hierarquia para exibir. Se você escreve uma expressão customizada com base em uma expressão `BinByDateTime`, você vê um seletor de coluna com todos os níveis da hierarquia especificada disponível, mas com o identificador do cursor da hierarquia posicionado no nível de poda especificado. Os argumentos válidos para Arg2 são combinações de: '`year`' ou '`yy`' - O ano. '`quarter`' ou '`qq`' - O trimestre. '`month`' ou '`mm`' - O mês. '`day of year`' ou '`dy`' - O dia do ano. '`day`' ou '`dd`' - O dia. '`week`' ou '`wk`' - A semana. '`day of week`' or '`dw`' - O dia da semana. '`hour`' ou '`hh`' - A hora. '`minute`' ou '`mi`' - O minuto. '`second`' ou '`ss`' - O segundo. '`millisecond`' ou '`ms`' - O milissegundo. Como alternativa, Arg2 também pode ser uma combinação de: '`isoyear`' - O ano de numeração de semana ISO 8601. '`isoweek`' - O número da semana ISO 8601. Exemplos: `BinByDateTime([Column],"Ano.Trimestre.Mês.Dia",2)` Para obter uma coluna de dados chamada de Data do Pedido, a expressão acima resultaria no seletor de coluna e no seletor de hierarquia mostrado abaixo quando usados em uma expressão customizada: O nível de remoção 0 defini o identificador do cursor para a posição do "ano", 1 significa o trimestre, 2 o mês e 3 o dia. `BinByDateTime([Column],"ISOYear.ISOWeek",1)` Para usar binning de acordo com a ISO 8601 para uma coluna de data, use as partes de data `isoyear` e `isoweek` em vez das partes normais de `ano` e `semana`.
`BinByEvenDistance`	Agrupa os valores na coluna especificada para que haja uma distância uniforme entre todos os compartimentos. O primeiro argumento é a coluna a ser compartimentada, enquanto o segundo é o comprimento do intervalo. O terceiro argumento (opcional) especifica onde iniciar a contagem. Se nenhum argumento inicial for especificado, o primeiro compartimento começará em zero. Exemplos: `BinByEvenDistance([Column], 10)` `BinByEvenDistance([Column], 10, 5)`
`BinByEvenDistribution`	Agrupa os valores na coluna especificada para que cada compartimento (grupo) tenha o mesmo número de valores exclusivos que os outros. O último compartimento pode ter valores mais exclusivos do que os outros. O primeiro argumento é a coluna para guardar e o segundo argumento é o número de compartimentos. Valores inválidos darão um resultado inválido. Exemplo: `BinByEvenDistribution([Column], 5)` `BinByEvenDistribution(Rank([Column])*Count() + RowId(), 3)`
`BinByEvenIntervals (Bin por intervalos iguais)`	Agrupa os valores na coluna especificada de forma que o intervalo de valores seja dividido em intervalos iguais. O primeiro argumento é a coluna para guardar e o segundo argumento é o número de compartimentos. Exemplo: `BinByEvenIntervals([Column], 5)`
`BinBySpecificLimits`	Agrupa os valores na coluna especificada por limites definidos para os compartimentos (grupos). O primeiro argumento é a coluna para guardar e os argumentos seguintes são os limites para os compartimentos. Todas as linhas que possuem valores maiores do que o limite maior terão o mesmo valor de compartimento. Valores inválidos darão um resultado inválido. Exemplo: `BinBySpecificLimits([Column], 1, 2, 3, 10)`
`BinByStdDev`	Agrupa os valores em diferentes compartimentos, dependendo da distância entre os valores e a média, medida em desvios padrão. O primeiro argumento é a coluna para guardar e os argumentos seguintes são os números de desvios padrão que exibe a partir da média. Os argumentos de desvio padrão devem ser dados de forma ascendente e todos os valores devem ser positivos. Exemplo: `BinByStdDev([Column], 0.5, 1)` Isso criará um binning para: ≤ -1 desvio padrão -1 desvio padrão -0,5 desvio padrão 0,5 desvio padrão 1 desvio padrão > 1 desvio padrão
`BinBySubstring`	Agrupa os valores em compartimentos com base nos caracteres iniciais ou finais do valor. Isso significa que você pode usar esse método para agrupar todos os valores começando com "A" em um bin, "B" em outro, etc. O primeiro argumento é a coluna `String` para agrupar, e o seguinte é o número de caracteres na substring. Se o segundo argumento for negativo, os subcaracteres começarão a partir do final do valor. Exemplos: `BinBySubstring([Column], 1)` `BinBySubstring([Column], -4)` `BinBySubstring(String([Integer Column]), 1)`
`BinByTimeSpan`	Agrupa os valores em compartimentos com base em uma extensão de tempo. O primeiro argumento é a coluna `TimeSpan` para agrupar. O segundo argumento é a definição do nível de hierarquia escrito na forma de caracteres contendo as partes do período desejadas, separadas por pontos (por exemplo, "`Hours.Minutes`"). O terceiro argumento é um nível de poda com base em zero, o qual especifica o nível da hierarquia a ser exibido. Os argumentos válidos para `Arg2` são combinações de: '`Days`' – Os dias. '`Hours`' – As horas. '`Minutes`' – Os minutos. '`Seconds`' – Os segundos. '`Milliseconds`' – Os milissegundos. Exemplo: `BinByTimeSpan([Column],"Days.Hours.Minutes.Seconds",2)` Para uma coluna `TimeSpan` chamada de Diferença de Tempo, a expressão acima resultaria no seletor de coluna e seletor de hierarquia mostrada abaixo quando usada em uma expressão customizada:
`FiscalBinByDateTime`	Agrupa os valores em compartimentos com base em uma hierarquia de data natural ou de data/hora, com os níveis deslocados de acordo com o número especificado de meses. O primeiro argumento é a coluna `Data` ou `DateTime` para agrupar. O segundo argumento é a definição do nível de hierarquia escrito na forma de caracteres que contêm as partes da data desejada, separadas por pontos (por exemplo, "`Ano.Trimestre.Mês`"). Apenas `Ano`, `Trimestre` e `Mês` são compatíveis. O terceiro argumento é o nível de poda que especifica o nível da hierarquia para exibir. O quarto argumento (opcional) é o número de meses a mudar. Se nenhum quarto for especificado então vai ser usado o valor da propriedade de documento `FiscalYearOffset`. Exemplos: `FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 1, 2)` `FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 2)`

Nota: Se um eixo, o qual usa uma expressão customizada com compartimento, tiver sido configurado como Avaliar a expressão do eixo em: Filtragem atual apenas (aplicável apenas com o cliente Windows), a compartimentação será recalculada com cada filtragem.

Veja tambémFunções.

Exemplo

Considere uma coluna com os seguintes valores:

Se essa coluna for compartimentada com o uso dos métodos de compartimentação abaixo, os limites resultantes serão os seguintes:


Método de classificação	Resultado
`AutoBinNumeric([Column],5)`
`BinByEvenDistance([Column],5)`
`BinByEvenDistribution([Column],5)`
`BinByEvenIntervals([Column],5)`
`BinBySpecificLimits([Column],-2,4,10,16,22)`

Dica: É possível alterar a formatação da coluna para visualizar menos decimais (ou nenhum) no eixo.