Skip to content

Commit

Permalink
Merge branch 'main' into danknight-deprecate-test
Browse files Browse the repository at this point in the history
  • Loading branch information
aholmes authored Oct 9, 2023
2 parents 24937f1 + 0a85616 commit 6bf75bc
Show file tree
Hide file tree
Showing 4 changed files with 60 additions and 114 deletions.
4 changes: 2 additions & 2 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,8 @@ Suggests:
testthat
Description: Contains several plotting functions such as barplots, scatterplots, heatmaps, as well as functions to combine plots and assist in the creation of these plots. These functions will give users great ease of use and customization options in broad use for biomedical applications, as well as general purpose plotting. Each of the functions also provides valid default settings to make plotting data more efficient and producing high quality plots with standard colour schemes simpler. All functions within this package are capable of producing plots that are of the quality to be presented in scientific publications and journals. P'ng et al.; BPG: Seamless, automated and interactive visualization of scientific data; BMC Bioinformatics 2019 <doi:10.1186/s12859-019-2610-2>.
License: GPL-2
URL: https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general
BugReports: https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general/issues
URL: https://github.com/uclahs-cds/package-BoutrosLab-plotting-general
BugReports: https://github.com/uclahs-cds/package-BoutrosLab-plotting-general/issues
LazyLoad: yes
LazyData: yes
VignetteBuilder: knitr
4 changes: 4 additions & 0 deletions NEWS
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ BoutrosLab.plotting.general 7.0.9 2023-07-21

UPDATE
* Run R CMD check GitHub action weekly
* Updated GitHub links to use new "package" prefix

REMOVED
* Remove unnecessary package manual file

--------------------------------------------------------------------------
BoutrosLab.plotting.general 7.0.8 2023-05-26
Expand Down
108 changes: 54 additions & 54 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,83 +42,83 @@ Or to install the latest development version from GitHub:
```
# install.packages("devtools")
devtools::install_github("uclahs-cds/public-R-BoutrosLab-plotting-general")
devtools::install_github("uclahs-cds/package-BoutrosLab-plotting-general")
```
## Function reference

For further details on usage, parameters or to see an example of a specific function, see function links below.

| **Functions** | **Description** |
|-----------|---------|
|[`auto.axis()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/auto.axis.html)|Create ideal labels and values for a given dataset (detects log scales)|
|[`colour.gradient()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/colour.gradient.html)|Creates a colour gradient|
|[`covariates.grob()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/covariates.grob.html)|Create one or more covariate bars|
|[`create.barplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.barplot.html)|Make a barplot|
|[`create.boxplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.boxplot.html)|Make a boxplot|
|[`create.colourkey()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.colourkey.html)|Create Colourkey|
|[`create.dendrogram()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.dendrogram.html)|Generate a dendrogram|
|[`create.densityplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.densityplot.html)|Make a density plot|
|[`create.dotmap()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.dotmap.html)|Make a dotmap with coloured background|
|[`create.gif()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.gif.html)|Make a gif|
[`create.heatmap()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.heatmap.html)|Make a heatmap|
|[`create.hexbinplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.hexbinplot.html)|Make a hexagonally binned plot|
|[`create.histogram()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.histogram.html)|Make a histogram|
|[`create.lollipopplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.lollipopplot.html)|Make a lollipopplot|
|[`create.manhattanplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.manhattanplot.html)|Make a Manhattan plot|
|[`create.multipanelplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.multipanelplot.html)|Joins plots together|
|[`create.multiplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.multiplot.html)|Joins plots together|
|[`create.polygonplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.polygonplot.html)|Make a polygonplot|
|[`create.qqplot.comparison()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.qqplot.comparison.html)|Make a quantile-quantile plot of two samples|
|[`create.qqplot.fit()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.qqplot.fit.html)|Make a quantile-quantile plot of a sample|
|[`create.qqplot.fit.confidence.interval()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.qqplot.fit.confidence.interval.html)|Create the confidence bands for a one-sample qq plot|
|[`create.scatterplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.scatterplot.html)|Make a scatterplot|
|[`create.segplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.segplot.html)|Make a segplot|
|[`create.stripplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.stripplot.html)|Make a strip-plot|
|[`create.violinplot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/create.violinplot.html)|Make a violin plot|
|[`critical.value.ks.test()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/critical.value.ks.test.html)|Critical Value for Kolmogorov-Smirnov Test|
|[`default.colours()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/default.colours.html)|Provides default colour schemes.|
|[`display.colours()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/display.colours.html)|Function to display R colors, as well as corresponding R grey colours.|
|[`display.statistical.result()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/display.statistical.result.html)|Utility function to display statistical result in a plot|
|[`dist()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/dist.html)|Distance Matrix Computation|
|[`force.colour.scheme()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/force.colour.scheme.html)|Based on predefined colour schemes, returns a vector of corresponding colours.|
|[`generate.at.final()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/generate.at.final.html)|Generates alternative default tick mark locations for create.densityplot() and create.|scatterplot()
|[`get.corr.key()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/get.corr.key.html)|Correlation Key|
|[`get.correlation.p.and.corr()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/get.correlation.p.and.corr.html)|Calculate a correlation and its statistical significance|
|[`get.defaults()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/get.defaults.html)|Get operating system specific default properties|
|[`get.line.breaks()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/get.line.breaks.html)|Get line breaks|
|[`legend.grob()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/legend.grob.html)|Generate a legend grob|
|[`panel.BL.bwplot`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/panel.BL.bwplot.html)|A lattice::panel.bwplot replacement that fixes colouring issues|
|[`pcawg.colours()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/pcawg.colours.html)|Return standard PCAWG colour palettes.|
|[`scientific.notation()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/scientific.notation.html)|Use scientific notation in plots|
|[`show.available.palettes()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/show.available.palettes.html)|Display the available colour palettes|
|[`thousands.split()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/thousands.split.html)|Divide strings into groups of thousands|
|[`write.metadata()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/write.metadata.html)|Writes Metadata|
|[`write.plot()`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/write.plot.html)|Simplifies plotting by standardizing and centralizing all output-handling|
|[`auto.axis()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/auto.axis.html)|Create ideal labels and values for a given dataset (detects log scales)|
|[`colour.gradient()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/colour.gradient.html)|Creates a colour gradient|
|[`covariates.grob()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/covariates.grob.html)|Create one or more covariate bars|
|[`create.barplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.barplot.html)|Make a barplot|
|[`create.boxplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.boxplot.html)|Make a boxplot|
|[`create.colourkey()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.colourkey.html)|Create Colourkey|
|[`create.dendrogram()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.dendrogram.html)|Generate a dendrogram|
|[`create.densityplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.densityplot.html)|Make a density plot|
|[`create.dotmap()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.dotmap.html)|Make a dotmap with coloured background|
|[`create.gif()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.gif.html)|Make a gif|
[`create.heatmap()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.heatmap.html)|Make a heatmap|
|[`create.hexbinplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.hexbinplot.html)|Make a hexagonally binned plot|
|[`create.histogram()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.histogram.html)|Make a histogram|
|[`create.lollipopplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.lollipopplot.html)|Make a lollipopplot|
|[`create.manhattanplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.manhattanplot.html)|Make a Manhattan plot|
|[`create.multipanelplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.multipanelplot.html)|Joins plots together|
|[`create.multiplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.multiplot.html)|Joins plots together|
|[`create.polygonplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.polygonplot.html)|Make a polygonplot|
|[`create.qqplot.comparison()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.qqplot.comparison.html)|Make a quantile-quantile plot of two samples|
|[`create.qqplot.fit()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.qqplot.fit.html)|Make a quantile-quantile plot of a sample|
|[`create.qqplot.fit.confidence.interval()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.qqplot.fit.confidence.interval.html)|Create the confidence bands for a one-sample qq plot|
|[`create.scatterplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.scatterplot.html)|Make a scatterplot|
|[`create.segplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.segplot.html)|Make a segplot|
|[`create.stripplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.stripplot.html)|Make a strip-plot|
|[`create.violinplot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/create.violinplot.html)|Make a violin plot|
|[`critical.value.ks.test()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/critical.value.ks.test.html)|Critical Value for Kolmogorov-Smirnov Test|
|[`default.colours()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/default.colours.html)|Provides default colour schemes.|
|[`display.colours()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/display.colours.html)|Function to display R colors, as well as corresponding R grey colours.|
|[`display.statistical.result()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/display.statistical.result.html)|Utility function to display statistical result in a plot|
|[`dist()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/dist.html)|Distance Matrix Computation|
|[`force.colour.scheme()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/force.colour.scheme.html)|Based on predefined colour schemes, returns a vector of corresponding colours.|
|[`generate.at.final()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/generate.at.final.html)|Generates alternative default tick mark locations for create.densityplot() and create.|scatterplot()
|[`get.corr.key()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/get.corr.key.html)|Correlation Key|
|[`get.correlation.p.and.corr()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/get.correlation.p.and.corr.html)|Calculate a correlation and its statistical significance|
|[`get.defaults()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/get.defaults.html)|Get operating system specific default properties|
|[`get.line.breaks()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/get.line.breaks.html)|Get line breaks|
|[`legend.grob()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/legend.grob.html)|Generate a legend grob|
|[`panel.BL.bwplot`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/panel.BL.bwplot.html)|A lattice::panel.bwplot replacement that fixes colouring issues|
|[`pcawg.colours()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/pcawg.colours.html)|Return standard PCAWG colour palettes.|
|[`scientific.notation()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/scientific.notation.html)|Use scientific notation in plots|
|[`show.available.palettes()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/show.available.palettes.html)|Display the available colour palettes|
|[`thousands.split()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/thousands.split.html)|Divide strings into groups of thousands|
|[`write.metadata()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/write.metadata.html)|Writes Metadata|
|[`write.plot()`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/write.plot.html)|Simplifies plotting by standardizing and centralizing all output-handling|

## Included datasets

| **Dataset** | **Description** |
|-----------|---------|
|[`CNA`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/CNA.html)|Copy number aberration (CNA) data from colon cancer patients|
|[`SNV`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/SNV.html)|Single nucleotide variant (SNV) data from colon cancer patients|
|[`microarray`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/microarray.html)|Microarray dataset of colon cancer patients|
|[`patient`](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/reference/patient.html)|Dataset describing qualities of 58 colon cancer patients|
|[`CNA`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/CNA.html)|Copy number aberration (CNA) data from colon cancer patients|
|[`SNV`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/SNV.html)|Single nucleotide variant (SNV) data from colon cancer patients|
|[`microarray`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/microarray.html)|Microarray dataset of colon cancer patients|
|[`patient`](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/reference/patient.html)|Dataset describing qualities of 58 colon cancer patients|

## Resources

Available resources on BPG usage can be found at the package [CRAN page](https://cran.r-project.org/package=BoutrosLab.plotting.general/index.html), [reference manual](https://cran.r-project.org/package=BoutrosLab.plotting.general/BoutrosLab.plotting.general.pdf), or [vignette](https://cran.r-project.org/package=BoutrosLab.plotting.general/vignettes/PlottingGuide.pdf).

## Getting help

Looking for guidance or support with Boutros.plotting.general? Check out our [Discussions](https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general/discussions) page.
Looking for guidance or support with Boutros.plotting.general? Check out our [Discussions](https://github.com/uclahs-cds/package-BoutrosLab-plotting-general/discussions) page.

Submit bugs, suggest new features or see current works at our [Issues](https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general/issues) page.
Submit bugs, suggest new features or see current works at our [Issues](https://github.com/uclahs-cds/package-BoutrosLab-plotting-general/issues) page.

[Pull requests](https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general/pulls) are also open for discussion.
[Pull requests](https://github.com/uclahs-cds/package-BoutrosLab-plotting-general/pulls) are also open for discussion.

## Contributors

For lists of contributors please visit [here](https://uclahs-cds.github.io/public-R-BoutrosLab-plotting-general/authors.html) and [here](https://github.com/uclahs-cds/public-R-BoutrosLab-plotting-general/graphs/contributors) at GitHub
For lists of contributors please visit [here](https://uclahs-cds.github.io/package-BoutrosLab-plotting-general/authors.html) and [here](https://github.com/uclahs-cds/package-BoutrosLab-plotting-general/graphs/contributors) at GitHub

## Citation information

Expand Down Expand Up @@ -156,4 +156,4 @@ Copyright (C) 2014-2018 Ontario Institute for Cancer Research and 2018-2023 Univ

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Loading

0 comments on commit 6bf75bc

Please sign in to comment.