geotrans 0.0.5

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:

• GeoPackages

• Esri Shapefiles

• File Geodatabases Read only

• GeoJSON

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

geotrans --help

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

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

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.

Copyright © 2020, Nikolas Ovaskainen.