@loaders.gl/scientific 0.0.0-stage → 5.0.0-alpha.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/README.md +21 -2
  2. package/dist/index.cjs +4313 -0
  3. package/dist/index.cjs.map +6 -0
  4. package/dist/index.d.ts +11 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +8 -0
  7. package/dist/index.js.map +1 -0
  8. package/dist/netcdf/bundled.cjs +1394 -0
  9. package/dist/netcdf/bundled.d.ts +2 -0
  10. package/dist/netcdf/bundled.d.ts.map +1 -0
  11. package/dist/netcdf/bundled.js +5 -0
  12. package/dist/netcdf/bundled.js.map +1 -0
  13. package/dist/netcdf/index.cjs +1394 -0
  14. package/dist/netcdf/index.cjs.map +6 -0
  15. package/dist/netcdf/index.d.ts +7 -0
  16. package/dist/netcdf/index.d.ts.map +1 -0
  17. package/dist/netcdf/index.js +8 -0
  18. package/dist/netcdf/index.js.map +1 -0
  19. package/dist/netcdf/iobuffer/iobuffer.d.ts +253 -0
  20. package/dist/netcdf/iobuffer/iobuffer.d.ts.map +1 -0
  21. package/dist/netcdf/iobuffer/iobuffer.js +450 -0
  22. package/dist/netcdf/iobuffer/iobuffer.js.map +1 -0
  23. package/dist/netcdf/netcdf-format.cjs +39 -0
  24. package/dist/netcdf/netcdf-format.d.ts +11 -0
  25. package/dist/netcdf/netcdf-format.d.ts.map +1 -0
  26. package/dist/netcdf/netcdf-format.js +14 -0
  27. package/dist/netcdf/netcdf-format.js.map +1 -0
  28. package/dist/netcdf/netcdf-loader-with-parser.cjs +995 -0
  29. package/dist/netcdf/netcdf-loader-with-parser.d.ts +60 -0
  30. package/dist/netcdf/netcdf-loader-with-parser.d.ts.map +1 -0
  31. package/dist/netcdf/netcdf-loader-with-parser.js +35 -0
  32. package/dist/netcdf/netcdf-loader-with-parser.js.map +1 -0
  33. package/dist/netcdf/netcdf-loader.cjs +84 -0
  34. package/dist/netcdf/netcdf-loader.d.ts +81 -0
  35. package/dist/netcdf/netcdf-loader.d.ts.map +1 -0
  36. package/dist/netcdf/netcdf-loader.js +41 -0
  37. package/dist/netcdf/netcdf-loader.js.map +1 -0
  38. package/dist/netcdf/netcdf-source-loader-types.cjs +78 -0
  39. package/dist/netcdf/netcdf-source-loader-types.d.ts +28 -0
  40. package/dist/netcdf/netcdf-source-loader-types.d.ts.map +1 -0
  41. package/dist/netcdf/netcdf-source-loader-types.js +32 -0
  42. package/dist/netcdf/netcdf-source-loader-types.js.map +1 -0
  43. package/dist/netcdf/netcdf-source-loader.cjs +1319 -0
  44. package/dist/netcdf/netcdf-source-loader.d.ts +59 -0
  45. package/dist/netcdf/netcdf-source-loader.d.ts.map +1 -0
  46. package/dist/netcdf/netcdf-source-loader.js +421 -0
  47. package/dist/netcdf/netcdf-source-loader.js.map +1 -0
  48. package/dist/netcdf/netcdfjs/netcdf-reader.d.ts +68 -0
  49. package/dist/netcdf/netcdfjs/netcdf-reader.d.ts.map +1 -0
  50. package/dist/netcdf/netcdfjs/netcdf-reader.js +172 -0
  51. package/dist/netcdf/netcdfjs/netcdf-reader.js.map +1 -0
  52. package/dist/netcdf/netcdfjs/netcdf-types.d.ts +70 -0
  53. package/dist/netcdf/netcdfjs/netcdf-types.d.ts.map +1 -0
  54. package/dist/netcdf/netcdfjs/netcdf-types.js +3 -0
  55. package/dist/netcdf/netcdfjs/netcdf-types.js.map +1 -0
  56. package/dist/netcdf/netcdfjs/read-data.d.ts +19 -0
  57. package/dist/netcdf/netcdfjs/read-data.d.ts.map +1 -0
  58. package/dist/netcdf/netcdfjs/read-data.js +51 -0
  59. package/dist/netcdf/netcdfjs/read-data.js.map +1 -0
  60. package/dist/netcdf/netcdfjs/read-header.d.ts +16 -0
  61. package/dist/netcdf/netcdfjs/read-header.d.ts.map +1 -0
  62. package/dist/netcdf/netcdfjs/read-header.js +227 -0
  63. package/dist/netcdf/netcdfjs/read-header.js.map +1 -0
  64. package/dist/netcdf/netcdfjs/read-type.d.ts +36 -0
  65. package/dist/netcdf/netcdfjs/read-type.d.ts.map +1 -0
  66. package/dist/netcdf/netcdfjs/read-type.js +135 -0
  67. package/dist/netcdf/netcdfjs/read-type.js.map +1 -0
  68. package/dist/netcdf/unbundled.cjs +1394 -0
  69. package/dist/netcdf/unbundled.d.ts +2 -0
  70. package/dist/netcdf/unbundled.d.ts.map +1 -0
  71. package/dist/netcdf/unbundled.js +5 -0
  72. package/dist/netcdf/unbundled.js.map +1 -0
  73. package/dist/netcdf.dev.js +3153 -0
  74. package/dist/netcdf.min.js +12 -0
  75. package/dist/zarr/bundled.d.ts +2 -0
  76. package/dist/zarr/bundled.d.ts.map +1 -0
  77. package/dist/zarr/bundled.js +5 -0
  78. package/dist/zarr/bundled.js.map +1 -0
  79. package/dist/zarr/geo-zarr-source-loader.d.ts +121 -0
  80. package/dist/zarr/geo-zarr-source-loader.d.ts.map +1 -0
  81. package/dist/zarr/geo-zarr-source-loader.js +692 -0
  82. package/dist/zarr/geo-zarr-source-loader.js.map +1 -0
  83. package/dist/zarr/index.cjs +14747 -0
  84. package/dist/zarr/index.cjs.map +6 -0
  85. package/dist/zarr/index.d.ts +11 -0
  86. package/dist/zarr/index.d.ts.map +1 -0
  87. package/dist/zarr/index.js +10 -0
  88. package/dist/zarr/index.js.map +1 -0
  89. package/dist/zarr/lib/consolidated-zarr.d.ts +31 -0
  90. package/dist/zarr/lib/consolidated-zarr.d.ts.map +1 -0
  91. package/dist/zarr/lib/consolidated-zarr.js +113 -0
  92. package/dist/zarr/lib/consolidated-zarr.js.map +1 -0
  93. package/dist/zarr/lib/load-zarr.d.ts +11 -0
  94. package/dist/zarr/lib/load-zarr.d.ts.map +1 -0
  95. package/dist/zarr/lib/load-zarr.js +22 -0
  96. package/dist/zarr/lib/load-zarr.js.map +1 -0
  97. package/dist/zarr/lib/spatial-multiscales.d.ts +14 -0
  98. package/dist/zarr/lib/spatial-multiscales.d.ts.map +1 -0
  99. package/dist/zarr/lib/spatial-multiscales.js +34 -0
  100. package/dist/zarr/lib/spatial-multiscales.js.map +1 -0
  101. package/dist/zarr/lib/utils.d.ts +28 -0
  102. package/dist/zarr/lib/utils.d.ts.map +1 -0
  103. package/dist/zarr/lib/utils.js +137 -0
  104. package/dist/zarr/lib/utils.js.map +1 -0
  105. package/dist/zarr/lib/zarr-data-cache.d.ts +13 -0
  106. package/dist/zarr/lib/zarr-data-cache.d.ts.map +1 -0
  107. package/dist/zarr/lib/zarr-data-cache.js +70 -0
  108. package/dist/zarr/lib/zarr-data-cache.js.map +1 -0
  109. package/dist/zarr/lib/zarr-pixel-source.d.ts +41 -0
  110. package/dist/zarr/lib/zarr-pixel-source.d.ts.map +1 -0
  111. package/dist/zarr/lib/zarr-pixel-source.js +97 -0
  112. package/dist/zarr/lib/zarr-pixel-source.js.map +1 -0
  113. package/dist/zarr/lib/zarrita-pixel-source.d.ts +40 -0
  114. package/dist/zarr/lib/zarrita-pixel-source.d.ts.map +1 -0
  115. package/dist/zarr/lib/zarrita-pixel-source.js +96 -0
  116. package/dist/zarr/lib/zarrita-pixel-source.js.map +1 -0
  117. package/dist/zarr/ome-zarr-source-loader.d.ts +195 -0
  118. package/dist/zarr/ome-zarr-source-loader.d.ts.map +1 -0
  119. package/dist/zarr/ome-zarr-source-loader.js +523 -0
  120. package/dist/zarr/ome-zarr-source-loader.js.map +1 -0
  121. package/dist/zarr/spatial-data-source.d.ts +95 -0
  122. package/dist/zarr/spatial-data-source.d.ts.map +1 -0
  123. package/dist/zarr/spatial-data-source.js +242 -0
  124. package/dist/zarr/spatial-data-source.js.map +1 -0
  125. package/dist/zarr/types.d.ts +105 -0
  126. package/dist/zarr/types.d.ts.map +1 -0
  127. package/dist/zarr/types.js +5 -0
  128. package/dist/zarr/types.js.map +1 -0
  129. package/dist/zarr/unbundled.d.ts +2 -0
  130. package/dist/zarr/unbundled.d.ts.map +1 -0
  131. package/dist/zarr/unbundled.js +5 -0
  132. package/dist/zarr/unbundled.js.map +1 -0
  133. package/dist/zarr/zarr-array-source.d.ts +102 -0
  134. package/dist/zarr/zarr-array-source.d.ts.map +1 -0
  135. package/dist/zarr/zarr-array-source.js +132 -0
  136. package/dist/zarr/zarr-array-source.js.map +1 -0
  137. package/dist/zarr/zarr-loader-types.d.ts +236 -0
  138. package/dist/zarr/zarr-loader-types.d.ts.map +1 -0
  139. package/dist/zarr/zarr-loader-types.js +128 -0
  140. package/dist/zarr/zarr-loader-types.js.map +1 -0
  141. package/dist/zarr.dev.js +16574 -0
  142. package/dist/zarr.min.js +79 -0
  143. package/package.json +62 -4
  144. package/src/index.ts +52 -0
  145. package/src/netcdf/bundled.ts +5 -0
  146. package/src/netcdf/index.ts +14 -0
  147. package/src/netcdf/iobuffer/iobuffer.ts +510 -0
  148. package/src/netcdf/netcdf-format.ts +16 -0
  149. package/src/netcdf/netcdf-loader-with-parser.ts +54 -0
  150. package/src/netcdf/netcdf-loader.ts +62 -0
  151. package/src/netcdf/netcdf-source-loader-types.ts +45 -0
  152. package/src/netcdf/netcdf-source-loader.ts +526 -0
  153. package/src/netcdf/netcdfjs/LICENSE +24 -0
  154. package/src/netcdf/netcdfjs/netcdf-reader.ts +196 -0
  155. package/src/netcdf/netcdfjs/netcdf-types.ts +75 -0
  156. package/src/netcdf/netcdfjs/read-data.ts +71 -0
  157. package/src/netcdf/netcdfjs/read-header.ts +277 -0
  158. package/src/netcdf/netcdfjs/read-type.ts +147 -0
  159. package/src/netcdf/unbundled.ts +5 -0
  160. package/src/zarr/bundled.ts +5 -0
  161. package/src/zarr/geo-zarr-source-loader.ts +998 -0
  162. package/src/zarr/index.ts +60 -0
  163. package/src/zarr/lib/consolidated-zarr.ts +190 -0
  164. package/src/zarr/lib/load-zarr.ts +31 -0
  165. package/src/zarr/lib/spatial-multiscales.ts +47 -0
  166. package/src/zarr/lib/utils.ts +162 -0
  167. package/src/zarr/lib/zarr-data-cache.ts +91 -0
  168. package/src/zarr/lib/zarr-pixel-source.ts +134 -0
  169. package/src/zarr/lib/zarrita-pixel-source.ts +141 -0
  170. package/src/zarr/ome-zarr-source-loader.ts +837 -0
  171. package/src/zarr/spatial-data-source.ts +370 -0
  172. package/src/zarr/types.ts +129 -0
  173. package/src/zarr/unbundled.ts +5 -0
  174. package/src/zarr/zarr-array-source.ts +225 -0
  175. package/src/zarr/zarr-loader-types.ts +166 -0
@@ -0,0 +1,523 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import * as zarrita from 'zarrita';
5
+ import { createScanQueryMetadata, DataSource } from '@loaders.gl/core/loader-utils';
6
+ import { guessLabels, guessTileSize, validLabels } from "./lib/utils.js";
7
+ import ZarritaPixelSource from "./lib/zarrita-pixel-source.js";
8
+ import { loadConsolidatedMetadata } from "./lib/consolidated-zarr.js";
9
+ // __VERSION__ is injected by babel-plugin-version-inline
10
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
11
+ const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
12
+ /**
13
+ * Loads consolidated metadata for a Zarr store root and extracts top-level arrays and groups.
14
+ */
15
+ export async function loadZarrConsolidatedMetadata(url, options = {}) {
16
+ const fetcher = options.fetch || fetch;
17
+ return await loadConsolidatedMetadata(url, fetcher, options);
18
+ }
19
+ /**
20
+ * Base runtime source for Zarr-backed sources that resolve groups and consolidated metadata.
21
+ */
22
+ export class ZarrSource extends DataSource {
23
+ /** Common raster-query capabilities shared by Zarr-backed sources. */
24
+ rasterQueryCapabilities = Object.freeze({
25
+ bounds: 'pushdown',
26
+ level: 'pushdown',
27
+ variables: 'pushdown',
28
+ slices: 'pushdown',
29
+ streaming: false,
30
+ cancellation: true
31
+ });
32
+ /** Zarrita store used for metadata and chunk reads. */
33
+ store;
34
+ /** Selected group path within the store root. */
35
+ path;
36
+ /** Shared consolidated metadata request. */
37
+ consolidatedMetadataPromise = null;
38
+ /** Creates a Zarr-backed source. */
39
+ constructor(data, options, coreApi) {
40
+ super(data, options, {
41
+ zarr: {
42
+ metadataPath: 'auto',
43
+ path: null,
44
+ labels: undefined,
45
+ requireConsolidatedMetadata: true
46
+ },
47
+ omezarr: {
48
+ interleaved: false,
49
+ defaultChannels: undefined
50
+ }
51
+ }, coreApi);
52
+ this.path = this.options.zarr?.path || null;
53
+ this.store = new zarrita.FetchStore(getZarritaStoreUrl(this.url), {
54
+ fetch: async (request) => {
55
+ const headers = Object.fromEntries(request.headers.entries());
56
+ return await this.fetchZarrFile(request.url, {
57
+ method: request.method,
58
+ headers,
59
+ signal: request.signal
60
+ });
61
+ }
62
+ });
63
+ }
64
+ /** Returns raster-query capabilities without reading array chunks. */
65
+ getRasterQueryCapabilities() {
66
+ return this.rasterQueryCapabilities;
67
+ }
68
+ /** Fetches Zarr metadata or chunk data through the injected core API when available. */
69
+ async fetchZarrFile(url, requestOptions) {
70
+ const fetchUrl = getFetchableUrl(url);
71
+ const response = this.hasCoreApi
72
+ ? await this.coreApi.fetchFile(fetchUrl, requestOptions)
73
+ : await this.fetch(fetchUrl, requestOptions);
74
+ // The Node file fetcher reports missing files as 400/ENOENT, while FetchStore
75
+ // needs a 404 response to continue its v2/v3 format probing.
76
+ if (response.status === 400 && response.statusText.includes('ENOENT')) {
77
+ return new Response(null, { status: 404, statusText: 'Not Found' });
78
+ }
79
+ return response;
80
+ }
81
+ /** Loads normalized consolidated metadata for the backing Zarr store. */
82
+ async getConsolidatedMetadata(signal) {
83
+ if (!this.consolidatedMetadataPromise) {
84
+ this.consolidatedMetadataPromise = loadConsolidatedMetadata(this.url, (url, requestOptions) => this.fetchZarrFile(url, requestOptions), {
85
+ metadataPath: this.options.zarr?.metadataPath,
86
+ signal
87
+ });
88
+ }
89
+ const consolidatedMetadataPromise = this.consolidatedMetadataPromise;
90
+ try {
91
+ return await consolidatedMetadataPromise;
92
+ }
93
+ catch (error) {
94
+ if (this.consolidatedMetadataPromise === consolidatedMetadataPromise) {
95
+ this.consolidatedMetadataPromise = null;
96
+ }
97
+ throw error;
98
+ }
99
+ }
100
+ /** Opens the selected Zarr group after the configured metadata preflight. */
101
+ async openGroup(signal) {
102
+ if (this.options.zarr?.requireConsolidatedMetadata) {
103
+ await this.getConsolidatedMetadata(signal);
104
+ }
105
+ const location = this.path ? zarrita.root(this.store).resolve(this.path) : this.store;
106
+ return await zarrita.open(location, { kind: 'group', signal });
107
+ }
108
+ }
109
+ /**
110
+ * Source factory for OME-Zarr multiscale images and labels.
111
+ */
112
+ export const OMEZarrSourceLoaderWithParser = {
113
+ dataType: null,
114
+ /** Runtime source type marker used by `createDataSource()` type inference. */
115
+ dataSource: null,
116
+ batchType: null,
117
+ name: 'OMEZarrSourceLoader',
118
+ id: 'omezarr',
119
+ module: 'scientific',
120
+ version: VERSION,
121
+ extensions: ['zarr'],
122
+ mimeTypes: [],
123
+ type: 'omezarr',
124
+ fromUrl: true,
125
+ fromBlob: false,
126
+ options: {
127
+ zarr: {
128
+ metadataPath: 'auto',
129
+ path: null,
130
+ labels: undefined,
131
+ requireConsolidatedMetadata: true
132
+ },
133
+ omezarr: {
134
+ interleaved: false,
135
+ defaultChannels: undefined
136
+ }
137
+ },
138
+ defaultOptions: {
139
+ zarr: {
140
+ metadataPath: 'auto',
141
+ path: null,
142
+ labels: undefined,
143
+ requireConsolidatedMetadata: true
144
+ },
145
+ omezarr: {
146
+ interleaved: false,
147
+ defaultChannels: undefined
148
+ }
149
+ },
150
+ testURL: (url) => /\.zarr(?:$|[/?#])/i.test(url),
151
+ createDataSource: (data, options, coreApi) => new OMEZarrImageSource(data, options, coreApi)
152
+ };
153
+ /**
154
+ * Source that loads 2D planes from an OME-Zarr pyramid.
155
+ */
156
+ export class OMEZarrImageSource extends ZarrSource {
157
+ /** Shared source initialization request. */
158
+ initPromise = null;
159
+ /** Returns normalized OME-Zarr image and pyramid metadata. */
160
+ async getMetadata(signal) {
161
+ const { metadata } = await this.getInitPromise(signal);
162
+ return metadata;
163
+ }
164
+ /** Discovers the raster pyramid through the common scan metadata contract. */
165
+ async getQueryMetadata(options = {}) {
166
+ const metadata = await this.getMetadata(options.signal);
167
+ return createScanQueryMetadata({
168
+ sourceType: 'omezarr',
169
+ queryType: 'raster',
170
+ execution: { status: 'supported', method: 'getRaster' },
171
+ name: metadata.name,
172
+ description: 'OME-Zarr multiscale image',
173
+ schema: { fields: [], metadata: {} },
174
+ capabilities: {
175
+ levelOfDetail: metadata.levels.length > 1 ? 'pushdown' : 'unsupported'
176
+ },
177
+ levels: metadata.levels.map(level => ({
178
+ index: level.level,
179
+ width: level.width,
180
+ height: level.height,
181
+ scale: level.scale
182
+ }))
183
+ });
184
+ }
185
+ /** Loads one 2D OME-Zarr plane or channel composite. */
186
+ async getRaster(parameters = {}) {
187
+ const { data, metadata } = await this.getInitPromise(parameters.signal);
188
+ const level = selectOMEZarrLevel(metadata.levels, parameters);
189
+ const pixelSource = data[level];
190
+ if (!pixelSource) {
191
+ throw new Error(`OME-Zarr pyramid level ${level} is not available.`);
192
+ }
193
+ const interleavedSource = metadata.labels.includes('_c');
194
+ const interleaved = parameters.interleaved ?? this.options.omezarr?.interleaved ?? interleavedSource;
195
+ const selection = {};
196
+ const timeIndex = normalizeAxisSelection(parameters.t, metadata.defaultT, metadata.sizeT, 'time');
197
+ const zIndex = normalizeAxisSelection(parameters.z, metadata.defaultZ, metadata.sizeZ, 'z');
198
+ if (metadata.labels.includes('t')) {
199
+ selection.t = timeIndex;
200
+ }
201
+ if (metadata.labels.includes('z')) {
202
+ selection.z = zIndex;
203
+ }
204
+ const channels = normalizeChannelSelection(parameters.channels, metadata.bandCount, this.options.omezarr?.defaultChannels);
205
+ if (interleavedSource) {
206
+ const raster = await pixelSource.getRaster({ selection, signal: parameters.signal });
207
+ const rawData = raster.data;
208
+ const channelData = selectInterleavedChannels(rawData, metadata.bandCount, channels, interleaved);
209
+ return {
210
+ data: channelData,
211
+ width: raster.width,
212
+ height: raster.height,
213
+ bandCount: channels.length,
214
+ dtype: metadata.dtype,
215
+ interleaved,
216
+ metadata: { selection, channels, level, sourceLabels: metadata.labels }
217
+ };
218
+ }
219
+ const rasters = await Promise.all(channels.map(channel => pixelSource.getRaster({
220
+ selection: { ...selection, c: channel },
221
+ signal: parameters.signal
222
+ })));
223
+ const { width, height } = rasters[0];
224
+ const channelData = rasters.map(raster => raster.data);
225
+ return {
226
+ data: interleaved
227
+ ? interleaveTypedArrays(channelData, metadata.dtype)
228
+ : channelData.length === 1
229
+ ? channelData[0]
230
+ : channelData,
231
+ width,
232
+ height,
233
+ bandCount: channelData.length,
234
+ dtype: metadata.dtype,
235
+ interleaved,
236
+ metadata: { selection, channels, level, sourceLabels: metadata.labels }
237
+ };
238
+ }
239
+ /** Returns the shared initialization request for this source. */
240
+ async getInitPromise(signal) {
241
+ if (!this.initPromise) {
242
+ this.initPromise = this.initialize(signal);
243
+ }
244
+ const initPromise = this.initPromise;
245
+ try {
246
+ return await initPromise;
247
+ }
248
+ catch (error) {
249
+ if (this.initPromise === initPromise) {
250
+ this.initPromise = null;
251
+ }
252
+ throw error;
253
+ }
254
+ }
255
+ /** Opens the image group and creates one pixel source per pyramid level. */
256
+ async initialize(signal) {
257
+ const group = await this.openGroup(signal);
258
+ const attrs = normalizeRootAttrs(group.attrs);
259
+ const datasets = attrs.multiscales?.[0]?.datasets;
260
+ if (!datasets?.length) {
261
+ throw new Error('OMEZarrImageSource requires multiscales metadata on the selected group.');
262
+ }
263
+ const arrays = await Promise.all(datasets.map(dataset => zarrita.open(group.resolve(dataset.path), { kind: 'array', signal })));
264
+ const labels = inferLabels(attrs, arrays[0], this.options.zarr?.labels);
265
+ const tileSize = guessTileSize({ shape: arrays[0].shape, chunks: arrays[0].chunks }, labels);
266
+ const data = arrays.map(array => new ZarritaPixelSource(array, labels, tileSize));
267
+ return {
268
+ data,
269
+ metadata: normalizeOMEZarrMetadata(this.path || this.data, attrs, data)
270
+ };
271
+ }
272
+ }
273
+ /** Normalizes pre-0.5 and 0.5 OME attributes into one internal shape. */
274
+ function normalizeRootAttrs(attrs) {
275
+ const omeAttrs = 'ome' in attrs && attrs.ome ? attrs.ome : null;
276
+ const multiscales = ('multiscales' in attrs ? attrs.multiscales : undefined) || omeAttrs?.multiscales || [];
277
+ const legacyCoordinateTransformations = 'coordinateTransformations' in attrs ? attrs.coordinateTransformations : undefined;
278
+ return {
279
+ multiscales,
280
+ omero: ('omero' in attrs ? attrs.omero : undefined) || omeAttrs?.omero || {},
281
+ coordinateTransformations: multiscales[0]?.coordinateTransformations ||
282
+ legacyCoordinateTransformations ||
283
+ omeAttrs?.coordinateTransformations
284
+ };
285
+ }
286
+ /** Resolves dimension labels from explicit options, array metadata, or OME axes. */
287
+ function inferLabels(attrs, array, optionLabels) {
288
+ const labels = optionLabels ||
289
+ normalizeDimensionNames(array.dimensionNames) ||
290
+ getAxisNames(attrs.multiscales?.[0]?.axes) ||
291
+ guessLabels(attrs);
292
+ if (!validLabels(labels, array.shape)) {
293
+ throw new Error('Invalid labels for OME-Zarr array dimensions.');
294
+ }
295
+ return labels;
296
+ }
297
+ /** Copies non-empty Zarr v3 dimension names. */
298
+ function normalizeDimensionNames(dimensionNames) {
299
+ if (!dimensionNames?.length) {
300
+ return null;
301
+ }
302
+ return [...dimensionNames];
303
+ }
304
+ /** Extracts named dimensions from OME multiscale axis metadata. */
305
+ function getAxisNames(axes) {
306
+ if (!axes?.length) {
307
+ return null;
308
+ }
309
+ const labels = axes
310
+ .map(axis => (typeof axis === 'string' ? axis : axis.name))
311
+ .filter((axisName) => Boolean(axisName));
312
+ return labels.length ? labels : null;
313
+ }
314
+ /** Builds normalized OME-Zarr metadata from the opened pyramid sources. */
315
+ function normalizeOMEZarrMetadata(data, attrs, sources) {
316
+ const baseSource = sources[0];
317
+ const interleaved = baseSource.labels[baseSource.labels.length - 1] === '_c';
318
+ const [height, width] = baseSource.shape.slice(interleaved ? -3 : -2);
319
+ const labels = [...baseSource.labels];
320
+ const dtype = normalizeDtype(baseSource.dtype);
321
+ const bandCount = getAxisSize(baseSource.shape, labels, '_c') ||
322
+ getAxisSize(baseSource.shape, labels, 'c') ||
323
+ attrs.omero?.channels?.length ||
324
+ 1;
325
+ const levels = sources.map((source, level) => {
326
+ const levelInterleaved = source.labels[source.labels.length - 1] === '_c';
327
+ const [levelHeight, levelWidth] = source.shape.slice(levelInterleaved ? -3 : -2);
328
+ const dataset = attrs.multiscales[0]?.datasets[level];
329
+ return {
330
+ level,
331
+ path: dataset?.path || String(level),
332
+ width: levelWidth,
333
+ height: levelHeight,
334
+ coordinateTransformations: dataset?.coordinateTransformations,
335
+ scale: [width / levelWidth, height / levelHeight]
336
+ };
337
+ });
338
+ return {
339
+ name: attrs.omero?.name || getOMEZarrName(data),
340
+ width,
341
+ height,
342
+ bandCount,
343
+ dtype,
344
+ sizeT: getAxisSize(baseSource.shape, labels, 't') || 1,
345
+ sizeZ: getAxisSize(baseSource.shape, labels, 'z') || 1,
346
+ sizeC: getAxisSize(baseSource.shape, labels, 'c') ||
347
+ getAxisSize(baseSource.shape, labels, '_c') ||
348
+ attrs.omero?.channels?.length ||
349
+ 1,
350
+ defaultT: attrs.omero?.rdefs?.defaultT ?? 0,
351
+ defaultZ: attrs.omero?.rdefs?.defaultZ ?? 0,
352
+ labels,
353
+ tileSize: { width: baseSource.tileWidth, height: baseSource.tileHeight },
354
+ levels,
355
+ channels: (attrs.omero?.channels || []).map(normalizeChannel),
356
+ metadata: attrs,
357
+ coordinateTransformations: attrs.coordinateTransformations
358
+ };
359
+ }
360
+ /** Selects an explicit level or the closest pyramid level for a target viewport. */
361
+ function selectOMEZarrLevel(levels, parameters) {
362
+ if (typeof parameters.level === 'number') {
363
+ return parameters.level;
364
+ }
365
+ if (parameters.level !== 'auto' || !parameters.width || !parameters.height) {
366
+ return 0;
367
+ }
368
+ const suitable = levels
369
+ .filter(level => level.width >= parameters.width && level.height >= parameters.height)
370
+ .sort((first, second) => first.width * first.height - second.width * second.height);
371
+ return (suitable[0] || levels[0]).level;
372
+ }
373
+ /** Converts OME display settings for one channel into public metadata. */
374
+ function normalizeChannel(channel, index) {
375
+ return {
376
+ index,
377
+ name: channel.label,
378
+ color: channel.color,
379
+ active: channel.active
380
+ };
381
+ }
382
+ /** Returns the size of a named dimension when it is present. */
383
+ function getAxisSize(shape, labels, label) {
384
+ const index = labels.indexOf(label);
385
+ return index >= 0 ? shape[index] : null;
386
+ }
387
+ /** Converts a Zarrita dtype into the raster source dtype union. */
388
+ function normalizeDtype(dtype) {
389
+ switch (dtype) {
390
+ case 'uint8':
391
+ case 'uint16':
392
+ case 'uint32':
393
+ case 'int8':
394
+ case 'int16':
395
+ case 'int32':
396
+ case 'float32':
397
+ case 'float64':
398
+ return dtype;
399
+ default:
400
+ throw new Error(`OME-Zarr dtype ${dtype} is not currently supported.`);
401
+ }
402
+ }
403
+ /** Resolves and validates the channel selection for a raster request. */
404
+ function normalizeChannelSelection(requestedChannels, bandCount, defaultChannels) {
405
+ const channelSelection = requestedChannels || defaultChannels || Array.from({ length: bandCount }, (_, index) => index);
406
+ if (channelSelection.length === 0) {
407
+ throw new Error('OME-Zarr channel selection must include at least one channel.');
408
+ }
409
+ for (const channel of channelSelection) {
410
+ if (!Number.isInteger(channel) || channel < 0 || channel >= bandCount) {
411
+ throw new Error(`Channel ${channel} is out of bounds for OME-Zarr with ${bandCount} bands.`);
412
+ }
413
+ }
414
+ return [...channelSelection];
415
+ }
416
+ /** Resolves and validates one optional time or z selection. */
417
+ function normalizeAxisSelection(requestedIndex, defaultIndex, size, axisName) {
418
+ const index = requestedIndex ?? defaultIndex;
419
+ if (!Number.isInteger(index) || index < 0 || index >= size) {
420
+ throw new Error(`OME-Zarr ${axisName} index ${index} is out of bounds for axis size ${size}.`);
421
+ }
422
+ return index;
423
+ }
424
+ /** Derives a display name from a store URL or selected group path. */
425
+ function getOMEZarrName(data) {
426
+ const normalizedData = data.replace(/[?#].*$/, '').replace(/\/+$/, '');
427
+ return normalizedData.split('/').pop() || normalizedData;
428
+ }
429
+ /** Converts file URLs emitted by FetchStore into paths accepted by core's Node file fetcher. */
430
+ function getFetchableUrl(url) {
431
+ if (!url.startsWith('file:')) {
432
+ return url;
433
+ }
434
+ return decodeURIComponent(new URL(url).pathname);
435
+ }
436
+ /** Resolves browser-relative URLs because Zarrita's FetchStore requires an absolute URL. */
437
+ function getZarritaStoreUrl(url) {
438
+ if (typeof globalThis.location?.href !== 'string') {
439
+ return url;
440
+ }
441
+ return new URL(url, globalThis.location.href).href;
442
+ }
443
+ /** Interleaves equally sized planar channel arrays. */
444
+ function interleaveTypedArrays(data, dtype) {
445
+ const TypedArrayConstructor = getTypedArrayConstructor(dtype);
446
+ const length = data[0]?.length || 0;
447
+ const channelCount = data.length;
448
+ const interleaved = new TypedArrayConstructor(length * channelCount);
449
+ for (let index = 0; index < length; index++) {
450
+ for (let channelIndex = 0; channelIndex < channelCount; channelIndex++) {
451
+ interleaved[index * channelCount + channelIndex] = data[channelIndex][index];
452
+ }
453
+ }
454
+ return interleaved;
455
+ }
456
+ /** Selects channels from an interleaved source and returns the requested layout. */
457
+ function selectInterleavedChannels(data, bandCount, channels, interleaved) {
458
+ if (channels.length === bandCount &&
459
+ interleaved &&
460
+ channels.every((channel, index) => channel === index)) {
461
+ return data;
462
+ }
463
+ const TypedArrayConstructor = data.constructor;
464
+ const pixelCount = data.length / bandCount;
465
+ const channelData = channels.map(() => new TypedArrayConstructor(pixelCount));
466
+ for (let pixelIndex = 0; pixelIndex < pixelCount; pixelIndex++) {
467
+ for (let channelSelectionIndex = 0; channelSelectionIndex < channels.length; channelSelectionIndex++) {
468
+ channelData[channelSelectionIndex][pixelIndex] =
469
+ data[pixelIndex * bandCount + channels[channelSelectionIndex]];
470
+ }
471
+ }
472
+ if (interleaved) {
473
+ return interleaveTypedArrays(channelData, getTypedArrayDtype(TypedArrayConstructor));
474
+ }
475
+ return channelData.length === 1 ? channelData[0] : channelData;
476
+ }
477
+ /** Returns the typed-array constructor for a raster dtype. */
478
+ function getTypedArrayConstructor(dtype) {
479
+ switch (dtype) {
480
+ case 'uint8':
481
+ return Uint8Array;
482
+ case 'uint16':
483
+ return Uint16Array;
484
+ case 'uint32':
485
+ return Uint32Array;
486
+ case 'int8':
487
+ return Int8Array;
488
+ case 'int16':
489
+ return Int16Array;
490
+ case 'int32':
491
+ return Int32Array;
492
+ case 'float32':
493
+ return Float32Array;
494
+ case 'float64':
495
+ return Float64Array;
496
+ default:
497
+ throw new Error(`Unsupported dtype ${dtype}.`);
498
+ }
499
+ }
500
+ /** Returns the raster dtype represented by a typed-array constructor. */
501
+ function getTypedArrayDtype(TypedArrayConstructor) {
502
+ switch (TypedArrayConstructor) {
503
+ case Uint8Array:
504
+ return 'uint8';
505
+ case Uint16Array:
506
+ return 'uint16';
507
+ case Uint32Array:
508
+ return 'uint32';
509
+ case Int8Array:
510
+ return 'int8';
511
+ case Int16Array:
512
+ return 'int16';
513
+ case Int32Array:
514
+ return 'int32';
515
+ case Float32Array:
516
+ return 'float32';
517
+ case Float64Array:
518
+ return 'float64';
519
+ default:
520
+ throw new Error('Unsupported TypedArray constructor.');
521
+ }
522
+ }
523
+ //# sourceMappingURL=ome-zarr-source-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ome-zarr-source-loader.js","sourceRoot":"","sources":["../../src/zarr/ome-zarr-source-loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,95 @@
1
+ import type { CoreAPI } from '@loaders.gl/core/loader-utils';
2
+ import { OMEZarrImageSource, type ZarrSourceLoaderOptions, ZarrSource } from "./ome-zarr-source-loader.js";
3
+ import { ZarrArraySource, type ZarrArraySourceLoaderOptions } from "./zarr-array-source.js";
4
+ /** SpatialData element families stored below a container root. */
5
+ export type SpatialDataElementKind = 'image' | 'labels' | 'points' | 'shapes' | 'table';
6
+ /** Storage convention used by one SpatialData element. */
7
+ export type SpatialDataElementFormat = 'ome-zarr' | 'parquet-dataset' | 'geoparquet' | 'anndata-zarr';
8
+ /** A normalized SpatialData element discovered without reading its payload. */
9
+ export type SpatialDataElementMetadata = Readonly<{
10
+ /** Element family. */
11
+ kind: SpatialDataElementKind;
12
+ /** Element name within its family namespace. */
13
+ name: string;
14
+ /** Zarr group path relative to the SpatialData root. */
15
+ path: string;
16
+ /** URL of the element group or its external table payload. */
17
+ url: string;
18
+ /** Storage convention used to open the element. */
19
+ format: SpatialDataElementFormat;
20
+ /** SpatialData element encoding version when declared. */
21
+ version?: string;
22
+ /** Named element axes when declared. */
23
+ axes?: readonly string[];
24
+ /** Coordinate transformations retained in their interoperable NGFF representation. */
25
+ coordinateTransformations?: readonly unknown[];
26
+ /** Original group attributes for application-specific extensions. */
27
+ attributes: Readonly<Record<string, unknown>>;
28
+ }>;
29
+ /** Normalized metadata for a SpatialData container. */
30
+ export type SpatialDataSourceMetadata = Readonly<{
31
+ /** SpatialData container format version. */
32
+ version?: string;
33
+ /** Every discovered element in stable namespace and name order. */
34
+ elements: readonly SpatialDataElementMetadata[];
35
+ /** Image elements. */
36
+ images: readonly SpatialDataElementMetadata[];
37
+ /** Label raster elements. */
38
+ labels: readonly SpatialDataElementMetadata[];
39
+ /** Point-table elements. */
40
+ points: readonly SpatialDataElementMetadata[];
41
+ /** Shape-table elements. */
42
+ shapes: readonly SpatialDataElementMetadata[];
43
+ /** AnnData table elements. */
44
+ tables: readonly SpatialDataElementMetadata[];
45
+ /** Original root attributes. */
46
+ attributes: Readonly<Record<string, unknown>>;
47
+ }>;
48
+ /** Options for {@link SpatialDataSourceLoader}. */
49
+ export type SpatialDataSourceLoaderOptions = ZarrSourceLoaderOptions;
50
+ /** Runtime source returned for a Zarr-backed SpatialData raster or table array. */
51
+ export type SpatialDataZarrElementSource = OMEZarrImageSource | ZarrArraySource;
52
+ /** Source loader for SpatialData containers stored as Zarr. */
53
+ export declare const SpatialDataSourceLoaderWithParser: {
54
+ readonly dataType: SpatialDataSource;
55
+ readonly dataSource: SpatialDataSource;
56
+ readonly batchType: never;
57
+ readonly name: "SpatialDataSourceLoader";
58
+ readonly id: "spatial-data";
59
+ readonly module: "scientific";
60
+ readonly version: any;
61
+ readonly extensions: ["zarr"];
62
+ readonly mimeTypes: [];
63
+ readonly type: "spatial-data";
64
+ readonly fromUrl: true;
65
+ readonly fromBlob: false;
66
+ readonly options: SpatialDataSourceLoaderOptions;
67
+ readonly defaultOptions: {
68
+ readonly zarr: {
69
+ readonly metadataPath: "auto";
70
+ readonly path: null;
71
+ readonly labels: never;
72
+ readonly requireConsolidatedMetadata: true;
73
+ };
74
+ };
75
+ readonly testURL: (url: string) => boolean;
76
+ readonly createDataSource: (data: string, options: SpatialDataSourceLoaderOptions, coreApi?: CoreAPI) => SpatialDataSource;
77
+ };
78
+ /** Discovers and opens the typed elements of a SpatialData Zarr container. */
79
+ export declare class SpatialDataSource extends ZarrSource {
80
+ /** Shared normalized metadata discovery request. */
81
+ private metadataPromise;
82
+ /** Creates a SpatialData container source. */
83
+ constructor(data: string, options?: SpatialDataSourceLoaderOptions, coreApi?: CoreAPI);
84
+ /** Discovers images, labels, points, shapes, and tables without reading payload chunks. */
85
+ getMetadata(signal?: AbortSignal): Promise<SpatialDataSourceMetadata>;
86
+ /** Returns one named element, throwing when the kind or name is absent. */
87
+ getElement(kind: SpatialDataElementKind, name: string, signal?: AbortSignal): Promise<SpatialDataElementMetadata>;
88
+ /** Opens an image or label element as an OME-Zarr raster source. */
89
+ createRasterSource(kind: 'image' | 'labels', name: string, signal?: AbortSignal): Promise<OMEZarrImageSource>;
90
+ /** Opens an array below an AnnData table element through the generic Zarr array source. */
91
+ createTableArraySource(name: string, arrayPath: string, options?: ZarrArraySourceLoaderOptions['zarrArray'], signal?: AbortSignal): Promise<ZarrArraySource>;
92
+ /** Loads and normalizes the consolidated SpatialData element catalog. */
93
+ private discoverMetadata;
94
+ }
95
+ //# sourceMappingURL=spatial-data-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spatial-data-source.d.ts","sourceRoot":"","sources":["../../src/zarr/spatial-data-source.ts"],"names":[],"mappings":"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"}