/QWAT

QGIS water module

Primary LanguageQMLGNU General Public License v2.0GPL-2.0

image

QWAT: QGIS Water Module

Documentation

Hosted version here: http://qwat.readthedocs.org/

Steps to build the documentation:

$ pip install sphinx # only once if you don't have sphinx installed
$ cd doc/
$ make html

Documentation Status

INSTALL

In your shell:

git clone https://github.com/qwat/qWat
cd qWat

If you haven't added your ssh key to github, then you need to tell git to access the data-model submodule through https. Edit the .gitmodules file in the qWat folder and replace the url value from git@github.com:qwat/qwat-data-model.git to https://github.com/qwat/qwat-data-model.git

git submodule update --init --recursive

In order to create the database model you need to create a postgresql database. Do to this you may execute for example:

psql -U postgres -c 'create database qwat'

You can choose whatever name for the database and whatever user as its owner. The script that is used to create the database model looks for the .pg_service.conf file in the users home directory or in the directory specified by the PGSYSCONFDIR or PGSERVICEFILE variables.

Assuming you named your database qwat, edit the .pg_service.conf file and make it look like:

# Qwat service name
[qwat]
#enter your database ip
host=192.168.0.1
#database name
dbname=qwat
port=5432
user=postgres
#you can also add your password if you like
password=YourPassword

Now go to the data-model directory and run the ./init_qwat.sh script:

cd data-model
./init_qwat.sh -p qwat -s 21781 -d -r

The script has the following options:

  • -p PG service to connect to the database.
  • -s or --srid PostGIS SRID. Default to 21781 (ch1903)
  • -d or --drop-schema drop schemas (cascaded) if they exist
  • -r or --create-roles create roles in the database

After your model gets created, in QGIS you should be able now to connect to the database by creating a new connection with Name=qwat, Service=qwat, SSL mode=prefer.

If that works then open the qwat.qgs project in QGIS.

You can either choose to restore a sample dataset , then instead of running the init script, just run :

cd ..
git clone https://github.com/qwat/qwat-data-sample
psql -U postgres -c 'create database qwat;'
psql -U postgres -d qwat -c 'create extension postgis;'
psql -U postgres -d qwat -c 'create extension hstore;'
pg_restore --dbname qwat -e --no-owner --verbose --port 5432 qwat_data_sample.backup

Credits

see CREDITS

License

This work is free software and licenced under the GNU GPL version 2 or any later version.

You can get the LICENSE here .