Skip to content

Commit 5f467b7

Browse files
committed
documentation involving pcb-aoi singletask and incremental learning corrected
documentation involving pcb-aoi singletask and incremental learning corrected Signed-off-by: Aryan Nanda <[email protected]> path error corrected Signed-off-by: Aryan Nanda <[email protected]>
1 parent 8260643 commit 5f467b7

10 files changed

+67
-61
lines changed

docs/guides/how-to-build-simulation-env.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,11 @@ benchmarkingjob:
3838
name: "benchmarkingjob"
3939
# the url address of job workspace that will reserve the output of tests; string type;
4040
# default value: "./workspace"
41-
workspace: "/ianvs/incremental_learning_bench/workspace"
41+
workspace: "./workspace/incremental_learning_bench"
4242

4343
# the url address of test environment configuration file; string type;
4444
# the file format supports yaml/yml;
45-
testenv: "./examples/pcb-aoi/incremental_learning_bench/testenv/testenv.yaml"
45+
testenv: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/testenv.yaml"
4646
# the configuration of test object
4747
test_object:
4848
...

docs/guides/how-to-contribute-test-environments.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,9 @@ testenv:
2020
# dataset configuration
2121
dataset:
2222
# the url address of train dataset index; string type;
23-
train_url: "/ianvs/dataset/train_data/index.txt"
23+
train_index: "./dataset/train_data/index.txt"
2424
# the url address of test dataset index; string type;
25-
test_url: "/ianvs/dataset/test_data/index.txt"
25+
test_index: "./dataset/test_data/index.txt"
2626

2727
# model eval configuration of incremental learning;
2828
model_eval:
@@ -31,7 +31,7 @@ testenv:
3131
# metric name; string type;
3232
name: "f1_score"
3333
# the url address of python file
34-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
34+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
3535

3636
# condition of triggering inference model to update
3737
# threshold of the condition; types are float/int
@@ -45,7 +45,7 @@ testenv:
4545
# metric name; string type;
4646
- name: "f1_score"
4747
# the url address of python file
48-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
48+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
4949
- name: "samples_transfer_ratio"
5050

5151
# incremental rounds setting for incremental learning paradigm.; int type; default value is 2;

docs/guides/how-to-test-algorithms.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,9 @@ testenv:
2727
# dataset configuration
2828
dataset:
2929
# the url address of train dataset index; string type;
30-
train_url: "/ianvs/dataset/train_data/index.txt"
30+
train_index: "./dataset/train_data/index.txt"
3131
# the url address of test dataset index; string type;
32-
test_url: "/ianvs/dataset/test_data/index.txt"
32+
test_index: "./dataset/test_data/index.txt"
3333

3434
# model eval configuration of incremental learning;
3535
model_eval:
@@ -38,7 +38,7 @@ testenv:
3838
# metric name; string type;
3939
name: "f1_score"
4040
# the url address of python file
41-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
41+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
4242

4343
# condition of triggering inference model to update
4444
# threshold of the condition; types are float/int
@@ -52,7 +52,7 @@ testenv:
5252
# metric name; string type;
5353
- name: "f1_score"
5454
# the url address of python file
55-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
55+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
5656
- name: "samples_transfer_ratio"
5757

5858
# incremental rounds setting for incremental learning paradigm.; int type; default value is 2;
@@ -63,7 +63,7 @@ The URL address of this test environment, i.e., testenv.yaml, then should be fil
6363
6464
``` yaml
6565
# benchmarkingJob.yaml
66-
testenv: "./examples/pcb-aoi/benchmarkingjob/testenv/testenv.yaml"
66+
testenv: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/testenv.yaml"
6767
```
6868
6969
## Step 2. Test Case Preparation
@@ -252,7 +252,7 @@ algorithm:
252252
# 1> "default": the dataset is evenly divided based train_ratio;
253253
splitting_method: "default"
254254
# the url address of initial model for model pre-training; string url;
255-
initial_model_url: "/ianvs/initial_model/model.zip"
255+
initial_model_url: "./initial_model/model.zip"
256256
257257
# algorithm module configuration in the paradigm; list type;
258258
modules:
@@ -264,7 +264,7 @@ algorithm:
264264
# example: basemodel.py has BaseModel module that the alias is "FPN" for this benchmarking;
265265
name: "FPN"
266266
# the url address of python module; string type;
267-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/basemodel.py"
267+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/basemodel.py"
268268
269269
# hyperparameters configuration for the python module; list type;
270270
hyperparameters:
@@ -283,7 +283,7 @@ algorithm:
283283
# name of python module; string type;
284284
name: "IBT"
285285
# the url address of python module; string type;
286-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/hard_example_mining.py"
286+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/hard_example_mining.py"
287287
# hyperparameters configuration for the python module; list type;
288288
hyperparameters:
289289
# name of the hyperparameter; string type;
@@ -311,7 +311,7 @@ The URL address of this algorithm then should be filled in the configuration fil
311311
- name: "fpn_incremental_learning"
312312
# the url address of test algorithm configuration file; string type;
313313
# the file format supports yaml/yml
314-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/fpn_algorithm.yaml"
314+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/fpn_algorithm.yaml"
315315
```
316316

317317
or
@@ -328,7 +328,7 @@ or
328328
- name: "fpn_singletask_learning"
329329
# the url address of test algorithm configuration file; string type;
330330
# the file format supports yaml/yml;
331-
url: "./examples/pcb-aoi/singletask_learning_bench/testalgorithms/fpn/fpn_algorithm.yaml"
331+
url: "./examples/pcb-aoi/singletask_learning_bench/fault_detection/testalgorithms/fpn/fpn_algorithm.yaml"
332332
```
333333

334334
## Step 3. ianvs Configuration
@@ -339,20 +339,21 @@ First, the user can configure the workspace to reserve the output of tests.
339339

340340
``` yaml
341341
# benchmarkingJob.yaml
342-
workspace: "/ianvs/pcb-aoi/workspace/"
342+
workspace: "./workspace/incremental_learning_bench"
343343
```
344344

345345
Then, the user fill in the test environment and algorithm configured in previous steps.
346346

347347
``` yaml
348348
# benchmarkingJob.yaml
349-
testenv: ".examples/pcb-aoi/benchmarkingjob/testenv/testenv.yaml"
349+
testenv: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/testenv.yaml"
350350
```
351351

352352
``` yaml
353+
# benchmarkingJob.yaml
353354
algorithms:
354355
- name: "fpn_incremental_learning"
355-
url: "./examples/pcb-aoi/benchmarkingjob/testalgorithms/fpn_incremental_learning/fpn_algorithm.yaml"
356+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/fpn_algorithm.yaml"
356357
```
357358

358359
As the final leaderboard, the user can configure how to rank the leaderboard with the specific metric and order.

docs/leaderboards/leaderboard-in-industrial-defect-detection-of-PCB-AoI/leaderboard-of-single-task-learning.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@
22

33

44

5-
|rank |algorithm |f1_score |paradigm |basemodel |learning_rate |momentum |time |
6-
|:----:|:-----------------------:|:--------:|:------------------:|:---------:|:-------------:|:--------:|:------------------------ |
7-
|1 |fpn_singletask_learning | 0.8396 |singletasklearning | FPN | 0.1 | 0.5 | 2022-07-07 20:33:53 |
8-
|2 |fpn_singletask_learning | 0.8353 |singletasklearning | FPN | 0.1 | 0.95 | 2022-07-07 20:31:08 |
5+
6+
| rank | algorithm | f1_score | paradigm | basemodel | basemodel-momentum | basemodel-learning_rate | time | url |
7+
|:----:|:------------------------:|:--------:|:------------------:|:---------:|:------------------:|:---------------------:|:---------------------:|:--------------------------------------------------------------------------------------- |
8+
| 1 | fpn_singletask_learning | 0.8527 | singletasklearning | FPN | 0.5 | 0.1 | 2025-01-06 14:30:30 | ./workspace/benchmarkingjob/fpn_singletask_learning/3a76bc25-cc0b-11ef-9f00-65cc74a7c013 |
9+
| 2 | fpn_singletask_learning | 0.8440 | singletasklearning | FPN | 0.95 | 0.1 | 2025-01-06 14:25:18 | ./workspace/benchmarkingjob/fpn_singletask_learning/3a76bc24-cc0b-11ef-9f00-65cc74a7c013 |

docs/proposals/test-reports/testing-incremental-learning-in-industrial-defect-detection-with-pcb-aoi.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ testenv:
3939
# dataset configuration
4040
dataset:
4141
# the url address of train dataset index; string type;
42-
train_url: "/ianvs/dataset/train_data/index.txt"
42+
train_index: "./dataset/train_data/index.txt"
4343
# the url address of test dataset index; string type;
44-
test_url: "/ianvs/dataset/test_data/index.txt"
44+
test_index: "./dataset/test_data/index.txt"
4545

4646
# model eval configuration of incremental learning;
4747
model_eval:
@@ -50,7 +50,7 @@ testenv:
5050
# metric name; string type;
5151
name: "f1_score"
5252
# the url address of python file
53-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
53+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
5454

5555
# condition of triggering inference model to update
5656
# threshold of the condition; types are float/int
@@ -64,7 +64,7 @@ testenv:
6464
# metric name; string type;
6565
- name: "f1_score"
6666
# the url address of python file
67-
url: "./examples/pcb-aoi/incremental_learning_bench/testenv/f1_score.py"
67+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/f1_score.py"
6868
- name: "samples_transfer_ratio"
6969

7070
# incremental rounds setting for incremental learning paradigm.; int type; default value is 2;
@@ -90,7 +90,7 @@ algorithm:
9090
# 1> "default": the dataset is evenly divided based train_ratio;
9191
splitting_method: "default"
9292
# the url address of initial model for model pre-training; string url;
93-
initial_model_url: "/ianvs/initial_model/model.zip"
93+
initial_model_url: "./initial_model/model.zip"
9494

9595
# algorithm module configuration in the paradigm; list type;
9696
modules:
@@ -102,7 +102,7 @@ algorithm:
102102
# example: basemodel.py has BaseModel module that the alias is "FPN" for this benchmarking;
103103
name: "FPN"
104104
# the url address of python module; string type;
105-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/basemodel.py"
105+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/basemodel.py"
106106

107107
# hyperparameters configuration for the python module; list type;
108108
hyperparameters:
@@ -118,13 +118,13 @@ algorithm:
118118
# the url addresses of hyperparameters configuration files; list type;
119119
# type of the value is string;
120120
values:
121-
- "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/fpn_hyperparameter.yaml"
121+
- "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/fpn_hyperparameter.yaml"
122122
# 2> "hard_example_mining": check hard example when predict ; optional module;
123123
- type: "hard_example_mining"
124124
# name of python module; string type;
125125
name: "IBT"
126126
# the url address of python module; string type;
127-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/hard_example_mining.py"
127+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/hard_example_mining.py"
128128
# hyperparameters configuration for the python module; list type;
129129
hyperparameters:
130130
# name of the hyperparameter; string type;

docs/proposals/test-reports/testing-single-task-learning-in-industrial-defect-detection-with-pcb-aoi.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -30,16 +30,16 @@ testenv:
3030
# dataset configuration
3131
dataset:
3232
# the url address of train dataset index; string type;
33-
train_url: "/ianvs/dataset/train_data/index.txt"
33+
train_index: "./dataset/train_data/index.txt"
3434
# the url address of test dataset index; string type;
35-
test_url: "/ianvs/dataset/test_data/index.txt"
35+
test_index: "./dataset/test_data/index.txt"
3636

3737
# metrics configuration for test case's evaluation; list type;
3838
metrics:
3939
# metric name; string type;
4040
- name: "f1_score"
4141
# the url address of python file
42-
url: "./examples/pcb-aoi/singletask_learning_bench/testenv/f1_score.py"
42+
url: "./examples/pcb-aoi/singletask_learning_bench/fault_detection/testenv/f1_score.py"
4343
```
4444
4545
Key settings of the algorithm to single learning are as follows:
@@ -53,7 +53,7 @@ algorithm:
5353
# 2> "incrementallearning"
5454
paradigm_type: "singletasklearning"
5555
# the url address of initial model; string type; optional;
56-
initial_model_url: "/ianvs/initial_model/model.zip"
56+
initial_model_url: "./initial_model/model.zip"
5757

5858
# algorithm module configuration in the paradigm; list type;
5959
modules:
@@ -65,7 +65,7 @@ algorithm:
6565
# example: basemodel.py has BaseModel module that the alias is "FPN" for this benchmarking;
6666
name: "FPN"
6767
# the url address of python module; string type;
68-
url: "./examples/pcb-aoi/singletask_learning_bench/testalgorithms/fpn/basemodel.py"
68+
url: "./examples/pcb-aoi/singletask_learning_bench/fault_detection/testalgorithms/fpn/basemodel.py"
6969

7070
# hyperparameters configuration for the python module; list type;
7171
hyperparameters:
@@ -81,7 +81,7 @@ algorithm:
8181
# the url addresses of hyperparameters configuration files; list type;
8282
# type of the value is string;
8383
values:
84-
- "./examples/pcb-aoi/singletask_learning_bench/testalgorithms/fpn/fpn_hyperparameter.yaml"
84+
- "./examples/pcb-aoi/singletask_learning_bench/fault_detection/testalgorithms/fpn/fpn_hyperparameter.yaml"
8585

8686
```
8787

docs/user_interface/how-to-config-algorithm.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ algorithm:
2424
incremental_learning_data_setting:
2525
...
2626
# the url address of initial model for model pre-training; string url;
27-
initial_model_url: "/ianvs/initial_model/model.zip"
27+
initial_model_url: "./initial_model/model.zip"
2828

2929
# algorithm module configuration in the paradigm; list type;
3030
modules:
@@ -73,7 +73,7 @@ modules:
7373
# example: basemodel.py has BaseModel module that the alias is "FPN" for this benchmarking;
7474
name: "FPN"
7575
# the url address of python module; string type;
76-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/basemodel.py"
76+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/basemodel.py"
7777

7878
# hyperparameters configuration for the python module; list type;
7979
hyperparameters:
@@ -83,7 +83,7 @@ modules:
8383
# name of python module; string type;
8484
name: "IBT"
8585
# the url address of python module; string type;
86-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/hard_example_mining.py"
86+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/hard_example_mining.py"
8787
# hyperparameters configuration for the python module; list type;
8888
hyperparameters:
8989
...
@@ -141,7 +141,7 @@ algorithm:
141141
# 1> "default": the dataset is evenly divided based train_ratio;
142142
splitting_method: "default"
143143
# the url address of initial model for model pre-training; string url;
144-
initial_model_url: "/ianvs/initial_model/model.zip"
144+
initial_model_url: "./initial_model/model.zip"
145145

146146
# algorithm module configuration in the paradigm; list type;
147147
modules:
@@ -153,7 +153,7 @@ algorithm:
153153
# example: basemodel.py has BaseModel module that the alias is "FPN" for this benchmarking;
154154
name: "FPN"
155155
# the url address of python module; string type;
156-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/basemodel.py"
156+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/basemodel.py"
157157

158158
# hyperparameters configuration for the python module; list type;
159159
hyperparameters:
@@ -172,7 +172,7 @@ algorithm:
172172
# name of python module; string type;
173173
name: "IBT"
174174
# the url address of python module; string type;
175-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/hard_example_mining.py"
175+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/hard_example_mining.py"
176176
# hyperparameters configuration for the python module; list type;
177177
hyperparameters:
178178
# name of the hyperparameter; string type;

docs/user_interface/how-to-config-benchmarkingjob.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,11 @@ benchmarkingjob:
2020
name: "benchmarkingjob"
2121
# the url address of job workspace that will reserve the output of tests; string type;
2222
# default value: "./workspace"
23-
workspace: "/ianvs/incremental_learning_bench/workspace"
23+
workspace: "./workspace/incremental_learning_bench"
2424

2525
# the url address of test environment configuration file; string type;
2626
# the file format supports yaml/yml;
27-
testenv: "./examples/pcb-aoi/incremental_learning_bench/testenv/testenv.yaml"
27+
testenv: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/testenv.yaml"
2828
# the configuration of test object
2929
test_object:
3030
...
@@ -69,7 +69,7 @@ algorithms:
6969
- name: "fpn_incremental_learning"
7070
# the url address of test algorithm configuration file; string type;
7171
# the file format supports yaml/yml
72-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/fpn_algorithm.yaml"
72+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/fpn_algorithm.yaml"
7373
```
7474
7575
### The configuration of rank
@@ -166,11 +166,11 @@ benchmarkingjob:
166166
name: "benchmarkingjob"
167167
# the url address of job workspace that will reserve the output of tests; string type;
168168
# default value: "./workspace"
169-
workspace: "/ianvs/incremental_learning_bench/workspace"
169+
workspace: "./workspace/incremental_learning_bench"
170170

171171
# the url address of test environment configuration file; string type;
172172
# the file format supports yaml/yml;
173-
testenv: "./examples/pcb-aoi/incremental_learning_bench/testenv/testenv.yaml"
173+
testenv: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testenv/testenv.yaml"
174174

175175
# the configuration of test object
176176
test_object:
@@ -183,7 +183,7 @@ benchmarkingjob:
183183
- name: "fpn_incremental_learning"
184184
# the url address of test algorithm configuration file; string type;
185185
# the file format supports yaml/yml
186-
url: "./examples/pcb-aoi/incremental_learning_bench/testalgorithms/fpn/fpn_algorithm.yaml"
186+
url: "./examples/pcb-aoi/incremental_learning_bench/fault_detection/testalgorithms/fpn/fpn_algorithm.yaml"
187187

188188
# the configuration of ranking leaderboard
189189
rank:

0 commit comments

Comments
 (0)