compute.kernels · thing ·

portableKernelWorkContract

A portable kernel work contract record carrying rank, globalDimensions, localDimensions, boundsPolicy, localMemoryBytes, and related state.

computecompute.kernelscpukernelsmethodsource-examplethingyeho

Describe reusable compute kernels and their workload contracts.

external thing portableKernelWorkContract

Status: source-declared

Fields and methods (16)
int rank
Stores rank as int.
list of int globalDimensions
Stores global dimensions as list of int.
list of int localDimensions
Stores local dimensions as list of int.
text boundsPolicy
Stores bounds policy as text.
int localMemoryBytes
Stores local memory bytes as int.
int barrierCount
Stores barrier count as int.
text barrierPolicy
Stores barrier policy as text.
text reductionKind
Stores reduction kind as text.
text reductionOrder
Stores reduction order as text.
portableKernelWorkContract(int rank, list of int globalDimensions, list of int localDimensions, text boundsPolicy, int localMemoryBytes, int barrierCount, text barrierPolicy, text reductionKind, text reductionOrder)
Portable kernel work contract.
WorkItemCount() returns int
Work item count. Complete example
DimensionValidationIssue() returns text
Dimension validation issue. Complete example
MemoryAndBarrierValidationIssue(int localMemoryLimitBytes) returns text
Memory and barrier validation issue. Complete example
ReductionValidationIssue() returns text
Reduction validation issue. Complete example
ValidationIssue(int localMemoryLimitBytes) returns text
Validation issue. Complete example
Describe() returns text
Describe. Complete example

Use portableKernelWorkContract

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

cpu · source-example · type checked

using compute.kernels

// Describe reusable compute kernels and their workload contracts.
portableKernelWorkContract sample = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
Console.Log(Text.From(sample.rank))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.WorkItemCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Work item count.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
int result = instance.WorkItemCount()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.DimensionValidationIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Dimension validation issue.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
text result = instance.DimensionValidationIssue()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.MemoryAndBarrierValidationIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Memory and barrier validation issue.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
int argument_localMemoryLimitBytes = 4
text result = instance.MemoryAndBarrierValidationIssue(argument_localMemoryLimitBytes)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.ReductionValidationIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Reduction validation issue.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
text result = instance.ReductionValidationIssue()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.ValidationIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Validation issue.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
int argument_localMemoryLimitBytes = 4
text result = instance.ValidationIssue(argument_localMemoryLimitBytes)
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

portableKernelWorkContract.Describe

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using compute.kernels

// Describe.
portableKernelWorkContract instance = portableKernelWorkContract(1, [], [], "bounds Policy", 4, 1, "barrier Policy", "reduction Kind", "reduction Order")
text result = instance.Describe()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.compute_kernels__portablekernelworkcontract"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "compute.kernels"
version = "0.1.0"
path = "../../../yeho/packages/compute/kernels"

[[dependencies]]
package = "compute.tensor"
version = "0.1.0"
path = "../../../yeho/packages/compute/tensor"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"
Notes and source

Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

yeho/packages/compute/kernels/portable_contract.yh:78