Luís Moreira de Sousa
||8 months ago|
|data||8 months ago|
|hex_utils||8 months ago|
|styles||5 years ago|
|surfaces||4 years ago|
|tests||3 years ago|
|.gitignore||8 months ago|
|.project||5 years ago|
|.pydevproject||5 years ago|
|LICENCE||5 years ago|
|README.md||8 months ago|
|Release.md||8 months ago|
|requirements.txt||5 years ago|
|setup.py||8 months ago|
Utilities for Hexagonal ASCII grids
Copyright (c) 2016-2020 Luís Moreira de Sousa. All rights reserved. Any use of this software constitutes full acceptance of all terms of the document licence.
For the latest updates please consult
hex-utils project page
New information is also posted on Twitter under the #HexASCII tag.
This project aims to deliver a series of tools to facilitate the manipulation and usage of hexagonal raster grids. These tools rely on the Hexagonal ASCII file format (or HASC for short) for the physical storage of hexagonal rasters.
hasc2gml - from an input HASC file creates a GML file with a vector feature for each hexagonal cell. Simplifies the display of hexagonal rasters in common desktop GIS software.
asc2hasc - creates an HASC file from an input ESRI ASCII grid. It can either preserve cell area or approximate spatial resolution.
surface2hasc - creates an HASC file from a continuous surface function.
surface2asc - creates an ESRI ASCII file from a continuous surface function.
Future work includes the development of a Graphical User Interface (GUI) for these tools on QGIS, making the usage of hexagonal grids even simpler.
This tool suite can be installed from the PyPi repository.
The Python package manager is required to install dependencies; on Debian based systems it can be obtained like:
sudo apt install python3-pip
Installing from PyPi
The easiest way to install
hex-utils is through the universal package
available from the Python Package Index (PyPi); an example again on Debian
sudo pip3 install hex-utils
Installing from Git
Start by cloning the repository to your system:
git clone firstname.lastname@example.org:ldesousa/hex-utils.git
Change to the new folder:
It is possible to install directly from the
master branch, but it is more
advisable to use one of the tagged releases,
git checkout tags/v0.4.4
Then install the scripts system wide:
sudo python3 setup.py install
Finally, install the remaining dependencies:
sudo pip3 install -r requirements.txt
Note that you may already have some of these packages installed on your system. That being the case, the best option is to use a virtual environment.
hasc2gml script requires the Python GDAL library; the
scipy library. Functional Python packages of these libraries
might not be available for all systems. In such cases pre-compiled and system
specific are required. On Debian based systems these can be installed with the
sudo apt install python3-gdal python3-scipy
To install the GDAL bindings library from PyPi.org make sure it matches the version installed on your system. For instance, on Ubuntu 20.04 this will be 3.0.4:
$ apt search libgdal Sorting... Done Full Text Search... Done libgdal-dev/focal,now 3.0.4+dfsg-1build3 amd64 [installed]
requirements.txt file should be edited accordingly before installing. Or
to install directly from PyPi.org:
pip install GDAL==3.0.4
The tools in this package can also be used through a QGis plug-in offering a graphical user interface to most of the functionalities.
Please use the reference below to cite the
de Sousa L. M. and Leitão, J. P. Hex-utils: A Tool Set Supporting HexASCII Hexagonal rasters. Proceedings of the 3rd International Conference on Geographical Information Systems Theory, Applications and Management: GISTAM, 1, 177-183, 2017.
This suite of programmes is released under the EUPL 1.1 licence. For full details please consult the LICENCE file.