amazonasdatahub#

amazonasdatahub logo

The goal of amazonasdatahub is to aggregate databases from the State of Amazonas (AM), Brazil, for conducting studies and preparing educational materials, as well as to facilitate access to organized and processed data, thereby supporting research and teaching and enabling the application of statistical methods.

Full documentation of both Python and R versions is available in the following languages/Documentação das versões em Python e R estão disponíveis nos seguintes idiomas:

Python only documentation:

Overview#

This amazonasdatahub package provides databases from various types and sources, all of which concern the State of Amazonas.

List of available datasets:

Dataset

Area

Source

agriculture_amazonas

Agriculture and Livestock

Institute of Agricultural and Sustainable Forestry Development of the State of Amazonas - 2024

aids_amazonas

Health

Department of HIV, AIDS, Tuberculosis, Viral Hepatitis, and Sexually Transmitted Infections, 2024

gdp_amazonas

Economy

Scientific Journal of Applied Social and Clinical Science - TIME SERIES ANALYSIS FOR THE QUARTERLY GROSS DOMESTIC PRODUCT OF AMAZONAS

humidity_manaus

Climate

NASCIMENTO, Leonardo Brandão Freitas; LIMA, Max Sousa; DUCZMAL, Luiz H. P-min-stable regression models for time series with extreme values of limited range. Environmetrics, Issue 2, v. 36, 2025.

malaria_amazonas

Health

Lais Baroni, M. P. (2020). An Integrated Dataset of Malaria Notifications in the Legal Amazon (Dataset). Synapse. https://doi.org/10.7303/SYN21552203

prf_amazonas

Road Safety

Brasil. Polícia Rodoviária Federal (PRF). Dados Abertos da PRF: Acidentes de Trânsito

rionegro_amazonas

Environment

Porto de Manaus. Nível do Rio Negro

srl_muni

Education

ALMEIDA, Thiago da Cruz de. Physical Literacy e desempenho em leitura de escolares amazônicos: um estudo de associação. 2024. 104 f. Dissertação (Mestrado em Educação) - Universidade Federal do Amazonas, Manaus, 2024.

Installation#

To install amazonasdatahub, you need the following tools installed on your computer or development environment:

  • Python 3.14.3

  • pip (package manager)

  • Git

You can install the development version of amazonasdatahub using git clone to clone the remote repository into your local environment and pip to install it:

# cloning
git clone https://github.com/onelsoncarvalho/amazonasdatahubpy amazonasdatahub
cd amazonasdatahub

# installing
pip install amazonasdatahub

Usage and Examples#

Loading amazonasdatahub#

Use import and from to require the functions from datasets module of amazonasdatahub:

from amazonasdatahub.datasets import get_dataset

The dataset name should be provided as argument of get_dataset(dataset: str) function.

agriculture_amazonas = get_dataset('agriculture_amazonas')
aids_amazonas = get_dataset('aids_amazonas')
gdp_amazonas = get_dataset('gdp_amazonas')

Get dataset documentation#

Each dataset has its own documentation to provide the user information about the dataset variables.

Use import and from to require the functions from docs module:

from amazonasdatahub.docs import get_doc

The dataset name should be provided as argument of get_docs(dataset: str) function.

get_doc('agriculture_amazonas')
get_doc('aids_amazonas')
get_doc('gdp_amazonas')

Contributing#

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License#

amazonasdatahub was created by Nelson Geraldo Aquino de Carvalho. It is licensed under the terms of the MIT license.

Citation#