CERC/mtl_gis_oo
4
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add readme

Browse Source
This commit is contained in:
Alireza Adli 2024-10-31 11:22:58 -04:00
parent 4b85e48deb
commit 0b046b975e
1 changed files with 92 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

92
README.md Normal file
View File

@ -0,0 +1,92 @@
**Project Developer: Alireza Adli**
alireza.adli@mail.concordia.ca
## Table of Contents
[About mtl_gis_oo](#about-gispy)
[scrub_layer_class.py](#scrublayer)
[handle_mtl_ds_workflow.py](#handle_mtl_ds_workflowpy)
[standalone_vs.py](#standalone_vspy)
[Setting up an environment to use standalone PyQGIS – How to import qgis.core](#setting-up)
<a name="about-gispy"/>
## About mtl_gis_oo
This project automates the process of integrating and cleaning updated datasets related to Montreal buildings with an object-oriented approach.
It is the continuation of non-object-oriented project namely [hydroquebec_archetype_gispy](https://ngci.encs.concordia.ca/gitea/a_adli/hydroquebec_archetype_gispy). The project involves the following datasets:
1. [NRCAN Building Footprints](https://open.canada.ca/data/en/dataset/7a5cda52-c7df-427f-9ced-26f19a8a64d6)
2. [Shared platform of geospatial data and aerial photographs (GeoIndex)](https://geoapp.bibl.ulaval.ca/)
3. [Montreal Property Assesment Units](https://donnees.montreal.ca/dataset/unites-evaluation-fonciere)
4. [Administrative boundaries of the agglomeration of Montréal (boroughs and related cities)](https://donnees.montreal.ca/dataset/limites-administratives-agglomeration)
The workflow has been developed and implemented in ArcGIS. This workflow (link) involves steps such as fixing geometries, clipping unnecessary parts of the map, splitting sections based on single building footprints, spatially joining datasets, and cleaning the data through processes such as removing duplicates, among others.
GISPy integrates these processes and automates them so that users can update the dataset by running the workflow module (mtl_buildings_workflow.py) after acquiring and defining the paths to the mentioned datasets.
GISPy has been written using QGIS Python standalone libraries (PyQGIS). This set of libraries leverages the functionality of QGIS without needing to run the full QGIS desktop application. To use the environment, QGIS needs to be installed, and the environment must be set up ([Setting up an environment to use standalone PyQGIS – How to import qgis.core](#setting-up)).
<a name="#scrublayer"/>
## scrub_layer_class.py
This module is the essence of the mtl_gis_oo project. It encompasses required functionalities of PyQGIS as methods. Some other methods also have been added to use the functionalities in a specific way. For example, clip_by_multiply carry outs PyQGIS clipping using multiple overlay layers.
<a name="#handle_mtl_ds_workflowpy"/>
## handle_mtl_ds_workflow.py
This is the process of cleaning and aggregating Montreal buildings datasets. This workflow is backed up by scrub_layer_class.py. After defining the paths, running the module outputs the updated and integrated dataset (map layer).
## scrub_mtl_class.py
This module is not being used or developed right now.
<a name="standalone_vs.py"/>
## standalone_vs.py
This module provides the preliminary settings for using PyQGIS.
<a name="setting-up"/>
## Setting up an environment to use standalone PyQGIS – How to import qgis.core
#pyqgis #qgis #path #pythonpath
To use PyQGIS without having the QGIS application run in the background, one needs to add the python path to the environment variables. Here is how to do it on Windows:
1. Install QGIS
2. Assign a specific name to the QGIS Python executable:
This is being done in order to access the QGIS Python from the command prompt without mixing with the system’s original Python installation(s).
a. Go to the QGIS installation directory’s Python folder. e.g. C:\Program Files\QGIS 3.34.1\apps\Python39
b. Duplicate the Python executable (python.exe) by copy-pasting it
c. Rename the duplicated version. e.g. pythonqgis.exe
3. Updating the Path variables
a. Go to Environmental Variables (from Windows start)
b. Click on Path and then click on Edit. Add the following paths:
> i. C:\Program Files\QGIS 3.34.1\apps\Python39\pythonqgis
> ii. C:\Program Files\QGIS 3.34.1\apps\Python39
c. Go back to the Environmental variables this time click on New and in New Variable box enter PYTHONPATH and in the Variable Value add the following paths (separate them with a colon). Some paths might be different. For example, apps\qgis can be apps\qgis-ltr.
> i. C:\Program Files\QGIS 3.34.1\apps\qgis\python
> ii. C:\Program Files\QGIS 3.34.1\apps\qgis\python\plugins
> iii. C:\Program Files\QGIS 3.34.1\apps\Qt5\plugins
> iv. C:\Program Files\QGIS 3.34.1\apps\gdal\share\gdal
> v. Or altogether: C:\Program Files\QGIS 3.34.1\apps\qgis\python;C:\Program Files\QGIS 3.34.1\apps\qgis\python\plugins;C:\Program Files\QGIS 3.34.1\apps\Qt5\plugins;C:\Program Files\QGIS 3.34.1\apps\gdal\share\gdal
4. Validate importing qgis.core
a. Open a command prompt window
b. Enter pythonqgis
c. If the process has been done correctly, you won’t face any error.
d. In the Python environment, import the package by:
> i. Either import qgis.core
> ii. Or from qgis.core import \*