Skip to content

Commit

Permalink
update docs site to reflect version bump
Browse files Browse the repository at this point in the history
  • Loading branch information
mvfki committed Mar 21, 2024
1 parent 3739d1c commit 59336ee
Show file tree
Hide file tree
Showing 3 changed files with 20 additions and 7 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/r.yml
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ jobs:
shell: Rscript {0}

- name: Check
run: rcmdcheck::rcmdcheck(args = c("--no-manual", "--as-cran"), error_on = "warning")
run: rcmdcheck::rcmdcheck(args = c("--no-manual"), error_on = "warning")
shell: Rscript {0}

- name: Run codecov
Expand Down
1 change: 1 addition & 0 deletions _pkgdown.yml
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,7 @@ reference:
- makeFeatureMatrix
- mergeH5
- mergeSparseAll
- writeH5
- title: "Deprecated"
- contents:
- ends_with("deprecated")
Expand Down
24 changes: 18 additions & 6 deletions vignettes/articles/installation.Rmd
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Install LIGER with R"
author: "Yichen Wang"
date: "2023-11-05"
date: "2024-03-20"
output:
html_document:
toc: 3
Expand All @@ -22,18 +22,30 @@ To install the latest stable release, please run the following command in R cons
install.packages("rliger")
```

Besides, we now move the core implementation of iNMF related algorithms to a separate package [RcppPlanc](https://github.com/welch-lab/RcppPlanc), with decent performance improvement. It **must** be installed for performing integration analysis. We currently host it on [R-universe](https://welch-lab.r-universe.dev/RcppPlanc) as we are actively submitting it to CRAN. Please run the following command in R console to install it.

```{R}
install.packages("RcppPlanc", repos = "https://welch-lab.r-universe.dev")
```

## Building from source

The developmental versions as well as source version of the previous versions are accessible from GitHub. We are currently contributing to the repository `welch-lab/liger` in branch `newObj` for the latest developmental version. To install the latest version from GitHub, please run the following command in R console:
The developmental versions as well as source version of the previous versions are accessible from GitHub. To install the latest version from GitHub, please run the following command in R console:

```{R}
if (!requireNamespace("devtools")) install.packages("devtools")
devtools::install_github("welch-lab/liger@newObj")
devtools::install_github("welch-lab/liger")
```

If you still need to work with the previous version (1.0.1):

```{R}
devtools::install_github("welch-lab/liger", ref = "v1.0.1")
```

If you encounter issues when building from source, please see below sections for details about some dependencies.

**Please note that the latest version (>=1.99.0) is massively updated compared to prior versions, and functions are not directly compatible with the old version objects which users might possess. Please use `readLiger()` to load old RDS files or `convertOldLiger()` to convert a loaded object into the up-to-date structure. You might need to be careful when overwriting existing analysis because we don't provide methods to convert new the structure backwards.**
**Please note that version 2.0.0 is massively updated compared to prior versions, and functions are not directly compatible with liger objects created with the old versions which users might possess. Please use `readLiger()` to load old RDS files or `convertOldLiger()` to convert a loaded object into the up-to-date structure. You might need to be careful when overwriting existing analysis because we don't provide methods to convert new the structure backwards.**

### Compiler setup

Expand All @@ -47,14 +59,14 @@ HDF5 library is required for interacting with H5 files. It can be installed via

| System | Command
|:------------------------------------------|:---------------------------------|
|OS X (using Homebrew or Conda) | `brew install hdf5` or `conda install -c anaconda hdf5`
|macOS (using Homebrew or Conda) | `brew install hdf5` or `conda install -c anaconda hdf5`
|Debian-based systems (including Ubuntu) | `sudo apt-get install libhdf5-dev`
|Systems supporting yum and RPMs | `sudo yum install hdf5-devel`
|Windows | Go to [HDF5 website](https://www.hdfgroup.org/downloads/hdf5/) and download the proper installer

### Installing RcppPlanc

[RcppPlanc](https://github.com/welch-lab/RcppPlanc) is an extension R package built basing on [Planc](https://github.com/ramkikannan/planc). We implemented highly optimized iNMF algorithm and its variants here for the new version upgrade. It is currently only available via GitHub.
[RcppPlanc](https://github.com/welch-lab/RcppPlanc) is an extension R package built basing on [Planc](https://github.com/ramkikannan/planc). We implemented highly optimized iNMF algorithm and its variants here for the new version upgrade. To install it from source:

```{R}
devtools::install_github("welch-lab/RcppPlanc")
Expand Down

0 comments on commit 59336ee

Please sign in to comment.