Commit 16a385955dfbc85c25dce6f0e317df8bb648e19b

Authored by Paulo Henrique Junqueira Amorim
2 parents 437a5ebf a66aab1c
Exists in user_guide_en

Merge branch 'user_guide_en' of https://github.com/paulojamorim/invesalius3 into user_guide_en

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 58  
59 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 69 \begin{figure}[!htb]
72 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 72 \hfill
75 73 \subfloat[Context aware]{\label{fig:surf_context}\includegraphics[width=0.32\textwidth]{context.png}}
76 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 77 \label{fig:surf_method}
80 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 84 \begin{figure}[!htb]
91 85 \centering
92 86 \includegraphics[scale=0.8]{surface_select_menu.png}
93   -\caption{Seleção de superfície}
  87 +\caption{Surface selection.}
94 88 \label{fig:select_surface}
95 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 93 \begin{figure}[!htb]
102 94 \centering
103 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 97 \label{fig:select_transparency}
106 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 102 \begin{figure}[!htb]
113 103 \centering
114 104 \includegraphics[scale=0.3]{transparency_2}
115   -\caption{Superfícies com nível alterado de transparência}
  105 +\caption{Surface with transparency.}
116 106 \label{fig:model_transparency}
117 107 \end{figure}
118 108  
119 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 115 \begin{figure}[!htb]
129 116 \centering
130 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 119 \label{fig:change_surface_color}
133 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 124 \begin{figure}[!htb]
139 125 \centering
140 126 \includegraphics[scale=0.6]{surface_select_color_windows_so_pt.png}
141   -\caption{Opções de cor}
  127 +\caption{Color dialog.}
142 128 \label{fig:button_select_color}
143 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 135 \begin{figure}[!htb]
152 136 \centering
153 137 \includegraphics[scale=0.7]{surface_painel_advanced_options_pt.png}
154   -\caption{Atalho para opções avançadas}
  138 +\caption{Advanced options.}
155 139 \label{fig:advanced_tools}
156 140 \end{figure}
157 141  
158 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 146 \begin{figure}[!htb]
164 147 \centering
165 148 \includegraphics[scale=0.7]{surface_split_pt.png}
166   -\caption{Opções avançadas}
  149 +\caption{Advanced options panel.}
167 150 \label{fig:advanced_tools_expanded}
168 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 157 \begin{figure}[!htb]
178 158 \centering
179 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 161 \label{fig:short_connectivity_largest}
182 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 166 \begin{figure}[!htb]
188 167 \centering
189 168 \includegraphics[scale=0.3]{surface_extract_most_region_1.jpg}
190   -\caption{Superfícies desconexas}
  169 +\caption{Disconnected surfaces.}
191 170 \label{fig:extract_most_region_1}
192 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 175 \begin{figure}[!htb]
198 176 \centering
199 177 \includegraphics[scale=0.3]{surface_extract_most_region2.jpg}
200   -\caption{Maior região separada}
  178 +\caption{Largest disconnected region separated.}
201 179 \label{fig:extract_most_region2}
202 180 \end{figure}
203 181  
204 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 188 \begin{figure}[!htb]
214 189 \centering
215 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 192 \label{fig:short_connectivity_manual}
218 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 197 \begin{figure}[!htb]
224 198 \centering
225 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 201 \label{fig:extract_most_region3}
228 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 209 \begin{figure}[!htb]
238 210 \centering
239 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 213 \label{fig:connectivity_split_all}
242 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 218 \begin{figure}[!htb]
247 219 \centering
248 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 222 \label{fig:extrac_most_region_4}
251 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 80  
81 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 87 \begin{figure}[!htb]
88 88 \centering
... ... @@ -224,7 +224,8 @@ desconexa separada.
224 224 Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}.
225 225 Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figura
226 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 230 \begin{figure}[!htb]
230 231 \centering
... ...