Creating a new study

To create a new study scroll to the bottom of the overview of studies and click the Create new study button

Create new study button

This will open a dialog for selecting a new name. Please, give this new study a unique name using only alphanumeric characters and underscore and click the Confirm button. Note that you can't change this name later, but you can show different "label" instead of it in some places.

Slide Score will then create the new study for you, give you the Edit right (more on rights in the Users section below) and show the study overview page:

Overview of new study

The "Overview" tab shows at-a-glance overview of the study

As you can see it's mostly empty now because the study has just been created. All the details can be configured on the tabs 1.

Note that all changes are immediately saved.

Study settings

To help with organizing your studies you can arrange them in folders or tag them with disease or organ, you can also change how Slide Score behaves for this study on the "Study Settings" page:

Study settings

Study name can't be changed once a study is created, but you can use the "Label" on the "Basics" panel 1 to display a different name with any characters you want. You can put the study in a study folder, by setting the "Folder" field. If you set it to the same value for two studies they will be shown together in that folder. That's useful if you have multiple stainings that you want to score for different things from the same project. This field will suggest existing folders to make it easier to use the same value.

The Privacy section 2 can be used to limit what will viewers and raters see. Note that in this and the following section if you change a setting from default it will be shown in bold. You can hide labels (they can contain patient, sample or study identifiers that you don't want to show) or thumbnails, hide sample identifiers from whole slide names or from TMA cores. Additionaly, you can enable unique shuffling of the slides for each rater. Score review - raters can copy other rater's score - can be disabled by unchecking the last option.

The Scoring section 3 can be used to further configure how pathologists score slides. Switch to scoring all TMA cores from the same sample at the same time instead of scoring core by core. Note that this might bias the scores. It's possible to enable comparison between rater's own answers and the majority opinion from everyone else. This can be used to give everyone a personalized feedback page - they can see whether they are biased compared to others, see this example. The last two settings can be used to further simplify Slide Score user interface, disallowing overwriting of answers and even moving backwards in a study.

Categories (or tags) 4 are labels you can attach to your study which make it easier to find. You can tag it with organ, disease or stainings. You can use multiple values if you separate them by a semicolon (;). These fields also suggest existing values - please use those suggestions and stick to the same format (it should be "CD8" not "CD-8") to make things easier to find. You can also include a tag with an identifier from an external system (e.g. biobank).

Slides

We can configure slides that belong to this study on this page. A slide can be a part of more than one study at a time.

The slide tab can look like this:

Slides

For each slide it displays:

And there is a button to add more slides to the study 3. We will use this button to add a few slides, click it now.

Add a Slide

If you are a site administrator you can see all the folders with slides on the server here 1. If you are just a study administrator - user with the Edit right - you can see all folders containing slides that you have access to and study directories of all studies you have access to. Select which slides (or folders) to add to the study by checking the check box next to their name. Selecting a folder will add all slides within that folder to the study. If a slide is already part of this study it will be ignored.

Slide Score can display slides from most microscope scanners without a conversion:

Standard image formats (JPG, PNG, TIFF and BMP) are also supported - they will get converted to a BigTIFF file for faster viewing experience and twice enlarged to make sure all details are visible. Note that these images don't have resolution information so you need to use the API to set it - don't forget to double the pixels per micron as the files get 2x rescaled.

If you click the '+' left of the folder name 2 you can see the slides inside it, with their check boxes and an "Upload files here" button 3. Click the "Upload files here" button to select slides from your computer - you can select multiple by holding Ctrl or Shift when clicking - to upload them to the server.

You can click the "Make a new folder" button 4 to create a new folder and upload some new files there. When you're done click the "Add" button 5 to include all the checked slides and folders in the study.

TMA maps

To mark a slide as TMA first check the check box on the Slides tab. This will display the TMA map name and an edit button.

TMA map edit button

This will open the overview of TMA maps that you have access to.

TMA map list

Each TMA map has a few columns:

You can also create a new map 3. When done click the Confirm button 4.

Try clicking the Create a new map from scratch button, it opens a new dialog:

New TMA map

A TMA map has an identifying name 1 and a grid of core/sample identifiers 4. To make orientation easier you can mark some cores as controls - these slides won't be scored - or mark some positions as empty. Please list the control 2 and empty 3 identifiers in the corresponding fields separated by commas (,).

The example map 4 has 3 rows, however there is a mistake - row number 2 has a different number of columns than row number 1. Slide Score points it out 5, to correct it make sure that the map is rectangular with the same number of columns in each row. Easiest way to do this is to edit it in an Excel sheet and paste it in this window.

When done click the "Add" button 6. This will add the TMA map to the list in the previous dialog so that you can select it to use it for the current slide.

Placing TMA grid

While it's possible to place TMA cores one-by-one it's a lot more efficient to use the "Edit Core Positions" panel to handle all the cores at once. Let's try it.

Open the first slide in the "TMA Demo" study and click the "Edit Core Positions" button just below the TMA map. This puts the viewer into a special mode:

Let's look at the panel in detail:

Edit Core Positions

You can read explanation and review keyboard shortcuts by clicking the question mark button - it will show a dialog that describes how to use this panel in detail.

The red "Back" button saves any pending changes, closes the panel and returns the viewer to normal mode where clicking a core selects it etc.

Undo and Redo buttons 1 can be used to revert last change.

You can use Import and Export buttons 2 to place a regular grid on the slide, import grid from another TMA or from JSON description or export a JSON description of the current grid.

The Selection sub-panel contains buttons 3 to

Clicking the checkbox "Cores are unusable" 4 will remove selected cores from scoring.

You can see what are the sample identifiers of the currently selected cores at 5.

The Manipulate cores sub-panel contains buttons 6 that switch what happens when you drag selected cores: Move, Rotate, Space (adjust spacing between them) and Magnet (twist the whole grid to simulate shifts of part of TMA). It's best to experiment with these buttons (you can always use the Undo button) and see how they work.

You will be most efficient if you learn their keyboard shortcuts (M, R, S and U respectively) or drag modifiers - if you activate the Move button and click and hold the mouse button while moving the mouse, the cores will move with your mouse. If you hold Ctrl while doing that they will rotate instead, Alt adjusts the spacing and Shift twists the whole grid like the Magnet function.

Step by step guide to placing the grid

  1. Open the Edit Core Positions panel
  2. If there are already cores placed on the grid select all (press Ctrl+A or the All button) and delete them (press the Delete button on keyboard or in the Selection subpanel)
  3. Press Import,
  4. Press Import from Map. This places a regularly spaced grid shaped like the TMA map on the slide. If you have a perfect TMA you're done, but usually the cores don't align exactly.
  5. Press All (or Ctrl+A),
  6. Move the grid so that its center is in the center of the cores on the slide,
  7. Rotate (holding ctrl while dragging) so that the grid has a similar inclination to the grid of cores on the slide,
  8. Adjust the spacing (holding ctrl while dragging) so that the cores fit. You may have adjust both horizontal and vertical spacing. If you can't get them to fit try to be off by the same distance in both extremes (i.e. in the first row and last row)
  9. Use the Magnet function (holding shift while dragging) to drag the cores in corners into place
  10. You might need to select None (press Esc) and select a group of misbehaving cores by drawing the selection rectangle around them and adjust them.

Don't forget about the Undo button!

Scoring sheet

This page is used to configure the questions that pathologists need to answer for each slide/TMA core.

This editor is accessible to everyone so that people can collaboratively design the scoring sheet.

Let's look at how it works:

Scoring Sheet Editor

The left column contains question types (free text, yes or no check box, percentage input, ...) and the central column contains actual questions on your scoring sheet. You can add a question of a particular type to your scoring sheet by clicking the '+' button 1 which creates a new question 2. You can change it by clicking the title of the question 2 or the pencil button 3, you can remove it by clicking the red '-' button. If you have multiple questions you can reorder them by dragging them in the right place, it's best to start dragging them by the empty area 4 (not the buttons or title).

If you click the button "Share" 5 a new dialog will open with a link that includes details of the scoring sheet. Send this link to anyone who needs to provide input or comments on the scoring sheet and ask them to send you their sharing link back. You can then click the "Import from URL" button 6 and paste their link into the dialog to load their questions. Note that changing the scoring sheet in that link doesn't actually change anything, they always have to share the link with you.

Clicking the title of a question 2 or pencil button 3 opens the question settings dialog:

Question Settings

Its contents depend on the question type, but all questions have a title 1. Please use a descriptive and short title use "Tumor Percentage" or "Tumor (%)" instead of "Please score Tumor percentage". Also make sure all pathologists have a clear idea what methodology to use to answer your questions.

Questions with the "No tumor", "No tissue" and "Too few cells" buttons have a yes or no checkbox whether these buttons should be shown 2. For some questions you can configure options - one option per line 3.

When you're done you can either press Enter or click Confirm 4 to close the dialog. Or press Ctrl+Enter or click Confirm and Next 5 to close this question and open the next one in your scoring sheet. It's fastest to add all questions at first, edit the first one and move through every question with Ctrl+Enter.

Question types

Text without any restrictions or checks. Best suited for remarks or comments

Yes/no check box, ideal when you need a binary answer. You can also add multiple check boxes to create a question where multiple answers can be selected.

Slides are often scored for positive staining, this question type fits this purpose.

0, 1, 2 and 3 values usually used for intensity of staining

For collecting number 0-100. White buttons with a range open a table of values within that range when clicked with numbers divisible by 5 in slightly larger font size.

Customizable list of options. Only one option can be selected. It's useful for the first option to be "Unknown" as it is the default.

Customizable set of up to 4 buttons. Only one option can be selected. Note that possibilites should be short to fit within the buttons. You don't have to include "Unknown" in this case, it gets added automatically.

H-Score (histo score) describes the percentages of cells with particular intensity of staining. It's basically four Percentage type questions grouped together. As soon as the pathologist fills in three values the fourth one is calculated to sum up to 100.

Allows pathologists to indicate a set of points (for example cells) on the slide. You can configure the color of the circle that marks the point. The results for this question are a set of coordinates in image pixels.

Users

It's important to share your slides with the right people and noone else. That is done on the Users page:

Users

You can search users 1 by (part of) their email address 2. For each user you see an indication how many slides have they completely scored and what can they do in this study - you can control that by checking the check boxes 3. Here user "test" can score slides and edit the study (i.e. they can access this screen) and user "test2" can score slides and download the results. If no box is checked the user can only view slides. Use the remove button 4 to remove all rights to this study from the user.

You can add new users to this study with the Add button 5. That opens a dialog:

Add user

You can type in part of the user's email address and accept a suggestion or type in a completely new email address.

And lastly it's possible to send an email to all users in the study directly from Slide Score 6. You can compose the email in a separate dialog:

Send Email

Here you can edit the email before sending. You can remove recipients by clicking on the cross button 1, by default all users in the study are included. You can use a better Subject 2 and improve the body of the email 3. Note that "" will be replaced by a link to the "Score!" button of this study - pathologists can click and it will take them directly to the first slide, score a couple of slides and stop. They can return to this email in a couple of days and click the link again to continue where they left off.

Confirm sending the email with the Send button 5

Editing an existing study

If a study has already been published and users are looking at it some care has to be taken to avoid disruption and loss of data.

On the other hand: