OrderCuts (FPScript)
Schneidet Ordnungsverläufe (ggf. durch RMS- oder Maximumsberechnung in einem Linienband) aus einem Ordnungsspektrum aus.
Syntax
OrderCuts(OrderSpectrum, Orders, [ OrderComponent = ORDERCUTS_ORDER_IS_X ], [ ExtractionMode = ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH ], [ LeftBandwidth = 0.125 ], [ RightBandwidth = 0.125 ], [ ResultStructure = ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES ] [ , ListNames ])
Die Syntax der OrderCuts-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||
---|---|---|---|---|---|---|---|---|---|
OrderSpectrum |
Das Ordnungsspektrum (d.h. Signalreihe mit Z-Komponente, welche auf der X- oder Z-Komponenten die Ordnungen enthält), aus derer einzelne Ordnungslinien in vertikaler bzw. horizontaler Richtung extrahiert werden sollen. Erlaubte Datenstrukturen sind Signalreihe. Es sind alle numerischen Datentypen erlaubt außer Kalenderzeit und Zeitspanne. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||
Orders |
Die Ordnungen, die extrahiert werden sollen. Erlaubte Datenstrukturen sind Datenreihe. Es sind alle reellen Datentypen erlaubt außer Wahrheitswert, Kalenderzeit und Zeitspanne. Ungültige Werte sind in diesem Argument nicht zulässig. |
||||||||
OrderComponent |
Komponentenangabe des Ordnungsspektrums, welche die Ordnungen enthält. Bestimmt daher die Richtung, in der die Linien aus dem Ordnungsspektrum ausgeschnitten werden. Das Argument OrderComponent kann folgende Werte haben:
Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert ORDERCUTS_ORDER_IS_X gesetzt. |
||||||||
ExtractionMode |
Bestimmt, ob die einzelnen Ordnungslinien ohne Bandbreite extrahiert oder durch RMS- bzw. Maximumsberechnung in einem Linienband berechnet werden sollen. Das Argument ExtractionMode kann folgende Werte haben:
Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH gesetzt. |
||||||||
LeftBandwidth |
Die linksseitigen Ordnungsbandbreiten zur Extraktion und Berechnung der einzelnen Ordnungsverläufe. Das Argument wird nur berücksichtigt, wenn ExtractionMode als ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH oder ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH angegeben wurde. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt außer Wahrheitswert, Kalenderzeit und Zeitspanne. Ungültige Werte sind in diesem Argument nicht zulässig. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 0,125 gesetzt. |
||||||||
RightBandwidth |
Die rechtsseitigen Ordnungsbandbreiten zur Extraktion und Berechnung der einzelnen Ordnungsverläufe. Das Argument wird nur berücksichtigt, wenn ExtractionMode als ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH oder ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH angegeben wurde. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt außer Wahrheitswert, Kalenderzeit und Zeitspanne. Ungültige Werte sind in diesem Argument nicht zulässig. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 0,125 gesetzt. |
||||||||
ResultStructure |
Bestimmt die Ergebnisstruktur der ausgeschnittenen Ordnungslinien. Das Argument ResultStructure kann folgende Werte haben:
Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES gesetzt. |
||||||||
ListNames |
Eine Datenreihe mit mehreren Elementnamen oder eine Liste, aus der die Elementnamen entnommen werden sollen. Wenn Sie das Argument weglassen oder zu wenig Namen angeben, werden automatische Elementnamen aus den auszuschneidenden Ordnungen gebildet. Erlaubte Datenstrukturen sind Datenreihe und Liste. Unterstützte Datentypen sind Zeichenkette. |
Anmerkungen
Die Funktion wird insbesondere verwendet zur Extraktion der Ordnungsverläufe aus einem Ordnungsspektrum.
Verfügbarkeit
Option Ordnungsanalyse
Beispiele
OrderCuts(orderspectrum, {4, 11, 25, 27}, ORDERCUTS_ORDER_IS_Z, ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH)
Extrahiert 4 Ordnungen aus einem Ordnungsspektrum (ohne Bandbreite). Das Ergebnis wird als Signalreihe zurückgegeben, die auf der Z-Komponenten die angegebenen Ordnungen 4, 11, 25 und 27 enthält.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2)
Extrahiert aus einem Ordnungsspektrum 3 Ordnungslinien an den Ordnungen 1, 1.5, und 2. Hierbei werden die ausgeschnittenen Linien energieerhaltend in den Bändern [0.8, 1.2], [1.3, 1.7] und [1.8, 2.2] berechnet (Wurzel der Quadratsumme im Ordnungsband). Dieser Modus ist nur dann sinnvoll, wenn das Ordnungsspektrum mit Spektrumtyp "RMS-Amplitude" und leistungsnormierter Fensternormierung berechnet wurde. Die Linien werden als Signalreihe zurückgegeben.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2, ORDERCUTS_RESULTSTRUCTURE_LIST)
Entspricht dem vorherigen Beispiel mit dem Unterschied, dass die Ordnungsverläufe nun als Liste ausgegeben werden. Die Listenelementnamen lauten "Order 1", "Order 1.5" und "Order 2".
Siehe auch
RevolutionSyncSampling-Funktion