radiomics_all: Calculates all radiomic statistics on supplied RIA_image

View source: R/radiomics_all.R

radiomics_allR Documentation

Calculates all radiomic statistics on supplied RIA_image

Description

Calculates specified radiomic statistics on RIA_image. Parameters of radiomic functions may be set. By default the the images are discretized to 8, 16 and 32 bins using equally sized and probable binning. First-order statistics are calculated on the original image and if asked then on all discretizations. Symmetric GLCMs are calculated for all directions at a distance of 1 for all discretizations. GLRLMs are also calculated for all discretizations. Geometry-based statistics are calculated for the original image as well as all discretizations is requested.

Usage

radiomics_all(
  RIA_data_in,
  bins_in = c(8, 16, 32),
  equal_prob = "both",
  fo_discretized = FALSE,
  distance = c(1),
  statistic = "mean(X, na.rm = TRUE)",
  geometry_discretized = TRUE,
  verbose_in = TRUE
)

Arguments

RIA_data_in

RIA_image.

bins_in

integer vector, number of bins specified.

equal_prob

logical or string, indicating to cut data into bins with equal relative frequencies. If FALSE, then equal interval bins will be used. If "both" is supplied, the both equally probable and equal interval bins will be created.

fo_discretized

logical, indicating whether to calculate first-order statistics on discretized images.

distance

integer, distance between the voxels being compared.

statistic

string, defining the statistic to be calculated on the array of GLCM statistics. By default, statistic is set to "mean", however any function may be provided. The proper syntax is: function(X, attributes). The supplied string must contain a "X", which will be replaced with the array of the GLCM statistics value. Further attributes of the function may also be given. For example, if you wish to calculate the median of all GLCMs calculated in different directions, then it must be supplied as: median(X, na.rm = TRUE).

geometry_discretized

logical, indicating whether to calculate geometry-based statistics on discretized images.

verbose_in

logical, indicating whether to print detailed information. Most prints can also be suppressed using the suppressMessages function.

Value

RIA_image containing the statistical information.

References

Márton KOLOSSVÁRY et al. Radiomic Features Are Superior to Conventional Quantitative Computed Tomographic Metrics to Identify Coronary Plaques With Napkin-Ring Sign Circulation: Cardiovascular Imaging (2017). DOI: 10.1161/circimaging.117.006843 https://pubmed.ncbi.nlm.nih.gov/29233836/

Márton KOLOSSVÁRY et al. Cardiac Computed Tomography Radiomics: A Comprehensive Review on Radiomic Techniques. Journal of Thoracic Imaging (2018). DOI: 10.1097/RTI.0000000000000268 https://pubmed.ncbi.nlm.nih.gov/28346329/

Examples

## Not run: 
#Discretize loaded image and then calculate all radiomic statistics
RIA_image <- radiomics_all(RIA_image, equal_prob = "both", bins_in= c(32,64), distance = c(1:2))

## End(Not run)


RIA documentation built on May 31, 2023, 7 p.m.