Define your cases

After you have uploaded the images for your reader study, you need to arrange them into cases. You can do this by going to the cases menu item in the side bar and clicking View / Delete Cases:

Here, you get an overview of all the cases that are part of your reader study. By default, each image is added to its own case. You can view details for a case by clicking on it. Use the Edit button to change the values for each of the interfaces that have been added to your case, or to delete the entire case. Images can be used in more than one case. The order field is used to determine the order in which your cases are presented to your readers. This field is automatically populated, but can be changed. Use the View Display Set button to open the reader study at a particular case.

💡Note that if the View Display Set button is used in a reader study that has Allow case navigation disabled, the viewer will only allow answering a case if that case is the first unanswered case. Otherwise it will show the case in a read-only view. Normal functionality will resume once the Continue button is clicked.

💡Once a case has been answered by any participant you cannot edit the case anymore. You can make the case editable again by removing all answers (Users progress → Remove Answers).

After you have defined all your cases, you may be left with a number of 'ghost cases', as you may have combined images in a case, making some of the ones that were created on upload obsolete. You can delete any case you no longer have use for, as long as there are no answers for that case.

Default answers¶

If you have defined an interface in any of the questions of the reader study, this interface will be shown in each display set. This allows you to set the default answer to that question. If the question has answer type Mask, you first need to upload the masks, before you can select the specific mask. For example, the display set below contains one image, the other values are default answers for a number of questions:

Define your layout¶

When your cases are set up, you can define the layout for your reader study. For an extensive description of the various layout options see this section.

You only need to define a layout if you have more than a single image per display set. If you only have a single image (optionally with an overlay), you can leave the view content and hanging protocol empty, and the viewer will use sensible defaults to show your image.

If you have several images, you will need to at least define the view content. This will ensure each image will be loaded in a separate view. You can leave the hanging protocol empty if you would like side views for 3D images, or a minimap overview for multi-resolution images. The viewer will then show all your images at the same size. If you want full control over how images are shown (for example one large view and three smaller views below the main view), you will need to define a hanging protocol. See existing protocols.

Case text¶

If you would like to display some information specific to an image you can configure Case text. Use the image name as key, for example:

{
  "image1.mhd": "Explanatory text for image 1",
  "image2.mhd": "Explanatory text for image 2"
}

The case text for the viewed images will be displayed in the viewer: