monai
medical
katielink commited on
Commit
9a0d90d
1 Parent(s): d56249f

add non-deterministic note

Browse files
Files changed (3) hide show
  1. README.md +6 -0
  2. configs/metadata.json +3 -2
  3. docs/README.md +6 -0
README.md CHANGED
@@ -59,6 +59,9 @@ In Evaluation Mode: A list of dictionaries of predicted box, classification labe
59
  ## Performance
60
  Coco metric is used for evaluating the performance of the model. The pre-trained model was trained and validated on data fold 0. This model achieves a mAP=0.853, mAR=0.994, AP(IoU=0.1)=0.862, AR(IoU=0.1)=1.0.
61
 
 
 
 
62
  #### Training Loss
63
  ![A graph showing the detection train loss](https://developer.download.nvidia.com/assets/Clara/Images/monai_retinanet_detection_train_loss.png)
64
 
@@ -73,16 +76,19 @@ In addition to the Pythonic APIs, a few command line interfaces (CLI) are provid
73
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
74
 
75
  #### Execute training:
 
76
  ```
77
  python -m monai.bundle run --config_file configs/train.json
78
  ```
79
 
80
  #### Override the `train` config to execute evaluation with the trained model:
 
81
  ```
82
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
83
  ```
84
 
85
  #### Execute inference on resampled LUNA16 images by setting `"whether_raw_luna16": false` in `inference.json`:
 
86
  ```
87
  python -m monai.bundle run --config_file configs/inference.json
88
  ```
 
59
  ## Performance
60
  Coco metric is used for evaluating the performance of the model. The pre-trained model was trained and validated on data fold 0. This model achieves a mAP=0.853, mAR=0.994, AP(IoU=0.1)=0.862, AR(IoU=0.1)=1.0.
61
 
62
+ Please note that this bundle is non-deterministic because of the max pooling layer used in the network. Therefore, reproducing the training process may not get exactly the same performance.
63
+ Please refer to https://pytorch.org/docs/stable/notes/randomness.html#reproducibility for more details about reproducibility.
64
+
65
  #### Training Loss
66
  ![A graph showing the detection train loss](https://developer.download.nvidia.com/assets/Clara/Images/monai_retinanet_detection_train_loss.png)
67
 
 
76
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
77
 
78
  #### Execute training:
79
+
80
  ```
81
  python -m monai.bundle run --config_file configs/train.json
82
  ```
83
 
84
  #### Override the `train` config to execute evaluation with the trained model:
85
+
86
  ```
87
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
88
  ```
89
 
90
  #### Execute inference on resampled LUNA16 images by setting `"whether_raw_luna16": false` in `inference.json`:
91
+
92
  ```
93
  python -m monai.bundle run --config_file configs/inference.json
94
  ```
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.5.3",
4
  "changelog": {
 
5
  "0.5.3": "adapt to BundleWorkflow interface",
6
  "0.5.2": "black autofix format and add name tag",
7
  "0.5.1": "modify dataset key name",
@@ -17,7 +18,7 @@
17
  "0.1.1": "add reference for LIDC dataset",
18
  "0.1.0": "complete the model package"
19
  },
20
- "monai_version": "1.2.0rc3",
21
  "pytorch_version": "1.13.1",
22
  "numpy_version": "1.22.2",
23
  "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.5.4",
4
  "changelog": {
5
+ "0.5.4": "add non-deterministic note",
6
  "0.5.3": "adapt to BundleWorkflow interface",
7
  "0.5.2": "black autofix format and add name tag",
8
  "0.5.1": "modify dataset key name",
 
18
  "0.1.1": "add reference for LIDC dataset",
19
  "0.1.0": "complete the model package"
20
  },
21
+ "monai_version": "1.2.0rc4",
22
  "pytorch_version": "1.13.1",
23
  "numpy_version": "1.22.2",
24
  "optional_packages_version": {
docs/README.md CHANGED
@@ -52,6 +52,9 @@ In Evaluation Mode: A list of dictionaries of predicted box, classification labe
52
  ## Performance
53
  Coco metric is used for evaluating the performance of the model. The pre-trained model was trained and validated on data fold 0. This model achieves a mAP=0.853, mAR=0.994, AP(IoU=0.1)=0.862, AR(IoU=0.1)=1.0.
54
 
 
 
 
55
  #### Training Loss
56
  ![A graph showing the detection train loss](https://developer.download.nvidia.com/assets/Clara/Images/monai_retinanet_detection_train_loss.png)
57
 
@@ -66,16 +69,19 @@ In addition to the Pythonic APIs, a few command line interfaces (CLI) are provid
66
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
67
 
68
  #### Execute training:
 
69
  ```
70
  python -m monai.bundle run --config_file configs/train.json
71
  ```
72
 
73
  #### Override the `train` config to execute evaluation with the trained model:
 
74
  ```
75
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
76
  ```
77
 
78
  #### Execute inference on resampled LUNA16 images by setting `"whether_raw_luna16": false` in `inference.json`:
 
79
  ```
80
  python -m monai.bundle run --config_file configs/inference.json
81
  ```
 
52
  ## Performance
53
  Coco metric is used for evaluating the performance of the model. The pre-trained model was trained and validated on data fold 0. This model achieves a mAP=0.853, mAR=0.994, AP(IoU=0.1)=0.862, AR(IoU=0.1)=1.0.
54
 
55
+ Please note that this bundle is non-deterministic because of the max pooling layer used in the network. Therefore, reproducing the training process may not get exactly the same performance.
56
+ Please refer to https://pytorch.org/docs/stable/notes/randomness.html#reproducibility for more details about reproducibility.
57
+
58
  #### Training Loss
59
  ![A graph showing the detection train loss](https://developer.download.nvidia.com/assets/Clara/Images/monai_retinanet_detection_train_loss.png)
60
 
 
69
  For more details usage instructions, visit the [MONAI Bundle Configuration Page](https://docs.monai.io/en/latest/config_syntax.html).
70
 
71
  #### Execute training:
72
+
73
  ```
74
  python -m monai.bundle run --config_file configs/train.json
75
  ```
76
 
77
  #### Override the `train` config to execute evaluation with the trained model:
78
+
79
  ```
80
  python -m monai.bundle run --config_file "['configs/train.json','configs/evaluate.json']"
81
  ```
82
 
83
  #### Execute inference on resampled LUNA16 images by setting `"whether_raw_luna16": false` in `inference.json`:
84
+
85
  ```
86
  python -m monai.bundle run --config_file configs/inference.json
87
  ```