Skip to content

Commit 57fb610

Browse files
committed
update readme
Signed-off-by: Can-Zhao <[email protected]>
1 parent adc5292 commit 57fb610

File tree

3 files changed

+6
-6
lines changed

3 files changed

+6
-6
lines changed

generation/maisi/README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,7 @@ For example,
168168
To run the inference script, please run:
169169
```bash
170170
export MONAI_DATA_DIRECTORY=<dir_you_will_download_data>
171-
python -m scripts.inference -c ./configs/config_maisi.json -i ./configs/config_infer.json -e ./configs/environment.json --random-seed 0
171+
python -m scripts.inference -c ./configs/config_maisi3d-ddpm.json -i ./configs/config_infer.json -e ./configs/environment.json --random-seed 0
172172
```
173173

174174
Please refer to [maisi_inference_tutorial.ipynb](maisi_inference_tutorial.ipynb) for the tutorial for MAISI model inference.
@@ -216,7 +216,7 @@ Please refer to [maisi_train_vae_tutorial.ipynb](maisi_train_vae_tutorial.ipynb)
216216

217217
#### [3.2 3D Latent Diffusion Training](./scripts/diff_model_train.py)
218218

219-
Please refer to [maisi_diff_unet_training_tutorial.ipynb](maisi_diff_unet_training_tutorial.ipynb) for the tutorial for MAISI diffusion model training.
219+
Please refer to [maisi_train_diff_unet_tutorial.ipynb](maisi_train_diff_unet_tutorial.ipynb) for the tutorial for MAISI diffusion model training.
220220

221221
#### [3.3 3D ControlNet Training](./scripts/train_controlnet.py)
222222

@@ -234,7 +234,7 @@ The training was performed with the following:
234234
#### Execute Training:
235235
To train with a single GPU, please run:
236236
```bash
237-
python -m scripts.train_controlnet -c ./configs/config_maisi.json -t ./configs/config_maisi_controlnet_train.json -e ./configs/environment_maisi_controlnet_train.json -g 1
237+
python -m scripts.train_controlnet -c ./configs/config_maisi3d-ddpm.json -t ./configs/config_maisi_controlnet_train.json -e ./configs/environment_maisi_controlnet_train.json -g 1
238238
```
239239

240240
The training script also enables multi-GPU training. For instance, if you are using eight GPUs, you can run the training script with the following command:
@@ -244,7 +244,7 @@ torchrun \
244244
--nproc_per_node=${NUM_GPUS_PER_NODE} \
245245
--nnodes=1 \
246246
--master_addr=localhost --master_port=1234 \
247-
-m scripts.train_controlnet -c ./configs/config_maisi.json -t ./configs/config_maisi_controlnet_train.json -e ./configs/environment_maisi_controlnet_train.json -g ${NUM_GPUS_PER_NODE}
247+
-m scripts.train_controlnet -c ./configs/config_maisi3d-ddpm.json -t ./configs/config_maisi_controlnet_train.json -e ./configs/environment_maisi_controlnet_train.json -g ${NUM_GPUS_PER_NODE}
248248
```
249249
Please also check [maisi_train_controlnet_tutorial.ipynb](./maisi_train_controlnet_tutorial.ipynb) for more details about data preparation and training parameters.
250250

generation/maisi/maisi_train_controlnet_tutorial.ipynb

+1-1
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@
127127
"\n",
128128
"Choose between `'maisi3d-ddpm'` and `'maisi3d-rflow'`. The differences are:\n",
129129
"- The maisi version `'maisi3d-ddpm'` uses basic noise scheduler DDPM. `'maisi3d-rflow'` uses Rectified Flow scheduler, can be 33 times faster during inference.\n",
130-
"- The maisi version `'maisi3d-ddpm'` requires training images to be labeled with body region (`\"top_region_index\"` and `\"bottom_region_index\"`), while `'maisi3d-rflow'` does not have such requirement. In other words, it is easier to prepare training data for `'maisi3d-rflow'`.\n",
130+
"- The maisi version `'maisi3d-ddpm'` requires training images to be labeled with body regions (`\"top_region_index\"` and `\"bottom_region_index\"`), while `'maisi3d-rflow'` does not have such requirement. In other words, it is easier to prepare training data for `'maisi3d-rflow'`.\n",
131131
"- For the released model weights, `'maisi3d-rflow'` can generate images with better quality for head region and small output volumes, and comparable quality for other cases compared with `'maisi3d-ddpm'`."
132132
]
133133
},

generation/maisi/maisi_train_diff_unet_tutorial.ipynb

+1-1
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@
129129
"\n",
130130
"Choose between `'maisi3d-ddpm'` and `'maisi3d-rflow'`. The differences are:\n",
131131
"- The maisi version `'maisi3d-ddpm'` uses basic noise scheduler DDPM. `'maisi3d-rflow'` uses Rectified Flow scheduler, can be 33 times faster during inference.\n",
132-
"- The maisi version `'maisi3d-ddpm'` requires training images to be labeled with body region (`\"top_region_index\"` and `\"bottom_region_index\"`), while `'maisi3d-rflow'` does not have such requirement. In other words, it is easier to prepare training data for `'maisi3d-rflow'`.\n",
132+
"- The maisi version `'maisi3d-ddpm'` requires training images to be labeled with body regions (`\"top_region_index\"` and `\"bottom_region_index\"`), while `'maisi3d-rflow'` does not have such requirement. In other words, it is easier to prepare training data for `'maisi3d-rflow'`.\n",
133133
"- For the released model weights, `'maisi3d-rflow'` can generate images with better quality for head region and small output volumes, and comparable quality for other cases compared with `'maisi3d-ddpm'`."
134134
]
135135
},

0 commit comments

Comments
 (0)