Superseded compatibility wrapper for plotting the historical two-column IC
acceptance matrix. New code should usually call icTrajectory() and then
plot.icTrajectory() directly.
Usage
plot_ic_acceptance_matrix(
matrix_data,
plot_title = "IC Acceptance Matrix Scatter Plot",
plot_rate_of_improvement = TRUE,
rate_limits = c(-400, 150),
baseline_ic = NULL,
...
)Arguments
- matrix_data
A two-column matrix or data frame. Column 1 must contain numeric IC scores in evaluation order; column 2 must contain logical values or 0/1 indicators for accepted proposals.
- plot_title
Plot title.
- plot_rate_of_improvement
Logical; if
TRUE, draw the proposaldelta_icoverlay on a secondary y-axis.- rate_limits
Numeric vector of length 2 giving limits for the overlay axis. Used only when
plot_rate_of_improvement = TRUE.- baseline_ic
Optional finite numeric baseline IC. When supplied, this replaces the first IC value for the plotted baseline row.
- ...
Additional plotting arguments passed to
plot.icTrajectory().
Details
This wrapper preserves the old plot_ic_acceptance_matrix() argument names
while delegating the actual drawing to plot.icTrajectory(). matrix_data
must have IC values in the first column and accepted/rejected indicators in
the second column. To match the legacy plotting convention, the first row is
treated as the plotted baseline row; when baseline_ic is supplied, it
replaces the first IC value for that baseline row.
The historical plot_rate_of_improvement argument maps to the new
show_delta plotting mode: TRUE draws the delta_ic overlay and FALSE
suppresses it. rate_limits is retained as the legacy name for the overlay
y-limits. Its order is ignored for compatibility with the historical wrapper.