TransformPart - escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 13 min. de leitura

    • . TransformPart A API 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 o. TransformPart classe, use sn_clotho identificador de namespace.

    Não há construtor para esta classe. Objetos TransformPart são retornados por muitos Transformador e. TransformPart métodos.

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

    A ordem TransformPart os métodos são chamados é importante.
    • Você deve ligar para métrica () método antes de chamar um método de transformação.
    • Não é possível usar métrica () ou GroupBy() métodos após chamar um método de transformação.
    • Transformações intermediárias não são retornadas em um resultado, a menos que coletar() o método é 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 de MetricBase aplicação.

    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 a série de métricas selecionada 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 numérica)

    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 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 como 0 para contar - 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 numérico)

    Substitua o valor em qualquer carimbo de data/hora 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 - 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 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 (constante numérica)

    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 - filtro (agregador de objeto, 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 do MetricBase .
    duração Objeto Período de tempo 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 (andar numérico)

    Substitua o valor em qualquer carimbo de data/hora 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 uma série composta pelo valor que a porcentagem especificada de valores está abaixo. 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 no 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á 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 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()

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

    . coletar() o método deve ser chamado antes de executar() e executar() o método deve ser chamado antes de chamar GetResult() método.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    TransformResult 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 (campo de cadeia de caracteres)

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

    Nota:
    . GroupBy() o método 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 pela qual agrupar os resultados da transformação.
    Tabela 24. Retornos
    Tipo Descrição
    TransformPart . TransformPart objeto que pode ser usado para especificar características de transformação.

    O exemplo a seguir mostra como agrupar métricas médias de altitude 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 - Interpolar (Contagem de objetos)

    Crie um valor de dados para um item de dados NaN interpolando 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 um valor não NaN. Se um valor não NaN não for encontrado, 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
    • Escala de IQR, abaixo de Q1-1.5IQR, ou acima de Q3-1.5IQR
    • P1, 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 Vários 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 de 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 contenha 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 e 1) para um carimbo de data/hora será a mediana. Se n for par, a média dos valores (n / 2) e (n / 2 mais 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 - métrica (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. . métrica () o método 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 multiplicar o valor de cada carimbo de data/hora.
    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 GlideDateTime, base 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 formatada ISO 8601 A duração do intervalo.
    base GlideDateTime ou uma cadeia de caracteres formatada 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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - reamostrar(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, será calculada a média de vários valores. 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 os pontos de dados existentes.

    Você pode usar nova amostra () método 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 - reamostrar(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á redimensionada 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 - reamostrar (agregador de cadeia de caracteres, números de valores)

    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 nova amostra () método 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 for maior do que o número de valores nos dados do período solicitado, interpolar() é usado para adicionar valores entre pontos existentes para atingir o número solicitado de valores.
    Tabela 52. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

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

    Especifique um agregador a ser usado para criar um conjunto de resultados durante a 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 minutos e. Reamostragem(AVG, new GlideDuration("1:00")) chamado, 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 intervenientes.

    Você pode usar nova amostra () método 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. Retornos
    Tipo Descrição
    TransformPart Um objeto TransformPart que pode ser usado para especificar características de transformação.

    TransformPart - arredondar (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 contenha 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 - soma()

    Agregue a série de métricas selecionada em uma série que contém a soma de todos os valores de 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 numérica)

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