globalIndices — Return the exact global indices owned by a worker.
globalIndices computes a worker's uint64 ownership indices or first/last endpoints from the resolved layout.
Syntax
indices = globalIndices(value, dimension, lab)Inputs
value- Type
Any- Required
- Yes
- Default
- —
- Description
- Value operated on by the parallel runtime.
dimension- Type
IntegerScalar- Required
- Yes
- Default
- —
- Description
- One-based distributed dimension.
lab- Type
IntegerScalar- Required
- No
- Default
- —
- Description
- Optional one-based source lab index.
Returns
indices_or_first- Type
Any- Description
- Global indices or first global index assigned to the worker.
last- Type
Any- Description
- Last global index assigned to the worker.
Returned values from globalIndices depend on how many outputs the caller requests.
Errors
RunMat:parallel:LoweringRequired- When
- The operation is invoked without an active compiler-owned SPMD or distributed execution context.
- Message
parallel operation requires executor-aware lowering
Behavior
A distributed value stores partition payloads in the execution service. The language value is a typed handle containing its global shape, value class, distribution scheme, owning pool, and generation. Exact integer classes, shapes, and supported complex or sparse representations are retained across partition and materialization boundaries.
Driver construction partitions one complete input. Cooperative construction inside spmd can replicate one value, select a designated worker's value, or build from every worker's local contribution. The default build form validates class, rank, shape, layout, and codistributor agreement across the gang; "noCommunication" skips cross-worker validation only when the caller already guarantees consistency.
Distributed values belong to one pool generation. Closing or resizing that pool retires local-part access, materialization, redistribution, and distributed builtin placement for the stale handle.
Execution placement
Construction, redistribution, and materialization may cross the driver-worker boundary. getLocalPart reads only the selected worker partition, globalIndices computes ownership from the authoritative layout, and getCodistributor projects the resolved description without reading payloads.
Examples
Read one worker's exact global indices
pool = parpool(2);
value = distributed(uint16([10 20 30 40]));
indices = globalIndices(value, uint32(2), uint32(1))Expected output:
indices contains worker 1's uint64 column indicesRead the first and last owned index
pool = parpool(2);
value = distributed(uint16([10 20 30 40]));
[first, last] = globalIndices(value, uint32(2), uint32(2))Expected output:
first = 3; last = 4Using globalIndices with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how globalIndices changes the result.
Run a small globalIndices example, explain the result, then change one input and compare the output.
FAQ
Does the language value contain every partition?⌄
No. It is a typed, generation-fenced handle; the execution service owns partition payloads.
Are integer classes preserved?⌄
Yes. Supported values retain their exact class, shape, and payload through partition, redistribution, local access, and gather.
What happens after the pool is closed or resized?⌄
The old generation is retired and distributed operations reject its stale handles.
Does inspection gather the full value?⌄
No. Codistributor and index inspection use handle metadata; local-part access reads only the selected partition.
Where can I omit a lab argument?⌄
Inside spmd, the active rank selects the local partition. Driver code supplies an explicit lab where the form requires one.
Related Parallel functions
codistributed · codistributed.build · codistributor · codistributor1d · codistributor2dbc · distributed · fetchNext · fetchOutputs · gcat · gcp · getCodistributor · getCurrentJob · getCurrentTask · getCurrentWorker · getLocalPart · gop · gplus · iscodistributed · isComplete · labBarrier · labBroadcast · labindex · labProbe · labReceive · labSend · labSendReceive · numlabs · parfeval · parfevalOnAll · parpool · redistribute · spmdBarrier · spmdBroadcast · spmdCat · spmdIndex · spmdPlus · spmdProbe · spmdReceive · spmdReduce · spmdSend · spmdSendReceive · spmdSize
Related guides
Source you can read
Every RunMat function's source is public. Read exactly how globalIndices is executed, line by line, in Rust.
- View the source for globalIndices in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.