display.obj.links: Display patient objects links

In espadon: Easy Study of Patient DICOM Data in Oncology

Display patient objects links

Description

The display.obj.links function displays a graph of connections between objects of a patient. The name of the objects corresponds to their modality (ct, mr, rtdose...) followed by their position in their respective lists in the patient list objects. Connected objects are linked by arrows. Objects sharing the same frame of reference have the same color except for objects with warnings, errors or missing planes which are all in grey. Approved objects are circled in green. By default, objects shapes are circles, except rtdose represented as squares.

Usage

display.obj.links(
  pat,
  obj.selected = NULL,
  exclusion = NULL,
  square = "rtdose",
  group.by.connected.FoR = TRUE,
  interactive = FALSE,
  random.seed = 314
)

Arguments

pat	"patient" class object, as loaded using load.patient.from.dicom, load.patient.from.Rdcm or toy.load.patient.
obj.selected	Dataframe (default to NULL) containing the objects already selected, created by a previous call of display.obj.links for example.
exclusion	Vector of patient file modalities that should not be displayed, as for instance "mr"...
square	Vector of patient file modalities that should be enclosed by a square, as for instance c ("ct", "mr")... If NULL no object name is squared.
group.by.connected.FoR	Boolean. If TRUE (default), all objects sharing the same frame of reference or connected by a registration matrix have the same color. If group.by.connected.FoR =FALSE, only objects sharing the same FoR have the same color.
interactive	Boolean. If interactive = TRUE, buttons are available on the graph to get information about the objects and select or remove them from the data frame of the selected objects. Then simply click on the name of the object on which to apply the chosen action. If interactive = FALSE no interaction possible with the plot.
random.seed	Positive Integer or NULL. If random.seed = NULL, the objects are laid out randomly. The layout is otherwise fixed.

Value

The function displays all patient objects, linked by an arrow when they are connected or a line when they belongs to the same DICOM object, and with a color and a shape depending on square, group.by.connected.FoR.

When interactive = TRUE, it returns a dataframe of the selected objects, or NULL if no object is selected.

Items are circled in green when the DICOM file has been approved. They are circled in red, when the DICOM series is incomplete (e.g. missing plan).

See Also

get.obj.connection

Examples

# loading of toy-patient objects
patient <- toy.load.patient (dxyz = c (5, 5, 5), beam.nb = 1)
display.obj.links (patient, group.by.connected.FoR = FALSE)
display.obj.links (patient, group.by.connected.FoR = TRUE)
display.obj.links (patient, group.by.connected.FoR = TRUE, random.seed=NULL)

espadon documentation built on April 11, 2025, 5:57 p.m.