CENIPA-API 0.0.7

CENIPA API

O CENIPA API é um framework que auxilia o entendimento sobre acidentes aéreos no Brasil com auxílio de sua base de dados pública. Facilitando, assim, o seu acesso e uso.

Autores | Introdução | Instruções de uso | Referência | Funções disponíveis | Código da biblioteca

Autores

Turma da graduação de Ciência de Dados e Inteligência Artificial na PUC-SP

Abdul Malik de Barros

Ana Beatriz Oliveira de Macedo

Bruna Bellini Faria

Heloisa Mariani Rodrigues

Introdução

Diante da fatalidade que ocorreu no dia 5 de novembro, que ocasionou na morte da cantora Marília Mendonça e mais 4 pessoas, nosso grupo iniciou uma pesquisa sobre acidentes aéreos, identificamos uma base de dados de ocorrências aeronáuticas, que é gerenciada pelo Centro de Investigação e Prevenção de Acidentes Aeronáuticos (CENIPA).  Constam nesta base de dados as ocorrências aeronáuticas notificadas ao CENIPA nos últimos 10 anos e que ocorreram em solo brasileiro. O relatório conta com detalhes sobre os acidentes, fatalidades, características das aeronaves, causas e fatores contribuintes, local, data, horário do evento e recomendações. A partir disso, compilamos os dados sobre as ocorrências e trouxemos algumas análises sobre o que obtemos, com gráficos, estatísticas e Dataframes. Permitindo uma ampla visualização, a compreensão mais abrangente dos fatos ocorridos e a obtenção de conclusões.

Instruções de uso

Bibliotecas necessárias

pip install pandas
pip install matplotlib
pip install re
pip install numpy

Instalando esta API

pip install CENIPA-API

Importando a API

import CENIPA-API

Utilizando a API

Chame uma das duas classes da biblioteca, recomendamos que utilizem a classe Insights, pois essa herda as funções da CENIPA_API, assim você obterá acesso a todas as funções disponíveis da biblioteca. Segue abaixo exemplos de uso:

Chamando diretamente pelo comando do import

from CENIPA-API import CENIPA_API
from CENIPA-API import Insights

tabela = Insights()
tabela.get_table

Chamando através de uma variável

tabela = CENIPA_API.Insights()
tabela.get_table

Resultado do exemplo

Funções disponíveis

Nome da função:	O que ela executa:
get_table()	Retornar e mostrar o Dataset dentro do terminal
get_acidente()	Retornar um dataset com as colunas relevantes para analise sobre os acidentes
get_fator_contribuinte()	Retornar um dataset com os fatores contribuintes para o acidente
get_aeronave()	Retornar um dataset para a analise das fatores das aeronaves
get_recomendacao()	Retornar um dataset para a analise das recomendações do casos
moda_coluna(col)	Retornar o valor mais recorrente em uma coluna escolhida do dataset
mediana_coluna(col)	Retornar a mediana de uma coluna escolhida do dataset
media_coluna(col)	Retornar a média de uma coluna escolhida do dataset
variancia_coluna(col)	Retornar a variancia de uma coluna escolhida do dataset
desvio_padrao_coluna(col)	Retornar o desvio padrão de uma coluna escolhida do dataset
gravidade_acidentes()	Gerar o número de mortes totais e alguns gráficos com insights sobre nível de dano, fatalidade e classificação da ocorrência
tipos_mortes_aeronaves()	Retornar os tipos de aeronaves e a porcentagem de ocorrencias fatais nas aeronaves listadas com ocorrências
top_fatores_contribuintes()	Retornar os top fatores contribuintes
ocorrencia_tipo()	Visualizar quais são as ocorrências mais frequentes
ocorrencia_estados(nome_UF)	Filtrar ocorrências pela sigla dos estados
ocorrencia_cidade(nome_cidade)	Filtrar ocorrências pelo nome de cidades
informacoes_acidentes()	Retornar informações sobre a gravidade e detalhes de fatalidade do acidente
ocorrencia_MesHora()	Apresentar os meses e horários que mais existem ocorrências
ocorrencia_ano(ano)	Apresentar as informações de acordo com o ano selecionado

Legenda para variáveis das funções:

• col= coluna que deseja utilizar
• nome_UF= nome da sigla do estado que deseja utilizar

Código da biblioteca

Abaixo você encontra o link do repositório com todos os códigos e dados até então coletados para a evolução do projeto e análise de dados para o desenvolvimento da página de visualização.

• https://github.com/brunabellini/CENIPA_API

Referência

• https://dados.gov.br/dataset/ocorrencias-aeronauticas-da-aviacao-civil-brasileira