Skip to content

Commit 39ca0a2

Browse files
author
Thiago Crepaldi
committed
Merge branch 'pull/3482'
Signed-off-by: Thiago Crepaldi <[email protected]>
2 parents 93f875c + 124163a commit 39ca0a2

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

Documentation/Documents/Configuration Files.md

+17-17
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ this “append” processing is not used for arrays elements, and the entire arr
9999
The ‘\#’ character signifies the beginning of a comment, everything that occurs after the ‘\#’ is ignored. The ‘\#’ must be preceded by whitespace or be at the beginning of the line to be interpreted as a comment. The following are valid comments, and an example of a value that will not be interpreted as a comment:
100100

101101
```
102-
#commands used will be appended the stderr name to create a path
102+
# commands used will be appended the stderr name to create a path
103103
stderr=c:\cntk\log\cntk # "_mnistTrain_mnistTest.log" would be appended
104104
# the parameter below is set to infinity, the ‘#’ in ‘1#INF’ is not a comment marker
105105
var = 1#INF
@@ -115,11 +115,11 @@ Here is a simple example of a configuration file:
115115
# sample configuration file for CNTK
116116
command=mnistTrain:mnistTest
117117
118-
#global parameters, all commands use these values unless overridden at a higher level
118+
# global parameters, all commands use these values unless overridden at a higher level
119119
precision=float
120120
deviceId=auto
121121
122-
#commands used will be appended the stderr name to create a path
122+
# commands used will be appended the stderr name to create a path
123123
stderr=c:\cntk\log\cntk # “_mnistTrain_mnistTest.log” would be appended
124124
traceLevel=0 # larger values mean more output
125125
ndlMacros=C:\cntk\config\DefaultMacros.ndl
@@ -136,7 +136,7 @@ mnistTrain=[
136136
run=ndlMacroUse
137137
]
138138
SGD=[
139-
#modelPath - moved to root level to share with mnistTest
139+
# modelPath - moved to root level to share with mnistTest
140140
learningRatesPerMB=0.001
141141
maxEpochs=50
142142
]
@@ -276,7 +276,7 @@ mnistTrain=[
276276
run=ndlMacroUse
277277
]
278278
SGD=[
279-
#modelPath - moved to root level to share with mnistTest
279+
# modelPath - moved to root level to share with mnistTest
280280
learningRatesPerMB=0.001
281281
maxEpochs=50
282282
]
@@ -925,11 +925,11 @@ The following is an example of a BinaryWriter definition. Since it is most commo
925925
926926
#### write definition
927927
wfile=c:\data\mnist\mnist_train.bin
928-
#wsize - inital size of the file in MB
928+
# wsize - inital size of the file in MB
929929
# if calculated size would be bigger, that is used instead
930930
wsize=256
931931
932-
#wrecords - number of records we should allocate space for in the file
932+
# wrecords - number of records we should allocate space for in the file
933933
# files cannot be expanded, so this should be large enough.
934934
wrecords=60000
935935
@@ -939,8 +939,8 @@ The following is an example of a BinaryWriter definition. Since it is most commo
939939
file=c:\data\mnist\mnist_train.txt
940940
941941
### write definition
942-
#wsize=200
943-
#wfile=c:\data\mnist\mnist_train_features.bin
942+
# wsize=200
943+
# wfile=c:\data\mnist\mnist_train_features.bin
944944
sectionType=data
945945
]
946946
labels=[
@@ -953,22 +953,22 @@ The following is an example of a BinaryWriter definition. Since it is most commo
953953
954954
#### Write definition ####
955955
# sizeof(unsigned) which is the label index type
956-
#wsize=10
957-
#wfile=c:\data\mnist\mnist_train_labels.bin
956+
# wsize=10
957+
# wfile=c:\data\mnist\mnist_train_labels.bin
958958
elementSize=4
959959
wref=features
960960
sectionType=labels
961961
mapping=[
962-
#redefine number of records for this section,
963-
#since we don't need to save it for each data record
962+
# redefine number of records for this section,
963+
# since we don't need to save it for each data record
964964
wrecords=10
965-
#variable size so use an average string size
965+
# variable size so use an average string size
966966
elementSize=10
967967
sectionType=labelMapping
968968
]
969969
category=[
970970
dim=10
971-
#elementSize=sizeof(ElemType) is default
971+
# elementSize=sizeof(ElemType) is default
972972
sectionType=categoryLabels
973973
]
974974
]
@@ -1154,7 +1154,7 @@ The key class that is used to allow the JIT evaluation of configuration strings
11541154

11551155
Configuration files are mainly made up of a hierarchy of Configuration Sets (*ConfigParameters*), which are dictionaries of *ConfigValue*. This class provides access to the configuration values and automatically searches up the hierarchy of ConfigParameter classes if a value is not found on the current level. The hierarchy is maintained by the order of class instantiations on the stack. ConfigParameters should only be created on the stack.
11561156

1157-
In configuration files the ‘name=value’ named pair are usually separated by newlines. However, they also can be separated by other characters and placed on the same line. The default separator for ConfigParmeters is a ‘;’ (semicolon). This can be overridden by placing the alternate separator character immediately following the opening brace. For example ‘\[|’ causes ‘|’ to be the separator for that ConfigParameter instance:
1157+
In configuration files the ‘name=value’ named pair are usually separated by newlines. However, they also can be separated by other characters and placed on the same line. The default separator for ConfigParameters is a ‘;’ (semicolon). This can be overridden by placing the alternate separator character immediately following the opening brace. For example ‘\[|’ causes ‘|’ to be the separator for that ConfigParameter instance:
11581158

11591159
```
11601160
name=[|parameter1=value1|parameter2=value2|parameter3=value3]
@@ -1524,7 +1524,7 @@ descriptor->FunctionParam(1-inputIndex, paramOptionsInput);
15241524
descriptor->GradientParam(inputIndex, paramOptionsInput | paramOptionsOutput | paramOptionsInitialize);
15251525
```
15261526

1527-
The second parameter is interesting because it is required to retain it value from one call to the next, this is done in a filter graph by having a parameter be input and output at the same time, meaning it updates itself. There is a clear distinction between values that need to be maintained and those that are transcient in a filter graph, and this idiom is how we instruct PTaskGraphBuilder to retain the value. The Initialize option is also necessary so on the first iteration the matrix will be cleared out (zeros).
1527+
The second parameter is interesting because it is required to retain its value from one call to the next, this is done in a filter graph by having a parameter in input and output at the same time, meaning it updates itself. There is a clear distinction between values that need to be maintained and those that are transcient in a filter graph, and this idiom is how we instruct PTaskGraphBuilder to retain the value. The Initialize option is also necessary so on the first iteration the matrix will be cleared out (zeros).
15281528

15291529
The last parameter is the gradient matrix of the current node, and is an input (defaults for this function).
15301530

0 commit comments

Comments
 (0)