# Histogram according to a binary The `histo.from.bin` function computes the voxels histogram of the selection defined by the binary object `sel.bin` of a "volume" class object. ```r histo.from.bin(vol, sel.bin, breaks = NULL, alias = "", description = NULL) ``` ## Arguments - `vol`: "volume" class object - `sel.bin`: "volume" class object, of `binary` modality - `breaks`: Vector giving the breakpoints between histogram cells. If `breaks = NULL`, the chosen breakpoints are those used by the hist function by default. If `breaks` are specified, outside values of `vol$vol3D.data` are not taken into account. - `alias`: Character string, `$alias` of the created object - `description`: Character string, describing the the created object. If the `description = NULL` (default value),it will be set to `vol$description` ## Returns Returns a "histo" class object. See histo.vol . ## Examples ```r # loading of toy-patient objects (decrease dxyz for better result) step <- 5 patient <- toy.load.patient (modality = c("ct","rtstruct"), roi.name = "", dxyz = rep (step, 3)) bin.patient <- bin.from.roi (patient$ct[[1]], struct = patient$rtstruct[[1]], roi.name = "patient", verbose = FALSE) # ct histogram in patient volume H <- histo.from.bin (patient$ct[[1]], sel.bin = bin.patient, breaks = NULL, alias = "patient_hist") str(H) ## Not run: # Skin dose histogram patient <- toy.load.patient (modality = c("rtdose", "rtstruct"), roi.name = "", dxyz = c (2, 2, 2), beam.nb = 3) D <- patient$rtdose[[1]] S <- patient$rtstruct[[1]] # Creation of the skin contour of 3 mm bin.patient <- bin.from.roi (D, struct = S, roi.name = "patient", alias = "patient", verbose = FALSE) inverse.patient <- bin.inversion (bin.patient, alias = "inv (patient)") expansion <- bin.dilation (inverse.patient, radius = 3, alias = "inv (patient) + 3") contour.3mm <- bin.intersection (bin.patient, expansion, alias = "contour 3 mm") # Dose histogram in this volume H <- histo.from.bin (D, sel.bin = contour.3mm, breaks = NULL, alias = "Skin dose") str(H) ## End(Not run) ``` ## See Also histo.from.roi , histo.vol , display.histo , display.dV_dx

histo.from.bin function