This is the Brazilian Portuguese version of this documentation file. For the English version of this text click here.
Esse repositório é uma versão congelada, para acessar a versão com atualizações, clique aqui. A versão aqui contida é a mesma utilizada para realização do trabalho aparesentado no FIA 2020/2022.
Augen é uma toolbox (conjunto de ferramentas) projetada para criar uma integração direta entre as toolboxes Acoular [1] e Amiet Tools [2]. A ferramenta fornece ainda algumas funções escritas em Matlab para fornecer suporte à toolboxes como ITA-Toolbox [3] e Beamap [4].
O nome Augen é um acrônimo para "Amiet-Acoular Integration Module in Python".
O artigo que apresenta a toolbox está disponível no ResearchGate:
- Integração de múltiplas toolboxes para aplicação em beamforming e aeroacústica
Nota: Se você usa o GitHub Desktop você também terá que realizar o procedimento abaixo.
1.0 Existem dois métodos para usar a caixa de ferramentas: 1.1, que usa diretamente a instalação do Python, ou 1.2, com um ambiente Anaconda.
1.1 Instale o Python 3.8.10 e o git para proceder com o procedimento de instalação do pacote.
1.2 Crie um ambiente Anaconda para o Python 3.8.10 com conda create -n nome_ambiente python=3.8.10.
2.0 Instale todas as dependências da lista abaixo (leia [A]):
- Python == 3.8.10
- SciPy == 1.7.1
- NumPy == 1.20.3
- Amiet Tools == 0.0.2
- Acoular == 21.5
- Matplotlib == 3.7.4
- PyQt5 == 5.15.10
- h5py == 3.10.0
Aviso: Como o Amiet Tools ainda não está disponível no PyPI, tenha a certeza de executar o seguinte comando antes de instalar o Augen:
pip install git+https://github.com/fchirono/amiet_tools
2.1 Verifique com o comando pip list se todos os dependecides estão instalados com a versão correta. Não se esqueça de ler [A].
3.0. Após instalar-se todas a dependências, pode-se realizar a instalação do Augen. A instalação pode ser feita ao rodar o seguinte comando utilizando o PIP:
pip install git+https://github.com/eac-ufsm/fia2022-augen
[A] Como instalar um versão antiga de uma depedência
Para realizar a instalação de um pacote/módulo em Python utilizando o PIP basta utilizar o seguinte comando:
pip install pacote_exemplo.
Contudo o PIP irá instalar a última versão disponível. Para contornar tal caso, utiliza-se o comando abaixo a fim de especificar-se uma determinada versão:
pip install pacote_exemplo==x.x.x,
no qual x.x.x é versão a ser determinada, um exemplo seria quando x.x.x assume 1.7.1.
A pasta examples traz códigos que buscam exemplificar a utilização da toolbox, em que os códigos estão regidos com uma série de comentários em inglês.
-
A pasta tests traz uma série de códigos simples para testar diferentes classes e funções disponibilizadas pela ferramenta. Essa pasta não é uma pasta para testagens pythoanianas oficiais.
-
A Matlab detêm de algumas funções escritas em Matlab para serem utilizadas em conjunto com toolboxes como ITA-Toolbox e Beamap — voltadas para ler/salvar arquivos em formato XML, das geometrias dos arranjos de microfones.
Michael Markus Ackermann é estudante do curso de Engenharia Acústica da Universidade Federal de Santa Maria (UFSM). Augen é originalmente criado por Michael como parte de seu trabalho de conclusão de curso (TCC) e é focado em aeroacústica e imageamento acústico (acoustical beamforming) — a toolbox é uma vertente do Beamap, feito em Python.
William D'Andrea Fonseca é Professor do curso de graduação em Engenharia Acústica (orientando projetos de mestrado e graduação) na Universidade Federal de Santa Maria (UFSM). William realiza pesquisas em Engenharia Acústica, Engenharia Elétrica e Engenharia Aeroespacial. Seus projetos atuais incluem: Beamforming, Instrumentação, Processamento de Sinais e Educação em Acústica, Áudio e Vibração (mais detalhes na sua página do ResearchGate).
Ackermann, Michael Markus; Fonseca, William D'Andrea; Mareze, Paulo Henrique; Casagrande Hirono, Fábio. Integracão de múltiplas toolboxes para aplicação em beamforming e aeroacústica. Em XII Congresso Iberoamericano de Acústica (FIA 2020/22) & XXIX Encontro da Sociedade Brasileira de Acústica - SOBRAC. Florianópolis, SC, Brazil, 2022. URL: https://bit.ly/fia2022-augen.
BibTex:
@article{augen-2022,
author = {Ackermann, Michael Markus and Fonseca, William {\relax D'A}ndrea, and Mareze, Paulo Henrique and Casagrande Hirono, Fábio},
title = {Integracão de múltiplas toolboxes para aplicação em beamforming e aeroacústica},
booktitle = {XII Congresso Iberoamericano de Acústica \& XXIX Encontro da Sociedade Brasileira de Acústica - SOBRAC},
date = {2022},
address = {Florianópolis, SC, Brazil},
url = {https://bit.ly/fia2022-augen}
}[1] Sarradj, Ennes e Herold, Gert. A Python framework for microphone array data processing (Acoular - Acoustic Testing and Source Mapping Software). Applied Acoustics, 116:50–58, 2017. ISSN 0003-682X. doi: 10.1016/j.apacoust.2016.09.015. Toolbox disponível em: http://acoular.org.
[2] Casagrande Hirono, Fabio; Joseph, Phillip e Fazi, Filippo M. An Open–Source Implementation of Analytical Turbulence–Airfoil Interaction Noise Model. Em AIAA Aviation 2020 Forum, número AIAA 2020-2544, págs. 1–21. American Institute of Aeronautics and Astronautics, 2020. doi: 10.2514/6.2020-2544. Toolbox disponível em: https://github.com/fchirono/amiet_tools.
[3]Dietrich, Pascal; Guski, Martin; Pollow, Martin; Müller-Trapet, Markus; Masiero, Bruno; Scharrer, Ro man e Vorlaender, Michael. ITA-Toolbox – An Open Source Matlab Toolbox for Acousticians. Em 38th German Annual Conference on Acoustics (DAGA), número 38, págs. 151–152, Darmstadt, Germany, 2012. Disponível em: https://pub.dega-akustik.de/DAGA_2012/data/articles/000164.pdf. Toolbox disponível em: https://git.rwth-aachen.de/ita/toolbox.
[4] Fonseca, William D’Andrea; Mareze, Paulo H.; Mello, Felipe R. e Fonseca, Carlos Calixto. Teaching Acoustical Beamforming via Active Learning Approach. Em 9th Berlin Beamforming Conference (BeBeC), número BeBeC-2022-D4, Berlim, Alemanha, junho 2022. Disponível em: BeBeC 2022.