Plot action potential recording — plot_AP

This function allows you to plot an .abf file of a recording taken in current clamp mode. It is useful if you want to display a representative trace of action potentials or the results of a current injection protocol.

Usage

plot_AP_trace(
  data,
  sweeps,
  colour_scale_option,
  custom_scale_colours = NULL,
  trace_colour,
  line_width = 0.7,
  plot_category,
  plot_treatment,
  state,
  include_scale_bar = "yes",
  scale_bar_x_start = 880,
  scale_bar_x_length = 100,
  scaling_factor = 10,
  scale_bar_y_start = -30,
  scale_bar_y_length = 40,
  scale_bar_linewidth = 0.6,
  save_plot_png = "no",
  filename_suffix,
  ...
)

Arguments

data: A dataframe generated using import_ABF_file() with recording_mode = "current_clamp".
sweeps: A character value or list of character values of the sweeps you would like to plot. These correspond to the values in the sweep1 column of your dataset, and will likely be in the form of "epi1", "epi2", etc.
colour_scale_option: A character value ("viridis", "custom" or "single_colour") describing what colour scale should be applied to the trace. If set to "viridis" or "custom", the trace will be coloured by sweep.
custom_scale_colours: A list of character values (can be hex values or named colours) describing the custom theme. Use if colour_scale_option = "custom".
trace_colour: A hex value of the colour of the lineplot. Use if colour_scale_option = "single_colour.
line_width: A numeric value specifying the width of the lineplot
plot_category: A numeric value specifying the category, which can be used to differentiate different protocol types. In the sample dataset for this package, plot_category == 2 represents experiments where insulin was applied continuously after a 5-minute baseline period.
plot_treatment: A character value specifying the treatment you would like to plot (e.g. "Control"). plot_treatment represents antagonists that were present on the brain slice, or the animals were fasted, etc.
state: A character value describing if the recording was taken during the baseline period or post-treatment/protocol. Examples include "Baseline", "Post-insulin". The state will be included in the .png filename if save_plot_png = "yes".
include_scale_bar: A character value that determines if a scale bar will be added to the plot. Allowed values are "yes" and "no".
scale_bar_x_start: A numeric value (in milliseconds) describing the x-axis position of the scale bar (default is 880).
scale_bar_x_length: A numeric value describing the horizontal span (in milliseconds) of the scale bar (default is 100).
scaling_factor: A numeric value describing the scaling factor applied by Clampfit to convert recording time to time in milliseconds. The default is 10, and this value will likely not need to be changed.
scale_bar_y_start: A numeric value describing the y-axis position (in mV) of the scale bar (default is -30).
scale_bar_y_length: A numeric value describing the vertical span (in mV) of the scale bar (default is 40).
scale_bar_linewidth: A numeric value describing the thickness of the scalebar line (default is 0.6).
save_plot_png: A character ("yes" or "no"). If "yes", the plot will be saved as a .png using ggsave. The filepath depends on the current type, but they will all go in subfolders below Figures/ in your project directory.
filename_suffix: Optional character value to add a suffix to the filename of the .png file created with this plot. Could be useful if you have specified a custom list of treatments.
...: Additional arguments passed to viridis::scale_color_viridis such as begin, end, option and direction

Value

A ggplot object. If save_plot_png == "yes", it will also generate a .png file in the folder Figures/Action-potentials/Representative-traces relative to the project directory.

Examples


# Custom colours
plot_AP_trace(
  data = sample_ap_abf_baseline,
  sweeps = as.character(unique(sample_ap_abf_baseline$episode)),
  custom_scale_colours = c(
    "#edd03a", "#cced34",
    "#a3fd3d", "#6bfe64",
    "#31f199", "#18dcc3",
    "#29bbec", "#4294ff",
    "#466be3", "#4040a2"
  ),
  colour_scale_option = "custom",
  plot_category = 2,
  plot_treatment = "Control"
)


# Single colour
plot_AP_trace(
  data = sample_ap_abf_baseline,
  sweeps = as.character(unique(sample_ap_abf_baseline$episode)),
  colour_scale_option = "single_colour",
  trace_colour = "#4294ff",
  plot_category = 2,
  plot_treatment = "Control"
)