Wiki source code of 3. Image registration to reference atlas using QuickNII and VisuAlign

Last modified by puchades on 2022/02/18 13:55

version	line-number	content
4.2	1	== [[image:BICCN_QNII_figure.png]] ==
1.1	2
29.1	3	(% class="wikigeneratedid" id="H-1" %)
32.2	4	(% class="small" %)Section image registration using //QuickNII//
14.1	5
29.1	6
	7
32.2	8	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	9
32.2	10	1. //QuickNII //guides you through an interactive affine alignment, including propagation of alignment settings across the section series.
	11	1. //VisuAlign //allows you to fine-tune your alignment by using non-linear adjustments.
14.1	12
32.2	13	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	14
13.1	15	== (% style="color:#c0392b" %)Preparation of the image series(%%) ==
1.1	16
32.2	17	Before you get started with image registration, make sure your images have the right size, and files are named according to the //QUINT //naming convention. See [[2. Image pre-processing with Nutil Transform>>doc:Collabs.quint.1\. Preparing the images.WebHome]] for details.
3.1	18
18.4	19	=== (% style="color:#c0392b" %)Generate your image descriptor file with FileBuilder(%%) ===
3.1	20
32.2	21	(% 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 resised images.
1.1	22
14.1	23	== (% style="color:#c0392b" %)Open //QuickNII// and load your images(%%) ==
1.1	24
36.1	25	(% 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	26
40.1	27	A detailed //QuickNII// online user manual is found here: [[https:~~/~~/quicknii.readthedocs.io>>url:https://quicknii.readthedocs.io]]
5.4	28
11.1	29	== (% style="color:#c0392b" %)Anchoring procedure(%%) ==
7.2	30
19.1	31	(% class="box infomessage" %)
	32	(((
32.2	33	The alignment procedure consists of two main tasks.
21.2	34
32.2	35	1. Determine the dorsoventral and mediolateral cutting angle of the section series and apply the same angles for all slices.
21.2	36	1. Adjust the atlas slices generated along these angles to match individual sections.
19.1	37	)))
	38
32.2	39	=== (% style="color:#c0392b" %)A. Determine the cutting angles(%%) ===
5.6	40
32.2	41	1. Open an image in the beginning of the series and use anatomical landmarks to find the approximate anteroposterior position of the section in the atlas. Select the atlas modality to be overlaid on the image (MRI, Atlas, etc.).
21.4	42	1. Tilt the atlas by adjusting the dorsoventral and mediolateral angles. Move the transparency slider back and forth to see how well the atlas fits the section. The size of the atlas slice can also be modified for a better fit.
21.3	43	1. Once you have a fairly good match, save the alignment settings for this section and move on with the anchoring procedure. The settings can be fine-tuned later.
32.2	44	1. Open another image, located at the other end of the series, and repeat the same procedure as above:, that is, find the approximate anteroposterior position of the section and test how well the cutting angles fit this section. Save your settings.
	45	1. Explore a few sections throughout the series to find the angles that fit most sections in order to achieve a good global anchoring. We recommend to keep the cutting angles consistent throughout the entire section series (i.e., ML = +1, DV = -4), unless two blocks were cut separately.
	46	1. Once two or more sections are anchored at their approximate position within the brain, //QuickNII //propagates the cutting angles across the entire image series. The anteroposterior position of the images is also estimated on the basis of the section numbering.
5.4	47
32.2	48	=== (% style="color:#c0392b" %)B. Fine-tune your alignment(%%) ===
5.4	49
32.2	50	Review the position of all sections in the series, adjust the width and height of the atlas slices as necessary, and save the settings.
5.4	51
32.2	52	Done! Now you can export customised atlas maps corresponding to your series by clicking on the “Export Slices” button. The exported .flat files are used for the quantification performed by using //Nutil //Quantifier.
5.4	53
32.2	54	== (% style="color:#c0392b" %)Non-linear adjustment with //VisuAlign//(%%) ==
8.2	55
9.2	56	[[image:VisuAlign_illustration.png]]
	57
41.1	58	A detailed //VisuAlign //user manual: [[https:~~/~~/visualign.readthedocs.io/en/latest/>>https://visualign.readthedocs.io/en/latest/]].
8.2	59
32.2	60	The basic steps are as follows.
8.4	61
32.2	62	1. Export your anchoring results from //QuickNII //in JSON format (click “Save JSON” in the Manage Data window). Save the file in the same folder as your image series.
	63	1. Open //VisuAlign //by double-clicking on “VisuAlign.bat” and load your image descriptor JSON (File -> Open).
	64	1. Add markers for adjusting the non-linear alignment. Drag a marker to move the atlas borders around it. Start with the borders of the section and then adjust internal landmarks to fine-tune the alignment between the section and the atlas. Keep the number of markers to a minimum.
	65	1. You can toggle “Outline mode” by pulling the opacity slider to the far right. A colour picker on the right side of the slider becomes active to change the outline colour.
	66	1. Enabling “Debug mode” from the View menu toggles the display of triangles representing the deformation field and allows you to change the colour of the triangles.
22.2	67	1. Finally, use File -> Save As to save your fine-tuned alignment as a new JSON file.
34.1	68	1. There is also an “Export” function for generating .flat files for //Nutil//.
31.2	69
	70	== (% style="color:#c0392b" %)Examples of use(%%) ==
	71
38.1	72	(% style="color:#c0392b" %)Visit the [[(% style="color:#c0392b" %)//QuickNII //and //VisuAlign //collab>>https://wiki.ebrains.eu/bin/view/Collabs/quicknii-and-visualign]](%%)(%%).
31.2	73
	74
	75

Wiki source code of 3. Image registration to reference atlas using QuickNII and VisuAlign

QUINT: Workflow for Quantification and Spatial Analysis of Features in Histological Images From Rodent Brain