GeoPublicHealth aims to provide a simplified interface for users in epidemiology and public health for QGIS. It is based on the GeoHealth Plugin developed by Etienne Trimaille. GeoPublicHealth includes additional methods that are very relevant for the use of GIS in public health and epidemiology. To use the plugin, you MUST to install first QGIS.

1. Go to https://download.qgis.org/downloads/QGIS-OSGeo4W-3.24.2-1.msi for the specific version of OSGeo4W
2. Run the file and choose Advance Install
3. Select Install from Internet and click on Next>
4. Select the root installing directory (highly recommended to maintain defaults) and click on Next>
5. Select the local package directory (highly recommended to maintain defaults) and click on Next>
6. Select the method for the Internet Connection (highly recommended to maintain defaults) and click on Next>
7. Choose a Download Site (highly recommended to maintain default https://download.osgeo.org) and click on Next>
8. Search for qgis
9. Select for Installing the qgis: QGIS Desktop version should be 3.24.3-1
10. Search for gdal
11. Select for Installing the gdal: The GDAL/OGR library and command line tools version should be 3.4.3-2
12. Search for pysal
13. Select for Installing the python3-libpysal: Core components of PySAL a library for spatial analisys functions version should be 4.3.0-1
14. Select for Installing the python3-pysal: A library for spatial analisys functions version should be 2.3.0-2 and click on Next>
15. Maintain checked the additional unmeet dependencies
16. Accept the Terms and Conditions and click on Next>

You can see a video of this process here

1. Go to https://www.qgis.org for download the specific version 3.30
2. Run the installer and follow instructions
3. macOS High Sierra (10.13) or newer is required. QGIS is not yet notarized as required by macOS Catalina (10.15) security rules. On first launch, please control-click on the icon and choose Open from the context menu, after which a confirmation dialog is shown and you need to click the Open button.
4. In some cases the https://www.xquartz.org/ should be installed. If you have a error about Library not loaded: /opt/X11/lib/libxcb.1.dylib the installing of xquartz will fixed.

1. Start QGIS

This section is only for MacOS users

1. In the Plugins menu select Python Console - This will open the console in QGIS
2. In the prompt of the console (after the >>>) write or copy and paste import pip and click enter - this will load the pip module in QGIS
3. Write or copy and paste pip.main(['install', 'pip', '--upgrade']) and click enter - this will upgrade the pip to the latest version
4. Write or copy and paste pip.main(['install', 'libpysal', '--upgrade']) and click enter - this will upgrade the libpysal to the latest version
5. Write or copy and paste pip.main(['install', 'numba', '--upgrade']) and click enter - this will upgrade the numba to the latest version

1. Launch the plugins manager by going to the Plugins menu and selecting Manage and Install Plugins….
2. In the Settings tab of the plugins settings dialog, scroll down and click on the Add… button.
3. Give the plugin repository the name epipublichealth and then add the full URL https://raw.githubusercontent.com/ePublicHealth/GeoPublicHealth/main/docs/plugins.xml in the URL field.
4. Please be sure that Show also experimental plugins is checked [x]
5. Click on the OK button.
6. Activate the All tab and Search field input geopu.
7. Select the GeoPublicHealth plugin
8. Click on the Install plugin button
9. Close the Plugins dialog
10. Check in the Plugins menu that the GeoPublicHealth plugin is a new option there

• You can see a video of this process for Windows Users here
• You can see a video of this process for Mac Users here

• QGIS 3.24.3-Tisler
• Python 3.9
• Pysal 2.5.0, Pyproj 3.2, libpysal 4.6.2, numb 0.55.2 and geopandas 0.8.1

Please review the Contribution Guidelines

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

This section guides you through submitting an issue report for GeoPublicHealth. Following these guidelines helps maintainers and the community understand your report 📝, reproduce the behavior 💻 💻, and find related reports 🔎.

Before creating bug reports, please check this list as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible.

• Perform a cursory search to see if the problem has already been reported. If it has, adds a comment to the existing issue instead of opening a new one.

Bugs are tracked as GitHub issues. Create an issue on this repository and provide the following information.

Explain the problem and include additional details to help maintainers reproduce the problem:

• Use a clear and descriptive title for the issue to identify the problem.
• Describe the exact steps which reproduce the problem in as many details as possible.
• Provide specific examples to demonstrate the steps. Include links to files or GitHub projects, or copy/pasteable snippets, which you use in those examples. If you're providing snippets in the issue, use Markdown code blocks.
• Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
• Explain which behavior you expected to see instead and why.
• Include screenshots and animated GIFs which show you following the described steps and clearly demonstrate the problem. If you use the keyboard while following the steps, record the GIF. You can use this tool to record GIFs on macOS and Windows, and this tool or this tool on Linux.
• If you're reporting that GeoPublicHealth crashed, include a crash report with the log from QGIS. Include the log report in the issue in a code block, a file attachment, or put it in a gist and provide link to that gist.
• If the problem wasn't triggered by a specific action, describe what you were doing before the problem happened and share more information using the guidelines below.

Provide more context by answering these questions:

• Can you reproduce the problem?
• Did the problem start happening recently (e.g., after updating to a new version ) or was this always a problem?
• If the problem started happening recently, can you reproduce the problem in an older version? What's the most recent version in which the problem doesn't happen?
• Can you reliably reproduce the issue? If not, provide details about how often the problem happens and under which conditions it usually happens.
• If the problem is related to working with files (e.g., opening and editing files), does the problem happen for all files and projects or only some? Does the problem happen only when working with local or remote files (e.g., on network drives), with files of a specific type, with large files or files with very long lines, or with files in a specific encoding? Is there anything else special about the files you are using?

Include details about your configuration and environment:

• Which version of QGIS are you using?
• What's the name and version of the OS you're using?
• Which keyboard layout are you using? Are you using a US layout or some other layout?

• Etienne Trimaille
• This project was designed by UMR Espace-DEV (IRD, UAG, UM2, UR).
• Manuel Vidaurre, ePublicHealth
• Pai (Supharerk Thawillarp) -- QGIS2to3 Migration work =======

Dr. Carlos Castillo-Salgado has taught in The Bloomberg School of Public Health of Johns Hopkins University the 340.701.11 Epidemiologic Applications of GIS the last 15 years and also in his work as Chief of the Special Program for Health Analysis for the Panamerican Health Organization, Regional Office of the World Health Organization for the Regional Office of the Americas. In this capacity, he led the development of SIGEpi as a pioneer GIS for Epidemiology and Public Health. Using the QGIS, the GeoPublicHealth will integrate several of the methods and techniques used in SIGEpi but enhance those with the capacities of QGIS. In February 2020, Pai (Supharerk Thawillarp) did the migration work for the plugin from QGIS 2 systems to QGIS 3.

Original GeoHealth Plugin:

• Etienne Trimaille
• This project was designed by UMR Espace-DEV (IRD, UAG, UM2, UR).

GeoPublicHealth:

• ePublicHealth
• Dr. Carlos Castillo-Salgado
• Manuel Vidaurre, ePublicHealth
• Pai (Supharerk Thawillarp) -- QGIS2to3 Migration work
• This project was designed and extended by the Johns Hopkins/Bloomberg School of Public Health Global Public Health Observatory

Please see LICENSE @ 2017-2022