Social vulnerability

Description

This analysis computes a social vulnerability score for per associated zone in census data. The computation extracts zoning and a social vulnerability score obtained by computing demographic features of interest against national average values.

The output of the computation is a dataset in CSV format.

Contributors

• Science: Elaina Sutley, Amin Enderami

• Implementation: Amin Enderami, Santiago Núñez-Corrales, and NCSA IN-CORE Dev Team

Related publications

• Enderami, S. A., and Sutley, E. (2024). Social vulnerability score: a scalable index for representing social vulnerability in virtual community resilience testbeds. Natural Hazards. https://doi.org/10.1007/s11069-024-06499-z

Input parameters

key name	type	name	description
result_name *	str	Result name	Name of the result dataset.
year *	int	Year	Census year for the input datasets.
state *	str	State	State according to US Census.
county *	str	County	County according to US Census.
census_geo_level *	str	Census geographic level	Geographic level of granularity described by the dataset.

Input datasets

key name	type	name	description
national_vulnerability_feature_averages *	incore:socialVulnerabilityFeatureAverages	National vulnerability feature averages	National averages for features determining social vulnerability.
social_vulnerability_demographic_factors *	incore:socialVulnerabilityDemFactors	Demographic factors	social vulnerability demographic factors for a given geographic type.

Output datasets

key name	type	parent key	name	description
social_vulnerability_score *	incore:socialVulnerabilityScore	social_vulnerability_score	Results	A dataset containing results (format: CSV) with social vulnerability score at the required geographic level.

(* required)

Execution

code snippet:

    # Create social vulnerability analysis instance
    sva = SocialVulnerability(client)

    # Load input dataset
    sva.load_remote_input_dataset("national_vulnerability_feature_averages", national_vulnerability_feature_averages)
    sva.load_remote_input_dataset("social_vulnerability_demographic_factors", social_vulnerability_demographic_factors)

    # Specify the result name
    result_name = "social_vulnerabilty"

    # Set analysis parameters
    sva.set_parameter("result_name", result_name)
    sva.set_parameter("year", year)
    sva.set_parameter("state", state)
    sva.set_parameter("county", county)
    sva.set_parameter("census_geo_level", census_geo_level)
    
    # Run social vulnerability analysis
    sva.run_analysis()

full analysis: social_vulnerability.ipynb