Correlation (FPScript)

21.09.2021

Détermine la matrice de corrélation d'une matrice de données ou la corrélation de deux ensembles de données.

Syntaxe

Correlation(DataSet)
ou
Correlation(DataSet1, DataSet2 [ , Mode = PROCESS_COLUMNS ])

 

La syntaxe de la fonction Correlation se compose des éléments suivants :

Section

Description

DataSet

Une matrice de données ou une série de signaux pour laquelle une matrice de corrélation doit être calculée.

Les structures de données autorisées sont Matrice de données, Série de signaux et Série de signaux avec composante X bidimensionnelle. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

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.

DataSet1

Le premier ensemble de données à évaluer.

Les structures de données autorisées sont Séries de données, Matrice de données, Signal, Série de signaux et Série de signaux avec composante X bidimensionnelle. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

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.

DataSet2

Le deuxième ensemble de données à évaluer.

Les structures de données autorisées sont Séries de données, Matrice de données, Signal, Série de signaux et Série de signaux avec composante X bidimensionnelle. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

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.

Mode

Précise comment deux matrices de données ou séries de signaux doivent être traitées.

L'argument Mode peut avoir les valeurs suivantes :

Constante

Signification

PROCESS_COLUMNS

Les matrices de données et les séries de signaux sont traitées colonne par colonne. Le résultat est une série de données ou un signal avec une corrélation par colonne de DataSet1 et DataSet2.

PROCESS_ROWS

Les matrices de données et les séries de signaux sont traitées ligne par ligne. Le résultat est une série de données ou un signal avec une corrélation par ligne de DataSet1 et DataSet2.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

Si l'argument n'est pas spécifié, il est défini à la valeur par défaut PROCESS_COLUMNS .

Remarques

Le résultat est toujours du type de données Virgule flottante de 64 bits.

La corrélation de deux échantillons est définie comme suit :

avec les valeurs moyennes

et

La plage de valeurs de la fonction est l'intervalle [-1, 1].

Si la fonction est utilisée avec un seul argument, alors l'argument doit être une matrice de données ou une série de signaux. La fonction calcule ensuite la matrice de corrélation pour les colonnes dans DataSet.

Si vous spécifiez DataSet1 et DataSet2, alors toutes les combinaisons des structures de données suivantes sont autorisées : série de données, matrice de données, signal et/ou série de signaux. Pour les structures de données composées, seule la composante Y est prise en compte et la composante X ou Z est adoptée dans le résultat lorsque cela est possible. Elle est de préférence issue de DataSet1.

Si la composante Y des deux ensembles de données est unidimensionnelle, le résultat est une valeur scalaire avec la corrélation des deux ensembles de données. Si la composante Y d'un ensemble de données est unidimensionnelle et la composante Y de l'autre ensemble de données est bidimensionnelle, alors pour chaque colonne de l'ensemble de données bidimensionnel, la corrélation est calculée avec l'autre ensemble de données. Le résultat est une série de données ou un signal avec une corrélation par colonne.

Si les composantes Y des deux ensembles de données sont bidimensionnelles, alors, en fonction du paramètre Mode, pour chaque colonne ou ligne de DataSet1, la corrélation est calculée avec la colonne ou la ligne correspondante dans DataSet2. Le résultat est une série de données ou un signal avec une corrélation par colonne ou ligne.

Si les ensembles de données présentent un nombre différent de lignes ou de colonnes, les lignes ou colonnes en excès sont ignorées.

Disponible dans

Option Statistiques avancées

Exemples

Correlation({5, 3, 4}, {3, 2, 1})

Renvoie 0.5.

Correlation({{1, 3, 5, 2, 4}, {2, 6, 10, 4, 8}})

Renvoie {{2.5, 1}, {1, 10}}.

Correlation({{1, 3, 5}, {3, 2, 4}}, {{2, 3, 7}, {3, 4, 6}}, PROCESS_ROWS)

Renvoie {1, -1, 1}.

Voir aussi

Fonction Covariance

Fonction Variance

Objet d'analyse Corrélation

Option Statistiques avancées

Littérature

[1] "Hartung, Joachim": "Statistik (Statistics), 9th Edition", page 119 - 20. "Oldenbourg Verlag GmbH, Munich",1993.ISBN 3-486-22055-1.

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :