Class: CircleROIStartEndThresholdTool

CircleROITool let you draw annotations that measures the statistics such as area, max, mean and stdDev of an elliptical region of interest. You can use CircleROITool in all perpendicular views (axial, sagittal, coronal). Note: annotation tools in cornerstone3DTools exists in the exact location in the physical 3d space, as a result, by default, all annotations that are drawing in the same frameOfReference will get shared between viewports that are in the same frameOfReference. Circle tool's text box lines are dynamically generated based on the viewport's underlying Modality. For instance, if the viewport is displaying CT, the text box will shown the statistics in Hounsfield units, and if the viewport is displaying PET, the text box will show the statistics in SUV units.

The resulting annotation's data (statistics) and metadata (the state of the viewport while drawing was happening) will get added to the ToolState manager and can be accessed from the ToolState by calling getAnnotations or similar methods.

Changing tool configuration (see below) you can make the tool to draw the center point circle with a given radius.

cornerstoneTools.addTool(CircleROITool)

const toolGroup = ToolGroupManager.createToolGroup('toolGroupId')

toolGroup.addTool(CircleROITool.toolName)

toolGroup.addViewport('viewportId', 'renderingEngineId')

toolGroup.setToolActive(CircleROITool.toolName, {
  bindings: [
   {
      mouseButton: MouseBindings.Primary, // Left Click
    },
  ],
})

// draw a circle at the center point with 4px radius.
toolGroup.setToolConfiguration(CircleROITool.toolName, {
  centerPointRadius: 4,
});

Read more in the Docs section of the website.

Extends

• CircleROITool

Constructors

new CircleROIStartEndThresholdTool()

new CircleROIStartEndThresholdTool(toolProps, defaultToolProps): CircleROIStartEndThresholdTool

Parameters

• toolProps: PublicToolProps = {}

• defaultToolProps: SharedToolProp = ...

Returns

CircleROIStartEndThresholdTool

Overrides

CircleROITool.constructor

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:80

Properties

_throttledCalculateCachedStats

_throttledCalculateCachedStats: Function

Overrides

CircleROITool._throttledCalculateCachedStats

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:69

---

configuration

configuration: Record<string, any>

Inherited from

CircleROITool.configuration

Defined in

tools/src/tools/base/BaseTool.ts:17

---

editData

editData: object

annotation

annotation: Annotation

handleIndex?

optional handleIndex: number

hasMoved?

optional hasMoved: boolean

newAnnotation?

optional newAnnotation: boolean

viewportIdsToRender

viewportIdsToRender: string[]

Overrides

CircleROITool.editData

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:70

---

isDrawing

isDrawing: boolean

Overrides

CircleROITool.isDrawing

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:77

---

isHandleOutsideImage

isHandleOutsideImage: boolean = false

Overrides

CircleROITool.isHandleOutsideImage

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:78

---

mode

mode: ToolModes

Tool Mode - Active/Passive/Enabled/Disabled/

Inherited from

CircleROITool.mode

Defined in

tools/src/tools/base/BaseTool.ts:21

---

supportedInteractionTypes

supportedInteractionTypes: InteractionTypes[]

Supported Interaction Types - currently only Mouse

Inherited from

CircleROITool.supportedInteractionTypes

Defined in

tools/src/tools/base/BaseTool.ts:15

---

toolGroupId

toolGroupId: string

ToolGroup ID the tool instance belongs to

Inherited from

CircleROITool.toolGroupId

Defined in

tools/src/tools/base/BaseTool.ts:19

---

toolName

static toolName: any

Overrides

CircleROITool.toolName

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:67

Methods

_activateDraw()

_activateDraw(element): void

Parameters

• element: any

Returns

void

Inherited from

CircleROITool._activateDraw

Defined in

tools/src/tools/annotation/CircleROITool.ts:563

---

_activateModify()

_activateModify(element): void

Parameters

• element: any

Returns

void

Inherited from

CircleROITool._activateModify

Defined in

tools/src/tools/annotation/CircleROITool.ts:539

---

_calculateCachedStats()

_calculateCachedStats(annotation, viewport, renderingEngine, enabledElement): any

Parameters

• annotation: any

• viewport: any

• renderingEngine: any

• enabledElement: any

Returns

any

Inherited from

CircleROITool._calculateCachedStats

Defined in

tools/src/tools/annotation/CircleROITool.ts:847

---

_calculateCachedStatsTool()

_calculateCachedStatsTool(annotation, enabledElement): any

Parameters

• annotation: any

• enabledElement: any

Returns

any

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:773

---

_computePointsInsideVolume()

_computePointsInsideVolume(annotation, imageVolume, targetId, enabledElement): void

Parameters

• annotation: any

• imageVolume: any

• targetId: any

• enabledElement: any

Returns

void

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:613

---

_computeProjectionPoints()

_computeProjectionPoints(annotation, imageVolume): void

Parameters

• annotation: CircleROIStartEndThresholdAnnotation

• imageVolume: ImageVolume

Returns

void

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:549

---

_deactivateDraw()

_deactivateDraw(element): void

Parameters

• element: any

Returns

void

Inherited from

CircleROITool._deactivateDraw

Defined in

tools/src/tools/annotation/CircleROITool.ts:576

---

_deactivateModify()

_deactivateModify(element): void

Parameters

• element: any

Returns

void

Inherited from

CircleROITool._deactivateModify

Defined in

tools/src/tools/annotation/CircleROITool.ts:551

---

_dragDrawCallback()

_dragDrawCallback(evt): void

Parameters

• evt: InteractionEventType

Returns

void

Inherited from

CircleROITool._dragDrawCallback

Defined in

tools/src/tools/annotation/CircleROITool.ts:406

---

_dragHandle()

_dragHandle(evt): void

Parameters

• evt: InteractionEventType

Returns

void

Inherited from

CircleROITool._dragHandle

Defined in

tools/src/tools/annotation/CircleROITool.ts:477

---

_dragModifyCallback()

_dragModifyCallback(evt): void

Parameters

• evt: InteractionEventType

Returns

void

Inherited from

CircleROITool._dragModifyCallback

Defined in

tools/src/tools/annotation/CircleROITool.ts:432

---

_endCallback()

_endCallback(evt): void

Parameters

• evt: InteractionEventType

Returns

void

Overrides

CircleROITool._endCallback

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:236

---

_getCoordinateForViewplaneNormal()

_getCoordinateForViewplaneNormal(pos, viewPlaneNormal): number

Parameters

• pos: number | vec3

• viewPlaneNormal: Point3

Returns

number

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:870

---

_getEndCoordinate()

_getEndCoordinate(worldPos, spacingInNormal, viewPlaneNormal): number

Parameters

• worldPos: Point3

• spacingInNormal: number

• viewPlaneNormal: Point3

Returns

number

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:828

---

_getIndexOfCoordinatesForViewplaneNormal()

_getIndexOfCoordinatesForViewplaneNormal(viewPlaneNormal): number

Parameters

• viewPlaneNormal: Point3

Returns

number

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:855

---

_getStartCoordinate()

_getStartCoordinate(worldPos, spacingInNormal, viewPlaneNormal): number

Parameters

• worldPos: Point3

• spacingInNormal: number

• viewPlaneNormal: Point3

Returns

number

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:802

---

_isInsideVolume()

_isInsideVolume(index1, index2, dimensions): boolean

Parameters

• index1: any

• index2: any

• dimensions: any

Returns

boolean

Inherited from

CircleROITool._isInsideVolume

Defined in

tools/src/tools/annotation/CircleROITool.ts:1010

---

addNewAnnotation()

addNewAnnotation(evt): object

Based on the current position of the mouse and the current imageId to create a CircleROI Annotation and stores it in the annotationManager

Parameters

• evt: InteractionEventType

EventTypes.NormalizedMouseEventType

Returns

object

The annotation object.

data

data: object

data.cachedStats

cachedStats: object

data.cachedStats.pointsInVolume

pointsInVolume: any[] = []

data.cachedStats.projectionPoints

projectionPoints: any[] = []

data.cachedStats.statistics

statistics: ROICachedStats

data.endCoordinate

endCoordinate: number = endCoord

data.handles

handles: object

data.handles.activeHandleIndex

activeHandleIndex: any = null

data.handles.points

points: [Point3, Point3]

data.handles.textBox

textBox: object

data.handles.textBox.hasMoved

hasMoved: boolean = false

data.handles.textBox.worldBoundingBox

worldBoundingBox: object

data.handles.textBox.worldBoundingBox.bottomLeft

bottomLeft: Point3

data.handles.textBox.worldBoundingBox.bottomRight

bottomRight: Point3

data.handles.textBox.worldBoundingBox.topLeft

topLeft: Point3

data.handles.textBox.worldBoundingBox.topRight

topRight: Point3

data.handles.textBox.worldPosition

worldPosition: Point3

data.label

label: string = ''

data.labelmapUID

labelmapUID: any = null

data.startCoordinate

startCoordinate: number = startCoord

highlighted

highlighted: boolean = true

invalidated

invalidated: boolean = true

metadata

metadata: object

metadata.enabledElement

enabledElement: IEnabledElement

metadata.FrameOfReferenceUID

FrameOfReferenceUID: string

metadata.referencedImageId

referencedImageId: any

metadata.spacingInNormal

spacingInNormal: number

metadata.toolName

toolName: string

metadata.viewPlaneNormal

viewPlaneNormal: Point3

metadata.viewUp

viewUp: Point3

metadata.volumeId

volumeId: any

Overrides

CircleROITool.addNewAnnotation

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:112

---

applyActiveStrategy()

applyActiveStrategy(enabledElement, operationData): any

Applies the active strategy function to the enabled element with the specified operation data.

Parameters

• enabledElement: IEnabledElement

The element that is being operated on.

• operationData: unknown

The data that needs to be passed to the strategy.

Returns

any

The result of the strategy.

Inherited from

CircleROITool.applyActiveStrategy

Defined in

tools/src/tools/base/BaseTool.ts:62

---

applyActiveStrategyCallback()

applyActiveStrategyCallback(enabledElement, operationData, callbackType): any

Applies the active strategy, with a given event type being applied. The event type function is found by indexing it on the active strategy function.

Parameters

• enabledElement: IEnabledElement

The element that is being operated on.

• operationData: unknown

The data that needs to be passed to the strategy.

• callbackType: string

the type of the callback

Returns

any

The result of the strategy.

Inherited from

CircleROITool.applyActiveStrategyCallback

Defined in

tools/src/tools/base/BaseTool.ts:86

---

cancel()

cancel(element): string

cancel Used to cancel the ongoing tool drawing and manipulation

Parameters

• element: HTMLDivElement

Returns

string

Inherited from

CircleROITool.cancel

Defined in

tools/src/tools/annotation/CircleROITool.ts:514

---

filterInteractableAnnotationsForElement()

filterInteractableAnnotationsForElement(element, annotations): Annotations

Given the element and annotations which is an array of annotation, it filters the annotations array to only include the annotation based on the viewportType. If the viewport is StackViewport, it filters based on the current imageId of the viewport, if the viewport is volumeViewport, it only returns those that are within the same slice as the current rendered slice in the volume viewport. imageId as the enabledElement.

Parameters

• element: HTMLDivElement

The HTML element

• annotations: Annotations

The annotations to filter (array of annotation)

Returns

Annotations

The filtered annotations

Inherited from

CircleROITool.filterInteractableAnnotationsForElement

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:60

---

getAnnotationStyle()

protected getAnnotationStyle(context): AnnotationStyle

Get the style that will be applied to all annotations such as length, cobb angle, arrow annotate, etc. when rendered on a canvas or svg layer

Parameters

• context

• context.annotation: Annotation

• context.styleSpecifier: StyleSpecifier

Returns

AnnotationStyle

Inherited from

CircleROITool.getAnnotationStyle

Defined in

tools/src/tools/base/AnnotationTool.ts:393

---

getHandleNearImagePoint()

getHandleNearImagePoint(element, annotation, canvasCoords, proximity): ToolHandle

It checks if the mouse click is near TextBoxHandle or AnnotationHandle itself, and return either it. It prioritize TextBoxHandle over AnnotationHandle. If the mouse click is not near any of the handles, it does not return anything.

Parameters

• element: HTMLDivElement

The element that the tool is attached to.

• annotation: Annotation

The annotation object associated with the annotation

• canvasCoords: Point2

The coordinates of the mouse click on canvas

• proximity: number

The distance from the mouse cursor to the point that is considered "near".

Returns

ToolHandle

The handle that is closest to the cursor, or null if the cursor is not near any of the handles.

Inherited from

CircleROITool.getHandleNearImagePoint

Defined in

tools/src/tools/base/AnnotationTool.ts:262

---

getLinkedTextBoxStyle()

getLinkedTextBoxStyle(specifications, annotation?): Record<string, unknown>

It returns the style for the text box

Parameters

• specifications: StyleSpecifier

• annotation?: Annotation

The annotation for the tool that is currently active.

Returns

Record<string, unknown>

An object of the style settings for the text box.

Inherited from

CircleROITool.getLinkedTextBoxStyle

Defined in

tools/src/tools/base/AnnotationTool.ts:328

---

getReferencedImageId()

protected getReferencedImageId(viewport, worldPos, viewPlaneNormal, viewUp?): string

Parameters

• viewport: Viewport

• worldPos: Point3

• viewPlaneNormal: Point3

• viewUp?: Point3

Returns

string

Inherited from

CircleROITool.getReferencedImageId

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:126

---

getStyle()

getStyle(property, specifications, annotation?): unknown

It takes the property (color, lineDash, etc.) and based on the state of the annotation (selected, highlighted etc.) it returns the appropriate value based on the central toolStyle settings for each level of specification.

Parameters

• property: string

The name of the style property to get.

• specifications: StyleSpecifier

• annotation?: Annotation

The annotation for the tool that is currently active.

Returns

unknown

The value of the property.

Inherited from

CircleROITool.getStyle

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:163

---

getTargetId()

protected getTargetId(viewport): string

Get the target Id for the viewport which will be used to store the cached statistics scoped to that target in the annotations. For StackViewport, targetId is the viewportId, but for the volume viewport, the targetId will be grabbed from the volumeId if particularly specified in the tool configuration, or if not, the first actorUID in the viewport.

Parameters

• viewport: Viewport

viewport to get the targetId for

Returns

string

targetId

Inherited from

CircleROITool.getTargetId

Defined in

tools/src/tools/base/BaseTool.ts:197

---

getTargetImageData()

protected getTargetImageData(targetId): IImageData | CPUIImageData

Get the image that is displayed for the targetId in the cachedStats which can be

• imageId:<imageId>
• volumeId:<volumeId>
• videoId:<basePathForVideo>/frames/<frameSpecifier>

Parameters

• targetId: string

annotation targetId stored in the cached stats

Returns

IImageData | CPUIImageData

The image data for the target.

Inherited from

CircleROITool.getTargetImageData

Defined in

tools/src/tools/base/BaseTool.ts:140

---

getToolName()

getToolName(): string

Returns the name of the tool

Returns

string

The name of the tool.

Inherited from

CircleROITool.getToolName

Defined in

tools/src/tools/base/BaseTool.ts:50

---

handleSelectedCallback()

handleSelectedCallback(evt, annotation, handle): void

handleSelectedCallback Custom callback for when a handle is selected.

Parameters

• evt: InteractionEventType

The normalized mouse event

• annotation: CircleROIAnnotation

The annotation selected.

• handle: ToolHandle

The selected handle (either Types.Point3 in space for annotations, or TextBoxHandle object for text boxes).

Returns

void

Inherited from

CircleROITool.handleSelectedCallback

Defined in

tools/src/tools/annotation/CircleROITool.ts:317

---

isPointNearTool()

isPointNearTool(element, annotation, canvasCoords, proximity): boolean

It returns if the canvas point is near the provided annotation in the provided element or not. A proximity is passed to the function to determine the proximity of the point to the annotation in number of pixels.

Parameters

• element: HTMLDivElement

HTML Element

• annotation: CircleROIAnnotation

Annotation

• canvasCoords: Point2

Canvas coordinates

• proximity: number

Proximity to tool to consider

Returns

boolean

Boolean, whether the canvas point is near tool

Inherited from

CircleROITool.isPointNearTool

Defined in

tools/src/tools/annotation/CircleROITool.ts:253

---

isSuvScaled()

isSuvScaled(viewport, targetId, imageId?): boolean

Returns true if the viewport is scaled to SUV units

Parameters

• viewport: StackViewport | VolumeViewport

The viewport

• targetId: string

The annotation targetId

• imageId?: string

The annotation imageId

Returns

boolean

Inherited from

CircleROITool.isSuvScaled

Defined in

tools/src/tools/base/AnnotationTool.ts:374

---

mouseMoveCallback()

mouseMoveCallback(evt, filteredAnnotations?): boolean

Event handler for Cornerstone MOUSE_MOVE event.

Parameters

• evt: MouseMoveEventType

The normalized mouse event

• filteredAnnotations?: Annotations

The annotations to check for hover interactions

Returns

boolean

True if the annotation needs to be re-drawn by the annotationRenderingEngine.

Inherited from

CircleROITool.mouseMoveCallback

Defined in

tools/src/tools/base/AnnotationTool.ts:197

---

onImageSpacingCalibrated()

onImageSpacingCalibrated(evt): void

On Image Calibration, take all the annotation from the AnnotationState manager, and invalidate them to force them to be re-rendered and their stats to be recalculated. Then use the old and new imageData (non-calibrated and calibrated) to calculate the new position for the annotations in the space of the new imageData.

Parameters

• evt: ImageSpacingCalibratedEvent

The calibration event

Returns

void

Inherited from

CircleROITool.onImageSpacingCalibrated

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:83

---

renderAnnotation()

renderAnnotation(enabledElement, svgDrawingHelper): boolean

it is used to draw the circleROI annotation in each request animation frame. It calculates the updated cached statistics if data is invalidated and cache it.

Parameters

• enabledElement: IEnabledElement

The Cornerstone's enabledElement.

• svgDrawingHelper: SVGDrawingHelper

The svgDrawingHelper providing the context for drawing.

Returns

boolean

Overrides

CircleROITool.renderAnnotation

Defined in

tools/src/tools/segmentation/CircleROIStartEndThresholdTool.ts:299

---

setActiveStrategy()

setActiveStrategy(strategyName): void

Sets the active strategy for a tool. Strategies are multiple implementations of tool behavior that can be switched by tool configuration.

Parameters

• strategyName: string

name of the strategy to be set as active

Returns

void

Inherited from

CircleROITool.setActiveStrategy

Defined in

tools/src/tools/base/BaseTool.ts:126

---

setConfiguration()

setConfiguration(newConfiguration): void

merges the new configuration with the tool configuration

Parameters

• newConfiguration: Record<string, any>

Returns

void

Inherited from

CircleROITool.setConfiguration

Defined in

tools/src/tools/base/BaseTool.ts:112

---

toolSelectedCallback()

toolSelectedCallback(evt, annotation): void

Custom callback for when an annotation is selected

Parameters

• evt: InteractionEventType

The normalized mouse event

• annotation: CircleROIAnnotation

The Annotation to check.

Returns

void

Inherited from

CircleROITool.toolSelectedCallback

Defined in

tools/src/tools/annotation/CircleROITool.ts:285

---

createAndAddAnnotation()

static createAndAddAnnotation(viewport, ...annotationBaseData): void

Creates and adds an annotation of the given type, firing the annotation modified event on the new annotation. This implicitly uses the static class when you call it on the correct base class. For example, you can call the KeyImageTool.createAnnotation method on KeyImageTool.toolName by calling KeyImageTool.createAndAddAnnotation

Parameters

• viewport: any

• ...annotationBaseData: any[]

Returns

void

Inherited from

CircleROITool.createAndAddAnnotation

Defined in

tools/src/tools/base/AnnotationTool.ts:97

---

createAnnotation()

static createAnnotation(...annotationBaseData): Annotation

Creates a base annotation object, adding in any annotation base data provided

Parameters

• ...annotationBaseData: any[]

Returns

Annotation

Inherited from

CircleROITool.createAnnotation

Defined in

tools/src/tools/base/AnnotationTool.ts:45

---

createAnnotationForViewport()

static createAnnotationForViewport(viewport, ...annotationBaseData): Annotation

Creates a new annotation for the given viewport. This just adds the viewport reference data to the metadata, and otherwise returns the static class createAnnotation data.

Parameters

• viewport: any

• ...annotationBaseData: any[]

Returns

Annotation

Inherited from

CircleROITool.createAnnotationForViewport

Defined in

tools/src/tools/base/AnnotationTool.ts:82