{"id":21715186,"url":"https://github.com/chicolucio/estatisticas-oiq-2019","last_synced_at":"2026-04-30T22:35:42.893Z","repository":{"id":99055078,"uuid":"218793790","full_name":"chicolucio/estatisticas-oiq-2019","owner":"chicolucio","description":"Projeto de análise estatística da Olimpíada Interna de Química de uma instituição de ensino.","archived":false,"fork":false,"pushed_at":"2019-10-31T15:09:17.000Z","size":9866,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-30T07:48:41.874Z","etag":null,"topics":["chemistry","estatistica","olimpiada","pandas","pandas-tutorial","quimica","statistics"],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chicolucio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-31T15:07:52.000Z","updated_at":"2020-02-01T14:47:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"72bb0387-d60c-4dd2-ac7e-ea4e3bb3e9e5","html_url":"https://github.com/chicolucio/estatisticas-oiq-2019","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chicolucio/estatisticas-oiq-2019","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chicolucio%2Festatisticas-oiq-2019","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chicolucio%2Festatisticas-oiq-2019/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chicolucio%2Festatisticas-oiq-2019/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chicolucio%2Festatisticas-oiq-2019/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chicolucio","download_url":"https://codeload.github.com/chicolucio/estatisticas-oiq-2019/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chicolucio%2Festatisticas-oiq-2019/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32479448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chemistry","estatistica","olimpiada","pandas","pandas-tutorial","quimica","statistics"],"created_at":"2024-11-26T00:41:35.132Z","updated_at":"2026-04-30T22:35:37.885Z","avatar_url":"https://github.com/chicolucio.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Análise estatística da OIQ 2019\n\nProjeto de análise estatística da Olimpíada Interna de Química de uma instituição\nde ensino.\n\n![oiq_images](oiq_small.png)\n\n*O nome da instituição e os dados dos alunos foram anonimizados.*\n\n## Organização\n\nHá duas pastas: inscrições e resultados. Ou seja, há uma análise dos dados de\ninscrições (inscrições por data, por curso, por nível etc) e, posteriormente,\ndos resultados das provas (alunos faltosos, perfil de notas por nível,\nrendimento relativo de cada nível etc).\n\nA linguagem de programação utilizada foi Python, com uso da biblioteca `pandas`.\nDiversas funções foram criadas para automatizar as análises. Tais funções se\nencontram nos arquivos `input_data.py`, havendo um arquivo para as inscrições e\noutro para os resultados. Também foram criadas funções para padronizar os gráficos\nda análise. Tais funções se  encontram nos arquivos `plots.py`, havendo um arquivo\n para as inscrições e outro para os resultados. Ambos os arquivos são importados\nnos Jupyter Notebooks presentes no repositório.\n\nAs pastas denominadas `dados_brutos` dentro de inscrições e de resultados possuem\nos arquivos originais que servem de partida para as análises. As únicas alterações\nfeitas nesses arquivos antes de disponibilizá-los neste repositório foram para\nanonimizar os dados (códigos aleatórios no lugar de nomes, retirada de campos de\ne-mail e telefone). O código fonte do gerador de cógidos aleatórios está [neste\nnotebook](gerador_nomes_anonimos.ipynb).\n\nUm [relatório](estatisticas_oiq_2019_github.pdf) foi gerado com a análise das\ninscrições e dos resultados. O relatório foi escrito em LaTeX de forma que se fez\nmuito uso dos métodos de exportação em formato LaTeX do `pandas` conforme visto\nnos Notebooks do repositório.\n\n## Objetivo do repositório\n\nApresentar aos demais membros da comissão como a análise é feita para facilitar\na comunicação interna da comissão e a compreensão. E, também, abrir à comunidade\ninterna e externa da instituição para que outras pessoas possam sugerir correções e\nmelhorias tanto de código quanto de interpretação dos dados. É, igualmente, uma\noportunidade de novatos em programação terem mais uma fonte de dados para treinar\no uso de `pandas` e Python em geral, servindo de incentivo aos alunos da instituição\npara iniciarem os estudos em programação.\n\n## Histórico\n\nA primeira edição da Olimpíada Interna de Química foi em 2018. Com base no aprendizado\nda primeira edição, a comissão resolveu que seria interessante fazer um acompanhamento\nestatístico das edições da olimpíada. Assim, fiquei responsável por avaliar os dados\nde inscrições e dos resultados da edição de 2018.\n\nCom o conhecimento adquirido em tal processo, resolvi automatizar o que fosse\npossível utilizando programação para que as análises dos anos posteriores fossem mais\nrápidas. Assim, utilizando a biblioteca `pandas` da linguagem Python, desenvolvi diversas funções que retornam os resultados que a comissão organizadora deseja\navaliar.\n\nCom a edição de 2019, tais funções foram otimizadas e o resultado é esse apresentado\nnesse repositório.\n\n## Organização da comissão\n\nA comissão possui um responsável pela elaboração do formulário de inscrições\n(um formulário do Google Forms) que, após as inscrições finalizarem, passa a planilha\nresultante desse formulário ao responsável pelas estatísticas. Após a correção\ndas provas pelos professores da comissão, as notas são digitadas em planilhas,\numa para cada nível que, então, são passadas ao responsável pelas estatísticas.\nObviamente, ainda há subdivisões da comissão para divulgação do evento, elaboração\ndas provas e outras atividades de suporte ao evento.\n\n## Licença\n\nO conteúdo do projeto é licenciado sob [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-nc-sa/4.0/) e o código usado para\nformatar e apresentar o conteúdo é licenciado sob [MIT license](LICENSE).\n\nThe content of this project itself is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-nc-sa/4.0/), and the underlying source code used to format and display that content is licensed under the [MIT license](LICENSE).\n\n## Autor\n\nFrancisco Lucio de S. Bustamante","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchicolucio%2Festatisticas-oiq-2019","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchicolucio%2Festatisticas-oiq-2019","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchicolucio%2Festatisticas-oiq-2019/lists"}