Skip to content

Commit 5fcbb9c

Browse files
Update README.md
1 parent 0980273 commit 5fcbb9c

1 file changed

Lines changed: 18 additions & 18 deletions

File tree

README.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,8 @@ conda activate /nfs/team361/aa36/PythonEnvs_2/envinflowdec27/
2020

2121
Alternatively, you can create the python environment yourself:
2222
```commandline
23-
git clone https://github.com/Lotfollahi-lab/inflow.git # clone the repo
24-
cd ./inflow/
23+
git clone https://github.com/Lotfollahi-lab/mintflow.git # clone the repo
24+
cd ./mintflow/
2525
conda env create -f environment.yml --prefix SOME_EMPTY_PATH
2626
```
2727

@@ -30,24 +30,24 @@ It's highly recommended to setup wandb before proceeding.
3030

3131
To do so:
3232
- Go to https://wandb.ai/ and create an account.
33-
- Create a project called "inFlow".
33+
- Create a project called "MintFlow".
3434

3535
## Quick Start
36-
You can use inflow as a local package, because it's not pip installable at the moment.
36+
You can use mintflow as a local package, because it's not pip installable at the moment.
3737

3838
To do so:
3939
```commandline
40-
git clone https://github.com/Lotfollahi-lab/inflow.git # clone the repo
41-
cd ./inflow/
40+
git clone https://github.com/Lotfollahi-lab/mintflow.git # clone the repo
41+
cd ./mintflow/
4242
```
43-
The easiest way to run inflow is through the command line interface (CLI).
43+
The easiest way to run MintFlow is through the command line interface (CLI).
4444
This involves two steps
4545
1. Creating four config files (you duplicate/modify template config files).
46-
2. Running inflow with a single command line.
46+
2. Running mintflow with a single command line.
4747

4848
### Rule of thumbs §1 for modifying the config files
4949
In the template config files, there are `TODO`-s of different types that you may need to modify
50-
- Category 1: `TODO:ESSENTIAL:TUNE`: the basic/essential parts to run inflow.
50+
- Category 1: `TODO:ESSENTIAL:TUNE`: the basic/essential parts to run mintflow.
5151
- Category 2: `TODO:TUNE`: less essneitial and/or technical details.
5252
- Category 3: `TODO:check`: parameters of even less importance compared to category 1 and category 2.
5353

@@ -58,7 +58,7 @@ If you are, for example, a biologist with no interest/experience in computationa
5858
Please follow these steps
5959
- Training data config file:
6060
- Make a copy of `./cli/SampleConfigFiles/config_data_train.yml` and rename it to `YOUR_CONFIG_DATA_TRAIN.yml`
61-
- Read the block of comments tarting with *"# Inflow expects a list of .h5ad files stored on disk, ..."*.
61+
- Read the block of comments tarting with *"# MintFlow expects a list of .h5ad files stored on disk, ..."*.
6262
- Modify some parts marked by `TODO:...` and according to *"Rule of thumbs §1"* explained above.
6363

6464

@@ -76,29 +76,29 @@ Please follow these steps
7676
- Make a copy of `./cli/SampleConfigFiles/config_training.yml` and rename it to `YOUR_CONFIG_TRAINING.yml`.
7777
- Modify some parts marked by `TODO:...` and according to *"Rule of thumbs §1"* explained above.
7878

79-
### Step 2 of Using the CLI: Running inflow
79+
### Step 2 of Using the CLI: Running MintFlow
8080

8181
```commandline
82-
cd ./inflow/ # if you haven't already done it above.
82+
cd ./mintflow/ # if you haven't already done it above.
8383
cd ./cli/
8484
85-
python inflow_cli.py \
85+
python mintflow_cli.py \
8686
--file_config_data_train YOUR_CONFIG_DATA_TRAIN.yml \
8787
--file_config_data_test YOUR_CONFIG_DATA_TEST.yml \
8888
--file_config_model YOUR_CONFIG_MODEL.yml \
8989
--file_config_training YOUR_CONFIG_TRAINING.yml \
9090
--path_output "./Your/Output/Path/ToDump/Results/" \
9191
--flag_verbose "True" \
9292
```
93-
The recommended way of accessing inflow predictions is by `adata_inflowOutput_norm.h5ad` and `adata_inflowOutput_unnorm.h5ad` created in the provided `--path_output`and `adata.obsm` and `adata.uns` in these files.
94-
In the former file `..._norm.h5ad` the readcount matrix `adata.X` as well as inflow predictions Xint and Xspl are row normalised, while in the latter file `_unnorm.h5ad` they are not.
93+
The recommended way of accessing MintFlow predictions is by `adata_mintflowOutput_norm.h5ad` and `adata_mintflowOutput_unnorm.h5ad` created in the provided `--path_output`and `adata.obsm` and `adata.uns` in these files.
94+
In the former file `..._norm.h5ad` the readcount matrix `adata.X` as well as MintFlow predictions Xint and Xspl are row normalised, while in the latter file `_unnorm.h5ad` they are not.
9595

96-
Inflow dumps a README file in the provided `--path_output`, as well as each subfolder therein.
96+
MintFlow dumps a README file in the provided `--path_output`, as well as each subfolder therein.
9797

9898
## Common Issues
99-
- Use absolute paths (and not relative paths like `../../some/path/`) in the config files, as well as when running `python inflow_cli.py ...`.
99+
- Use absolute paths (and not relative paths like `../../some/path/`) in the config files, as well as when running `python mintflow_cli.py ...`.
100100
- TODO: intro to the script for tune window width.
101-
- It's common to face out of memory issue in the very last step where the big anndata objects `adata_inflowOutput_norm.h5ad` and `adata_inflowOutput_unnorm.h5ad` are created and dumped.
101+
- It's common to face out of memory issue in the very last step where the big anndata objects `adata_mintflowOutput_norm.h5ad` and `adata_mintflowOutput_unnorm.h5ad` are created and dumped.
102102
If that step fails, the results are still accesible in the output path the subfolder `CheckpointAndPredictions/`.
103103
One can laod the `.pt` files by
104104
```python

0 commit comments

Comments
 (0)