6. Customised reports explained

Quantifier generates several reports, including CustomRegion reports. These contain quantifications for broader regions. The broad regions are compilations of reference atlas regions and may either be user-defined (“Custom”) or the default regions included in the Nutil software (“Default”).


The QCAlign software has a viewer for exploring the reference atlas hierarchy, and can be used to create a custom region file (hierarchy sheet in TXT format) that is compatible with Nutil.

6.1. CustomRegion reports

  1. The simplest option is to run the analysis with the “default” regions that are in-built in the Nutil software. Select “default”.

More information on the default regions are found in the CustomRegion files in the Nutil software package, located in the CustomRegion folder. The “default” option is a complete brain analysis, which means it includes all the reference atlas regions compiled into broader regions. For example, for the Allen Mouse Brain Atlas v3,2017, the custom regions are; the cortex; fiber tracts; hippocampus; olfactory regions; hypothalamus; regions in the striatum and pallidum; midbrain - hindbrain - and medulla; thalamus; cerebellum; and ventricular system.

  1. Alternatively, generate CustomRegion reports based on your own compilations of reference atlas regions. Select “custom” and navigate to the relevant CSV or XLSX file.

There are two options for generating this file:

  • Use the QCAlign software (hierarchy sheet in CSV format).

  • Defined your own regions using the CustomRegionsTemplate.xlsx provided in the CustomRegion folder of the Nutil package. Fill in the template exactly as shown below:


ROW 1: assign your own names to the regions (For example, cortex. This is for your information only).

ROW 2: assign colours to the regions. Do this by typing a RGB colour code in the following format: 255;0;0 (for red). This colour will be assigned to the objects located in the custom region for the purposes of the image output and coordinate output (for display purposes only).

ROW 3: enter the colour name (this is for your information only).

ROW 4: define the region by listing the reference atlas IDs that you wish to include. The excel sheets in the AtlasHierarchy folder list all the regions and IDs for each atlas.

For mouse, see the ABAHier2015.xlsx or ABAHier2017.xlsx file for the full list of regions and IDs.

For rat, see the WHS_rat_atlas_v2.xlsx or WHS_rat_atlas_v3.xlsx file for the full list of regions and IDs.

The default .xlsx may be used as a guide for filling out the template.