R/api.R
FacileAnalysisResultViz.RdThe vizualize, shine, and report triumverate provide the analyst with
the tools required to interact and explore the results of a FacileAnalysis.
viz(x, ...)
shine(x, ...)
report(x, ...)A FacileAnalysisResult object
passed down to the x-specific vizualize.*, report.*, and
shine.* functions.
The vizualize functions generate an analysis-specific interactive
htmlwidget for the analysist to explore.
The shine functions generate shiny gadgets that provide a more interactive
view over a FacileAnalysisResult. This empowers the analyst to provide more
context around the results, likely by leveraging all of the data available
within the FacileDataStore.
The respective shine functions must return a FacileAnalysisShine object
invisibly to the caller. These should be able to be past into an overladed
report function, the result of which can be embedded into an Rmarkdown
report. In this way the analyst can embed a feature-reduced version of what
was observed in the gadget into an Rmarkdown report.
I'm not sure how exactly we can do this, but perhaps this will require some
code generation that the analyst can copy and paste paste into the Rmarkdown
document. This might simply be a parameterized version of the report
function call.
The report function produces an object that can be embedded into an
Rmarkdown document. The implementation of these functions will likely
result in a parameterized call to the respective vizualize function.
Two report functions should be created per FacileAnalysis. One that accepts
the FacileAnalysisResult object itself, and another that accepts the
analysis-specific FacileAnalysisShine object, which should parameterize
the final visualize call so that it can be embedded seamlessly into
an Rmarkdown report for "offline" viewing.