alpha.beta.ion.sequence: Evaluation of ion alpha and beta LQ parameters

View source: R/biological-functions.R

alpha.beta.ion.sequenceR Documentation

Evaluation of ion alpha and beta LQ parameters

Description

The evaluation is performed for a monoenergetic ion. It uses a C++ implementation for the evaluation. It accepts a sequence of parameters and ion specifications stored in an input data.frame.

Usage

alpha.beta.ion.sequence(model = "MKM", parameters = data.frame(cell =
  "test", alpha0 = 0.1295, beta0 = 0.03085, rN = 4, rd = 0.31, particle =
  "H", energy = 50, let = NULL), calculusType = "rapidMKM",
  precision = 0.5, ignore.stdout = TRUE, ignore.stderr = TRUE,
  remove.temp.files = TRUE)

Arguments

model

the name of the model (options: 'MKM', 'LEMI', 'LEMII', 'LEMIII')

parameters

input data.frame containing the cell name (column 'cell', optional) "biological" parameters associated to a specific biological tissue/model, and the specification of the primary particles (ion type and energy and/or LET). All the parameters have to be put in a dataframe. Each row of the dataframe represent the irradiation of a specific tissue/model with a specific particle. In the case of the MKM the biological parameters

  • alpha0 LQ alpha parameter of the reference radiation [Gy^-1]

  • beta0 LQ beta parameter of the reference radiation [Gy^-2]

  • rN cell nucleus radius [um]

  • rd domain radius [um]

In the case of LEMI, LEMII, LEMIII:

  • alpha0 LQ alpha parameter of the reference radiation [Gy^-1]

  • beta0 LQ beta parameter of the reference radiation [Gy^-2]

  • rN cell nucleus radius [um]

  • Dt threshold dose [Gy]

The ion is specified with the columns:

  • particle ion type: 'H', 'He', 'Li', 'Be', 'B', 'C', 'N', 'O', 'F' or 'Ne'

  • energy Energy of the particle in MeV/u

  • let LET of the particle in keV/um. It is used only if the energy is not specified.

#' @family LEM/MKM Models

calculusType

the type of the evaluations options are:

  • rapidKase implementation of MKM as described in (Kase2008)

  • rapidMKM more correct implementation for the MKM from the one described in (Kase2008)

  • newMKMKase "rapidKase" implementation + non poissionian correction for beta

  • newMKM "rapidMKM" implementation + non poissionian correction for beta

  • rapidScholz fast implementation of the LEMI, LEMII, LEMIII (Scholz2000)

  • rapidRusso fast implementation of the LEMI, LEMII, LEMIII, more accurate than the rapidScholz (Russo2010)

  • slow_alphaIon_betaIon slow Monte Carlo evaluation (compatible with MKM, LEMI, LEMII and LEMIII).


planit-group/Rplanit documentation built on Dec. 5, 2022, 11:10 p.m.