OrderCuts (FPScript)
Coupe les courbes d'ordre (si nécessaire par RMS ou calcul du maximum dans une bande de lignes) à partir d'un spectre d'ordre.
Syntaxe
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 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éries de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. |
||||||||
OrderComponent |
Spécification de la composante du spectre d'ordres, qui contient les ordres. Détermine donc la direction dans laquelle les lignes sont coupées du spectre d'ordres. 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 de gauche pour extraire et calculer les courbes d'ordre individuelles. L'argument n'est pris en compte que si ExtractionMode a été spécifié comme ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH ou ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH. Les structures de données autorisées sont Scalaire et Séries de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, 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 de droite pour extraire et calculer les courbes d'ordre individuelles. L'argument n'est pris en compte que si ExtractionMode a été spécifié comme ORDERCUTS_EXTRACTIONMODE_MAXIMUM_IN_BANDWIDTH ou ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH. Les structures de données autorisées sont Scalaire et Séries de données. Tous les types de données réels sont autorisés, sauf Valeur booléenne, 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 dont les noms d'éléments doivent être extraits. Si vous omettez l'argument ou si vous spécifiez trop peu de noms, des noms d'éléments automatiques sont formés à partir des ordres à couper. Les structures de données autorisées sont Séries 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 spécifiés 4, 11, 25 et 27 sur les composantes Z.
OrderCuts(orderspectrum, {1, 1.5, 2}, ORDERCUTS_ORDER_IS_X, ORDERCUTS_EXTRACTIONMODE_RMS_IN_BANDWIDTH, 0.2, 0.2)
Extrait 3 lignes d'ordre d'un spectre d'ordre aux ordres 1, 1,5 et 2. Ici, les lignes de coupe 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 carrée 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 la normalisation de la fenêtre de puissance. Les lignes sont renvoyées comme une 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 courbes d'ordre sont maintenant éditées 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