amazonasdatahub

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:

• English documentation
• 🇧🇷 Documentação em Português (BR)

Python only documentation:

• English documentation for Python version
• 🇧🇷 Documentação em Português (BR) para versão do Python

Overview

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

List of available datasets:

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

• CARVALHO, Nelson Geraldo Aquino de; NASCIMENTO, Leonardo Brandão Freitas do. amazonasdatahub. 2026. https://onelsoncarvalho.github.io/amazonasdatahubpy.