PMA.studio 2.1.0

PMA.studio is a cockpit environment for everything digital pathology. PMA.vue is a viewer. Like many other widely used software applications today, both PMA.studio and PMA.vue adopt a common user interface and layout:

• A slide (file) explorer on the left, showing all available slides and folders available to a properly authenticated and authorized end-user
• A viewport (slide viewer) on the right, showing the content of the slide(s) you have opened

PMA.studio and PMA.vue come with a simple and intuitive layout that maximizes the space provided for the viewer while leaving ample room to browse and access the full context of your folders and other associated data like annotations and forms.

The Ribbon is a panel that sticks to the top of the screen and consists of tabs and controls.

It is the strip of buttons and icons located above the work (viewport) area. The ribbon replaces the menus and toolbars found older software applications.

The ribbon includes a context menu, and tabs labeled Home, Grid, Annotations, and Configure. PMA.vue only has the Home tab. The ribbon in PMA.studio can be extended with optional tabs.

When you select a tab, the area below the ribbon displays a set of groups and, within the groups, buttons representing a variety of commands.

Appearance of tabs and controls are being controlled by the ribbon layout, which can be specified in the Admin area.

Viewer panel consist of one or more viewports organized in grid and toolbar underneath it (only in single-slide mode). Currently selected slide is highlighted with the blue dashed border [#1 on a picture #1]. When user adds new viewer panel its grid has only 1 column and 1 row, so it's single cell grid. When changing grid size application will always ask what to do with slides that were already loaded into grid - whether application should preserve it or clear all.

Toolbar is placed underneath the viewer [#2 on picture #1] Toolbar consists of (left to the right):

1. Flip horizontally
2. Flip vertically
3. Rotate counter-clockwise 90 degrees
4. Rotate clockwise 90 degrees
5. Rotate 180 degrees
6. Previous slide
7. Next slide
8. Magnification buttons

PMA.Studio allows to load multiple slides into the grid in addition to opening multiple viewer panels with grid inside. Each slide position could be changed using [i] [#1 on picture #2] button on top of viewport - it's required to drag and drop that [i] handle to the desired position - it could be either another cell, tray or new viewer panel. In addition Column/row of grid also could change it's position - there is a handle [#2, #3, #4, #5 on picture #2] near each row or column that could be drag and dropped to the required position.

Purpose of Navigation panel is to provide an access to connected Tile servers, represent folder\slides structure and select slide to inspect. Navigation panel works in 2 modes - Tree mode and Slides mode. Tree mode Navigation panel in Tree mode consists of 2 main elements - button toolbar and Tile server content. Button toolbar [#1 on Picture #3] consist of 4 buttons - from the left to the right:

1. Switch navigation mode - there are 2 Navigation modes - Tree mode and Gallery mode
2. Reload - force pick latest folder\slides structure from the Tile server
3. Open in new tab - toggles mode that opens selected slide in the current selected cell or creates a new viewer panel and put selected slide there
4. Show preview - toggles visibility of slide preview on hover in Tree mode

Slides mode Navigation panel in Gallery mode consists of buttons toolbar, directory selector and directory content. Button toolbar consist of 4 buttons - from the left to the right

1. Switch - switches navigation mode to Tree mode
2. Reload - force pick latest slides in the directory
3. Open in new tab - toggles mode that opens selected slide in the current selected cell or creates a new viewer panel and put selected slide there
4. Mode - toggles presence of barcode and thumbnail on the slide

More information can be found on the Slide browser page.

Tray

Tray panel is a virtual store of slides, user can send slides to the Tray and keep them in Tray for the current session. User can open select slides from tray and open them in v iewer tabs or in a grid or remove them from the Tray. To make Tray persistent it's possible to export and import slides to\from tray in CSV format. Tray can present slides in 2 ways - Meta data v iew and Slides v iew. Metadata v iew displays slide information and shows all filled forms for the slide with it's values, while slides v iew shows slide contents in Gallery. Button toolbar is mostly the same for slides and metadata v iew except of 'Export to CSV' button which is available only for Metadata v iew. In both modes it's available to select slides by clicking on them, selected slides are being highlighted with blue colour, in addition slide that that is currently active in v iewer will be additionally highlighted in Metadata v iew with blue dashed border. Tray toolbar consist of several buttons, from the left to the right:

1. Switch mode - switches between Metadata and Slides mode
2. Select dropdown -
   1. All - select all slides in Tray
   2. None - deselect all slides in Tray - selection will be empty
   3. Invert - invert selection, deselect selected slides and v ice verca
3. Remove selected - removes selected slides from the Tray
4. Clear - removes all slides from the Tray
5. Open in grid - open selected slides in one v iewer panel in Grid, it's possible to perform this action only when selected slides count is less or equal 36 (6*6 grid)
6. Open in tabs - open each selected slide in separate v iewer panel
7. Export to CSV - exports slides metadata information - slide info and filled forms to the csv file, download should start immediatly
8. Import from CSV - opens an import wizard

Annotations panel displays existing annotations on the selected slide. A table contains Note, Pen Width, Color, Area and Length of every annotations. Besides this data there are buttons for remove, edit and show/hide annotation item. Annotation creating also available with Ribbon tools at Annotations tab. Available buttons:

1. Delete annotation
2. Edit annotation (opens window with caption field)
3. Show/hide annotation (toggles displaying of the annotation on viewport)

Info panel displays available slide information for currently selected slide. Currently selected slide is highlighted with blue dashed border. Columns are pretty self-descriptive and only thing to mention here is that barcode and overv iew is clickable and by clicking on that images it will be opened in a new browser tab.

Purpose of color adjustment panel is to prov ide tools for changing color settings for selected slide. There are 3 available settings (from top to bottom) - Brightness, Contrast and Gamma, for each setting there are 2 ways of change its value - slider and input. Slider and input are synchronized and user can adjust settings using both ways. 'Reset to default' button will reset settings to the following values - Brightness: 0, Contrast: 1, Gamma: 1.

Forms data panel purpose is to show filled forms for the slide and prov ide access to editing and filling new forms for currently selected slide. The panel consists of 2 main sections - Add button that will add a panel with specific form, and section with already filled form for the selected slide, user can collapse\expand each form with toggle control in top left corner and if user need to edit the form (s)he should click on 'Edit' button, it will open a new panel - specific form edit panel, where user can fill or edit form values and save them.

Conferencing panel works in 3 modes:

1. No active conference: when there is no active conference this panel just show a placeholder that allows user to Create new conference or Join to existing conference.
2. Active conference, user is admin: When there is an active conference and user is admin of conference user can see:
   1. Link to share - 'Copy' button allows to copy link to clipboard, and then this link can be used for joining a conference as participant
   2. Conference name (specified by admin)
   3. Owner - nickname of user who created a conference
   4. Nickname - nickname of current user
   5. Live mode - can be in 2 states - enabled (green circle), and disabled (red circle). When live mode is enabled conference participants can see the same ROIs as admin, when it is disabled participant cannot see
   6. Everyone in control - indicator is the same as for Live mode, when everyone in control enabled all participants can control what is being shown in conference
   7. Participants - list of participant nicknames
3. Active conference, user is participant: When user joined to a conference as participant (s)he can see a reduced list of fields that are the same to one that is described in previous list item

Viewer area contains application Main page, Embedded view and Embedded directory. Main page consists consists of 2 main parts - ribbon on top and panels organized in panel stacks.