Wiki

Version 8 (Jan Luc Tavares, 14/10/2019 13:29)

1 1
h1. Wiki
2 1
3 7 Jan Luc Tavares
Segue todos os detalhes sobre o projeto Estação de Espectrometria, desenvolvido no CTA. 
4 7 Jan Luc Tavares
Texto ainda deve ser melhorado.
5 7 Jan Luc Tavares
6 7 Jan Luc Tavares
h1. Estação de Espectrometria
7 7 Jan Luc Tavares
8 7 Jan Luc Tavares
*Frase que defina consequências do desenvolvimento do projeto.*
9 7 Jan Luc Tavares
10 8 Jan Luc Tavares
!Modulos.jpg!
11 7 Jan Luc Tavares
12 7 Jan Luc Tavares
{{toc}}
13 7 Jan Luc Tavares
14 7 Jan Luc Tavares
h2. Descrição do Projeto
15 7 Jan Luc Tavares
16 7 Jan Luc Tavares
Nosso software foi desenvolvido para ser utilizado juntamente com o módulo N957 da CAEN, que realiza a função essencial de coletar dados e armazena-os num buffer de saída com os picos da entrada convertidos para valores discretos. Com a ajuda da biblioteca N957Lib, configuramos a placa e extraímos os dados do buffer pela porta USB. Utilizamos esses valores para criar um histograma dos níveis de energia que o módulo detecta. Esse histograma é atualizado em tempo-real, e a medição pode ser encerrada a qualquer momento, quando o histograma final e um registro são salvos. 
17 7 Jan Luc Tavares
18 7 Jan Luc Tavares
O software foi desenvolvido no ambiente de trabalho Gnome versão 3.4.2. no processador Intel® Pentium® CPU G2030 @ 3.00 Ghz x 2. A aplicação executa com boa performance nessa plataforma, portanto uma CPU semelhante ou de maior poder de computação que a nossa é recomendada. Segundo o Manual de Informações Técnicas do módulo, que pode ser encontrada na pasta 'docs' de nossa aplicação, a taxa de transferência de dados dependerá dessas capacidades da plataforma e do tamanho de bloco a ser lido, definido pela função N957_ReadData.
19 7 Jan Luc Tavares
20 7 Jan Luc Tavares
Nossa aplicação é um software livre, licenciado pela Licença Pública do GNU versão 3 (GNU GPL v3). Ela foi desenvolvida no Centro de Tecnologia Acadêmica para aplicações no Laboratório de Implantação Iônica, pertencente ao Instituto de Física da Universidade Federal do Rio Grande do Sul (UFRGS).
21 7 Jan Luc Tavares
22 7 Jan Luc Tavares
[	propósito do software
23 7 Jan Luc Tavares
	características mais importantes do software
24 7 Jan Luc Tavares
	diferencial do sistema desenvolvido
25 7 Jan Luc Tavares
	usuários-alvo
26 7 Jan Luc Tavares
	desenvolvedores]
27 7 Jan Luc Tavares
28 7 Jan Luc Tavares
----
29 7 Jan Luc Tavares
30 7 Jan Luc Tavares
h2. Principais Características
31 7 Jan Luc Tavares
32 8 Jan Luc Tavares
* Atualização dos software utilizado no Laboratório de Implantação Iônica da UFRGS;
33 8 Jan Luc Tavares
* Diminuição do hardware necessário no laboratório;
34 8 Jan Luc Tavares
* Aproveitamento mais eficiente dos experimentos.
35 7 Jan Luc Tavares
36 7 Jan Luc Tavares
----
37 7 Jan Luc Tavares
38 7 Jan Luc Tavares
h2. Histórico
39 7 Jan Luc Tavares
40 7 Jan Luc Tavares
|*Data*|*Evento*|
41 8 Jan Luc Tavares
|12/01/15|Início do desenvolvimento do software de análise de dados|
42 7 Jan Luc Tavares
43 7 Jan Luc Tavares
----
44 7 Jan Luc Tavares
45 7 Jan Luc Tavares
h2. Próximos Passos
46 7 Jan Luc Tavares
47 7 Jan Luc Tavares
----
48 7 Jan Luc Tavares
49 7 Jan Luc Tavares
h2. Documentação
50 7 Jan Luc Tavares
51 7 Jan Luc Tavares
h3. Uso
52 7 Jan Luc Tavares
53 7 Jan Luc Tavares
h4. Instruções de Instalação
54 7 Jan Luc Tavares
55 7 Jan Luc Tavares
*LabFis*
56 7 Jan Luc Tavares
57 7 Jan Luc Tavares
O LabFis é uma distribuição do GNU/Linux baseada no "Debian Wheezy":https://www.debian.org/ criado pelo Centro de Tecnologia Acadêmica. 
58 7 Jan Luc Tavares
59 7 Jan Luc Tavares
Para mais informações nosso sistema, vá para a "página do LabFis":http://cta.if.ufrgs.br/projects/labfis . Lá, você pode encontrar o sistema para download e instruções de instalação. 
60 7 Jan Luc Tavares
61 7 Jan Luc Tavares
*Mais pacotes necessários*
62 7 Jan Luc Tavares
63 7 Jan Luc Tavares
Para o software Estação de Espectrometria executar no sistema LabFis, precisamos instalar os seguintes pacotes:
64 7 Jan Luc Tavares
65 7 Jan Luc Tavares
** make
66 7 Jan Luc Tavares
** linux-headers-3.0.2.4-common
67 7 Jan Luc Tavares
** linux-headers-3.0.2.4-686-pae
68 7 Jan Luc Tavares
** linux-libc-dev
69 7 Jan Luc Tavares
70 7 Jan Luc Tavares
*Driver CAEN*
71 7 Jan Luc Tavares
72 7 Jan Luc Tavares
Na página web do módulo N957, na aba Software/Firmware, está disponível a última versão do driver USB para o seu sistema operacional. Para baixá-lo, você deverá possuir uma conta no site da CAEN. 
73 7 Jan Luc Tavares
74 7 Jan Luc Tavares
Após baixado, descompacte o arquivo. Pelo terminal, vá para a pasta criada e execute:
75 7 Jan Luc Tavares
> sudo make
76 7 Jan Luc Tavares
> sudo make install
77 7 Jan Luc Tavares
78 7 Jan Luc Tavares
*Biblioteca CAEN*
79 7 Jan Luc Tavares
80 7 Jan Luc Tavares
Na página web do módulo N957, na aba Software/Firmware, o arquivo N957 Tools está disponível. Esse pacote contém a biblioteca com as funções necessárias para configuração da placa e obtenção de dados, um programa para atualização do firmware e um programa de demonstração da utilização da biblioteca. Para baixar o pacote, você deverá possuir uma conta no site da CAEN.
81 7 Jan Luc Tavares
82 7 Jan Luc Tavares
Após baixado, descompacte o arquivo. Pelo terminal, vá para a pasta criada e execute:
83 7 Jan Luc Tavares
> cd N957Lib
84 7 Jan Luc Tavares
85 7 Jan Luc Tavares
Após, se o sistema for de 32-bits, execute:
86 7 Jan Luc Tavares
> sudo sh install
87 7 Jan Luc Tavares
88 7 Jan Luc Tavares
Se for de 64-bits, execute:
89 7 Jan Luc Tavares
> sudo sh install_64 
90 7 Jan Luc Tavares
91 7 Jan Luc Tavares
*Git*
92 7 Jan Luc Tavares
93 7 Jan Luc Tavares
Para obter o software Estação de Espectrometria, o Git deve estar instalado no computador.
94 7 Jan Luc Tavares
95 7 Jan Luc Tavares
Abaixo apresentamos alguns tutorias de utilização do Git.
96 7 Jan Luc Tavares
97 7 Jan Luc Tavares
http://www.software-carpentry.org/v5/novice/git/01-backup.html
98 7 Jan Luc Tavares
http://rogerdudler.github.io/git-guide/index.pt_BR.html
99 7 Jan Luc Tavares
100 7 Jan Luc Tavares
*Software Estação de Espectrometria*
101 7 Jan Luc Tavares
102 7 Jan Luc Tavares
Pelo terminal, vá até a pasta onde você deseja que o software esteja e execute:
103 7 Jan Luc Tavares
104 7 Jan Luc Tavares
> git clone https://gitlab.com/rafamw/estacaodeespectrometria.git
105 7 Jan Luc Tavares
106 7 Jan Luc Tavares
A pasta 'estacaodeespectrometria', com todo o código e documentação do sistema está no seu computador e o software está pronto para ser utilizado.
107 7 Jan Luc Tavares
108 7 Jan Luc Tavares
h4. Após instalação...
109 7 Jan Luc Tavares
110 7 Jan Luc Tavares
Antes de utilizar o programa é necessário definir o número de módulos que serão utilizados e o número serial deles. Para isso, deve-se alterar o arquivo "User_Config.py", comentando os módulos que não vão ser usados (inserir o caractere '#' no início da linha).
111 7 Jan Luc Tavares
112 7 Jan Luc Tavares
Para debugar o sistema, o mais simples é executar somente o programa em C. Para isso, deve-se abrir o terminal, ir até a pasta 'python' do sistema de arquivos do programa e executar
113 7 Jan Luc Tavares
114 7 Jan Luc Tavares
> ./N957Run [número_do_módulo_a_ser_debugado]
115 7 Jan Luc Tavares
116 7 Jan Luc Tavares
Para executar o programa completo, com interface, pode-se dar dois cliques no arquivo rodamodulo.sh, no ramo principal do sistema de arquivos do programa, ou, pelo terminal, ir até o ramo principal do sistema e executar
117 7 Jan Luc Tavares
118 7 Jan Luc Tavares
> ./rodamodulo.sh
119 7 Jan Luc Tavares
120 7 Jan Luc Tavares
Ao iniciar o programa, ele solicita o nome do arquivo a ser salvo com os dados do histograma e o registro. Após, ele iniciará a computação dos dados de entrada. A interface disponível ao usuário é a seguinte:
121 7 Jan Luc Tavares
122 7 Jan Luc Tavares
*imagem!*
123 7 Jan Luc Tavares
124 7 Jan Luc Tavares
A exibição dos dados pode ser alterada utilizando comandos do mouse e operações podem ser feitas sobre os dados através de botões na interface do programa e de atalhos no teclado.
125 7 Jan Luc Tavares
126 7 Jan Luc Tavares
Comandos do mouse.
127 7 Jan Luc Tavares
128 7 Jan Luc Tavares
  Botão esquerdo:
129 7 Jan Luc Tavares
    Realiza os comandos de zoom.
130 7 Jan Luc Tavares
131 7 Jan Luc Tavares
    Definir escala X: Clicar com o botão esquerdo, deslocar linearmente na direção X, soltar botão esquerdo.
132 7 Jan Luc Tavares
    Definir escala Y: Clicar com o botão esquerdo, deslocar linearmente na direção Y, soltar botão esquerdo.
133 7 Jan Luc Tavares
134 7 Jan Luc Tavares
  Botão central:
135 7 Jan Luc Tavares
    Resetar zoom: Aperte com o botão do meio do mouse.
136 7 Jan Luc Tavares
137 7 Jan Luc Tavares
  Botão direito:
138 7 Jan Luc Tavares
    Abre uma janela com as seguintes opções.
139 7 Jan Luc Tavares
140 7 Jan Luc Tavares
    Resetar o zoom: volta para as configurações padrões do zoom.
141 7 Jan Luc Tavares
    Definir cursor: (não implementado).
142 7 Jan Luc Tavares
143 7 Jan Luc Tavares
144 7 Jan Luc Tavares
Atalhos
145 7 Jan Luc Tavares
146 7 Jan Luc Tavares
  'Alt' + '1'= Parar/Retornar execução.
147 7 Jan Luc Tavares
  'Alt' + '2'= Parar/Retornar execução.
148 7 Jan Luc Tavares
  'Alt' + '3'= Clear.
149 7 Jan Luc Tavares
  'Alt' + '5'= Save.
150 7 Jan Luc Tavares
  'Alt' + '6'= Save As.
151 7 Jan Luc Tavares
152 7 Jan Luc Tavares
[	detalhar utilização das principais funcionalidades do sistema]
153 7 Jan Luc Tavares
154 7 Jan Luc Tavares
h3. Ensino
155 7 Jan Luc Tavares
156 7 Jan Luc Tavares
Oficinas e tutoriais direcionados para aplicação em grupos por instrutores.
157 7 Jan Luc Tavares
158 7 Jan Luc Tavares
h3. Desenvolvimento
159 7 Jan Luc Tavares
160 7 Jan Luc Tavares
Descrição completa do desenvolvimento e produção do projeto. Insira links para repositórios, esquemáticos, códigos-fonte, procurando inserir os arquivos editáveis originais.
161 7 Jan Luc Tavares
162 7 Jan Luc Tavares
----
163 7 Jan Luc Tavares
164 7 Jan Luc Tavares
h2. Contatos
165 7 Jan Luc Tavares
166 7 Jan Luc Tavares
Contribuidores do projeto:
167 7 Jan Luc Tavares
* Jan Luc Tavares:
168 7 Jan Luc Tavares
* Rafaela Wetternick: rmwetternick@gmail.com
169 7 Jan Luc Tavares
170 7 Jan Luc Tavares
----
171 7 Jan Luc Tavares
172 7 Jan Luc Tavares
h2. Referências
173 7 Jan Luc Tavares
174 7 Jan Luc Tavares
[1] Referência numerada de acordo com aparição no texto.
175 7 Jan Luc Tavares
[2] Flavio Depaoli, et al. 2015. Modelo de Documentação Padrão. [ONLINE] Disponível em: http://cta.if.ufrgs.br/projects/suporte-cta/wiki/Modelo_de_Documenta%C3%A7%C3%A3o_Padr%C3%A3o. [Acesso em 07 de Janeiro de 2015].
176 7 Jan Luc Tavares
177 7 Jan Luc Tavares
----
178 7 Jan Luc Tavares
179 7 Jan Luc Tavares
_Este esboço de projeto é distribuído sob uma licença Creative Commons BY-SA 4.0. Autores: Flávio Depaoli, Jan Luc Tavares, Renan Bohrer, Béuren Bechlin, Lucas Leal, Rafaela Wetternick._
180 7 Jan Luc Tavares
181 7 Jan Luc Tavares
----
182 7 Jan Luc Tavares
183 5 Jan Luc Tavares
h2. [[Documentação]]
184 5 Jan Luc Tavares
185 4 Jan Luc Tavares
h2. [[Desenvolvimento]]
186 2 Jan Luc Tavares
187 4 Jan Luc Tavares
h2. [[Medidas DVD]]