Recorta las órdenes (posiblemente por cálculo RMS o máximo en una banda líneal) de un espectro de órdenes.
Sintaxis
OrderCuts(OrderSpectrum, Orders, [ OrderComponent = ORDERCUTS_ORDER_IS_X ], [ ExtractionMode = ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH ], [ LeftBandwidth = 0.125 ], [ RightBandwidth = 0.125 ], [ ResultStructure = ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES ] [ , ListNames ])
La sintaxis de la función OrderCuts consta de los siguientes elementos:
Parte |
Descripción |
||||||||
|---|---|---|---|---|---|---|---|---|---|
OrderSpectrum |
El espectro de órdenes (es decir, la serie de señales con componente Z que contiene las órdenes en el componente X o Z), del que se extraerán líneas de orden individuales en dirección vertical u horizontal. Las estructuras de datos permitidas son Serie de señales. Se permiten todos los tipos de datos numéricos excepto Tiempo de calendario y Intervalo de tiempo. 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. |
||||||||
Orders |
Las órdenes que deben extraerse. Las estructuras de datos permitidas son Serie de datos. Se permiten todos los tipos de datos reales excepto Valor booleano, Tiempo de calendario y Intervalo de tiempo. No se permiten valores inválidos en este argumento. |
||||||||
OrderComponent |
Especificación del componente del espectro de órdenes que contiene las órdenes. Por tanto, determina la dirección en la que se recortan las líneas del espectro de órdenes. El argumento OrderComponent puede tener los siguientes valores:
Se establece el valor predeterminado ORDERCUTS_ORDER_IS_X si no se especifica el argumento. |
||||||||
ExtractionMode |
Determina si las líneas de orden individuales deben extraerse sin ancho de banda o calcularse mediante cálculo RMS o máximo en una banda de línea. El argumento ExtractionMode puede tener los siguientes valores:
Se establece el valor predeterminado ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH si no se especifica el argumento. |
||||||||
LeftBandwidth |
Los anchos de banda de orden del lado izquierdo para extraer y calcular las órdenes individuales. El argumento solo se tiene en cuenta si se ha especificado ExtractionMode como ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH o ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales excepto Valor booleano, Tiempo de calendario y Intervalo de tiempo. No se permiten valores inválidos en este argumento. Se establece el valor predeterminado 0,125 si no se especifica el argumento. |
||||||||
RightBandwidth |
Los anchos de banda de orden del lado derecho para extraer y calcular las órdenes individuales. El argumento solo se tiene en cuenta si se ha especificado ExtractionMode como ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH o ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales excepto Valor booleano, Tiempo de calendario y Intervalo de tiempo. No se permiten valores inválidos en este argumento. Se establece el valor predeterminado 0,125 si no se especifica el argumento. |
||||||||
ResultStructure |
Determina la estructura resultante de las líneas de orden de corte. El argumento ResultStructure puede tener los siguientes valores:
Se establece el valor predeterminado ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES si no se especifica el argumento. |
||||||||
ListNames |
Una serie de datos con varios nombres de elementos o una lista de la que deben tomarse los nombres de los elementos. Si se omite el argumento o se especifican muy pocos nombres, se forman automáticamente nombres de elementos a partir de las órdenes que se van a recortar. Las estructuras de datos permitidas son Serie de datos y Lista. Los tipos de datos permitidos son Cadena. |
Notas
La función se utiliza en particular para extraer las progresiones de orden de un espectro de órdenes.
Disponibilidad
Opción Análisis de órdenes
Ejemplos
OrderCuts(orderspectrum, {4, 11, 25, 27}, ORDERCUTS_ORDER_IS_Z, ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH)
Extrae 4 órdenes de un espectro de órdenes (sin ancho de banda). El resultado se devuelve como una serie de señales que contiene las órdenes especificadas 4, 11, 25 y 27 en es componente Z.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2)
Extrae 3 líneas de orden de un espectro de orden en las órdenes 1, 1,5 y 2. Las líneas de corte se calculan en las bandas [0.8, 1.2], [1.3, 1.7] y [1.8, 2.2] de forma que se preserva la energía (raíz de la suma de cuadrados en la banda de orden). Este modo solo es útil si el espectro de órdenes se ha calculado con el tipo de espectro "Amplitud RMS" y una función de ventana normalizada en potencia. Las líneas se devuelven como una serie de señales.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2, ORDERCUTS_RESULTSTRUCTURE_LIST)
Corresponde al ejemplo anterior con la diferencia de que ahora las órdenes se emiten como una lista. Los nombres de los elementos de lista son "Order 1", "Order 1.5" y "Order 2".
Véase también
Función RevolutionSyncSampling
Objeto de análisis Análisis de órdenes síncronas de revolución