---
output: github_document
description: |
  "This file creates README.md, README.md MUST NOT BE CHANGED MANUALLY"
  "The last chunk includes the What's New file, can safely be excluded by eval=FALSE"
  
knit: (function(inputFile, encoding) {
    rmarkdown::render(inputFile, output_file="README.md", encoding = encoding, output_dir = "../") })
---

<!-- PLEASE DO NOT EDIT ./README.md BY HAND, EDIT ./inst/README.Rmd AND RENDER TO CREATE ./README.md -->


```{r setup, include=FALSE}
library(knitr)
library(badger)
opts_chunk$set(
  echo = TRUE,
  eval = FALSE,
  warning = FALSE,
  fig.path = "whatsnew-files/",
  fig.asp = 1,
  out.width = "50%",
  cache = FALSE
)
```

`r badge_last_commit("EvaYiwenWang/PLSDAbatch", branch='master')`
`r badge_license("GPL-3")`
`r badge_code_size("EvaYiwenWang/PLSDAbatch")`
`r badge_repostatus("Active")`

# PLSDAbatch 
A multivariate and non-parametric batch effect correction framework based on Projection to Latent Structures Discriminant Analysis for microbiome data.
This repository contains the `R` package hosted on Bioconductor.

## Maintainer
[Yiwen (Eva) Wang](mailto:wangyiwen@caas.cn)

## Installation

(**macOS users only:** Ensure you have installed [XQuartz](https://www.xquartz.org/) first.)

Make sure you have the latest R version and the latest `BiocManager` package installed following [these instructions](https://www.bioconductor.org/install/).

```{r}
## install BiocManager if not installed
if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
```

Ensure the following returns `TRUE`, or follow the guidelines provided by the output.

```{r}
BiocManager::valid()
```


#### a) Latest `Bioconductor` Release (not now, wait for Bioconductor release)

You can install `PLSDAbatch` using the following code:

```{r}
BiocManager::install('PLSDAbatch')
```

#### b) `GitHub` Version

Install the GitHub version with:

```{r}
# without vignette
BiocManager::install("EvaYiwenWang/PLSDAbatch") 

# with vignette
devtools::install_github("https://github.com/EvaYiwenWang/PLSDAbatch", build_vignettes = T)
```

## Functions preview

```{r}
library(PLSDAbatch)

## names
ls('package:PLSDAbatch')

## names and details
lsf.str('package:PLSDAbatch')
```

## Vignette View

```{r}
browseVignettes("PLSDAbatch")
```


## Bug reports/Feature requests

[Open a new issue](https://github.com/EvaYiwenWang/PLSDAbatch/issues).

## Reference

Wang, Y., & Lê Cao, K. A. (2023). PLSDA-batch: a multivariate framework to correct for batch effects in microbiome data. Briefings in Bioinformatics, 24(2), bbac622.

https://academic.oup.com/bib/article/24/2/bbac622/6991121 (The mentioned simulations and analyses in the paper are separately stored [here](https://evayiwenwang.github.io/PLSDAbatch_workflow/).)



```{r, eval=TRUE, child = 'README-WhatsNew.Rmd'}
```
