plot_pof: Plotting Pareto-optimal Fronts and Best Compromise Solutions

In hydroMOPSO: Multi-Objective Optimisation with Focus on Environmental Models

Plotting Pareto-optimal Fronts and Best Compromise Solutions

Description

The function plot_pof generates plots of the Pareto-optimal front (POF) and the best compromise solution (BCS) in multi-objective optimization for hydrological models. It visualizes trade-offs between different objectives and helps identify the most balanced solution, assisting in model calibration and evaluation processes.

(*): When do.png == TRUE, graphics are written to disk.

Usage

plot_pof(Results,
         pof = NULL,
         bcs = NULL,
         analysis.period = NULL,
         dimensions = NULL,
         maxmin = NULL,
         obj.thr = NULL,
         obj.names = NULL,
         main = "study case #1",
         drty.out = "MOPSO.out", 
         pch.pof = 21,
         pch.bcs = 21,
         col.pof = "#f21b1b",
         col.bcs = "#004fcf",
         legend.pof = c("Pareto-optimal front solutions", "Best compromise solution"),
         cex.pt = 1.25,
         cex.main = 1,
         cex.lab = 1,
         cex.axis = 1,
         do.png = FALSE)

Arguments

Results	(list) Object containing preprocessed hydrological results.
pof	(matrix or NULL) Dataset representing the filled Pareto-optimal front (POF) solutions.
bcs	(matrix or NULL) Parameters or results corresponding to the best compromise solution (BCS).
analysis.period	(character or NULL) Time period for analysis (e.g., "calibration" or "verification").
dimensions	(numeric or NULL) Dimensions of the modeled problem, typically indicating the number of objectives and variables.
maxmin	(character or NULL) Indicator of whether objectives are to be maximized ("max") or minimized ("min").
obj.thr	(numeric or NULL) Objective thresholds.
obj.names	(character or NULL) Names of the objectives used in the plot.
main	(character) Main title for the plot.
drty.out	(character) Output directory where plots will be saved if specified to save as PNG files.
pch.pof	(integer) Symbol type for points in the plot representing the Pareto-optimal front solutions.
pch.bcs	(integer) Symbol type for points in the plot representing the best compromise solution (BCS).
col.pof	(character) Color used for the points representing the Pareto-optimal front solutions in the plots.
col.bcs	(character) Color used for the points representing the best compromise solution in the plots.
legend.pof	(character) Legend text for the Pareto-optimal front and best compromise solution.
cex.pt	(numeric) Size of points in the plots.
cex.main	(numeric) Size of the main title text in the plot.
cex.lab	(numeric) Size of the axis label text in the plots.
cex.axis	(numeric) Size of the axis values text in the plots.
do.png	(logical) Boolean value indicating whether the plots should be saved as PNG files.

Value

No return value; generates plots as a side effect.

Author(s)

Rodrigo Marinao Rivas [e-mail], Mauricio Zambrano-Bigiarini, [e-mail]

See Also

plot_out, plot_param

hydroMOPSO documentation built on June 18, 2025, 9:15 a.m.