utils_tomas module

Este módulo contém funções que fornecem análises estatísticas e visualizações gráficas

utils_tomas.create_age_histogram(army_age_df: DataFrame) → bool

Cria um histograma de idade.

Parameters

army_age_dfpd.Series: Uma série com dados de idade.

Returns

bool: Retorna True se o gráfico foi criado com sucesso, False caso contrário.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> army_age_df = get_age(army_df,"ANO_NASCIMENTO")
>>> result = create_age_histogram(army_age_df)
>>> isinstance(result, bool)
True

utils_tomas.create_correlation_matrix(army_df: DataFrame, hum_measures_list: List[str]) → bool

Cria uma matriz de correlação para medidas físicas humanas.

Parameters

army_df: pd.DataFrame: DataFrame com dados de medidas físicas humanas.
hum_measures_listList[str]: Lista de colunas no DataFrame representando medidas físicas.

Returns

bool: Retorna True se a matriz de correlação foi criada com sucesso, False caso contrário.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> result = create_correlation_matrix(army_df, ["ALTURA", "CINTURA"])
>>> isinstance(result, bool)
True

utils_tomas.create_height_heatmap(merged_army_height_df: DataFrame, height_colname: str, state_colname: str) → bool

Cria um mapa de calor brasileiro que representa a diferença entre as médias de altura por estado.

Parameters

merged_army_height_dfpd.DataFrame: DataFrame combinando informações de altura com dados geográficos dos estados brasileiros.
height_colnamestr: Nome da coluna no DataFrame que representa a altura.
state_colnamestr: Nome da coluna no DataFrame que representa os estados.

Returns

bool: Retorna True se o gráfico foi criado com sucesso, False caso contrário.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> geobrazil_df = get_state_coordinates("geo_data.gpkg")
>>> merged_df = merge_height_geography_df(army_df, "ALTURA", "UF_RESIDENCIA", geobrazil_df)
>>> result = create_height_heatmap(merged_df, "ALTURA", "UF_RESIDENCIA")
>>> isinstance(result, bool)
True

utils_tomas.get_age(army_df: DataFrame, birth_date_colname: str) → DataFrame

Calcula a idade a partir da data de nascimento em um DataFrame.

Parameters

army_df: pd.DataFrame: DataFrame com dados do alistamento militar.
birth_date_colnamestr: Nome da coluna no DataFrame que contém a data de nascimento.

Returns

pd.DataFrame: Um DataFrame contendo a idade calculada de acordo com a data de nascimento.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> result = get_age(army_df, "ANO_NASCIMENTO")
>>> isinstance(result, pd.DataFrame) or result is None
True

utils_tomas.get_state_coordinates(path: str, dropnull: bool = False) → GeoDataFrame

Lê um arquivo gpkg e cria um GeoDataFrame.

Parameters

path: str: O caminho do arquivo gpkg que será lido.
dropnullbool: Caso True, remove as linhas nulas; se False, mantém as linhas com valores nulos.

Returns

gpd.GeoDataFrame: Um GeoDataFrame contendo informações dos estados brasileiros.

Raises

NameError: Se o arquivo não existir ou o caminho estiver incorreto.

Example

>>> geobrazil_df = get_state_coordinates("geo_data.gpkg")
>>> isinstance(geobrazil_df, gpd.GeoDataFrame) or geobrazil_df is None
True

utils_tomas.get_stats(army_df: DataFrame, numeric_colname: str) → Series

Realiza análise estatística de uma coluna em um DataFrame.

Parameters

army_df: pd.DataFrame: DataFrame com dados do alistamento militar.
numeric_colnamestr: Nome da coluna no DataFrame com dados numéricos.

Returns

pd.Series: Uma série com estatísticas da coluna especificada.

Raises

KeyError: Se a coluna especificada não existir no DataFrame.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> result = get_stats(army_df, "ALTURA")
>>> isinstance(result, pd.Series) or result is None
True

utils_tomas.merge_height_geography_df(army_df: DataFrame, height_colname: str, state_colname: str, geobrazil_df: GeoDataFrame) → DataFrame

Realiza o merge do DataFrame de alistamento militar com um GeoDataFrame contendo informações geográficas.

Parameters

army_df: pd.DataFrame: DataFrame com dados do alistamento militar.
height_colnamestr: Nome da coluna no DataFrame que representa a altura.
state_colnamestr: Nome da coluna no DataFrame que representa os estados.
geobrazil_dfgpd.GeoDataFrame: GeoDataFrame com dados dos estados brasileiros.

Returns

pd.DataFrame: Um DataFrame que combina informações de altura com dados geográficos dos estados brasileiros.

Raises

KeyError: Se as colunas especificadas não existirem no DataFrame fornecido.

Example

>>> army_df = pd.read_csv('sermil2022.csv')
>>> geobrazil_df = get_state_coordinates("geo_data.gpkg")
>>> result = merge_height_geography_df(army_df, "ALTURA", "UF_RESIDENCIA", geobrazil_df)
>>> isinstance(result, pd.DataFrame) or result is None
True