a b/docs/Output files.rst
1
.. _Output_page:
2
3
*******************
4
Output from QuArray
5
*******************
6
7
Tissue core threshold output
8
============================
9
10
.. note::
11
   The outputs of the tissue core export process are as follows. They are all saved into the same location in the
12
   whole slide image export file.
13
14
1. Whole core images - indexed with coordinates in the file name
15
----------------------------------------------------------------
16
17
Image of the selection panel
18
----------------------------
19
20
This will be created when overlay cores is pressed.
21
22
.. Image:: images/wsi_001_split_overlay.tiff
23
24
2. Figure containing images of all tissue cores in an array
25
-----------------------------------------------------------
26
27
An example of such a figure is given below. A bounding box appears (e.g. green or red) if a pathology/condition map is
28
included in (see :ref:`input files<Input_page>`), otherwise bounding boxes are omitted.
29
30
.. Image:: images/wsi_001_split_layoutfig.tiff
31
32
3. Image metadata in JSON format
33
--------------------------------
34
35
The following fields are included.
36
37
:path: path of the whole slide image
38
:coordinates: list of tuple coordinates in the whole slide image
39
:cores: list of strings to denote core names
40
:diameter: int for the number of pixels in the image
41
:scale_index: float to show the scale index between low and high WSI levels
42
:lowlevel: int to show the level that the low magnification file was taken from
43
:arrayshape: tuple of the shape of the tissue array in col row format
44
45
46
Chromogen measurement output
47
============================
48
49
The output of the chromogen (e.g. DAB) measurement window is a single excel file (.xlsx) which contains measurements of
50
multiple parameters from each tissue core in the input folder.
51
52
The data is organised in a single row for the measurements for tissue each core image.
53
54
The column titles and data description appear as follows:
55
56
57
:CoreName: The file name of the analysed tissue image
58
:AMTsignal: the total number of pixels that contain 'signal' in the image\, Also termed coverage
59
:Mean_intensity: The mean average of the pixel values in the threshold image
60
:Standard_Dev_intensity: The standard deviation of the pixel values in the threshold image
61
:AMTtissue: The total amount of tissue in the image \(calculation provided in the :ref:`measurements page<Measurements_page>`
62
:AFperAMTT: The AMTsignal divided by the amount of tissue
63
:Mean_Intensity_perAMTT: The Mean_intensity divided by the amount of tissue
64
:SD_Intensity_perAMTT: The Standard_Dev_intensity divided by the amount of tissue
65
66
Output file structure
67
=====================
68
69
Below is an example of what the file structure could look like for an end to end project after running image export and
70
chromogen analysis.
71
72
.. code-block:: bash
73
74
   .
75
   ├── wsi_001.ndpi
76
   ├── wsi_001.xlsx
77
   └── wsi_001_split
78
       ├── CoreAnalysis_WSI_001.xlsx
79
       ├── wsi_001_split_A1.png
80
       ├── wsi_001_split_B1.png
81
       ├── wsi_001_split_C1.png
82
       ├── wsi_001_split_D1.png
83
       ├── wsi_001_split_layoutfig.tiff
84
       ├── wsi_001_split_metadata.json
85
       └── wsi_001_split_overlay.tiff
86