Skip to content

Formats I/O supportés

GISPulse utilise PyOGRIO pour la lecture et l'écriture vectorielle et Rasterio pour le raster. La détection du format est automatique basée sur l'extension du fichier.

bash
# Lister les formats disponibles sur votre installation
gispulse formats

Formats vectoriels

Formats recommandés

ExtensionFormatLectureÉcritureNotes
.gpkgGeoPackageouiouiRecommandé — multi-layers, styles, performant
.fgbFlatGeobufouiouiUltra-rapide pour gros volumes, indexé spatialement
.parquetGeoParquetouiouiOptimal pour données tabulaires larges, natif DuckDB
.geojsonGeoJSONouiouiStandard web, interopérable
.geojsonlGeoJSON LinesouiouiStreaming, gros volumes

Formats courants

ExtensionFormatLectureÉcritureNotes
.shpESRI ShapefileouiouiHéritage — préférer GPKG
.csvCSV (lat/lon ou WKT)ouiouiDétection auto colonnes géométrie
.dxfAutoCAD DXFouiouiCAD
.kmlKML / KMZouinonGoogle Earth
.gmlGMLouiouiOGC standard
.gpxGPXouinonGPS tracks

Formats bases de données

FormatLectureÉcritureNotes
PostGISouiouiVia GISPULSE_DSN (Pro)
SpatiaLiteouiouiMode portable, sessions éphémères
GeoDatabase ESRI (.gdb)ouinonRead-only
OGC WFSouinonVia OGCLayerLoader (lazy loading)
OGC API FeaturesouinonStandard OGC moderne

Lecture par lots (chunked)

Pour les fichiers volumineux, read_vector_chunked() permet une lecture par lots de 50 000 features, évitant de charger tout en mémoire.

Formats raster (avec gispulse[raster])

ExtensionFormatLectureÉcriture
.tif, .tiffGeoTIFFouioui
.tif (COG)Cloud-Optimized GeoTIFFouioui
.jp2JPEG2000ouinon
.ascASCII Gridouinon
.vrtGDAL VRTouinon
.imgERDAS Imagineouinon
.ncNetCDFouinon
.hdf, .h5HDF5ouinon
.ecwECWouinon
.sidMrSIDouinon
.pngPNG (géoréférencé)ouinon

Raster

Les formats raster nécessitent pip install "gispulse[raster]" (dépendance rasterio).

Détection automatique

GISPulse détecte le format à partir de l'extension :

bash
# Format détecté automatiquement
gispulse run input.fgb --rules rules.json -o output.gpkg
gispulse run input.geojson --rules rules.json -o output.fgb
gispulse run input.shp --rules rules.json -o output.parquet

Si le fichier n'a pas d'extension reconnue, forcer avec --layer et --crs.

Conseils de format

Pour de gros volumes (> 100 000 features)

  1. FlatGeobuf (.fgb) — lecture/écriture la plus rapide, indexé spatialement
  2. GeoParquet (.parquet) — excellent pour les dizaines de colonnes attributaires, natif DuckDB
  3. GPKG — polyvalent, supporte les styles

Pour l'interopérabilité GIS desktop

  • GeoPackage (.gpkg) — supporte les styles QGIS (QML) et SLD, multi-layers
  • GISPulse copie automatiquement les styles lors d'un pipeline --all-layers

Pour le web / API

  • GeoJSON — standard universel, lisible humainement
  • FlatGeobuf — streaming performant pour les grandes datasets côté client
  • MVT — tuiles vectorielles via l'endpoint /ogc/collections/{id}/tiles/

Pour la data spatiale "moderne"

  • GeoParquet — compatible DuckDB, Pandas, Arrow, cloud-native
  • COG — Cloud-Optimized GeoTIFF pour le raster

Multi-layers (GPKG)

GeoPackage supporte plusieurs layers dans un seul fichier :

bash
# Traiter une layer spécifique
gispulse run projet.gpkg --rules rules.json -o output.gpkg --layer batiments

# Traiter toutes les layers (styles copiés)
gispulse run projet.gpkg --rules rules.json -o output.gpkg --all-layers
bash
# Inspecter les layers d'un GPKG
gispulse layers projet.gpkg

3 layer(s):
  - parcelles
  - batiments
  - routes

Published under AGPL-3.0 license.