diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index 1623a0c..fea6fb5 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -4,6 +4,9 @@ on: push: branches: - main + pull_request: + branches: + - main jobs: build: diff --git a/README.md b/README.md index 81c9fd8..8867856 100644 --- a/README.md +++ b/README.md @@ -1,1013 +1,302 @@ -# Gender Enabling Environments Spatial Tool (GEEST) -This tool employs a multicriteria evaluation (MCE) framework to spatially describe womens' access to formal employment and business opportunities in the renewable energy sector in Small Island Developing States (SIDS). The MCE framework allows for the incorporation and assessment of dimensions, factors, and indicators to identify where the enabling environments (or lack thereof) are located for women to secure employment opportunities in SIDS. +# Geospatial Assessment of Women Employment and Business Opportunities in the Renewable Energy Sector + +With support from the [Canada Clean Energy and Forest Climate Facility (CCEFCFy)](https://www.worldbank.org/en/topic/climatechange/brief/canada-world-bank-clean-energy-and-forests-climate-facility), the [Geospatial Operational Support Team (GOST, DECSC)](https://worldbank.github.io/GOST) launched the project "Geospatial Assessment of Women Employment and Business Opportunities in the Renewable Energy Sector." The project aims to propose a novel methodology and generate a geospatial open-source tool for mapping the enabling environments for women in a country that can inform new energy projects to support the advancement of women's economic empowerment in SIDS while contributing to closing gender gaps in employment in the RE sector. + +![image](docs/images/img01.png) + +![image](docs/images/img02.png) + +Countries included in the project: + + + +| AFRICA | LATIN AMERICA AND CARIBBEAN | EAST ASIA AND PACIFIC | SOUTH ASIA | +| --- | --- | --- | --- | +| Cabo Verde | Antigua and Barbuda | Federated States of Micronesia | Maldives | +| Comoros | Belize | Fiji  | | +| Guinea-Bissau | Dominica | Kiribati | | +| Mauritius | Dominican Republic | Marshall Islands | | +| São Tomé and Príncipe | Grenada | Nauru | |   +| | Guyana | Niue | |   +| | Haiti | Palau | |   +| | Jamaica | Papua New Guinea | |   +| | St. Lucia | Samoa | |   +| | St. Vincent and Grenadines | Solomon Islands | | +| | Suriname | Timor-Leste | |   +| | | Tonga | |   +| | | Tuvalu | |   +| | | Vanuatu | | +   + + +**Project Components** + +The project is divided into six main components: + + 1. [Gender Spatial Data Gap Assessment](gender-spatial-data-gap-assessment) + 2. [Geospatial Databases](geospatial-databases) + 3. [Novel Analytical Framework](novel-analytical-framework) + 4. [Gender Enabling Environments Tool (GEEST)](gender-enabling-environments-tool-geest) + 5. [Implementation](implementation) + 6. [GEEST Main Limitations](geest-main-limitations) + +(gender-spatial-data-gap-assessment)= + +## 1. Gender Spatial Data Gap Assessment + +This undertaking involved the identification and compilation of essential open-source geospatial information layers that are crucial for assessing women's development, employment, and business prospects within the Renewable Energy (RE) sector. A thorough research was conducted for 59 data layers within each country, organized into 12 thematic categories. The table below presents the 59 layers identified during the desk research, grouped into 12 categories, as outlined below + +
+ +This effort resulted in a Data Gap Analysis Report for each of the 31 SIDS included in the project. The report for each country provides a comprehensive overview of the findings derived from an extensive data gap analysis, specifically centered on women in SIDS and their access (or lack thereof) to employment opportunities within the RE sector. This endeavor entailed thorough desk-based research, necessitating a detailed exploration of both spatial and non-spatial data sources that are publicly available. The focus was on identifying critical open sources, evaluating the resolution and quality of the data, and specifying any pertinent gaps or missing information in each country. The reports are available here: + + + +| **Reference Data** | +| --- | +| Administrative boundaries | +| Location and outline of cities/villages | +| Building footprints |   +| **Demographics and Population** | +| Population Density |   +| Level of Education |   +| Age | +| Wealth Index | +| Female-Headed Households |   +| Average Number of Children |   +| Adolescent Fertility Rate |   +| Share of Female University Graduates, STEM | +| Tertiary -Post Secondary- Education Attainment |   +| Secondary Education Attainment | +| Agency of Women: Sexual Relations, Contraception, Reproductive Care |   +| **Renewable Energy** | +| Existing RE: Solar Plants | +| Potential RE Project Sites: Solar | +| Potential RE Project Sites: Wind | +| Potential RE Project Sites: Wind Offshore | +| **Energy Access** | +| Location of Power Plants |   +| Location of Stations and Substations |   +| Grid Network: Transmission + Distribution |   +| Prevalence of Energy Source | +| Measure of Visible Light at Nighttime |   +| Electrification Rates |   +| Access to Electricity/Community |   +| Access to Reliable Electricity/Community |   +| **Education** | +| Location Universities |   +| Location Technical Schools |   +| **Jobs and Finance** | +| Financial Facilities | +| Labor in Industry Sector, Gender-Disaggregated |   +| % Female Managers/Entrepreneurship | +| % Women in Middle/High Management Positions | +| Economic Participation and Opportunities Gap Score | +| Unpaid Domestic Work (% of day) | +| **Digital Inclusion** | +| Access to Broadband Rates |   +| Digital Literacy Rates |   +| **Transportation** | +| Road Network | +| Public Transportation Networks |   +| Public Transportation Stops |   +| Ports | +| Airports | +| Mobility Dataset | +| Commuting Zones | +| **Safety** | +| Crime Incidence: Serious Assaults | +| Crime Incidence: Sexual Violence | +| Prevalence of Domestic Violence | +| Trust in the Police |   +| **Amenities** | +| Location of Hospitals |   +| Location of Grocery Stores |   +| Location of Playgrounds and Parks |   +| Location of Daycares/Elementary Schools |   +| **Climate/Earth (5 datasets, four in GDB)** | +| Average Rainfall |   +| Coastal Flood Risk |   +| Vegetation Areas | +| Waterways | +| **Law/Policy/Government** | +| Sexual and Reproductive Health and Rights (% developed) | +| Length of Paid Maternity Leave (days) | +| Legislation Against Domestic Violence | +| Non-Discrimination Employment Legislation: Gender-Based | +| Legislation Against Sexual Harassment in Employment |   +| National Parliament Seats Held by Women (%) | +| Missing Data from SDGs | + + + +The following figure summarizes the data availability concerning the 59 datasets examined for each country: + +:::{figure-md} markdown-fig +Proportion of data availability for the 59 datasets, by country + +Proportion of data availability for the 59 datasets, by country +::: + +(geospatial-databases)= -- The spatial GDBs for all SIDS can be accessed [here](https://datacatalog.worldbank.org/search/collections/genderspatial). -- The methodology report can be accessed [here](https://documents.worldbank.org/en/publication/documents-reports/documentdetail/099121123091527675/p1792120dc820d04409928040a279022b42). +## 2. Geospatial Databases -## User Manual +In parallel with the Gender Data Gap Assessment, a comprehensive geospatial database was compiled for each of the 31 Small Island Developing States (SIDS) Targeted in the project. The repository containing the geospatial databases can be found in the following link: + +Examples of data layers present in the GDB for select countries: + +![image](docs/images/img04.png) + +![image](docs/images/img05.jpg) + +![image](docs/images/img06.jpg) + +(novel-analytical-framework)= + +## 3. Novel Analytical Framework + +An extensive literature review, focusing on the barriers women face in securing jobs, particularly within SIDS, was conducted. This comprehensive review resulted in the formulation of a Multicriteria Evaluation (MCE) framework comprising 23 key factors, both spatial and non-spatial, that affect women’s job opportunities, categorized into four dimensions: Individual, Contextual, Accessibility, and Place Characterization. The latter two dimensions concentrate on geographical factors. For a comprehensive understanding of the Analytical Framework and the associated methodology employed to evaluate women's spatial access to employment opportunities, please refer to the Methodology Report available at the following link: + +![image](docs/images/img07.png) -- [Gender Enabling Environments Spatial Tool (GEEST)](#gender-enabling-environments-spatial-tool-geest) - - [User Manual](#user-manual) - - [1 Install QGIS](#1-install-qgis) - - [2 Install Open Route Service (ORS) plugin](#2-install-open-route-service-ors-plugin) - - [3 Installing Plugin on local device](#3-installing-plugin-on-local-device) - - [4 Using the Plugin](#4-using-the-plugin) - - [ 4.1 SETUP TAB](#-41-setup-tab) - - [4.2 INDIVIDUAL TAB](#42-individual-tab) - - [4.2.1 Education](#421-education) - - [4.2.2 Care Responsibilities](#422-care-responsibilities) - - [4.2.3 Domestic Violence](#423-domestic-violence) - - [4.2.4 Aggregate](#424-aggregate) - - [4.3 CONTEXTUAL TAB](#43-contextual-tab) - - [4.3.1 Policy and Legal Protection](#431-policy-and-legal-protection) - - [4.3.2 Access to Finance](#432-access-to-finance) - - [4.3.3 Aggregate](#433-aggregate) - - [4.4 ACCESSIBILITY TAB](#44-accessibility-tab) - - [4.4.1 Women's Travel Patterns](#441-womens-travel-patterns) - - [4.4.2 Access to Public Transport](#442-access-to-public-transport) - - [4.4.3 Access to Education and Training Facilities](#443-access-to-education-and-training-facilities) - - [4.4.4 Access to Jobs in the RE sector](#444-access-to-jobs-in-the-re-sector) - - [4.4.5 Access to Health Facilities](#445-access-to-health-facilities) - - [4.4.6 Access to Financial Facilities](#446-access-to-financial-facilities) - - [4.4.7 Aggregate](#447-aggregate) - - [4.5 PLACE CHARACTERIZATION TAB](#45-place-characterization-tab) - - [4.5.1 Active Transport](#451-active-transport) - - [4.5.2 Availability of Public Transport](#452-availability-of-public-transport) - - [4.5.3 Safe Urban Design](#453-safe-urban-design) - - [4.5.4 Security](#454-security) - - [4.5.5 Income Level](#455-income-level) - - [4.5.6 Electricity Access](#456-electricity-access) - - [4.5.7 Level of Urbanization](#457-level-of-urbanization) - - [4.5.8 Size of Housing](#458-size-of-housing) - - [4.5.9 Digital Inclusion](#459-digital-inclusion) - - [4.5.10 Natural Environment and Climatic Factors](#4510-natural-environment-and-climatic-factors) - - [4.5.11 Aggregate](#4511-aggregate) - - [4.6 DIMENSION AGGREGATION TAB](#46-dimension-aggregation-tab) - - [4.7 ABOUT TAB](#47-about-tab) - - [4.8 INSIGHTS TAB](#48-insights-tab) - - [4.8.1 Enablement](#481-enablement) - - [4.8.2 RE Zone Raster Locations](#482-re-zone-raster-locations) - - [4.8.3 RE Point Locations](#483-re-point-locations) - - [5 Troubleshooting](#5-troubleshooting) - - [5.1 ACCESSIBILTY TABS PERMISSIONS ERROR](#51-accessibilty-tabs-permissions-error) - - [5.2 QGIS PLUGIN/INTERFACE WIDGETS AND TEXT ARE DISTORTED AND SCALED INCORRECTLY](#52-qgis-plugininterface-widgets-and-text-are-distorted-and-scaled-incorrectly) - - [5.3 RASTER OUTPUTS NOT BEING LOADED AND DISPLAYING CORRECTLY](#53-raster-outputs-not-being-loaded-and-displaying-correctly) - - [5.4 ERROR: OUTPUT DIRECTORY NOT SET](#54-error-output-directory-not-set) - - [5.5 ERROR: COUNTRY BOUNDARY POLYGON NOT SET](#55-error-country-boundary-polygon-not-set) - - [5.6 ERROR: CO-ORDINATE REFERENCE SYSTEM (CRS) NOT SET](#56-error-co-ordinate-reference-system-crs-not-set) - - [5.7 ALTERNATIVE WAY TO REFRESH THE PLUGIN IF IT FREEZES OR DOES NOT RUN AS EXPECTED](#57-alternative-way-to-refresh-the-plugin-if-it-freezes-or-does-not-run-as-expected) -- [List of CRSs for SIDS](#list-of-crss-for-sids) -- [License](#license) +(gender-enabling-environments-tool-geest)= -## 1 Install QGIS +## 4. Gender Enabling Environments Tool (GEEST) -1. The link below will take you to the QGIS website where you will be able to download the QGIS installation file. Note that it is possible to use older versions of QGIS, e.g. Version 3.28. +Based on the Methodological Framework, the GEEST, an open-source plugin in QGIS, was developed for the automatic computation of the factors and dimensions. The GEEST characterizes communities based on women's prospects to secure jobs or establish their own businesses within the RE sector. It aims to assist decision-makers in selecting optimal locations for RE projects, ensuring the maximum positive impact on communities and addressing gender disparities. Additionally, it provides insights for building the necessary infrastructure around RE projects to create enabling environments that enhance women's participation in the RE sector in SIDS. -QGIS website: [https://www.qgis.org/en/site/](https://www.qgis.org/en/site/) +The table below outlines the dimensions, factors, and recommended indicators for computing the GEEST, derived from the Methodological Framework: -![image](https://github.com/worldbank/GEEST/assets/120469484/e0448baf-9a0b-475e-9bc2-c883868318d2) +:::{figure-md} markdown-fig +Dimensions, Factors and indicators included in the Analytical Framework -2. Once the installation file is downloaded run the installation file. +Dimensions, Factors and indicators included in the Analytical Framework +::: -3. A pop-up window as seen in the image below should show up. Follow the prompts and leave all settings on default. +The GEEST generates raw score outputs for 21 of the 23 factors outlined in the Analytical Framework. The factors (i) Water and Sanitation and (ii) Fragility, Conflict, and Violence are absent due to lack of data availability. Each of the 21 factors, dimensions, and overall aggregate scores are assessed on a scale ranging from 0 to 5. -![image](https://github.com/worldbank/GEEST/assets/120469484/52464df3-b408-4d05-af88-c6ef4a55c599) +The interpretation of these scores is thoroughly detailed in the Methodology Report: . Higher scores signify a more conducive environment for women to access job opportunities. Conversely, scores of 0 indicate a lack of supportive conditions for women to access employment opportunities. To enhance comprehension, the methodology further categorizes these scores into distinct 'classes,' offering a simplified approach to their interpretation, as shown in the following table: +```{list-table} Proposed discrete score classes to enable simpler visual interpretation of raw score outputs and enable intersection with other layers of information (reproduced from the Methodology Report). +:header-rows: 1 +:name: Class Scores Table -## 2 Install Open Route Service (ORS) plugin +* - Score range + - Class + - Interpretation +* - 0.00-0.50 + - 0 + - Not enabling +* - 0.51-1.50 + - 1 + - Very low enabling +* - 1.51-2.50 + - 2 + - Low enabling +* - 2.51-3.50 + - 3 + - Moderately enabling +* - 3.51-4.50 + - 4 + - Enabling +* - 4.51-5.00 + - 5 + - Highly enabling +``` -1. Open QGIS, navigate to the "Plugins" tab and select the "Manage and Install Plugins…" option from the drop-down menu. +To access the User Manual for GEEST and the necessary installation files for QGIS, please visit the [User Guide](docs/user_guide.md) or the [GitHub repository](https://github.com/worldbank/GEEST). -![image](https://github.com/worldbank/GEEST/assets/120469484/1a2b1b0c-2a6f-49a6-b3d3-6e48386b7b22) +(implementation)= -2. The "Plugins" pop-up window should appear as seen in the image below. +## 5. Implementation -3. In the search bar type "ORS", select the "ORS Tool" from the list of plugins, and select the install button to install the plugin. +The GEEST was tested in three pilot countries – Comoros, Dominican Republic, and Papua New Guinea (PNG) – to assess its functionality. The selection of these countries was strategic, considering their varied geographic regions, income levels, sizes, population densities, and data availability. Testing the GEEST across such a broad range of conditions ensured that its usefulness, applicability, and functionality in different contexts could be accurately tested. The findings and insights derived from the GEEST implementation are documented in the Implementation Report, accessible through the following link: [insert link]. -![image](https://github.com/worldbank/GEEST/assets/120469484/6274c002-9b56-4374-8fd4-9278d2246afb) +#### INDIVIDUAL DIMENSION RESULTS IN PILOT COUNTRIES -4. You will now have to set up an account on the Open Route Service website which can be accessed by clicking the link below. +The Individual dimension contains factors that reflect a woman’s personal characteristics, such as physical, psychological, and socio-cultural characteristics. These factors can act as barriers or enablers to women’s career development and include care responsibilities, exposure to domestic violence, and education. Only the Dominican Republic included data for all three factors associated with the Individual Dimension. -ORS website: [https://openrouteservice.org/](https://openrouteservice.org/) +![image](docs/images/img09.png) -ORS Sign up: [https://openrouteservice.org/dev/#/signup](https://openrouteservice.org/dev/#/signup) +#### CONTEXTUAL DIMENSION IN PILOT COUNTRIES -![image](https://github.com/worldbank/GEEST/assets/120469484/79728902-e5ba-49c1-a262-32cd9df628a6) +The Contextual dimension encompasses factors that provide information concerning the legal and policy environment of places, which can influence workplace gender discrimination, women's financial independence, and the overall likelihood that women will be empowered to work outside the home. -5. Fill in all the necessary fields to sign up and then log into your account. +![image](docs/images/img10.png) -6. Request a standard token and provide a name for the Token. +#### ACCESIBILITY DIMENSION RESULTS IN PILOT COUNTRIES -![image](https://github.com/worldbank/GEEST/assets/120469484/72eb8f24-84b5-42e9-8da7-e19bf96d410a) +The Accessibility dimension includes factors that relate to the ease with which women can reach specific services or destinations and are often determined by proximity. These factors affect the day- to-day mobility of women. Accessibility factors found to be most relevant to women in SIDS include (i) women's travel patterns, (ii) access to public transport, (iii) access to education facilities, (iv) access to RE jobs, (v) access to health facilities, and (vi) access to financial facilities. -7. Once the token has been created, navigate to the Dashboard tab and click on the API key as seen in the image below. The API key should now be copied to the clipboard. +![image](docs/images/img11.png) -![image](https://github.com/worldbank/GEEST/assets/120469484/26564e04-4520-4022-9930-4b791df8e63f) +#### PLACE CHARACTERIZATION DIMENSION RESULTS IN PILOT COUNTRIES -8. In the QGIS window navigate the ORS tool and select "Provider Settings". +The Place-Characterization dimension contains factors that refer to attributes that are used to define a specific geographical location or environment and do not include a mobility component. Those deemed to be most important place-characterization factors concerning women’s access to jobs include (i) walkability, (ii) the availability of cycleways and public transport, (iii) safety, (iii) electricity access, (iv) digital inclusion, (v) fragility, conflict, and violence, (vi) access to water and sanitation, and (vii) natural environment and climatic factors. -![image](https://github.com/worldbank/GEEST/assets/120469484/45a45354-8478-45df-b212-c477a99b2c9a) +![image](docs/images/img12.png) -9. The provider settings pop-up window should now appear as seen in the image below. +Below are some of the overall insights derived from the GEEST for the Dominican Republic. The first map illustrates the degree of enablement within environments; the second map shows the level of enablement concerning the female population on a raster 100x100m format. The third map focuses on this score exclusively within a 10 km radius of points of interest, specifically potential Renewable Energy (RE) sites. Meanwhile, the fourth map shows the results for the level of enablement concerning female population, aggregated at the lowest administrative level. -10. Past the API key that has been copied to the clipboard into the API Key field and press "OK". +:::{figure-md} markdown-fig +Raster results concerning enabling environments for the Dominican Republic -![image](https://github.com/worldbank/GEEST/assets/120469484/b255a792-4d46-42ef-a0ff-79edb1e2fd19) +Raster results concerning enabling environments for the Dominican Republic +::: -**N.B.** Additional credits can be requested on the ORS site by applying for the collaborative plan as described [here](https://openrouteservice.org/plans/). You will have to provide a brief motivation, however, if your application is in a humanitarian, academic, governmental, or not-for-profit organization, you should be eligible for the collaborative plan. +:::{figure-md} markdown-fig +Raster results concerning enabling environments with respect to women’s population for the Dominican Republic -This email address can also be used for further assistance: +Raster results concerning enabling environments with respect to women’s population for the Dominican Republic +::: -support@openrouteservice.heigit.org +![image](docs/images/img15.png) -## 3 Installing Plugin on local device +:::{figure-md} markdown-fig +Point location (RE sites) results concerning enabling environments with respect to women’s population for the DR -1. Click on the green "Code" button and select the "Download ZIP" option. +Point location (RE sites) results concerning enabling environments with respect to women’s population for the DR +::: -![image](https://github.com/worldbank/GEEST/assets/120469484/af517d0b-8b32-43b6-a664-0bb250a1d620) +:::{figure-md} markdown-fig +Aggregate results concerning enabling environments with respect to women’s population for the Dominican Republic -2. Once the download has been completed extract the contents of the ZIP file. +Aggregate results concerning enabling environments with respect to women’s population for the Dominican Republic +::: -3. Navigate to your extracted ZIP folder and copy the _requirements.txt_ file. +If the job opportunities' location layer is presented in raster format, the GEEST can generate scores specifically for the regions where employment prospects exist, emphasizing opportunities exclusively within those areas. -![image](https://github.com/worldbank/GEEST/assets/120469484/6adea1a2-e63c-4067-9052-346811697828) +:::{figure-md} markdown-fig +Raster results concerning enabling environments in RE sites with respect to women’s population for the DR -4. Navigate to the QGIS program folder and paste the _requirements.txt_ file into it. The file path would be similar to this: _C:\Program Files\QGIS 3.32.0_ as seen in the image under **step 5**. +Raster results concerning enabling environments in RE sites with respect to women’s population for the DR +::: -5. Run the _OSGeo4W_ batch file. +Likewise, the GEEST has the capability to aggregate results solely within the administrative zones where jobs are situated. -![image](https://github.com/worldbank/GEEST/assets/120469484/9a8376bb-dc50-41fa-a3fd-f3e0757a3850) +:::{figure-md} markdown-fig +Aggregate results concerning enabling environments near RE sites with respect to women’s population for the DR -6. A command line pop-up window will appear as seen in the image below. +Aggregate results concerning enabling environments near RE sites with respect to women’s population for the DR +::: -7. Type the following into it and press Enter. -```pip install -r requirements.txt``` +(geest-main-limitations)= -![image](https://github.com/worldbank/GEEST/assets/120469484/ed373467-0f80-4b75-8931-9c9e2d03d013) +## 6. GEEST Main Limitations -8. All the Python libraries that the Plugin is dependent on will now be installed. This can take a few minutes to install. +#### Data Availability and Granularity -9. Once the installations are complete you can close the command line pop-up window. +The effectiveness of GEEST relies heavily on the quality of open-source data. Therefore, it is imperative to underscore that the principal limitation of the tool in its current state originates from the scarcity of open-source data in SIDS and the limited granularity of the available data. -10. Open QGIS, navigate to the "Plugins" tab and select the "Manage and Install Plugins…" option from the drop-down menu. +#### Processing Time -![image](https://github.com/worldbank/GEEST/assets/120469484/39e233a5-15de-4471-9560-028cd8cde839) +The processing of factors within the Accessibility dimension is notably slow. Subsequent enhancements should prioritize the reduction of computational demands for calculating these indicators. -11. In the plugin pop-up window navigate to the "Install from ZIP" tab. +#### Methodological Deviations -![image](https://github.com/worldbank/GEEST/assets/120469484/9ed559bc-5672-4631-a33d-714710440819) +The Place Characterization factors pose challenges due to restricted data availability, necessitating deviations from the proposed geoprocessing techniques outlined in the methodology. The granularity of GEEST's output is confined by available data, suggesting potential refinement opportunities in geoprocessing procedures with improved data access or alternative methods to those specified in the methodology. -12. From the "Install from ZIP" tab navigate back to your extracted ZIP folder and select the "gender\_indicator\_tool" compressed (zipped) folder as seen in the image below. +#### Lack of Specialized Urban-Rural Analyses -![image](https://github.com/worldbank/GEEST/assets/120469484/f2e81343-1bb4-4dc1-b593-38c26726f767) - -13. Once the ZIP file has been selected click on "Install Plugin". - -14. Once the plugin has been installed navigate to the "All" tab. - -15. In the search bar type "GEEST" and click the check box next to the "Gender Enabling Environments Spatial Tool (GEEST)" to install the plugin. - -![image](https://github.com/worldbank/GEEST/assets/120469484/aac4db6e-3585-40dc-9e73-d0eb3a8bc247) - -16. The plugin is now installed and you should now be able to access it in your toolbar or under the Plugin's tab as seen in the image below. - -![image](https://github.com/worldbank/GEEST/assets/120469484/eceaf443-ff8b-4be0-9282-a1236a03bb86) - -## 4 Using the Plugin -Examples of files that can be used as input at a particular step as per the Pilot Country Database will be indicated at the end of the step. The following format will be used: - -**Input File:** *Folder/file_name* --> *AccessFinance/Access_to_finance.shp* - -### 4.1 SETUP TAB - -![image](https://github.com/worldbank/GEEST/assets/120469484/6ff06edc-198a-4807-a59f-038f1b401d43) - -1. Create a project folder that will be used to store all tool outputs. - -3. Set the output directory to the project folder created in the previous step. - -5. Set the country boundary layer by navigating to and selecting the **Admin 0** country boundary polygon shapefile for the country you want to analyze. - - **Input File:** *AdminBoundaries/Admin0.shp* - -7. Select the appropriate coordinate reference system (CRS) from the QGIS CRS database. - -**Appendix A** _lists all the CRS to be used for the SIDS countries._ - -5. Copy and paste the EPSG code for your specific country and paste it in the Filter bar as seen in the image below. - -![image](https://github.com/worldbank/GEEST/assets/120469484/5e9d2066-c641-4129-8e4c-a876b19da8a2) - -6. Select the CRS from the list and click "OK". - -7. Set your preferred output raster output resolution in meters squared. - -### 4.2 INDIVIDUAL TAB - -#### 4.2.1 Education - -![image](https://github.com/worldbank/GEEST/assets/120469484/783752ba-77a9-4c37-95ad-d5ffb34b9bf7) - -1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of women who have achieved a post-secondary education. - - **Input File:** *Education/Level_of_education* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of women who have achieved a post-secondary education. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/EDU_Raster_output.tif*) - -#### 4.2.2 Care Responsibilities - -![image](https://github.com/worldbank/GEEST/assets/120469484/a22a693d-7979-442a-9e6d-b485417d8fad) - -1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of time women spend on care responsibilities or household activities. - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of time women spend on care responsibilities or household activities. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/CRE_Raster_output.tif*) - -#### 4.2.3 Domestic Violence - -![image](https://github.com/worldbank/GEEST/assets/120469484/b2b9e9e9-cb5c-4251-b495-2ee10ea8f404) - -1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of women who have suffered domestic violence. - - **Input File:** *DomesticViolence/Prevalence_of_domestic_violence.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of women who have suffered domestic violence. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/DOV_Raster_output.tif*) - -#### 4.2.4 Aggregate - -![image](https://github.com/worldbank/GEEST/assets/120469484/e9e14c68-2111-4377-9ea2-bc73c6241fc1) - -1. Load the raster outputs generated in each of the previous factor tabs for the Individual Dimension. - -_If a factor was executed in the same work session, its file path will automatically be populated after execution._ - -2. If factors are missing adjust the weighting percentage accordingly and ensure it totals to 100%. - -_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ - -3. Enter an alternate aggregated raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. - -7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/AGG_Raster_output.tif*) - -### 4.3 CONTEXTUAL TAB - -#### 4.3.1 Policy and Legal Protection - -![image](https://github.com/worldbank/GEEST/assets/120469484/ab6797a8-b09e-4a6e-92c8-6e2b664d17c0) - -1. Navigate to and select polygon input shapefile containing a field reporting a percentage representing the level of protective policies afforded to women. - - **Input File:** *PolicyLegal/Regulatory_Framework_Law_agg.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing a percentage representing the level of protective policies afforded to women. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/PLP_Raster_output.tif*) - -#### 4.3.2 Access to Finance - -![image](https://github.com/worldbank/GEEST/assets/120469484/2e4050cd-d458-4b19-9876-b434431b68c7) - -1. Navigate to and select polygon input shapefile containing a field reporting the percentage of women who have a bank account. - - **Input File:** *AccessFinance/Access_to_finance.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of women who have a bank account. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/FIN_Raster_output.tif*) - -#### 4.3.3 Aggregate - -![image](https://github.com/worldbank/GEEST/assets/120469484/bcf2260d-5db0-4be5-a583-ac9d0537e35c) - -1. Load the raster outputs generated in each of the previous factor tabs for the Contextual Dimension. - -_If a factor was executed in the same work session, its file path will automatically be populated after execution._ - -2. If factors are missing adjust the weighting percentage accordingly and ensure it totals to 100%. - -If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension. - -3. Enter an alternate aggregated raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. - -7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/AGG_Raster_output.tif*) - -### 4.4 ACCESSIBILITY TAB - -#### 4.4.1 Women's Travel Patterns - -![image](https://github.com/worldbank/GEEST/assets/120469484/6541477e-2ff8-4878-8962-3abb48e4ce43) - -1. Navigate to and select point shapefile input of facilities related to women's role as caregivers. This includes: - - Childcare facilities - - Primary and secondary schools - - Markets - - Grocery stores - - Recreational areas - - **Input File:** *Amenities/Daycares_elementary_schools.shp* - - **Input File:** *Amenities/Grocery_stores.shp* - -2. Select the mode of travel (Walking OR Driving). - -3. Select the method of measurement (Distance OR Time). - -4. Specify travel distance or time increments in meters or time respectively using comma delimitation. - -5. Edit the facility raster output file name for each unique type of facility. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The output raster file will be stored in the project folder specified in the "Setup" tab, in the "WTP" folder under the "Accessibility" folder. (*Project_Folder/Accessibility/WTP/Facility_Raster_output.tif*) - -**Steps 1 – 8 will have to be repeated for all facility types**. - -9. Once all facilities have completed the processing, move on to the next step and enter the aggregated raster output file name. - -10. Click the "Aggregate" button to run the algorithm. - -11. Status text next to the "Execute" button will appear and let you know once processing is complete. - -12. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Accessibility/WTP_Raster_output.tif*) - -#### 4.4.2 Access to Public Transport - -![image](https://github.com/worldbank/GEEST/assets/120469484/ade68b40-f9f4-477c-a631-3ed137b71e27) - -1. Navigate to and select point shapefile input for public transport stops. - - **Input File:** *PubTransportStops/Public_transportation_stops.shp* - -3. Select the mode of travel (Walking OR Driving). - -4. Select the method of measurement (Distance OR Time). - -5. Specify travel distance or time increments in meters or time respectively using comma delimitation. - -6. Enter an alternate raster output file name if desired. - -7. Click the "Execute" button to run the algorithm. - -8. Status text next to the "Execute" button will appear and let you know once processing is complete. - -9. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/PBT_Raster_output.tif*). - -#### 4.4.3 Access to Education and Training Facilities - -![image](https://github.com/worldbank/GEEST/assets/120469484/0899eb4e-9547-4d7a-9a30-95082ebb71dc) - -1. Navigate to and select point shapefile input of education and training facilities. - - **Input File:** *EducationFacilities/Techncal_schools.shp* - - **Input File:** *EducationFacilities/Universities.shp* - -3. Select the mode of travel (Walking OR Driving). - -4. Select the method of measurement (Distance OR Time). - -5. Specify travel distance or time increments in meters or time respectively using comma delimitation. - -6. Enter an alternate raster output file name if desired. - -7. Click the "Execute" button to run the algorithm. - -8. Status text next to the "Execute" button will appear and let you know once processing is complete. - -9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/ETF_Raster_output.tif*). - -#### 4.4.4 Access to Jobs in the RE sector - -![image](https://github.com/worldbank/GEEST/assets/120469484/572b704c-830a-40c4-96f0-6dceb7e6100d) - -1. Navigate to and select point shapefile input of jobs or job facilities. - -3. Select the mode of travel (Walking OR Driving). - -4. Select the method of measurement (Distance OR Time). - -5. Specify travel distance or time increments in meters or time respectively using comma delamination. - -6. Enter an alternate raster output file name if desired. - -7. Click the "Execute" button to run the algorithm. - -8. Status text next to the "Execute" button will appear and let you know once processing is complete. - -9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/JOB_Raster_output.tif*). - -#### 4.4.5 Access to Health Facilities - -![image](https://github.com/worldbank/GEEST/assets/120469484/c38e5cb6-2264-4bd3-8e53-56c19d8213e4) - -1. Navigate to and select point shapefile input of health care facilities. - - **Input File:** *HealthFacilities/Hospitals.shp* - -3. Select the mode of travel (Walking OR Driving). - -4. Select the method of measurement (Distance OR Time). - -5. Specify travel distance or time increments in meters or time respectively using comma delimitation. - -6. Enter an alternate raster output file name if desired. - -7. Click the "Execute" button to run the algorithm. - -8. Status text next to the "Execute" button will appear and let you know once processing is complete. - -9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder. (*Project_Folder/Accessibility/HEA_Raster_output.tif*) - -#### 4.4.6 Access to Financial Facilities - -![image](https://github.com/worldbank/GEEST/assets/120469484/bd2bace8-e569-4b23-a4c0-a6024fe2adf6) - -1. Navigate to and select point shapefile input of financial facilities. - - **Input File:** *FinancialFacilities/Financial_Facilities.shp* - -3. Select the mode of travel (Walking OR Driving). - -4. Select the method of measurement (Distance OR Time). - -5. Specify travel distance or time increments in meters or time respectively using comma delamination. - -6. Enter an alternate raster output file name if desired. - -7. Click the "Execute" button to run the algorithm. - -8. Status text next to the "Execute" button will appear and let you know once processing is complete. - -9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/FIF_Raster_output.tif*). - -#### 4.4.7 Aggregate - -![image](https://github.com/worldbank/GEEST/assets/120469484/ba3c884c-5940-4255-9ca5-9e202ae106b8) - -1. Load the raster outputs generated in each of the previous factor tabs for the Accessibility Dimension. - -_If a factor was executed in the same work session, the file path will automatically be populated after execution._ - -2. If factors are missing, adjust the weighting percentage accordingly and ensure it totals to 100%. - -_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ - -3. Enter alternate aggregated raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. - -7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Accessibility/AGG_Raster_output.tif*). - -### 4.5 PLACE CHARACTERIZATION TAB - -#### 4.5.1 Active Transport - -![image](https://github.com/worldbank/GEEST/assets/120469484/bf89b9ad-7ecc-460c-a7d9-38f1a894176a) - -1. Navigate to and select polyline road network shapefile. - - **Input File:** *Roads/Roads.shp* - -3. Click the "Set" button to extract all the fields from the polyline input layer. - -4. Select the field containing the road type categorical values. - -5. Click the "Unique Values" button to extract all the unique road type values. - -6. Score each of the extracted road types from 1 to 5 based on local knowledge, where 5 is a road type that is very safe for walking and cycling and 1 is an unsafe road type. - -7. Enter an alternate raster output file name if desired. - -8. Click the "Execute" button to run the algorithm. - -9. Status text next to the "Execute" button will appear and let you know once processing is complete. - -10. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/WLK_Raster_output.tif*). - -#### 4.5.2 Availability of Public Transport - -!![image](https://github.com/worldbank/GEEST/assets/120469484/8dd068ae-b4dd-447c-bef0-0e57c8f4db17) - -1. Navigate to and select point shapefile input for public transport stops. - - **Input File:** *PubTransportStops/Public_transportation_stops.shp* - -3. Set hexagon grid size. The default is 1km. - -The smaller size the more computationally intensive the algorithm will be. - -3. Enter an alternate raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/APT_Raster_output.tif*). - -#### 4.5.3 Safe Urban Design - -![image](https://github.com/worldbank/GEEST/assets/120469484/2ab8874d-50cb-4445-9bac-3231b8328fb7) - -1. Navigate to and select nighttime lights raster input. - - **Input File:** *Electricity/Nighttime_Lights_2021.tif* - -3. Enter an alternate raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/SAF_Raster_output.tif*). - -### 4.5.4 Security - -![image](https://github.com/worldbank/GEEST/assets/120469484/10d4eb39-51b9-421d-b105-46466f4b3ba9) - -1. Navigate to and select the crime rate polygon input shapefile containing a field reporting the crime rate for a specific incident. - - **Input File:** *Security/Crime_Incidence_Serious_Assaults.shp* - - **Input File:** *Security/Crime_Incidence_Sexual_Violence.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the crime rate. - -5. Enter the raster output file name for the crime type. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The output raster file will be stored in the project folder specified in the "Setup" tab, in the "SEC" folder under the "Accessibility" folder (*Project_Folder/Place Characterization/SEC/Incidents_Raster_output.tif*). - -**Steps 1 – 8 will have to be repeated for all facility types**. - -8. Once all crime types have completed the processing, enter the aggregated raster output file name. - -9. Click the "Aggregate" button to run the algorithm. - -10. Status text next to the "Execute" button will appear and let you know once processing is complete. - -11. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Place Characterization/SEC_Raster_output.tif*) - -#### 4.5.5 Income Level - -![image](https://github.com/worldbank/GEEST/assets/120469484/c1a88898-25a9-47ba-83a3-567bbf525f1a) - -1. Navigate to and select the wealth index polygon input shapefile containing a field with the wealth index. - - **Input File:** *Income/Wealth_Index.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the wealth index. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/INC_Raster_output.tif*). - -#### 4.5.6 Electricity Access - -![image](https://github.com/worldbank/GEEST/assets/120469484/1a37676f-d82f-44bd-a554-9fcb854ce42d) - -1. Navigate to and select electricity access polygon input shapefile containing a field indicating the percentage of individuals that have access to electricity. - - **Input File:** *Electricity/Electrification_rate.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of individuals that have access to electricity. - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/ELC_Raster_output.tif*). - -OR - -1. Navigate to and select nighttime lights raster input. - - **Input File:** *Electricity/Nighttime_Lights_2021.tif* - -3. Enter the raster output file name. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/ELC_Raster_output.tif*). - -**N.B. If nighttime lights raster data is used for the "Safe Urban Design" factor it should not be used in the "Electrical Access" factor and vice-versa** - -#### 4.5.7 Level of Urbanization - -![image](https://github.com/worldbank/GEEST/assets/120469484/8776fd6c-8f40-4584-b517-a8610b867dd6) - -1. Navigate to and select GHS-SMOD raster input. - - **Input File:** *Urbanization/GHS_SMOD_E2020_GLOBE_R2023A_54009_1000_V1_0_R7_C12.tif* - -3. Enter an alternate raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/LOU_Raster_output.tif*). - -#### 4.5.8 Size of Housing - -![image](https://github.com/worldbank/GEEST/assets/120469484/b50b4538-6610-438b-b90a-4ee0c9462dc4) - -1. Navigate to and select the building footprints polygon shapefile. - - **Input File:** *Housing/Building_footprint.shp* - -3. Set hexagon grid size. The default is 1 km. - -The smaller size the more computationally intensive the algorithm will be. - -3. Enter an alternate raster output file name if desired. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/QUH_Raster_output.tif*). - -#### 4.5.9 Digital Inclusion - -![image](https://github.com/worldbank/GEEST/assets/120469484/de34e9da-6e68-4d09-bec5-84755bb35545) - -1. Navigate to and select the polygon input shapefile containing a field indicating the percentage of houses with internet access. - - **Input File:** *Digital/Access_to_broadband_rates_community.shp* - -3. Click the "Set" button to extract all the fields from the polygon input layer. - -4. Select the field containing the numeric value representing the percentage of houses with Internet access - -5. Enter an alternate raster output file name if desired. - -6. Click the "Execute" button to run the algorithm. - -7. Status text next to the "Execute" button will appear and let you know once processing is complete. - -8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/DIG_Raster_output.tif*). - -#### 4.5.10 Natural Environment and Climatic Factors - -![image](https://github.com/worldbank/GEEST/assets/120469484/2b0a1b43-6f34-436e-a790-5516027d291a) - -1. Navigate to and select polygon hazard shapefile. - - **Input File:** *Environment/Flood_risk.shp* - -3. Click the "Set" button to extract all the fields from the polyline input layer. - -4. Select the field containing the descriptive risk level values. - -5. Click the "Unique Values" button to extract all the unique risk level values. - -6. Score each of the extracted risk levels from 1 to 5, where 5 is the lowest risk and 1 is the highest risk. - -7. Enter hazard type raster output file name. - -8. Click the "Execute" button to run the algorithm. - -9. Status text next to the "Execute" button will appear and let you know once processing is complete. - -10. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder. (*Project_Folder/Place Characterization/ENV/Hazard_Raster_output.tif*) - -**Steps 1 – 9 will have to be repeated for all hazard types**. - -10. Once all hazard types have been processed, enter the aggregated raster output file name. - -11. Click the "Aggregate" button to run the algorithm. - -12. Status text next to the "Execute" button will appear and let you know once processing is complete. - -13. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/ENV_Raster_output.tif*). - -#### 4.5.11 Aggregate - -![image](https://github.com/worldbank/GEEST/assets/120469484/bedf9d85-63c5-4cd9-857a-c726ef77a89a) - -1. Load the raster outputs generated in each of the previous factor tabs for the Place Characterization Dimension. - -_If a factor was executed in the same work session, its file path will automatically be populated after execution._ - -2. If factors are missing, adjust the weighting percentage accordingly and ensure it totals to 100%. - -_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ - -3. Enter the aggregated raster output file name. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. - -7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/AGG_Raster_output.tif*). - -### 4.6 DIMENSION AGGREGATION TAB - -![image](https://github.com/worldbank/GEEST/assets/120469484/651ed053-e36a-4fa1-b44d-6759fc5b60d8) - -1. Load each dimension's aggregated raster outputs. - -_If a dimension's factor aggregation was executed in the same work session, its file path will automatically be populated after execution._ - -2. If dimensions are missing, adjust the weighting percentage accordingly and ensure it totals up to 100%. - -_If a dimension is missing it needs to be given a weighting of 0%._ - -3. Enter aggregated dimensions raster output file name. - -4. Click the "Execute" button to run the algorithm. - -5. Status text next to the "Execute" button will appear and let you know once processing is complete. - -6. The aggregated dimensional layer will be loaded to the QGIS and appear in the table of contents. - -7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Final\_output" folder (*Project_Folder/Final_Output/Final_AGG_Raster_output.tif_). - -### 4.7 ABOUT TAB - -![image](https://github.com/worldbank/GEEST/assets/120469484/a949054b-1b8e-46f6-9279-fdd2b54212de) - -Information on the tool its framework, scoring system, and how results should or can be interpreted. - -### 4.8 INSIGHTS TAB -#### 4.8.1 Enablement - -![image](https://github.com/worldbank/GEEST/assets/120469484/e0e94c47-bf17-462c-a41c-5023f96ab642) - -**Classify into discrete classes** - -1. Navigate to and select the enablement score input raster file. This can be the final aggregate score, a dimension aggregate score, or even a single factor output layer. - -2. Click the "Classify" button under the "Enablement Score Input layer" field to run the algorithm. - -3. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/1) Level of Enablement Classification" folder. (*Project_Folder/Insights/1) Level of Enablement Classification/Level_of_Enablement.tif*) - -4. Navigate to and select the population input raster file. - - **Input File:** *Population/Female_population_35_39.tif* (**Any of the age ranges can be used as input**) - -6. Click the "Classify" button under the "Population Input layer" field to run the algorithm. - -7. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/2) Relative Population Count Classification" folder. (*Project_Folder/Insights/2) Relative Population Count Classification/Relative_Population_Count.tif*) - -**Combine score and population classifications** - -8. Navigate to and select the "Level of Enablement" output raster file produced in **step 2**. This file path will be automatically populated if **step 2** was executed in the same work session. - -9. Navigate to and select the "Relative Population Count" output raster file produced in **step 6**. This file path will be automatically populated if **step 6** was executed in the same work session. - -10. Click the "Combine Classification" button to run the algorithm combining the "Level of Enablement" and "Relative Population Count" raster layers. - -11. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/3) Combined Level of Enablement & Relative Population Count Classification" folder. (*Project_Folder/Insights/3) Combined Level of Enablement & Relative Population Count Classification/Enablement_&_Population_Combined_classification.tif*) - -**Aggregation** - -12. Navigate to and select the "Combine Classification" output raster file produced in **step 10**. This file path will be automatically populated if **step 10** was executed in the same work session. - -13. Navigate to and select the aggregation input shapefile. This can be any polygon layer representing boundaries of interest for aggregation (e.g. municipal boundary layer) - - **Input File:** *AdminBoundaries/Admin6.shp* (**Any admin level can be used as input**) - -14. Enter aggregated "Combine Classification" shapefiles output file name. - -15. Click the "Execute" button to run the algorithm. - -16. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/4) Aggregation" folder. (*Project_Folder/Insights/4) Aggregation/Aggregation_.tif*) - -#### 4.8.2 RE Zone Raster Locations - -![image](https://github.com/worldbank/GEEST/assets/120469484/612670ce-b60f-48a1-b085-7c6478c5b5f8) - -1. Navigate to and select the combined classification input file produced in **step 10** of the "Enablement" tab. This file path will be automatically populated if **step 10** of the "Enablement" tab was executed in the same work session. - -2. Navigate to and select the aggregated combined classification input file produced in **step 15** of the "Enablement" tab. This file path will be automatically populated if **step 15** of the "Enablement" tab was executed in the same work session. - -3. Navigate to and select the potential RE zones input raster file. (Zones in the region that have no RE potential need to be represented with "no data" or "inf" values in the raster file) - - **Input File:** *RE/WBG_REZoning_DOM_score_wind.tif* - - **Input File:** *RE/WBG_REZoning_DOM_score_solar.tif* - -4. Enter the "RE zones" raster file and shapefile prefix for the output file name. - -5. Click the "Execute" button to run the algorithm. - -6. The 2 output files will be stored in the project folder specified in the "Setup" tab, under the "Insights/5) RE Zone Raster Locations" folder. (*Project_Folder/Insights/5) RE Zone Raster Locations/RE_zone_.tif* **&** *Project_Folder/Insights/5) RE Zone Raster Locations/RE_zone_admin_units.shp*) - - -#### 4.8.3 RE Point Locations - -![image](https://github.com/worldbank/GEEST/assets/120469484/55ae3e3a-2b0a-463c-a2d1-c76d37605e17) - -1. Navigate to and select the combined classification input file produced in **step 10** of the "Enablement" tab. This file path will be automatically populated if **step 10** of the "Enablement" tab was executed in the same work session. - -2. Navigate to and select the aggregated combined classification input file produced in **step 15** of the "Enablement" tab. This file path will be automatically populated if **step 15** of the "Enablement" tab was executed in the same work session. - -3. Navigate to and select the RE point locations input shapefile of interest. (These could be existing RE job locations or other points of interest) - -4. Set buffer radial distance in meters. - -5. Enter the "RE point location" shapefiles prefix for the output file names. - -5. Click the "Execute" button to run the algorithm. - -6. The 2 output shapefiles will be stored in the project folder specified in the "Setup" tab, under the "Insights/6) RE Point Locations" folder. (*Project_Folder/Insights/6) RE Point Locations/RE_point_buffer_.shp* **&** *Project_Folder/Insights/6) RE Point Locations/RE_point_admin_units_buffer_.shp*) - -## 5 Troubleshooting - -### 5.1 ACCESSIBILTY TABS PERMISSIONS ERROR - -![image](https://github.com/worldbank/GEEST/assets/120469484/63edfc18-8294-478c-bcc5-1a4f28c07711) - -This error occurs when some of the shapefiles produced in the temp folder of the working directory are trying to be overwritten or deleted but can't because it's still being stored in QGIS's memory. This can occurs even when the layer is removed from the QGIS table of contents. - -**This error may also occur when the tool runs correctly so first check if the desired output file was produced in the working directory.** - -If the file is not produced you can try the following: -- Delete the *temp* folder in the working directory -- If you cannot delete the *temp* folder you will have to close QGIS and open it again, complete the setup tab, go back to the tab where the error occurred and re-run the tab again. - -### 5.2 QGIS PLUGIN/INTERFACE WIDGETS AND TEXT ARE DISTORTED AND SCALED INCORRECTLY -![image](https://github.com/worldbank/GEEST/assets/120469484/e195416b-ee86-4998-9ca5-a4784f7c724e) - -This is a problem linked to display settings caused by the connection of multiple monitors and/or varying display scales and resolutions, rather than a QGIS or plugin-related issue. This is backed by a Microsoft support post, linked [here](https://support.microsoft.com/en-gb/topic/windows-scaling-issues-for-high-dpi-devices-508483cd-7c59-0d08-12b0-960b99aa347d), highlighting the issues that may be experienced when using a high-DPI device, such as a 4k monitor. Additionally, in the scaling display setting, Microsoft indicates that entering a custom scaling size between 100% - 500% is not recommended as "...it can cause text and apps to become unreadable." - -![image](https://github.com/worldbank/GEEST/assets/120469484/248fde5c-dd1a-41d0-94ad-2ace20a74f95) - -Possible solutions to this are: -- Adjust the scale for all monitors to 100%. -- Ensure that the display resolution is the same for both monitors. i.e. If the smallest monitor is set to 1920 x 1080 set the 4k monitor to this display resolution as well. - -### 5.3 RASTER OUTPUTS NOT BEING LOADED AND DISPLAYING CORRECTLY - -![image](https://github.com/worldbank/GEEST/assets/120469484/10de6c72-f8f6-47b8-adb3-930f5c625f66) - -Occasionally, some of the outputs automatically loaded to the QGIS table of contents do not display correctly. To correct this, try removing the layer that is displayed incorrectly and add it again to QGIS. - -## 5.4 ERROR: OUTPUT DIRECTORY NOT SET - -![image](https://github.com/worldbank/GEEST/assets/120469484/b2f2959e-85c4-4e89-8493-dac2b9a20f07) - -If you see the following error message, please check if your output directory has been set in the "Setup" tab. - -### 5.5 ERROR: COUNTRY BOUNDARY POLYGON NOT SET - -![image](https://github.com/worldbank/GEEST/assets/120469484/75882e9d-a9af-43fc-9f68-0293c75b49b3) - -If you see the following error message, please check if you're country boundary polygon layer has been set in the "Setup" tab. - -### 5.6 ERROR: CO-ORDINATE REFERENCE SYSTEM (CRS) NOT SET - -![image](https://github.com/worldbank/GEEST/assets/120469484/120c0cf9-e526-4d8b-adff-de3a9d2f7fb8) - -If you see the following error message, please check if you're CRS has been set in the "Setup" tab. - -### 5.7 ALTERNATIVE WAY TO REFRESH THE PLUGIN IF IT FREEZES OR DOES NOT RUN AS EXPECTED - -1. Install the "Plugin Reloader" plugin. - - 1.1 Navigate to and open “Manage and Install Plugins…” under the plugins tab in QGIS. - - 1.2 In the search bar type “plugin reloader”. - - 1.3 Select the “Plugin Reloader” plugin and click on the install button. - - -![image](https://github.com/worldbank/GEEST/assets/120469484/801db189-92ca-4755-a79f-8898b2e43a2f) - - 1.4 Navigate to the "Plugin Reloader" configuration window under the Plugins tab. - -*Plugins* → *Plugin Reloader* → *Configure* - - 1.5 From the drop-down list select the "gender\_indicator\_tool" plugin and press "OK". - -![image](https://github.com/worldbank/GEEST/assets/120469484/3dc21c04-2ebe-4b33-92bc-1020746ee9e3) - - 1.6 If you encounter an unexpected error in the tool that has not been mentioned in any of the previous troubleshooting sections you can try runing the "plugin reload" tool - -![image](https://github.com/worldbank/GEEST/assets/120469484/80e1ae57-8608-4392-8df2-46e5b5d4789e) - -**OR** - -**If the "Plugin Reloader" does not resolve the error close QGIS, restart it again, and re-run the process you were trying to execute.** - -# List of CRSs for SIDS - -| **Country** | **WGS84 / UTM CRS** | **EPSG** | -| --- | --- | --- | -| Antigua and Barbuda | WGS 84 / UTM zone 20N | 32620 | -| Belize | WGS 84 / UTM zone 16N | 32616 | -| Cabo Verde | WGS 84 / UTM zone 26N | 32626 | -| Comoros | WGS 84 / UTM zone 38S | 32738 | -| Dominica | WGS 84 / UTM zone 20N | 32620 | -| Dominican Republic | WGS 84 / UTM zone 19N | 32619 | -| Fiji | WGS 84 / UTM zone 60S | 32760 | -| Grenada | WGS 84 / UTM zone 20N | 32620 | -| Guinea-Bissau | WGS 84 / UTM zone 28N | 32628 | -| Guyana | WGS 84 / UTM zone 21N | 32621 | -| Haiti | WGS 84 / UTM zone 18N | 32618 | -| Jamaica | WGS 84 / UTM zone 17N | 32617 | -| Kiribati | WGS 84 / UTM zone 1N | 32601 | -| Maldives | WGS 84 / UTM zone 43N | 32643 | -| Marshall Islands | WGS 84 / UTM zone 58N | 32658 | -| Mauritius | WGS 84 / UTM zone 40S | 32740 | -| Micronesia (Federated States of) | WGS 84 / UTM zone 57N | 32657 | -| Nauru | WGS 84 / UTM zone 58N | 32658 | -| Niue | WGS 84 / UTM zone 1S | 32701 | -| Palau | WGS 84 / UTM zone 53N | 32653 | -| Papua New Guinea | WGS 84 / UTM zone 55S | 32755 | -| Samoa | WGS 84 / UTM zone 2S | 32702 | -| Sao Tomé and Principe | WGS 84 / UTM zone 32N | 32632 | -| Solomon Islands | WGS 84 / UTM zone 57S | 32757 | -| St. Lucia | WGS 84 / UTM zone 20N | 32620 | -| St. Vincent and the Grenadines | WGS 84 / UTM zone 20N | 32620 | -| Suriname | WGS 84 / UTM zone 21N | 32621 | -| Timor-Leste | WGS 84 / UTM zone 52S | 32752 | -| Tonga | WGS 84 / UTM zone 60S | 32760 | -| Tuvalu | WGS 84 / UTM zone 60S | 32760 | -| Vanuatu | WGS 84 / UTM zone 59S | 32759 | - -# License -This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details +Applying the GEEST in the pilot countries has yielded valuable insights, particularly in highlighting disparities between rural and urban outcomes. This divergence underscores the need for a more tailored approach, emphasizing targeted subgroup analyses to accommodate the distinct characteristics of rural and urban areas. diff --git a/docs/_toc.yml b/docs/_toc.yml index 52eca1b..90dc05a 100644 --- a/docs/_toc.yml +++ b/docs/_toc.yml @@ -2,6 +2,9 @@ format: jb-book root: README parts: + - caption: GEEST + chapters: + - file: docs/user_guide - caption: Additional Resources chapters: - url: https://datacatalog.worldbank.org/search/collections/genderspatial diff --git a/docs/images/img01.png b/docs/images/img01.png new file mode 100644 index 0000000..d45432f Binary files /dev/null and b/docs/images/img01.png differ diff --git a/docs/images/img02.png b/docs/images/img02.png new file mode 100644 index 0000000..e475dc1 Binary files /dev/null and b/docs/images/img02.png differ diff --git a/docs/images/img03.png b/docs/images/img03.png new file mode 100644 index 0000000..6d90bcb Binary files /dev/null and b/docs/images/img03.png differ diff --git a/docs/images/img04.png b/docs/images/img04.png new file mode 100644 index 0000000..fe8de97 Binary files /dev/null and b/docs/images/img04.png differ diff --git a/docs/images/img05.jpg b/docs/images/img05.jpg new file mode 100644 index 0000000..b2592d2 Binary files /dev/null and b/docs/images/img05.jpg differ diff --git a/docs/images/img06.jpg b/docs/images/img06.jpg new file mode 100644 index 0000000..10d7b5e Binary files /dev/null and b/docs/images/img06.jpg differ diff --git a/docs/images/img07.png b/docs/images/img07.png new file mode 100644 index 0000000..4a4f65d Binary files /dev/null and b/docs/images/img07.png differ diff --git a/docs/images/img08.png b/docs/images/img08.png new file mode 100644 index 0000000..7f5f621 Binary files /dev/null and b/docs/images/img08.png differ diff --git a/docs/images/img09.png b/docs/images/img09.png new file mode 100644 index 0000000..9de19ef Binary files /dev/null and b/docs/images/img09.png differ diff --git a/docs/images/img10.png b/docs/images/img10.png new file mode 100644 index 0000000..bd445dc Binary files /dev/null and b/docs/images/img10.png differ diff --git a/docs/images/img11.png b/docs/images/img11.png new file mode 100644 index 0000000..95ff34f Binary files /dev/null and b/docs/images/img11.png differ diff --git a/docs/images/img12.png b/docs/images/img12.png new file mode 100644 index 0000000..0b3072e Binary files /dev/null and b/docs/images/img12.png differ diff --git a/docs/images/img13.png b/docs/images/img13.png new file mode 100644 index 0000000..c1eefc9 Binary files /dev/null and b/docs/images/img13.png differ diff --git a/docs/images/img14.png b/docs/images/img14.png new file mode 100644 index 0000000..c225c53 Binary files /dev/null and b/docs/images/img14.png differ diff --git a/docs/images/img15.png b/docs/images/img15.png new file mode 100644 index 0000000..e475dc1 Binary files /dev/null and b/docs/images/img15.png differ diff --git a/docs/images/img16.png b/docs/images/img16.png new file mode 100644 index 0000000..c1f082c Binary files /dev/null and b/docs/images/img16.png differ diff --git a/docs/images/img17.png b/docs/images/img17.png new file mode 100644 index 0000000..945b34a Binary files /dev/null and b/docs/images/img17.png differ diff --git a/docs/images/img18.png b/docs/images/img18.png new file mode 100644 index 0000000..25a0d3d Binary files /dev/null and b/docs/images/img18.png differ diff --git a/docs/images/img19.png b/docs/images/img19.png new file mode 100644 index 0000000..5074b9a Binary files /dev/null and b/docs/images/img19.png differ diff --git a/docs/user_guide.md b/docs/user_guide.md new file mode 100644 index 0000000..8376024 --- /dev/null +++ b/docs/user_guide.md @@ -0,0 +1,1013 @@ +# Gender Enabling Environments Spatial Tool (GEEST) User Manual +This tool employs a multicriteria evaluation (MCE) framework to spatially describe womens' access to formal employment and business opportunities in the renewable energy sector in Small Island Developing States (SIDS). The MCE framework allows for the incorporation and assessment of dimensions, factors, and indicators to identify where the enabling environments (or lack thereof) are located for women to secure employment opportunities in SIDS. + +- The spatial GDBs for all SIDS can be accessed [here](https://datacatalog.worldbank.org/search/collections/genderspatial). +- The methodology report can be accessed [here](https://documents.worldbank.org/en/publication/documents-reports/documentdetail/099121123091527675/p1792120dc820d04409928040a279022b42). + +## User Manual + +- [Gender Enabling Environments Spatial Tool (GEEST) User Manual](#gender-enabling-environments-spatial-tool-geest-user-manual) + - [User Manual](#user-manual) + - [1 Install QGIS](#1-install-qgis) + - [2 Install Open Route Service (ORS) plugin](#2-install-open-route-service-ors-plugin) + - [3 Installing Plugin on local device](#3-installing-plugin-on-local-device) + - [4 Using the Plugin](#4-using-the-plugin) + - [ 4.1 SETUP TAB](#-41-setup-tab) + - [4.2 INDIVIDUAL TAB](#42-individual-tab) + - [4.2.1 Education](#421-education) + - [4.2.2 Care Responsibilities](#422-care-responsibilities) + - [4.2.3 Domestic Violence](#423-domestic-violence) + - [4.2.4 Aggregate](#424-aggregate) + - [4.3 CONTEXTUAL TAB](#43-contextual-tab) + - [4.3.1 Policy and Legal Protection](#431-policy-and-legal-protection) + - [4.3.2 Access to Finance](#432-access-to-finance) + - [4.3.3 Aggregate](#433-aggregate) + - [4.4 ACCESSIBILITY TAB](#44-accessibility-tab) + - [4.4.1 Women's Travel Patterns](#441-womens-travel-patterns) + - [4.4.2 Access to Public Transport](#442-access-to-public-transport) + - [4.4.3 Access to Education and Training Facilities](#443-access-to-education-and-training-facilities) + - [4.4.4 Access to Jobs in the RE sector](#444-access-to-jobs-in-the-re-sector) + - [4.4.5 Access to Health Facilities](#445-access-to-health-facilities) + - [4.4.6 Access to Financial Facilities](#446-access-to-financial-facilities) + - [4.4.7 Aggregate](#447-aggregate) + - [4.5 PLACE CHARACTERIZATION TAB](#45-place-characterization-tab) + - [4.5.1 Active Transport](#451-active-transport) + - [4.5.2 Availability of Public Transport](#452-availability-of-public-transport) + - [4.5.3 Safe Urban Design](#453-safe-urban-design) + - [4.5.4 Security](#454-security) + - [4.5.5 Income Level](#455-income-level) + - [4.5.6 Electricity Access](#456-electricity-access) + - [4.5.7 Level of Urbanization](#457-level-of-urbanization) + - [4.5.8 Size of Housing](#458-size-of-housing) + - [4.5.9 Digital Inclusion](#459-digital-inclusion) + - [4.5.10 Natural Environment and Climatic Factors](#4510-natural-environment-and-climatic-factors) + - [4.5.11 Aggregate](#4511-aggregate) + - [4.6 DIMENSION AGGREGATION TAB](#46-dimension-aggregation-tab) + - [4.7 ABOUT TAB](#47-about-tab) + - [4.8 INSIGHTS TAB](#48-insights-tab) + - [4.8.1 Enablement](#481-enablement) + - [4.8.2 RE Zone Raster Locations](#482-re-zone-raster-locations) + - [4.8.3 RE Point Locations](#483-re-point-locations) + - [5 Troubleshooting](#5-troubleshooting) + - [5.1 ACCESSIBILTY TABS PERMISSIONS ERROR](#51-accessibilty-tabs-permissions-error) + - [5.2 QGIS PLUGIN/INTERFACE WIDGETS AND TEXT ARE DISTORTED AND SCALED INCORRECTLY](#52-qgis-plugininterface-widgets-and-text-are-distorted-and-scaled-incorrectly) + - [5.3 RASTER OUTPUTS NOT BEING LOADED AND DISPLAYING CORRECTLY](#53-raster-outputs-not-being-loaded-and-displaying-correctly) + - [5.4 ERROR: OUTPUT DIRECTORY NOT SET](#54-error-output-directory-not-set) + - [5.5 ERROR: COUNTRY BOUNDARY POLYGON NOT SET](#55-error-country-boundary-polygon-not-set) + - [5.6 ERROR: CO-ORDINATE REFERENCE SYSTEM (CRS) NOT SET](#56-error-co-ordinate-reference-system-crs-not-set) + - [5.7 ALTERNATIVE WAY TO REFRESH THE PLUGIN IF IT FREEZES OR DOES NOT RUN AS EXPECTED](#57-alternative-way-to-refresh-the-plugin-if-it-freezes-or-does-not-run-as-expected) +- [List of CRSs for SIDS](#list-of-crss-for-sids) +- [License](#license) + +## 1 Install QGIS + +1. The link below will take you to the QGIS website where you will be able to download the QGIS installation file. Note that it is possible to use older versions of QGIS, e.g. Version 3.28. + +QGIS website: [https://www.qgis.org/en/site/](https://www.qgis.org/en/site/) + +![image](https://github.com/worldbank/GEEST/assets/120469484/e0448baf-9a0b-475e-9bc2-c883868318d2) + +2. Once the installation file is downloaded run the installation file. + +3. A pop-up window as seen in the image below should show up. Follow the prompts and leave all settings on default. + +![image](https://github.com/worldbank/GEEST/assets/120469484/52464df3-b408-4d05-af88-c6ef4a55c599) + + +## 2 Install Open Route Service (ORS) plugin + +1. Open QGIS, navigate to the "Plugins" tab and select the "Manage and Install Plugins…" option from the drop-down menu. + +![image](https://github.com/worldbank/GEEST/assets/120469484/1a2b1b0c-2a6f-49a6-b3d3-6e48386b7b22) + +2. The "Plugins" pop-up window should appear as seen in the image below. + +3. In the search bar type "ORS", select the "ORS Tool" from the list of plugins, and select the install button to install the plugin. + +![image](https://github.com/worldbank/GEEST/assets/120469484/6274c002-9b56-4374-8fd4-9278d2246afb) + +4. You will now have to set up an account on the Open Route Service website which can be accessed by clicking the link below. + +ORS website: [https://openrouteservice.org/](https://openrouteservice.org/) + +ORS Sign up: [https://openrouteservice.org/dev/#/signup](https://openrouteservice.org/dev/#/signup) + +![image](https://github.com/worldbank/GEEST/assets/120469484/79728902-e5ba-49c1-a262-32cd9df628a6) + +5. Fill in all the necessary fields to sign up and then log into your account. + +6. Request a standard token and provide a name for the Token. + +![image](https://github.com/worldbank/GEEST/assets/120469484/72eb8f24-84b5-42e9-8da7-e19bf96d410a) + +7. Once the token has been created, navigate to the Dashboard tab and click on the API key as seen in the image below. The API key should now be copied to the clipboard. + +![image](https://github.com/worldbank/GEEST/assets/120469484/26564e04-4520-4022-9930-4b791df8e63f) + +8. In the QGIS window navigate the ORS tool and select "Provider Settings". + +![image](https://github.com/worldbank/GEEST/assets/120469484/45a45354-8478-45df-b212-c477a99b2c9a) + +9. The provider settings pop-up window should now appear as seen in the image below. + +10. Past the API key that has been copied to the clipboard into the API Key field and press "OK". + +![image](https://github.com/worldbank/GEEST/assets/120469484/b255a792-4d46-42ef-a0ff-79edb1e2fd19) + +**N.B.** Additional credits can be requested on the ORS site by applying for the collaborative plan as described [here](https://openrouteservice.org/plans/). You will have to provide a brief motivation, however, if your application is in a humanitarian, academic, governmental, or not-for-profit organization, you should be eligible for the collaborative plan. + +This email address can also be used for further assistance: + +support@openrouteservice.heigit.org + +## 3 Installing Plugin on local device + +1. Click on the green "Code" button and select the "Download ZIP" option. + +![image](https://github.com/worldbank/GEEST/assets/120469484/af517d0b-8b32-43b6-a664-0bb250a1d620) + +2. Once the download has been completed extract the contents of the ZIP file. + +3. Navigate to your extracted ZIP folder and copy the _requirements.txt_ file. + +![image](https://github.com/worldbank/GEEST/assets/120469484/6adea1a2-e63c-4067-9052-346811697828) + +4. Navigate to the QGIS program folder and paste the _requirements.txt_ file into it. The file path would be similar to this: _C:\Program Files\QGIS 3.32.0_ as seen in the image under **step 5**. + +5. Run the _OSGeo4W_ batch file. + +![image](https://github.com/worldbank/GEEST/assets/120469484/9a8376bb-dc50-41fa-a3fd-f3e0757a3850) + +6. A command line pop-up window will appear as seen in the image below. + +7. Type the following into it and press Enter. +```pip install -r requirements.txt``` + +![image](https://github.com/worldbank/GEEST/assets/120469484/ed373467-0f80-4b75-8931-9c9e2d03d013) + +8. All the Python libraries that the Plugin is dependent on will now be installed. This can take a few minutes to install. + +9. Once the installations are complete you can close the command line pop-up window. + +10. Open QGIS, navigate to the "Plugins" tab and select the "Manage and Install Plugins…" option from the drop-down menu. + +![image](https://github.com/worldbank/GEEST/assets/120469484/39e233a5-15de-4471-9560-028cd8cde839) + +11. In the plugin pop-up window navigate to the "Install from ZIP" tab. + +![image](https://github.com/worldbank/GEEST/assets/120469484/9ed559bc-5672-4631-a33d-714710440819) + +12. From the "Install from ZIP" tab navigate back to your extracted ZIP folder and select the "gender\_indicator\_tool" compressed (zipped) folder as seen in the image below. + +![image](https://github.com/worldbank/GEEST/assets/120469484/f2e81343-1bb4-4dc1-b593-38c26726f767) + +13. Once the ZIP file has been selected click on "Install Plugin". + +14. Once the plugin has been installed navigate to the "All" tab. + +15. In the search bar type "GEEST" and click the check box next to the "Gender Enabling Environments Spatial Tool (GEEST)" to install the plugin. + +![image](https://github.com/worldbank/GEEST/assets/120469484/aac4db6e-3585-40dc-9e73-d0eb3a8bc247) + +16. The plugin is now installed and you should now be able to access it in your toolbar or under the Plugin's tab as seen in the image below. + +![image](https://github.com/worldbank/GEEST/assets/120469484/eceaf443-ff8b-4be0-9282-a1236a03bb86) + +## 4 Using the Plugin +Examples of files that can be used as input at a particular step as per the Pilot Country Database will be indicated at the end of the step. The following format will be used: + +**Input File:** *Folder/file_name* --> *AccessFinance/Access_to_finance.shp* + +### 4.1 SETUP TAB + +![image](https://github.com/worldbank/GEEST/assets/120469484/6ff06edc-198a-4807-a59f-038f1b401d43) + +1. Create a project folder that will be used to store all tool outputs. + +3. Set the output directory to the project folder created in the previous step. + +5. Set the country boundary layer by navigating to and selecting the **Admin 0** country boundary polygon shapefile for the country you want to analyze. + + **Input File:** *AdminBoundaries/Admin0.shp* + +7. Select the appropriate coordinate reference system (CRS) from the QGIS CRS database. + +**Appendix A** _lists all the CRS to be used for the SIDS countries._ + +5. Copy and paste the EPSG code for your specific country and paste it in the Filter bar as seen in the image below. + +![image](https://github.com/worldbank/GEEST/assets/120469484/5e9d2066-c641-4129-8e4c-a876b19da8a2) + +6. Select the CRS from the list and click "OK". + +7. Set your preferred output raster output resolution in meters squared. + +### 4.2 INDIVIDUAL TAB + +#### 4.2.1 Education + +![image](https://github.com/worldbank/GEEST/assets/120469484/783752ba-77a9-4c37-95ad-d5ffb34b9bf7) + +1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of women who have achieved a post-secondary education. + + **Input File:** *Education/Level_of_education* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of women who have achieved a post-secondary education. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/EDU_Raster_output.tif*) + +#### 4.2.2 Care Responsibilities + +![image](https://github.com/worldbank/GEEST/assets/120469484/a22a693d-7979-442a-9e6d-b485417d8fad) + +1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of time women spend on care responsibilities or household activities. + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of time women spend on care responsibilities or household activities. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/CRE_Raster_output.tif*) + +#### 4.2.3 Domestic Violence + +![image](https://github.com/worldbank/GEEST/assets/120469484/b2b9e9e9-cb5c-4251-b495-2ee10ea8f404) + +1. Navigate to and select the polygon input shapefile containing a field reporting the percentage of women who have suffered domestic violence. + + **Input File:** *DomesticViolence/Prevalence_of_domestic_violence.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of women who have suffered domestic violence. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/DOV_Raster_output.tif*) + +#### 4.2.4 Aggregate + +![image](https://github.com/worldbank/GEEST/assets/120469484/e9e14c68-2111-4377-9ea2-bc73c6241fc1) + +1. Load the raster outputs generated in each of the previous factor tabs for the Individual Dimension. + +_If a factor was executed in the same work session, its file path will automatically be populated after execution._ + +2. If factors are missing adjust the weighting percentage accordingly and ensure it totals to 100%. + +_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ + +3. Enter an alternate aggregated raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. + +7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Individual" folder. (*Project_Folder/Individual/AGG_Raster_output.tif*) + +### 4.3 CONTEXTUAL TAB + +#### 4.3.1 Policy and Legal Protection + +![image](https://github.com/worldbank/GEEST/assets/120469484/ab6797a8-b09e-4a6e-92c8-6e2b664d17c0) + +1. Navigate to and select polygon input shapefile containing a field reporting a percentage representing the level of protective policies afforded to women. + + **Input File:** *PolicyLegal/Regulatory_Framework_Law_agg.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing a percentage representing the level of protective policies afforded to women. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/PLP_Raster_output.tif*) + +#### 4.3.2 Access to Finance + +![image](https://github.com/worldbank/GEEST/assets/120469484/2e4050cd-d458-4b19-9876-b434431b68c7) + +1. Navigate to and select polygon input shapefile containing a field reporting the percentage of women who have a bank account. + + **Input File:** *AccessFinance/Access_to_finance.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of women who have a bank account. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/FIN_Raster_output.tif*) + +#### 4.3.3 Aggregate + +![image](https://github.com/worldbank/GEEST/assets/120469484/bcf2260d-5db0-4be5-a583-ac9d0537e35c) + +1. Load the raster outputs generated in each of the previous factor tabs for the Contextual Dimension. + +_If a factor was executed in the same work session, its file path will automatically be populated after execution._ + +2. If factors are missing adjust the weighting percentage accordingly and ensure it totals to 100%. + +If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension. + +3. Enter an alternate aggregated raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. + +7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Contextual/AGG_Raster_output.tif*) + +### 4.4 ACCESSIBILITY TAB + +#### 4.4.1 Women's Travel Patterns + +![image](https://github.com/worldbank/GEEST/assets/120469484/6541477e-2ff8-4878-8962-3abb48e4ce43) + +1. Navigate to and select point shapefile input of facilities related to women's role as caregivers. This includes: + - Childcare facilities + - Primary and secondary schools + - Markets + - Grocery stores + - Recreational areas + + **Input File:** *Amenities/Daycares_elementary_schools.shp* + + **Input File:** *Amenities/Grocery_stores.shp* + +2. Select the mode of travel (Walking OR Driving). + +3. Select the method of measurement (Distance OR Time). + +4. Specify travel distance or time increments in meters or time respectively using comma delimitation. + +5. Edit the facility raster output file name for each unique type of facility. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The output raster file will be stored in the project folder specified in the "Setup" tab, in the "WTP" folder under the "Accessibility" folder. (*Project_Folder/Accessibility/WTP/Facility_Raster_output.tif*) + +**Steps 1 – 8 will have to be repeated for all facility types**. + +9. Once all facilities have completed the processing, move on to the next step and enter the aggregated raster output file name. + +10. Click the "Aggregate" button to run the algorithm. + +11. Status text next to the "Execute" button will appear and let you know once processing is complete. + +12. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Accessibility/WTP_Raster_output.tif*) + +#### 4.4.2 Access to Public Transport + +![image](https://github.com/worldbank/GEEST/assets/120469484/ade68b40-f9f4-477c-a631-3ed137b71e27) + +1. Navigate to and select point shapefile input for public transport stops. + + **Input File:** *PubTransportStops/Public_transportation_stops.shp* + +3. Select the mode of travel (Walking OR Driving). + +4. Select the method of measurement (Distance OR Time). + +5. Specify travel distance or time increments in meters or time respectively using comma delimitation. + +6. Enter an alternate raster output file name if desired. + +7. Click the "Execute" button to run the algorithm. + +8. Status text next to the "Execute" button will appear and let you know once processing is complete. + +9. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/PBT_Raster_output.tif*). + +#### 4.4.3 Access to Education and Training Facilities + +![image](https://github.com/worldbank/GEEST/assets/120469484/0899eb4e-9547-4d7a-9a30-95082ebb71dc) + +1. Navigate to and select point shapefile input of education and training facilities. + + **Input File:** *EducationFacilities/Techncal_schools.shp* + + **Input File:** *EducationFacilities/Universities.shp* + +3. Select the mode of travel (Walking OR Driving). + +4. Select the method of measurement (Distance OR Time). + +5. Specify travel distance or time increments in meters or time respectively using comma delimitation. + +6. Enter an alternate raster output file name if desired. + +7. Click the "Execute" button to run the algorithm. + +8. Status text next to the "Execute" button will appear and let you know once processing is complete. + +9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/ETF_Raster_output.tif*). + +#### 4.4.4 Access to Jobs in the RE sector + +![image](https://github.com/worldbank/GEEST/assets/120469484/572b704c-830a-40c4-96f0-6dceb7e6100d) + +1. Navigate to and select point shapefile input of jobs or job facilities. + +3. Select the mode of travel (Walking OR Driving). + +4. Select the method of measurement (Distance OR Time). + +5. Specify travel distance or time increments in meters or time respectively using comma delamination. + +6. Enter an alternate raster output file name if desired. + +7. Click the "Execute" button to run the algorithm. + +8. Status text next to the "Execute" button will appear and let you know once processing is complete. + +9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/JOB_Raster_output.tif*). + +#### 4.4.5 Access to Health Facilities + +![image](https://github.com/worldbank/GEEST/assets/120469484/c38e5cb6-2264-4bd3-8e53-56c19d8213e4) + +1. Navigate to and select point shapefile input of health care facilities. + + **Input File:** *HealthFacilities/Hospitals.shp* + +3. Select the mode of travel (Walking OR Driving). + +4. Select the method of measurement (Distance OR Time). + +5. Specify travel distance or time increments in meters or time respectively using comma delimitation. + +6. Enter an alternate raster output file name if desired. + +7. Click the "Execute" button to run the algorithm. + +8. Status text next to the "Execute" button will appear and let you know once processing is complete. + +9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder. (*Project_Folder/Accessibility/HEA_Raster_output.tif*) + +#### 4.4.6 Access to Financial Facilities + +![image](https://github.com/worldbank/GEEST/assets/120469484/bd2bace8-e569-4b23-a4c0-a6024fe2adf6) + +1. Navigate to and select point shapefile input of financial facilities. + + **Input File:** *FinancialFacilities/Financial_Facilities.shp* + +3. Select the mode of travel (Walking OR Driving). + +4. Select the method of measurement (Distance OR Time). + +5. Specify travel distance or time increments in meters or time respectively using comma delamination. + +6. Enter an alternate raster output file name if desired. + +7. Click the "Execute" button to run the algorithm. + +8. Status text next to the "Execute" button will appear and let you know once processing is complete. + +9. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Accessibility" folder (*Project_Folder/Accessibility/FIF_Raster_output.tif*). + +#### 4.4.7 Aggregate + +![image](https://github.com/worldbank/GEEST/assets/120469484/ba3c884c-5940-4255-9ca5-9e202ae106b8) + +1. Load the raster outputs generated in each of the previous factor tabs for the Accessibility Dimension. + +_If a factor was executed in the same work session, the file path will automatically be populated after execution._ + +2. If factors are missing, adjust the weighting percentage accordingly and ensure it totals to 100%. + +_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ + +3. Enter alternate aggregated raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. + +7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Accessibility/AGG_Raster_output.tif*). + +### 4.5 PLACE CHARACTERIZATION TAB + +#### 4.5.1 Active Transport + +![image](https://github.com/worldbank/GEEST/assets/120469484/bf89b9ad-7ecc-460c-a7d9-38f1a894176a) + +1. Navigate to and select polyline road network shapefile. + + **Input File:** *Roads/Roads.shp* + +3. Click the "Set" button to extract all the fields from the polyline input layer. + +4. Select the field containing the road type categorical values. + +5. Click the "Unique Values" button to extract all the unique road type values. + +6. Score each of the extracted road types from 1 to 5 based on local knowledge, where 5 is a road type that is very safe for walking and cycling and 1 is an unsafe road type. + +7. Enter an alternate raster output file name if desired. + +8. Click the "Execute" button to run the algorithm. + +9. Status text next to the "Execute" button will appear and let you know once processing is complete. + +10. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/WLK_Raster_output.tif*). + +#### 4.5.2 Availability of Public Transport + +!![image](https://github.com/worldbank/GEEST/assets/120469484/8dd068ae-b4dd-447c-bef0-0e57c8f4db17) + +1. Navigate to and select point shapefile input for public transport stops. + + **Input File:** *PubTransportStops/Public_transportation_stops.shp* + +3. Set hexagon grid size. The default is 1km. + +The smaller size the more computationally intensive the algorithm will be. + +3. Enter an alternate raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/APT_Raster_output.tif*). + +#### 4.5.3 Safe Urban Design + +![image](https://github.com/worldbank/GEEST/assets/120469484/2ab8874d-50cb-4445-9bac-3231b8328fb7) + +1. Navigate to and select nighttime lights raster input. + + **Input File:** *Electricity/Nighttime_Lights_2021.tif* + +3. Enter an alternate raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/SAF_Raster_output.tif*). + +### 4.5.4 Security + +![image](https://github.com/worldbank/GEEST/assets/120469484/10d4eb39-51b9-421d-b105-46466f4b3ba9) + +1. Navigate to and select the crime rate polygon input shapefile containing a field reporting the crime rate for a specific incident. + + **Input File:** *Security/Crime_Incidence_Serious_Assaults.shp* + + **Input File:** *Security/Crime_Incidence_Sexual_Violence.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the crime rate. + +5. Enter the raster output file name for the crime type. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The output raster file will be stored in the project folder specified in the "Setup" tab, in the "SEC" folder under the "Accessibility" folder (*Project_Folder/Place Characterization/SEC/Incidents_Raster_output.tif*). + +**Steps 1 – 8 will have to be repeated for all facility types**. + +8. Once all crime types have completed the processing, enter the aggregated raster output file name. + +9. Click the "Aggregate" button to run the algorithm. + +10. Status text next to the "Execute" button will appear and let you know once processing is complete. + +11. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder. (*Project_Folder/Place Characterization/SEC_Raster_output.tif*) + +#### 4.5.5 Income Level + +![image](https://github.com/worldbank/GEEST/assets/120469484/c1a88898-25a9-47ba-83a3-567bbf525f1a) + +1. Navigate to and select the wealth index polygon input shapefile containing a field with the wealth index. + + **Input File:** *Income/Wealth_Index.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the wealth index. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/INC_Raster_output.tif*). + +#### 4.5.6 Electricity Access + +![image](https://github.com/worldbank/GEEST/assets/120469484/1a37676f-d82f-44bd-a554-9fcb854ce42d) + +1. Navigate to and select electricity access polygon input shapefile containing a field indicating the percentage of individuals that have access to electricity. + + **Input File:** *Electricity/Electrification_rate.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of individuals that have access to electricity. + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/ELC_Raster_output.tif*). + +OR + +1. Navigate to and select nighttime lights raster input. + + **Input File:** *Electricity/Nighttime_Lights_2021.tif* + +3. Enter the raster output file name. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/ELC_Raster_output.tif*). + +**N.B. If nighttime lights raster data is used for the "Safe Urban Design" factor it should not be used in the "Electrical Access" factor and vice-versa** + +#### 4.5.7 Level of Urbanization + +![image](https://github.com/worldbank/GEEST/assets/120469484/8776fd6c-8f40-4584-b517-a8610b867dd6) + +1. Navigate to and select GHS-SMOD raster input. + + **Input File:** *Urbanization/GHS_SMOD_E2020_GLOBE_R2023A_54009_1000_V1_0_R7_C12.tif* + +3. Enter an alternate raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The output raster file will be stored in the project folder set in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/LOU_Raster_output.tif*). + +#### 4.5.8 Size of Housing + +![image](https://github.com/worldbank/GEEST/assets/120469484/b50b4538-6610-438b-b90a-4ee0c9462dc4) + +1. Navigate to and select the building footprints polygon shapefile. + + **Input File:** *Housing/Building_footprint.shp* + +3. Set hexagon grid size. The default is 1 km. + +The smaller size the more computationally intensive the algorithm will be. + +3. Enter an alternate raster output file name if desired. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder (*Project_Folder/Place Characterization/QUH_Raster_output.tif*). + +#### 4.5.9 Digital Inclusion + +![image](https://github.com/worldbank/GEEST/assets/120469484/de34e9da-6e68-4d09-bec5-84755bb35545) + +1. Navigate to and select the polygon input shapefile containing a field indicating the percentage of houses with internet access. + + **Input File:** *Digital/Access_to_broadband_rates_community.shp* + +3. Click the "Set" button to extract all the fields from the polygon input layer. + +4. Select the field containing the numeric value representing the percentage of houses with Internet access + +5. Enter an alternate raster output file name if desired. + +6. Click the "Execute" button to run the algorithm. + +7. Status text next to the "Execute" button will appear and let you know once processing is complete. + +8. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/DIG_Raster_output.tif*). + +#### 4.5.10 Natural Environment and Climatic Factors + +![image](https://github.com/worldbank/GEEST/assets/120469484/2b0a1b43-6f34-436e-a790-5516027d291a) + +1. Navigate to and select polygon hazard shapefile. + + **Input File:** *Environment/Flood_risk.shp* + +3. Click the "Set" button to extract all the fields from the polyline input layer. + +4. Select the field containing the descriptive risk level values. + +5. Click the "Unique Values" button to extract all the unique risk level values. + +6. Score each of the extracted risk levels from 1 to 5, where 5 is the lowest risk and 1 is the highest risk. + +7. Enter hazard type raster output file name. + +8. Click the "Execute" button to run the algorithm. + +9. Status text next to the "Execute" button will appear and let you know once processing is complete. + +10. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Place Characterization" folder. (*Project_Folder/Place Characterization/ENV/Hazard_Raster_output.tif*) + +**Steps 1 – 9 will have to be repeated for all hazard types**. + +10. Once all hazard types have been processed, enter the aggregated raster output file name. + +11. Click the "Aggregate" button to run the algorithm. + +12. Status text next to the "Execute" button will appear and let you know once processing is complete. + +13. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/ENV_Raster_output.tif*). + +#### 4.5.11 Aggregate + +![image](https://github.com/worldbank/GEEST/assets/120469484/bedf9d85-63c5-4cd9-857a-c726ef77a89a) + +1. Load the raster outputs generated in each of the previous factor tabs for the Place Characterization Dimension. + +_If a factor was executed in the same work session, its file path will automatically be populated after execution._ + +2. If factors are missing, adjust the weighting percentage accordingly and ensure it totals to 100%. + +_If a factor is missing it needs to be given a weighting of 0%. All factors should have equal weighting within a dimension._ + +3. Enter the aggregated raster output file name. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated layer will be loaded to the QGIS and appear in the table of contents. + +7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Contextual" folder (*Project_Folder/Place Characterization/AGG_Raster_output.tif*). + +### 4.6 DIMENSION AGGREGATION TAB + +![image](https://github.com/worldbank/GEEST/assets/120469484/651ed053-e36a-4fa1-b44d-6759fc5b60d8) + +1. Load each dimension's aggregated raster outputs. + +_If a dimension's factor aggregation was executed in the same work session, its file path will automatically be populated after execution._ + +2. If dimensions are missing, adjust the weighting percentage accordingly and ensure it totals up to 100%. + +_If a dimension is missing it needs to be given a weighting of 0%._ + +3. Enter aggregated dimensions raster output file name. + +4. Click the "Execute" button to run the algorithm. + +5. Status text next to the "Execute" button will appear and let you know once processing is complete. + +6. The aggregated dimensional layer will be loaded to the QGIS and appear in the table of contents. + +7. The aggregated output raster file will be stored in the project folder specified in the "Setup" tab, under the "Final\_output" folder (*Project_Folder/Final_Output/Final_AGG_Raster_output.tif_). + +### 4.7 ABOUT TAB + +![image](https://github.com/worldbank/GEEST/assets/120469484/a949054b-1b8e-46f6-9279-fdd2b54212de) + +Information on the tool its framework, scoring system, and how results should or can be interpreted. + +### 4.8 INSIGHTS TAB +#### 4.8.1 Enablement + +![image](https://github.com/worldbank/GEEST/assets/120469484/e0e94c47-bf17-462c-a41c-5023f96ab642) + +**Classify into discrete classes** + +1. Navigate to and select the enablement score input raster file. This can be the final aggregate score, a dimension aggregate score, or even a single factor output layer. + +2. Click the "Classify" button under the "Enablement Score Input layer" field to run the algorithm. + +3. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/1) Level of Enablement Classification" folder. (*Project_Folder/Insights/1) Level of Enablement Classification/Level_of_Enablement.tif*) + +4. Navigate to and select the population input raster file. + + **Input File:** *Population/Female_population_35_39.tif* (**Any of the age ranges can be used as input**) + +6. Click the "Classify" button under the "Population Input layer" field to run the algorithm. + +7. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/2) Relative Population Count Classification" folder. (*Project_Folder/Insights/2) Relative Population Count Classification/Relative_Population_Count.tif*) + +**Combine score and population classifications** + +8. Navigate to and select the "Level of Enablement" output raster file produced in **step 2**. This file path will be automatically populated if **step 2** was executed in the same work session. + +9. Navigate to and select the "Relative Population Count" output raster file produced in **step 6**. This file path will be automatically populated if **step 6** was executed in the same work session. + +10. Click the "Combine Classification" button to run the algorithm combining the "Level of Enablement" and "Relative Population Count" raster layers. + +11. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/3) Combined Level of Enablement & Relative Population Count Classification" folder. (*Project_Folder/Insights/3) Combined Level of Enablement & Relative Population Count Classification/Enablement_&_Population_Combined_classification.tif*) + +**Aggregation** + +12. Navigate to and select the "Combine Classification" output raster file produced in **step 10**. This file path will be automatically populated if **step 10** was executed in the same work session. + +13. Navigate to and select the aggregation input shapefile. This can be any polygon layer representing boundaries of interest for aggregation (e.g. municipal boundary layer) + + **Input File:** *AdminBoundaries/Admin6.shp* (**Any admin level can be used as input**) + +14. Enter aggregated "Combine Classification" shapefiles output file name. + +15. Click the "Execute" button to run the algorithm. + +16. The output raster file will be stored in the project folder specified in the "Setup" tab, under the "Insights/4) Aggregation" folder. (*Project_Folder/Insights/4) Aggregation/Aggregation_.tif*) + +#### 4.8.2 RE Zone Raster Locations + +![image](https://github.com/worldbank/GEEST/assets/120469484/612670ce-b60f-48a1-b085-7c6478c5b5f8) + +1. Navigate to and select the combined classification input file produced in **step 10** of the "Enablement" tab. This file path will be automatically populated if **step 10** of the "Enablement" tab was executed in the same work session. + +2. Navigate to and select the aggregated combined classification input file produced in **step 15** of the "Enablement" tab. This file path will be automatically populated if **step 15** of the "Enablement" tab was executed in the same work session. + +3. Navigate to and select the potential RE zones input raster file. (Zones in the region that have no RE potential need to be represented with "no data" or "inf" values in the raster file) + + **Input File:** *RE/WBG_REZoning_DOM_score_wind.tif* + + **Input File:** *RE/WBG_REZoning_DOM_score_solar.tif* + +4. Enter the "RE zones" raster file and shapefile prefix for the output file name. + +5. Click the "Execute" button to run the algorithm. + +6. The 2 output files will be stored in the project folder specified in the "Setup" tab, under the "Insights/5) RE Zone Raster Locations" folder. (*Project_Folder/Insights/5) RE Zone Raster Locations/RE_zone_.tif* **&** *Project_Folder/Insights/5) RE Zone Raster Locations/RE_zone_admin_units.shp*) + + +#### 4.8.3 RE Point Locations + +![image](https://github.com/worldbank/GEEST/assets/120469484/55ae3e3a-2b0a-463c-a2d1-c76d37605e17) + +1. Navigate to and select the combined classification input file produced in **step 10** of the "Enablement" tab. This file path will be automatically populated if **step 10** of the "Enablement" tab was executed in the same work session. + +2. Navigate to and select the aggregated combined classification input file produced in **step 15** of the "Enablement" tab. This file path will be automatically populated if **step 15** of the "Enablement" tab was executed in the same work session. + +3. Navigate to and select the RE point locations input shapefile of interest. (These could be existing RE job locations or other points of interest) + +4. Set buffer radial distance in meters. + +5. Enter the "RE point location" shapefiles prefix for the output file names. + +5. Click the "Execute" button to run the algorithm. + +6. The 2 output shapefiles will be stored in the project folder specified in the "Setup" tab, under the "Insights/6) RE Point Locations" folder. (*Project_Folder/Insights/6) RE Point Locations/RE_point_buffer_.shp* **&** *Project_Folder/Insights/6) RE Point Locations/RE_point_admin_units_buffer_.shp*) + +## 5 Troubleshooting + +### 5.1 ACCESSIBILTY TABS PERMISSIONS ERROR + +![image](https://github.com/worldbank/GEEST/assets/120469484/63edfc18-8294-478c-bcc5-1a4f28c07711) + +This error occurs when some of the shapefiles produced in the temp folder of the working directory are trying to be overwritten or deleted but can't because it's still being stored in QGIS's memory. This can occurs even when the layer is removed from the QGIS table of contents. + +**This error may also occur when the tool runs correctly so first check if the desired output file was produced in the working directory.** + +If the file is not produced you can try the following: +- Delete the *temp* folder in the working directory +- If you cannot delete the *temp* folder you will have to close QGIS and open it again, complete the setup tab, go back to the tab where the error occurred and re-run the tab again. + +### 5.2 QGIS PLUGIN/INTERFACE WIDGETS AND TEXT ARE DISTORTED AND SCALED INCORRECTLY +![image](https://github.com/worldbank/GEEST/assets/120469484/e195416b-ee86-4998-9ca5-a4784f7c724e) + +This is a problem linked to display settings caused by the connection of multiple monitors and/or varying display scales and resolutions, rather than a QGIS or plugin-related issue. This is backed by a Microsoft support post, linked [here](https://support.microsoft.com/en-gb/topic/windows-scaling-issues-for-high-dpi-devices-508483cd-7c59-0d08-12b0-960b99aa347d), highlighting the issues that may be experienced when using a high-DPI device, such as a 4k monitor. Additionally, in the scaling display setting, Microsoft indicates that entering a custom scaling size between 100% - 500% is not recommended as "...it can cause text and apps to become unreadable." + +![image](https://github.com/worldbank/GEEST/assets/120469484/248fde5c-dd1a-41d0-94ad-2ace20a74f95) + +Possible solutions to this are: +- Adjust the scale for all monitors to 100%. +- Ensure that the display resolution is the same for both monitors. i.e. If the smallest monitor is set to 1920 x 1080 set the 4k monitor to this display resolution as well. + +### 5.3 RASTER OUTPUTS NOT BEING LOADED AND DISPLAYING CORRECTLY + +![image](https://github.com/worldbank/GEEST/assets/120469484/10de6c72-f8f6-47b8-adb3-930f5c625f66) + +Occasionally, some of the outputs automatically loaded to the QGIS table of contents do not display correctly. To correct this, try removing the layer that is displayed incorrectly and add it again to QGIS. + +## 5.4 ERROR: OUTPUT DIRECTORY NOT SET + +![image](https://github.com/worldbank/GEEST/assets/120469484/b2f2959e-85c4-4e89-8493-dac2b9a20f07) + +If you see the following error message, please check if your output directory has been set in the "Setup" tab. + +### 5.5 ERROR: COUNTRY BOUNDARY POLYGON NOT SET + +![image](https://github.com/worldbank/GEEST/assets/120469484/75882e9d-a9af-43fc-9f68-0293c75b49b3) + +If you see the following error message, please check if you're country boundary polygon layer has been set in the "Setup" tab. + +### 5.6 ERROR: CO-ORDINATE REFERENCE SYSTEM (CRS) NOT SET + +![image](https://github.com/worldbank/GEEST/assets/120469484/120c0cf9-e526-4d8b-adff-de3a9d2f7fb8) + +If you see the following error message, please check if you're CRS has been set in the "Setup" tab. + +### 5.7 ALTERNATIVE WAY TO REFRESH THE PLUGIN IF IT FREEZES OR DOES NOT RUN AS EXPECTED + +1. Install the "Plugin Reloader" plugin. + + 1.1 Navigate to and open “Manage and Install Plugins…” under the plugins tab in QGIS. + + 1.2 In the search bar type “plugin reloader”. + + 1.3 Select the “Plugin Reloader” plugin and click on the install button. + + +![image](https://github.com/worldbank/GEEST/assets/120469484/801db189-92ca-4755-a79f-8898b2e43a2f) + + 1.4 Navigate to the "Plugin Reloader" configuration window under the Plugins tab. + +*Plugins* → *Plugin Reloader* → *Configure* + + 1.5 From the drop-down list select the "gender\_indicator\_tool" plugin and press "OK". + +![image](https://github.com/worldbank/GEEST/assets/120469484/3dc21c04-2ebe-4b33-92bc-1020746ee9e3) + + 1.6 If you encounter an unexpected error in the tool that has not been mentioned in any of the previous troubleshooting sections you can try runing the "plugin reload" tool + +![image](https://github.com/worldbank/GEEST/assets/120469484/80e1ae57-8608-4392-8df2-46e5b5d4789e) + +**OR** + +**If the "Plugin Reloader" does not resolve the error close QGIS, restart it again, and re-run the process you were trying to execute.** + +# List of CRSs for SIDS + +| **Country** | **WGS84 / UTM CRS** | **EPSG** | +| --- | --- | --- | +| Antigua and Barbuda | WGS 84 / UTM zone 20N | 32620 | +| Belize | WGS 84 / UTM zone 16N | 32616 | +| Cabo Verde | WGS 84 / UTM zone 26N | 32626 | +| Comoros | WGS 84 / UTM zone 38S | 32738 | +| Dominica | WGS 84 / UTM zone 20N | 32620 | +| Dominican Republic | WGS 84 / UTM zone 19N | 32619 | +| Fiji | WGS 84 / UTM zone 60S | 32760 | +| Grenada | WGS 84 / UTM zone 20N | 32620 | +| Guinea-Bissau | WGS 84 / UTM zone 28N | 32628 | +| Guyana | WGS 84 / UTM zone 21N | 32621 | +| Haiti | WGS 84 / UTM zone 18N | 32618 | +| Jamaica | WGS 84 / UTM zone 17N | 32617 | +| Kiribati | WGS 84 / UTM zone 1N | 32601 | +| Maldives | WGS 84 / UTM zone 43N | 32643 | +| Marshall Islands | WGS 84 / UTM zone 58N | 32658 | +| Mauritius | WGS 84 / UTM zone 40S | 32740 | +| Micronesia (Federated States of) | WGS 84 / UTM zone 57N | 32657 | +| Nauru | WGS 84 / UTM zone 58N | 32658 | +| Niue | WGS 84 / UTM zone 1S | 32701 | +| Palau | WGS 84 / UTM zone 53N | 32653 | +| Papua New Guinea | WGS 84 / UTM zone 55S | 32755 | +| Samoa | WGS 84 / UTM zone 2S | 32702 | +| Sao Tomé and Principe | WGS 84 / UTM zone 32N | 32632 | +| Solomon Islands | WGS 84 / UTM zone 57S | 32757 | +| St. Lucia | WGS 84 / UTM zone 20N | 32620 | +| St. Vincent and the Grenadines | WGS 84 / UTM zone 20N | 32620 | +| Suriname | WGS 84 / UTM zone 21N | 32621 | +| Timor-Leste | WGS 84 / UTM zone 52S | 32752 | +| Tonga | WGS 84 / UTM zone 60S | 32760 | +| Tuvalu | WGS 84 / UTM zone 60S | 32760 | +| Vanuatu | WGS 84 / UTM zone 59S | 32759 | + +# License +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details