Commit 16a385955dfbc85c25dce6f0e317df8bb648e19b
Exists in
user_guide_en
Merge branch 'user_guide_en' of https://github.com/paulojamorim/invesalius3 into user_guide_en
Showing
2 changed files
with
45 additions
and
72 deletions
Show diff stats
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 | ... | ... |