functions.luciano_vis module

Módulo para a criação da visualização do integrante Luciano Sampaio. Contém 6 funções incluindo aquela que gera e salva o gráfico.

functions.luciano_vis.contagem_elementos(dataframe: DataFrame, elemento_contado: str, nome_da_serie: str) → Series

Retorna uma série do Pandas com as contagens dos elementos na ordem deles.

Parâmetros

dataframe:

Tipo: pandas.DataFrame

Descrição:

DataFrame a ser modificado

elemento_contado:

Tipo: str

Descrição:

Nome da coluna em que o value_counts vai ser feito

nome_da_serie:

Tipo: str

Descrição:

nome da série a ser retornada

Retorna

contagem:

Tipo: pandas.Series

Descrição:

série do pandas com as informações feitas

Exemplos

>>> contagem_elementos(pd.DataFrame({"NOME": ["A", "B", "B"]}), "NOME", "SERIE EXEMPLO")
NOME
A    1
B    2
Name: SERIE EXEMPLO, dtype: int64

functions.luciano_vis.cria_datetime(dataframe: DataFrame) → Series

Cria uma série do Pandas com datetimes relativos aos anos e meses das colunas “ANO_VENDA” e “MES_VENDA”. Os dias no datetime serão todos o primeiro dia de cada mês.

Parâmetros:

dataframe:

Tipo: pandas.DataFrame

Descrição:

o dataframe do Pandas com as colunas “ANO_VENDA” e “MES_VENDA”.

Retorna:

datetimes:

Tipo: pandas.Series

Descrição:

série do Pandas com as datas em formato datetime.

Exemplo:

>>> cria_datetime(pd.DataFrame({"ANO_VENDA": [2020, 2020, 2021], "MES_VENDA": [3, 3, 12]}))
0   2020-03-01
1   2020-03-01
2   2021-12-01
dtype: datetime64[ns]

functions.luciano_vis.filtra_e_contatena(coluna_do_valor: str, valores_procurados: list | str) → DataFrame

Usa as funções do módulo utils para concatenar todas as datas disponíveis e pegar apenas as linhas com os valores procurados

Parâmetros:

coluna_do_valor:

Tipo: str

Descrição:

nome da coluna em que o valor procurado deve estar

valores_procurados:

Tipo: list | str

Descrição:

valor, caso string, ou valores, caso lista, que serão procurados na coluna

Retorna:

dataframe:

Tipo: pandas.DataFrame

Descrição:

dataframe pandas com os dados filtrados

functions.luciano_vis.grafico_linhas(datas: Iterable[datetime64], valores: tuple[Iterable] | Iterable, labels: tuple[str] | str, titulo: str | None = None, transparencias: tuple[float] | float = 1.0)

Prepara um gráfico de linhas com os dados fornecidos usando o matplotlib.pyplot

Parâmetros

datas:

Tipo: Iterable[datetime]

Descrição:

Datas que serão usadas no eixo X.

valores:

Tipo: tuple[Iterable] | Iterable

Descrição:

Valores que serão plotados em relação ao eixo Y. Se há mais de uma linha, o parâmetro deve receber uma tupla com os dados de cada linha.

labels:

Tipo: tuple[str] | str

Descrição:

Legendas das linhas a serem plotadas. Se há mais de uma linha, esse parâmetro deve receber uma tupla.

titulo:

Tipo: str | None

Descrição:

Título do gráfico.

transparencias:

Tipo: tuple[float] | float

Descrição:

Transparências das linhas a serem geradas. Se há mais de uma linha, esse parâmetro deve receber uma tupla.

Exemplo:

>>> datas = cria_datetime(pd.DataFrame({"ANO_VENDA": [2020, 2020, 2021], "MES_VENDA": [3, 3, 12]}))
>>> grafico_linhas(datas, ([1, 3, 4], [2, 3, 1]), ("Primeira linha"))
Traceback (most recent call last):
...
ValueError: As quantidades de valores e labels são diferentes.

functions.luciano_vis.luciano_vis(acao: Literal['show', 'save', None], path: str | None = None)

Gera o gráfico escolhido por Luciano. Vai ser exibido ou salvo.

Parâmetros:

acao:

Tipo: str | None

Descrição:

Ação a ser executada depois de formar o gráfico. Pode ser: “show”: irá mostrar o gráfico e fechar a figura. “save”: irá salvar o gráfico e fechar a figura. None: formará o gráfico, mas não o fechará.

path:

Tipo: str | None

Descrição:

path em que a figura será salva. É necessário caso o parâmetro acao seja “save”.

Exemplo:

>>> luciano_vis(acao = "salvar")
Traceback (most recent call last):
...
ValueError: Ação 'salvar' inválida. 
Valores válidos: 'show', 'save', None

functions.luciano_vis.regiao_estado(sigla_estado: str) → str

Retorna a região do estado brasileiro: Norte, Nordeste, Centro-Oeste, Sudeste ou Sul.

Parâmetros

sigla_estado:

Tipo: str

Descrição:

Sigla do estado brasileiro

Exemplo: “MG”

Retorna:

regiao:

Tipo: str | None

Descrição:

Região em que o estado brasileiro está. Se a sigla inserida for inexistente, retorna None.

Exemplo: Sudeste

Exemplos

>>> regiao_estado("RR")
'Norte'

>>> regiao_estado("BH")