FAQ

This document was generated from 'src/documentation/print-faq-wiki.ts' on 2025-06-15, 17:37:50 UTC presenting an overview of flowR's frequently asked questions (v2.2.15). Please do not edit this file/wiki page directly.

💮 flowR FAQ

🧑‍💻 flowR Development

What are test labels and how do they work?

Tests are labeled based on the flowR capabilities that they test for. The list of supported capabilities can be found on the Capabilities wiki page. For more extensive information on test labels, see the test labels wiki section.

How do I generate mermaid diagrams?

There are several ways to generate mermaid diagrams based on the input data that you want to use.

• From the AST (abstract syntax tree): ./src/util/mermaid/ast.ts
• From the CFG (control flow graph): ./src/util/mermaid/cfg.ts
• From the DFG (dataflow graph): ./src/util/mermaid/dfg.ts

How do I create new wiki pages?

To create an automatically generated wiki page, you can follow these steps:

• Create a new file in src/documentation with a name like print-my-page-wiki.ts.
• Add a new wiki generation script to the ./package.json. You can copy one of the existing ones of the form "wiki:my-page": "ts-node src/documentation/print-my-page-wiki.ts".
• Add the wiki generation script to the broken-links-and-wiki.yml GitHub workflow file to enable automatic generation through the CI. You can copy one of the existing ones of the form update_page wiki/"My page" wiki:my-page.

You can test your page by piping the wiki generation script to a file. For example, you can run the following command:

npm run --silent wiki:my-page > __my-page.md

Remember not to commit this file, as it's only meant for testing.

Why can't I pass arguments when running flowR with npm?

With npm you have to pass arguments in a specific way. The -- operator is used to separate the npm arguments from the script arguments. For example, if you want to run flowR with the --help argument, you can use the following command:

npm run flowR -- --help

🇷 R FAQ

📦 R Packages

What is the R prelude and R base package?

The base package contains lots of base functions like source for example. The R prelude includes the base package along with several other packages. Packages that were loaded by the prelude can be called without prefixing the function call with the package name and the :: operator.

The packages loaded by the R prelude can be seen in the attached base packages sections in the output of sessionInfo().

How to get documentation for a function or package?

There are a couple of ways to get documentation for a function or package.

🖥️ Firstly, if you have already installed the package the function originated from you can simply run ?<package name>::<function name> in an R session to print the relevant documentation. If you don't know the origin of the package, you can use ??<function name> in an R shell to fuzzy find all documentations containing <function name> or something similar.

🌐 Secondly, if you don't have or don't want to install the package you can simply google the fully qualified name of the function. Good sources include rdrr.io or rdocumentation.org. Additionally, the package documentation PDF can also be downloaded directly from cran.