{"id":28305421,"url":"https://github.com/toxpi/toxpi-gis","last_synced_at":"2025-09-01T20:39:28.341Z","repository":{"id":83458012,"uuid":"327949718","full_name":"ToxPi/ToxPi-GIS","owner":"ToxPi","description":"Production of shareable, interactive feature layers from the output of the ToxPi GUI","archived":false,"fork":false,"pushed_at":"2023-06-09T17:59:35.000Z","size":21818,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-31T11:45:14.604Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ToxPi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-01-08T16:07:20.000Z","updated_at":"2024-12-17T08:46:42.000Z","dependencies_parsed_at":"2023-04-17T06:17:02.746Z","dependency_job_id":"153c1127-f386-4916-923f-6b3c15af998b","html_url":"https://github.com/ToxPi/ToxPi-GIS","commit_stats":null,"previous_names":["toxpi/toxpi-gis"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ToxPi/ToxPi-GIS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxPi%2FToxPi-GIS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxPi%2FToxPi-GIS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxPi%2FToxPi-GIS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxPi%2FToxPi-GIS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ToxPi","download_url":"https://codeload.github.com/ToxPi/ToxPi-GIS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxPi%2FToxPi-GIS/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261056595,"owners_count":23103474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-24T02:12:38.663Z","updated_at":"2025-09-01T20:39:28.329Z","avatar_url":"https://github.com/ToxPi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ToxPi\\*GIS Toolkit\n## **GitHub Directory:** \nThe following methods are used for the production and visualization of shareable, interactive feature layers containing ToxPi profiles using ArcGIS Pro. To learn more about ToxPi, see [ToxPi Description](#ToxPi-Description) below.  \n\n* For users looking to generate a predesigned layer file of ToxPi profiles with Python, or users who are unsure, see [Method 1](#method-1-toxpi_creationpy--toxpi_creation_customizedpy).  \n\n* For users looking to use an ArcGIS Toolbox(e.g., for integration into existing ArcGIS workflows), see [Method 2](#method-2-toxpitoolboxtbx).  \n\n* For users looking to see example walkthroughs, see the vignettes in [Examples](./Examples/).  \n\n* For users looking to visualize existing maps, see [Visualizations](./Examples/Visualizations.md).  \n\n* For users requiring help with data manipulation and formatting requirements, see [Utilities](./Utilities/).  \n\n\u003ca id=\"ToxPi-Description\"\u003e\u003c/a\u003e\n\n## **ToxPi Description:** \n\n**Definition**  \nThe ToxPi framework provides a method for transparently integrating and visualizing data across disparate information domains and is often used to determine risk values for the data being analyzed.  \n\u003cbr\u003e\n\n**Description**  \nData that are not normally compared are combined into a data matrix comprising various data domains, or slice categories, with varying weights that represent the different data categories. Each slice category, represented by a color scheme, can then be separated into subdomains. The data matrix is then analyzed to produce a risk score ranging from 0 to 1 for each slice category, as well as a corresponding overall score that represents the record’s total risk from all categories. These scores are determined via a rank system for easy comparison between different data points and are displayed in a ToxPi profile for each record. If the data record's are locations, the figures can be mapped geographically. The calculation process, as well as ToxPi profile interpretation for Covid-19 data, are depicted below. For a more in depth look at the ToxPi framework, visit www.toxpi.org\n\n\u003cp align = \"center\"\u003e\nCalculation  \n\u003cbr\u003e\n\u003cimg src=\"./Images/ToxPiDescription.PNG\" data-canonical-  \nsrc=\"./Images/ToxPiDescription.PNG\" width=\"550\" height=\"425\" /\u003e  \n\u003c/p\u003e  \n\n\u003cp align = \"center\"\u003e\nInterpretation\n\u003cbr\u003e\n\u003cimg src=\"./Images/ToxPiInterpretation.PNG\" data-canonical-  \nsrc=\"./Images/ToxPiInterpretation.PNG\" width=\"550\" height=\"425\" /\u003e  \n\u003c/p\u003e \n\n\u003ca id=\"Map-Creation-Workflow\"\u003e\u003c/a\u003e\n\n## **Map Creation Workflow:**  \n\n\u003cp align = \"center\"\u003e\n\u003cimg src=\"./Images/MapCreationWorkflow.PNG\" data-canonical-  \nsrc=\"./Images/MapCreationWorkflow.PNG\" width=\"600\" height=\"300\" /\u003e  \n\u003c/p\u003e  \n\n\u003ca id=\"method-1-toxpi_creationpy--toxpi_creation_customizedpy\"\u003e\u003c/a\u003e\n  \n## **Method 1: ToxPi_creation.py \u0026 ToxPi_creation_customized.py**   \nUse the script [ToxPi_creation.py](ToxPi_creation.py)  to automatically produce predesigned feature layers containing interactive ToxPi profiles using the output of the ToxPi GUI as input. This is the suggested method, unless you are skilled with ArcGIS Pro and have a specific need for a Toolbox. An example walkthrough is shown in [Vignette 1](./Examples/Vignette1-%20Using%20ToxPi_creation.md). \n\u003cbr\u003e\u003c/br\u003e\n[ToxPi_creation_customized.py](ToxPi_creation_customized.py) can be used with county or census tract data for a more data rich map and acts as an example of how ToxPi_creation.py can be customized with further geoprocessing steps to create more advanced maps for specific data. An example walkthrough is shown in [Vignette 3](./Examples/Vignette3-%20Using%20ToxPi_creation_customized.md).  \n\nSteps:  \n1A. Load raw data into the [ToxPi GUI](https://toxpi.org/)  \n1B. Analyze data and output results file to a CSV, and make sure file meets data requirements    \n1C. Run python script from windows command prompt using the required parameters  \n1D. Open output layer file in ArcGIS Pro  \n1E. Share resulting map to ArcGIS Online  \n\n\u003ca id=\"method-2-toxpitoolboxtbx\"\u003e\u003c/a\u003e\n\n## **Method 2: ToxPiToolbox.tbx**  \nThe ToxPiToolbox.tbx file is an ArcToolbox that contains a custom tool called ToxPi Construction for drawing the polygons that make up ToxPi profiles. It requires more manual steps than the script; however, a model can be created for the automation of map creation, and the toolbox allows for more customization than the script, including drawing a subset of slices for ToxPi profiles. This, along with a walkthrough example, are described under [Vignette 2](./Examples/Vignette2-%20Using%20ToxPiToolbox.md).  \n\nSteps:  \n2A. Load raw data into the [ToxPi GUI](https://toxpi.org/)  \n2B. Analyze data and output results file to a CSV, and split the coordinates into two separate columns  \n2C. Add results file to ArcGIS Pro  \n2D. Add ToxPiToolbox.tbx to ArcGIS Pro  \n2E. Run required analysis steps including the ToxPi tool and share resulting map to ArcGIS Online   \n\n\u003ca id=\"Acknowledgements/References:\"\u003e\u003c/a\u003e\n\n## **Acknowledgements:**  \nWe thank the PVI project team for data provision and the Baker Lab at NCSU for software testing. We also thank Dan Schmitt and Logan Wenzel for their expertise in implementation. This research was supported by the National Institutes of Health (NIH) grant awards ES030007 and ES025128, and by intramural funds from the National Institute of Environmental Health Sciences and the National Institute for Allergy and Infectious Diseases. Portions of the code for drawing slices were adapted from the Coxcomb tool for ArcGIS Pro. \n\n## Citation:\nFleming J, Marvel SW, Supak S, Motsinger-Reif AA, Reif DM. ToxPi*GIS Toolkit: creating, viewing, and sharing integrative visualizations for geospatial data using ArcGIS. J Expo Sci Environ Epidemiol. 2022 Apr 26. doi: 10.1038/s41370-022-00433-w. PMID: 35474345.\n\nOpen-access link to full-text article: [https://www.nature.com/articles/s41370-022-00433-w](https://www.nature.com/articles/s41370-022-00433-w) \n\n\n\n    \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxpi%2Ftoxpi-gis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoxpi%2Ftoxpi-gis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxpi%2Ftoxpi-gis/lists"}