Diferencia entre revisiones de «Creador atlas»
(Se marcó esta sección para su traducción) |
|||
| (No se muestran 15 ediciones intermedias del mismo usuario) | |||
| Línea 3: | Línea 3: | ||
<translate> | <translate> | ||
| − | == | + | ==Inicio== <!--T:1--> |
| − | |||
La herramienta de generación de atlas se encuentra alojada en https://mt4sd.ulpgc.es/atlas/, junto con los atlas creados por el GTMA (<xr id="fig:01" />). | La herramienta de generación de atlas se encuentra alojada en https://mt4sd.ulpgc.es/atlas/, junto con los atlas creados por el GTMA (<xr id="fig:01" />). | ||
| + | <!--T:2--> | ||
<figure id="fig:01"> | <figure id="fig:01"> | ||
[[File:Genatlas-01.png|none|thumb|<caption>Welcome screen</caption>]] | [[File:Genatlas-01.png|none|thumb|<caption>Welcome screen</caption>]] | ||
</figure> | </figure> | ||
| + | <!--T:3--> | ||
En la esquina superior derecha está el botón etiquetado '''Atlas manager''', que da acceso a la herramienta. | En la esquina superior derecha está el botón etiquetado '''Atlas manager''', que da acceso a la herramienta. | ||
| + | <!--T:4--> | ||
<span style="color:#ff0000">'''ATENCION''' Actualmente la herramienta sólo está disponible en inglés</span> | <span style="color:#ff0000">'''ATENCION''' Actualmente la herramienta sólo está disponible en inglés</span> | ||
| − | ===Acceso=== | + | ===Acceso=== <!--T:5--> |
Antes de acceder, es necesario introducir el nombre de usuario (el email) y la contraseña (<xr id="fig:02" />). | Antes de acceder, es necesario introducir el nombre de usuario (el email) y la contraseña (<xr id="fig:02" />). | ||
| + | <!--T:6--> | ||
<figure id="fig:02"> | <figure id="fig:02"> | ||
[[File:Genatlas-02.png|none|thumb|<caption>Entrance screen</caption>]] | [[File:Genatlas-02.png|none|thumb|<caption>Entrance screen</caption>]] | ||
</figure> | </figure> | ||
| − | ===Pantalla inicial=== | + | ===Pantalla inicial=== <!--T:7--> |
| + | <!--T:8--> | ||
Una vez dentro, la herramienta nos muestra los atlas creados por nuestro usuario, con su nivel de progreso, estado y si se ha marcado como disponible al público o sigue siendo privado (<xr id="fig:03" />): | Una vez dentro, la herramienta nos muestra los atlas creados por nuestro usuario, con su nivel de progreso, estado y si se ha marcado como disponible al público o sigue siendo privado (<xr id="fig:03" />): | ||
| + | <!--T:9--> | ||
<figure id="fig:03"> | <figure id="fig:03"> | ||
[[File:Genatlas-03.png|none|thumb|<caption>Main panel</caption>]] | [[File:Genatlas-03.png|none|thumb|<caption>Main panel</caption>]] | ||
</figure> | </figure> | ||
| + | <!--T:10--> | ||
| + | Podemos crear un nuevo atlas, utilizando el botón '''NEW ATLAS''' de la parte izquierda o seleccionar uno de los existentes haciendo click sobre su nombre. | ||
| + | |||
| + | ==Trabajando con un atlas== <!--T:11--> | ||
| + | |||
| + | <!--T:12--> | ||
| + | El flujo de trabajo de la herramienta está diseñado para ir avanzando consecutivamente por los diferentes pasos, no permitiéndose la vuelta atrás en algunos de ellos. Es por eso que resulta muy importante tener claro lo que se está haciendo en cada uno de los pasos, ya que el atlas se va generando de forma progresiva, estando cada paso basado en el anterior. | ||
| + | |||
| + | ===1.Color Table=== <!--T:13--> | ||
| + | La base del atlas es la ColorTable generada en el 3DSlicer cuando se hace la segmentación (<xr id="fig:04" />). Es este fichero el que hay que subir a la plataforma, usando el botón '''UPLOAD Color Table'''. Si ya se ha subido el fichero, aparece listado y hay que seleccionarlo haciendo click sobre su nombre. | ||
| + | |||
| + | <!--T:14--> | ||
| + | En <xr id="fig:05" /> aparece listado el contenido del fichero Color Table: el nombre de los segmentos y el color que tienen asignados. Si esta información es correcta se puede proceder al siguiente paso, haciendo click sobre el botón de la esquina superior derecha '''IMPORT INFORMATION'''. Esta acción valida los nombres de todos los segmentos listados, para poder empezar a construir el atlas con ellos, y nos lleva automáticamente al siguiente paso. | ||
| + | |||
| + | <!--T:15--> | ||
| + | <gallery> | ||
| + | File:Genatlas-04.png|none|thumb|<caption><figure id="fig:04">Figure 4: Select/Upload Color Table</figure></caption> | ||
| + | File:Genatlas-05.png|none|thumb|<caption><figure id="fig:05">Figure 5: Content of the colortable</figure></caption> | ||
| + | </gallery> | ||
| + | |||
| + | ===2.Elements=== <!--T:16--> | ||
| + | En este paso se pueden editar, eliminar o añadir segmentos al atlas (<xr id="fig:06" />). | ||
| + | |||
| + | <!--T:17--> | ||
| + | Es necesario eliminar el elemento con la id 0 (ver <xr id="fig:06" />), que no tiene ni nombre ni fichero asociado, esto se hace haciendo click sobre su icono de la papelera. Para modificar un segmento, basta con hacer click en su icono del lápiz (<xr id="fig:07" />); para cambiar el nombre hay que rellenar el campo del formulario con el nombre correcto y para cambiar el color, haciendo click sobre el recuadro coloreado se abre una ventana emergente con un selector de color. Si fuera necesario añadir un segmento que no haya venido incluido en la colortable, está el botón en la parte superior derecha con el texto '''ADD ELEMENT MANUALLY'''; los campos del formulario a rellenar son similares a los del caso de la edición. | ||
| + | |||
| + | <!--T:18--> | ||
| + | Una vez revisados los segmentos, se continúa al siguiente paso con el botón '''PROCEED TO STRUCTURE''' | ||
| + | |||
| + | <!--T:19--> | ||
| + | <gallery> | ||
| + | File:Genatlas-06.png|none|thumb|<caption><figure id="fig:06">Figure 6: Elements screen</figure></caption> | ||
| + | File:Genatlas-07.png|none|thumb|<caption><figure id="fig:07">Figure 7: Editing a segment</figure></caption> | ||
| + | </gallery> | ||
| + | |||
| + | ===3.Hierarchy=== <!--T:20--> | ||
| + | En este paso es necesario organizar jerárquicamente los segmentos, clasificándolos en grupos (<xr id="fig:08" />). No es posible tener elementos que no pertenezcan a ningún grupo dentro del atlas; de hecho los elementos que queden ''sueltos'' no serán incluidos en el atlas. Otra norma a tener en cuenta es que tiene que haber, al final, un único grupo que lo contenga todo. La estructura de grupos se construye desde los elementos individuales, los segmentos; grupos que pueden contener otros grupos y/o segmentos; hasta un grupo final. El proceso es similar a construir un árbol desde las puntas de las ramas hasta llegar al tronco principal. Se accede a la creación de grupos con el botón '''ADD GROUP''', situado en la esquina superior derecha. | ||
| + | |||
| + | <!--T:21--> | ||
| + | A la hora de crear un grupo, se le da un nombre en el formulario, y se marcan las casillas de los elementos que van a ser sus hijos (tomando el grupo que se está creando como padre y los elementos, tanto grupos como segmentos, como sus hijos). Para localizar los elementos a añadir, se puede utilizar la casilla de búsqueda, marcada con el nombre '''Children element''' o navegar directamente por el listado (<xr id="fig:09" />). Una vez seleccionados los elementos, notar que los grupos tienen su nombre escrito con negrita, para así diferenciarlos de los segmentos, hacer click en el botón '''CREATE''', que nos devuelve a la pantalla con el listado de elementos (<xr id="fig:10" />). | ||
| + | |||
| + | <!--T:22--> | ||
| + | Con el botón '''VIEW TREE''' se puede consultar en una nueva ventana la estructura jerárquica (<xr id="fig:11" />) que se ha construido hasta el momento. | ||
| + | |||
| + | <!--T:23--> | ||
| + | Una vez organizados todos los elementos que van a formar parte del atlas, hacer click en el botón '''CONTINUE''' para ir al siguiente paso. | ||
| + | |||
| + | <!--T:24--> | ||
| + | <gallery> | ||
| + | File:Genatlas-08.png|none|thumb|<caption><figure id="fig:08">Figure 8: Hierarchy overview</figure></caption> | ||
| + | File:Genatlas-09.png|none|thumb|<caption><figure id="fig:09">Figure 9: Group creation</figure></caption> | ||
| + | File:Genatlas-10.png|none|thumb|<caption><figure id="fig:10">Figure 10: Grouped elements</figure></caption> | ||
| + | File:Genatlas-11.png|none|thumb|<caption><figure id="fig:11">Figure 11: Tree view</figure></caption> | ||
| + | </gallery> | ||
| + | |||
| + | ===4.Files=== <!--T:25--> | ||
| + | En este paso se suben al servidor los ficheros que componen el atlas: la herramienta va solicitando los ficheros necesarios y no permite continuar al siguiente paso si le falta alguno de los ficheros necesarios. (<xr id="fig:12" /> | ||
| + | |||
| + | <!--T:26--> | ||
| + | Hay que aportar los ficheros .vtk generados durante la segmentación. Estos son los ficheros que contienen, de forma individual, la representación tridimensional de cada una de las estructuras segmentadas en 3D Slicer. Aparecen listados en la parte baja de la pantalla; si están marcados en verde significa que su fichero se ha subido ya de forma correcta, si aparecen en amarillo es que falta el fichero .vtk y si aparecen en rojo es que hay una discrepancia entre el nombre del fichero aportado y el segmento al que debería estar asociado. MUY IMPORTANTE: el nombre del fichero ha de coincidir con el del segmento, todo en minúsculas y sin espacios (los espacios han de ser sustituidos por un guión bajo _). | ||
| + | |||
| + | <!--T:27--> | ||
| + | Hay que subir también un fichero para el labelmap (formato nrrd), y otro para el background (formato nrrd) de la escena. | ||
| + | |||
| + | <!--T:28--> | ||
| + | Una vez subidos todos los ficheros, la aplicación permite pasar al siguiente paso, que es el montaje, mediante el botón '''Proceed to ASSEMBLY''' | ||
| + | |||
| + | <!--T:29--> | ||
| + | <gallery> | ||
| + | File:Genatlas-12.png|none|thumb|<caption><figure id="fig:12">Figure 12: Uploading files</figure></caption> | ||
| + | </gallery> | ||
| + | |||
| + | ===5.Assembly=== <!--T:30--> | ||
| + | En este paso podemos elegir si deseamos alojar el atlas generado en el servidor o si preferimos descargar los ficheros, generando para ello un archivo comprimido con toda la información. | ||
| + | |||
| + | <!--T:31--> | ||
| + | También aquí se puede escoger si deseamos que el atlas sea público o se mantenga privado (que sólo nosotros podamos consultarlo). | ||
| + | |||
| + | <!--T:32--> | ||
<hr> | <hr> | ||
[[Clínicos 3D Slicer| MENU]] | [[Clínicos 3D Slicer| MENU]] | ||
</translate> | </translate> | ||
Revisión actual del 15:51 10 ene 2019
Inicio
La herramienta de generación de atlas se encuentra alojada en https://mt4sd.ulpgc.es/atlas/, junto con los atlas creados por el GTMA (Figure 1).
En la esquina superior derecha está el botón etiquetado Atlas manager, que da acceso a la herramienta.
ATENCION Actualmente la herramienta sólo está disponible en inglés
Acceso
Antes de acceder, es necesario introducir el nombre de usuario (el email) y la contraseña (Figure 2).
Pantalla inicial
Una vez dentro, la herramienta nos muestra los atlas creados por nuestro usuario, con su nivel de progreso, estado y si se ha marcado como disponible al público o sigue siendo privado (Figure 3):
Podemos crear un nuevo atlas, utilizando el botón NEW ATLAS de la parte izquierda o seleccionar uno de los existentes haciendo click sobre su nombre.
Trabajando con un atlas
El flujo de trabajo de la herramienta está diseñado para ir avanzando consecutivamente por los diferentes pasos, no permitiéndose la vuelta atrás en algunos de ellos. Es por eso que resulta muy importante tener claro lo que se está haciendo en cada uno de los pasos, ya que el atlas se va generando de forma progresiva, estando cada paso basado en el anterior.
1.Color Table
La base del atlas es la ColorTable generada en el 3DSlicer cuando se hace la segmentación (Figure 4). Es este fichero el que hay que subir a la plataforma, usando el botón UPLOAD Color Table. Si ya se ha subido el fichero, aparece listado y hay que seleccionarlo haciendo click sobre su nombre.
En Figure 5 aparece listado el contenido del fichero Color Table: el nombre de los segmentos y el color que tienen asignados. Si esta información es correcta se puede proceder al siguiente paso, haciendo click sobre el botón de la esquina superior derecha IMPORT INFORMATION. Esta acción valida los nombres de todos los segmentos listados, para poder empezar a construir el atlas con ellos, y nos lleva automáticamente al siguiente paso.
2.Elements
En este paso se pueden editar, eliminar o añadir segmentos al atlas (Figure 6).
Es necesario eliminar el elemento con la id 0 (ver Figure 6), que no tiene ni nombre ni fichero asociado, esto se hace haciendo click sobre su icono de la papelera. Para modificar un segmento, basta con hacer click en su icono del lápiz (Figure 7); para cambiar el nombre hay que rellenar el campo del formulario con el nombre correcto y para cambiar el color, haciendo click sobre el recuadro coloreado se abre una ventana emergente con un selector de color. Si fuera necesario añadir un segmento que no haya venido incluido en la colortable, está el botón en la parte superior derecha con el texto ADD ELEMENT MANUALLY; los campos del formulario a rellenar son similares a los del caso de la edición.
Una vez revisados los segmentos, se continúa al siguiente paso con el botón PROCEED TO STRUCTURE
3.Hierarchy
En este paso es necesario organizar jerárquicamente los segmentos, clasificándolos en grupos (Figure 8). No es posible tener elementos que no pertenezcan a ningún grupo dentro del atlas; de hecho los elementos que queden sueltos no serán incluidos en el atlas. Otra norma a tener en cuenta es que tiene que haber, al final, un único grupo que lo contenga todo. La estructura de grupos se construye desde los elementos individuales, los segmentos; grupos que pueden contener otros grupos y/o segmentos; hasta un grupo final. El proceso es similar a construir un árbol desde las puntas de las ramas hasta llegar al tronco principal. Se accede a la creación de grupos con el botón ADD GROUP, situado en la esquina superior derecha.
A la hora de crear un grupo, se le da un nombre en el formulario, y se marcan las casillas de los elementos que van a ser sus hijos (tomando el grupo que se está creando como padre y los elementos, tanto grupos como segmentos, como sus hijos). Para localizar los elementos a añadir, se puede utilizar la casilla de búsqueda, marcada con el nombre Children element o navegar directamente por el listado (Figure 9). Una vez seleccionados los elementos, notar que los grupos tienen su nombre escrito con negrita, para así diferenciarlos de los segmentos, hacer click en el botón CREATE, que nos devuelve a la pantalla con el listado de elementos (Figure 10).
Con el botón VIEW TREE se puede consultar en una nueva ventana la estructura jerárquica (Figure 11) que se ha construido hasta el momento.
Una vez organizados todos los elementos que van a formar parte del atlas, hacer click en el botón CONTINUE para ir al siguiente paso.
4.Files
En este paso se suben al servidor los ficheros que componen el atlas: la herramienta va solicitando los ficheros necesarios y no permite continuar al siguiente paso si le falta alguno de los ficheros necesarios. (Figure 12
Hay que aportar los ficheros .vtk generados durante la segmentación. Estos son los ficheros que contienen, de forma individual, la representación tridimensional de cada una de las estructuras segmentadas en 3D Slicer. Aparecen listados en la parte baja de la pantalla; si están marcados en verde significa que su fichero se ha subido ya de forma correcta, si aparecen en amarillo es que falta el fichero .vtk y si aparecen en rojo es que hay una discrepancia entre el nombre del fichero aportado y el segmento al que debería estar asociado. MUY IMPORTANTE: el nombre del fichero ha de coincidir con el del segmento, todo en minúsculas y sin espacios (los espacios han de ser sustituidos por un guión bajo _).
Hay que subir también un fichero para el labelmap (formato nrrd), y otro para el background (formato nrrd) de la escena.
Una vez subidos todos los ficheros, la aplicación permite pasar al siguiente paso, que es el montaje, mediante el botón Proceed to ASSEMBLY
5.Assembly
En este paso podemos elegir si deseamos alojar el atlas generado en el servidor o si preferimos descargar los ficheros, generando para ello un archivo comprimido con toda la información.
También aquí se puede escoger si deseamos que el atlas sea público o se mantenga privado (que sólo nosotros podamos consultarlo).