Skip to contents

Import and process antimicrobial phenotype data exported from MicroScan instruments

Source: R/import_pheno.R
import_microscan_pheno.Rd

This function imports antimicrobial susceptibility testing (AST) data from MicroScan instrument output files (wide CSV format) and converts it to the standardised long-format used by AMRgen. Supports English, Spanish, French, German, and Portuguese column names (auto-detected from metadata columns).

Usage

import_microscan_pheno(
  input,
  sample_col = NULL,
  source = NULL,
  species = NULL,
  ab = NULL,
  instrument_guideline = NULL,
  interpret_eucast = FALSE,
  interpret_clsi = FALSE,
  interpret_ecoff = FALSE
)

Arguments

input

A dataframe or path to a CSV/TSV file containing MicroScan AST output data

sample_col

String indicating the name of the column containing sample identifiers. Default: "Lab ID"

source

Optional string value to record in the source column for all data points (e.g., dataset name or study identifier)

species

Optional string indicating a single species to use for phenotype interpretation (otherwise this is inferred per-sample from the input)

ab

Optional string indicating a single antibiotic to use for phenotype interpretation (otherwise this is inferred per-sample from the input)

instrument_guideline

Optional string indicating the guideline used by the instrument for SIR interpretation (e.g., "EUCAST 2025", "CLSI 2025"), used to record the guideline in the output file. Default: NULL

interpret_eucast

A logical value (default is FALSE). If TRUE, the function will re-interpret the susceptibility phenotype (SIR) for each observation based on the MIC values, against EUCAST human breakpoints. These will be reported in a new column pheno_eucast, of class sir.

interpret_clsi

A logical value (default is FALSE). If TRUE, the function will re-interpret the susceptibility phenotype (SIR) for each observation based on the MIC values, against CLSI human breakpoints. These will be reported in a new column pheno_clsi, of class sir.

interpret_ecoff

A logical value (default is FALSE). If TRUE, the function will re-interpret the wildtype vs nonwildtype status for each observation based on the MIC values, against epidemiological cut-off (ECOFF) values. These will be reported in a new column ecoff, of class sir and coded as NWT (nonwildtype) or WT (wildtype).

Value

Standardised AST data frame