---
title: "Reconstructing ordered ontogenic trajectories"
author: "Wajid Jawaid"
date: "`r Sys.Date()`"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{Infer biologically plausible journeys through single cell data}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

Reconstructing ordered ontogenic trajectories provides methods for identifying informative genes (crude), finding a sparse graph structure between cells and traversing the graph in a biologiclal informed way using a directed non-markovian monte-carlo method.

The main goal of *roots* is to infer plausible developmental journeys guided by the user.

## Installation

```{r installation, echo=TRUE, eval=FALSE}
library(devtools)
install_github("wjawaid/roots")
``` 

## Example

Here I take the mouse adult haematopoietic data from ([Nestorowa et al.] (http://www.bloodjournal.org/content/early/2016/06/30/blood-2016-05-716480)). Data is downloaded and processed using the *goggles()* function as below.

```{r example, echo=TRUE, eval=FALSE}
library(roots)

## Load data
blood <- read.table("http://blood.stemcells.cam.ac.uk/data/norm_counts_nestorowa_data.txt", sep = " ")
cellNames <- read.table("http://blood.stemcells.cam.ac.uk/data/cell_names_nestorowa_data.txt", sep = " ", stringsAsFactors = FALSE)[,1]
rownames(blood) <- gsub("LT\\.", "LT-", cellNames)
geneNames <- read.table("http://blood.stemcells.cam.ac.uk/data/gene_names_nestorowa_data.txt", sep = " ", stringsAsFactors = FALSE)[,1]
colnames(blood) <- geneNames
blood <- as.matrix(blood)
rm(cellNames, geneNames)

## Load metadata
meta <- read.csv("http://blood.stemcells.cam.ac.uk/data/wj_out_jd.csv")
colnames(meta) <- c("cellType", "index", "name")
rownames(meta) <- meta$name
meta$col <- bglab::ggCol(meta$cellType)
nmeta <- data.frame(col=rep("#00000011", nrow(blood)), stringsAsFactors = FALSE, row.names = rownames(blood))
nmeta[rownames(meta),"col"] <- meta$col
leg <- data.frame(cell=as.character(unique(meta$cellType)), col=as.character(unique(meta$col)), stringsAsFactors = FALSE)
legOrd <- c(5, 8, 6, 7, 1, 4, 2, 3)

## Analyse
xx <- goggles(blood)

## Plot
plot(xx$l, pch=16, col = nmeta[rownames(xx$l), "col"])
legend("topright", legend = leg$cell[legOrd], fill=leg$col[legOrd], inset=0.02)

```

![Output from goggle() function](example.png
)