TransformPart - com escopo, global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 13 min. de leitura

    • Use a classe TransformPart para especificar detalhes da transformação a ser feita.

    Você pode chamar essa classe em scripts de servidor com escopo e globais. Ao usar a classe TransformPart, use o identificador de namespace sn_clotho.

    Não há nenhum construtor para esta classe. Os objetosTransformPart são retornados por muitos métodos Transformer e TransformPart.

    Os métodos desta classe definem as transformações a serem feitas. A transformação real é feita quando o método execute() é chamado no objeto Transformer.

    A ordem em que os métodos TransformPart são chamados é importante.
    • Você deve chamar o método metric() antes de chamar um método de transformação.
    • Você não pode usar os métodos metric() ou groupBy() depois de chamar um método de transformação.
    • As transformações intermediárias não são retornadas em um resultado, a menos que o método collect() seja chamado para o resultado intermediário desejado.
      // where tp is a TransformPart object
// example 1
tp.avg().add(2);
var tr = tp.execute(); 
// tr contains avg+2, but not avg
 
// example 2
tp.avg().add(2);
tp.avg();
var tr = tp.execute(); 
// tr contains both avg and avg + 2

// example 3
tp.avg().collect().add(2);
var tr = tp.execute(); 
// tr contains both avg and avg + 2

    Esta classe faz parte da aplicação MetricBase.

    TransformPart - add(Number constante)

    Adicione o número especificado ao valor em cada carimbo de data/hora.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    constante Número O número a ser adicionado ao valor em cada carimbo de data/hora.
    Tabela 2. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - avg()

    Agregue as séries de métricas selecionadas em uma série que contém o valor médio de cada carimbo de data/hora.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - Bottom(Number count)

    Crie um conjunto de resultados que, para cada carimbo de data/hora, retorne o número especificado de valores inferiores. Este método resulta em um número de "contagem" de séries. Cada valor retém o rótulo de sua série de origem.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    contagem Número O número de séries a serem retornadas. As séries são rotuladas de 0 para contagem - 1.
    Tabela 6. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - ceil(Número máximo)

    Substitua o valor em qualquer carimbo de data/hora que seja maior que o valor especificado pelo valor especificado.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    teto Número O valor máximo permitido para qualquer carimbo de data/hora.
    Tabela 8. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - collect()

    Marque esta transformação para coleção.

    As transformações que fazem parte de uma cadeia, mas não a última transformação, não são coletadas por padrão. Uma transformação coletada é retornada como parte do resultado da transformação.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - count()

    Agregue as séries de métricas selecionadas em uma série que contém o número de valores para cada carimbo de data/hora.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - div(Number constante)

    Divida o valor em cada carimbo de data/hora pelo número especificado.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    constante Número O número pelo qual o valor de cada carimbo de data/hora será dividido.
    Tabela 14. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - filter (agregador de objetos, duração do objeto)

    Crie uma série usando o agregador especificado para o tempo especificado.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    agregador Objeto Pode ser:
    • MÉDIA
    • CHISQUARE
    • ÚLTIMO
    • MÁX
    • MEDIANA
    • MÍN
    • STDDEV
    Para obter as definições dessas opções, consulte Transformações MetricBase.
    duração Objeto Período da série.
    Tabela 16. Retorna
    Tipo Descrição
    TransformPart Objeto TransformPart que você pode usar para especificar características de transformação.

    TransformPart - andar(Número do andar)

    Substitua o valor em qualquer carimbo de data/hora que seja menor do que o valor especificado pelo valor especificado.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    piso Número O valor mínimo para qualquer carimbo de data/hora.
    Tabela 18. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - stratiles(Matriz de frações)

    Crie séries compostas pelo valor abaixo do qual a porcentagem especificada de valores está. Retorna uma série para cada fração na matriz especificada.

    O valor em um carimbo de data/hora em uma série retornada é o valor abaixo do qual a fração especificada das amostras para esse carimbo de data/hora está abaixo. Por exemplo, se a fração for 0,5, o valor no carimbo de data/hora será o valor em que metade dos valores na série de entrada estão abaixo (mediana).

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    frações Matriz de números As frações a serem usadas na série de entrada.
    Tabela 20. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação. Contém uma série para cada fração especificada. 
    // returns a single series containing the median for each time stamp, which
// means that half a time stamp's values are below the returned value 
fractiles([.5]) 
// returns four series, one series for each of the 25%, 50%, 75%, and 100% quartiles 
fractiles([.25, .5, .75, 1])
// returns the median, 95% percentile, the max value
fractiles([.50, .95, 1])

    TransformPart - getResult()

    Retornar a parte do resultado relevante para esta transformação.

    O método collect() deve ser chamado antes do método execute(), e o método execute() deve ser chamado antes de chamar o método getResult().

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    TransformarResultado Contém os resultados da transformação associados a esta parte da transformação. 
    var t = new sn_clotho.Transformer(drones);
t.metric("mb_demo_mt_altitude");
var avgTform = t.avg();
t.execute();
var avgTformResult = avgTform.getResult();

    TransformPart - groupBy(cadeia de caracteres no campo)

    Especifique um campo para agrupar os dados. Para especificar vários campos, execute chamadas sucessivas individualmente.

    Nota:
    O método groupBy() não pode ser chamado depois que uma transformação foi executada.
    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Assunto: Cadeia de caracteres Nome de um campo na tabela pelo qual os resultados da transformação serão agrupados.
    Tabela 24. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    O exemplo a seguir mostra como agrupar métricas de altitude média por campos de frota e modelo.

    transformer.groupBy("fleet,model").metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');

var transformPart = transformer.groupBy("fleet,model")

transformPart.metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');

    TransformPart - interpolate (contagem de objetos)

    Crie um valor de dados para um item de dados NaN interpolando a partir de valores de dados adjacentes.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    contagem Objeto Especifica o número de amostras de dados em cada direção para verificar se há um valor não NaN. Se um valor diferente de NaN não for encontrado, o NaN será usado.
    Tabela 26. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - iqr()

    Execute uma transformação de intervalo Interquartil.

    Cria um conjunto de resultados de quatro séries.
    • IQR, a mediana de todas as entradas
    • Intervalo de IQR, abaixo de Q1-1.5IQR ou acima de Q3+1.5IQR
    • T1, a mediana da menor metade das entradas
    • T3, a mediana da maior metade das entradas
    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - label(cadeia de caracteres "label")

    Adicione um rótulo para a série resultante.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    rótulo Cadeia de caracteres O rótulo dos resultados da transformação.
    Tabela 30. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - limit(contagem de objetos)

    Retorna no máximo o número especificado de valores, começando no valor não NaN mais recente.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    contagem Objeto Um número de carimbos de data/hora.
    Tabela 32. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - log(Number base)

    Execute um logaritmo no valor de cada carimbo de data/hora em que o resultado é o log da base especificada para o valor do carimbo de data/hora.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    base Número A base para o cálculo do logaritmo.
    Tabela 34. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - max ()

    Retorna uma série com o valor máximo para cada carimbo de data/hora.

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 36. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - mediano ()

    Crie uma série que contém a mediana de valores para cada carimbo de data/hora em um conjunto de séries.

    Se houver n séries no objeto TransformPart, se n for ímpar, o valor (n / 2 + 1) de um carimbo de data/hora será a mediana. Se n for par, a média dos valores (n / 2) e (n / 2 + 1) para um carimbo de data/hora será a mediana.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 38. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - metric(cadeia de caracteres métrica)

    Especifique o campo de métrica a ser usado na transformação.

    Você pode especificar várias métricas a serem usadas na transformação. O método metric() não pode ser chamado depois que a transformação foi executada.

    Tabela 39. Parâmetros
    Nome Tipo Descrição
    métrica Cadeia de caracteres Nome do campo de métrica.
    Tabela 40. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - min ()

    Retorna uma série com o valor mínimo de cada carimbo de data/hora.

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 42. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - mul(Number constante)

    Multiplique o valor em cada carimbo de data/hora pelo número especificado.

    Tabela 43. Parâmetros
    Nome Tipo Descrição
    constante Número O número pelo qual multiplicar o valor de cada carimbo de data/hora.
    Tabela 44. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - partição (agregador de cadeia de caracteres, duração de GlideDateTime, base de GlideDateTime)

    Divida a série em intervalos de mesma duração.

    Tabela 45. Parâmetros
    Nome Tipo Descrição
    agregador Cadeia de caracteres O agregador a ser usado. Pode ser mínimo, máximo, médio ou último.
    duração GlideDateTime ou uma cadeia de caracteres no formato ISO 8601 A duração do intervalo.
    base GlideDateTime ou uma cadeia de caracteres no formato ISO 8601 O deslocamento zero para particionamento. Por exemplo, se você particionar por dia (24h), defina a base como segunda-feira à meia-noite no seu fuso horário. Se você particionar por 30 dias, defina a base como o primeiro dia do mês mais recente.
    Tabela 46. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample(Number count)

    Especifique o número de pontos de dados a serem incluídos no resultado.

    Alinha uma série com um número fixo de pontos de dados no intervalo fornecido. Se a série original tiver mais pontos de dados do que o especificado, a média de vários valores será calculada. Se a série original tiver menos pontos de dados do que o especificado, os pontos de dados serão adicionados interpolando pontos de dados entre pontos de dados existentes.

    Você pode usar o método resample() para reduzir o número de amostras no resultado para corresponder mais ao número de amostras que serão exibidas.

    Tabela 47. Parâmetros
    Nome Tipo Descrição
    contagem Número O número de amostras a serem incluídas no resultado.
    Tabela 48. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample(Number min, Number max)

    Especifique o número mínimo e máximo de amostras a serem incluídas no resultado.

    Este método é útil quando você está mostrando séries com diferentes períodos de tempo (granularidades).

    Este método determina o número médio de pontos por série e, se ele se ajustar entre o mínimo e o máximo especificados, cada série será reamostrada para esse número médio de pontos. Se a média calculada for maior que o máximo especificado ou menor que o mínimo especificado, o máximo ou mínimo especificado será usado.

    Tabela 49. Parâmetros
    Nome Tipo Descrição
    mín Número O número mínimo de amostras a serem incluídas no resultado. Se não houver amostras suficientes disponíveis, a interpolação será usada para criar amostras.
    máx. Número O número máximo de amostras a serem incluídas no resultado.
    Tabela 50. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample(cadeia de caracteres agregador, Number numValues)

    Especifique um agregador a ser usado para criar um conjunto de resultados do tamanho especificado. O agregador pode ser LAST, AVG, MIN ou MAX.

    Você pode usar o método resample() para reduzir o número de amostras no resultado para corresponder mais ao número de amostras que serão exibidas.

    Tabela 51. Parâmetros
    Nome Tipo Descrição
    agregador Cadeia de caracteres Pode ser LAST, AVG, MIN ou MAX.
    valores numéricos Número O número de amostras a serem incluídas no conjunto de resultados.

    Quando o número de valores solicitados é maior do que o número de valores nos dados para o período solicitado, interpolate() é usado para adicionar valores entre pontos existentes para atingir o número de valores solicitado.
    Tabela 52. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample (agregador de cadeia de caracteres, duração de GlideDuration)

    Especifique um agregador a ser usado para criar um conjunto de resultados ao longo da duração especificada. O agregador pode ser LAST, AVG, MIN ou MAX.

    Reamostra os dados subjacentes para o período solicitado.
    • Quando a série temporal é armazenada em um intervalo de 1 minuto e resample(AVG, new GlideDuration("1:00")) é chamada, o resultado terá um ponto de dados a cada hora, refletindo a média dos 60 valores anteriores.
    • Quando o período solicitado é menor do que o período dos dados, a interpolação é usada para calcular os pontos de dados intermediários.

    Você pode usar o método resample() para reduzir o número de amostras no resultado para corresponder mais ao número de amostras que serão exibidas.

    Tabela 53. Parâmetros
    Nome Tipo Descrição
    agregador Cadeia de caracteres Pode ser LAST, AVG, MIN ou MAX.
    duração GlideDuration O período do conjunto de resultados.
    Tabela 54. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - round(precisão de número)

    Arredonde o valor em cada carimbo de data/hora para a precisão especificada.

    Executa este cálculo em cada valor.
    (v / precision) * precision
    Tabela 55. Parâmetros
    Nome Tipo Descrição
    precisão Número O valor a ser usado no cálculo de arredondamento.
    Tabela 56. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - stddev()

    Crie uma série que contém o desvio padrão dos valores de cada carimbo de data/hora em um conjunto de séries.

    Tabela 57. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 58. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - sub(constante do objeto)

    Subtraia o número especificado do valor em cada carimbo de data/hora.

    Tabela 59. Parâmetros
    Nome Tipo Descrição
    constante Objeto O número a ser subtraído do valor em cada carimbo de data/hora.
    Tabela 60. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - sum()

    Agregue as séries de métricas selecionadas em uma série que contém a soma de todos os valores para cada carimbo de data/hora.

    Tabela 61. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 62. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - top(Number count)

    Crie um conjunto de resultados que, para cada carimbo de data/hora, retorne o número especificado de valores principais. Este método resulta em um número de "contagem" de séries. Cada valor retém o rótulo de sua série de origem.

    Tabela 63. Parâmetros
    Nome Tipo Descrição
    contagem Número O número de séries a serem retornadas. As séries são rotuladas de 0 para contagem - 1.
    Tabela 64. Retorna
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.