Saltar navegación

Documentación de FlexPro 2025

CrestFactor

Calcula el factor de cresta de un conjunto de datos.

Sintaxis

CrestFactor(DataSet, [ Mode = PROCESS_COLUMNS ] [ , IntervalWidth ])

 

La sintaxis de la función CrestFactor consta de los siguientes elementos:

Parte

Descripción

DataSet

El conjunto de datos que se va a evaluar.

Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos numéricos.

En los tipos de datos complejos se calcula un valor absoluto.

Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista.

Mode

Especifica cómo deben procesarse las matrices de datos y las series de señales y si deben determinarse factores de cresta individuales, móviles o de bloque.

El argumento Mode puede tener los siguientes valores:

Constante

Significado

PROCESS_COLUMNS

Las matrices de datos y las series de señales se procesan columna por columna. El resultado es una serie de datos o una señal con un factor de cresta por columna.

PROCESS_ROWS

Las matrices de datos y las series de señales se procesan fila por fila. El resultado es una serie de datos o una señal con un factor de cresta por fila.

PROCESS_COMPLETE

Las matrices de datos y las series de señales se procesan como un todo. El resultado es un valor escalar para todo el conjunto de datos.

... más una constante opcional que determina el método de cálculo:

Constante

Significado

+ CALC_BLOCK

Cálculo bloque por bloque. Se calcula un valor por intervalo.

+ CALC_MOVING

Cálculo móvil. Se determina un resultado en el intervalo especificado para cada valor del conjunto de datos.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Se establece el valor predeterminado PROCESS_COLUMNS si no se especifica el argumento.

IntervalWidth

Este argumento es necesario para determinar los factores de cresta móviles y de bloque. A continuación, el ancho del intervalo especifica el número de valores que se deben tener en cuenta. El ancho debe ser un número impar. De lo contrario, el intervalo es asimétrico y se incluye en el cálculo un valor más a la derecha del centro que a la izquierda.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos enteros.

El valor debe ser mayor o igual que 1.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Notas

El resultado es siempre el tipo de datos En coma flotante de 64 bits.

El factor de cresta de una muestra se define como:

En el caso de señales y series de señales, se procesa el componente Y y, si es posible, se adopta el componente X o Z. Al calcular coeficientes móviles o de bloque, la estructura de datos del resultado corresponde a la del argumento. Si, en cambio, DataSet es una serie de datos o una señal, el resultado es un valor escalar con el factor de cresta requerido; en caso contrario, el resultado es una serie de datos o una señal con un factor de cresta por columna o fila.

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

CrestFactor(Sin(Series(0, 2 * PI, 0.01)))

Devuelve 1.414979831240105. El factor de cresta de una onda senoidal es Sqrt(2).

CrestFactor({ Sin(Series(0, 2 * PI, 0.01)), Sawtooth(Series(0, 2 * PI, 0.01)) })

Devuelve { 1.414979831240105, 1.730172555653944 }. Calcula el factor de cresta de una onda senoidal y una onda de sierra.

Véase también

Función Mean

Objeto de análisis Parámetro estadístico