Learn R Programming

Nozzle.R1 (version 1.1-1.1)

Nozzle Reports

Description

The Nozzle package provides an API to generate HTML reports with dynamic user interface elements based on JavaScript and CSS (Cascading Style Sheets). Nozzle was designed to facilitate summarization and rapid browsing of complex results in data analysis pipelines where multiple analyses are performed frequently on big data sets. The package can be applied to any project where user-friendly reports need to be created.

Copy Link

Version

Install

install.packages('Nozzle.R1')

Monthly Downloads

510

Version

1.1-1.1

License

LGPL-2

Issues

Pull Requests

Stars

Forks

Maintainer

Nils Gehlenborg

Last Published

June 23rd, 2022

Functions in Nozzle.R1 (1.1-1.1)

LOGO.BOTTOM.CENTER

Logo position.
IMAGE.TYPE.PDF

Image type.
DEFAULT.DOI.RESOLVER

Default DOI resolver URL.
DEFAULT.REPORT.FILENAME

Default filename for reports.
IMAGE.TYPE.SVG

Image type.
HTML.REPORT

Output type.
LOGO.BOTTOM.LEFT

Logo position.
IMAGE.TYPE.RASTER

Image type.
PROTECTION.TCGA

Group visibility.
RDATA.REPORT

Output type.
DEFAULT.SIGNIFICANT.ENTITY

Name of entities that are labeled as signficiant.
addToMeta

Add elements to the "Meta" section of a standard report.
PROTECTION.PUBLIC

Public visibility.
addToReferences

Add elements to the "References" subsection in the "Methods & Data" section of a standard report.
addToOverview

Add elements to the "Overview" section of a standard report.
asReference

Reference a citation, figure or table element.
asParameter

Format text as parameter.
addToIntroduction

Add elements to the "Introduction" subsection in the "Overview" section of a standard report.
addToInput

Add elements to the "Input" subsection in the "Methods & Data" section of a standard report.
PROTECTION.PRIVATE

Private visibility.
addToMethods

Add elements to the "Methds & Data" section of a standard report.
asCode

Format text as code.
getContactInformationLabel

Get label for contact button for report.
addTo

Add child elements to a parent element.
PROTECTION.GROUP

Group visibility.
getContactInformationMessage

Get contact email default message for report.
TABLE.SIGNIFICANT.DIGITS

Default number of significant digits to be used to trim numeric columns in tables.
Nozzle.R1-package

Nozzle: a Report Generation Toolkit for Data Analysis Pipelines
getDoiVersion

Get the DOI version for report.
getDoiYear

Get the DOI year for report.
asEmph

Format text with emphasis (usually resulting in text set in italics).
getContactInformationEmail

Get contact email address for report.
asValue

Format text as value.
getCustomScreenCss

Get the path or URL of the CSS file to be used to overwrite the default screen (not: print) style sheet.
getFigureFile

Get path or URL of image file associated with a figure element.
asFilename

Format text as filename.
getDoi

Get the DOI (document object identifier, http://www.doi.org) for report.
getFigureFileHighRes

Get path or URL of high-resolution of vector-based image file associated with a figure element.
LOGO.TOP.LEFT

Logo position.
getGoogleAnalyticsId

Get Google Analytics tracking ID for report.
asLink

Format text as a hyperlink.
getCopyrightStatement

Get copyright statement for report. This text is linked to the copyright URL.
HTML.FRAGMENT

Output type.
getCopyrightUrl

Get copyright URL for report, which is linked to the copyright statement.
getReportSubTitle

Get the subtitle of report.
getLogo

Get logo file for one of six positions (three at the top, three at the bottom) in report.
getSummary

Get the first element of the "Summary" subsection in the "Overview" section in a standard report.
getTableFile

Get path or URL of file associatd with table element.
SECTION.CLASS.META

Section class.
SECTION.CLASS.RESULTS

Section class.
LOGO.TOP.RIGHT

Logo position.
isFigure

Test if element is a figure element.
getSoftwareName

Get the name of the software that used Nozzle to generate report.
getSoftwareVersion

Get the version of the software that used Nozzle to generate report.
asStrong

Format text with strong emphasis (usually resulting in text set in bold).
newResult

Create a new result element.
newReport

Create a new report with pre-defined sections Overview/Introduction, Overview/Summary, Results, Methods & Data/Input, Methods & Data/References and Meta Data.
asSummary

Include a result in text. This is a legacy method and provided only for backwards compatibility.
LOGO.BOTTOM.RIGHT

Logo position.
setGoogleAnalyticsId

Set the Google Analytics tracking ID to be embedded in this report ("web property id", usually starts with "UA-").
setLogo

Set a logo file for one of six positions (three at the top, three at the bottom) in report, e.g. an institute logo.
getCopyrightYear

Get copyright year report.
newList

Create a new list element.
getReportTitle

Get the title of report.
newJournalCitation

Create a citation element that represents a document published in a journal. This is a convenience wrapper for newCitation.
isTable

Test if element is a table element.
getDoiCreator

Get the DOI creator for report.
LOGO.TOP.CENTER

Logo position.
addToResults

Add elements to the "Results" section of a standard report.
getCreatorDate

Get date when report was created.
getContactInformationSubject

Get contact email subject line for report.
getCopyrightOwner

Get name of the copyright owner for report.
addToSummary

Add elements to the "Summary" subsection in the "Overview" section of a standard report.
setDoiYear

Set the DOI meta data year for report.
setDoiVersion

Set the DOI meta data version for report.
getDoiPublisher

Get the DOI publisher for report.
getMaintainerName

Get name of maintainer of report.
setCopyright

Set copyright messsage for report.
setCustomPrintCss

Set the path or URL of the CSS file to be used to overwrite the default print (not: screen) style sheet. Can be relative or absolute.
getCreatorName

Get name and version of the Nozzle package that was used to create report.
setDoiCreator

Set the DOI meta data creator for report.
setReportSubTitle

Set the subtitle of report.
setDoiPublisher

Set the DOI meta data publisher for report.
setMaintainerName

Set name of maintainer of report.
setReportTitle

Set the title of report.
getRendererDate

Get date when report was rendered.
getSignificantEntity

Get name of entities that are called out as significant, e.g. "gene". This is currently not being used and might become obsolete in future versions of Nozzle.
getSignificantResultsCount

Get the total number of significant results in report.
setNextReport

Set the URL and title of the "next" report after report. This will be accessible through the utility menu.
getDoiResolver

Get the DOI resolver URL (e.g. http://dx.doi.org) for report.
getDoiTitle

Get the DOI title for report.
newCitation

Create a citation element.
getCustomPrintCss

Get the path or URL of the CSS file to be used to overwrite the default print (not: screen) style sheet.
getExportedElement

Get an exported element from a report. This can be used to generate aggregate reports. This is an experimental feature of Nozzle and may not lead to the expected results.
getMaintainerAffiliation

Get affiliation of maintainer of report.
getMaintainerEmail

Get email address of maintainer of report.
newParagraph

Create a new paragraph element.
getRendererName

Get name and version of the Nozzle package that was used to render report.
getExportedElementIds

Get the IDs of exported elements from report. This is an experimental feature of Nozzle and may not lead to the expected results.
newSubSubSection

Create a new subsubsection element.
newParameterList

Create a new parameter list element. A parameter list is an unnumbered list of the form param_1 = value_1, ..., param_n = value_n where param_i is formated as a parameter and value_i is formatted as a value.
newTable

Create new table element.
getReportId

Get the ID (a UUID) of report.
newFigure

Create a new list element.
newHtml

Create a new freeform HTML element. THIS MUST BE USED WITH EXTRAORDINARTY CARE!
newSection

Create a new section element.
setFigureFile

Set path or URL of image file associated with a figure element. Paths can relative or absolute.
setParentReport

Set the URL and title of the "parent" report above report. This will be accessible through the utility menu.
newSubSection

Create a new subsection element.
setPreviousReport

Set the URL and title of the "previous" report before report. This will be accessible through the utility menu.
setFigureFileHighRes

Set path or URL of high-resolution or vector-based image file associated with a figure element. Paths can be relative or absolute.
setSignificantEntity

Set name of entities that are called out as significant, e.g. "gene". This is currently not being used and might become obsolete in future versions of Nozzle.
setSoftwareName

Set the name of the software that used Nozzle to generate report, e.g. "My Report Generator Script".
newCustomReport

Create a new custom report without pre-defined sections.
setCustomScreenCss

Set the path or URL of the CSS file to be used to overwrite the default screen (not: print) style sheet. Can be relative or absolute.
setMaintainerAffiliation

Set affiliation of maintainer of report.
setDoi

Set the DOI (document object identifier, http://www.doi.org) for report. A warning will be emitted if the report has been assigned a DOI before.
setMaintainerEmail

Set email address of maintainer of report.
writeReport

Write report to file.
newWebCitation

Create a citation element that represents a document published online. This is a convenience wrapper for newCitation.
setContactInformation

Set contact information for report. This is used to create a "contact" button in the top right corner of the report, e.g. to collect feedback about the report.
setDoiTitle

Set the DOI meta data title for report.
setSoftwareVersion

Set the name of the software that used Nozzle to generate report, e.g. "Version 1.2".
setDoiResolver

Set the DOI resolver URL (e.g. http://dx.doi.org) for report. The URL must not end with a slash!
setTableFile

Set path or URL of file associatd with table element.