Wiki source code of 3. Image registration to reference atlas using QuickNII and VisuAlign
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
4.2 | 1 | == [[image:BICCN_QNII_figure.png]] == |
| |
1.1 | 2 | |
| |
18.2 | 3 | == == |
| |
14.1 | 4 | |
| |
18.2 | 5 | The QUINT workflow allows you to register series of histological section images from the brain to a 3D reference atlas such as the Allen Mouse Brain Atlas or the Waxholm Space atlas of the rat brain. This is a two-step process: |
| |
14.1 | 6 | |
| |
18.2 | 7 | 1. QuickNII guides you through an interactive affine alignment, including propagation of alignment settings across the section series. |
| 8 | 1. VisuAlign lets you fine-tune your alignment using non-linear adjustments. | ||
| |
14.1 | 9 | |
| |
18.2 | 10 | Further steps of the QUINT workflow are compatible with the atlas map output of both QuickNII and VisuAlign (the VisuAlign step is optional). |
| |
14.1 | 11 | |
| |
13.1 | 12 | == (% style="color:#c0392b" %)Preparation of the image series(%%) == |
| |
1.1 | 13 | |
| |
20.2 | 14 | Before you get started with image registration, make sure your images are the right size, and files are named according to the QUINT naming convention. See 2. Image pre-processing with Nutil Transform for details. |
| |
3.1 | 15 | |
| |
18.4 | 16 | === (% style="color:#c0392b" %)Generate your image descriptor file with FileBuilder(%%) === |
| |
3.1 | 17 | |
| |
18.4 | 18 | (% style="color:#4e5f70" %)Use the small program “FileBuilder.bat” provided with //QuickNII//. A new window will open, and ask for the folder where your images are located. Point to the correct folder, mark all image files, and click OK. **An XML file is generated**. **Always save this file in the same folder as the resized images.** |
| |
1.1 | 19 | |
| |
14.1 | 20 | == (% style="color:#c0392b" %)Open //QuickNII// and load your images(%%) == |
| |
1.1 | 21 | |
| |
14.1 | 22 | (% style="color:#4e5f70" %)Open the //QuickNII// program from the .exe file. Once the program opens, click the **Manage data button** and load your XML file. |
| |
1.1 | 23 | |
| |
14.1 | 24 | A detailed //QuickNII// user manual as well as a demo dataset can be found on [[https:~~/~~/www.nitrc.org/projects/quicknii/>>https://www.nitrc.org/projects/quicknii/]] |
| |
5.4 | 25 | |
| |
11.1 | 26 | == (% style="color:#c0392b" %)**Anchoring procedure**(%%) == |
| |
7.2 | 27 | |
| |
19.1 | 28 | (% class="box infomessage" %) |
| 29 | ((( | ||
| 30 | (% style="color:#27ae60" %)The idea is to determine the cutting angles (dorso-ventral and medio-lateral) for the whole series as these should be consistent throughout. Once found in a few sections, apply the same angles to the rest of the series. | ||
| 31 | ))) | ||
| 32 | |||
| |
5.6 | 33 | **The basic steps are:** |
| 34 | |||
| |
14.1 | 35 | (% style="color:#000000" %)-(%%)Open one image in the beginning of the series and use anatomical landmarks to find the approximate anteroposterior position of the section. Select the atlas modality to be overlayed on the image (MRI, Atlas, etc..) |
| |
5.4 | 36 | |
| |
15.1 | 37 | -Use the** transparency slider** continuously to determine how well the atlas fits the section. Determine the sectioning angles (dorso-ventral and medio-lateral) by tilting the atlas and adjust the atlas borders. |
| |
5.4 | 38 | |
| |
14.1 | 39 | -Save the positions for this section for now, they can be adjust later. |
| |
5.4 | 40 | |
| |
14.1 | 41 | -Open another image, located at the other end of the series, and repeat the same procedure as above, i.e. find the approximate anteroposterior position of the section and test how well the cutting angles fit this section. Save the positions. |
| |
5.4 | 42 | |
| |
14.1 | 43 | -Explore a few sections in order to find the angles that fit most sections in order to achieve a global anchoring. |
| |
5.6 | 44 | |
| |
14.1 | 45 | -By having the same cutting angles set for two sections (i.e. ML=+1; DV= -4), //QuickNII// will apply them to all the sections located between them. The antero-posterior positions of all the images are also estimated based on the numbering. |
| |
5.7 | 46 | |
| |
14.1 | 47 | -Review the atlas to section match for all the sections, adjusting the atlas borders as necessary, and save. |
| |
8.2 | 48 | |
| |
14.1 | 49 | -Export customised atlas maps corresponding to your series by clicking on the **“export Slices”** button. The exported .flat files are used for the quantification by //Nutil Quantifier//. |
| |
9.3 | 50 | |
| |
11.1 | 51 | == (% style="color:#c0392b" %)**Nonlinear adjustment with VisuAlign**(%%) == |
| |
8.2 | 52 | |
| |
9.2 | 53 | **[[image:VisuAlign_illustration.png]]** |
| 54 | |||
| |
17.1 | 55 | A detailed //VisuAlign //user manual can be found on [[https:~~/~~/www.nitrc.org/docman/?group_id=1426>>https://www.nitrc.org/docman/?group_id=1426]] |
| |
8.2 | 56 | |
| |
8.4 | 57 | **The basic steps are:** |
| 58 | |||
| |
17.1 | 59 | -Use the same folder as //QuickNII// with your png images and series descriptor (XML file). You will need the JSON version of the descriptor (it is generated by //QuickNII// by clicking “Save JSON”). |
| |
8.2 | 60 | |
| |
17.1 | 61 | -Open tool by clicking on “VisuAlign.bat” file. It loads and saves JSON files created by //QuickNII//. |
| |
8.4 | 62 | |
| 63 | -Add markers and drag them to move the atlas borders. Start with the borders of the tissue and then adjust internal landmarks. | ||
| 64 | |||
| 65 | NB: keep the number of markers to a minimum. | ||
| 66 | |||
| |
17.1 | 67 | -The outline mode is toggled by pulling the opacity slider to the far right (as seen in the screenshot). A color picker to the right of it becomes active for changing outline colour. |
| |
8.4 | 68 | |
| |
17.1 | 69 | -“Debug mode” displays triangles representing the deformation field, it is enabled from the View menu (and also enables a colour picker for changing the colour of the triangles). |
| |
8.4 | 70 | |
| 71 | - Use the “Save As” to save your deformations as a new JSON file. |