Skip to content

Commit f58a67a

Browse files
authored
Update README and JupyterBook (#11)
* Update README * Update JupyterBook details
1 parent 1c2bb7f commit f58a67a

File tree

4 files changed

+28
-40
lines changed

4 files changed

+28
-40
lines changed

README.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,16 @@
11
# CellRank protocols
22

3-
This repository provides the protocols and corresponding preprocessing for CellRank-based trajectory inference.
3+
This repository provides protocols and corresponding preprocessing for CellRank-based trajectory inference.
4+
Data used in the different use cases is made available in [this](https://doi.org/10.6084/m9.figshare.c.7752290.v1)
5+
figshare collection.
46

57
## Installation
68

79
```bash
810
conda create -n crp-py311 python=3.11 --yes && conda activate crp-py311
9-
pip install -e .
1011

11-
pip install jupyterlab ipywidgets
12+
conda install -c conda-forge cellrank
13+
pip install -e ".[jupyter]"
14+
1215
python -m ipykernel install --user --name crp-py311 --display-name "crp-py311"
1316
```

notebooks/_config.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
title: Single-cell analysis repository
1+
title: CellRank protocol
22
author: Philipp Weiler
33
execute:
44
execute_notebooks: "off"
55

66
repository:
7-
url: https://github.com/WeilerP/sc_analysis_template
7+
url: https://github.com/theislab/cellrank_protocol
88
html:
99
use_repository_button: true

notebooks/_toc.yml

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,18 @@ root: index
33
parts:
44
- caption: Template
55
chapters:
6-
- file: template
6+
7+
- caption: CytoTRACEKernel
8+
chapters:
9+
- file: cytrotrace/cellrank
10+
- caption: PseudotimeKernel
11+
chapters:
12+
- file: pseudotime/preprocessing
13+
- file: pseudotime/cellrank
14+
- caption: RealTimeKernel
15+
chapters:
16+
- file: realtime/cellrank
17+
- caption: VelocityKernel
18+
chapters:
19+
- file: velocity/preprocessing
20+
- file: velocity/cellrank

notebooks/index.md

Lines changed: 5 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,13 @@
1-
# Single-cell analysis template repository
1+
# CellRank protocols
22

3-
This repository acts as a template notebook for the analysis of single-cell data and methods; the corresponding Jupyter
4-
Book is rendered [here](https://weilerp.github.io/sc_analysis_template/).
5-
You can check the [CellRank 2 reproducibility repository](https://github.com/theislab/cellrank2_reproducibility)
6-
for an example repository following the same outline as this template.
7-
8-
## Set up
9-
10-
1. Rename `src/fancypackage/`.
11-
2. Update `pyproject.toml` to include the correct information
12-
- Project name
13-
- Project description
14-
- Project-specific Python requirements
15-
- Project author
16-
- Project maintainers
17-
- Project URLs
18-
3. Update `src/fancypackage/core/_constants.py` to include any paths relevant to your analysis and that should be accessible from any script or Jupyter notebook
19-
4. Update this README to include the relevant information about your project.
20-
5. Ensure repository settings are set up correctly to build Jupyter Book:
21-
- In `Settings > Actions > General > Workflow permissions`: Allow read and write permissions.
22-
- In `Settings > Pages > Build and deployment`: Set the branch to `gh-pages`.
3+
This repository provides the protocols and corresponding preprocessing for CellRank-based trajectory inference.
234

245
## Installation
256

267
```bash
27-
conda create -n fancyname-pyXX python=X.X --yes && conda activate fancyname-pyXX
28-
pip install -e ".[dev]"
29-
pre-commit install
8+
conda create -n crp-py311 python=3.11 --yes && conda activate crp-py311
9+
pip install -e .
3010

3111
pip install jupyterlab ipywidgets
32-
python -m ipykernel install --user --name fancyname-pyXX --display-name "fancyname-pyXX"
12+
python -m ipykernel install --user --name crp-py311 --display-name "crp-py311"
3313
```
34-
35-
## Things to keep in mind
36-
37-
Whenever you use a new single-cell tool, add it to `known_bio` in `pyproject.toml` s.t. `isort` can work correctly.
38-
39-
## Workflow
40-
41-
The workflow for committing a notebook is as follows: Upon committing a notebook, the pre-commit hooks format your notebook
42-
and generate a corresponding script. You need to add the formatted notebook and Python script to the same commit for the commit to go through. The commit will now either be successful or not. If not, your Python script was formatted by the pre-commit hooks. In that case, you need to update your notebook accordingly, unstage the Python script, and recommit the notebook. You will iterate through this process until there are no inconsistencies between the notebook and its corresponding Python script.

0 commit comments

Comments
 (0)