Learn R Programming

FastRet

FastRet is an R package for predicting retention times in liquid chromatography. It can be used through the R console or through a graphical user interface (GUI). The package's key features include the ability to

  1. Train new predictive models specific for your own chromatography column
  2. Use pre-trained models to predict retention times of molecules
  3. Adjust pre-trained models to accommodate modifications in chromatography columns

Installation

You can install the development version of FastRet from GitHub by entering the following commands in an R session:

if (Sys.which("java")[1] == "") stop("Please install a Java SDK first.")
install.packages("pak")
pak::pkg_install("spang-lab/FastRet")

For further details see Installation.

Usage

The easiest way to use FastRet is through its GUI. To start the GUI, install the package and then run the following command in an interactive R terminal:

FastRet::start_gui()

After running the above code, you should see an output like

Listening on http://localhost:8080

in your R console. This means that the GUI is now running and you can access it via the URL http://localhost:8080 in your browser. If your terminal supports it, you can also just click on the displayed link.

By default, the GUI opens in Mode Train new Model. To apply or adjust pretrained models, select mode Predict Retention Time or Adjust existing Model instead. For more information about the individual modes and the various input fields, click on the little question mark symbols next to the different input fields or have a look at the documentation page for GUI Usage.

Documentation

FastRet's documentation is available at spang-lab.github.io/FastRet. It includes pages about

Copy Link

Version

Install

install.packages('FastRet')

Monthly Downloads

233

Version

1.3.0

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Tobias Schmidt

Last Published

December 17th, 2025

Functions in FastRet (1.3.0)

preprocess_data

Preprocess data
RP

Retention Times (RT) measured on a Reverse Phase (RP) Column
init_log_dir

Initialize log directory
getCDs

Get Chemical Descriptors for a list of molecules
predict.frm

Predict retention times using a FastRet Model
plot_frm

Plot predictions for a FastRet model
read_retip_hilic_data

Read the HILIC dataset from the Retip package
pkg_file

Get package file
withTimeout

Execute an expression with a timeout
train_frm

Train a new FastRet model (FRM) for retention time prediction
now

now
withLineEnd

Add line end
withSink

Execute an expression while redirecting output to a file
withStopMessage

Try expression with predefined error message
read_rpadj_xlsx

Hypothetical retention times
read_rp_xlsx

Read retention times (RT) measured on a reverse phase (RP) column
start_gui

Start the FastRet GUI
selective_measuring

Selective Measuring
CDNames

Chemical Descriptors Names
get_predictors

Extract predictor names from an 'frm' object
clip_predictions

Clip predictions to observed range
analyzeCDNames

Analyze Chemical Descriptors Names
read_rp_lasso_model_rds

LASSO Model trained on RP dataset
fastret_app

The FastRet GUI
as_canonical

Canonicalize SMILES
collect

Collect elements from a list of lists
adjust_frm

Adjust an existing FastRet model for use with a new column
CDFeatures

Chemical Descriptor Features
catf

catf function