quicR is a package made for the analysis of real-time quaking-induced conversion (RT-QuIC) assays.
Much of the functionality is designed to be integrated with the Excel output files generated by the BMG analysis software, MARS. For best results, in the MARS software select:
---
config:
layout: dagre
theme: dark
look: neo
---
flowchart TB
excel(Excel Export)
subgraph A[Select these export options]
direction LR
micro(
Microplate
View
)
table(
Table
View
)
trans(
Transpose
Table
)
test(
Add test run
information
)
end
export(Export report to Excel)
excel --> A
micro --> table --> trans --> test
A --> export
Having both the microplate view and the table view helps with integrating plate layouts and the real-time data.
For many of the functions, it is important to have a table labelled “Sample IDs” on the microplate view sheet of the Excel file.
Use BMG_format.R script to format a .CSV file with a Sample IDs in a plate view into a format importable into the BMG control software.
For example .CSV file, see
tests/testthat/BMG_formatting/plate_layout.csv
The file, “formatted.txt” in the same folder, is how the export should look to be imported into the BMG software.
Getting the real-time data from the MARS export is quite simple. Normalization can also be performed on the data.
# Import the raw data
<- get_real("file.xlsx")
df_
# Normalize the data based on the initial background reading.
<- normalize_RFU(df_) df_norm
The MARS software exports microplate views of the samples with information that the user chose. Often, you will want to ensure that you included “Sample IDs” in that export. To import the metadata into your environment, run the following:
# Import the metadata as a named list of tables.
<- organize_tables("file.xlsx", plate = 96)
tabs
# Convert the tables into dataframe columns
<- convert_tables(tabs) df_
Additionally, MARS will also export the run metadata which is not sample dependent. This includes information such as the date, run ID, user ID, etc. To get this information run the following:
get_meta("file.xlsx")
If you need to know which wells were used in the plate, run:
<- get_wells("file.xlsx") wells
The function, plate_view
exports a useful figure for
quickly analyzing real-time data. It plots every sample in an 8x12 or
16x24 faceted grid for 96-well and 384-well plates, respectively.
Use .example_scripts/plate_view_export
to export a plate
view of the real-time data from an Excel file made in MARS.
quicR provides functions for calculating kinetic information from
real-time data. These metrics include: 1. Maxpoint ratio:
calculate_MPR
2. Maximum slope: calculate_MS
3. Time-to-threshold: calculate_TtT
There is no function included for rate of amyloid formation (RAF) since that can be calculated as the inverse of time-to-threshold.
The script provided at
.example_scripts/calculate_metrics.R
will calculate these
metrics.
An Excel file will also be created with the full data and summarized data. A plot of the summarized data will also be created.
For example .xlsx files, see:
inst/extdata/input_files/
# For latest release
install.packages("quicR")
# For development version
::install_github("https://github.com/gage1145/quicR") devtools
Gage Rowden