COVID19_ES_Py package

Submodules

COVID19_ES_Py.exceptions module

O módulo exceptions.py apenas declara a exceção RelatorioError.

exception COVID19_ES_Py.exceptions.RelatorioError

Base: Exception

COVID19_ES_Py.relatorio module

O módulo relatorio.py é o principal do pacote a partir de 15/04/2020 (COVID19-ES-Py 3.0.0). Nele são introduzidas as classes e métodos utilizados para coletar dados dos relatórios emitidos pelo Governo através do painel PowerBI.

class COVID19_ES_Py.relatorio.Caso(dados=None, data=None, classificacao=None, evolucao=None, criterioConfirmacao=None, statusNotificacao=None, municipio=None, bairro=None, faixaEtaria=None, sexo=None, racaCor=None, escolaridade=None, sintomas=None, comorbidades=None, ficouInternado=None, viagemBrasil=None, viagemInternacional=None)

Base: object

Um objeto Caso é capaz de abstrair o registro de um caso lido do csv.

Parâmetros:dados (iterable) – Um iterável com os dados do caso.
data

A data de registro do caso.

Type:Objeto arrow
classificacao

A classificação da ocorrência de COVID-19 no paciente.

Type:str
evolucao

A evolução da situação do paciente ou None se não for informada.

Type:str ou None
criterioConfirmacao

O critério usado para a classificação do caso ou None se não for informada.

Type:str ou None
statusNotificacao

O estado atual do caso.

Type:str
municipio

O município de origem do paciente.

Type:str
bairro

O bairro de origem do paciente.

Type:str ou None
faixaEtaria

A faixa etária do paciente.

Type:str
sexo

O sexo do paciente.

Type:str
racaCor

A raça/cor do paciente ou None se não for informada.

Type:str ou None
escolaridade

O grau de escolaridade do paciente ou None se não for informada.

Type:str
sintomas

Os sintomas apresentados pelo paciente.

Type:dict : bool
comorbidades

As comorbidades apresentadas pelo paciente.

Type:dict : bool
ficouInternado

Se o paciente ficou internado ou não.

Type:bool ou None
viagemBrasil

Se o paciente realizou viagem nacional ou não.

Type:bool ou None
viagemInternacional

Se o paciente realizou viagem internacional ou não.

Type:bool ou None
carrega_dados_linha(linha)

Carrega os dados presentes em uma linha do csv para o objeto Caso. Retorna o objeto Caso preenchido.

class COVID19_ES_Py.relatorio.LeitorRelatorio(caminhoCSV=None)

Base: object

Um objeto LeitorRelatorio é capaz de manipular relatórios emitidos pelo painel PowerBI.

Parâmetros:caminhoCSV (string) – Caminho até o arquivo csv. Se não for informado, baixa do PowerBI.
csv

A string com caminho ou URL do arquivo csv.

Type:str
linhasRelatorio

A lista de objetos Row lidos do arquivo csv.

Type:list : Row
relatorio

O objeto Relatorio criado a partir do csv O número de municípios infectados deste relatório.

Type:Relatorio
carrega_ultimo_relatorio()

Baixa e lê o arquivo csv mais recente do PowerBI.

filtra_casos_ate_dia(data)

Filtra relatório por casos até o dia fornecido (incluso).

Parâmetros:data (str) – A data limite (incluso) a ser usada como filtro. Formatos de data aceitos: “DD/MM/YYYY”, “DD-MM-YYYY”, “DD_MM_YYYY”, “DD.MM.YYYY”, “DDMMYYYY”.
Retorna:Relatorio – O Relatorio filtrado e preenchido com os registros até a data especificada.
Tipo de retorno:
 Relatorio
filtra_casos_no_dia(data)

Filtra relatório por casos no dia fornecido.

Parâmetros:data (str) – A data específica a ser pesquisada. Formatos de data aceitos: “DD/MM/YYYY”, “DD-MM-YYYY”, “DD_MM_YYYY”, “DD.MM.YYYY”, “DDMMYYYY”.
Retorna:Relatorio – O Relatorio filtrado e preenchido com os registros da data especificada.
Tipo de retorno:
 Relatorio
class COVID19_ES_Py.relatorio.Municipio(nome)

Base: object

Um objeto Municipio representa um município do estado do Espírito Santo.

Parâmetros:Nome (str) – O nome do município a ser atribuído ao objeto.
nome

O nome do município.

Type:str
casos

Uma lista de objetos do tipo Caso.

Type:list : Caso
casosConfirmados

O número de casos confirmados no município.

Type:int
obitos

O número de óbitos confirmados em decorrência de COVID-19 no município.

Type:int
class COVID19_ES_Py.relatorio.Relatorio(caminhoCSV=None)

Base: object

Um objeto Relatorio é capaz de abstrair um relatório em csv emitido pelo painel PowerBI.

Parâmetros:caminhoCSV (string) – Caminho até o arquivo csv. Se não for informado, baixa do PowerBI.
csv

A string com caminho ou URL do arquivo csv.

Type:str
linhasRelatorio

A lista de objetos Row lidos do arquivo csv.

Type:list : Row
casosMunicipios

O dicionário de objetos Municipio

Type:dict : Municipio
importadosOuIndefinidos

O dicionário com total de casos confirmados e óbitos de municípios indefinidos ou de pacientes de fora do ES.

Type:dict : int
totalGeral

O dicionário com total de casos confirmados e óbitos no ES.

Type:dict : int
nMunicipiosInfectados

O número de municípios infectados deste relatório.

Type:int
busca_casos_municipio(municipio)

Realiza pesquisa no Relatorio por casos registrados em um município.

Parâmetros:municipio (str) – O município a ser pesquisado.
Raises:RelatorioError – Se o município não for encontrado na lista de casos.
Retorna:self.casos[municipio] – O dicionário de casos registrados no município.
Tipo de retorno:
 dict
inicializa_dicionario_municipios()

Inicializa o dicionário de municípios do Relatorio.

popula_relatorio()

Preenche o Relatorio com as informações presentes em self.linhasRelatorio e retorna uma cópia do Relatorio.

COVID19_ES_Py.utils module

O módulo utils.py contém funções e constantes auxiliares.

COVID19_ES_Py.utils.remove_caracteres_especiais(stringEntrada)

Remove caracteres especiais (acentos, etc) de uma string.

COVID19_ES_Py.utils.trata_dados_linha(linha)

Trata e corrige os valores das linhas dos arquivos csv de relatórios.

Module contents

Leitor de relatórios de casos de COVID-19 no Espírito Santo.
>>> import COVID19_ES_Py
>>> leitor = COVID19_ES_Py.LeitorRelatorio()
>>> relatorio = leitor.carrega_ultimo_relatorio()

Veja https://github.com/AtilioA/COVID19-ES-Py ou https://covid19-es-py.readthedocs.io/ para mais informações.

class COVID19_ES_Py.LeitorRelatorio(caminhoCSV=None)

Base: object

Um objeto LeitorRelatorio é capaz de manipular relatórios emitidos pelo painel PowerBI.

Parâmetros:caminhoCSV (string) – Caminho até o arquivo csv. Se não for informado, baixa do PowerBI.
csv

A string com caminho ou URL do arquivo csv.

Type:str
linhasRelatorio

A lista de objetos Row lidos do arquivo csv.

Type:list : Row
relatorio

O objeto Relatorio criado a partir do csv O número de municípios infectados deste relatório.

Type:Relatorio
carrega_ultimo_relatorio()

Baixa e lê o arquivo csv mais recente do PowerBI.

filtra_casos_ate_dia(data)

Filtra relatório por casos até o dia fornecido (incluso).

Parâmetros:data (str) – A data limite (incluso) a ser usada como filtro. Formatos de data aceitos: “DD/MM/YYYY”, “DD-MM-YYYY”, “DD_MM_YYYY”, “DD.MM.YYYY”, “DDMMYYYY”.
Retorna:Relatorio – O Relatorio filtrado e preenchido com os registros até a data especificada.
Tipo de retorno:
 Relatorio
filtra_casos_no_dia(data)

Filtra relatório por casos no dia fornecido.

Parâmetros:data (str) – A data específica a ser pesquisada. Formatos de data aceitos: “DD/MM/YYYY”, “DD-MM-YYYY”, “DD_MM_YYYY”, “DD.MM.YYYY”, “DDMMYYYY”.
Retorna:Relatorio – O Relatorio filtrado e preenchido com os registros da data especificada.
Tipo de retorno:
 Relatorio
class COVID19_ES_Py.Relatorio(caminhoCSV=None)

Base: object

Um objeto Relatorio é capaz de abstrair um relatório em csv emitido pelo painel PowerBI.

Parâmetros:caminhoCSV (string) – Caminho até o arquivo csv. Se não for informado, baixa do PowerBI.
csv

A string com caminho ou URL do arquivo csv.

Type:str
linhasRelatorio

A lista de objetos Row lidos do arquivo csv.

Type:list : Row
casosMunicipios

O dicionário de objetos Municipio

Type:dict : Municipio
importadosOuIndefinidos

O dicionário com total de casos confirmados e óbitos de municípios indefinidos ou de pacientes de fora do ES.

Type:dict : int
totalGeral

O dicionário com total de casos confirmados e óbitos no ES.

Type:dict : int
nMunicipiosInfectados

O número de municípios infectados deste relatório.

Type:int
busca_casos_municipio(municipio)

Realiza pesquisa no Relatorio por casos registrados em um município.

Parâmetros:municipio (str) – O município a ser pesquisado.
Raises:RelatorioError – Se o município não for encontrado na lista de casos.
Retorna:self.casos[municipio] – O dicionário de casos registrados no município.
Tipo de retorno:
 dict
inicializa_dicionario_municipios()

Inicializa o dicionário de municípios do Relatorio.

popula_relatorio()

Preenche o Relatorio com as informações presentes em self.linhasRelatorio e retorna uma cópia do Relatorio.