<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="import" xml:lang="fr">
    <info>
        <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
        <link type="guide" xref="index#topics"/>
    
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Kevin / Archer_M-I-A</mal:name>
      <mal:email>archer_m-i-a_69@proton.me</mal:email>
      <mal:years>2026</mal:years>
    </mal:credit>
  </info>
    <title>Ajout de données</title>
    <p>Il y a trois types différents de données dans Graphes :</p>
    <list>
        <item>
            <p><link xref="#dataset"> <em>Jeu de données</em> </link> : les données sont importées depuis un fichier ou une base de données.</p>
        </item>
        <item>
            <p><link xref="#generated"> <em>Jeu de données générées</em> </link> : les données sont générées à partir d’une équation sur un ensemble fixe de points.</p>
        </item>
        <item>
            <p><link xref="#equation"> <em>Équation</em> </link> : une expression mathématique est rendue en continu sur l’intégralité du canevas.</p>
        </item>
    </list>
    <section id="dataset">
        <title>Jeu de données</title>
        <p>Un jeu de données correspond à des données importées depuis une source externe. Graphes prend en charge les fichiers orientés colonnes (tels que .csv, .dat, .xy, et texte simple), les feuilles de calcul (.ods et .xlsx), les fichiers de base de données SQLite, ainsi que les fichiers .xrdml Panalytical et .xry Leybold. Les données d’autres projets Graphes peuvent aussi être importées en sélectionnant un fichier projet.</p>
        <p>Pour importer des données, appuyez sur le bouton <em>Ajouter</em> dans la partie supérieure gauche de la barre latérale et choisissez <em>Ajouter des données à partir d’un fichier…</em>. Plusieurs fichiers peuvent être ajoutés lors d’une seule session d’importation en utilisant le bouton Ajouter dans la partie supérieure gauche de la boîte de dialogue d’importation. Chaque fichier apparaît dans la barre latérale de la boîte de dialogue, dans laquelle il peut être sélectionné pour vérifier et ajuster ses paramètres. Graphes tâchera d’estimer automatiquement les paramètres appropriés pour chaque fichier. Une fois que tout semble en ordre, appuyez sur <em>Importer</em> pour ajouter tous les fichiers au projet.</p>
        <p>Le <em>Mode importation</em> détermine la manière dont un fichier est analysé, et est paramétré automatiquement selon le type du fichier. Les modes disponibles sont décrits ci-dessous.</p>
        <section id="columns">
            <title>Fichiers orientés colonnes</title>
            <p>Les fichiers orientés colonnes enregistrent les données sous forme de rangées de valeurs séparées par un délimiteur tel qu’une virgule, une tabulation ou un espace. Graphes détecte automatiquement le délimiteur dans la plupart des cas. En cas d’utilisation d’un délimiteur personnalisé, un champ supplémentaire apparaît et permet d’indiquer le délimiteur de votre choix. Ce champ reconnaît les expressions régulières. Par exemple, l’expression <code>\s+</code> identifie toutes les correspondances avec des espaces, y compris des tabulations, et équivaut à utiliser l’option par défaut Espace.</p>
            <p>Si un fichier ne contient qu’une seule colonne de valeurs Y, l’option <em>Colonne unique</em> permet de générer automatiquement des valeurs X à partir d’une équation paramétrable, où <code>n</code> représente l’indice de la rangée en partant de zéro. Par exemple, <code>n</code> donne 0, 1, 2, 3… tandis que <code>n*0,5</code> donne 0, 0,5, 1,0, 1,5…</p>
        </section>
        <section id="spreadsheet">
            <title>Feuilles de calcul</title>
            <p>Graphes prend en charge l’importation de données à partir de feuilles de calcul en .ods et .xlsx. Les colonnes X et Y sont sélectionnées selon leur indice de colonne alphabétique, en partant de zéro. A l’instar des fichiers orientés colonnes, l’option <em>Colonne unique</em> peut être utilisée pour générer automatiquement des valeurs X lorsque seules des données Y sont disponibles. Plusieurs éléments peuvent être paramétrés à partir de la même feuille de calcul en une seule session d’importation en utilisant le bouton <em>Ajouter un élément</em>, chacun ayant sa propre sélection de colonne.</p>
        </section>
        <section id="sql">
            <title>Bases de données</title>
            <p>Graphes prend également en charge les fichiers de bases de données SQLite. Lors de l’importation d’un fichier de base de données, une liste déroulante affiche les tables disponibles. Une fois qu’une table est sélectionnée, les colonnes X et Y peuvent chacune être choisies à partir des colonnes numériques disponibles dans cette table. Si une table ne contient aucune colonne numérique, un avertissement est affiché.</p>
        </section>
        <section id="errorbars">
            <title>Barres d’erreur</title>
            <p>Les jeux de données prennent en charge des barres d’erreur X et Y facultatives. Pour les importations de bases de données et de feuilles de calcul, les barres d’erreur peuvent être activées par axe via le bouton bascule associé, ce qui déclenche l’affichage d’un sélecteur de colonne supplémentaire pour spécifier la colonne qui contient les valeurs d’erreur. Les formats de fichiers orientés colonnes qui contiennent nativement des données de barre d’erreur, tels que les fichiers .xrdml, verront ces données automatiquement importées.</p>
            <p>Une fois qu’elles ont été importées, les barres d’erreur sont conservées durant la plupart des opérations. Lors de la combinaison de plusieurs jeux de données, les barres d’erreur sont transmises telles quelles uniquement si tous les éléments sélectionnés en possèdent en sortie.</p>
        </section>
    </section>
    <section id="generated">
        <title>Jeux de données générées</title>
        <p>Les jeux de données générées créent des données via l’évaluation d’une équation sur une plage de valeurs X. Pour ajouter un jeu de données générées, appuyez sur le bouton <em>Ajouter</em> dans la barre latérale et choisissez <em>Générer des données…</em>. Les paramètres suivants peuvent être configurés :</p>
        <terms>
            <item>
                <title>Équation</title>
                <p>L’expression mathématique à évaluer, en utilisant <code>x</code> comme variable.</p>
            </item>
            <item>
                <title>X début et X fin</title>
                <p>Le minorant et le majorant de la plage des abscisses sur laquelle les données sont générées.</p>
            </item>
            <item>
                <title>Pas d’incrémentation</title>
                <p>Le nombre de points de données à générer.</p>
            </item>
            <item>
                <title>Échelle</title>
                <p>Détermine l’espacement entre les points de données. Un espacement linéaire place les points à équidistance. Les autres options telles que Logarithmique, Racine carrée, et Inverse sont utiles lorsque les données ou l’axe sur lequel elles seront tracées suivent une échelle non linéaire.</p>
            </item>
        </terms>
        <p>Les jeux de données générées sont généralement traités de la même manière que les données importées. Cependant, contrairement aux jeux de données classiques, les paramètres utilisés pour générer les données peuvent être modifiés à tout moment depuis l’éditeur d’éléments, et les données seront régénérées en conséquence.</p>
    </section>
    <section id="equation">
        <title>Équation</title>
        <p>Les éléments d’équation permettent un rendu continu et en direct d’une expression mathématique sur l’intégralité du canevas. Pour ajouter une équation, appuyez sur le bouton <em>Ajouter</em> dans la barre latérale et choisissez <em>Ajouter une équation…</em>, ou appuyez sur <keyseq> <key>Ctrl</key> <key>Alt</key> <key>N</key> </keyseq>.</p>
        <p>L’expression utilise <code>x</code> comme variable. Les syntaxes mathématiques les plus courantes sont acceptées. Par exemple, une équation quadratique simple telle que <code>x²+5</code> peut être saisie, et des expressions comme <code>sin(x)*x</code> ou <code>1/(x+1)</code> fonctionnent comme prévu. Les fonctions trigonométriques sont en radians par défaut. Pour utiliser plutôt les degrés, ajoutez un <code>d</code> au nom de la fonction. Ainsi <code>cosd(x)</code> utilise des degrés tandis que <code>cos(x)</code> utilise des radians.</p>
        <p>Une distinction importante entre les éléments d’équation et les jeux de données porte sur le fait que les opérations sont effectuées de manière analytique plutôt que numérique. Par exemple, le calcul de la dérivée de <code>x²+5</code> donne l’équation <code>2·x</code> plutôt qu’un ensemble de valeurs de coefficients directeurs calculées numériquement.</p>
    </section>
</page>
