Manages configuration of easyCHAMP, including labpresets — easyCHAMP.config.helper • easyCHAMP

Most settings of easyCHAMP can be overwritten by a labpreset. If a labpreset is selected, it might overwrite or not overwrite the current function settings. To manage which settings will be chosen and which not (depending on NAs in labpreset), this function handles the configuration with labpresets correctly and returns a config data frame. This function is thought to ensure correct configuration and to simplify changes and maintenance, as well as improving testing.

Usage

easyCHAMP.config.helper(
  labpreset,
  blankKey,
  sep,
  dec,
  colPol,
  colL,
  colReqPol,
  ReqPolKey,
  colShape,
  colCol,
  colLFib,
  colArea,
  colWidth,
  fibre,
  sphere,
  fragment,
  pixel,
  startrow
)

Arguments

labpreset: A preset for most of the parameters (except: path, polymers, dataReturn, eocsum). Can be requested by other labs, to be implemented, that they don't have to be set manually all the time.
blankKey: The key word to distinguish blanks from other measurements/samples. It is case sensitive to prevent accidental matching. Defaults to "Blank".
sep: Symbol in your csv files indicating new a column. Defaults to ';'.
dec: Symbol in your csv files indicating decimal sign. Defaults to ','.
colPol: Column number where the polymer type is stated. In the TOEKI lab this is column 6 (Class Name). The polymer names (or abbreviations) can be set manually in 'polymers' in case the default does not apply. Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colL: Column number for the particle length. In the TOEKI lab this is column 17 (Length 5µ). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colReqPol: Column number for the particle check, whether the particle is a polymer or not. In the TOEKI lab this is column 24 (Plastik? or Plastik ja/nein). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d). If no curing took place, this parameter could be set to 'none' which will cause the function to simply use all particles in the file. Warning: this might cause further warnings or errors to occur, if a polymer is not an unknown substance (e.g., it is no polymer).
ReqPolKey: key word or sentence of 'colReqPol' that indicates that it is a plastic particle. Default is 'ja'.
colShape: Column number for the particle shape. In the TOEKI lab this is column 25 (Form). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colCol: Column number for the particle color In the TOEKI lab this is column 26 (Farbe). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colLFib: Column number for the particle length in case of a fibre with corrected length (because of curvy shape) In the TOEKI lab this is column 27 (Länge). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colArea: Column number for the particle length in case of a fibre with corrected length (because of curvy shape) In the TOEKI lab this is column 4 (Area µm²). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
colWidth: Column number for the particle length in case of a fibre with corrected length (because of curvy shape) In the TOEKI lab this is column 18 (Width µm). Could also be provided as column name, but only in ASCII encoding (e.g., special character as . and ä = d).
fibre: How fibres are called in colShape (Form). In the TOEKI lab it is 'Faser'.
sphere: How spheres are called in colShape (Form). In the TOEKI lab it is 'Kugel'.
fragment: How fragments are called in colShape (Form). In the TOEKI lab it is 'Fragment'.
pixel: How pixels are called in colShape (Form). In the TOEKI lab it is 'Pixel'.
startrow: Number of rows that can be omitted from the *.csv files. Usually preprocessing software provides a bunch of meta data, that are not of interest here. Usually 40 rows can be skipped (more or less - 0 in case of siMPle). This is automated now. However, automation can be disabled if a value is defined (e.g., for troubleshooting).