Modèle de données géologiques

Le but de ces outils est de créer de manière plus au moins automatique le modèle de données géologiques, en particulier la liste des valeurs attributaires possibles, et le modèle physique issu de ESRI ArcSDE.

Les exports de la base de données ArcSDE sont dans exports, les fichiers intermédiaires nécessaires pour la génération des documents finaux, comme markdown dans inputs et les différents formats du modèle final dans outputs.

• Pour l'instant, le modèle est disponible en allemand et en français.
• Plusieurs formats sont disponbiles : datamodel.pdf, ainsi que sous forme de fichier .docx, .html et .odt.
• Le dump des informations de ESRI ArcSDE dans exports
• Le schéma ER de la base ER-GCOVER.svg, généré à partir d'un fichier PlantUML.

Installation

L'outil est disponbile comme paquets sur anaconda.org et pypi.org. La génération des fichiers finaux à partir des exports est possible dans n'importe quel environnement, mais l'export des données nécessite arcpyet un accès à la base ESRI ArcSDE. base de données ESRI ArcSDE n'est bien entendu pas possible.

Windows

Create a new conda environment by cloning arcgispro-py3 if you need to export data from ArcSDE (obvious). To generate the models, you don't need arcpy,

Install the package

(arcgispro-py3) D:\conda\envs\arcgispro-py3_clone> conda install swisstopo::geocover

To generate de final documents from the markdown sources, you need pandoc. As pandoc.exe is a standalone binary on Windows, simply download it and unzip it into C:\LegacySW (see the latest available version on Pandoc ).

Pour tester l'installation (le numéro de version peut être différent):

C:\LegacySW\pandoc-3.1.13\pandoc.exe --version

Linux

You need pandoc and a fully-fledge XeLaTeX installation. Install it with apt-get, yum, etc.

Create a conda environement as normal and install the package:

conda install swisstopo::geocover

The subcommand of geocover requiring arcpy are not available on Linux. The Le script datamodel qui génère le fichier markdown n'a besoin que des libraries de base sus-mentionnées.

Utilisation

Ce guide décrit les étapes nécessaires pour générer une nouvelle version du modèle de données géologiques en utilisant les outils gcover et geocover

Préparation

1. Création du répertoire de données

Créez un nouveau répertoire pour stocker les exports de la version :

mkdir -p exports/<RELEASE-DIR>

Exemple : mkdir -p exports/2025-08-26

2. Configuration du modèle

Modifiez le fichier datamodel.yaml pour spécifier la nouvelle version et le répertoire source :

# Le numéro de révision du modèle doit être modifié lorsque des attributs sont ajoutés, supprimés ou modifiés
model:
  revision: '4.1.1'
  revision_date: "2025-08-26"
  sources_dir: "exports/2025-08-26"

3. Installation de l'outil

Si ce n'est pas déjà fait, installez l'outil gcover :

Avec conda (recommandé) :

conda install gcover

Avec pip :

pip install gcover

Export des données

1. Export du schéma de données

Exportez le schéma complet depuis la base de données ArcSDE :

gcover schema extract \
  --filter-prefix "GC_" \
  --output exports/<RELEASE-DIR>/GCOVERP.json \
  "D:\connections\[email protected]"

2. Transformation en version simplifiée

Convertissez le schéma complet en version simplifiée :

gcover schema transform-simple \
  exports/<RELEASE-DIR>/GCOVERP.json \
  -o exports/<RELEASE-DIR>/gcoverp_export_simple.json

3. Export des tables annexes

Exportez toutes les tables de référence nécessaires :

gcover schema export-tables \
  -w "H:/connections/[email protected]" \
  -o exports/<RELEASE-DIR> \
  --all-tables

Cette commande génère les fichiers suivants :

• Geol_Mapping_Unit_Att.json
• Geol_Mapping_Unit.json
• Correlation.json
• Admixture.json
• Composit.json
• Charcat.json
• System.json

4. Ajout des fichiers statiques

Copiez manuellement les fichiers statiques suivants dans le répertoire exports/<RELEASE-DIR>/ :

Note : Ces fichiers seront bientôt intégrés automatiquement dans le processus

• geolcode_chrono.csv
• GeolCodeText_Trad_230317.csv
• SCHEMA_CHANGES_4.0-4.1.json
• all_codes_dict.json

Génération des documents

Génération des PDF

Une fois tous les exports terminés, générez les documents finaux :

make pdfs

Cette commande produit les fichiers PDF dans les langues configurées (français, allemand).

Vérification de la qualité

Validation des métadonnées PDF

Vérifiez que les métadonnées du PDF généré sont correctes :

exiftool outputs/fr/datamodel.pdf

Sortie attendue :

ExifTool Version Number         : 12.40
File Name                       : datamodel.pdf
Language                        : fr
Page Count                      : 425
Title                           : Modèle de donnée géologique 2D (GeoCover), Révision 4.1
Subject                         : Levé géologique de la Suisse
Author                          : Service géologique national — Office fédéral de topographie swisstopo
Keywords                        : GeoCover, Metadata, Model, GIS, Vector data, Geology, Switzerland, development
Model Revision                  : 4.1.1
Model Short Revision            : 4.1
Git Hash                        : a858a3b
Create Date                     : 2025:08:27 21:41:58+03:00

Notes importantes

• Pré-requis : L'export des données nécessite un accès à la base de données ArcSDE et l'environnement ArcGIS Pro avec arcpy
• Durée : Le processus complet peut prendre plusieurs minutes selon la taille de la base de données
• Sauvegarde : Il est recommandé de sauvegarder les exports précédents avant de générer une nouvelle version
• Validation : Vérifiez toujours les fichiers générés avant de les publier

Résolution de problèmes

Erreurs communes

1. Connexion à la base de données impossible :

   • Vérifiez la chaîne de connexion ArcSDE
   • Assurez-vous que l'environnement ArcGIS Pro est actif

2. Fichiers manquants :

   • Vérifiez que tous les fichiers statiques ont été copiés
   • Contrôlez les permissions sur le répertoire de sortie

3. Erreur lors de la génération PDF :

   • Vérifiez que pandoc et XeLaTeX sont installés
   • Contrôlez la syntaxe du fichier datamodel.yaml

Contact

En cas de problème, consultez la documentation technique ou contactez l'équipe de développement ([email protected]).