Données

Ecran :

Description :
Ce module a pour objectif d'introduire dans l'organigramme les données sur lesquelles l'utilisateur va travailler.

Vous avez cinq possibilités qui correspondent aux 5 possibilités de la liste de choix :

• Choisir un fichier Texte ou DBF contenant des données statistiques. Pour cela, sélectionnez Fichier Texte, puis cliquez sur le bouton Choix du fichier. Grâce au bouton Colonne et en-tête, vous pouvez sélectionner la colonne qui vous intéresse et préciser si la première ligne du fichier est une ligne d'en-tête.
• Choisir un fichier Excel contenant des données statistiques. Pour cela, sélectionnez Excel, puis cliquez sur le bouton Choix du fichier Excel. Grâce aux boutons Choix de la feuille, Colonne des identifiants et Colonne de la donnée, vous pouvez sélectionner la donnée qui vous intéresse, et préciser si la première ligne du fichier est une ligne d'en-tête grâce à la case Utiliser l'en-tête pour le nom des colonnes.
• Prendre les données dans les enregistrements d'une base 4D. Pour cela, sélectionnez Base 4D, puis complétez les champs Nom de la table, Nom du champ et Champ pour l'identifiant relatifs à la base 4D que vous désirez utiliser (la base doit être ouverte avec le Plug-In Cartes & Données).
• Prendre les données dans les enregistrements d'une source de données ODBC. Pour cela, sélectionnez ODBC, puis complétez les champs Nom de la source ODBC, Login et Mot de passe relatifs à la source que vous désirez utiliser. Complétez ensuite le champ Requête pour effectuer votre sélection.
• Conserver les données dans l'organigramme, en sélectionnant Interne.

A tout moment, vous pourrez créer un nouveau fichier contenant les données (quelle que soit la provenance). Pour cela, sélectionnez Fichier Texte, puis cliquez sur le bouton Création du fichier, et donnez-lui le nom que vous souhaitez.
ATTENTION: si vous venez de placer votre module dans l'organigramme, il ne contient pas de donnée, donc la création échouera. Il faut le connecter au module de fond de carte en amont pour que le module construise des données. Dès lors, la création du fichier sera correcte.

Si Fichier Texte est sélectionné, alors le fichier en question est sauvegardé à chaque saisie manuelle dans Cartes & Données.
Si Excel ou Base 4D ou ODBC est sélectionné, alors la donnée n'est pas modifiable.

En cochant la case Nom du module automatique, le nom du module dans l'organigramme sera choisi automatiquement, et vous ne pourrez pas le modifier vous-même (sauf si les données sont internes). Ce sera :

• soit celui du fichier sélectionné, suivi du numéro de la colonne choisie.
• soit le nom de la colonne si le fichier possède une ligne d'entête.
• soit le nom du champ pour les bases 4D.

Types de données :
Voici la liste des différents types de données :

• Donnée continue (chiffres)
• Donnée discrétisée (numéros de classes)
• Donnée qualitative (noms)
• Donnée alphabétique (noms)
• Matrice continue (chiffres en matrice)
• Matrice discrétisée (numéros de classes en matrice)

Lors de la saisie des données dans le tableau de Cartes & Données, quel que soit son type, la valeur "----" (quatre tirets) correspond à une valeur non-valide. Cela permet d'exclure du traitement une ou plusieurs entités.

Sélection d'un fichier Texte ou DBF :

• Le fichier peut être au format dbf ou ASCII (texte).
• Si le fichier est au format ASCII (texte), 2 informations doivent apparaître sur chaque ligne :
       - l'identifiant de l'entité géographique.
       - la valeur.
• Ces informations doivent être séparées par des tabulations. L'identifiant doit être identique à celui du fichier "fond de carte".
• De la même façon que dans le format "NUM", s'il y a un tiret dans l'identifiant, il sépare alors l'identifiant et le nom de l'entité (voir la description des formats d'imports / exports ).
• Un fichier de données peut comporter autant de colonnes que vous souhaitez.
• ATTENTION: si la première ligne est un en-tête, le premier champ de cette ligne ne doit pas être vide (mettre une étoile par exemple).
• Si la donnée est matricielle, le tableau de données peut prendre deux formes : soit une matrice carrée, soit une matrice unicolonne (voir plus bas, le chapitre sur les matrices).

Emplacement du fichier :
Dans le menu Options/Préférences, vous pouvez choisir un répertoire des données. Si le fichier se trouve sous l'arborescence de ce dernier, alors il est considéré comme relatif.

• Il est recommandé que tous les documents (cartes, données, organigrammes) soient placés sous ce répertoire.
• Il est recommandé de ne jamais changer ce répertoire, car il sert de référence à tous les fichiers relatifs.
• Si deux personnes possèdent Cartes & Données, elles peuvent échanger leurs organigrammes sans aucune difficulté si elles ont pris soin de placer leurs données dans ce répertoire selon une arborescence similaire. Ceci est valable même si l'une utilise un Macintosh et l'autre un PC.

Sélection d'un fichier contenant plusieurs colonnes :
Si le fichier comporte plusieurs colonnes, cliquez sur le bouton Colonne et en-tête afin de choisir la colonne que vous désirez. Vous verrez alors apparaître une fenêtre de ce style :

Par défaut, la première colonne est toujours sélectionnée. Pour en sélectionner une autre, il vous suffit de cliquer sur la colonne désirée (elle apparaîtra alors en bleu).

Si votre fichier comporte une ligne d'en-tête, cochez la case Utiliser l'en-tête pour le nom des colonnes :

Si la case Utiliser l'en-tête pour le nom des colonnes est cochée, Cartes & Données prendra la première ligne pour renommer le module.

Sélection d'un fichier Excel :

• Le fichier xls doit être au format Excel95, Excel97 ou ExcelXP.
• Il doit comporter une colonne avec les identifiants des entités géographiques. Les identifiants doivent être identiques à ceux du fichier "fond de carte".
• De la même façon que dans le format "NUM", s'il y a un tiret dans l'identifiant, il sépare alors l'identifiant et le nom de l'entité (voir la description des formats d'imports / exports ).
• Le fichier de données peut comporter autant de colonnes que vous souhaitez.
• Si la donnée est matricielle, le tableau de données peut prendre deux formes : soit une matrice carrée, soit une matrice unicolonne (voir plus bas, le chapitre sur les matrices).

Emplacement du fichier :
Voir le paragraphe sur l'emplacement du fichier dans le chapitre Sélection d'un fichier Texte ou DBF.

Sélection de la feuille :
Cliquez sur le bouton Choix de la feuille afin de choisir la feuille qui contient la donnée que vous désirez. Vous verrez alors apparaître une fenêtre de ce style :

Par défaut, la première feuille du fichier est toujours sélectionnée. Pour en sélectionner une autre, il vous suffit de cliquer sur le nom de la feuille désirée (la croix apparaîtra alors devant son nom).

Le nom de la feuille sélectionnée apparaît à droite du bouton Choix de la feuille.

Sélection des colonnes :
Cliquez sur le bouton Colonne et en-tête afin de choisir la colonne des idenfiants et celle de la donnée. Vous verrez alors apparaître une fenêtre de ce style :

Par défaut, la première colonne est toujours sélectionnée pour les identifiants. Pour en sélectionner une autre, il vous suffit de cliquer sur la colonne désirée (elle apparaîtra alors en bleu).

Cliquez ensuite sur suivant pour afficher cette nouvelle page :

Par défaut, la deuxième colonne est toujours sélectionnée pour les données. Pour en sélectionner une autre, il vous suffit de cliquer sur la colonne désirée (elle apparaîtra alors en bleu).

Si votre fichier comporte une ligne d'en-tête, cochez la case Utiliser l'en-tête pour le nom des colonnes.

Si la case Utiliser l'en-tête pour le nom des colonnes est cochée, Cartes & Données prendra la première ligne pour renommer le module.

Données provenant de 4D :

ATTENTION: il ne doit y avoir qu'un seul Plug-In sur la machine. Si plusieurs bases 4D sont ouvertes avec chacune un Plug-In, le transfert de paramètres ne se fera pas correctement.

Le Plug-In et Cartes & Données acceptent les types 4D suivants, en fonction des types Cartes & Données :

Les données matricielles doivent être stockées dans une seule colonne, avec pour identifiant "Départ>Arrivée". Par exemple pour les départements français, on pourra trouver une table comme ci-dessous :

Ces valeurs signifient que le flux entre les départements 95 et 12 est 10, et le flux entre 17 et 34 est 20.

Les messages d'erreur pouvant apparaître lors de l'exécution sont les suivants :

Données provenant d'une source ODBC :

Le modèle est le suivant:
  select idchamp, datachamp from table where champ>5
où:

• table est une table de la source ODBC sélectionnée.
• idchamp est un champ de table contenant les identifiants des éléments du fond de carte associé.
• datachamp est un champ de table contenant la donnée elle-même.
• Facultatif : le mot "where" permet de spécifier une ou plusieurs conditions.
   Exemple : "where champ1>100 and champ2<200"
    où champ1 et champ2 sont des champs de table.

Dans le cas particulier où l'identifiant est une clé multiple (identifiant composé de plusieurs champs, séparés par exemple par un '/'), le résultat de la requête doit, comme pour les identifiants simples, être composé de deux colonnes : identifiant puis donnée. La syntaxe est alors la suivante:

• si la source ODBC est une base Access:
    select idchamp1+'/'+idchamp2+'/'+idchamp3, datachamp from table
  
  
• si la source ODBC est une base mysql:
    select concat(idchamp1,'/',idchamp2,'/',idchamp3) as multiplekey, datachamp from table

ATTENTION: il est important de bien respecter l'ordre précis : champ des identifiants, champ de la donnée. Sinon, la requête génèrera une erreur.

Une fois que votre requête est prête, vous devez sélectionner le type de données correspondant au résultat, puis cliquer sur le bouton OK ou Appliquer pour lancer votre sélection.

Comme pour les données provenant de 4D, les données matricielles doivent être stockées dans une seule colonne, avec pour identifiant "Départ>Arrivée".

Types de données :

Donnée discrétisée :
Une donnée discrétisée doit être un nombre entier, compris entre 1 et 512.
Cependant, un traitement spécial est effectué si la plus petite valeur n'est pas 1 : par exemple, si les classes sont entre -15 et 2 , alors dans Cartes & Données elles passeront entre 1 et 18, et tout sera décalé.

Donnée qualitative :
Si vous choisissez une donnée qualitative, et que l'onglet Interne est sélectionné, vous pouvez modifier le nombre de qualités en cliquant sur les boutons ' + ' ou ' - ' qui se trouvent à côté du nombre de qualités. Les noms des qualités apparaissent alors dans le tableau situé au-dessus de ces boutons. Par défaut, ce sont des chiffres, mais il vous suffit de cliquer dessus pour les renommer, et d'utiliser les touches "Flèche vers le bas" ou "Tabulation" de votre clavier pour valider chaque saisie. Vous pouvez utiliser au maximum 512 qualités.

Lors de la saisie des données dans le tableau de Cartes & Données, une liste des qualités est proposée, quelle que soit la provenance des données. Vous pourrez faire dérouler la liste des qualités avec la souris ou bien au clavier (touches "flèche droite" et "flèche gauche"). Vous pourrez ainsi sélectionner une qualité, ou bien en créer une nouvelle.

Matrice :
Une matrice de flux est une donnée statistique de flux migratoire entre entités géographiques. Chaque ligne de la matrice représente les mouvements depuis une entité vers toutes les autres. La matrice est carrée, et le fond de carte d'origine est le même que celui de destination.
La première colonne doit contenir les identifiants.
La première ligne peut contenir :

• soit des données. Les colonnes sont alors supposées être dans le même ordre que les lignes. S'il y a 10 objets, il faut 1 colonne d'identifiants, plus 10 colonnes de données, pour un total de 10 lignes.
• soit les identifiants. Les colonnes peuvent alors être dans n'importe quel ordre. Vous devez cocher la case Utiliser l'en-tête pour le nom des colonnes, accessible en cliquant sur le bouton Colonne et en-tête. S'il y a 10 objets, il faut 1 colonne d'identifiants, plus 10 colonnes de données, pour un total de 11 lignes.

La matrice doit toujours être carrée (sans compter les en-têtes).

Exemples de matrice (avec trois objets A, B et C) :

équivaut à :

Matrice décrite par une seule colonne:
On peut décrire la matrice dans une seule colonne. Dans ce cas, il faut cocher l'option Matrice colonne dans l'onglet "Fichier". Dans l'import 4D et ODBC, c'est la seule possibilité, on ne peut pas utiliser la matrice carrée.
Le fichier doit se présenter ainsi :

A>B    2
B>A    1
B>C    1
C>B    1

2      module untyped_list ""
3        mod_type integer "102"
3        mod_subtype integer "0"
3        mod_name string "PSDC82"
3        mod_dads integer_list ""
4          ? integer "4"
3        path path ""
4          file_type integer "-1"
4          type integer "4"
4          win32_net boolean "F"
4          volume string ""
4          path_elem string_list ""
5            ? string "FRANCE"
5            ? string "DPT"
5            ? string "MULTI.DPT"
3        absolute boolean "F"
3        base_path path ""
4          file_type integer "-1"
4          type integer "2"
4          win32_net boolean "F"
4          volume string "D"
4          path_elem string_list ""
5            ? string "develres"
5            ? string "Lib_html"
5            ? string "scripts"
3        auto_name boolean "T"
3        linked_to_file boolean "F"
3        column_nb integer "3"
3        squared_matrix boolean "F"
3        has_header boolean "T"
3        output_type integer "2"
3        data_list untyped_list ""
3        qualities string_list ""
3        linked_to_xls boolean "T"
3        xls_path path ""
4          file_type integer "-1"
4          type integer "4"
4          win32_net boolean "F"
4          volume string ""
4          path_elem string_list ""
5            ? string "france"
5            ? string "dpt"
5            ? string "multi.xls"
3        absolute_xls boolean "F"
3        col_id integer "1"
3        col_data integer "4"
3        sheets string_list ""
4          ? string "Feuille1"
4          ? string "Feuille2"
4          ? string "Feuille3"
3        sheet_name string "Feuille1"
3        xls_squared_matrix boolean "F"
3        xls_has_header boolean "T"
3        linked_to_4d boolean "F"
3        table_name string "DEPARTEMENTS"
3        data_name string "POP"
3        key_name string "CODE"
3        linked_to_odbc boolean "F"
3        src_name string "POPULATION"
3        src_login string ""
3        src_psswd string ""
3        request string "select CODE,DENSITE from DEP where DENSITE>100"

Valeurs pour output_type :
Donnée continue          2
Donnée alphabétique      5
Donnée discrétisée       9
Donnée qualitative      10
Matrice continue        11
Matrice discrétisée     12
Matrice qualitative     13

Cas où l'onglet Interne est sélectionné :
Dans ce cas, la liste 'data_list' doit contenir les données saisies à l'écran.
Par exemple, pour des données de type alphabétique :

3        data_list untyped_list ""
4          ? untyped_list ""
5            id string "80"
5            val string "Nord"
4          ? untyped_list ""
5            id string "83"
5            val string "Sud"

Le type de donnée pour le champ 'val' sera :
 - 'double' pour une donnée ou matrice continue.
 - 'integer' pour une donnée ou matrice discrétisée.
 - 'string' pour une donnée qualitative ou alphabétique.
Le champ 'id' contient l'identifiant de l'entité concernée.
Dans le cas des matrices, on placera dans ce champ les identifiants de départ et d'arrivée
séparés par un ">". Exemple : "80>83".

Seules les entités ayant une donnée doivent être insérées.
Les autres sont considérées comme non-valides.

Cas des données qualitatives :
Si les données sont qualitatives, et que l'onglet Interne est sélectionné,
alors la liste 'qualities' doit être fournie. Exemple :

3        qualities string_list ""
4          ? string "Electronique"
4          ? string "Textile"