diff --git a/docs/user_guide_en_source/cap_superf.tex b/docs/user_guide_en_source/cap_superf.tex index f105c32..eff79ea 100644 --- a/docs/user_guide_en_source/cap_superf.tex +++ b/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 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. -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". +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. -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. +\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. -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. +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. -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. - -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. +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. \begin{figure}[!htb] \centering - \subfloat[Binário]{\label{fig:surf_binary}\includegraphics[width=0.33\textwidth]{binary.png}} + \subfloat[Binary]{\label{fig:surf_binary}\includegraphics[width=0.33\textwidth]{binary.png}} \hfill \subfloat[Context aware]{\label{fig:surf_context}\includegraphics[width=0.32\textwidth]{context.png}} \hfill - \subfloat[Padrão]{\label{fig:surfa_default}\includegraphics[width=0.332\textwidth]{default.png}} - \caption{Superfícies geradas por diferentes métodos } + \subfloat[Default]{\label{fig:surfa_default}\includegraphics[width=0.332\textwidth]{default.png}} + \caption{Surface generated by each method.} \label{fig:surf_method} \end{figure} +\section{Transparency} - -\section{Transparência} - -É possível visualizar uma superfície com transparência. Para isso, primeiro selecione a -superfície por meio da lista de seleção, dentro do item \textbf{3. Configure a superfície 3D}, opção -\textbf{Propriedades da superfície} (figure \ref{fig:select_surface}). +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}). \begin{figure}[!htb] \centering \includegraphics[scale=0.8]{surface_select_menu.png} -\caption{Seleção de superfície} +\caption{Surface selection.} \label{fig:select_surface} \end{figure} -Em seguida, para determinar o nível de transparência que a superfície selecionada receberá, arraste -o controle deslizante ilustrado na figure \ref{fig:select_transparency}. Quanto mais para a direita -o controle, maior será a transparência aplicada. +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. \begin{figure}[!htb] \centering \includegraphics[scale=0.7]{surface_transparency_pt.png} -\caption{Seleção de nível de transparência} +\caption{Selection of surface transparency.} \label{fig:select_transparency} \end{figure} -A figure \ref{fig:model_transparency} ilustra a visualização de duas superfícies: uma mais externa -(esverdeada) e outra mais interna (amarelada). A superfície mais externa aparece com a transparência -aumentada. +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). \begin{figure}[!htb] \centering \includegraphics[scale=0.3]{transparency_2} -\caption{Superfícies com nível alterado de transparência} +\caption{Surface with transparency.} \label{fig:model_transparency} \end{figure} \newpage -\section{Cor} +\section{Color} -A cor de uma superfície também pode ser alterada. Selecione a superfície (reveja a figure -\ref{fig:select_surface}) e, em seguida, clique no botão ao lado da superfície selecionada. A figure -\ref{fig:change_surface_color} ilustra o botão, também localizado no item \textbf{3. Configure a -superfície 3D}, opção \textbf{Propriedades da superfície}. +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}. \begin{figure}[!htb] \centering \includegraphics[scale=0.6]{surface_button_select_color_yellow.png} -\caption{Botão para alteração de cor} +\caption{Button to change surface color.} \label{fig:change_surface_color} \end{figure} -Uma janela de seleção de cores se abre (figure \ref{fig:button_select_color}). Selecione a cor -desejada e clique no botão \textbf{OK}. +A dialog will be shown (figure~\ref{fig:button_select_color}). Select the desired color and click on \textbf{Ok}. \begin{figure}[!htb] \centering \includegraphics[scale=0.6]{surface_select_color_windows_so_pt.png} -\caption{Opções de cor} +\caption{Color dialog.} \label{fig:button_select_color} \end{figure} -\section{Separando regiões desconexas} +\section{Splitting disconnected surfaces} -Para separar regiões da superfície que se encontram desconexas, é necessário clicar na opção -\textbf{Ferramentas avançadas}, dentro do item \textbf{3. Configure a superfície 3D}. Veja a -figure \ref{fig:advanced_tools}. +To split disconnected surfaces it's necessary to go to \textbf{3. Configure 3D surface}, \textbf{Advanced options} (figure~\ref{fig:advanced_tools}). \begin{figure}[!htb] \centering \includegraphics[scale=0.7]{surface_painel_advanced_options_pt.png} -\caption{Atalho para opções avançadas} +\caption{Advanced options.} \label{fig:advanced_tools} \end{figure} \newpage -Um menu com as opções disponíveis será exibido, como ilustra a figure -\ref{fig:advanced_tools_expanded}. +The advanced options panel will be displayed (figure~\ref{fig:advanced_tools_expanded}). \begin{figure}[!htb] \centering \includegraphics[scale=0.7]{surface_split_pt.png} -\caption{Opções avançadas} +\caption{Advanced options panel.} \label{fig:advanced_tools_expanded} \end{figure} -\subsection{Separar maior superfície} +\subsection{Select largest surface} -A opção \textbf{Separar maior superfície} seleciona, automaticamente, somente a região -desconexa que contém maior volume. Para realizar a operação, basta clicar no atalho -que a figure \ref{fig:short_connectivity_largest} ilustra. É criada uma nova superfície -resultante da operação. +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. \begin{figure}[!htb] \centering \includegraphics[scale=0.2]{connectivity_largest} -\caption{Atalho para separação da maior região desconexa} +\caption{Button to split the largest disconnected surface} \label{fig:short_connectivity_largest} \end{figure} -Como exemplo, a figure \ref{fig:extract_most_region_1} mostra um caso antes da separação -da maior região. +As an example, the figure~\ref{fig:extract_most_region_1} shows a surface before \textbf{Select largest surface}. \begin{figure}[!htb] \centering \includegraphics[scale=0.3]{surface_extract_most_region_1.jpg} -\caption{Superfícies desconexas} +\caption{Disconnected surfaces.} \label{fig:extract_most_region_1} \end{figure} -Na figure \ref{fig:extract_most_region2}, observa-se a superfície com a maior região -desconexa separada. +Whereas the figure~\ref{fig:extract_most_region2} shows the surface with largest disconnected region separated. \begin{figure}[!htb] \centering \includegraphics[scale=0.3]{surface_extract_most_region2.jpg} -\caption{Maior região separada} +\caption{Largest disconnected region separated.} \label{fig:extract_most_region2} \end{figure} \newpage -\subsection{Selecionar as regiões de interesse} +\subsection{Select regions of interest} -Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}. -Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figure -\ref{fig:short_connectivity_manual}. Em seguida, basta clicar sobre as regiões desconexas -da superfície que se pretende selecionar. +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. \begin{figure}[!htb] \centering \includegraphics[scale=0.2]{connectivity_manual} -\caption{Atalho para seleção de regiões de interesse} +\caption{Button to select the regions of interest.} \label{fig:short_connectivity_manual} \end{figure} -No exemplo da figure \ref{fig:extract_most_region3}, foram selecionados o crânio e a parte -direita do suporte do tomógrafo. +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. \begin{figure}[!htb] \centering \includegraphics[scale=0.35]{surface_extract_most_region3.jpg} -\caption{Exemplo de regiões de interesse selecionadas} +\caption{Example of selected regions of interest} \label{fig:extract_most_region3} \end{figure} -\subsection{Separar todas regiões desconexas} +\subsection{Split all disconnected surfaces} -É possível, também, separar automaticamente \textit{todas} as regiões desconexas. Para -isso, basta clicar no botão ilustrado pela figure \ref{fig:connectivity_split_all}, que -representa a opção \textbf{Separar todas regiões desconexas}. +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}. \begin{figure}[!htb] \centering \includegraphics[scale=0.2]{connectivity_split_all} -\caption{Atalho para separação de todas as regiões desconexas} +\caption{Button to split all the disconnected regions surface.} \label{fig:connectivity_split_all} \end{figure} -A figure \ref{fig:extrac_most_region_4} mostra um exemplo. +Figure~\ref{fig:extrac_most_region_4} shows an example. \begin{figure}[!htb] \centering \includegraphics[scale=0.3]{surface_extract_most_region_4.jpg} -\caption{Exemplo de separação de todas as regiões desconexas} +\caption{Example of split all disconnected regions surface.} \label{fig:extrac_most_region_4} \end{figure} diff --git a/docs/user_guide_pt_BR_source/cap_superf.tex b/docs/user_guide_pt_BR_source/cap_superf.tex index f144897..36bfe93 100644 --- a/docs/user_guide_pt_BR_source/cap_superf.tex +++ b/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 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. -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. +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á. -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. +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. \begin{figure}[!htb] \centering @@ -224,7 +224,8 @@ desconexa separada. Outra modalidade de seleção se dá pela opção \textbf{Selecionar as regiões de interesse...}. Para ativá-la, o usuário deve clicar sobre o botão ilustrado na figura \ref{fig:short_connectivity_manual}. Em seguida, basta clicar sobre as regiões desconexas -da superfície que se pretende selecionar. +da superfície que se pretende selecionar. Depois, clique novamente em \textbf{Selecionar as regiões de interesse...} +para gerar uma nova superfície com as regiões selecionadas. \begin{figure}[!htb] \centering -- libgit2 0.21.2