TransformPart - com escopo, global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 13 min. de leitura

    • A API TransformPart fornece métodos para especificar detalhes da transformação a ser feita.

    Você pode chamar esta 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 objetos TransformPart 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(constante numérica)

    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. Retornos
    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 - inferior (contagem de números)

    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 a contagem - 1.
    Tabela 6. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - ceil (teto de número)

    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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - coletar ()

    Marque esta transformação para coleta.

    Por padrão, as transformações que fazem parte de uma cadeia, mas não a última transformação, não são coletadas. 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 a série de métricas selecionada 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 dividir o valor de cada carimbo de data/hora.
    Tabela 14. Retornos
    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 definições dessas opções, consulte Transformações de MetricBase.
    duração Objeto Período da série.
    Tabela 16. Retornos
    Tipo Descrição
    TransformPart Objeto TransformPart que você pode usar para especificar características de transformação.

    TransformPart - andar (Número andar)

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

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

    TransformPart - fractiles (frações de matriz)

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

    O valor em um carimbo de data/hora em uma série retornada é o valor no qual a parte especificada das amostras para esse carimbo de data/hora está abaixo. Por exemplo, se a fracçã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. Retornos
    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 fracçã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
    Resultado da transformação Contém os resultados de 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 campo)

    Especifique um campo pelo qual os dados serão agrupados. 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 agrupar os resultados da transformação.
    Tabela 24. Retornos
    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 não NaN não for encontrado, o NaN será usado.
    Tabela 26. Retornos
    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
    • Q1, 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 - rótulo (rótulo de cadeia de caracteres)

    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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - limite (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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - log (base numérica)

    Execute um logaritmo no valor em 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. Retornos
    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 (métrica de cadeia de caracteres)

    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. Retornos
    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 para 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 (constante numérica)

    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 o valor de cada carimbo de data/hora será multiplicado.
    Tabela 44. Retornos
    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)

    Particione a série em intervalos da 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 1º dia do mês mais recente.
    Tabela 46. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample (contagem de números)

    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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - resample (Número mínimo, Número máximo)

    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 isso se encaixar entre o mínimo e o máximo especificados, cada série será amostrada novamente 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. Retornos
    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, 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.
    numValues 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 do período solicitado, interpolate() é usado para adicionar valores entre pontos existentes para atingir o número de valores solicitado.
    Tabela 52. Retornos
    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 for armazenada em um intervalo de 1 minuto e resample(AVG, new GlideDuration("1:00")) for 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 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 de tempo do conjunto de resultados.
    Tabela 54. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - Round (precisão numérica)

    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. Retornos
    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 de valores para 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 de 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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - sum()

    Agregue a série de métricas selecionada 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 (contagem de números)

    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 a contagem - 1.
    Tabela 64. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.