Coupe les courbes d'ordre (si nécessaire par calcul de la valeur efficace ou du maximum dans une bande de lignes) d'un spectre d'ordre.
Syntaxe
OrderCuts(OrderSpectrum, le Orders, le [ OrderComponent Variable ORDERCUTS_ORDER_IS_X ], le [ ExtractionMode Variable ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH ], le [ LeftBandwidth Variable 0.125 ], le [ RightBandwidth Variable 0.125 ], le [ ResultStructure Variable ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES ] [ , le ListNames ])
La syntaxe de la fonction OrderCuts se compose des éléments suivants :
Section |
Description |
||||||||
---|---|---|---|---|---|---|---|---|---|
OrderSpectrum |
Le spectre d'ordre (c'est-à-dire les séries de signaux avec la composante Z, qui contient les ordres sur la composante X ou Z), à partir duquel les lignes d'ordre individuelles doivent être extraites dans une direction verticale ou horizontale. Les structures de données autorisées sont Série de signaux. Tous les types de données numériques sont autorisés, à l'exception de Temps calendaire et Période de temps. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||
Orders |
Les ordres à extraire. Les structures de données autorisées sont Série de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, le Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. |
||||||||
OrderComponent |
Indication de composante du spectre d'ordre, qui contient les ordres. Détermine donc la direction dans laquelle les lignes sont découpées dans le spectre d'ordre. L'argument OrderComponent peut avoir les valeurs suivantes :
Si l'argument n'est pas spécifié, il est défini à la valeur par défaut ORDERCUTS_ORDER_IS_X . |
||||||||
ExtractionMode |
Détermine si les lignes d'ordre individuelles doivent être extraites sans largeur de bande ou calculées par RMS ou calcul de maximum dans une bande de ligne. L'argument ExtractionMode peut avoir les valeurs suivantes :
Si l'argument n'est pas spécifié, il est défini à la valeur par défaut ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH . |
||||||||
LeftBandwidth |
Les largeurs de bande d'ordre à gauche pour l'extraction et le calcul des différentes progressions d'ordre. L'argument n'est pris en compte que si ExtractionMode comme ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH ou ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH a été spécifié. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, le Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0.125 . |
||||||||
RightBandwidth |
Les largeurs de bande d'ordre à droite pour l'extraction et le calcul des différentes évolutions d'ordre. L'argument n'est pris en compte que si ExtractionMode comme ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH ou ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH a été spécifié. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, le Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0.125 . |
||||||||
ResultStructure |
Détermine la structure de résultat des lignes de coupes d'ordre. L'argument ResultStructure peut avoir les valeurs suivantes :
Si l'argument n'est pas spécifié, il est défini à la valeur par défaut ORDERCUTS_RESULTSTRUCTURE_SIGNALSERIES . |
||||||||
ListNames |
Une série de données avec plusieurs noms d'éléments ou une liste d'où les noms d'éléments doivent être extraits. Si vous omettez l'argument ou si vous indiquez trop peu de noms, des noms d'éléments automatiques sont formés à partir des ordres à découper. Les structures de données autorisées sont Série de données et Liste. Les types de données pris en charge sont Chaîne de caractères. |
Remarques
Cette fonction est notamment utilisée pour extraire des courbes d'ordre d'un spectre d'ordre.
Disponible dans
Option Analyse d'ordre
Exemples
OrderCuts(orderspectrum, {4, 11, 25, 27}, ORDERCUTS_ORDER_IS_Z, ORDERCUTS_EXTRACTIONMODE_WITHOUT_BANDWIDTH)
Extrait 4 ordres d'un spectre d'ordre (sans bande passante). Le résultat est renvoyé sous la forme d'une série de signaux contenant les ordres 4, 11, 25 et 27 indiqués sur la composante Z.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2)
Extrait d'un spectre d'ordre 3 lignes d'ordre aux ordres 1, 1.5, et 2. Ici, les lignes découpées sont calculées en conservant l'énergie dans les bandes [0.8, 1.2], [1.3, 1.7] et [1.8, 2.2] (racine de la somme des carrés dans la bande d'ordre). Ce mode n'est utile que si le spectre d'ordre a été calculé avec le type de spectre "Amplitude RMS" et une normalisation de fenêtre à puissance normalisée. Les lignes sont renvoyées sous forme de série de signaux.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2, ORDERCUTS_RESULTSTRUCTURE_LIST)
Correspond à l'exemple précédent, à la différence que les historiques de classement sont maintenant affichés sous forme de liste. Les noms des éléments de la liste sont "Ordre 1", "Ordre 1.5" et "Ordre 2".
Voir aussi
Fonction RevolutionSyncSampling