cyto-studio

A napari viewer which reads multiplex images.

Installation Windows

Start -> Anaconda3 (64-bit) -> Anaconda Prompt (Anaconda3)

Type:

>conda create -n py39 python=3.9

>conda activate py39

>pip install cyto-studio --upgrade

or:

>mkenv cyto-studio --python /soft/conda/envs/napari/bin/python

>workon cyto-studio

>pip install cyto-studio --upgrade

Installation Linux

Applications -> Terminal Emulator

Type:

>pip install cyto-studio --upgrade

University Server / Darkroom Setup

If the shared environment already exists, create the launch button with:

>source /opt/conda/etc/profile.d/conda.sh
>conda activate /storage/scratch.space/envs/cyto-studio-env
>python -m cyto_studio --create-launcher

Create the shared conda environment:

>source /opt/conda/etc/profile.d/conda.sh
>conda create -y -p /storage/scratch.space/envs/cyto-studio-env python=3.11
>conda activate /storage/scratch.space/envs/cyto-studio-env
>conda install -y -c conda-forge xcb-util-cursor
>PIP_REQUIRE_VIRTUALENV=false python -m pip install cyto-studio --upgrade

If installing from a local checkout instead:

>cd /path/to/cyto-studio
>PIP_REQUIRE_VIRTUALENV=false python -m pip install -e .

Create or refresh the desktop launcher:

>python -m cyto_studio --create-launcher

The launcher activates /storage/scratch.space/envs/cyto-studio-env and starts Cyto Studio with the Qt/PySide6 environment isolated from the host system. It also checks for the Qt/XCB runtime package needed by PySide6 and installs it if it is missing.

Create the launcher

Type:

>python -m cyto_studio --create-launcher

How to run

The cyto-studio viewer can be run from command line by typing:

>cyto-studio

How to use

1. If working within the IMAXT Windows VMware or Linux remote desktop, the Data folder containing the STPT images will have been automatically selected. If not, please select the location of the folders with STPT Zarr files using the "Set folder" button.
2. The dropdown box should now have all the available STPT images.
3. Select the image file from the dropdown box.

2D rendering (slice view)

4. Select the slice you wish to view using the scroll bar.
5. Press the "Load slice" button to load the image.
6. When zooming using the mouse wheel the resolution will update dynamically.

3D rendering

4. The "Output pixel size" is the resolution to which the images are reformatted (after applying the translations based on the bead locations).
5. The "Maximum number of optical slices" can be set in case the optical slices go beyond the slice thickness of 15um. For example, if we have 9 optical slices of 2um we should use only 7 slices.
6. Select which channels to load.
7. Press "Load image 3D".
8. To crop the volume draw a shape using the add rectangles button of napari. To do this select the "New shapes layer" button and then "Add rectangles" button. Draw a box across the image according to the region you wish to crop.
9. Pressing "Crop to shape" will just crop the colume to this region.
10. Pressing "Reload in shape" will reload the slices. In this case you can set a different output pixel size. To get the full resolution use a value of 0.5, although a value of 1 or 2 will in most cases suffice. Be aware that due to the limited memory the region will have to be rather small if the resolution increases.
11. Press "Save volume" to save the multi-channel volume to a tiff file.
12. Press the "Toggle number of display dimensions" button at the botton left (or press Ctrl-Y) to see the volume in 3D.

Bead removal

Removing the beads requires a "Tissue threshold value" to be set which separates the tissue from background. Move the mouse over the image to get an idea of the values, which are shown in the status bar. There are two ways to remove the beads in a volume:

1. Press button "Show only large regions" to remove all but the largest regions. The number of regions to retain can be selected for this.
2. Press button "Remove small regions" to remove all the regions smaller than the size as defined by the "Minimum size".