Geotransformations Python Command Line Utility¶

Documentation¶

Published on ReadTheDocs: Documentation

Features¶

Command line utility for easy transformations between geodata/spatial filetypes.
Python functions with documentation for direct usage.
- This is my own main use case: A package with all basic geopandas file loads and saves bundled.
Uses Python pathlib for cross-platform path handling.

Support¶

Currently supports:

All file formats supported by geopandas can be implemented.

Dependencies¶

geopandas for transforming between geodata filetypes which in turn uses fiona (that uses GDAL).
click for command line integration.

Alternatives¶

The GDAL tool ogr2ogr is a much more sophisticated command-line tool for converting between spatial file formats.

Geopandas by itself supports many more spatial file formats. For more advanced use cases when interacting with Python I recommend just using geopandas.

Fiona provides a command-line interface fio. fio.

Installation¶

PyPi

pip install geotrans

poetry for development

git clone https://github.com/nialov/geotransform.git
cd geotransform
poetry install

Using geotransform¶

Command line¶

Run

geotrans --help

to print the command line help for the utility.

To transform from a geopackage file with a single layer to an ESRI shapefile:

geotrans input_file.gpkg --to_type shp --output output_file.shp

To transform from a geopackage file with multiple layers to multiple ESRI shapefiles into a given directory:

geotrans input_file.gpkg --to_type shp --output output_dir

Python¶

All main functions in charge of loading and saving geodata files are exposed in the transform.py file in the geotrans package.

from geotrans.transform import load_file, save_files, SHAPEFILE_DRIVER
from pathlib import Path

# Your geodata file
filepath = Path("input_file.gpkg")

# load_file returns a single or multiple geodataframes depending
# on how many layers are in the file.
geodataframes, layer_names = load_file(filepath)

# Assuming geopackage contained only one layer ->
# Save acquired geodataframe and layer
save_files(geodataframes, layer_names, [Path("output_file.shp")], SHAPEFILE_DRIVER)

License¶

This project is licensed under the terms of the MIT license.

Contents¶

Module documentation for developers

geotrans package