socio4health

commits

Overview

Package socio4health is an extraction, transformation and loading (ETL) classification tool designed to simplify the intricate process of collecting and merging data from multiple sources, focusing on sociodemographic and census datasets from Colombia, Brazil, and Peru, into a harmonized dataset.

Seamlessly retrieve data from online data sources through web scraping, as well as from local files.
Support for various data formats, including .csv, .xlsx, .xls, .txt, .sav, fixed-width files and geospatial files, ensuring versatility in sourcing information.
Consolidating extracted data into a pandas (or dask) DataFrame.

Dependencies

	Dask Dask is a flexible parallel computing library for analytics.
	Pandas Pandas is a well-known open source data analysis and manipulation tool.
	Geopandas Python tools for geographic data.
	Numpy The fundamental package for scientific computing with Python.
	Scrapy Framework for extracting the data you need from websites.
	Matplotlib Library for creating static, animated, and interactive visualizations in Python.
	Torch Python package for tensor computation and deep neural networks.

Installation

socio4health can be installed via pip from PyPI.

# Install using pip
pip install socio4health

Optional extras

Use the following extras to install optional dependencies:

pip install "socio4health[scraping]"
pip install "socio4health[ml]"
pip install "socio4health[geo]"
pip install "socio4health[all]"
pip install "socio4health[dev]"
pip install "socio4health[test]"

How to Use it

To use the socio4health package, follow these steps:

Import the package in your Python script:

from socio4health import Extractor()
from socio4health import Harmonizer

Create an instance of the Extractor class:
```
extractor = Extractor()
```

Extract data from online sources and create a list of data information:

url = 'https://www.example.com'
depth = 0
ext = 'csv'
list_datainfo = extractor.s4h_extract(url=url, depth=depth, ext=ext)
harmonizer = Harmonizer()

For more detailed examples and use cases, please refer to the socio4health documentation.

Resources

Package Website

The socio4health website package website includes API reference, user guide, and examples. The site mainly concerns the release version, but you can also find documentation for the latest development version.

Organisation Website

Harmonize is an international project that develops cost-effective and reproducible digital tools for stakeholders in Latin America and the Caribbean (LAC) affected by a changing climate. These stakeholders include cities, small islands, highlands, and the Amazon rainforest.

The project consists of resources and tools developed in conjunction with different teams from Brazil, Colombia, Dominican Republic, Peru, and Spain.

Organizations

Authors / Contact information

Here is the contact information of authors/contributors in case users have questions or feedback.

Diego Irreño (developer)
Erick Lozano (developer)
Juan Montenegro (developer)
Ingrid Mora (documentation)

Metadata

Release files for socio4health 1.0.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for socio4health 1.0.11
File	Size	Uploaded
socio4health-1.0.11.tar.gz	42.3 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for socio4health 1.0.11
File	Interpreter	ABI	Platform	Reset
socio4health-1.0.11-py3-none-any.whl 39.3 kB Oct 9, 2026	Python 3	none	any	Details

Total release size: 81.6 kB

Release files / socio4health-1.0.11.tar.gz

Download URL	socio4health-1.0.11.tar.gz
Size	42.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`412446913dfb0144013bc071f07999cc2b80a6733211dc8ef28f4a9031903de0`
BLAKE2b-256 checksum How to use checksums	`5a9481912ed65b70bfb290a472fe59eb1ad69ccc4e277be53c7bbe8a15cc2880`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`

Release files / socio4health-1.0.11-py3-none-any.whl

Download URL	socio4health-1.0.11-py3-none-any.whl
Size	39.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c49b209f53b6f4674b81b0e7054bc62e5e6711315c7374637c91a8398d4307a3`
BLAKE2b-256 checksum How to use checksums	`9c44bd90f1494383f4a2acc96cf11e50e1f8896edf91c6800943abfb1eba8f9e`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`