{"id":14068399,"url":"https://github.com/parklab/nozzle","last_synced_at":"2025-10-22T06:06:46.504Z","repository":{"id":6180417,"uuid":"7410639","full_name":"parklab/nozzle","owner":"parklab","description":"Nozzle is a report generation toolkit for data analysis pipelines implemented in R.","archived":false,"fork":false,"pushed_at":"2016-04-02T13:05:37.000Z","size":1541,"stargazers_count":67,"open_issues_count":15,"forks_count":22,"subscribers_count":9,"default_branch":"develop","last_synced_at":"2024-09-23T16:37:32.438Z","etag":null,"topics":["gehlenborglab","html-report","reproducible-research"],"latest_commit_sha":null,"homepage":"http://gdac.broadinstitute.org/nozzle","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/parklab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-02T17:41:50.000Z","updated_at":"2024-07-10T00:22:41.000Z","dependencies_parsed_at":"2022-08-24T10:40:41.801Z","dependency_job_id":null,"html_url":"https://github.com/parklab/nozzle","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklab%2Fnozzle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklab%2Fnozzle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklab%2Fnozzle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklab%2Fnozzle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parklab","download_url":"https://codeload.github.com/parklab/nozzle/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228082274,"owners_count":17866601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gehlenborglab","html-report","reproducible-research"],"created_at":"2024-08-13T07:06:08.823Z","updated_at":"2025-10-22T06:06:41.460Z","avatar_url":"https://github.com/parklab.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"# Nozzle [![](http://www.r-pkg.org/badges/version/Nozzle.R1)](http://cran.rstudio.com/web/packages/Nozzle.R1/index.html) [![](http://cranlogs.r-pkg.org/badges/grand-total/Nozzle.R1)](http://cranlogs.r-pkg.org/badges/grand-total/Nozzle.R1)\n\nNozzle is an [R package](http://www.r-project.org) that 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.\n\nA paper describing the package was published in [Bioinformatics](http://bioinformatics.oxfordjournals.org/content/29/8/1089). Please cite this paper if you are using Nozzle in your work:\n\n\u003e N Gehlenborg, MS Noble, G Getz, L Chin and PJ Park, \"Nozzle: a report generation toolkit for data analysis pipelines\", _Bioinformatics_ __29__:1089-1091 (2013)\n\nA [_nozzleized_ version of the preprint](http://gdac.broadinstitute.org/docs/nozzle/reports/paper.html) is available on the [Nozzle site at the Broad Institute](http://gdac.broadinstitute.org) and the [source code](https://github.com/parklab/Nozzle/blob/develop/examples/paper.R) is included in this repository.\n\n### About the Name\n\nThe package was orignally developed for a data analysis pipeline called \"Firehose\" and the name \"Nozzle\" was chosen because the package is used to focus the output of Firehose. The \"R1\" in the \"Nozzle.R1\" package name stands for \"revision 1\" of the Nozzle R API. All versions of the Nozzle.R1 package will be backwards-compatible and able to render reports generated with earlier versions of the package. When backwards-compatibility of the API can no longer maintained the package name will change to \"Nozzle.R2\".\n\n# Obtaining and Installing the R package\n\nAs of version 1.0-0 the R package is available from [CRAN](http://cran.r-project.org) and can be installed directly from R:\n\n\tinstall.packages( \"Nozzle.R1\", type=\"source\" );\n\nThe package can also be downloaded from the [Nozzle site at the Broad Institute](http://gdac.broadinstitute.org/nozzle). The package has no external dependencies and can be installed by calling the following from the command line:\n\n\tR CMD install Nozzle.R1\n\n\n# Creating a Basic Report\n\nThe following code creates a report with one section and two subsections. The first subsection contains a table and the second subsection contains a paragraph of text:\n\n\trequire( Nozzle.R1 )\n\t\n\t# Phase 1: create report elements\n\tr \u003c- newCustomReport( \"My Report\" );\n\ts \u003c- newSection( \"My Section\" );\n\tss1 \u003c- newSection( \"My Subsection 1\" );\n\tss2 \u003c- newSection( \"My Subsection 2\" );\n\tf \u003c- newTable( iris[45:55,], \"Iris data.\" ); # w/ caption\n\tp \u003c- newParagraph( \"Some sample text.\" );\n\t\n\t# Phase 2: assemble report structure bottom-up\n\tss1 \u003c- addTo( ss1, f ); # parent, child_1, ..., child_n \n\tss2 \u003c- addTo( ss2, p );\n\ts \u003c- addTo( s, ss1, ss2 );\n\tr \u003c- addTo( r, s );\n\t\n\t# Phase 3: render report to file\n\twriteReport( r, filename=\"my_report\" ); # w/o extension\n\nTwo files called `my_report.html` and `my_report.RData` will be written to the current working directory.\n\n# Further Examples\n\nAn comprehensive demo that uses almost the complete Nozzle API is in the [`examples`](https://github.com/parklab/Nozzle/tree/develop/examples) folder.\nBoth the `demo.R` file and the `demo.css` file are required for the example to work. The rendered HTML reports can be viewed on the [Nozzle site at the Broad Institute](http://gdac.broadinstitute.org/docs/nozzle/reports/nozzle1.html).  \n\n# Building the R package\n\nNozzle works with R 2.10 or later. Use standard R commands to build the package in the cloned repo directory:\n\n\tR CMD check Nozzle.R1\n\tR CMD build Nozzle.R1\n\n\n## Updating Documentation\n\nThe Nozzle API is documented using the `roxygen2` [R package](http://cran.r-project.org/web/packages/roxygen2/index.html). To rebuild the Rd files in the `man` directory run the following from the R shell (using the cloned repo directory as the working directory):\n\n\tlibrary(methods);\n\tlibrary(utils);\n\tlibrary(roxygen2);\n\troxygenize(\"Nozzle.R1\", copy=FALSE);\n\n\n## Minifying Files\n\nThe JavaScript and CSS code should be compressed before they can be embedded in the HTML report. If you make changes to any file in the `inst` directory you need to download the [YUI compressor] (http://yui.github.com/yuicompressor) and run the following from the command line:\n\n\tjava -jar Tools/yuicompressor-2.4.2.jar -o Nozzle.R1/inst/js/nozzle.min.js \tNozzle.R1/inst/js/nozzle.js\n\tjava -jar Tools/yuicompressor-2.4.2.jar -o Nozzle.R1/inst/css/nozzle.print.min.css Nozzle.R1/inst/css/nozzle.print.css\n\tjava -jar Tools/yuicompressor-2.4.2.jar -o Nozzle.R1/inst/css/nozzle.min.css Nozzle.R1/inst/css/nozzle.css\n\n\n# Author\n\n[Nils Gehlenborg](http://www.gehlenborg.com) ([nils@hms.harvard.edu] (mailto:nils@hms.harvard.edu))\n\n# Funding\n\nNozzle was developed with funding from The Cancer Genome Atlas program of the National Cancer Institute, U24 CA143867.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparklab%2Fnozzle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparklab%2Fnozzle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparklab%2Fnozzle/lists"}