OrderCuts (FPScript)

21.09.2021

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:

Konstante

Bedeutung

ORDERCUTS_ORDER_IS_Z

Die Ordnungen werden spaltenweise extrahiert (d.h. die Ordnungskomponente des Ordnungsspektrums entspricht der Z-Komponente).

ORDERCUTS_ORDER_IS_X

Die Ordnungen werden zeilenweise extrahiert (d.h. die Ordnungskomponente des Ordnungsspektrums entspricht der X-Komponente).

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:

Konstante

Bedeutung

ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH

Die einzelnen Ordnungslinien werden ohne Bandbreite aus dem Ordnungsspektrum extrahiert.

ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH

Die einzelnen Ordnungslinien werden aus dem Ordnungsspektrum als Maximum im spezifizierten Ordnungsband berechnet.

ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH

Die einzelnen Ordnungslinien werden aus dem Ordnungsspektrum leistungskorrekt (energieerhaltend) im spezifizierten Ordnungsband berechnet (Wurzel der Quadratsumme im Ordnungsband). Diese Wahl ist nur dann physikalisch sinnvoll, wenn das vorliegende Ordnungsspektrum mit Spektrumtyp "RMS-Amplitude" und leistungsnormierter Fensternormierung berechnet wurde.

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:

Konstante

Bedeutung

ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES

Die ausgeschnittenen Ordnungslinien werden als Signalreihe zurückgegeben.

ORDERCUTS_RESULTSTRUCTURE_LIST

Die ausgeschnittenen Ordnungslinien werden als Liste zurückgegeben.

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

HarmonicRemovalFilter-Funktion

Option Ordnungsanalyse

Analyseobjekt Umdrehungssynchrone Ordnungsanalyse

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren