rk.call.plugin {rkward} | R Documentation |
rk.call.plugin(plugin, ..., submit.mode = c("manual", "auto", "submit")) rk.list.plugins(path, type = "all")
plugin |
character string, giving the name of the plugin to call. See Details. |
... |
arguments passed to the |
submit.mode |
character string, specifying the submission mode: |
rk.call.plugin
provides a high level wrapper to call any plugin available in RKWard. The exact string to be used as plugin
, and the list of arguments available for a particular plugin, are generally not transparent to the user.rk.list.plugins
can be used to obtain a list of current plugins. For plugin arguments, it is recommended to run the plugin, and inspect the "Run again" link that is generated on the output.
Warning: Using rk.call.plugin
, especially with submit.modes "auto"
or "submit"
to program a sequence of analyses has important drawbacks. First, the semantics of plugins are not guaranteed to remain unchanged across different versions of RKWard, thus your code may stop working after an upgrade. Second, your code will not be usable outside of an RKWard session. Consider copying the generated code for each plugin, instead. The primary use-cases for rk.call.plugin
are automated tests, cross-references, and scripted tutorials.
Note: Even when using "submit.mode=submit"
, the plugin code is run in the global context. Any local variables of the calling context are not available to the plugin.
rk.list.plugins
returns the list of the names of all currently registered plugins.
rk.call.plugin
returns TRUE
invisibly.
rk.list.plugins
returns a character vector of plugin names. If none found, NULL
is returned.
Thomas Friedrichsmeier rkward-devel@lists.sourceforge.net
rk.results
, rkward://page/rkward_output
## list all current plugins rk.list.plugins () ## "t_test_two_vars" plugin: ## see the output: Windows->Show Output local({ x1 <- rnorm (100) x2 <- rnorm (100, 2) rk.call.plugin ("rkward::t_test_two_vars", confint.state="1", conflevel.real="0.95", hypothesis.string="greater", paired.state="0", varequal.state="0", x.available="x1", y.available="x2", submit.mode="submit") })