feat: cornerstone3D stack and volume viewports (#2787)
* feat: cs3d working stack viewport and tools (#19) * Squashed everything * fix weird react issue * fix eslint / prettier stuff * thumbnails work now with cpu rendering * feat: use new loadImageToCanvas in cs3d * make jump to measurement work * fix active thumbnail * fix measurement delete * fix window level presets * remove segmentation and sync groups for now * fix the dicom pdf and dicom video * fix cornerstone window assignment for cypress * apply review comments Co-authored-by: Erik <erik.sweed@gmail.com> * feat: cs3d tools and toolGroups (#20) * add more tools to work with cs3d mode * fix hotkeys * add stack manager usage for stach viewports * add image scrollbar * wip viewport overlay * fix toAnnotation schema for tools * fix the unnecessary size change that triggered resize * hanging protocol improvement to allow unmatched errors * study description matching for hanging protocol * fix the displaysetOptions to work * fix handle the active tool when a new viewport is added * fix separate toolGroups for mode * apply review comments * apply review comments * yarn lock * feat: overlay component (#21) * fix default displayset options * add viewport overlay * apply review comments * feat: loading and orientation indicators (#22) * add loading indicator * add orientation marker initial work * apply review comments * fix: orientation markers (#23) * finished the orientation markers * fix various broken cypress tests * apply review comments * update yarn lock * feat: re-working measurement tracking mode with cornerstone3d (#2805) * feat: cs3d working stack viewport and tools (#19) * Squashed everything * fix weird react issue * fix eslint / prettier stuff * thumbnails work now with cpu rendering * feat: use new loadImageToCanvas in cs3d * make jump to measurement work * fix active thumbnail * fix measurement delete * fix window level presets * remove segmentation and sync groups for now * fix the dicom pdf and dicom video * fix cornerstone window assignment for cypress * apply review comments Co-authored-by: Erik <erik.sweed@gmail.com> * feat: Add Measurement tracking mode with cs3D (#2789) * feat: first render for cornerstone3d tracked viewport * make tool active work * wip for SR extension * renamed dicom sr to cornerstone dicom sr * remove cornerstone from dicom pdf and video * move dicom sr logic to sr extension * feat: Add hydration for the length tool * fix SR display tool for length using cs3d * fix default config * fix: various bugs with sr viewport and tracking * fix promptying to continue tracking for when SR is created * feat: add keep trackign of unique identifiers * fix hydration for same imageIds * feat: Add SR toolGroup creation on modeEnter * feat: remove the need for separate mapper for SR hydration * add SR display for ellipse * handle hydration of elliptical ROI tool * remove cornerstone extension * add arrow mapping * feat: Add ArrowAnnotate SR display and hydration * apply review comments * apply review comments * move viewport labels to the viewportData * apply review comments * fix: integration cypress tests with cornerstone3D and add CINE tool (#2795) * fix: integration cypress tests with cornerstone3D * revert to addOrUpdate as it makes more sense * fix local drag and drop * fix tests * move dicomLoaderService to cornerstone extension * fix various import bugs * fix bug for local PT series * fix various unit tests * bump cs3d versions * add angle and magnify tool * bump dependencies to avoid broken peerDeps * feat: add initial work for capture using cs3d * feat: show annotations on the image capture * feat: add svg layer export * feat: Add CINE Tool * feat: remove unnecessary viewport rendering for cine state changes Co-authored-by: Erik Ziegler <erik.sweed@gmail.com> * docs: modify and improve documentation (#2800) * cleanup docs versionings * feat: Add all version explanations * version docs for 3.0 * wip for changing docs * wip for updated docs * add utility module documentation * fix demo with nohoisting of history * add slides and video to resources * apply review comments * fix: drag and drop SR into SR viewport (#2803) * update yarn lock Co-authored-by: Erik <erik.sweed@gmail.com> * update pathnames to match v3-stable * update the e2e pathname * fix: various bugs with regard to tracking workflow (#2811) * fix: various issues with measurement panel * fix: update default tool style for annotations * fix: annotatoin label getting removed * feat: Add backward compatibility for SR hydration with legacy cornerstone * fix: cursors and ellipse ROI max style * fix: ArrowAnnotate SRDisplay * apply review comments * bump package versions * fix: bugin rehydration of SR * fix: e2e tests * fix active viewport thickness and arrowTool ui * add readme for measurement tracking * use uploaded image for readme * add back images * try to fix e2e test * fix: window level presets hotkeys * Update README.md * update yarn lock * feat: volume api and TMTV mode (#2817) * feat: volumeAPI and TMTV mode * feat: use cs3d cache service to obtain viewportData * wip for volume api * wip: fusion viewport * feat: add blend mode option * wip for image scrollbar * fix drag and drop thumbnail * wip for image scrollbar for voluems * fix: element mismatch bug for scroll * feat: Add image scrollbar to volumes * feat: add syncGroups to volume api * feat: add tmtv mode initial setup * feat: add initial image options for the stack viewports * feat: Add custom load strategy for volume viewports via HP * apply review comments fix: Jump presets cs3d (#2812) * feat: Add JumpPreset to OHIF for Cornerstone3D * fix: accessing viewport service from servicesManager feat: volume API and TMTV mode (#2814) * fix: do not display overlays on mip viewports * feat: add optional disableCommands for toggle buttons * fix: toggleCrossharis * feat: config the crosshairs * feat: add PetSUV Panel for changing metadata * feat: initial work for the rectangleROIThreshold panel * wip: measurement service * roi threshold working * feat: Add displayText to segmentations * feat: add remove segmentation * feat: add csv export * feat: add RT export for annotations in tmtv mode * fix: fusion to use pt in tmtv mode and measuremet mappings * fix: various bugs * apply review comments * apply review comments * feat: add fusion color maps * add readme to tmtv mode * Update README.md * fix: try to fix build * fix unit tests * Update README.md * feat: add about to the panel * fix: changing strategy in roi panel * apply review comments * update package versions * wip for stackPrefetch * fix: cornerstone3d hydration and renaming (#2818) * update readme * renamed cornerstone extension * wip for renaming cornerstone3D variables * wip for renaming cornerstone3D variables * wip for fixing bugs for SR viewport * fix: jumpToMeasurement and initial label after hydration * fix: fileName capitalization * feat: use the new prefetch stack in the cs3d (#2820) * feat: use the new prefetch stack in the cs3d * use viewport scroll api for stack viewport * fix cine stop when scrollbar changes * feat: use new prefetch events * fix loading state to not show repeatedly * fix: various bugs for tmtv mode thresholding and new icons (#2823) * feat: make tmtv mode available in worklist * feat: add new icons for tmtv mode * feat: add fusion color icon * fix: parallel scale calculation * fix: bump Cornerstone to get large image support working * fix: Fix issues with CPU viewport flipping, including config files * fix: bump cornerstone to fix magnify tool * fix: Bump Cornerstone version to fix resetCamera issue in StackViewport * ci: Add _headers file to enable CORS headers for Netlify Drag/Drop deploys * fix: WADO-URI was not working. PET Metadata was coming from the wrong place. Fixed some minor React errors * feat(OHIF):Allow modes and extensions to be added after commpile time. (#2838) Also works with the compile time add that the existing cli uses, so that both build types work. Eric and I agreed this doesn't change existing functionality, but is almost entirely build issues/fixes. * bump: dependency versions to fix hydration bugs (#2848) * bump: dcmjs version to fix hydration bugs * try to fix tests * bump dependency versions Co-authored-by: Alireza <ar.sedghi@gmail.com> Co-authored-by: Bill Wallace <wayfarer3130@gmail.com>
This commit is contained in:
668 files changed
+41669
-13410
No files matched your search
@@ -0,0 +1,4 @@
|
||||
{
|
||||
"label": "User Guide",
|
||||
"position": 2
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
---
|
||||
sidebar_position: 2
|
||||
sidebar_label: Study List
|
||||
---
|
||||
|
||||
# Study List
|
||||
|
||||
## Overview
|
||||
|
||||
The first page you will see when the viewer is loaded is the `Study List`. In
|
||||
this page you can explore all the studies that are stored on the configured
|
||||
server for the `OHIF Viewer`.
|
||||
|
||||
|
||||
|
||||
## Sorting
|
||||
|
||||
When the Study List is opened, the application queries the PACS for 101 studies
|
||||
by default. If there are greater than 100 studies returned, the default sort for
|
||||
the study list is dictated by the image archive that hosts these studies for the
|
||||
viewer and study list sorting will be disabled. If there are less than or equal
|
||||
to 100 studies returned, they will be sorted by study date (most recent to
|
||||
oldest) and study list sorting will be enabled. Whenever a query returns greater
|
||||
than 100 studies, use filters to narrow results below 100 studies to enable
|
||||
Study List sorting.
|
||||
|
||||
## Filters
|
||||
|
||||
There are certain filters that can be used to limit the study list to the
|
||||
desired criteria.
|
||||
|
||||
- Patient Name: Searches between patients names
|
||||
- MRN: Searches between patients Medical Record Number
|
||||
- Study Date: Filters the date of the acquisition
|
||||
- Description: Searches between study descriptions
|
||||
- Modality: Filters the modalities
|
||||
- Accession: Searches between patients accession number
|
||||
|
||||
An example of using study list filter is shown below:
|
||||
|
||||
|
||||
|
||||
Below the study list are pagination options for 25, 50, or 100 studies per page.
|
||||
|
||||
|
||||
|
||||
## Study Summary
|
||||
|
||||
Click on a study to expand the study summary panel.
|
||||
|
||||
|
||||
|
||||
A summary of series available in the study is shown, which contains the series
|
||||
description, series number, modality of the series, instances in the series, and
|
||||
buttons to launch viewer modes to display the study.
|
||||
|
||||
## Study Specific Modes
|
||||
|
||||
All available modes are seen in the study expanded view. Modes can be enabled or
|
||||
disabled for a study based on the modalities contained within the study.
|
||||
|
||||
In the screenshot below, there are two modes shown for the selected study
|
||||
|
||||
- Basic Viewer: Default mode that enables rendering and measurement tracking
|
||||
|
||||
- PET/CT Fusion: Mode for visualizing the PET CT study in a 3x3 format.
|
||||
|
||||
Based on the mode configurations (e.g., available modalities), PET/CT mode is
|
||||
disabled for studies that do not contain PET AND CT images.
|
||||
|
||||
<!-- This should be a screenshot that show an expanded study with multiple modalities (CT, MRI) but not PET. -->
|
||||
|
||||
|
||||
|
||||
The previous screenshot shows a study containing PET and CT images and both
|
||||
Basic Viewer and PET/CT Mode are available.
|
||||
|
||||
## View Study
|
||||
|
||||
The `Basic Viewer` mode is available for all studies by default. Click on the
|
||||
mode button to launch the viewer.
|
||||
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
---
|
||||
sidebar_position: 8
|
||||
---
|
||||
|
||||
# Language
|
||||
|
||||
OHIF supports internationalization capabilities and setting the general language
|
||||
of the Viewer.
|
||||
|
||||
It should be noted that we don't have complete translations for all the components
|
||||
and all the languages; however, you can easily add the key value translation pairs
|
||||
following developer guides.
|
||||
|
||||
Summary of language changing usage can be seen below:
|
||||
|
||||
|
||||
|
||||
## Overview Video
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/559038442?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
@@ -0,0 +1,4 @@
|
||||
{
|
||||
"label": "Basic Viewer",
|
||||
"position": 2
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Hotkeys
|
||||
|
||||
To open the hotkey assignment panel, you can click on the Preferences gear on the
|
||||
top right side of the viewer.
|
||||
|
||||
|
||||
Below, you can see the default hotkeys key bindings:
|
||||
|
||||
|
||||
|
||||
Hotkeys can be assigned to custom bindings that persist for the duration of the browser session.
|
||||
@@ -0,0 +1,29 @@
|
||||
---
|
||||
sidebar_position: 1
|
||||
sidebar_label: Overview
|
||||
---
|
||||
|
||||
|
||||
# Overview
|
||||
When you open a mode, viewport, toolbar and panels of the mode get shown.
|
||||
It is important to note that each mode has a different UI, which serves its purpose.
|
||||
Here we explain various components of `Basic Viewer` mode which includes measurement
|
||||
tracking functionalities.
|
||||
|
||||
Basic viewer mode (longitudinal):
|
||||
|
||||
|
||||
|
||||
Let's break different aspects of the viewer to the main components:
|
||||
|
||||
- Left Panel (study panel): displays series thumbnails with series details
|
||||
- Viewport: renders the image and displays annotations
|
||||
- Right Panel (measurements): displays annotations details
|
||||
- Toolbar: displays tools and logo
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Now, we explain each component and its sub-elements in detail.
|
||||
@@ -0,0 +1,74 @@
|
||||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Measurement Panel
|
||||
|
||||
## Introduction
|
||||
In `Basic Viewer` mode, the right panel is the `Measurement Panel`. The Measurement Panel can be expanded or hidden by clicking on the arrow to the left of `Measurements`.
|
||||
<!-- We might want to make an entire section about the tracking workflow including SR hydration because it's pretty complicated. Let's review after the deploy branch is ready. Logic is in OHIF-63 OHIF-339 tickets for reference -->
|
||||
Select a measurement tool and mark an image to initiate measurement tracking. A pop-up will ask if you want to track measurements for the series on which the annotation was drawn.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
If you select `Yes`, the series becomes a `tracked series`, and the current drawn measurement and next measurements are shown on the measurement panel on the right.
|
||||
|
||||
|
||||
|
||||
If you select `No`, the measurement becomes temporary. The next annotation made will repeat the measurement tracking prompt.
|
||||
|
||||
If you select `No, do not ask again`, all annotations made on the study will be temporary.
|
||||
<!-- Temporary measurement screenshot -->
|
||||
|
||||
|
||||
|
||||
## Labeling Measurements
|
||||
You can edit the measurement name by hovering over the measurement and selecting the edit icon. You can also label or relabel a measurement by right-clicking on it in the viewport.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Deleting a Measurement
|
||||
A measurement can be deleting by dragging it outside the image in the viewport or by right-clicking on the measurement in the viewport and selecting 'Delete'.
|
||||
|
||||
|
||||
## Jumping to a Measurement
|
||||
Measurement navigation inside the top viewport can be used to move to previous and next measurement.
|
||||
|
||||
|
||||
|
||||
|
||||
If a series containing a measurement is currently being displayed in a viewport, you can jump to display the measurement in the viewport by clicking on it in the Measurement Panel.
|
||||
|
||||
## Export Measurements
|
||||
<!-- I think PDF and DICOM export didn't make it into this version but should be options. Let's confirm -->
|
||||
You can export the measurements by clicking on the `Export`. A CSV file will get downloaded to your local computer containing the drawn measurements.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
If you have set up your DICOM server to be able to store instances from the viewer, then you are able to create a report by clicking on the `Create Report`.
|
||||
This will create a DICOM Structured Report (SR) from the measurements and push it
|
||||
to the server.
|
||||
|
||||
For instance, running the Viewer on a local DCM4CHEE:
|
||||
|
||||
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/557569965?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
## Overview Video
|
||||
An overview of measurement drawing and exporting can be seen below:
|
||||
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/545986384?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
@@ -0,0 +1,124 @@
|
||||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Measurement Tracking
|
||||
|
||||
## Introduction
|
||||
OHIF-V3's `Basic Viewer` implements a `Measurement Tracking` workflow. Measurement
|
||||
tracking allows you to:
|
||||
|
||||
- Draw annotations and have them shown in the measurement panel
|
||||
- Create a report from the tracked measurement and export them as DICOM SR
|
||||
- Use already exported DICOM SR to re-hydrate the measurements in the viewer
|
||||
|
||||
|
||||
## Status Icon
|
||||
Each viewport has a left icon indicating whether the series within the viewport
|
||||
contains:
|
||||
|
||||
- tracked measurement OR
|
||||
- untracked measurement OR
|
||||
- Structured Report OR
|
||||
- Locked (uneditable) Structured Report
|
||||
|
||||
In the following, we will discuss each category.
|
||||
|
||||
### Tracked vs Untracked Measurements
|
||||
|
||||
`OHIF-v3` implements a workflow for measurement tracking that can be seen below.
|
||||
|
||||
|
||||
|
||||
In summary, when you create an annotation, a prompt will be shown whether to start tracking or not. If you start the tracking, the annotation style will change to a solid line, and annotation details get displayed on the measurement panel.
|
||||
On the other hand, if you decline the tracking prompt, the measurement will be considered "temporary," and annotation style remains as a dashed line and not shown on the right panel, and cannot be exported.
|
||||
|
||||
|
||||
Below, you can see different icons that appear for a tracked vs. untracked series in
|
||||
`OHIF-v3`.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### Overview video for starting the tracking for measurements:
|
||||
<!-- trackedMeasurements -->
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570278865?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
|
||||
<br></br>
|
||||
|
||||
#### Overview video for not starting tracking for measurements:
|
||||
<!-- untrackedMeasurements -->
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570280036?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
|
||||
### Reading and Writing DICOM SR
|
||||
|
||||
`OHIF-v3` provides full support for reading, writing and mapping the DICOM Structured
|
||||
Report (SR) to interactable `Cornerstone Tools`. When you load an already exported
|
||||
DICOM SR into the viewer, you will be prompted whether to track the measurements
|
||||
for the series or not.
|
||||
|
||||
|
||||
|
||||
If you click Yes, DICOM SR measurements gets re-hydrated into the viewer and
|
||||
the series become a tracked series. However, If you say no and later decide to say track the measurements, you can always click on the SR button that will prompt you
|
||||
with the same message again.
|
||||
|
||||
|
||||
|
||||
The full workflow for saving measurements to SR and loading SR into the viewer is shown below.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### Overview video for loading DICOM SR and making a tracked series:
|
||||
<!-- SR Restore and Yes -->
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570278845?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
<br></br>
|
||||
|
||||
#### Overview video for loading DICOM SR and not making a tracked series:
|
||||
<!-- SR Restore and No -->
|
||||
<!-- SR Export and measurement restore -->
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570278814?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
<br></br>
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570278799?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
|
||||
### Loading DICOM SR into an Already Tracked Series
|
||||
|
||||
If you have an already tracked series and try to load a DICOM SR measurements,
|
||||
you will be shown the following lock icon. This means that, you can review the
|
||||
DICOM SR measurement, manipulate image and draw "temporary" measurements; however,
|
||||
you cannot edit the DICOM SR measurement.
|
||||
|
||||
|
||||
|
||||
|
||||
<br></br>
|
||||
|
||||
|
||||
#### Overview video for loading DICOM SR inside an already tracked series:
|
||||
<!-- DICOMSRLockedTracked -->
|
||||
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/570278726?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Study Panel
|
||||
|
||||
In `Basic Viewer` mode, the left panel includes Studies related to the current
|
||||
patient. You can see three main type of studies below
|
||||
|
||||
- Primary: The opened study from the study list. This study is always expanded
|
||||
by default.
|
||||
- Recent: All studies for the patient that contain study dates within 1 year of
|
||||
the primary study
|
||||
- All: All studies available for the patient contained within the source
|
||||
repository
|
||||
|
||||
The `Study Panel` displays the measurement tracking status of each series within
|
||||
a study. As you can see in the first picture, the dashed circle on the left side
|
||||
of each series demonstrates whether the series is being tracked for measurement
|
||||
or not.
|
||||
|
||||
<!-- We should resize this screenshot to make it smaller. We might want to add both screenshots in-line to make better use of horizontal space. Let's ask Dan -->
|
||||
|
||||
|
||||
|
||||
Studies can be expanded or collapsed by clicking on the study information in the
|
||||
Study Panel. If a series is being tracking within a study, the Measurement Panel
|
||||
will display this information while the study is collapsed.
|
||||
|
||||
<!-- We should link to refer to measurement tracking section -->
|
||||
|
||||
<!-- We need to add SR functionality descriptions to this section -->
|
||||
@@ -0,0 +1,84 @@
|
||||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
|
||||
# Toolbar
|
||||
|
||||
The four main components of the toolbar are:
|
||||
|
||||
- Navigation back to the [Study List](../index.md)
|
||||
- Logo and white labelling
|
||||
- [Tools](#tools)
|
||||
- [Preferences](#preferences)
|
||||
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
This section displays all the available tools inside the mode.
|
||||
## Measurement tools
|
||||
The basic viewer comes with the following default measurement tools:
|
||||
|
||||
- Length Tool: Calculates the linear distance between two points in *mm*
|
||||
- Bidirectional Tool: Creates a measurement of the longest diameter (LD) and longest perpendicular diameter (LPD) in *mm*
|
||||
- Annotation: Used to create a qualitative marker with a freetext label
|
||||
- Ellipse: Measures an elliptical area in *mm<sup>2</sup>* and Hounsfield Units (HU)
|
||||
|
||||
When a measurement tool is selected from the toolbar, it becomes the `active` tool. Use the caret to expand the measurement tools and select another tool.
|
||||
<!-- We should add a smaller screenshot for each measurement tool. Maybe have a matrix with 4 identical sized screenshots in a box? Also we should make sure the screenshots have more realistic measurements -->
|
||||
|
||||
|
||||
|
||||
|
||||
## Window/Level
|
||||
The `Window/Level` tool enables manipulating the window level and window width of the rendered image. Click on the tool to enable freeform adjustment, then click and drag on the viewport to freely adjust the window/level.
|
||||
|
||||
Click on the caret to expand the tool and choose from predefined W/L settings for common imaging scenarios.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Pan and Zoom
|
||||
With the Zoom tool selected, click and drag the cursor on an image to adjust the zoom. The magnification level is displayed in the viewport.
|
||||
|
||||
With the Pan tool selected, click and drag the cursor on an image to adjust the image position.
|
||||
|
||||
## Image Capture
|
||||
Click on the Camera icon to download a high quality image capture using common image formats (png, jpg)
|
||||
|
||||
|
||||
|
||||
In the opened modal, the filename, image's width and height, and filetype and can be configured before downloading the image to your local computer.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Layout Selector
|
||||
Please see the `Viewport` section for details.
|
||||
|
||||
|
||||
## More Tools Menu
|
||||
- Reset View: Resets all image manipulation such as position, zoom, and W/L
|
||||
- Rotate Right: Flips the image 90 degrees clockwise
|
||||
- Flip Horizontally: Flips the image 180 degrees horizontally
|
||||
- Stack Scroll: Links all viewports containing images to scroll together
|
||||
- Magnify: Click on an image to magnify a particular area of interest
|
||||
- Invert: Inverts the color scale
|
||||
- Cine: Toggles the Cine player control in the currently selected viewport. Click the `x` on the Cine player or click the tool again to toggle off.
|
||||
- Angle: Measures an adjustable angle on an image
|
||||
- Probe: Drag the probe to see pixel values
|
||||
- Rectangle: Measures a rectangular area in mm^2 and HU
|
||||
|
||||
When a tool is selected from the `More Tools` menu, it becomes the active tool until it is replaced by clicking on a different tool in the More Tools menu or main toolbar.
|
||||
|
||||
<!-- Cine player tool -->
|
||||
## Overview Video
|
||||
An overview of tool usage can been seen below:
|
||||
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/545989422?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Viewport
|
||||
|
||||
Image visualization happens at the viewport which contains canvas or canvases that
|
||||
renders series.
|
||||
|
||||
|
||||
|
||||
|
||||
By default, you can modify:
|
||||
|
||||
- Zoom: right click dragging up or down
|
||||
- Contrast/brightness: left click dragging up/down to change contrast, and left/right for changing brightness
|
||||
- Pan: middle click dragging
|
||||
|
||||
|
||||
## Changing Series for display
|
||||
To change the displayed series, you can drag and drop the desired series from the left panel. Start, by dragging the thumbnail of the series, and drop it on the viewport.
|
||||
|
||||
## Changing Layout
|
||||
If you click on the layout icon on the toolbar, you can use the layout selector UI. After changing the layout, you can select studies for each new viewport by dragging and dropping in to the viewport.
|
||||
|
||||
After changing the layout from 1x1, you will see each viewport gets tagged by a letter,
|
||||
which matches its series section in the study list.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Overview Video
|
||||
An overview of viewport layout change, and manipulation can be seen below:
|
||||
|
||||
|
||||
<div style={{padding:"56.25% 0 0 0", position:"relative"}}>
|
||||
<iframe src="https://player.vimeo.com/video/545995881?badge=0&autopause=0&player_id=0&app_id=58479" frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen style= {{ position:"absolute",top:0,left:0,width:"100%",height:"100%"}} title="measurement-report"></iframe>
|
||||
</div>
|
||||
Reference in new issue
Block a user