* r/man/macros/macros.Rd (HTMLVignette): New macro.

 * r/R/generate.R: Use it.
 * r/R/hv_approx.R: Likewise.

Author: MLopez-Ibanez

r/R/generate.R

@@ -9,6 +9,8 @@
 #' [normalise()].  Otherwise, points are scaled to a non-negative integer range
 #' that keeps the points mutually nondominated.
 #'
+#' See the visualisations in the vignette \HTMLVignette{generate}{Sampling Random Nondominated Sets}.
+#'
 #' @param n `integer(1)`\cr Number of rows in the output.
 #' @param d `integer(1)`\cr Number of columns in the output.
 #' @param method `character(1)`\cr Method used to generate the random nondominated set.

r/R/hv_approx.R

@@ -5,8 +5,8 @@
 #' `method="DZ2019-HW"` is deterministic and ignores the parameter `seed`,
 #' while `method="DZ2019-MC"` relies on Monte-Carlo sampling
 #' \citep{DenZha2019approxhv}.  Both methods tend to get more accurate with
-#' higher values of `nsamples`, but the increase in accuracy is not monotonic.
-#  FIXME: Link to vignette like the Python docs.
+#' higher values of `nsamples`, but the increase in accuracy is not monotonic,
+#' as shown in the vignette \HTMLVignette{hv_approx}{Approximating the hypervolume}.
 #'
 #' @author Manuel \enc{López-Ibáñez}{Lopez-Ibanez}
 #'

r/man/generate_ndset.Rd

@@ -1,2 +1,9 @@
 \newcommand{\citep}{\insertCite{#1}{moocore}}%
 \newcommand{\citet}{\insertCite{#1;textual}{moocore}}%
+
+% Macro to create link to an HTML vignette from a help page.
+% arg 1 is the name of the vignette (without .html)
+% arg 2 is the text to show on the link.
+%% See also:
+%% https://github.com/dmurdoch/rgl/blob/ec1e6cf237f91064a3e00b4627c6e39005779f83/man/macros/macros.Rd#L10
+\newcommand{\HTMLVignette}{\href{https://multi-objective.github.io/moocore/r/articles/#1.html}{#2}}