From 0135f439f36e7d2945827ebf76f434802162bce7 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 18 Dec 2023 17:14:58 -0800 Subject: [PATCH 01/17] Conventions: Tidy up "create an MLActivation" internal steps * Update callers to use dfn autolinks (for type checking) * Remove assertion about builder argument (simplify) * Remove test/exception for name argument (not needed) For #450 and #455 --- index.bs | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/index.bs b/index.bs index 2cb5a06b..c98ce5ab 100644 --- a/index.bs +++ b/index.bs @@ -891,8 +891,6 @@ The {{MLActivation}} objects (including the ones passed as input to methods) are To create an MLActivation given |builder|, |name|, |options| and |init-steps|, run the following steps:
- 1. [=Assert=]: the type of |builder| is {{MLGraphBuilder}}. - 1. If |name| is empty, then [=exception/throw=] a "{{TypeError}}". 1. Let |activation| be a new [=object=]. 1. Set |activation|.{{MLActivation/[[builder]]}} to |builder|. 1. Set |activation|.{{MLActivation/[[name]]}} to |name|. @@ -1825,7 +1823,7 @@ partial interface MLGraphBuilder {
1. If running the check clamp options steps given |options| returns false, then [=exception/throw=] a {{TypeError}}. - 1. Let |op| be the result of creating an MLActivation given [=this=], `"clamp"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"clamp"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -2847,7 +2845,7 @@ partial interface MLGraphBuilder { The elu(|options|) method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=], `"elu"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"elu"` and |options|. 1. Return |op|.
@@ -3587,7 +3585,7 @@ partial interface MLGraphBuilder { The hardSigmoid(|options|) method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=], `"hardSigmoid"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"hardSigmoid"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -3666,7 +3664,7 @@ partial interface MLGraphBuilder { The hardSwish() method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=] and `"hardSwish"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"hardSwish"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -4000,7 +3998,7 @@ partial interface MLGraphBuilder { The leakyRelu(|options|) method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=], `"leakyRelu"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"leakyRelu"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -4092,7 +4090,7 @@ partial interface MLGraphBuilder { The linear(|options|) method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=], `"linear"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"linear"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5202,7 +5200,7 @@ partial interface MLGraphBuilder { The relu() method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=] and `"relu"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"relu"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5473,7 +5471,7 @@ partial interface MLGraphBuilder { The sigmoid() method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=] and `"sigmoid"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"sigmoid"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5591,7 +5589,7 @@ partial interface MLGraphBuilder { The softmax() method steps are:
- 1. Let |op| be the result of creating an MLActivation given and `"softmax"`. + 1. Let |op| be the result of [=creating an MLActivation=] given and `"softmax"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5681,7 +5679,7 @@ partial interface MLGraphBuilder { The softplus(|options|) method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=], `"softplus"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"softplus"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5753,7 +5751,7 @@ partial interface MLGraphBuilder { The softsign() method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=] and `"softsign"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"softsign"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5904,7 +5902,7 @@ partial interface MLGraphBuilder { The tanh() method steps are:
- 1. Let |op| be the result of creating an MLActivation given [=this=] and `"tanh"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"tanh"`. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
From e7a5eb517e12e99aeea8b506930fa99b0cf59d9b Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 18 Dec 2023 17:30:04 -0800 Subject: [PATCH 02/17] =?UTF-8?q?Conventions:=20Use=20=C2=AB=20=C2=BB=20no?= =?UTF-8?q?tation=20for=20lists?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Note that many places still use [ ] notation; it may be better to convert those to non-normative text e.g. domintro sections, where the JS array-style notation is more common. For #450. --- index.bs | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/index.bs b/index.bs index c98ce5ab..e57c5211 100644 --- a/index.bs +++ b/index.bs @@ -1989,7 +1989,7 @@ Data truncation will occur when the values in the range exceed the range of the 1. Let |descriptor| be a new {{MLOperandDescriptor}}. 1. Set |descriptor|.{{MLOperandDescriptor/dataType}} to |type|. 1. Let |size| be *max(0, ceil((end - start)/step))*. - 1. Set |descriptor|.{{MLOperandDescriptor/dimensions}} to [|size|]. + 1. Set |descriptor|.{{MLOperandDescriptor/dimensions}} to « |size| ». 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |operand| be the result of creating an MLOperand given [=this=], |start|, |end|, |step|, and |type|. 1. Make a request to the underlying platform to: @@ -2137,12 +2137,12 @@ partial interface MLGraphBuilder { 1. If |inputSize| is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |filterSize| is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}} is not the same as |filter|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConv2dOptions/padding}} does not [=map/exist=], set it to `« 0, 0, 0, 0 »`. + 1. If |options|.{{MLConv2dOptions/padding}} does not [=map/exist=], set it to « 0, 0, 0, 0 ». 1. Else if the [=list/size=] of |options|.{{MLConv2dOptions/padding}} is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLConv2dOptions/strides}} does not [=map/exist=], set it to `« 1, 1 »`. + 1. If |options|.{{MLConv2dOptions/strides}} does not [=map/exist=], set it to « 1, 1 ». 1. Else if the [=list/size=] of |options|.{{MLConv2dOptions/strides}} is not 2, then [=exception/throw=] a {{TypeError}}. 1. If any element in |options|.{{MLConv2dOptions/strides}} is equal to 0, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConv2dOptions/dilations}} does not [=map/exist=], set it to `« 1, 1 »`. + 1. If |options|.{{MLConv2dOptions/dilations}} does not [=map/exist=], set it to « 1, 1 ». 1. Else if the [=list/size=] of |options|.{{MLConv2dOptions/dilations}} is not 2, then [=exception/throw=] a {{TypeError}}. 1. If |options|.{{MLConv2dOptions/autoPad}} does not [=map/exist=], set it to `"explicit"`. 1. If |options|.{{MLConv2dOptions/groups}} is 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. @@ -2313,14 +2313,14 @@ partial interface MLGraphBuilder { 1. If |inputSize| is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |filterSize| is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}} is not the same as {{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConvTranspose2dOptions/padding}} does not [=map/exist=], set it to `« 0, 0, 0, 0 »`. + 1. If |options|.{{MLConvTranspose2dOptions/padding}} does not [=map/exist=], set it to « 0, 0, 0, 0 ». 1. Else if the [=list/size=] of |options|.{{MLConvTranspose2dOptions/padding}} is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLConvTranspose2dOptions/strides}} does not [=map/exist=], set it to `« 1, 1 »`. + 1. If |options|.{{MLConvTranspose2dOptions/strides}} does not [=map/exist=], set it to « 1, 1 ». 1. Else if the [=list/size=] of |options|.{{MLConvTranspose2dOptions/strides}} is not 2, then [=exception/throw=] a {{TypeError}}. 1. If any element in |options|.{{MLConv2dOptions/strides}} is equal to 0, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConvTranspose2dOptions/dilations}} does not [=map/exist=], set it to `« 1, 1 »`. + 1. If |options|.{{MLConvTranspose2dOptions/dilations}} does not [=map/exist=], set it to « 1, 1 ». 1. Else if the [=list/size=] of |options|.{{MLConvTranspose2dOptions/dilations}} is not 2, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConvTranspose2dOptions/outputPadding}} does not [=map/exist=], set it to `« 0, 0 »`. + 1. If |options|.{{MLConvTranspose2dOptions/outputPadding}} does not [=map/exist=], set it to « 0, 0 ». 1. Else if the [=list/size=] of |options|.{{MLConvTranspose2dOptions/outputPadding}} is not 2, then [=exception/throw=] a {{TypeError}}. 1. If |options|.{{MLConvTranspose2dOptions/outputSizes}} [=map/exists=]: 1. If the [=list/size=] of |options|.{{MLConvTranspose2dOptions/outputSizes}} is not 2, then [=exception/throw=] a {{TypeError}}. @@ -3094,7 +3094,7 @@ partial interface MLGraphBuilder { Type compatibility between |a|, |b| and |options|.{{MLGemmOptions/c}} can be also checked.
1. Let |desc| a new {{MLOperandDescriptor}}. - 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [|shapeA|[0], |shapeB|[1]]. + 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to « |shapeA|[0], |shapeB|[1] ». 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. @@ -4572,7 +4572,7 @@ partial interface MLGraphBuilder {
1. Let |shapeA| be |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} and |sizeA| the [=list/size=] of |shapeA|. 1. Let |shapeB| be |b|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} and |sizeB| the [=list/size=] of |shapeB|. - 1. If |sizeA| and |sizeB| is 1, return `« 1 »`. + 1. If |sizeA| and |sizeB| is 1, return « 1 ». 1. If |sizeA| is 1 and |sizeB| is not, then insert 1 in the front of |shapeA| to become [ 1 | |shapeA| ] and let |sizeA| be 2. 1. If |shapeA|[0] is not equal to |shapeB|[|sizeB| - 2], then [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. If |sizeB| is 1 and |sizeA| is not, then append 1 to |shapeB| to become [ |shapeB| | 1 ] and let |sizeB| be 2. @@ -4860,18 +4860,18 @@ partial interface MLGraphBuilder { 1. If the [=list/size=] of |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |options|.{{MLPool2dOptions/windowDimensions}} [=map/exists=] and its [=list/size=] is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. Otherwise, set |options|.{{MLPool2dOptions/windowDimensions}} to the height and width dimensions of the shape of |input|. - 1. If |options|.{{MLPool2dOptions/outputSizes}} [=map/exists=], or if |options|.{{MLPool2dOptions/padding}} does not [=map/exist=], set |options|.{{MLPool2dOptions/padding}} to `« 0, 0, 0, 0 »`. + 1. If |options|.{{MLPool2dOptions/outputSizes}} [=map/exists=], or if |options|.{{MLPool2dOptions/padding}} does not [=map/exist=], set |options|.{{MLPool2dOptions/padding}} to « 0, 0, 0, 0 ». 1. If the [=list/size=] of |options|.{{MLPool2dOptions/padding}} is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLPool2dOptions/strides}} does not [=map/exist=], set |options|.{{MLPool2dOptions/strides}} to `« 1, 1 »`. + 1. If |options|.{{MLPool2dOptions/strides}} does not [=map/exist=], set |options|.{{MLPool2dOptions/strides}} to « 1, 1 ». 1. If the [=list/size=] of |options|.{{MLPool2dOptions/strides}} is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any value in |options|.{{MLPool2dOptions/strides}} is not greater than 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |options|.{{MLPool2dOptions/outputSizes}} [=map/exists=]: 1. If the [=list/size=] of |options|.{{MLPool2dOptions/outputSizes}} is not 2, then [=exception/throw=] a {{TypeError}}. 1. If the elements of |options|.{{MLPool2dOptions/outputSizes}} are not smaller than the elements at the same dimension (index) for |options|.{{MLPool2dOptions/strides}}, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLPool2dOptions/dilations}} does not [=map/exist=], set |options|.{{MLPool2dOptions/dilations}} to `« 1, 1 »`. + 1. If |options|.{{MLPool2dOptions/dilations}} does not [=map/exist=], set |options|.{{MLPool2dOptions/dilations}} to « 1, 1 ». 1. If the [=list/size=] of |options|.{{MLPool2dOptions/dilations}} is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any value in |options|.{{MLPool2dOptions/dilations}} is not greater than 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLPool2dOptions/autoPad}} is not `"explicit"`, set |options|.{{MLPool2dOptions/padding}} to `« 0, 0, 0, 0 »`. + 1. If |options|.{{MLPool2dOptions/autoPad}} is not `"explicit"`, set |options|.{{MLPool2dOptions/padding}} to « 0, 0, 0, 0 ». 1. Let |desc| be a copy of |input|.{{MLOperand/[[descriptor]]}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Make a request to the underlying platform to: @@ -5265,11 +5265,11 @@ partial interface MLGraphBuilder { To check resample options given |options|, run the following steps:
- 1. If |options|.{{MLResample2dOptions/scales}} does not [=map/exist=], set it to to `« 1.0, 1.0 »`. + 1. If |options|.{{MLResample2dOptions/scales}} does not [=map/exist=], set it to to « 1.0, 1.0 ». 1. Otherwise, if any of its values is not greater than 0, or if its [=list/size=] is not 2, return false. 1. If |options|.{{MLResample2dOptions/sizes}} [=map/exists=], and if its size is not 2, or if any of its values is not greater than 0, return false. - 1. If |options|.{{MLResample2dOptions/axes}} does not [=map/exists=], set it to `« 2, 3 »`. - 1. Otherwise, if its value is not one of `« 0, 1», « 1, 2», « 2, 3 »`, return false. + 1. If |options|.{{MLResample2dOptions/axes}} does not [=map/exists=], set it to « 2, 3 ». + 1. Otherwise, if its value is not one of « 0, 1», « 1, 2», « 2, 3 », return false. 1. Return true.
@@ -5340,9 +5340,9 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. Let |outputShape| be an empty array of {{unsigned long}}. - 1. If |newShape| is a scalar [=number=], set |outputShape| to `« 1 »`. + 1. If |newShape| is a scalar [=number=], set |outputShape| to « 1 ». 1. Otherwise, if |newShape| is an array of {{unsigned long}}: - 1. If the [=list/size=] of |newShape| is 0, set |outputShape| to `« 1 »` (reshaping to scalar). + 1. If the [=list/size=] of |newShape| is 0, set |outputShape| to « 1 » (reshaping to scalar). 1. If |newShape| contains more than one `null` value, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any value in |newShape| is 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. Let |inputElementCount| be the product of all elements in |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}. From 5e5df0e32d428f45a76bd66aafc3dca06e229f05 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 18 Dec 2023 17:46:20 -0800 Subject: [PATCH 03/17] Conventions: Use Infra map iteration in buildSync() MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit WebIDL records are reflected in Infra as ordered maps, so can be iterated using "For each key → value of map", and the funky "element.key" syntax can be retired. For #450 --- index.bs | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/index.bs b/index.bs index e57c5211..6d10a78a 100644 --- a/index.bs +++ b/index.bs @@ -1662,12 +1662,9 @@ Build a composed graph up to a given output operand into a computational graph,
The permissions and context validity have been checked by [[#api-mlgraphbuilder-constructor]] steps.
- 1. [=Assert=]: the type of |outputs| is {{MLNamedOperands}}. 1. If |outputs| is empty, then [=exception/throw=] a {{TypeError}}. - 1. [=map/For each=] |element| in |outputs|: - 1. [=Assert=]: the type of |element|.key is [=string=]. - 1. If |element|.key is empty, then [=exception/throw=] a {{TypeError}}. - 1. [=Assert=]: the type of |element|.value is {{MLOperand}}. + 1. [=map/For each=] |name| → |operand| of |outputs|: + 1. If |name| is empty, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |graph| be a new {{MLGraph}}: 1. Set |graph|.{{MLGraph/[[context]]}} to [=this=].{{MLGraphBuilder/[[context]]}}. @@ -1675,7 +1672,7 @@ Build a composed graph up to a given output operand into a computational graph, 1. Connect |graph| to a new [=implementation-defined=] graph implementation |graphImpl| given |graph|. 1. Store a reference to |graphImpl| in |graph|.{{MLGraph/[[implementation]]}}. 1. Make a request to the underlying platform to initialize the graph: - 1. [=map/For each=] |operand| in |outputs|: + 1. [=map/For each=] |name| → |operand| of |outputs|: 1. If validating MLOperand given |operand| and [=this=] returns false, then [=exception/throw=] a {{TypeError}}. 1. If |operand| was created as an input by the underlying platform: 1. If |operand|.{{MLOperand/[[name]]}}] is not unique for |graphImpl|, then [=exception/throw=] a {{TypeError}}. From 74b87c61536e655d5067c839c0d6dc412e0cb7e4 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 18 Dec 2023 17:51:49 -0800 Subject: [PATCH 04/17] Conventions: Use Infra style for iterating MLNamedArrayBufferViews MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Use "for each key → value of ..." syntax * Drop asserts for types For #450 and #455 --- index.bs | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/index.bs b/index.bs index 6d10a78a..a4a55258 100644 --- a/index.bs +++ b/index.bs @@ -1143,10 +1143,8 @@ partial interface MLContext { To validate graph resources, given |resources| and |descriptors|, run the following steps:
- 1. [=Assert=]: the type of |resources| is {{MLNamedArrayBufferViews}}. - 1. [=map/For each=] [=record=] <|key|, |value|> of |resources|: + 1. [=map/For each=] |key| → |value| of |resources|: 1. If |descriptors|[|key|] does not [=map/exist=], return false. - 1. [=Assert=]: the type of |value| is {{ArrayBufferView}}. 1. If validating buffer with descriptor given |value| and |descriptors|[|key|] returns false, then return false. 1. Return true.
@@ -1168,17 +1166,15 @@ partial interface MLContext { To execute graph, given |graph|, |inputs| and |outputs|, run the following steps:
- 1. [=Assert=]: the type of |inputs| is {{MLNamedArrayBufferViews}}. 1. Let |inputResources| denote the input resources of |graph|.{{MLGraph/[[implementation]]}}. - 1. [=map/For each=] <|key|, |inputValue|> of |inputs|: + 1. [=map/For each=] |key| → |inputValue| of |inputs|: 1. Let |inputDescriptor| be |graph|.{{MLGraph/[[inputDescriptors]]}}[|key|]. 1. Let |inputTensor| be a new tensor for |graph|.{{MLGraph/[[implementation]]}} as follows: 1. Set the data type of |inputTensor| to the one that matches the [=element type=] of |inputValue|. 1. Set the dimensions of |inputTensor| to |inputDescriptor|.{{MLOperandDescriptor/dimensions}}. 1. Set the values of elements in |inputTensor| to the values of elements in |inputValue|. 1. Request the underlying implementation of |graph| to bind |inputResources|[|key|] to |inputTensor|. - 1. [=Assert=]: the type of |outputs| is {{MLNamedArrayBufferViews}}. - 1. [=map/For each=] <|key|, |outputValue|> of |outputs|: + 1. [=map/For each=] |key| → |outputValue| of |outputs|: 1. Issue a compute request to |graph|.{{MLGraph/[[implementation]]}} given |key| and |inputResources| and wait for completion. 1. If that returns an error, then [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Otherwise, store the result in |outputTensor|. From a2866a504470b5b803b490b5b4a846532b9a2c3f Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 18 Dec 2023 17:58:03 -0800 Subject: [PATCH 05/17] Conventions: Linkify "nchw" and "nhwc" Use links to the enum member definitions, rather than just strings. For #450 --- index.bs | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/index.bs b/index.bs index a4a55258..9802c31f 100644 --- a/index.bs +++ b/index.bs @@ -1560,7 +1560,7 @@ partial interface MLGraphBuilder { : axis :: - An {{unsigned long}} scalar. Specifies the index to the feature count dimension of the input shape for which the mean and variance values are. Its value must be in the range [0, N-1] where N is the [=rank=] of the input tensor. The default value is 1, corresponding to the channel (*"c"*) dimension in the *"nchw"* data layout. + An {{unsigned long}} scalar. Specifies the index to the feature count dimension of the input shape for which the mean and variance values are. Its value must be in the range [0, N-1] where N is the [=rank=] of the input tensor. The default value is 1, corresponding to the channel (*"c"*) dimension in the {{MLInputOperandLayout/"nchw"}} data layout. : epsilon :: @@ -1611,7 +1611,7 @@ partial interface MLGraphBuilder {
- The behavior of this operation when the input tensor is 4-D of the *"nchw"* layout and the activation is of operator type *relu* can be generically emulated from the usage of other operations as follow. However, user agents typically have a more efficient implementation for it, therefore its usage is encouraged from the performance standpoint. + The behavior of this operation when the input tensor is 4-D of the {{MLInputOperandLayout/"nchw"}} layout and the activation is of operator type *relu* can be generically emulated from the usage of other operations as follow. However, user agents typically have a more efficient implementation for it, therefore its usage is encouraged from the performance standpoint. 
     const shape = [1,null,1,1];
@@ -2071,13 +2071,13 @@ partial interface MLGraphBuilder {
     ::
         An {{MLInputOperandLayout}} [=string=].
         Specifies the layout format of the input and output tensor as follows:
-            - **"nchw"**
+            - {{MLInputOperandLayout/"nchw"}}
                 - input tensor: *[batches, inputChannels, height, width]*
                 - output tensor: *[batches, outputChannels, height, width]*
-            - **"nhwc"**:
+            - {{MLInputOperandLayout/"nhwc"}}:
                 - input tensor: *[batches, height, width, inputChannels]*
                 - output tensor: *[batches, height, width, outputChannels]*
-        The default value is *"nchw"*.
+        The default value is {{MLInputOperandLayout/"nchw"}}.
 
     : filterLayout
     ::
@@ -2253,13 +2253,13 @@ partial interface MLGraphBuilder {
     ::
         An {{MLInputOperandLayout}} [=string=].
         Specifies the layout format of the input and output tensor as follows:
-            - **"nchw"**
+            - {{MLInputOperandLayout/"nchw"}}
                 - input tensor: *[batches, inputChannels, height, width]*
                 - output tensor: *[batches, outputChannels, height, width]*
-            - **"nhwc"**:
+            - {{MLInputOperandLayout/"nhwc"}}:
                 - input tensor: *[batches, height, width, inputChannels]*
                 - output tensor: *[batches, height, width, outputChannels]*
-        The default value is *"nchw"*.
+        The default value is {{MLInputOperandLayout/"nchw"}}.
 
     : filterLayout
     ::
@@ -3770,7 +3770,7 @@ The {{MLInstanceNormalizationOptions}} members are:
 

 

   
-    The behavior of this operation when the input tensor is 4-D of the *"nchw"* layout can be generically emulated from
+    The behavior of this operation when the input tensor is 4-D of the {{MLInputOperandLayout/"nchw"}} layout can be generically emulated from
     the usage of other operations as follow. However, user agents typically have a more efficient implementation for it,
     therefore its usage is encouraged from the performance standpoint.
   
@@ -4797,13 +4797,13 @@ partial interface MLGraphBuilder {
     ::
         An {{MLInputOperandLayout}} [=string=].
         Specifies the layout format of the input and output tensor as follows:
-            - **"nchw"**
+            - {{MLInputOperandLayout/"nchw"}}
                 - input tensor: *[batches, inputChannels, height, width]*
                 - output tensor: *[batches, outputChannels, height, width]*
-            - **"nhwc"**:
+            - {{MLInputOperandLayout/"nhwc"}}:
                 - input tensor: *[batches, height, width, inputChannels]*
                 - output tensor: *[batches, height, width, outputChannels]*
-        The default value is *"nchw"*.
+        The default value is {{MLInputOperandLayout/"nchw"}}.
 
     : roundingType
     ::

From abf7fa1ea0868d88240b423947c8dc4ad82e28ab Mon Sep 17 00:00:00 2001
From: Joshua Bell 
Date: Tue, 19 Dec 2023 09:24:46 -0800
Subject: [PATCH 06/17] Conventions: Replace "Store a reference" with "Set"

Follow Infra conventions for updating internal slots. No need to
use "reference" - it's implied.

For #450
---
 index.bs | 172 +++++++++++++++++++++++++++----------------------------
 1 file changed, 86 insertions(+), 86 deletions(-)

diff --git a/index.bs b/index.bs
index 9802c31f..1451487a 100644
--- a/index.bs
+++ b/index.bs
@@ -898,7 +898,7 @@ The {{MLActivation}} objects (including the ones passed as input to methods) are
     1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operator |opImpl| for the given |name| operation.
-            1. Store a reference of |opImpl| in |activation|.{{MLActivation/[[operator]]}}.
+            1. Set |activation|.{{MLActivation/[[operator]]}} to |opImpl|.
         1. If |init-steps| are defined, run |init-steps| with |options|.
             1. Otherwise, initialize |activation|.{{MLActivation/[[operator]]}} given |options| in an [=implementation-defined=] way for the given |name| operation.
     1. Return |activation|.
@@ -1502,9 +1502,9 @@ partial interface MLGraphBuilder {
         1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|.
         1. Make a request to the underlying platform to:
             1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| argMin or argMax operation, given |options|.
-            1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}.
+            1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|.
             1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|.
-            1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}.
+            1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|.
         1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|.
         1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|.
     1. Return |output|.
@@ -1666,7 +1666,7 @@ Build a composed graph up to a given output operand into a computational graph,
             1. Set |graph|.{{MLGraph/[[context]]}} to [=this=].{{MLGraphBuilder/[[context]]}}.
         1. Make a request to the underlying platform to:
             1. Connect |graph| to a new [=implementation-defined=] graph implementation |graphImpl| given |graph|.
-            1. Store a reference to |graphImpl| in |graph|.{{MLGraph/[[implementation]]}}.
+            1. Set |graph|.{{MLGraph/[[implementation]]}} to |graphImpl|.
         1. Make a request to the underlying platform to initialize the graph:
             1. [=map/For each=] |name| → |operand| of |outputs|:
                 1. If validating MLOperand given |operand| and [=this=] returns false, then [=exception/throw=] a {{TypeError}}.
@@ -1707,9 +1707,9 @@ partial interface MLGraphBuilder {
         1. Let |output| be the result of  copying an MLOperand given |input|.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operator |castImpl| for this method, given |type|.
-            1. Store a reference of |castImpl| in |output|.{{MLOperand/[[operator]]}}.
+            1. Set |output|.{{MLOperand/[[operator]]}} to |castImpl|.
             1. Create an [=implementation-defined=] platform operand |outputImpl| to represent an output, given |output| and |castImpl|.
-            1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}.
+            1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|.
         1. Connect |operand|.{{MLOperand/[[operand]]}} as input to |castImpl|.
         1. Connect |output|.{{MLOperand/[[operand]]}} as output to |castImpl|.
     1. Return |output|.
@@ -1790,9 +1790,9 @@ partial interface MLGraphBuilder {
         1. Let |output| be the result of  copying an MLOperand given |input|.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operator |clampImpl| for this method, given |options|.{{MLClampOptions/minValue}} and |options|.{{MLClampOptions/maxValue}}.
-            1. Store a reference of |clampImpl| in |output|.{{MLOperand/[[operator]]}}.
+            1. Set |output|.{{MLOperand/[[operator]]}} to |clampImpl|.
             1. Create an [=implementation-defined=] platform operand |outputImpl| to represent clamp output, given |output| and |clampImpl|.
-            1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}.
+            1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|.
         1. Connect |input|.{{MLOperand/[[operand]]}} as input to |clampImpl|.
         1. Connect |output|.{{MLOperand/[[operand]]}} as output to |clampImpl|.
     1. Return |output|.
@@ -1872,9 +1872,9 @@ partial interface MLGraphBuilder {
         1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operator |concatImpl| for this method, given |inputs| and |axis|.
-            1. Store a reference of |concatImpl| in |output|.{{MLOperand/[[operator]]}}.
+            1. Set |output|.{{MLOperand/[[operator]]}} to |concatImpl|.
             1. Create an [=implementation-defined=] platform operand |outputImpl| to represent output,given |output| and |concatImpl|.
-            1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}.
+            1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|.
         1. Connect |inputs| as input to |concatImpl|.
         1. Connect |output|.{{MLOperand/[[operand]]}} as output to |concatImpl|.
     1. Return |output|.
@@ -1911,7 +1911,7 @@ Create a constant {{MLOperand}} of the specified data type and shape that contai
         1. Let |bytes| be the result of invoking the [=get a copy of the bytes held by the buffer source=] steps given |bufferView|.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant, given |descriptor|.
-            1. Store a reference of |constantImpl| in |operand|.{{MLOperand/[[operand]]}}.
+            1. Set |operand|.{{MLOperand/[[operand]]}} to |constantImpl|.
             1. Register |operand| as a tensor constant with |bytes| as value.
     1. Return |operand|.
   

@@ -1949,7 +1949,7 @@ Data truncation will occur when the specified value exceeds the range of the spe
         1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|.
         1. Make a request to the underlying platform to:
             1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant, given |descriptor|.
-            1. Store a reference of |constantImpl| in |operand|.{{MLOperand/[[operand]]}}.
+            1. Set |operand|.{{MLOperand/[[operand]]}} to |constantImpl|.
             1. Register |operand| as a scalar constant with |value| as value.
     1. Return |operand|.
@@ -1992,7 +1992,7 @@ Data truncation will occur when the values in the range exceed the range of the 1. Set |buffer|[|index|] to |start| + (|index| * |step|). 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant operand, given |descriptor|. - 1. Store a reference of |constantImpl| in |operand|.{{MLOperand/[[operand]]}}. + 1. Set |operand|.{{MLOperand/[[operand]]}} to |constantImpl|. 1. Register |operand| as a constant with |buffer| as value. 1. Return |operand|.
@@ -2157,9 +2157,9 @@ partial interface MLGraphBuilder { 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |conv2dImpl| for this method, given |options| and |filter|. 1. If |options|.{{MLConv2dOptions/activation}} [=map/exists=],register it as activation to |conv2dImpl|. - 1. Store a reference of |conv2dImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |conv2dImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |conv2dImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |conv2dImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |conv2dImpl|. 1. Return |output|. @@ -2336,9 +2336,9 @@ partial interface MLGraphBuilder { 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |convTranspose2dImpl| for this method, given |options| and |filter|. 1. If |options|.{{MLConvTranspose2dOptions/activation}} [=map/exists=],register it as activation to |convTranspose2dImpl|. - 1. Store a reference of |convTranspose2dImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |convTranspose2dImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |convTranspose2dImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |convTranspose2dImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |convTranspose2dImpl|. 1. Return |output|. @@ -2400,9 +2400,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the binary operation |op|, given |a| and |b|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |a|.{{MLOperand/[[operand]]}} and |b|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -2537,9 +2537,9 @@ Although operations *greaterOrEqual* and *lesserOrEqual* can each be implemented 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the binary operation |op|, given |a| and |b|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |a|.{{MLOperand/[[operand]]}} and |b|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -2652,9 +2652,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the unary operation |op|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -2813,9 +2813,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the ELU operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -2880,9 +2880,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |outputDesc|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |expandImpl| for this method, given |input| and |newShape|. - 1. Store a reference of |expandImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |expandImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent output,given |output| and |expandImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input| as input to |expandImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |expandImpl|. 1. Return |output|. @@ -2956,9 +2956,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the Gather operation, given |input|, |indices|, and |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} and |indices|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3093,9 +3093,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the GEMM operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |a|.{{MLOperand/[[operand]]}} and |b|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3377,9 +3377,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for `"gruCell"`, given |weight|, |recurrentWeight|, |hiddenState|, |hiddenSize| and |options| as parameters. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3554,9 +3554,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hard sigmoid operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3634,9 +3634,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hard-swish operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3692,7 +3692,7 @@ Create a named {{MLOperand}} based on a descriptor, that can be used as an input 1. Set |operand|.{{MLOperand/[[name]]}} to |name|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform input operand |operandImpl| given |descriptor|. - 1. Store a reference of |operandImpl| in |operand|.{{MLOperand/[[operand]]}}. + 1. Set |operand|.{{MLOperand/[[operand]]}} to |operandImpl|. 1. Register |operand| as an input. 1. Return |operand|.
@@ -3758,9 +3758,9 @@ The {{MLInstanceNormalizationOptions}} members are: 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the instance normalization operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3866,9 +3866,9 @@ The {{MLLayerNormalizationOptions}} members are: 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the instance normalization operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -3967,9 +3967,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the Leaky RELU operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -4059,9 +4059,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the linear operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -4224,9 +4224,9 @@ partial interface MLGraphBuilder { 1. Otherwise, Let |output| be the array [ |output0|, |output1| ]. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the LSTM operation, given |weight|, |recurrentWeight|, |steps|, |hiddenSize| and |options|. - 1. Store a reference of |opImpl| in |output0|.{{MLOperand/[[operator]]}}, |output1|.{{MLOperand/[[operator]]}} and |output2|.{{MLOperand/[[operator]]}}. + 1. Set |output0|.{{MLOperand/[[operator]]}}, |output1|.{{MLOperand/[[operator]]}} and |output2|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output0|.{{MLOperand/[[operand]]}}, |output1|.{{MLOperand/[[operand]]}} and |output2|.{{MLOperand/[[operand]]}}. + 1. Set |output0|.{{MLOperand/[[operand]]}}, |output1|.{{MLOperand/[[operand]]}} and |output2|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output| as output to |opImpl|. 1. Return |output|. @@ -4406,9 +4406,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the array [ |output0|, |output1| ]. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the LSTM cell operation, given |weight|, |recurrentWeight|, |hiddenState|, |cellState|, |hiddenSize| and |options|. - 1. Store a reference of |opImpl| in |output0|.{{MLOperand/[[operator]]}} and |output1|.{{MLOperand/[[operator]]}}. + 1. Set |output0|.{{MLOperand/[[operator]]}} and |output1|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output0|.{{MLOperand/[[operand]]}} and |output1|.{{MLOperand/[[operand]]}}. + 1. Set |output0|.{{MLOperand/[[operand]]}} and |output1|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output| as output to |opImpl|. 1. Return |output|. @@ -4592,9 +4592,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the matrix multiplication operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |a|.{{MLOperand/[[operand]]}} and |b|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -4678,9 +4678,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the padding operation, given |beginningPadding|, |endingPadding| and |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -4871,9 +4871,9 @@ partial interface MLGraphBuilder { 1. Calculate the output dimensions given |input| and |options|. Let |desc|.{{MLOperandDescriptor/dimensions}} be the result of that. 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| pooling operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -4947,9 +4947,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the PreLU operation, given |slope|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5042,9 +5042,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| reduce operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5170,9 +5170,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the ReLU operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5295,9 +5295,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the resample 2D operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5348,9 +5348,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the reshape operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5441,9 +5441,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the sigmoid operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5499,9 +5499,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the slice operation, given |starts| and |sizes|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5559,9 +5559,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softmax operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5648,9 +5648,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softplus operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5721,9 +5721,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softsign operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5793,9 +5793,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the split operation, given |splits| and |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5872,9 +5872,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hyperbolic tangent operation. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5946,9 +5946,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the transpose operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -5996,9 +5996,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the triangular operation, given |options|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. @@ -6095,9 +6095,9 @@ partial interface MLGraphBuilder { 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the where operation, given |condition|, |input| and |other|. - 1. Store a reference of |opImpl| in |output|.{{MLOperand/[[operator]]}}. + 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. - 1. Store a reference to |outputImpl| in |output|.{{MLOperand/[[operand]]}}. + 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. 1. Connect |condition|.{{MLOperand/[[operand]]}}, |input| and |other|.{{MLOperand/[[operand]]}} as inputs to |opImpl|. 1. Connect |output|.{{MLOperand/[[operand]]}} as output to |opImpl|. 1. Return |output|. From 339df2f282ac8b503fae2729e5694fd52bc96285 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 09:32:51 -0800 Subject: [PATCH 07/17] Don't toggle details when clicking on definition/variables Bikeshed makes definitions (algorithms, methods) and variables clickable and show valuable info. This collides with this spec's use of details elements to allow showing/hiding the algorithms, where clicking in the summary, by default, toggles the details. During setup of the spec, slip in a "preventDefault()" to make these play better together. Details in #450 --- index.bs | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/index.bs b/index.bs index 1451487a..26e01f54 100644 --- a/index.bs +++ b/index.bs @@ -391,6 +391,16 @@ th, td { tip.innerHTML = "Expand all"; } } + + // Prevent clicks on active parts of definition don't toggle details. + document.addEventListener('DOMContentLoaded', function() { + var targets = document.querySelectorAll('summary dfn,summary var'); + Array.from(targets).forEach(function(target) { + target.addEventListener('click', function(e) { + e.preventDefault(); + }); + }); + }); Introduction {#intro} From 08ddb3e47f1b138699b4e769d3e19618d7957312 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 09:38:46 -0800 Subject: [PATCH 08/17] Conventions: Fix "Let desc a new" phrasing. Infra style is "Let var be..." For #450 --- index.bs | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/index.bs b/index.bs index 26e01f54..b8d90e4a 100644 --- a/index.bs +++ b/index.bs @@ -2159,7 +2159,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |options|.{{MLConv2dOptions/activation}} is {{MLActivation}}. 1. Let |outputShape| be the result of invoking the underlying implementation for calculating output dimensions, given |options|. 1. If |outputShape| is not the same as the shape of |options|.{{MLConv2dOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -2338,7 +2338,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |options|.{{MLConvTranspose2dOptions/activation}} is {{MLActivation}}. 1. Let |outputShape| be the result of invoking the underlying implementation for calculating output dimensions, given |options|. 1. If |outputShape| is not the same as the shape of |options|.{{MLConvTranspose2dOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -2959,7 +2959,7 @@ partial interface MLGraphBuilder { 1. If |dimCount| is less than or equal to |axis| then [=continue=]. 1. Set |shapeOutput|[|rankOutput| + |dimCount| - |axis| - 1] to |size|. 1. Increment |dimCount| by one. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |shapeOutput|. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -3096,7 +3096,7 @@ partial interface MLGraphBuilder {
Type compatibility between |a|, |b| and |options|.{{MLGemmOptions/c}} can be also checked.
- 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to « |shapeA|[0], |shapeB|[1] ». 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -3380,7 +3380,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: its type is {{MLOperand}}. 1. If its rank is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |options|.{{MLGruOptions/activations}} [=map/exists=] and its [=list/size=] is not 2, then [=exception/throw=] a {{TypeError}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |input|.{{MLOperandDescriptor/dimensions}}[0], |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -4222,7 +4222,7 @@ partial interface MLGraphBuilder { 1. If its [=list/size=] is not 3, then [=exception/throw=] a {{TypeError}}. 1. [=Assert=]: the type of its elements is {{MLActivation}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |numDirections|, |batchSize|, |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Let |output0| be the result of creating an MLOperand given [=this=] and |desc|. @@ -4407,7 +4407,7 @@ partial interface MLGraphBuilder { 1. If |options|.{{MLLstmCellOptions/activations}} [=map/exists=]: 1. If its [=list/size=] is not 3, then [=exception/throw=] a {{TypeError}}. 1. [=Assert=]: the type of its elements is {{MLActivation}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |batchSize|, |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -4594,7 +4594,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |a| and |b| is {{MLOperand}}. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of invoking the calculate matmul output sizes steps given |a| and |b|. 1. If that throws an error, re-[=exception/throw=] the error. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. @@ -5045,7 +5045,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If |options|.{{MLReduceOptions/axes}} [=map/exists=], if any of its elements is not in [=the range=] 0 to the [=rank=] of |input|, exclusive, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. Let |outputShape| be the result of invoking the underlying implementation for calculating reduction output dimensions, given |options|. - 1. Let |desc| a new {{MLOperandDescriptor}}. + 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. From 8e18e8ee997f5fb0de2c6bc61ced5cc7c352f439 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 09:50:54 -0800 Subject: [PATCH 09/17] Conventions: Linkify operand layout enum members * MLConvTranspose2dFilterOperandLayout * MLConv2dFilterOperandLayout For #450 --- index.bs | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/index.bs b/index.bs index b8d90e4a..153eaa32 100644 --- a/index.bs +++ b/index.bs @@ -2093,11 +2093,11 @@ partial interface MLGraphBuilder { :: An {{MLConv2dFilterOperandLayout}} [=string=]. Specifies the layout format of the filter tensor as follow: - - **"oihw"**: *[outputChannels, inputChannels/groups, height, width]* - - **"hwio"**: *[height, width, inputChannels/groups, outputChannels]* - - **"ohwi"**: *[outputChannels, height, width, inputChannels/groups]* - - **"ihwo"**: *[inputChannels/groups, height, width, outputChannels]* - The default value is *"oihw"*. + - {{MLConv2dFilterOperandLayout/"oihw"}}: *[outputChannels, inputChannels/groups, height, width]* + - {{MLConv2dFilterOperandLayout/"hwio"}}: *[height, width, inputChannels/groups, outputChannels]* + - {{MLConv2dFilterOperandLayout/"ohwi"}}: *[outputChannels, height, width, inputChannels/groups]* + - {{MLConv2dFilterOperandLayout/"ihwo"}}: *[inputChannels/groups, height, width, outputChannels]* + The default value is {{MLConv2dFilterOperandLayout/"oihw"}}. : bias :: @@ -2125,7 +2125,7 @@ partial interface MLGraphBuilder {
A *depthwise* conv2d operation is a variant of grouped convolution, used in models like the MobileNet, where the *options.groups* = inputChannels = outputChannels and the shape of filter tensor is [options.groups, 1, height, width] - for *"oihw"* layout, [height, width, 1, options.groups] for *"hwio"* layout, [options.groups, height, width, 1] for *"ohwi"* layout and [1, height, width, options.groups] for *"ihwo"* layout. + for {{MLConv2dFilterOperandLayout/"oihw"}} layout, [height, width, 1, options.groups] for {{MLConv2dFilterOperandLayout/"hwio"}} layout, [options.groups, height, width, 1] for {{MLConv2dFilterOperandLayout/"ohwi"}} layout and [1, height, width, options.groups] for {{MLConv2dFilterOperandLayout/"ihwo"}} layout.
@@ -2275,10 +2275,10 @@ partial interface MLGraphBuilder { :: An {{MLConvTranspose2dFilterOperandLayout}} [=string=]. Specifies the layout format of the filter tensor as follow: - - **"iohw"**: [inputChannels, outputChannels/groups, height, width] - - **"hwoi"**: [height, width, outputChannels/groups, inputChannels] - - **"ohwi"**: [outputChannels/groups, height, width, inputChannels] - The default value is *"iohw"*. + - {{MLConvTranspose2dFilterOperandLayout/"iohw"}}: [inputChannels, outputChannels/groups, height, width] + - {{MLConvTranspose2dFilterOperandLayout/"hwoi"}}: [height, width, outputChannels/groups, inputChannels] + - {{MLConvTranspose2dFilterOperandLayout/"ohwi"}}: [outputChannels/groups, height, width, inputChannels] + The default value is {{MLConvTranspose2dFilterOperandLayout/"iohw"}}. : bias :: From 50122c54baca2b062f25bef6045c028f71dec7b8 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 09:56:24 -0800 Subject: [PATCH 10/17] Conventions: Linkify MLAutoPad enum members For #450 --- index.bs | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/index.bs b/index.bs index 153eaa32..0dafa553 100644 --- a/index.bs +++ b/index.bs @@ -2064,12 +2064,12 @@ partial interface MLGraphBuilder { :: An {{MLAutoPad}} [=string=]. Specifies the automatic input padding options. - The default value is *"explicit"*, which means that the values in the {{MLConv2dOptions/padding}} array should be used for input padding. - When the option is set other than *"explicit"*, the values in the {{MLConv2dOptions/padding}} array are ignored. + The default value is {{MLAutoPad/"explicit"}}, which means that the values in the {{MLConv2dOptions/padding}} array should be used for input padding. + When the option is set other than {{MLAutoPad/"explicit"}}, the values in the {{MLConv2dOptions/padding}} array are ignored. - With the *"same-upper"* option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. + With the {{MLAutoPad/"same-upper"}} option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. - The *"same-lower"* option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. + The {{MLAutoPad/"same-lower"}} option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. : groups :: @@ -2147,7 +2147,7 @@ partial interface MLGraphBuilder { 1. If any element in |options|.{{MLConv2dOptions/strides}} is equal to 0, then [=exception/throw=] a {{TypeError}}. 1. If |options|.{{MLConv2dOptions/dilations}} does not [=map/exist=], set it to « 1, 1 ». 1. Else if the [=list/size=] of |options|.{{MLConv2dOptions/dilations}} is not 2, then [=exception/throw=] a {{TypeError}}. - 1. If |options|.{{MLConv2dOptions/autoPad}} does not [=map/exist=], set it to `"explicit"`. + 1. If |options|.{{MLConv2dOptions/autoPad}} does not [=map/exist=], set it to {{MLAutoPad/"explicit"}}. 1. If |options|.{{MLConv2dOptions/groups}} is 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |inputSize| / |options|.{{MLConv2dOptions/groups}} is not equal to |filterSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. Else if |inputSize| % |options|.{{MLConv2dOptions/groups}} is not 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. @@ -2245,13 +2245,13 @@ partial interface MLGraphBuilder { :: An {{MLAutoPad}} [=string=]. Specifies the automatic input padding options. - The default value is *"explicit"*, which means that the values in the {{MLConvTranspose2dOptions/padding}} array should be used for input padding. + The default value is {{MLAutoPad/"explicit"}}, which means that the values in the {{MLConvTranspose2dOptions/padding}} array should be used for input padding. - When the option is set other than *"explicit"*, the values in the {{MLConvTranspose2dOptions/padding}} array are ignored. + When the option is set other than {{MLAutoPad/"explicit"}}, the values in the {{MLConvTranspose2dOptions/padding}} array are ignored. - With the *"same-upper"* option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. + With the {{MLAutoPad/"same-upper"}} option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. - The *"same-lower"* option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. + The {{MLAutoPad/"same-lower"}} option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. : groups :: @@ -4796,12 +4796,12 @@ partial interface MLGraphBuilder { :: An {{MLAutoPad}} [=string=]. Specifies the automatic input padding options. - The default value is *"explicit"*, which means that the values in the {{MLPool2dOptions/padding}} array should be used for input padding. - When the option is set other than *"explicit"*, the values in the {{MLPool2dOptions/padding}} array are ignored. + The default value is {{MLAutoPad/"explicit"}}, which means that the values in the {{MLPool2dOptions/padding}} array should be used for input padding. + When the option is set other than {{MLAutoPad/"explicit"}}, the values in the {{MLPool2dOptions/padding}} array are ignored. - With the *"same-upper"* option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. + With the {{MLAutoPad/"same-upper"}} option, the padding values are automatically computed such that the additional ending padding of the spatial input dimensions would allow all of the input values in the corresponding dimension to be filtered. - The *"same-lower"* option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. + The {{MLAutoPad/"same-lower"}} option is similar but padding is applied to the beginning padding of the spatial input dimensions instead of the ending one. : layout :: @@ -4874,7 +4874,7 @@ partial interface MLGraphBuilder { 1. If |options|.{{MLPool2dOptions/dilations}} does not [=map/exist=], set |options|.{{MLPool2dOptions/dilations}} to « 1, 1 ». 1. If the [=list/size=] of |options|.{{MLPool2dOptions/dilations}} is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any value in |options|.{{MLPool2dOptions/dilations}} is not greater than 0, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If |options|.{{MLPool2dOptions/autoPad}} is not `"explicit"`, set |options|.{{MLPool2dOptions/padding}} to « 0, 0, 0, 0 ». + 1. If |options|.{{MLPool2dOptions/autoPad}} is not {{MLAutoPad/"explicit"}}, set |options|.{{MLPool2dOptions/padding}} to « 0, 0, 0, 0 ». 1. Let |desc| be a copy of |input|.{{MLOperand/[[descriptor]]}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Make a request to the underlying platform to: From 4048dc2eb8aa59a0a73e24db639c7fb50b2f8a27 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 10:07:37 -0800 Subject: [PATCH 11/17] Conventions: Linkify more enum members * MLDeviceType * MLGruWeightLayout * MLInterpolationMode * MLLstmWeightLayout * MLOperandDataType * MLPaddingMode * MLRecurrentNetworkDirection * MLRoundingType For #450 --- index.bs | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/index.bs b/index.bs index 0dafa553..f7538bc1 100644 --- a/index.bs +++ b/index.bs @@ -638,7 +638,7 @@ Unlike WebGPU, this API does not intrinsically support custom shader authoring; The WebGPU API identifies machine-specific artifacts as a privacy consideration. Given the WebNN API defines means to record an ML workload onto a WebGPU-compatible {{GPUCommandBuffer}}, compute unit scheduling may under certain circumstances introduce a fingerprint. However, similarly to WebGPU, such fingerprints are identical across most or all of the devices of each vendor, mitigating the concern. Furthermore, software implementations can be used to further eliminate such artifacts. -The WebNN API defines two developer-settable preferences to help inform [[#programming-model-device-selection]] and allow the implementation to better select the most appropriate underlying execution device for the workload. [=Device type=] normatively indicates the kind of device and is either "cpu" or "gpu". If this type cannot be satisfied, an "{{OperationError}}" {{DOMException}} is thrown, thus this type can in some cases add two bits of entropy to the fingerprint. [=Power preference=] indicates preference as related to the power consumption and is considered a hint only and as such does not increase entropy of the fingerprint. +The WebNN API defines two developer-settable preferences to help inform [[#programming-model-device-selection]] and allow the implementation to better select the most appropriate underlying execution device for the workload. [=Device type=] normatively indicates the kind of device and is either {{MLDeviceType/"cpu"}} or {{MLDeviceType/"gpu"}}. If this type cannot be satisfied, an "{{OperationError}}" {{DOMException}} is thrown, thus this type can in some cases add two bits of entropy to the fingerprint. [=Power preference=] indicates preference as related to the power consumption and is considered a hint only and as such does not increase entropy of the fingerprint. If a future version of this specification introduces support for new a [=device type=] that can only support a subset of {{MLOperandDataType}}s, that may introduce a new fingerprint. @@ -1826,7 +1826,7 @@ partial interface MLGraphBuilder {
1. If running the check clamp options steps given |options| returns false, then [=exception/throw=] a {{TypeError}}. - 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"clamp"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"clamp"` and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -1931,13 +1931,13 @@ Create a constant {{MLOperand}} of the specified data type and shape that contai Create a constant {{MLOperand}} of the specified value and data type.
-Data truncation will occur when the specified value exceeds the range of the specified output data type e.g. when a float value is assigned to an *"int8"* data type, etc. +Data truncation will occur when the specified value exceeds the range of the specified output data type e.g. when a float value is assigned to an {{MLOperandDataType/"int8"}} data type, etc.
**Arguments:** - *value*: a {{float}} number. The value of the constant. - - *type*: an optional {{MLOperandDataType}}. If not specified, it is assumed to be *"float32"*. + - *type*: an optional {{MLOperandDataType}}. If not specified, it is assumed to be {{MLOperandDataType/"float32"}}. **Returns:**: an {{MLOperand}}. The constant output.
@@ -1969,7 +1969,7 @@ Data truncation will occur when the specified value exceeds the range of the spe Create a constant {{MLOperand}} of the specified data type and shape that contains the data as specified by the range.
-Data truncation will occur when the values in the range exceed the range of the specified output data type e.g. when a float value is assigned to an *"int8"* data type, etc. +Data truncation will occur when the values in the range exceed the range of the specified output data type e.g. when a float value is assigned to an {{MLOperandDataType/"int8"}} data type, etc.
@@ -1977,7 +1977,7 @@ Data truncation will occur when the values in the range exceed the range of the - *start*: a {{float}} scalar. The starting value of the range. - *end*: a {{float}} scalar. The ending value of the range. - *step*: a {{float}} scalar. The gap value between two data points in the range. - - *type*: an optional {{MLOperandDataType}}. If not specified, it is assumed to be *"float32"*. + - *type*: an optional {{MLOperandDataType}}. If not specified, it is assumed to be {{MLOperandDataType/"float32"}}. **Returns:**: an {{MLOperand}}. The constant 1-D output tensor of size `max(0, ceil((end - start)/step))`.
@@ -3188,11 +3188,11 @@ partial interface MLGraphBuilder { : direction :: - An {{MLRecurrentNetworkDirection}}. Specifies the processing direction of the input sequence. When set to `"both"`, the size of the first dimension of the weight and the bias tensor shapes must be 2, and the input is processed in both directions. + An {{MLRecurrentNetworkDirection}}. Specifies the processing direction of the input sequence. When set to {{MLRecurrentNetworkDirection/"both"}}, the size of the first dimension of the weight and the bias tensor shapes must be 2, and the input is processed in both directions. : layout :: - An {{MLGruWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of GRU, specifically the `update (z)`, `reset (r)`, and `new (n)` gate, as indicated in the second dimension of the weight and bias tensor shape. When not specified, the default layout is `"zrn"`.bias + An {{MLGruWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of GRU, specifically the `update (z)`, `reset (r)`, and `new (n)` gate, as indicated in the second dimension of the weight and bias tensor shape. When not specified, the default layout is {{MLGruWeightLayout/"zrn"}}. : activations :: @@ -3344,7 +3344,7 @@ partial interface MLGraphBuilder { : layout :: - An {{MLGruWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of GRU, specifically the `update (z)`, `reset (r)`, and `new (n)` gate, as indicated in the second dimension of the weight and bias tensor shape. When not specified, the default layout is `"zrn"`. + An {{MLGruWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of GRU, specifically the `update (z)`, `reset (r)`, and `new (n)` gate, as indicated in the second dimension of the weight and bias tensor shape. When not specified, the default layout is {{MLGruWeightLayout/"zrn"}}. : activations :: @@ -3399,7 +3399,7 @@ partial interface MLGraphBuilder {
- The behavior of this operation can be generically emulated via other operations as shown below, when the weight layout is the default *"zrn"* layout, and the activation functions of the update/reset gate and new gate are of the operator types *sigmoid* and *tanh* respectively. + The behavior of this operation can be generically emulated via other operations as shown below, when the weight layout is the default {{MLGruWeightLayout/"zrn"}} layout, and the activation functions of the update/reset gate and new gate are of the operator types *sigmoid* and *tanh* respectively. 
     const one = builder.constant(1);
@@ -4155,11 +4155,11 @@ partial interface MLGraphBuilder {
 
     : direction
     ::
-        An {{MLRecurrentNetworkDirection}}. Specifies the processing direction of the input sequence. When set to `"both"`, the size of the first dimension of the weight and the bias tensor shapes must be 2, and the input is processed in both directions.
+        An {{MLRecurrentNetworkDirection}}. Specifies the processing direction of the input sequence. When set to {{MLRecurrentNetworkDirection/"both"}}, the size of the first dimension of the weight and the bias tensor shapes must be 2, and the input is processed in both directions.
 
     : layout
     ::
-        An {{MLLstmWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of LSTM, specifically the `input (i)`, `output (o)`, `forget (f)`, and `cell (g)` gate, as indicated in the first dimension of the weight and bias tensor shapes. When not specified, the default layout is `"iofg"`.
+        An {{MLLstmWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of LSTM, specifically the `input (i)`, `output (o)`, `forget (f)`, and `cell (g)` gate, as indicated in the first dimension of the weight and bias tensor shapes. When not specified, the default layout is {{MLLstmWeightLayout/"iofg"}}.
 
     : activations
     ::
@@ -4184,7 +4184,7 @@ partial interface MLGraphBuilder {
     The lstm(|input|, |weight|, |recurrentWeight|, |steps|, |hiddenSize|, |options|) method steps are:
   
   

-    1. Let |numDirections| be 1 if |options|.{{MLLstmOptions/direction}} is `"forward"`, or otherwise let it be 2.
+    1. Let |numDirections| be 1 if |options|.{{MLLstmOptions/direction}} is {{MLRecurrentNetworkDirection/"forward"}}, or otherwise let it be 2.
     1. [=Assert=]: the type of |input|, |weight| and |recurrentWeight| is {{MLOperand}}.
         

             The shape of |input|, |weight| or |recurrentWeight| could be also checked here.
@@ -4363,7 +4363,7 @@ partial interface MLGraphBuilder {
 
     : layout
     ::
-        An {{MLLstmWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of LSTM, specifically the `input (i)`, `output (o)`, `forget (f)`, and `cell (g)` gate, as indicated in the first dimension of the weight and bias tensor shapes. When not specified, the default layout is `"iofg"`.
+        An {{MLLstmWeightLayout}}. The ordering of the weight and bias vectors for the internal gates of LSTM, specifically the `input (i)`, `output (o)`, `forget (f)`, and `cell (g)` gate, as indicated in the first dimension of the weight and bias tensor shapes. When not specified, the default layout is {{MLLstmWeightLayout/"iofg"}}.
 
     : activations
     ::
@@ -4428,7 +4428,7 @@ partial interface MLGraphBuilder {
 

 

   
-    The behavior of this operation can be generically emulated via other operations as shown below, when the weight layout is the default *"iofg"* layout, and the activation functions of the input/forget/output gate and the cell gate/the cell state's filter for the output hidden state are of the operator types *sigmoid* and *tanh* respectively.
+    The behavior of this operation can be generically emulated via other operations as shown below, when the weight layout is the default {{MLLstmWeightLayout/"iofg"}} layout, and the activation functions of the input/forget/output gate and the cell gate/the cell state's filter for the output hidden state are of the operator types *sigmoid* and *tanh* respectively.
   
   
     const zero = builder.constant(0);
@@ -4640,12 +4640,12 @@ partial interface MLGraphBuilder {
     ::
         An {{MLPaddingMode}} [=string=].
         Specifies the different ways to pad the tensor.
-        The default value is `"constant"`.
+        The default value is {{MLPaddingMode/"constant"}}.
 
     : value
     ::
         A {{float}}.
-        Specifies the padding value when {{MLPadOptions/mode}} is set to `"constant"`.
+        Specifies the padding value when {{MLPadOptions/mode}} is set to {{MLPaddingMode/"constant"}}.
         The default value is 0.
 
 
@@ -4836,11 +4836,11 @@ partial interface MLGraphBuilder {
 
     **Returns:** an {{MLOperand}}. The output 4-D tensor that contains the
     result of the reduction. The logical shape is interpreted according to the
-    value of *layout*. More specifically, if the *options.roundingType* is *"floor"*, the spatial dimensions of the output tensor can be calculated as follow:
+    value of *layout*. More specifically, if the *options.roundingType* is {{MLRoundingType/"floor"}}, the spatial dimensions of the output tensor can be calculated as follow:
 
     *output size = floor(1 + (input size - filter size + beginning padding + ending padding) / stride)*
 
-    or if *options.roundingType* is *"ceil"*:
+    or if *options.roundingType* is {{MLRoundingType/"ceil"}}:
 
     *output size = ceil(1 + (input size - filter size + beginning padding + ending padding) / stride)*
 

@@ -5242,7 +5242,7 @@ partial interface MLGraphBuilder {
     ::
         An {{MLInterpolationMode}} [=string=].
         Specifies the interpolation algorithm used to fill the output tensor values.
-        The default value is `"nearest-neighbor"`, standing for *Nearest Neighbor* interpolation.
+        The default value is {{MLInterpolationMode/"nearest-neighbor"}}, standing for *Nearest Neighbor* interpolation.
 
     : scales
     ::

From bfc901f425cd50689aab4129b499100a0f6ae364 Mon Sep 17 00:00:00 2001
From: Joshua Bell 
Date: Tue, 19 Dec 2023 10:10:18 -0800
Subject: [PATCH 12/17] Conventions: Linkify "rank" term in a few more places

For #450
---
 index.bs | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/index.bs b/index.bs
index f7538bc1..9b78a4a4 100644
--- a/index.bs
+++ b/index.bs
@@ -3227,7 +3227,7 @@ partial interface MLGraphBuilder {
         1. If |options|.{{MLGruOptions/recurrentBias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLGruOptions/initialHiddenState}} [=map/exists=].
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLGruOptions/activations}} [=map/exists=] and its [=list/size=] is not 2, then [=exception/throw=] a {{TypeError}}.
     1. If |steps| is not equal to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0], then [=exception/throw=] a {{TypeError}}.
     1. Let |output| be an empty sequence of {{MLOperand}} objects.
@@ -3375,10 +3375,10 @@ partial interface MLGraphBuilder {
     1. If |recurrentWeight|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLGruOptions/bias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLGruOptions/recurrentBias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not equal to 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLGruOptions/activations}} [=map/exists=] and its [=list/size=] is not 2, then [=exception/throw=] a {{TypeError}}.
     1. Let |desc| be a new {{MLOperandDescriptor}}.
     1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |input|.{{MLOperandDescriptor/dimensions}}[0], |hiddenSize| ].
@@ -4193,28 +4193,28 @@ partial interface MLGraphBuilder {
     1. Let |batchSize| be |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1].
     1. If |options|.{{MLLstmOptions/bias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not |numDirections|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not 4 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmOptions/recurrentBias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/recurrentBias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not |numDirections|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/recurrentBias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not 4 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmOptions/peepholeWeight}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/peepholeWeight}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not |numDirections|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/peepholeWeight}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not 4 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmOptions/initialHiddenState}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialHiddenState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not |numDirections|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialHiddenState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not equal to |batchSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialHiddenState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[2] is not |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmOptions/initialCellState}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 3, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialCellState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not |numDirections|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialCellState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[1] is not equal to |batchSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmOptions/initialCellState}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[2] is not |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
@@ -4394,15 +4394,15 @@ partial interface MLGraphBuilder {
     1. Let |batchSize| be |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0].
     1. If |options|.{{MLLstmCellOptions/bias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmCellOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not 4 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmCellOptions/recurrentBias}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmCellOptions/recurrentBias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not 4 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmCellOptions/peepholeWeight}} [=map/exists=]:
         1. [=Assert=]: its type is {{MLOperand}}.
-        1. If its rank is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
+        1. If its [=rank=] is not 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
         1. If |options|.{{MLLstmCellOptions/peepholeWeight}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not 3 * |hiddenSize|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
     1. If |options|.{{MLLstmCellOptions/activations}} [=map/exists=]:
         1. If its [=list/size=] is not 3, then [=exception/throw=] a {{TypeError}}.

From ad513e4da8a5f3f1a2b83dbdd8acd457c1200729 Mon Sep 17 00:00:00 2001
From: Joshua Bell 
Date: Tue, 19 Dec 2023 10:15:20 -0800
Subject: [PATCH 13/17] Typo: Add missing "this" in algorithm invocation

---
 index.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.bs b/index.bs
index 9b78a4a4..06a389e1 100644
--- a/index.bs
+++ b/index.bs
@@ -5592,7 +5592,7 @@ partial interface MLGraphBuilder {
     The softmax() method steps are:
   
   

-    1. Let |op| be the result of [=creating an MLActivation=] given  and  `"softmax"`.
+    1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and  `"softmax"`.
         1. If that [=exception/throws=] an error, re-[=exception/throw=] the error.
     1. Return |op|.
   


From 151e6a75437821c3d6a0b1fefb623824799326f6 Mon Sep 17 00:00:00 2001
From: Joshua Bell 
Date: Tue, 19 Dec 2023 10:19:16 -0800
Subject: [PATCH 14/17] Conventions: Drop code-style formatting for internal op
 names

Rather than `"opname"` just use "opname" consistently, which was more
common. These are internal identifiers, not exposed to script.

In the future it might be worth introducing a typographic convention
and/or just a markup/markdown style for op names, just to make it
easier to distinguish them.

For #450
---
 index.bs | 42 +++++++++++++++++++++---------------------
 1 file changed, 21 insertions(+), 21 deletions(-)

diff --git a/index.bs b/index.bs
index 06a389e1..2cdd483e 100644
--- a/index.bs
+++ b/index.bs
@@ -1826,7 +1826,7 @@ partial interface MLGraphBuilder {
   
   

     1. If running the check clamp options steps given |options| returns false, then [=exception/throw=] a {{TypeError}}.
-    1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"clamp"` and |options|.
+    1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "clamp" and |options|.
         1. If that [=exception/throws=] an error, re-[=exception/throw=] the error.
     1. Return |op|.
   

@@ -2848,7 +2848,7 @@ partial interface MLGraphBuilder {
     The elu(|options|) method steps are:
   
   

-    1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"elu"` and |options|.
+    1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "elu" and |options|.
     1. Return |op|.
@@ -3196,7 +3196,7 @@ partial interface MLGraphBuilder { : activations :: - A sequence of {{MLActivation}}. Specifies a pair of activation functions with the first function used for the update and reset gate, and the second used for the new gate. When not specified, implementations SHOULD use the the pair of sigmoid (`"sigmoid"`) and the hyperbolic tangent (`"tanh"`) functions, respectively. + A sequence of {{MLActivation}}. Specifies a pair of activation functions with the first function used for the update and reset gate, and the second used for the new gate. When not specified, implementations SHOULD use the the pair of sigmoid ("sigmoid") and the hyperbolic tangent ("tanh") functions, respectively.
@@ -3233,7 +3233,7 @@ partial interface MLGraphBuilder { 1. Let |output| be an empty sequence of {{MLOperand}} objects. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Make a request to the underlying platform to: - 1. Let |opImpl| be an [=implementation-defined=] platform operator for `"gru"`, given |weight|, |recurrentWeight|, |steps|, |hiddenSize| and |options| as parameters. + 1. Let |opImpl| be an [=implementation-defined=] platform operator for "gru", given |weight|, |recurrentWeight|, |steps|, |hiddenSize| and |options| as parameters. 1. Connect |input|.{{MLOperand/[[operand]]}} as input to |opImpl|. 1. Connect |output| as output to |opImpl|. 1. Return |output|. @@ -3348,7 +3348,7 @@ partial interface MLGraphBuilder { : activations :: - A sequence of {{MLActivation}}. Specifies a pair of activation functions with the first function used for the update and reset gate, and the second used for the new gate. When not specified, implementations SHOULD use the the pair of sigmoid (`"sigmoid"`) and the hyperbolic tangent (`"tanh"`) functions, respectively. + A sequence of {{MLActivation}}. Specifies a pair of activation functions with the first function used for the update and reset gate, and the second used for the new gate. When not specified, implementations SHOULD use the the pair of sigmoid ("sigmoid") and the hyperbolic tangent ("tanh") functions, respectively.
@@ -3386,7 +3386,7 @@ partial interface MLGraphBuilder { 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: - 1. Let |opImpl| be an [=implementation-defined=] platform operator for `"gruCell"`, given |weight|, |recurrentWeight|, |hiddenState|, |hiddenSize| and |options| as parameters. + 1. Let |opImpl| be an [=implementation-defined=] platform operator for "gruCell", given |weight|, |recurrentWeight|, |hiddenState|, |hiddenSize| and |options| as parameters. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. 1. Set |output|.{{MLOperand/[[operand]]}} to |outputImpl|. @@ -3588,7 +3588,7 @@ partial interface MLGraphBuilder { The hardSigmoid(|options|) method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"hardSigmoid"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "hardSigmoid" and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -3667,7 +3667,7 @@ partial interface MLGraphBuilder { The hardSwish() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"hardSwish"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "hardSwish". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -4001,7 +4001,7 @@ partial interface MLGraphBuilder { The leakyRelu(|options|) method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"leakyRelu"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "leakyRelu" and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -4093,7 +4093,7 @@ partial interface MLGraphBuilder { The linear(|options|) method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"linear"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "linear" and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -4163,7 +4163,7 @@ partial interface MLGraphBuilder { : activations :: - A sequence of {{MLActivation}}. A sequence of three activation functions, the first one is used for the `input (i)`, `forget (f)`, and `output (o)` gate, the second one is used for the `cell (g)` gate, and the last used for filtering the output cell state before combining it with the result of the output gate to form the output hidden state. When not specified, implementations SHOULD use the sequence of the sigmoid function (`"sigmoid"`) followed by two hyperbolic tangent functions (`"tanh"`) respectively. + A sequence of {{MLActivation}}. A sequence of three activation functions, the first one is used for the `input (i)`, `forget (f)`, and `output (o)` gate, the second one is used for the `cell (g)` gate, and the last used for filtering the output cell state before combining it with the result of the output gate to form the output hidden state. When not specified, implementations SHOULD use the sequence of the sigmoid function ("sigmoid") followed by two hyperbolic tangent functions ("tanh") respectively.
@@ -4367,7 +4367,7 @@ partial interface MLGraphBuilder { : activations :: - A sequence of {{MLActivation}}. A sequence of three activation functions, the first one is used for the `input (i)`, `forget (f)`, and `output (o)` gate, the second one is used for the `cell (g)` gate, and the last used for filtering the output cell state before combining it with the result of the output gate to form the output hidden state. When not specified, they are assumed to be of the sigmoid function (`"sigmoid"`) followed by two hyperbolic tangent functions (`"tanh"`) respectively. + A sequence of {{MLActivation}}. A sequence of three activation functions, the first one is used for the `input (i)`, `forget (f)`, and `output (o)` gate, the second one is used for the `cell (g)` gate, and the last used for filtering the output cell state before combining it with the result of the output gate to form the output hidden state. When not specified, they are assumed to be of the sigmoid function ("sigmoid") followed by two hyperbolic tangent functions ("tanh") respectively.
@@ -4896,21 +4896,21 @@ partial interface MLGraphBuilder {
The averagePool2d(|input|, |options|) method steps are: - 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given `"averagePool2d"`, |input| and |options|. + 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given "averagePool2d", |input| and |options|. 1. If that [=exception/throws=] an error, then re-[=exception/throw=] the error. 1. Return |output|.
The l2Pool2d(|input|, |options|) method steps are: - 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given `"l2Pool2d"`, |input| and |options|. + 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given "l2Pool2d", |input| and |options|. 1. If that [=exception/throws=] an error, then re-[=exception/throw=] the error. 1. Return |output|.
The maxPool2d(|input|, |options|) method steps are: - 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given `"maxPool2d"`, |input| and |options|. + 1. Let |output| be the result of running the [=MLGraphBuilder/pooling-op | create pooling operation=] given "maxPool2d", |input| and |options|. 1. If that [=exception/throws=] an error, then re-[=exception/throw=] the error. 1. Return |output|.
@@ -5203,7 +5203,7 @@ partial interface MLGraphBuilder { The relu() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"relu"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "relu". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5474,7 +5474,7 @@ partial interface MLGraphBuilder { The sigmoid() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"sigmoid"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "sigmoid". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5592,7 +5592,7 @@ partial interface MLGraphBuilder { The softmax() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"softmax"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "softmax". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5682,7 +5682,7 @@ partial interface MLGraphBuilder { The softplus(|options|) method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], `"softplus"` and |options|. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "softplus" and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5754,7 +5754,7 @@ partial interface MLGraphBuilder { The softsign() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"softsign"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "softsign". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
@@ -5905,7 +5905,7 @@ partial interface MLGraphBuilder { The tanh() method steps are:
- 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and `"tanh"`. + 1. Let |op| be the result of [=creating an MLActivation=] given [=this=] and "tanh". 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|.
From 54138a37a0b353ec8bbac2474095ad18599e6c0f Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 10:32:06 -0800 Subject: [PATCH 15/17] Conventions: Use more specific names than key/value in map iteration E.g. if the key is a name, use |name| For #450 --- index.bs | 58 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/index.bs b/index.bs index 2cdd483e..9763b51b 100644 --- a/index.bs +++ b/index.bs @@ -992,21 +992,21 @@ partial interface MLCommandEncoder {
1. If any of the following requirements are unmet, then [=exception/throw=] a "{{DataError}}" {{DOMException}}.
- 1. [=map/For each=] |key| → |value| of |inputs|: - 1. |graph|.{{MLGraph/[[inputDescriptors]]}}[|key|] must [=map/exist=]. - 1. Let |inputDesc| be |graph|.{{MLGraph/[[inputDescriptors]]}}[|key|]. - 1. If |value| is a {{GPUBuffer}}, then: - 1. |value|.{{GPUBuffer/size}} must equal to [=byte length=] of |inputDesc|. - 1. [=map/For each=] |key| → |value| of |outputs|: - 1. |graph|.{{MLGraph/[[outputDescriptors]]}}[|key|] must [=map/exist=]. - 1. Let |outputDesc| be |graph|.{{MLGraph/[[outputDescriptors]]}}[|key|]. - 1. If |value| is a {{GPUBuffer}}, then: - 1. |value|.{{GPUBuffer/size}} must equal to [=byte length=] of |outputDesc|. + 1. [=map/For each=] |name| → |input| of |inputs|: + 1. |graph|.{{MLGraph/[[inputDescriptors]]}}[|name|] must [=map/exist=]. + 1. Let |inputDesc| be |graph|.{{MLGraph/[[inputDescriptors]]}}[|name|]. + 1. If |input| is a {{GPUBuffer}}, then: + 1. |input|.{{GPUBuffer/size}} must equal to [=byte length=] of |inputDesc|. + 1. [=map/For each=] |name| → |output| of |outputs|: + 1. |graph|.{{MLGraph/[[outputDescriptors]]}}[|name|] must [=map/exist=]. + 1. Let |outputDesc| be |graph|.{{MLGraph/[[outputDescriptors]]}}[|name|]. + 1. If |output| is a {{GPUBuffer}}, then: + 1. |output|.{{GPUBuffer/size}} must equal to [=byte length=] of |outputDesc|.
- 1. [=map/For each=] |key| → |value| of |inputs|: - 1. Set the input of |graph|.{{MLGraph/[[implementation]]}} that is associated with |key| to |value|. - 1. [=map/For each=] |key| → |value| of |outputs|: - 1. Set the output of |graph|.{{MLGraph/[[implementation]]}} that is associated with |key| to |value|. + 1. [=map/For each=] |name| → |input| of |inputs|: + 1. Set the input of |graph|.{{MLGraph/[[implementation]]}} that is associated with |name| to |input|. + 1. [=map/For each=] |name| → |output| of |outputs|: + 1. Set the output of |graph|.{{MLGraph/[[implementation]]}} that is associated with |name| to |output|. 1. Issue a compute request of |graph|.{{MLGraph/[[implementation]]}}. 1. If there is an error returned by |graph|.{{MLGraph/[[implementation]]}}, then: 1. Throw an "{{OperationError}}" {{DOMException}}. @@ -1153,9 +1153,9 @@ partial interface MLContext { To validate graph resources, given |resources| and |descriptors|, run the following steps:
- 1. [=map/For each=] |key| → |value| of |resources|: - 1. If |descriptors|[|key|] does not [=map/exist=], return false. - 1. If validating buffer with descriptor given |value| and |descriptors|[|key|] returns false, then return false. + 1. [=map/For each=] |name| → |resource| of |resources|: + 1. If |descriptors|[|name|] does not [=map/exist=], return false. + 1. If validating buffer with descriptor given |resource| and |descriptors|[|name|] returns false, then return false. 1. Return true.
@@ -1177,18 +1177,18 @@ partial interface MLContext {
1. Let |inputResources| denote the input resources of |graph|.{{MLGraph/[[implementation]]}}. - 1. [=map/For each=] |key| → |inputValue| of |inputs|: - 1. Let |inputDescriptor| be |graph|.{{MLGraph/[[inputDescriptors]]}}[|key|]. + 1. [=map/For each=] |name| → |inputValue| of |inputs|: + 1. Let |inputDescriptor| be |graph|.{{MLGraph/[[inputDescriptors]]}}[|name|]. 1. Let |inputTensor| be a new tensor for |graph|.{{MLGraph/[[implementation]]}} as follows: 1. Set the data type of |inputTensor| to the one that matches the [=element type=] of |inputValue|. 1. Set the dimensions of |inputTensor| to |inputDescriptor|.{{MLOperandDescriptor/dimensions}}. 1. Set the values of elements in |inputTensor| to the values of elements in |inputValue|. - 1. Request the underlying implementation of |graph| to bind |inputResources|[|key|] to |inputTensor|. - 1. [=map/For each=] |key| → |outputValue| of |outputs|: - 1. Issue a compute request to |graph|.{{MLGraph/[[implementation]]}} given |key| and |inputResources| and wait for completion. + 1. Request the underlying implementation of |graph| to bind |inputResources|[|name|] to |inputTensor|. + 1. [=map/For each=] |name| → |outputValue| of |outputs|: + 1. Issue a compute request to |graph|.{{MLGraph/[[implementation]]}} given |name| and |inputResources| and wait for completion. 1. If that returns an error, then [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Otherwise, store the result in |outputTensor|. - 1. Let |outputDesc| be |graph|.{{MLGraph/[[outputDescriptors]]}}[|key|]. + 1. Let |outputDesc| be |graph|.{{MLGraph/[[outputDescriptors]]}}[|name|]. 1. If the byte length of |outputTensor| is not equal to the [=byte length=] of |outputDesc|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If the [=element type=] of |outputTensor| doesn't match the [=element type=] of |outputValue|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. Request the underlying implementation of |graph| to set the values of elements in |outputValue| to the values of elements in |outputTensor|. @@ -1244,12 +1244,12 @@ partial interface MLContext {
1. Let |transferredViews| be a new {{MLNamedArrayBufferViews}}. - 1. [=map/For each=] |key| → |value| of |views|: - 1. Let |transferredBuffer| be the result of [=ArrayBuffer/transfer|transferring=] the [=underlying buffer=] of |value|. - 1. Let |constructor| be the appropriate [=view constructor=] for the type of {{ArrayBufferView}} |value|. - 1. Let |elementsNumber| be the result of the [=BufferSource/byte length=] of |value| ÷ [=element size=] of |value|. - 1. Let |transferredView| be [$Construct$](|constructor|, |transferredBuffer|, |value|.\[[ByteOffset]], |elementsNumber|). - 1. Set |transferredViews|[|key|] to |transferredView|. + 1. [=map/For each=] |name| → |view| of |views|: + 1. Let |transferredBuffer| be the result of [=ArrayBuffer/transfer|transferring=] the [=underlying buffer=] of |view|. + 1. Let |constructor| be the appropriate [=view constructor=] for the type of {{ArrayBufferView}} |view|. + 1. Let |elementsNumber| be the result of the [=BufferSource/byte length=] of |view| ÷ [=element size=] of |view|. + 1. Let |transferredView| be [$Construct$](|constructor|, |transferredBuffer|, |view|.\[[ByteOffset]], |elementsNumber|). + 1. Set |transferredViews|[|name|] to |transferredView|. 1. Return |transferredViews|.
From 9cd17f14f3e1d80ad1c5b51710cbf9fcc1836e39 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 10:37:14 -0800 Subject: [PATCH 16/17] Conventions: Simplify "result of invoking the xxx steps" wording With Bikeshed and autolinks you can just write "result of xxxing" For #450 --- index.bs | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/index.bs b/index.bs index 9763b51b..1c05b4fa 100644 --- a/index.bs +++ b/index.bs @@ -1795,7 +1795,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. - 1. If running the check clamp options steps given |options| returns false, then [=exception/throw=] a {{TypeError}}. + 1. If [=checking clamp options=] given |options| returns false, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |output| be the result of copying an MLOperand given |input|. 1. Make a request to the underlying platform to: @@ -1825,7 +1825,7 @@ partial interface MLGraphBuilder { The clamp(|options|) method steps are:
- 1. If running the check clamp options steps given |options| returns false, then [=exception/throw=] a {{TypeError}}. + 1. If [=checking clamp options=] given |options| returns false, then [=exception/throw=] a {{TypeError}}. 1. Let |op| be the result of [=creating an MLActivation=] given [=this=], "clamp" and |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return |op|. @@ -1914,11 +1914,11 @@ Create a constant {{MLOperand}} of the specified data type and shape that contai
1. [=Assert=]: the type of |descriptor| is {{MLOperandDescriptor}}. 1. If the [=byte length=] of |descriptor| is not supported by the underlying platform, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If the [=check dimensions=] steps given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} return false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. If the [=checking dimensions=] given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If validating buffer with descriptor given |bufferView| and |descriptor| returns false, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|. - 1. Let |bytes| be the result of invoking the [=get a copy of the bytes held by the buffer source=] steps given |bufferView|. + 1. Let |bytes| be the result of [=getting a copy of the bytes held by the buffer source=] given |bufferView|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant, given |descriptor|. 1. Set |operand|.{{MLOperand/[[operand]]}} to |constantImpl|. @@ -3695,7 +3695,7 @@ Create a named {{MLOperand}} based on a descriptor, that can be used as an input 1. [=Assert=]: the type of |descriptor| is {{MLOperandDescriptor}}. 1. [=Assert=]: If |descriptor|.{{MLOperandDescriptor/dimensions}} does not [=map/exist=], then |descriptor| defines a scalar input. 1. If |descriptor|.{{MLOperandDescriptor/dimensions}} [=map/exists=]: - 1. If the [=check dimensions=] steps given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} return false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. If [=checking dimensions=] given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If the [=byte length=] of |descriptor| is not supported by the underlying platform, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|. @@ -4595,7 +4595,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |a| and |b| is {{MLOperand}}. 1. Let |desc| be a new {{MLOperandDescriptor}}. - 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of invoking the calculate matmul output sizes steps given |a| and |b|. + 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of [=calculating matmul output sizes=] given |a| and |b|. 1. If that throws an error, re-[=exception/throw=] the error. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. @@ -4683,7 +4683,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If the [=list/size=] of |beginningPadding| and |endingPadding| is not equal to the [=rank=] of |input|, then then [=exception/throw=] a "{{TypeError}}". 1. Let |desc| be a copy of |input|.{{MLOperand/[[descriptor]]}}. - 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of invoking the calculate padding output sizes steps given |input|, |beginningPadding| and |endingPadding|. + 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of [=calculating padding output sizes=] given |input|, |beginningPadding| and |endingPadding|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. 1. Make a request to the underlying platform to: @@ -5298,8 +5298,8 @@ partial interface MLGraphBuilder {
1. If the [=list/size=] of |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} is not 4, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If running the check resample options steps given |options| returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. Let |desc| be the result of running the resample output sizes steps given |options|. + 1. If [=checking resample options=] given |options| returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. Let |desc| be the result of [=resampling output sizes=] given |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. @@ -6228,7 +6228,7 @@ The {{MLOperand}} objects are created by the methods of {{MLGraphBuilder}}, inte 1. [=Assert=]: the type of |operand|.{{MLOperand/[[builder]]}} is {{MLGraphBuilder}}. 1. If |builder| is not equal to |operand|.{{MLOperand/[[builder]]}}, return false. 1. Let |desc| be |operand|.{{MLOperand/[[descriptor]]}}. - 1. If |desc|.{{MLOperandDescriptor/dimensions}} [=map/exists=] and invoking check dimensions given |desc|.{{MLOperandDescriptor/dimensions}} and |desc|.{{MLOperandDescriptor/dataType}} returns false, then return false. + 1. If |desc|.{{MLOperandDescriptor/dimensions}} [=map/exists=] and [=checking dimensions=] given |desc|.{{MLOperandDescriptor/dimensions}} and |desc|.{{MLOperandDescriptor/dataType}} returns false, then return false. 1. Return true.
From c0fd0d97b168b9980f6e2bfa209dd660f51b1606 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Tue, 19 Dec 2023 10:45:25 -0800 Subject: [PATCH 17/17] Conventions: Prefer autolinks to HTML markup If Bikeshed [=autolinks=] are used instead of HTML markup then Bikeshed can do a better job of consistency checking. For #450 --- index.bs | 132 +++++++++++++++++++++++++++---------------------------- 1 file changed, 66 insertions(+), 66 deletions(-) diff --git a/index.bs b/index.bs index 1c05b4fa..57a0fe42 100644 --- a/index.bs +++ b/index.bs @@ -814,7 +814,7 @@ Its default allowlist is 'self'. 1. Let |promise| be [=a new promise=]. 1. Return |promise| and run the following steps [=in parallel=]. 1. Let |context| be the result of [=creating a context=] given |options|. - 1. If validating MLContext given |context| returns false, [=reject=] |promise| with a "{{NotSupportedError}}" {{DOMException}}. + 1. If [=validating MLContext=] given |context| returns false, [=reject=] |promise| with a "{{NotSupportedError}}" {{DOMException}}. 1. [=Resolve=] |promise| with |context|.
@@ -828,7 +828,7 @@ Its default allowlist is 'self'. 1. Let |promise| be [=a new promise=]. 1. Return |promise| and run the following steps [=in parallel=]. 1. Let |context| be the result of [=creating a context=] given |gpuDevice|. - 1. If validating MLContext given |context| returns false, [=reject=] |promise| with a "{{NotSupportedError}}" {{DOMException}}. + 1. If [=validating MLContext=] given |context| returns false, [=reject=] |promise| with a "{{NotSupportedError}}" {{DOMException}}. 1. [=Resolve=] |promise| with |context|.
@@ -842,7 +842,7 @@ Its default allowlist is 'self'.
1. If [=this=]'s [=relevant global object=]'s [=associated Document=] is not [=allowed to use=] the [=webnn-feature|webnn=] feature, then [=exception/throw=] a "{{SecurityError}}" {{DOMException}}. 1. Let |context| be the result [=creating a context=] |options|. - 1. If validating MLContext given |context| return false, then [=exception/throw=] a "{{NotSupportedError}}" {{DOMException}}. + 1. If [=validating MLContext=] given |context| return false, then [=exception/throw=] a "{{NotSupportedError}}" {{DOMException}}. 1. Return |context|.
@@ -854,7 +854,7 @@ Its default allowlist is 'self'.
1. If [=this=]'s [=relevant global object=]'s [=associated Document=] is not [=allowed to use=] the [=webnn-feature|webnn=] feature, then [=exception/throw=] a "{{SecurityError}}" {{DOMException}}. 1. Let |context| be the result [=creating a context=] with |gpuDevice|. - 1. If validating MLContext given |context| return false, then [=exception/throw=] a "{{NotSupportedError}}" {{DOMException}}. + 1. If [=validating MLContext=] given |context| return false, then [=exception/throw=] a "{{NotSupportedError}}" {{DOMException}}. 1. Return |context|.
@@ -1140,9 +1140,9 @@ partial interface MLContext {
1. If |graph|.{{MLGraph/[[context]]}}.{{MLContext/[[contextType]]}} is not "[=default-context|default=]", [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. If validating graph resources given |inputs| and |graph|.{{MLGraph/[[inputDescriptors]]}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If validating graph resources given |outputs| and |graph|.{{MLGraph/[[outputDescriptors]]}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. Invoke execute graph given |graph|, |inputs| and |outputs|. + 1. If [=validating graph resources=] given |inputs| and |graph|.{{MLGraph/[[inputDescriptors]]}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. If [=validating graph resources=] given |outputs| and |graph|.{{MLGraph/[[outputDescriptors]]}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. Invoke [=execute graph=] given |graph|, |inputs| and |outputs|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. Return {{undefined}}.
@@ -1155,7 +1155,7 @@ partial interface MLContext {
1. [=map/For each=] |name| → |resource| of |resources|: 1. If |descriptors|[|name|] does not [=map/exist=], return false. - 1. If validating buffer with descriptor given |resource| and |descriptors|[|name|] returns false, then return false. + 1. If [=validating buffer with descriptor=] given |resource| and |descriptors|[|name|] returns false, then return false. 1. Return true.
@@ -1289,13 +1289,13 @@ partial interface MLContext { 1. Let |promise| be [=a new promise=]. 1. Return |promise| and run the following steps [=in parallel=]: 1. If |graph|.{{MLGraph/[[context]]}}.{{MLContext/[[contextType]]}} is not "[=default-context|default=]", [=reject=] |promise| with an "{{OperationError}}" {{DOMException}}. - 1. If validating graph resources given |inputs| and |graph|.{{MLGraph/[[inputDescriptors]]}} returns false, then [=reject=] |promise| with a "{{DataError}}" {{DOMException}}. - 1. If validating graph resources given |outputs| and |graph|.{{MLGraph/[[outputDescriptors]]}} returns false, then [=reject=] |promise| with a "{{DataError}}" {{DOMException}}. + 1. If [=validating graph resources=] given |inputs| and |graph|.{{MLGraph/[[inputDescriptors]]}} returns false, then [=reject=] |promise| with a "{{DataError}}" {{DOMException}}. + 1. If [=validating graph resources=] given |outputs| and |graph|.{{MLGraph/[[outputDescriptors]]}} returns false, then [=reject=] |promise| with a "{{DataError}}" {{DOMException}}. 1. Let |transferredInputs| be the result of [=MLNamedArrayBufferViews/transfer|transferring=] {{MLNamedArrayBufferViews}} |inputs|. 1. Let |transferredOutputs| be the result of [=MLNamedArrayBufferViews/transfer|transferring=] {{MLNamedArrayBufferViews}} |outputs|. - 1. Invoke execute graph given |graph|, |transferredInputs| and |transferredOutputs|. + 1. Invoke [=execute graph=] given |graph|, |transferredInputs| and |transferredOutputs|. 1. If that [=exception/throws=] an error, [=reject=] |promise| with the error. - 1. Otherwise, when execute graph has completed: + 1. Otherwise, when [=execute graph=] has completed: 1. Let |result| be a new {{MLComputeResult}}. 1. Set |result|.{{MLComputeResult/inputs}} to |transferredInputs|. 1. Set |result|.{{MLComputeResult/outputs}} to |transferredOutputs|. @@ -1452,7 +1452,7 @@ Both {{MLGraphBuilder}}.{{MLGraphBuilder/build()}} and {{MLGraphBuilder}}.{{MLGr
1. If [=this=]'s [=relevant global object=]'s [=associated Document=] is not [=allowed to use=] the [=webnn-feature|webnn=] feature, then [=exception/throw=] a "{{SecurityError}}" {{DOMException}}. - 1. If validating MLContext given |context| returns false, then [=exception/throw=] a "{{TypeError}}". + 1. If [=validating MLContext=] given |context| returns false, then [=exception/throw=] a "{{TypeError}}". 1. Set {{MLGraphBuilder/[[context]]}} to |context|.
@@ -1509,7 +1509,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dataType}} to "int64". 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| argMin or argMax operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -1609,7 +1609,7 @@ partial interface MLGraphBuilder { 1. If its [=list/size=] is not 1, then [=exception/throw=] a {{TypeError}}. 1. If |options|.{{MLBatchNormalizationOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[0] is not equal to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[|options|.{{MLBatchNormalizationOptions/axis}}], then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |input|.{{MLOperand/[[descriptor]]}}, that may use the same underlying data as |input|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |input|.{{MLOperand/[[descriptor]]}}, that may use the same underlying data as |input|. 1. Make a request to the underlying platform to initialize the batch normalization: 1. Create an [=implementation-defined=] platform operator |batchNormImpl| for this method, given |input|, |mean|, |variance| and |options|. 1. If |options|.activation [=map/exists=],register it as activation to |batchNormImpl|. @@ -1679,7 +1679,7 @@ Build a composed graph up to a given output operand into a computational graph, 1. Set |graph|.{{MLGraph/[[implementation]]}} to |graphImpl|. 1. Make a request to the underlying platform to initialize the graph: 1. [=map/For each=] |name| → |operand| of |outputs|: - 1. If validating MLOperand given |operand| and [=this=] returns false, then [=exception/throw=] a {{TypeError}}. + 1. If [=validating MLOperand=] given |operand| and [=this=] returns false, then [=exception/throw=] a {{TypeError}}. 1. If |operand| was created as an input by the underlying platform: 1. If |operand|.{{MLOperand/[[name]]}}] is not unique for |graphImpl|, then [=exception/throw=] a {{TypeError}}. 1. Add |operand|.{{MLOperand/[[descriptor]]}} to |graph|.{{MLGraph/[[inputDescriptors]]}}[|operand|.{{MLOperand/[[name]]}}]. @@ -1713,8 +1713,8 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |operand| be the result of creating an MLOperand given [=this=], |input| and |type|. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |operand| be the result of [=creating an MLOperand=] given [=this=], |input| and |type|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |castImpl| for this method, given |type|. 1. Set |output|.{{MLOperand/[[operator]]}} to |castImpl|. @@ -1797,7 +1797,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If [=checking clamp options=] given |options| returns false, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |clampImpl| for this method, given |options|.{{MLClampOptions/minValue}} and |options|.{{MLClampOptions/maxValue}}. 1. Set |output|.{{MLOperand/[[operator]]}} to |clampImpl|. @@ -1870,7 +1870,7 @@ partial interface MLGraphBuilder { 1. Let |desc|.{{MLOperandDescriptor/dimensions}}[|axis|] be 0. 1. [=map/For each=] |index| in [=the range=] 0 to the [=rank=] of |inputs|, exclusive: 1. Let |input| be |inputs|[|index|]. - 1. If validating MLOperand given |input| and [=this=] returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. + 1. If [=validating MLOperand=] given |input| and [=this=] returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}} is not equal to |inputs|[0].{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. [=map/For each=] |dim| in [=the range=] 0 to the [=rank=] of |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}, exclusive:
@@ -1879,7 +1879,7 @@ partial interface MLGraphBuilder { 1. If |dim| is not equal to |axis| and if |input|.{{MLOperandDescriptor/dimensions}}[|dim|] is not equal to |inputs|[0].{{MLOperandDescriptor/dimensions}}[|dim|], then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |dim| is equal to |axis|, add to |desc|.{{MLOperandDescriptor/dimensions}}[|axis|] the value of |input|.{{MLOperandDescriptor/dimensions}}[|dim|]. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |concatImpl| for this method, given |inputs| and |axis|. 1. Set |output|.{{MLOperand/[[operator]]}} to |concatImpl|. @@ -1915,9 +1915,9 @@ Create a constant {{MLOperand}} of the specified data type and shape that contai 1. [=Assert=]: the type of |descriptor| is {{MLOperandDescriptor}}. 1. If the [=byte length=] of |descriptor| is not supported by the underlying platform, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If the [=checking dimensions=] given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. - 1. If validating buffer with descriptor given |bufferView| and |descriptor| returns false, then [=exception/throw=] a {{TypeError}}. + 1. If [=validating buffer with descriptor=] given |bufferView| and |descriptor| returns false, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |operand| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Let |bytes| be the result of [=getting a copy of the bytes held by the buffer source=] given |bufferView|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant, given |descriptor|. @@ -1956,7 +1956,7 @@ Data truncation will occur when the specified value exceeds the range of the spe In the case of a scalar constant, |descriptor|.{{MLOperandDescriptor/dimensions}} is ignored.
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |operand| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operand |constantImpl| to represent a constant, given |descriptor|. 1. Set |operand|.{{MLOperand/[[operand]]}} to |constantImpl|. @@ -1994,7 +1994,7 @@ Data truncation will occur when the values in the range exceed the range of the 1. Let |size| be *max(0, ceil((end - start)/step))*. 1. Set |descriptor|.{{MLOperandDescriptor/dimensions}} to « |size| ». 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |operand| be the result of creating an MLOperand given [=this=], |start|, |end|, |step|, and |type|. + 1. Let |operand| be the result of [=creating an MLOperand=] given [=this=], |start|, |end|, |step|, and |type|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform memory buffer the size of |size| multiplied by sizeof(|descriptor|.{{MLOperandDescriptor/dataType}}). 2. Store the beginning address to that memory buffer as a pointer |buffer| of the corresponding data type. @@ -2163,7 +2163,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |conv2dImpl| for this method, given |options| and |filter|. 1. If |options|.{{MLConv2dOptions/activation}} [=map/exists=],register it as activation to |conv2dImpl|. @@ -2342,7 +2342,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |convTranspose2dImpl| for this method, given |options| and |filter|. 1. If |options|.{{MLConvTranspose2dOptions/activation}} [=map/exists=],register it as activation to |convTranspose2dImpl|. @@ -2407,7 +2407,7 @@ partial interface MLGraphBuilder { 1. Let |descriptor|.{{MLOperandDescriptor/dimensions}} be the result of running the [=MLGraphBuilder/broadcast-shapes=] steps given |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} and |b|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the binary operation |op|, given |a| and |b|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -2544,7 +2544,7 @@ Although operations *greaterOrEqual* and *lesserOrEqual* can each be implemented 1. Let |descriptor|.{{MLOperandDescriptor/dimensions}} be the result of running the [=MLGraphBuilder/broadcast-shapes=] steps given |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} and |b|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the binary operation |op|, given |a| and |b|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -2659,7 +2659,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: |op| is one of "abs", "ceil", "cos", "erf", "exp", "floor", "identity", "log", "neg", "reciprocal", "sin", "sqrt", "tan". 1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the unary operation |op|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -2820,7 +2820,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the ELU operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -2887,7 +2887,7 @@ partial interface MLGraphBuilder { 1. If |size| is not equal to 1 and not equal to |newShape|[index], then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |size| is equal to 1, then let |outputDesc|.{{MLOperandDescriptor/dimensions}}[|index|] be |newShape|[|index|]. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |outputDesc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |outputDesc|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform operator |expandImpl| for this method, given |input| and |newShape|. 1. Set |output|.{{MLOperand/[[operator]]}} to |expandImpl|. @@ -2963,7 +2963,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |shapeOutput|. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the Gather operation, given |input|, |indices|, and |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3100,7 +3100,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to « |shapeA|[0], |shapeB|[1] ». 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the GEMM operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3384,7 +3384,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |input|.{{MLOperandDescriptor/dimensions}}[0], |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for "gruCell", given |weight|, |recurrentWeight|, |hiddenState|, |hiddenSize| and |options| as parameters. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3561,7 +3561,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hard sigmoid operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3641,7 +3641,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hard-swish operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3698,7 +3698,7 @@ Create a named {{MLOperand}} based on a descriptor, that can be used as an input 1. If [=checking dimensions=] given |descriptor|.{{MLOperandDescriptor/dataType}} and |descriptor|.{{MLOperandDescriptor/dimensions}} returns false, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If the [=byte length=] of |descriptor| is not supported by the underlying platform, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |operand| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |operand| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Set |operand|.{{MLOperand/[[name]]}} to |name|. 1. Make a request to the underlying platform to: 1. Create an [=implementation-defined=] platform input operand |operandImpl| given |descriptor|. @@ -3765,7 +3765,7 @@ The {{MLInstanceNormalizationOptions}} members are: 1. [=Assert=]: the type of |options|.{{MLInstanceNormalizationOptions/bias}} is {{MLOperand}}. 1. If the [=rank=] of |options|.{{MLInstanceNormalizationOptions/bias}} is not equal to 1, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the instance normalization operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3873,7 +3873,7 @@ The {{MLLayerNormalizationOptions}} members are: 1. If |options|.{{MLLayerNormalizationOptions/scale}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[|index|] is not equal to |size|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If |options|.{{MLLayerNormalizationOptions/bias}}.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}[|index|] is not equal to |size|, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the instance normalization operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -3974,7 +3974,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the Leaky RELU operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -4066,7 +4066,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the linear operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -4225,11 +4225,11 @@ partial interface MLGraphBuilder { 1. Let |desc| be a new {{MLOperandDescriptor}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |numDirections|, |batchSize|, |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. - 1. Let |output0| be the result of creating an MLOperand given [=this=] and |desc|. - 1. Let |output1| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output0| be the result of [=creating an MLOperand=] given [=this=] and |desc|. + 1. Let |output1| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |steps|, |numDirections|, |batchSize|, |hiddenSize| ]. 1. If |options|.{{MLLstmOptions/returnSequence}} is set to true: - 1. Let |output2| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output2| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Let |output| be the array [ |output0|, |output1|, |output2| ]. 1. Otherwise, Let |output| be the array [ |output0|, |output1| ]. 1. Make a request to the underlying platform to: @@ -4411,8 +4411,8 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to [ |batchSize|, |hiddenSize| ]. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output0| be the result of creating an MLOperand given [=this=] and |desc|. - 1. Let |output1| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output0| be the result of [=creating an MLOperand=] given [=this=] and |desc|. + 1. Let |output1| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Let |output| be the array [ |output0|, |output1| ]. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the LSTM cell operation, given |weight|, |recurrentWeight|, |hiddenState|, |cellState|, |hiddenSize| and |options|. @@ -4599,7 +4599,7 @@ partial interface MLGraphBuilder { 1. If that throws an error, re-[=exception/throw=] the error. 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |a|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the matrix multiplication operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -4685,7 +4685,7 @@ partial interface MLGraphBuilder { 1. Let |desc| be a copy of |input|.{{MLOperand/[[descriptor]]}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to the result of [=calculating padding output sizes=] given |input|, |beginningPadding| and |endingPadding|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the padding operation, given |beginningPadding|, |endingPadding| and |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -4879,7 +4879,7 @@ partial interface MLGraphBuilder { 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. 1. Make a request to the underlying platform to: 1. Calculate the output dimensions given |input| and |options|. Let |desc|.{{MLOperandDescriptor/dimensions}} be the result of that. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| pooling operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. 1. Create an [=implementation-defined=] platform operand |outputImpl| to represent the output, given |output| and |opImpl|. @@ -4954,7 +4954,7 @@ partial interface MLGraphBuilder { 1. Let |descriptor|.{{MLOperandDescriptor/dimensions}} be the result of running the [=MLGraphBuilder/broadcast-shapes=] steps given |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} and |slope|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}}. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the PreLU operation, given |slope|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5049,7 +5049,7 @@ partial interface MLGraphBuilder { 1. Set |desc|.{{MLOperandDescriptor/dataType}} to |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dataType}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |outputShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the |op| reduce operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5177,7 +5177,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the ReLU operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5302,7 +5302,7 @@ partial interface MLGraphBuilder { 1. Let |desc| be the result of [=resampling output sizes=] given |options|. 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the resample 2D operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5355,7 +5355,7 @@ partial interface MLGraphBuilder { 1. Let |desc| be a copy of |input|.{{MLOperand/[[descriptor]]}}. 1. Set |desc|.{{MLOperandDescriptor/dimensions}} to |newShape|. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |desc|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |desc|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the reshape operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5448,7 +5448,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the sigmoid operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5504,9 +5504,9 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If |sizes|.size is 0, then [=exception/throw=] a {{TypeError}}. - 1. If the [=list/size=] of |starts| and |sizes| is not equal to the rank of |input|, then [=exception/throw=] a {{TypeError}}. + 1. If the [=list/size=] of |starts| and |sizes| is not equal to the [=rank=] of |input|, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the slice operation, given |starts| and |sizes|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5566,7 +5566,7 @@ partial interface MLGraphBuilder { 1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If the [=list/size=] of |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} is not 2, then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softmax operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5655,7 +5655,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softplus operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5728,7 +5728,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the softsign operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5800,7 +5800,7 @@ partial interface MLGraphBuilder { 1. If |splits| is an {{unsigned long}}, and |input|.{{MLOperandDescriptor/dimensions}}[|options|.{{MLSplitOptions/axis}}] % |splits| is not 0, then [=exception/throw=] a {{TypeError}}. 1. If |splits| is a sequence of {{unsigned long}}, and the sum of its elements is not equal to |input|.{{MLOperandDescriptor/dimensions}}[|options|.{{MLSplitOptions/axis}}], then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the split operation, given |splits| and |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5879,7 +5879,7 @@ partial interface MLGraphBuilder {
1. [=Assert=]: the type of |input| is {{MLOperand}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the hyperbolic tangent operation. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -5953,7 +5953,7 @@ partial interface MLGraphBuilder { 1. If the values in |options|.{{MLTransposeOptions/permutation}} are not in [=the range=] 0 and the [=rank=] of |input|.{{MLOperand/[[descriptor]]}}.{{MLOperandDescriptor/dimensions}} exclusive, then [=exception/throw=] a {{TypeError}}. 1. If the values in |options|.{{MLTransposeOptions/permutation}} contain duplicate value, then [=exception/throw=] a {{TypeError}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the transpose operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -6003,7 +6003,7 @@ partial interface MLGraphBuilder {
1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of copying an MLOperand given |input|. + 1. Let |output| be the result of [=copying an MLOperand=] given |input|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the triangular operation, given |options|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|. @@ -6102,7 +6102,7 @@ partial interface MLGraphBuilder { 1. If that [=exception/throws=] an error, re-[=exception/throw=] the error. 1. If |condition| is not unidirectionally broadcastable to |descriptor|.{{MLOperandDescriptor/dimensions}} according to the [[!numpy-broadcasting-rule]], then [=exception/throw=] a "{{DataError}}" {{DOMException}}. 1. If any of the following sub-steps fail, [=exception/throw=] an "{{OperationError}}" {{DOMException}}. - 1. Let |output| be the result of creating an MLOperand given [=this=] and |descriptor|. + 1. Let |output| be the result of [=creating an MLOperand=] given [=this=] and |descriptor|. 1. Make a request to the underlying platform to: 1. Let |opImpl| be an [=implementation-defined=] platform operator for the where operation, given |condition|, |input| and |other|. 1. Set |output|.{{MLOperand/[[operator]]}} to |opImpl|.