monai
medical
katielink commited on
Commit
9b1d3a3
1 Parent(s): 0238d7d

add non-deterministic note

Browse files
Files changed (3) hide show
  1. README.md +7 -1
  2. configs/metadata.json +3 -2
  3. docs/README.md +7 -1
README.md CHANGED
@@ -62,11 +62,13 @@ Dice score was used for evaluating the performance of the model. This model achi
62
  - Enhancing tumor (ET): 0.7905
63
  - Average: 0.8518
64
 
 
 
 
65
  #### Training Loss and Dice
66
  ![A graph showing the training loss and the mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_train.png)
67
 
68
  #### Validation Dice
69
-
70
  ![A graph showing the validation mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_val.png)
71
 
72
  ## MONAI Bundle Commands
@@ -75,11 +77,13 @@ In addition to the Pythonic APIs, a few command line interfaces (CLI) are provid
75
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
76
 
77
  #### Execute training:
 
78
  ```
79
  python -m monai.bundle run --config_file configs/train.json
80
  ```
81
 
82
  #### Override the `train` config to execute multi-GPU training:
 
83
  ```
84
  torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config_file "['configs/train.json','configs/multi_gpu_train.json']"
85
  ```
@@ -87,11 +91,13 @@ torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config
87
  Please note that the distributed training-related options depend on the actual running environment; thus, users may need to remove `--standalone`, modify `--nnodes`, or do some other necessary changes according to the machine used. For more details, please refer to [pytorch's official tutorial](https://pytorch.org/tutorials/intermediate/ddp_tutorial.html).
88
 
89
  #### Override the `train` config to execute evaluation with the trained model:
 
90
  ```
91
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
92
  ```
93
 
94
  #### Execute inference:
 
95
  ```
96
  python -m monai.bundle run --config_file configs/inference.json
97
  ```
 
62
  - Enhancing tumor (ET): 0.7905
63
  - Average: 0.8518
64
 
65
+ Please note that this bundle is non-deterministic because of the trilinear interpolation used in the network. Therefore, reproducing the training process may not get exactly the same performance.
66
+ Please refer to https://pytorch.org/docs/stable/notes/randomness.html#reproducibility for more details about reproducibility.
67
+
68
  #### Training Loss and Dice
69
  ![A graph showing the training loss and the mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_train.png)
70
 
71
  #### Validation Dice
 
72
  ![A graph showing the validation mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_val.png)
73
 
74
  ## MONAI Bundle Commands
 
77
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
78
 
79
  #### Execute training:
80
+
81
  ```
82
  python -m monai.bundle run --config_file configs/train.json
83
  ```
84
 
85
  #### Override the `train` config to execute multi-GPU training:
86
+
87
  ```
88
  torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config_file "['configs/train.json','configs/multi_gpu_train.json']"
89
  ```
 
91
  Please note that the distributed training-related options depend on the actual running environment; thus, users may need to remove `--standalone`, modify `--nnodes`, or do some other necessary changes according to the machine used. For more details, please refer to [pytorch's official tutorial](https://pytorch.org/tutorials/intermediate/ddp_tutorial.html).
92
 
93
  #### Override the `train` config to execute evaluation with the trained model:
94
+
95
  ```
96
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
97
  ```
98
 
99
  #### Execute inference:
100
+
101
  ```
102
  python -m monai.bundle run --config_file configs/inference.json
103
  ```
configs/metadata.json CHANGED
@@ -1,7 +1,8 @@
1
  {
2
  "schema": "https://github.com/Project-MONAI/MONAI-extra-test-data/releases/download/0.8.1/meta_schema_20220324.json",
3
- "version": "0.4.0",
4
  "changelog": {
 
5
  "0.4.0": "adapt to BundleWorkflow interface",
6
  "0.3.9": "black autofix format and add name tag",
7
  "0.3.8": "modify dataset key name",
@@ -18,7 +19,7 @@
18
  "0.1.1": "update for MetaTensor",
19
  "0.1.0": "complete the model package"
20
  },
21
- "monai_version": "1.2.0rc3",
22
  "pytorch_version": "1.13.1",
23
  "numpy_version": "1.22.2",
24
  "optional_packages_version": {
 
1
  {
2
  "schema": "https://github.com/Project-MONAI/MONAI-extra-test-data/releases/download/0.8.1/meta_schema_20220324.json",
3
+ "version": "0.4.1",
4
  "changelog": {
5
+ "0.4.1": "add non-deterministic note",
6
  "0.4.0": "adapt to BundleWorkflow interface",
7
  "0.3.9": "black autofix format and add name tag",
8
  "0.3.8": "modify dataset key name",
 
19
  "0.1.1": "update for MetaTensor",
20
  "0.1.0": "complete the model package"
21
  },
22
+ "monai_version": "1.2.0rc4",
23
  "pytorch_version": "1.13.1",
24
  "numpy_version": "1.22.2",
25
  "optional_packages_version": {
docs/README.md CHANGED
@@ -55,11 +55,13 @@ Dice score was used for evaluating the performance of the model. This model achi
55
  - Enhancing tumor (ET): 0.7905
56
  - Average: 0.8518
57
 
 
 
 
58
  #### Training Loss and Dice
59
  ![A graph showing the training loss and the mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_train.png)
60
 
61
  #### Validation Dice
62
-
63
  ![A graph showing the validation mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_val.png)
64
 
65
  ## MONAI Bundle Commands
@@ -68,11 +70,13 @@ In addition to the Pythonic APIs, a few command line interfaces (CLI) are provid
68
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
69
 
70
  #### Execute training:
 
71
  ```
72
  python -m monai.bundle run --config_file configs/train.json
73
  ```
74
 
75
  #### Override the `train` config to execute multi-GPU training:
 
76
  ```
77
  torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config_file "['configs/train.json','configs/multi_gpu_train.json']"
78
  ```
@@ -80,11 +84,13 @@ torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config
80
  Please note that the distributed training-related options depend on the actual running environment; thus, users may need to remove `--standalone`, modify `--nnodes`, or do some other necessary changes according to the machine used. For more details, please refer to [pytorch's official tutorial](https://pytorch.org/tutorials/intermediate/ddp_tutorial.html).
81
 
82
  #### Override the `train` config to execute evaluation with the trained model:
 
83
  ```
84
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
85
  ```
86
 
87
  #### Execute inference:
 
88
  ```
89
  python -m monai.bundle run --config_file configs/inference.json
90
  ```
 
55
  - Enhancing tumor (ET): 0.7905
56
  - Average: 0.8518
57
 
58
+ Please note that this bundle is non-deterministic because of the trilinear interpolation used in the network. Therefore, reproducing the training process may not get exactly the same performance.
59
+ Please refer to https://pytorch.org/docs/stable/notes/randomness.html#reproducibility for more details about reproducibility.
60
+
61
  #### Training Loss and Dice
62
  ![A graph showing the training loss and the mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_train.png)
63
 
64
  #### Validation Dice
 
65
  ![A graph showing the validation mean dice over 300 epochs](https://developer.download.nvidia.com/assets/Clara/Images/monai_brats_mri_segmentation_val.png)
66
 
67
  ## MONAI Bundle Commands
 
70
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
71
 
72
  #### Execute training:
73
+
74
  ```
75
  python -m monai.bundle run --config_file configs/train.json
76
  ```
77
 
78
  #### Override the `train` config to execute multi-GPU training:
79
+
80
  ```
81
  torchrun --standalone --nnodes=1 --nproc_per_node=8 -m monai.bundle run --config_file "['configs/train.json','configs/multi_gpu_train.json']"
82
  ```
 
84
  Please note that the distributed training-related options depend on the actual running environment; thus, users may need to remove `--standalone`, modify `--nnodes`, or do some other necessary changes according to the machine used. For more details, please refer to [pytorch's official tutorial](https://pytorch.org/tutorials/intermediate/ddp_tutorial.html).
85
 
86
  #### Override the `train` config to execute evaluation with the trained model:
87
+
88
  ```
89
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
90
  ```
91
 
92
  #### Execute inference:
93
+
94
  ```
95
  python -m monai.bundle run --config_file configs/inference.json
96
  ```