Skip to content

Proof-read introduction vignette - #7

Draft
advieser wants to merge 18 commits into
masterfrom
intro_vignette_review
Draft

Proof-read introduction vignette#7
advieser wants to merge 18 commits into
masterfrom
intro_vignette_review

Conversation

@advieser

@advieser advieser commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

I like the structure of the vignette and it all follows quite logically from itself. Having read it a couple of times, however, I still get confused which class is for what purpose. A short overview might help.

Changes:

  • Switched to American style dash usage (unspaced em dashes).
  • Switched from plain-text citation to pandoc citations.
    • Default citation style could be improved, but I don't think it relevant enough for a vignette.
  • Sections are also numbered on the website.
  • Rephrased titles to be somewhat unified in structure and to be in title case.
  • Added section links.
  • Rephrased and expanded article roadmap.
  • Reworked all figures.
  • Used title case for figure titles.
  • Switched to consistent American spellings.

Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated

`ObjectiveRFun` evaluates one configuration at a time; `ObjectiveRFunDt` is the batch-wise variant for functions that can process a whole `data.table` of configurations at once.
Codomains with `"minimize"` or `"maximize"` tags remain admissible -- the same machinery can drive model-based optimization -- but this vignette concentrates on the pure learning case.
Codomains with `"minimize"` or `"maximize"` tags remain admissible---the same machinery can drive model-based optimization---but this vignette concentrates on the pure learning case.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does celecx handle "minimize" or "maximize" in any way? If not, I think this is unnecessary.

Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
The batches take turns between the two difficult parts of the function---the oscillatory left, whose fine structure the model cannot yet interpolate, and the steep right flank---because each refit moves the widest part of the credible band elsewhere.
Within a batch the four points cluster tightly, a consequence of greedy batch construction that Section 3.3 returns to.

```{r first-plot, fig.height = 4, fig.cap = "Figure 1: Active learning on the one-dimensional test function. Points show evaluated configurations, shaded by batch; the shaded region is the emulator's 95% credible band after the final batch."}

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to hide the figure-generating code?

@advieser

Copy link
Copy Markdown
Collaborator Author

New Fig. 1 legend
grafik

Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd
Comment thread vignettes/celecx.Rmd
Comment thread vignettes/celecx.Rmd
Comment thread vignettes/celecx.Rmd
col = experiment_colors[archive_experiment$batch_nr])
plot(progress$data$batch_nr, progress$data$mae, log = "y", type = "b", pch = 19,
xlab = "batch", ylab = "held-out MAE", main = "Learning curve")
par(old_par)

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For some reason, shown as a separate code field in with pkgdown.

Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd
Comment thread vignettes/celecx.Rmd Outdated
Comment thread vignettes/celecx.Rmd Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant