HOWTO · Csharp

Écart type en C#

Il existe deux méthodes principales qui peuvent être utilisées pour calculer l'écart type des éléments d'une liste en C#, l'approche auto-définie et la méthode d'extension.

Sur cette page

L’écart type décrit dans quelle mesure les valeurs s’écartent généralement de leur moyenne. Ce guide présente deux façons de le calculer en C# : avec une méthode personnalisée et avec une méthode d’extension. Les deux exemples calculent l’écart type de la population.

Ce que mesure l’écart type

Pour les valeurs (x_1, x_2, \dots, x_N), calculez d’abord leur moyenne (\mu). Élevez ensuite au carré l’écart entre chaque valeur et la moyenne, faites la moyenne de ces carrés, puis prenez la racine carrée du résultat :

Formule de l’écart type : racine carrée de la somme des écarts à la moyenne au carré, divisée par N

La division par (N), le nombre de valeurs, donne l’écart type de la population. Si les valeurs constituent un échantillon servant à estimer une population plus vaste, l’écart type de l’échantillon se calcule généralement en divisant plutôt par (N - 1). Choisissez la formule qui correspond à la nature de vos données.

Calculer l’écart type de la population avec une méthode personnalisée

La méthode ci-dessous accepte IEnumerable<double>, copie les éléments dans un tableau, puis calcule la moyenne et les écarts au carré à partir de cette copie. Le nom standardDeviation est conservé pour les appelants qui l’utilisent directement.

Exécutez cet exemple. Le code ainsi que les libellés et la sortie affichés restent en anglais :

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;

class Program
{
    static double standardDeviation(IEnumerable<double> sequence)
    {
        double[] values = sequence.ToArray();
        if (values.Length == 0)
            return 0;

        double mean = values.Average();
        double squaredDifferenceSum = values.Sum(value => Math.Pow(value - mean, 2));
        return Math.Sqrt(squaredDifferenceSum / values.Length);
    }

    static void Main()
    {
        var values = new List<double> { 1, 2, 3, 4, 5 };
        Console.WriteLine(string.Format(CultureInfo.InvariantCulture,
            "Population standard deviation = {0:F13}", standardDeviation(values)));
    }
}
Population standard deviation = 1.4142135623731

ToArray() crée une copie stable : Average() et Sum() travaillent donc sur les mêmes valeurs. La moyenne de cette liste est 3 ; la somme des écarts au carré est 10, et la variance de la population vaut (10 / 5 = 2). Sa racine carrée est d’environ 1.4142135623731.

Utiliser une méthode d’extension

Une méthode d’extension rend le même calcul réutilisable et permet de l’appeler avec une syntaxe telle que values.standardDeviation(). Elle doit être déclarée dans une classe statique, et son premier paramètre utilise this pour désigner le type étendu. Cette version complète applique la même convention de copie et de traitement des séquences vides que la méthode personnalisée. Le code ainsi que les libellés et la sortie affichés restent en anglais :

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;

static class StatisticsExtensions
{
    public static double standardDeviation(this IEnumerable<double> sequence)
    {
        double[] values = sequence.ToArray();
        if (values.Length == 0)
            return 0;

        double mean = values.Average();
        double squaredDifferenceSum = values.Sum(value => Math.Pow(value - mean, 2));
        return Math.Sqrt(squaredDifferenceSum / values.Length);
    }
}

class Program
{
    static void Main()
    {
        var values = new List<double> { 1, 2, 3, 4, 5 };
        Console.WriteLine(string.Format(CultureInfo.InvariantCulture,
            "Population standard deviation = {0:F13}", values.standardDeviation()));
    }
}
Population standard deviation = 1.4142135623731

Utilisez la méthode personnalisée lorsqu’un appel de méthode ordinaire convient à l’API environnante. Choisissez la syntaxe d’extension lorsque l’opération se lit naturellement comme un comportement appliqué à une séquence. Les deux méthodes calculent l’écart type de la population ; la syntaxe d’extension ne modifie pas la formule statistique.

Gérer les séquences vides ou réutilisables

Les exemples renvoient 0 pour une séquence vide afin que les deux API se comportent de façon cohérente. Comme zéro peut aussi être un écart type légitime lorsque toutes les valeurs sont identiques, les appelants qui doivent distinguer « aucune donnée » de « aucune variation » devraient choisir une autre règle explicite, par exemple rejeter une entrée vide ou renvoyer un résultat nullable.

Un IEnumerable<double> ne représente pas nécessairement une collection réutilisable. Il peut s’agir d’un générateur, d’une source de données qui évolue ou d’une séquence qui ne peut être parcourue qu’une seule fois. Appeler séparément Any(), Average(), Sum() et Count() peut entraîner plusieurs parcours, ce qui risque d’ajouter du travail ou d’observer des valeurs différentes. La matérialisation unique avec ToArray() évite ces parcours répétés et garantit que chaque étape du calcul utilise les mêmes valeurs. Pour les flux très volumineux, utilisez un algorithme à un seul parcours qui accumule le nombre de valeurs, la moyenne et les écarts au carré au lieu de toutes les stocker.