fagan2888 / gasp

gasp is a python package with methods to assist programmers on tasks related with spatial analysis and production of geographic information.

GeoData Algorithms for Spatial Problems

The GeoData Algorithms for Spatial Problems (GASP) is a free and open source library for geospatial data science. It consistes of a set of Python Methods to support the automatization of spatial analysis activities based on Geographic Information Systems Software inside any application. These Python Methods could be included in any high-level application for spatial analysis.

GASP Components

Methods and Algorithms for Land Use/ Land Cover mapping

• OSM2LULC - implementation in Python of an algorithm for the conversion of OpenStreetMap data into Land Use/Land Cover (LULC) maps. Know more about OSM2LULC!

Methods and Algorithms for other applications

• TODO

Installation

Install dependencies:

• Ubuntu/Debian;
• Lubuntu;
• CentOS7;
• MS Windows (TODO).

Install GASP:

1 - Install GIT:

sudo apt install git

2 - Clone GASP repository from github.com:

user="$(whoami)"
mkdir /home/$user/xpto
cd /home/$user/xpto
git clone https://github.com/jasp382/gasp.git

3 - Set PGPASSWORD as environment variable:

echo "export PGPASSWORD=yourpostgresqlpassword" | sudo tee --append /home/$user/.bashrc
source /home/$user/.bashrc

4 - Edit /../../gasp/gasp/osm2lulc/con-postgresql.json file according your PostgreSQL configuration;

5 - Replace default osmconf.ini file in your GDAL-DATA configuration folder:

# For Ubuntu and CentOS
sudo rm /usr/share/gdal/osmconf.ini
sudo cp /home/$user/xpto/gasp/gasp/osm2lulc/osmconf-gdal.ini /usr/share/gdal/osmconf.ini

# For Lubuntu
sudo rm /usr/share/gdal/2.2/osmconf.ini
sudo cp /home/$user/xpto/gasp/gasp/osm2lulc/osmconf-gdal.ini /usr/share/gdal/2.2/osmconf.ini

6 - Create Python Virtual Environment:

sudo -H pip install virtualenv
cd /home/$user/xpto
virtualenv gasp_env --system-site-packages

7 - Install gasp in the created virtual environment:

source gasp_env/bin/activate
cd /home/$user/xpto/gasp
pip install -r requirements.txt
python setup.py install

Use GASP without installation

It is possible to use GASP Python package without any configuration. For that, just download the virtual machine vm_gasp using the following URL: https://vgi.uc.pt/vgi/vm/vm_gasp/

The only requirement is to have 7Zip and VirtualBox 5.x installed. The first to decompress the vm_gasp.7z and the second to run the virtual machine (vm_gasp.vbox).

The access to the virtual machine is performed with the following credentials:

User: gisuser
Password: gisuser

To test GASP tools, just activate the virtual python environment with the name gasp_env, as shown in the following example:

cd /home/gisuser/xpto/gasp
source gasp_env/bin/activate

Also to test GASP, anyone can use the data available in the /home/gisuser/sample_data folder.

Documentation

TODO

Development

TODO

Bug reports

If a bug is found or if there is any problem during GASP setup, please send an email to the administrator of this repository ([email protected]).

License information

See the file "LICENSE" for information about the terms & conditions and a DISCLAIMER OF ALL WARRANTIES.