|
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 |
|