Improved Readme
This commit is contained in:
parent
1233c8a3be
commit
67afc86242
1
FastCAR
1
FastCAR
@ -1 +0,0 @@
|
|||||||
Subproject commit 2121cbd359630af53c002dd3e082621010111346
|
|
20
FastCAR.Rproj
Normal file
20
FastCAR.Rproj
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
Version: 1.0
|
||||||
|
|
||||||
|
RestoreWorkspace: Default
|
||||||
|
SaveWorkspace: Default
|
||||||
|
AlwaysSaveHistory: Default
|
||||||
|
|
||||||
|
EnableCodeIndexing: Yes
|
||||||
|
UseSpacesForTab: Yes
|
||||||
|
NumSpacesForTab: 2
|
||||||
|
Encoding: UTF-8
|
||||||
|
|
||||||
|
RnwWeave: Sweave
|
||||||
|
LaTeX: pdfLaTeX
|
||||||
|
|
||||||
|
AutoAppendNewline: Yes
|
||||||
|
StripTrailingWhitespace: Yes
|
||||||
|
|
||||||
|
BuildType: Package
|
||||||
|
PackageUseDevtools: Yes
|
||||||
|
PackageInstallArgs: --no-multiarch --with-keep.source
|
BIN
Images/Example_profile.png
Normal file
BIN
Images/Example_profile.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 20 KiB |
103
README.md
103
README.md
@ -1,3 +1,104 @@
|
|||||||
# FastCAR
|
# FastCAR
|
||||||
|
|
||||||
Repo for the FastCAR (Fast Correction of Ambient RNA) R package and maybe eventual python library
|
FastCAR is an R package to remove ambient RNA from cells in droplet based single cell RNA sequencing data.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
What things you need to install the software and how to install them
|
||||||
|
|
||||||
|
```
|
||||||
|
Give examples
|
||||||
|
```
|
||||||
|
|
||||||
|
### Installing
|
||||||
|
|
||||||
|
FastCAR can be install from git with the following command.
|
||||||
|
|
||||||
|
```
|
||||||
|
devtools::install_git("https://git.web.rug.nl/P278949/FastCAR")
|
||||||
|
```
|
||||||
|
|
||||||
|
Running FastCAR is quite simple.
|
||||||
|
First load the library and dependencies.
|
||||||
|
|
||||||
|
```
|
||||||
|
library(Matrix)
|
||||||
|
library(Seurat)
|
||||||
|
library(qlcMatrix)
|
||||||
|
library(FastCAR)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
cellExpressionFolder = c("Cellranger_output/sample1/filtered_feature_bc_matrix/")
|
||||||
|
fullMatrixFolder = c("Cellranger_output/sample1/raw_feature_bc_matrix/")
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
|
# This folder will contain the corrected cell matrix
|
||||||
|
correctedMatrixFolder = c("Cellranger_output/sample1/corrected_feature_bc_matrix")
|
||||||
|
|
||||||
|
|
||||||
|
cellMatrix = read.cell.matrix(cellExpressionFolder)
|
||||||
|
fullMatrix = read.full.matrix(fullMatrixFolder)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
The following functions give an idea of the effect that different settings have on the ambient RNA profile
|
||||||
|
|
||||||
|
```
|
||||||
|
ambProfile = describe.ambient.RNA.sequence(fullCellMatrix = fullMatrix, start = 10, stop = 500, by = 10, contaminationChanceCutoff = 0.05)
|
||||||
|
plot.ambient.profile(ambProfile)
|
||||||
|
|
||||||
|
```
|
||||||
|

|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Set
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
emptyDropletCutoff = 100
|
||||||
|
contaminationChanceCutoff = 0.05
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
ambientProfile = determine.background.to.remove(fullMatrix, cellMatrix, emptyDropletCutoff, contaminationChanceCutoff)
|
||||||
|
cellMatrix = remove.background(cellMatrix, ambientProfile)
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally write the corrected cell/gene matrix to a file, this matrix can be used in Seurat the same way as any other cell/gene matrix.
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
write.corrected.matrix(cellMatrix, correctedMatrixFolder, ambientProfile)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
End with an example of getting some data out of the system or using it for a little demo
|
||||||
|
|
||||||
|
## Running the tests
|
||||||
|
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
* **Marijn Berg** - *Initial work*
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the GPL-3 License - see the [LICENSE.md](LICENSE.md) file for details
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user