SVInsight is a python package for calculating an exploratory social vulnerability index. This package calculates SVI using two methods: (1) an iterative factor analysis method and (2) a rank method, both of which have been heavily utilized in scholarly research. This package automates the creation and comparison of indices using U.S. American Community Survey 5-Year Data (ACS5) at the block group or tract level. Users can customize which social, demographic, and economic variables are included in their own custom indices.
This package is a tool to efficiently calculate an exploratory estimate of social vulnerability for a given region. Social vulnerability is an incredibly complex and constantly evolving concept, and researchers, practitioners, and users of this software should always consult relevant peer-reviewed literature and local experts to validate findings.
For user guides, examples, and a more indepth discussion of social vulnerability indices, refer to the documentation.
Travis County SVI estimates from 2013 to 2021
To quickly install the package, use pip to install via PyPI:
pip install SVInsight
SVInsight can then be imported into python:
>>> from svinsight import SVInsight as svi
SVInsight has dependencies that rely on gdal, which may require its own prior installation based on your operating system and coding environment.
For example:
-
On macOS:
brew install gdal -
On Ubuntu:
sudo apt-get install gdal-bin libgdal-dev -
On Windows:
pip install gdal==<version> --find-links https://www.lfd.uci.edu/~gohlke/pythonlibs/
Please refer to the docs website for more detailed installation guides if any problems persist.
In its simplest form the SVInsight workflow takes 5 lines of code:
>>> project = svi(project_name, file_path, api_key, geoids)
>>> project.boundaries_data(boundary, year)
>>> project.census_data(boundary, year)
>>> project.configure_variables(config_file)
>>> project.calculate_svi(config_file, boundary, year)
Some typical compute times that can be expected to run the workflow for various locations at the Block Group level can be found below:
| Location | Compute Time (seconds) |
|---|---|
| Texas | 125.75 |
| New York | 120.10 |
| Connecticut | 42.25 |
| Los Angeles, CA | 65.60 |
| Providence County, RI | 27.22 |
| Travis County, TX | 26.34 |
We welcome contributions to SVInsight. Please open an issue or a pull request if there is functionality you would like to see or propose. Refer to our contributing guide for more information.
If you use this package and wish to cite it, please do. We are currently in the process of submitting this work to the Journal of Open Source Software. In the meantime, please refer to recent published work in Frontiers in Water, Hydrology and Earth System Sciences, and The International Journal of Disaster Risk Reduction.
This work was supported in part by the National Science Foundation Graduate Research Fellowship (grant no. DGE-1610403), Future Investigators in NASA Earth and Space Science and Technology (NASA FINESST, grant no. 21-EARTH21-0264), Planet Texas 2050, a research grand challenge at the University of Texas at Austin, and the U.S. Department of Energy, Office of Science, Biological and Environmental Research Program’s South-East Texas Urban Integrated Field Laboratory under Award Number DE-SC0023216.