|
1 |
| -# Single-cell analysis template repository |
| 1 | +# CellRank protocols |
2 | 2 |
|
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. |
23 | 4 |
|
24 | 5 | ## Installation
|
25 | 6 |
|
26 | 7 | ```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 . |
30 | 10 |
|
31 | 11 | 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" |
33 | 13 | ```
|
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