Object to interact with the 3D ROI Operator when it is active. More...

Public Slots
void	addLayer (string name, bool hidden=false, int alphaSlice=127)
	Adds a new layer to the end of the current layer list. More...

void	editLayer (int id, string name, bool hidden=false, int alphaSlice=127)
	Edits various layer properties such as name, alpha. More...

void	deleteLayer (int id=-1, int target=-1, int targetMovePolicy=ROIObject::respectImmutable)
	Removes a layer from the list of layers and reassigns all its ROIs. More...

void	deleteLayerToROI (int id, int targetROI, int targetLayer, int targetMovePolicy=ROIObject::respectImmutable)
	Removes a layer from the list of layers and reassigns all its ROIs. More...

void	deleteLayers (Array< int > indices, int target=-1, int targetMovePolicy=ROIObject::respectImmutable)
	Delete multiple layers. More...

void	clearLayer (int id=-1)
	Reassigns all ROIs of a layer. More...

void	clearLayers (Array< int > indices)
	Clears multiple layers. More...

void	addROI (string name, string colorName, bool immutable=false, bool hidden=false, int alphaSlice=127, int alphaSurface=255)
	Adds a new ROI to the end of the current ROI list on the current active layer. More...

void	addROI (int layerID, string name, string colorName, bool immutable=false, bool hidden=false, int alphaSlice=127, int alphaSurface=255)
	Adds a new ROI to the end of the current ROI list on the specified layer. More...

void	editROI (int id, string name, string colorName, bool immutable=false, bool hidden=false, int alphaSlice=127, int alphaSurface=255, string layer="")
	Edits various ROI properties such as name, color on the current active layer. More...

void	editROI (int layerID, int id, string name, string colorName, bool immutable=false, bool hidden=false, int alphaSlice=127, int alphaSurface=255, string layer="")
	Edits various ROI properties such as name, color on the specified layer. More...

void	deleteROI (int id=-1, int targetROI=-1, int targetLayer=-1, int movePolicy=ROIObject::respectImmutable)
	Removes an ROI from the ROI list and reassigns all its voxels. More...

void	clearROI (int id=-1, int targetROI=-1, int targetLayer=-1, int movePolicy=ROIObject::respectImmutable)
	Reassigns all voxels of an ROI. More...

void	clearAll ()
	Reassigns the voxels of every ROI to the background.

void	clearAllROIs ()
	Deletes all ROIs and removes them from the ROI List.

void	exportTable (string filename="", bool openFile=true)
	Exports a table of selected metrics for ROIs; e.g. Volume, Sum. More...

void	showTable (bool quick=false)
	Displays a table of selected metrics for ROIs that have been created; e.g. Volume, Sum. More...

void	showHistogram ()
	Displays histogram GUI that depicts signal intensity of a given selected ROI.

void	saveROI (string filename, string compression="RLE")
	Save an ROI to Disk. More...

void	saveLayer (string filename, int layerID=-1, string compression="RLE")
	Save an ROI Layer to Disk. More...

bool	saveROIsAsRTSTRUCT (string filename, bool quiet=false)
	Saves all ROIs in an RTSTRUCT DICOM. The DICOM will be defined with respect to the currently loaded reference image. More...

void	setSortContourImportByVolume (bool sortByVolume)
	Sets whether ROIs imported from an RTSTRUCT file are sorted by volume. More...

void	deleteROIs (Array< int > indices, int targetROI=-1, int targetLayer=-1, int movePolicy=ROIObject::respectImmutable)
	Delete multiple ROIs. More...

void	clearROIs (Array< int > indices, int targetROI=-1, int targetLayer=-1, int movePolicy=ROIObject::respectImmutable)
	Clears multiple ROIs. More...

void	exportROIs (Array< int > exportROIs)
	Exports an ROI (or group of ROIs) as a Volume in the Data Manager. More...

void	toggleHidden (Array< int > indices)
	Toggles the hidden attribute of ROI(s) More...

void	toggleImmutable (Array< int > indices)
	Toggles the immutable attribute of ROI(s) More...

void	cutROI (bool bg, bool quiet=false, Array< Index > list=Array< Index >())
	Removes regions of the volumes. More...

void	submitROI (bool quiet=false, bool allMetric=false)
	Submit the ROIs to the associated data on the iPACS. More...

void	submitROIAsRTSTRUCTNotQuiet ()
	Submit the ROIs as RTSTRUCT to the associated data on the iPACS. If it is possible to use the coordinate space of the original image before resampling and quiet is false, the user will be asked their preference. More...

void	submitLayer (bool quiet=false, bool allMetric=false, int layerID=-1)
	Submit the ROIs of the specified layer to the associated data on the iPACS. More...

void	loadROIFromIPACS (bool quiet=false)
	Download the ROIs from associated data on the iPACS. More...

void	loadLayerFromIPACS (bool quiet=false, int layerID=-1)
	Download the ROIs into the specified layer from the associated data on the iPACS. More...

void	loadRTStructureAsROI (string filename)
	Use DicomReader to load an ROI in the RT Structure Set format specified by the Dicom standard and used by the Siemens IRW. More...

void	loadVOIAsROI (string filename)
	Support for PMOD region of interest files. More...

void	kMeansManualSeedCluster (string kmeans)
	a helper function to set the seed mean value for manual k-means segmentation More...

void	copyLayerToClipboard ()

void	pasteROIFromClipboard (bool quite=false)

Public Member Functions
void	loadROI (string filename)
	Loads a .rmha file from disk into the 3D ROI Operator. More...

void	loadLayer (string filename, int layerID=-1)
	Loads a .rmha file from disk into the 3D ROI Operator. More...

string	getROICenterOfMass (unsigned char id)
	Returns the geometric center of mass of an ROI. More...

double	getROIVolume (unsigned char id)
	Returns the volume of a ROI. More...

double	get2DROIVolumeEstimation (unsigned char id, unsigned char planeId, unsigned int px1, unsigned int py1, unsigned int px2, unsigned int py2, unsigned int sections=20)
	Returns the Modified Simpson's approach for volume estimation of a 2D ROI on a given plane. More...

Array< int >	getROIContourPoints (unsigned char id, unsigned char planeId)
	Returns the outline points of an ROI on the current slice of a given plane. More...

Array< string >	getSplinePath (int id, bool interpolated=false)
	Returns the current spline points when using the spline tool. More...

void	setSplinePath (int id, Array< string > list, bool closed=false)
	Sets spline points in the spline tool. More...

bool	canSaveRTSTRUCTAsOriginal ()
	Returns whether or not the image's original voxel sizes can be used when saving RTSTRUCTs. More...

int	numROIs ()
	Returns the number of ROIs in the current layer. More...

int	numTotalROIs ()
	Returns the number of ROIs currently in the operator (all layers) More...

int	numLayers ()
	Returns the number of layers currently in the operator. More...

Array< string >	getROIDetails (int i)
	Returns various details regarding the display of an ROI. More...

Array< string >	getLayerDetails (int i)
	Returns various details regarding the display of a layer. More...

void	setInputROI (int roiIdx)
	Sets the input ROI for the Segmentation Tools. More...

void	setInputROI (int layerId, int roiIdx)
	Sets the input ROI for the Segmentation Tools. More...

void	setCurrentROI (int i)
	Sets the currently selected ROI in the 3D ROI Operator. More...

void	setCurrentLayer (int i)
	Sets the currently selected layer in the 3D ROI Operator. More...

void	submitROIAsRTSTRUCT (bool quiet=false, bool allMetric=false)
	Submit the ROIs as RTSTRUCT to the associated data on the iPACS. More...

Protected Member Functions
void	setROIViewMode (string mode)
	Set ROI painting mode. More...

void	drawSphere (int x, int y, int z, float radius, int roi_id, bool updateDisplay=true)
	Draws a ROI sphere at a given point. More...

void	drawCircle (int plane, int x, int y, int z, float radius, int roi_id, bool updateDisplay=true)
	Draws a ROI circle at a given point. More...

void	drawCube (int x, int y, int z, float radius, int roi_id, bool updateDisplay=true)
	Draws a ROI cube at a given point. More...

void	drawRect (int plane, int x, int y, int z, float radius, int roi_id, bool updateDisplay=true)
	Draws a ROI square at a given point. More...

void	drawCylinder (int plane, int x, int y, int z, float radius, float height, int roi_id, bool updateDisplay=true)
	Draws a ROI square at a given point. More...

void	resizeROI (int layerID=-1)

Detailed Description

Object to interact with the 3D ROI Operator when it is active.

This object can be used to interact with Regions Of Interest (ROIs) when the 3D ROI Tool Operator is loaded.

ROIs are index starting with the background at 0 See also ScriptMaster::currentOp() to obtain this object and MainWin::setViewMode() to enter the 3D ROI Operator

Member Function Documentation

◆ addLayer

void addLayer	(	string	name,
		bool	hidden = `false`,
		int	alphaSlice = `127`
	)

slot

Adds a new layer to the end of the current layer list.

Parameters

name	Name of the layer
hidden	Hide the layer or not
alphaSlice	Alpha of the layer in the slice view (0-255)

◆ addROI [1/2]

void addROI	(	int	layerID,
		string	name,
		string	colorName,
		bool	immutable = `false`,
		bool	hidden = `false`,
		int	alphaSlice = `127`,
		int	alphaSurface = `255`
	)

slot

Adds a new ROI to the end of the current ROI list on the specified layer.

Parameters

layerID	the layer to which the ROI should be added to
name	Name of the ROI
colorName	Color of the ROI.
immutable	Make the ROI Immutable or not
hidden	Hide the ROI or not
alphaSlice	Alpha of the ROI in the slice view (0-255)
alphaSurface	Alpha of the ROI in the VTK viewer (0-255)

Note: Available colors can be found here: http://www.w3.org/TR/SVG/types.html#ColorKeywords

◆ addROI [2/2]

void addROI	(	string	name,
		string	colorName,
		bool	immutable = `false`,
		bool	hidden = `false`,
		int	alphaSlice = `127`,
		int	alphaSurface = `255`
	)

slot

Adds a new ROI to the end of the current ROI list on the current active layer.

Parameters

name	Name of the ROI
colorName	Color of the ROI.
immutable	Make the ROI Immutable or not
hidden	Hide the ROI or not
alphaSlice	Alpha of the ROI in the slice view (0-255)
alphaSurface	Alpha of the ROI in the VTK viewer (0-255)

Note: Available colors can be found here: http://www.w3.org/TR/SVG/types.html#ColorKeywords

◆ canSaveRTSTRUCTAsOriginal()

bool canSaveRTSTRUCTAsOriginal ( )

Returns whether or not the image's original voxel sizes can be used when saving RTSTRUCTs.

Returns: Whether or not the current ROIs can be saved in the RTSTRUCT format in the coordinate system of the image before it was resampled

◆ clearLayer

void clearLayer ( int id = -1 )

slot

Reassigns all ROIs of a layer.

Parameters

id	Index of layer to clear

Note: layer id stays in the layer list

◆ clearLayers

void clearLayers ( Array< int > indices )

slot

Clears multiple layers.

Parameters

indices Array of indicies to clear

◆ clearROI

void clearROI	(	int	id = `-1`,
		int	targetROI = `-1`,
		int	targetLayer = `-1`,
		int	movePolicy = `ROIObject::respectImmutable`
	)

slot

Reassigns all voxels of an ROI.

Parameters

id	Index of ROI to clear
targetROI	Index of ROI to recieve id's voxels
targetLayer	Index of layer to recieve id's voxels

Note: ROI id stays in the ROI list

◆ clearROIs

void clearROIs	(	Array< int >	indices,
		int	targetROI = `-1`,
		int	targetLayer = `-1`,
		int	movePolicy = `ROIObject::respectImmutable`
	)

slot

Clears multiple ROIs.

Parameters

indices	Array of indicies to clear
targetROI	Destination ROI for voxels in indicies
targetLayer	Destination layer for voxels in indicies

◆ copyLayerToClipboard

void copyLayerToClipboard ( )

slot

Copy active layer to Clipboard. this function can be used to copy ROI between layers or VQ instances.

◆ cutROI

void cutROI	(	bool	bg,
		bool	quiet = `false`,
		Array< Index >	list = `Array< Index >()`
	)

slot

Removes regions of the volumes.

Parameters

bg	If true, removes all voxels in active volumes in the background ROI. If false, removes voxels in the current ROI
quiet	If true, does not give a warning

Note: Voxels in ACTIVE volumes are rest to the minimum value set in the cache. This should be equal to the global minimum of the volume but isn't always the case; A volume MUST active (ie "turned on") for voxels to be reset

◆ deleteLayer

void deleteLayer	(	int	id = `-1`,
		int	target = `-1`,
		int	targetMovePolicy = `ROIObject::respectImmutable`
	)

slot

Removes a layer from the list of layers and reassigns all its ROIs.

Parameters

id	Index of layer to delete
target	Index of layer to recieve id's from deleted ROIs
targetMovePolicy	is 0=replace, 1=no overwrite (keep target), 2=respect immutable status of target (default), 3=make new ROIs from overlap

◆ deleteLayers

void deleteLayers	(	Array< int >	indices,
		int	target = `-1`,
		int	targetMovePolicy = `ROIObject::respectImmutable`
	)

slot

Delete multiple layers.

Parameters

indices	Array of indicies to delete
target	Destination layer for voxels in indicies
targetMovePolicy	is 0=replace, 1=no overwrite (keep target), 2=respect immutable status of target (default), 3=make new ROIs from overlap

◆ deleteLayerToROI

void deleteLayerToROI	(	int	id,
		int	targetROI,
		int	targetLayer,
		int	targetMovePolicy = `ROIObject::respectImmutable`
	)

slot

Removes a layer from the list of layers and reassigns all its ROIs.

Parameters

id	Index of layer to delete
targetROI	Index of ROI to recieve id's from deleted ROIs
targetLayer	Index of layer to recieve id's
targetMovePolicy	is 0=replace, 1=no overwrite (keep target), 2=respect immutable status of target (default), 3=make new ROIs from overlap

◆ deleteROI

void deleteROI	(	int	id = `-1`,
		int	targetROI = `-1`,
		int	targetLayer = `-1`,
		int	movePolicy = `ROIObject::respectImmutable`
	)

slot

Removes an ROI from the ROI list and reassigns all its voxels.

Parameters

id	Index of an ROI in the current layer to delete
targetROI	Index of an ROI to recieve id's voxels
targetLayer	Index of the layer of the target ROI

◆ deleteROIs

void deleteROIs	(	Array< int >	indices,
		int	targetROI = `-1`,
		int	targetLayer = `-1`,
		int	movePolicy = `ROIObject::respectImmutable`
	)

slot

Delete multiple ROIs.

Parameters

indices	Array of indicies to delete
targetROI	Destination ROI for voxels in indicies
targetLayer	Destination layer for voxels in indicies

◆ drawCircle()

void drawCircle	(	int	plane,
		int	x,
		int	y,
		int	z,
		float	radius,
		int	roi_id,
		bool	updateDisplay = `true`
	)

protected

Draws a ROI circle at a given point.

Parameters

plane	Plane in which to draw the circle (0=sagittal,1=coronal,2=transverse)
x	Coordinate in the X (sagittal) plane of center of circle
y	Coordinate in the Y (coronal) plane of center of circle
z	Coordinate in the Z (transverse) plane of center of circle
radius	Radius of the circle, in voxels
roi_id	Index of ROI to update
updateDisplay	If true, will immediately update the display to show the drawn ROI

Note: If making many (>10) drawing calls, it is recommended to turn off updateDisplay until the last iteration; (x,y,z) correspond to dimensions (0,1,2) as gotten by QSliceViewControl::getPos() or other View Controler functions

◆ drawCube()

void drawCube	(	int	x,
		int	y,
		int	z,
		float	radius,
		int	roi_id,
		bool	updateDisplay = `true`
	)

protected

Draws a ROI cube at a given point.

Parameters

x	Coordinate in the X (sagittal) plane of center of cube
y	Coordinate in the Y (coronal) plane of center of cube
z	Coordinate in the Z (transverse) plane of center of cube
radius	Radius of the cube, in voxels. Cube has sides of length 2*radius
roi_id	Index of ROI to update
updateDisplay	If true, will immediately update the display to show the drawn ROI

Note: If making many (>10) drawing calls, it is recommended to turn off updateDisplay until the last iteration; (x,y,z) correspond to dimensions (0,1,2) as gotten by QSliceViewControl::getPos() or other View Controler functions

◆ drawCylinder()

void drawCylinder	(	int	plane,
		int	x,
		int	y,
		int	z,
		float	radius,
		float	height,
		int	roi_id,
		bool	updateDisplay = `true`
	)

protected

Draws a ROI square at a given point.

Parameters

plane	Plane in which to draw the circle (0=sagittal,1=coronal,2=transverse)
x	Coordinate in the X (sagittal) plane of center of cylinder
y	Coordinate in the Y (coronal) plane of center of cylinder
z	Coordinate in the Z (transverse) plane of center of cylinder
radius	Radius of the cylinder, in voxels
height	Height of the cylinder. Height is extended to height/2 on either sides of the center point perpendicular to plane
roi_id	Index of ROI to update
updateDisplay	If true, will immediately update the display to show the drawn ROI

Note: If making many (>10) drawing calls, it is recommended to turn off updateDisplay until the last iteration; (x,y,z) correspond to dimensions (0,1,2) as gotten by QSliceViewControl::getPos() or other View Controler functions

◆ drawRect()

void drawRect	(	int	plane,
		int	x,
		int	y,
		int	z,
		float	radius,
		int	roi_id,
		bool	updateDisplay = `true`
	)

protected

Draws a ROI square at a given point.

Parameters

plane	Plane in which to draw the square (0=sagittal,1=coronal,2=transverse)
x	Coordinate in the X (sagittal) plane of center of square
y	Coordinate in the Y (coronal) plane of center of square
z	Coordinate in the Z (transverse) plane of center of square
radius	Radius of the square, in voxels (square has sides of length 2*radius)
roi_id	Index of ROI to update
updateDisplay	If true, will immediately update the display to show the drawn ROI

Note: If making many (>10) drawing calls, it is recommended to turn off updateDisplay until the last iteration; (x,y,z) correspond to dimensions (0,1,2) as gotten by QSliceViewControl::getPos() or other View Controler functions

◆ drawSphere()

void drawSphere	(	int	x,
		int	y,
		int	z,
		float	radius,
		int	roi_id,
		bool	updateDisplay = `true`
	)

protected

Draws a ROI sphere at a given point.

Parameters

x	Coordinate in the X (sagittal) plane of center of sphere
y	Coordinate in the Y (coronal) plane of center of sphere
z	Coordinate in the Z (transverse) plane of center of sphere
radius	Radius of the sphere, in voxels
roi_id	Index of ROI to update
updateDisplay	If true, will immediately update the display to show the drawn ROI

Note: If making many (>10) drawing calls, it is recommended to turn off updateDisplay until the last iteration; (x,y,z) correspond to dimensions (0,1,2) as gotten by QSliceViewControl::getPos() or other View Controler functions

◆ editLayer

void editLayer	(	int	id,
		string	name,
		bool	hidden = `false`,
		int	alphaSlice = `127`
	)

slot

Edits various layer properties such as name, alpha.

Parameters

id	Index of layer to edit
name	Name of the layer
hidden	Hide the layer or not
alphaSlice	Alpha of the ROI in the slice view (0-255)

◆ editROI [1/2]

void editROI	(	int	id,
		string	name,
		string	colorName,
		bool	immutable = `false`,
		bool	hidden = `false`,
		int	alphaSlice = `127`,
		int	alphaSurface = `255`,
		string	layer = `""`
	)

slot

Edits various ROI properties such as name, color on the current active layer.

Parameters

id	Index of ROI to edit
name	Name of the ROI
colorName	Color of the ROI.
immutable	Make the ROI Immutable or not
hidden	Hide the ROI or not
alphaSlice	Alpha of the ROI in the slice view (0-255)
alphaSurface	Alpha of the ROI in the VTK viewer (0-255)
layer	Name of the layer this ROI is moved to

Note: Available colors can be found here: http://www.w3.org/TR/SVG/types.html#ColorKeywords

◆ editROI [2/2]

void editROI	(	int	layerID,
		int	id,
		string	name,
		string	colorName,
		bool	immutable = `false`,
		bool	hidden = `false`,
		int	alphaSlice = `127`,
		int	alphaSurface = `255`,
		string	layer = `""`
	)

slot

Edits various ROI properties such as name, color on the specified layer.

Parameters

layerID	the layer to which the ROI is on
id	Index of ROI to edit
name	Name of the ROI
colorName	Color of the ROI.
immutable	Make the ROI Immutable or not
hidden	Hide the ROI or not
alphaSlice	Alpha of the ROI in the slice view (0-255)
alphaSurface	Alpha of the ROI in the VTK viewer (0-255)
layer	Name of the layer this ROI is moved to

Note: Available colors can be found here: http://www.w3.org/TR/SVG/types.html#ColorKeywords

◆ exportROIs

void exportROIs ( Array< int > exportROIs )

slot

Exports an ROI (or group of ROIs) as a Volume in the Data Manager.

Parameters

exportROIs Array of ROI indicies to export

Note: ROIs will be exported into a new volume and appended to the end of the data manager. The index number of each ROI will have that corresponding value for all its voxels

◆ exportTable

void exportTable	(	string	filename = `""`,
		bool	openFile = `true`
	)

slot

Exports a table of selected metrics for ROIs; e.g. Volume, Sum.

Parameters

filename Name of output file

◆ get2DROIVolumeEstimation()

double get2DROIVolumeEstimation	(	unsigned char	id,
		unsigned char	planeId,
		unsigned int	px1,
		unsigned int	py1,
		unsigned int	px2,
		unsigned int	py2,
		unsigned int	sections = `20`
	)

Returns the Modified Simpson's approach for volume estimation of a 2D ROI on a given plane.

Parameters

id	Index of ROI
planeId	(0 = sagittal, 1 = coronal, 2 = transverse)
p1	Long axis start point
p1	Long axis end point
sections	The number of sections along the long axis

Returns: The estimated volume

◆ getLayerDetails()

Array<string> getLayerDetails ( int i )

Returns various details regarding the display of a layer.

Parameters

i	Index of Layer to get details

Returns: A length 2 array containing the following information:; array[0]: Name of Layer; array[1]: Layer Alpha in the slice view (0-255: 0=transparent, 255=opaque)

◆ getROICenterOfMass()

string getROICenterOfMass ( unsigned char id )

Returns the geometric center of mass of an ROI.

Parameters

id	Index of ROI to load

Returns: String of containing the x,y, and z position of the center of mass of the ROI in the form "x,y,z"

◆ getROIContourPoints()

Array<int> getROIContourPoints	(	unsigned char	id,
		unsigned char	planeId
	)

Returns the outline points of an ROI on the current slice of a given plane.

Parameters

id	Index of ROI
planeId	(0 = sagittal, 1 = coronal, 2 = transverse)

Returns: String of (x,y) coordinates in the format "x1,y1,x2,y2..." in the planeID (on the current slice) where the outline of the ROI id exists)

◆ getROIDetails()

Array<string> getROIDetails ( int i )

Returns various details regarding the display of an ROI.

Parameters

i	Index of ROI to get details

Returns: A length 6 array containing the following information:; array[0]: Name of ROI; array[1]: ROI Color; array[2]: 0 if ROI is mutable, 1 if ROI is immutable; array[3]: 0 if ROI is visible, 1 if ROI is hidden; array[4]: ROI Alpha in the slice view (0-255: 0=transparent, 255=opaque); array[5]: ROI Alpha in the VTK Viewer (0-255: 0=transparent, 255=opaque)

◆ getROIVolume()

double getROIVolume ( unsigned char id )

Returns the volume of a ROI.

Parameters

id	Index of ROI

Returns: Double containing ROI volume (in mm^3)

◆ getSplinePath()

Array<string> getSplinePath	(	int	id,
		bool	interpolated = `false`
	)

Returns the current spline points when using the spline tool.

Parameters

id	Plane (0 = sagittal , 1 = conronal, 2 = transverse) to grab spline points
interpolated	If true, returns every point along interpolated (green) line. If false, returns just the clicked points

Returns: String of (x,y) coordinates in the format "x1,y1,x2,y2..."

◆ kMeansManualSeedCluster

void kMeansManualSeedCluster ( string kmeans )

slot

a helper function to set the seed mean value for manual k-means segmentation

Parameters

a	string that contains double values that split by ","

◆ loadLayer()

void loadLayer	(	string	filename,
		int	layerID = `-1`
	)

Loads a .rmha file from disk into the 3D ROI Operator.

Parameters

filename	Path to filename on disk
layerID	The layer index to load into (if not provided, the ROIs will be loaded in the active layer)

◆ loadLayerFromIPACS

void loadLayerFromIPACS	(	bool	quiet = `false`,
		int	layerID = `-1`
	)

slot

Download the ROIs into the specified layer from the associated data on the iPACS.

Parameters

quiet	If true, the most recent ROIs will be loaded and no dialog will be shown
layerID	The layer ID to download the ROIs to (if not specified, the active layer will be used)

◆ loadROI()

void loadROI ( string filename )

Loads a .rmha file from disk into the 3D ROI Operator.

Parameters

filename Path to filename on disk

◆ loadROIFromIPACS

void loadROIFromIPACS ( bool quiet = false )

slot

Download the ROIs from associated data on the iPACS.

Parameters

quiet If true, the most recent ROIs will be loaded and no dialog will be shown

◆ loadRTStructureAsROI

void loadRTStructureAsROI ( string filename )

slot

Use DicomReader to load an ROI in the RT Structure Set format specified by the Dicom standard and used by the Siemens IRW.

Parameters

filename path to an RTSTRUCT Dicom image.

◆ loadVOIAsROI

void loadVOIAsROI ( string filename )

slot

Support for PMOD region of interest files.

Parameters

filename Name of file

◆ numLayers()

int numLayers ( )

inline

Returns the number of layers currently in the operator.

Returns: Number of layers in the operator

◆ numROIs()

int numROIs ( )

inline

Returns the number of ROIs in the current layer.

Returns: Number of ROIs for the current layer

Note: Background is included so the function will never return less than 1

◆ numTotalROIs()

int numTotalROIs ( )

inline

Returns the number of ROIs currently in the operator (all layers)

Returns: The sum of the number of ROIs from all the Layers

Note: A Background ROI for each layer is included in the total

◆ pasteROIFromClipboard

void pasteROIFromClipboard ( bool quite = false )

slot

Paste ROIs from Clipbard to current active layer. this function can be used to copy ROI between layers or VQ instances.

Parameters

quiet If true, overlayed ROIs will be overwritten and no dialog will be shown.

◆ resizeROI()

void resizeROI ( int layerID = -1 )

protected

If the dimensions of the underlying ROI object do not match that of the reference image, resize and clear the ROI object and display a notification dialog

◆ saveLayer

void saveLayer	(	string	filename,
		int	layerID = `-1`,
		string	compression = `"RLE"`
	)

slot

Save an ROI Layer to Disk.

Parameters

filename	Local path to output (saved) rmha file
layerID	The layerID of the ROI to be saved
compression	Type of Compression to use (Use RLE in almost all cases)

◆ saveROI

void saveROI	(	string	filename,
		string	compression = `"RLE"`
	)

slot

Save an ROI to Disk.

Parameters

filename	Local path to output (saved) rmha file
compression	Type of Compression to use (Use RLE in almost all cases)

◆ saveROIsAsRTSTRUCT

bool saveROIsAsRTSTRUCT	(	string	filename,
		bool	quiet = `false`
	)

slot

Saves all ROIs in an RTSTRUCT DICOM. The DICOM will be defined with respect to the currently loaded reference image.

Parameters

filename	Local path to output (saved) RTSTRUCT DICOM
quiet	If true, warning dialogs will not be displayed (but warnings will still be printed to the logs)

Returns: Whether or not creating the RTSTRUCT was successful

◆ setCurrentLayer()

void setCurrentLayer ( int i )

inline

Sets the currently selected layer in the 3D ROI Operator.

Parameters

i	Index of the layer to set as Current

◆ setCurrentROI()

void setCurrentROI ( int i )

inline

Sets the currently selected ROI in the 3D ROI Operator.

Parameters

i	Index of the ROI to set as Current

◆ setInputROI() [1/2]

void setInputROI	(	int	layerId,
		int	roiIdx
	)

Sets the input ROI for the Segmentation Tools.

Parameters

i	Index of layer to set as Input
i	Index of ROI to set as Input

◆ setInputROI() [2/2]

void setInputROI ( int roiIdx )

Sets the input ROI for the Segmentation Tools.

Parameters

i	Index of ROI from the current active layer to set as Input

◆ setROIViewMode()

void setROIViewMode ( string mode )

protected

Set ROI painting mode.

Parameters

mode	Paint mode name, should be "All Layer", "All ROI", "Current Layer", "Outline"

◆ setSortContourImportByVolume

void setSortContourImportByVolume ( bool sortByVolume )

slot

Sets whether ROIs imported from an RTSTRUCT file are sorted by volume.

Parameters

sortByVolume If true, sorts ROIs imported from an RTSTRUCT by volume. If false, preserves the order they appear in the RTSTRUCT file (except for overlaps)

◆ setSplinePath()

void setSplinePath	(	int	id,
		Array< string >	list,
		bool	closed = `false`
	)

Sets spline points in the spline tool.

Parameters

id	Index of ROI
list	Array in the form [x1,y1,x2,y2,...] denoting the points of the spline
closed	if True, will complete the spline interpolation

◆ showTable

void showTable ( bool quick = false )

slot

Displays a table of selected metrics for ROIs that have been created; e.g. Volume, Sum.

Parameters

quick If true will automatically display a table of metrics; default = false

◆ submitLayer

void submitLayer	(	bool	quiet = `false`,
		bool	allMetric = `false`,
		int	layerID = `-1`
	)

slot

Submit the ROIs of the specified layer to the associated data on the iPACS.

Parameters

quiet	If true, no setting dialog is shown and latest saving parameters are used
allMetric	if true, force to save all the quantification metrics
layerID	The layer ID to save the ROIs from (if not specified, the active layer will be used)

◆ submitROI

void submitROI	(	bool	quiet = `false`,
		bool	allMetric = `false`
	)

slot

Submit the ROIs to the associated data on the iPACS.

Parameters

quiet	If true, no setting dialog is shown and latest saving parameters are used
allMetric	If true, force to save all the quantification metrics

◆ submitROIAsRTSTRUCT()

void submitROIAsRTSTRUCT	(	bool	quiet = `false`,
		bool	allMetric = `false`
	)

Submit the ROIs as RTSTRUCT to the associated data on the iPACS.

Parameters

quiet	If true, no setting dialog is shown and latest saving parameters are used
allMetric	If true, force to save all the quantification metrics image before any resampling that was done in VQ

◆ submitROIAsRTSTRUCTNotQuiet

void submitROIAsRTSTRUCTNotQuiet ( )

slot

Submit the ROIs as RTSTRUCT to the associated data on the iPACS. If it is possible to use the coordinate space of the original image before resampling and quiet is false, the user will be asked their preference.

Parameters

allMetric If true, force to save all the quantification metrics

◆ toggleHidden

void toggleHidden ( Array< int > indices )

slot

Toggles the hidden attribute of ROI(s)

Parameters

indices Array of ROI indicies to toggle

◆ toggleImmutable

void toggleImmutable ( Array< int > indices )

slot

Toggles the immutable attribute of ROI(s)

Parameters

indices Array of ROI indicies to toggle

Public Slots

Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ addLayer

◆ addROI [1/2]

◆ addROI [2/2]

◆ canSaveRTSTRUCTAsOriginal()

◆ clearLayer

◆ clearLayers

◆ clearROI

◆ clearROIs

◆ copyLayerToClipboard

◆ cutROI

◆ deleteLayer

◆ deleteLayers

◆ deleteLayerToROI

◆ deleteROI

◆ deleteROIs

◆ drawCircle()

◆ drawCube()

◆ drawCylinder()

◆ drawRect()

◆ drawSphere()

◆ editLayer

◆ editROI [1/2]

◆ editROI [2/2]

◆ exportROIs

◆ exportTable

◆ get2DROIVolumeEstimation()

◆ getLayerDetails()

◆ getROICenterOfMass()

◆ getROIContourPoints()

◆ getROIDetails()

◆ getROIVolume()

◆ getSplinePath()

◆ kMeansManualSeedCluster

◆ loadLayer()

◆ loadLayerFromIPACS

◆ loadROI()

◆ loadROIFromIPACS

◆ loadRTStructureAsROI

◆ loadVOIAsROI

◆ numLayers()

◆ numROIs()

◆ numTotalROIs()

◆ pasteROIFromClipboard

◆ resizeROI()

◆ saveLayer

◆ saveROI

◆ saveROIsAsRTSTRUCT

◆ setCurrentLayer()

◆ setCurrentROI()

◆ setInputROI() [1/2]

◆ setInputROI() [2/2]

◆ setROIViewMode()

◆ setSortContourImportByVolume

◆ setSplinePath()

◆ showTable

◆ submitLayer

◆ submitROI

◆ submitROIAsRTSTRUCT()

◆ submitROIAsRTSTRUCTNotQuiet

◆ toggleHidden

◆ toggleImmutable