Commit a66aab1ced883825731ffd55e5a618b74d39aa20

Authored by Thiago Franco de Moraes
1 parent cd284781
Exists in user_guide_en

Translated the surface chapter and solved some errors surface chapter pt_br

docs/user_guide_en_source/cap_superf.tex
@@ -58,195 +58,167 @@ Whereas the figure~\ref{fig:surface_ex2} displays the surface create without act @@ -58,195 +58,167 @@ Whereas the figure~\ref{fig:surface_ex2} displays the surface create without act
58 58
59 The item \textbf{Surface creation method} has the following options:\textbf{Binary}, \textbf{Context aware smoothing} and \textbf{Default}. Figure~\ref{fig:surf_method} shows an example of surface created using each of these 3 methods. 59 The item \textbf{Surface creation method} has the following options:\textbf{Binary}, \textbf{Context aware smoothing} and \textbf{Default}. Figure~\ref{fig:surf_method} shows an example of surface created using each of these 3 methods.
60 60
61 -O método \textbf{binário}, tem como partida a máscara que foi segmentada, sendo a região selecionada como 1 e o restante 0. Como existem somente 2 valores, as curvas na superfície que o algoritmo gera são abruptas ou popularmente conhecida como "degraus". 61 +The \textbf{Binary} method takes as input the segmentation mask which is binary, where selected regions have value 1 and non-selected have value 0. As it is binary, the surface generated has a blocky aspect, mainly in high curvature areas, appearing staircases.
62 62
63 -The \textbf{Binary} method takes as input the segmentation mask which is binary, where selected regions have value 1 and non-selected have value 0. As it is binary, the surface generated has a blocky aspect, mainly in high curvature areas. 63 +\textbf{Context aware smoothing} starts generating the surface using binary method. After that it uses the algorithm \textbf{Context aware smoothing} to smooth the surface to avoid the staircase artifacts. This method has 4 parameters presented bellow.
64 64
65 -No método \textbf{Context aware smoothing}, inicialmente a superfície é gerada a partir do método binário, mas em seguida é executado o algoritmo "Context aware smoothing" para suavizar a superfície resultante e evitar os "degraus" na mesma. Neste passo é requerido 4 valores, que serão apresentados a seguir. 65 +The \textbf{angle} parameter is the angle between 2 adjacent triangles. If the calculated angle is \textbf{greater than} the angle parameter the triangle will be considered a staircase triangle and will be smoothed. The angle parameter ranges from $0$ to $1$. Where $0$ is $0^\circ$ and $1$ is $90^\circ$. The \textbf{Max distance} is the maximum distance that a non-staircase triangle has to be from a staircase triangle to be considered to be smoothed. Non-staircase triangles with distance greater than \textbf{Max distance} also will be smoothed but the smoothing will be weighted by the \textbf{Min. weight} parameter. This parameter ranges from $0$ (without smoothing) to $1$ (total smoothing). The last parameter, \textbf{N. steps}, is the number of times the smoothing algorithm will be run. The greater this parameter the smoother the surface will be.
66 66
67 -O \textbf{ângulo}, nesse caso será formado entre 2 normais de triângulos adjacentes, que \textbf{caso esteja acima do valor} definido no campo ângulo, o triângulo é elegido para ser o ponto de partida da suavização, a faixa de valor é de 0 até 1, sendo $0^\circ$ e $90^\circ$ respectivamente. A \textbf{distância máxima} é o raio a partir dos triângulos elegidos no passo anterior, que será utilizada como limite de suavização. O \textbf{peso mínimo} é o quanto de suavização será aplicado nas áreas que estão fora do raio determinado anteriormente. O \textbf{número de passos} é quantas vezes o algoritmo vai executar.  
68 -  
69 -O método \textbf{padrão} é ativo \textbf{somente quando não existir edição manual na máscara}, os pixeis da imagem original que estão sob a máscara é utilizado para a geração de superfície, como normalmente imagens de tomografia ou ressonância possui vários níveis de cinza, é gerada uma superfície com curvas mais suaves. 67 +The \textbf{Default} method is enable only when \textbf{it was used thresholding segmentation and there is not a manual edition in the mask}. This method doesn't use the mask image, but the exam image, and generates a smoother surface.
70 68
71 \begin{figure}[!htb] 69 \begin{figure}[!htb]
72 \centering 70 \centering
73 - \subfloat[Binário]{\label{fig:surf_binary}\includegraphics[width=0.33\textwidth]{binary.png}} 71 + \subfloat[Binary]{\label{fig:surf_binary}\includegraphics[width=0.33\textwidth]{binary.png}}
74 \hfill 72 \hfill
75 \subfloat[Context aware]{\label{fig:surf_context}\includegraphics[width=0.32\textwidth]{context.png}} 73 \subfloat[Context aware]{\label{fig:surf_context}\includegraphics[width=0.32\textwidth]{context.png}}
76 \hfill 74 \hfill
77 - \subfloat[Padrão]{\label{fig:surfa_default}\includegraphics[width=0.332\textwidth]{default.png}}  
78 - \caption{Superfícies geradas por diferentes métodos } 75 + \subfloat[Default]{\label{fig:surfa_default}\includegraphics[width=0.332\textwidth]{default.png}}
  76 + \caption{Surface generated by each method.}
79 \label{fig:surf_method} 77 \label{fig:surf_method}
80 \end{figure} 78 \end{figure}
81 79
  80 +\section{Transparency}
82 81
83 -  
84 -\section{Transparência}  
85 -  
86 -É possível visualizar uma superfície com transparência. Para isso, primeiro selecione a  
87 -superfície por meio da lista de seleção, dentro do item \textbf{3. Configure a superfície 3D}, opção  
88 -\textbf{Propriedades da superfície} (figure \ref{fig:select_surface}). 82 +It's also possible to display a surface with some level of Transparency. To do that, first select the desired surface from the list of surfaces, in the item \textbf{3. Configure 3D surface}, \textbf{Surface properties} (figure \ref{fig:select_surface}).
89 83
90 \begin{figure}[!htb] 84 \begin{figure}[!htb]
91 \centering 85 \centering
92 \includegraphics[scale=0.8]{surface_select_menu.png} 86 \includegraphics[scale=0.8]{surface_select_menu.png}
93 -\caption{Seleção de superfície} 87 +\caption{Surface selection.}
94 \label{fig:select_surface} 88 \label{fig:select_surface}
95 \end{figure} 89 \end{figure}
96 90
97 -Em seguida, para determinar o nível de transparência que a superfície selecionada receberá, arraste  
98 -o controle deslizante ilustrado na figure \ref{fig:select_transparency}. Quanto mais para a direita  
99 -o controle, maior será a transparência aplicada. 91 +Then, to set the level of surface transparency, use de sliding control shown in the figure~\ref{fig:select_transparency}. The more to right the more transparent the surface will be shown.
100 92
101 \begin{figure}[!htb] 93 \begin{figure}[!htb]
102 \centering 94 \centering
103 \includegraphics[scale=0.7]{surface_transparency_pt.png} 95 \includegraphics[scale=0.7]{surface_transparency_pt.png}
104 -\caption{Seleção de nível de transparência} 96 +\caption{Selection of surface transparency.}
105 \label{fig:select_transparency} 97 \label{fig:select_transparency}
106 \end{figure} 98 \end{figure}
107 99
108 -A figure \ref{fig:model_transparency} ilustra a visualização de duas superfícies: uma mais externa  
109 -(esverdeada) e outra mais interna (amarelada). A superfície mais externa aparece com a transparência  
110 -aumentada. 100 +Figure~\ref{fig:model_transparency} shows 2 surfaces: the extern surface (green color) has some level of transparency which permits to see the intern surface (yellow color).
111 101
112 \begin{figure}[!htb] 102 \begin{figure}[!htb]
113 \centering 103 \centering
114 \includegraphics[scale=0.3]{transparency_2} 104 \includegraphics[scale=0.3]{transparency_2}
115 -\caption{Superfícies com nível alterado de transparência} 105 +\caption{Surface with transparency.}
116 \label{fig:model_transparency} 106 \label{fig:model_transparency}
117 \end{figure} 107 \end{figure}
118 108
119 \newpage 109 \newpage
120 110
121 -\section{Cor} 111 +\section{Color}
122 112
123 -A cor de uma superfície também pode ser alterada. Selecione a superfície (reveja a figure  
124 -\ref{fig:select_surface}) e, em seguida, clique no botão ao lado da superfície selecionada. A figure  
125 -\ref{fig:change_surface_color} ilustra o botão, também localizado no item \textbf{3. Configure a  
126 -superfície 3D}, opção \textbf{Propriedades da superfície}. 113 +It's possible to change a surface color. Select the surface (see figure~\ref{fig:select_surface}). Click on the colored button on the right to the surface selection list. Figure~\ref{fig:change_surface_color} displays this button, inside the item \textbf{3. Configure 3D surface}, \textbf{Surface properties}.
127 114
128 \begin{figure}[!htb] 115 \begin{figure}[!htb]
129 \centering 116 \centering
130 \includegraphics[scale=0.6]{surface_button_select_color_yellow.png} 117 \includegraphics[scale=0.6]{surface_button_select_color_yellow.png}
131 -\caption{Botão para alteração de cor} 118 +\caption{Button to change surface color.}
132 \label{fig:change_surface_color} 119 \label{fig:change_surface_color}
133 \end{figure} 120 \end{figure}
134 121
135 -Uma janela de seleção de cores se abre (figure \ref{fig:button_select_color}). Selecione a cor  
136 -desejada e clique no botão \textbf{OK}. 122 +A dialog will be shown (figure~\ref{fig:button_select_color}). Select the desired color and click on \textbf{Ok}.
137 123
138 \begin{figure}[!htb] 124 \begin{figure}[!htb]
139 \centering 125 \centering
140 \includegraphics[scale=0.6]{surface_select_color_windows_so_pt.png} 126 \includegraphics[scale=0.6]{surface_select_color_windows_so_pt.png}
141 -\caption{Opções de cor} 127 +\caption{Color dialog.}
142 \label{fig:button_select_color} 128 \label{fig:button_select_color}
143 \end{figure} 129 \end{figure}
144 130
145 -\section{Separando regiões desconexas} 131 +\section{Splitting disconnected surfaces}
146 132
147 -Para separar regiões da superfície que se encontram desconexas, é necessário clicar na opção  
148 -\textbf{Ferramentas avançadas}, dentro do item \textbf{3. Configure a superfície 3D}. Veja a  
149 -figure \ref{fig:advanced_tools}. 133 +To split disconnected surfaces it's necessary to go to \textbf{3. Configure 3D surface}, \textbf{Advanced options} (figure~\ref{fig:advanced_tools}).
150 134
151 \begin{figure}[!htb] 135 \begin{figure}[!htb]
152 \centering 136 \centering
153 \includegraphics[scale=0.7]{surface_painel_advanced_options_pt.png} 137 \includegraphics[scale=0.7]{surface_painel_advanced_options_pt.png}
154 -\caption{Atalho para opções avançadas} 138 +\caption{Advanced options.}
155 \label{fig:advanced_tools} 139 \label{fig:advanced_tools}
156 \end{figure} 140 \end{figure}
157 141
158 \newpage 142 \newpage
159 143
160 -Um menu com as opções disponíveis será exibido, como ilustra a figure  
161 -\ref{fig:advanced_tools_expanded}. 144 +The advanced options panel will be displayed (figure~\ref{fig:advanced_tools_expanded}).
162 145
163 \begin{figure}[!htb] 146 \begin{figure}[!htb]
164 \centering 147 \centering
165 \includegraphics[scale=0.7]{surface_split_pt.png} 148 \includegraphics[scale=0.7]{surface_split_pt.png}
166 -\caption{Opções avançadas} 149 +\caption{Advanced options panel.}
167 \label{fig:advanced_tools_expanded} 150 \label{fig:advanced_tools_expanded}
168 \end{figure} 151 \end{figure}
169 152
170 -\subsection{Separar maior superfície} 153 +\subsection{Select largest surface}
171 154
172 -A opção \textbf{Separar maior superfície} seleciona, automaticamente, somente a região  
173 -desconexa que contém maior volume. Para realizar a operação, basta clicar no atalho  
174 -que a figure \ref{fig:short_connectivity_largest} ilustra. É criada uma nova superfície  
175 -resultante da operação. 155 +The option \textbf{Select largest surface} selects, automatically, only surface with the greater volume. To do this operation click on the button illustrated in the figure~\ref{fig:short_connectivity_largest}. This operation creates new surface with only the largest surface.
176 156
177 \begin{figure}[!htb] 157 \begin{figure}[!htb]
178 \centering 158 \centering
179 \includegraphics[scale=0.2]{connectivity_largest} 159 \includegraphics[scale=0.2]{connectivity_largest}
180 -\caption{Atalho para separação da maior região desconexa} 160 +\caption{Button to split the largest disconnected surface}
181 \label{fig:short_connectivity_largest} 161 \label{fig:short_connectivity_largest}
182 \end{figure} 162 \end{figure}
183 163
184 -Como exemplo, a figure \ref{fig:extract_most_region_1} mostra um caso antes da separação  
185 -da maior região. 164 +As an example, the figure~\ref{fig:extract_most_region_1} shows a surface before \textbf{Select largest surface}.
186 165
187 \begin{figure}[!htb] 166 \begin{figure}[!htb]
188 \centering 167 \centering
189 \includegraphics[scale=0.3]{surface_extract_most_region_1.jpg} 168 \includegraphics[scale=0.3]{surface_extract_most_region_1.jpg}
190 -\caption{Superfícies desconexas} 169 +\caption{Disconnected surfaces.}
191 \label{fig:extract_most_region_1} 170 \label{fig:extract_most_region_1}
192 \end{figure} 171 \end{figure}
193 172
194 -Na figure \ref{fig:extract_most_region2}, observa-se a superfície com a maior região  
195 -desconexa separada. 173 +Whereas the figure~\ref{fig:extract_most_region2} shows the surface with largest disconnected region separated.
196 174
197 \begin{figure}[!htb] 175 \begin{figure}[!htb]
198 \centering 176 \centering
199 \includegraphics[scale=0.3]{surface_extract_most_region2.jpg} 177 \includegraphics[scale=0.3]{surface_extract_most_region2.jpg}
200 -\caption{Maior região separada} 178 +\caption{Largest disconnected region separated.}
201 \label{fig:extract_most_region2} 179 \label{fig:extract_most_region2}
202 \end{figure} 180 \end{figure}
203 181
204 \newpage 182 \newpage
205 183
206 -\subsection{Selecionar as regiões de interesse} 184 +\subsection{Select regions of interest}
207 185
208 -Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}.  
209 -Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figure  
210 -\ref{fig:short_connectivity_manual}. Em seguida, basta clicar sobre as regiões desconexas  
211 -da superfície que se pretende selecionar. 186 +Other selection option is \textbf{Select regions of interest ...}. To do this operation click on the button illustrated on the figure~\ref{fig:short_connectivity_manual}. Then click on desired disconnected surface regions you want to select. Next click on \textbf{Select regions of interest ...}. This operation will create new surface with only the selected disconnected regions.
212 187
213 \begin{figure}[!htb] 188 \begin{figure}[!htb]
214 \centering 189 \centering
215 \includegraphics[scale=0.2]{connectivity_manual} 190 \includegraphics[scale=0.2]{connectivity_manual}
216 -\caption{Atalho para seleção de regiões de interesse} 191 +\caption{Button to select the regions of interest.}
217 \label{fig:short_connectivity_manual} 192 \label{fig:short_connectivity_manual}
218 \end{figure} 193 \end{figure}
219 194
220 -No exemplo da figure \ref{fig:extract_most_region3}, foram selecionados o crânio e a parte  
221 -direita do suporte do tomógrafo. 195 +As an example, the figure~\ref{fig:extract_most_region3} shows the surface created after the user selects the cranium and the right part of the tomograph support.
222 196
223 \begin{figure}[!htb] 197 \begin{figure}[!htb]
224 \centering 198 \centering
225 \includegraphics[scale=0.35]{surface_extract_most_region3.jpg} 199 \includegraphics[scale=0.35]{surface_extract_most_region3.jpg}
226 -\caption{Exemplo de regiões de interesse selecionadas} 200 +\caption{Example of selected regions of interest}
227 \label{fig:extract_most_region3} 201 \label{fig:extract_most_region3}
228 \end{figure} 202 \end{figure}
229 203
230 204
231 -\subsection{Separar todas regiões desconexas} 205 +\subsection{Split all disconnected surfaces}
232 206
233 -É possível, também, separar automaticamente \textit{todas} as regiões desconexas. Para  
234 -isso, basta clicar no botão ilustrado pela figure \ref{fig:connectivity_split_all}, que  
235 -representa a opção \textbf{Separar todas regiões desconexas}. 207 +It's also possible to split all the disconnected surface regions automatically. To do this, click on the button illustrated in the figure~\ref{fig:connectivity_split_all}.
236 208
237 \begin{figure}[!htb] 209 \begin{figure}[!htb]
238 \centering 210 \centering
239 \includegraphics[scale=0.2]{connectivity_split_all} 211 \includegraphics[scale=0.2]{connectivity_split_all}
240 -\caption{Atalho para separação de todas as regiões desconexas} 212 +\caption{Button to split all the disconnected regions surface.}
241 \label{fig:connectivity_split_all} 213 \label{fig:connectivity_split_all}
242 \end{figure} 214 \end{figure}
243 215
244 -A figure \ref{fig:extrac_most_region_4} mostra um exemplo. 216 +Figure~\ref{fig:extrac_most_region_4} shows an example.
245 217
246 \begin{figure}[!htb] 218 \begin{figure}[!htb]
247 \centering 219 \centering
248 \includegraphics[scale=0.3]{surface_extract_most_region_4.jpg} 220 \includegraphics[scale=0.3]{surface_extract_most_region_4.jpg}
249 -\caption{Exemplo de separação de todas as regiões desconexas} 221 +\caption{Example of split all disconnected regions surface.}
250 \label{fig:extrac_most_region_4} 222 \label{fig:extrac_most_region_4}
251 \end{figure} 223 \end{figure}
252 224
docs/user_guide_pt_BR_source/cap_superf.tex
@@ -80,9 +80,9 @@ O método \textbf{binário}, tem como partida a máscara que foi segmentada, sen @@ -80,9 +80,9 @@ O método \textbf{binário}, tem como partida a máscara que foi segmentada, sen
80 80
81 No método \textbf{Context aware smoothing}, inicialmente a superfície é gerada a partir do método binário, mas em seguida é executado o algoritmo "Context aware smoothing" para suavizar a superfície resultante e evitar os "degraus" na mesma. Neste passo é requerido 4 valores, que serão apresentados a seguir. 81 No método \textbf{Context aware smoothing}, inicialmente a superfície é gerada a partir do método binário, mas em seguida é executado o algoritmo "Context aware smoothing" para suavizar a superfície resultante e evitar os "degraus" na mesma. Neste passo é requerido 4 valores, que serão apresentados a seguir.
82 82
83 -O \textbf{ângulo}, nesse caso será formado entre 2 normais de triângulos adjacentes, que \textbf{caso esteja acima do valor} definido no campo ângulo, o triângulo é elegido para ser o ponto de partida da suavização, a faixa de valor é de 0 até 1, sendo $0^\circ$ e $90^\circ$ respectivamente. A \textbf{distância máxima} é o raio a partir dos triângulos elegidos no passo anterior, que será utilizada como limite de suavização. O \textbf{peso mínimo} é o quanto de suavização será aplicado nas áreas que estão fora do raio determinado anteriormente. O \textbf{número de passos} é quantas vezes o algoritmo vai executar. 83 +O \textbf{ângulo}, nesse caso será formado entre 2 normais de triângulos adjacentes, que \textbf{caso esteja acima do valor} definido no campo ângulo, o triângulo é elegido para ser o ponto de partida da suavização, a faixa de valor é de 0 até 1, sendo $0^\circ$ e $90^\circ$ respectivamente. A \textbf{distância máxima} é o raio a partir dos triângulos elegidos no passo anterior, que será utilizada como limite de suavização. O \textbf{peso mínimo} é o quanto de suavização será aplicado nas áreas que estão fora do raio determinado anteriormente. Esse parâmetro varia de $0$ (sem suavização) à $1$ (suavização total). O \textbf{número de passos} é quantas vezes o algoritmo vai executar. Quantos maior o número de passos, mais suave a superfície será.
84 84
85 -O método \textbf{padrão} é ativo \textbf{somente quando não existir edição manual na máscara}, os pixeis da imagem original que estão sob a máscara é utilizado para a geração de superfície, como normalmente imagens de tomografia ou ressonância possui vários níveis de cinza, é gerada uma superfície com curvas mais suaves. 85 +O método \textbf{padrão} é ativo \textbf{somente quando usado a segmentação por limiar e não existir edição manual na máscara}, os pixeis da imagem original que estão sob a máscara é utilizado para a geração de superfície, como normalmente imagens de tomografia ou ressonância possui vários níveis de cinza, é gerada uma superfície com curvas mais suaves.
86 86
87 \begin{figure}[!htb] 87 \begin{figure}[!htb]
88 \centering 88 \centering
@@ -224,7 +224,8 @@ desconexa separada. @@ -224,7 +224,8 @@ desconexa separada.
224 Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}. 224 Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}.
225 Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figura 225 Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figura
226 \ref{fig:short_connectivity_manual}. Em seguida, basta clicar sobre as regiões desconexas 226 \ref{fig:short_connectivity_manual}. Em seguida, basta clicar sobre as regiões desconexas
227 -da superfície que se pretende selecionar. 227 +da superfície que se pretende selecionar. Depois, clique novamente em \textbf{Selecionar as regiões de interesse...}
  228 +para gerar uma nova superfície com as regiões selecionadas.
228 229
229 \begin{figure}[!htb] 230 \begin{figure}[!htb]
230 \centering 231 \centering