Experimental modules
Overview
@luma.gl/experimental has been removed. Its APIs now live in ANARI, Engine experimental subpaths, and Graph experimental subpaths. These modules let the
project validate new GPU architecture, analytics, rendering, and simulation contracts before they
are considered for stable packages.
Experimental APIsWebGPU features available
Use the matching public package and explicit subpath for each API. Public scene renderers and their lighting, shadow, and transparency helpers now live in @luma.gl/anari. Controls, material plugins, texture helpers, and WebXR APIs live under @luma.gl/engine/experimental/*. Path/polygon models live under @luma.gl/engine/models; simulation code lives under @luma.gl/graph/experimental/simulation.
When to use it
Use an experimental module when its current contract fits your application and you can absorb changes between releases. Prefer Core, Engine, Shaders, or another stable package when they already provide the required capability.
Live example
This explicitly activated example compares A-buffer, weighted-blended, and ordinary alpha blending on the same scene. It demonstrates how an experimental renderer can still compose with stable Engine models and Shaders passes.
Module catalog
GPU Core and GPU analytics
| Module | Use it for |
|---|---|
@luma.gl/graph/gpu-data | Primitive GPU chunks, views, vectors, constants, memory formats, and basic layout helpers. |
@luma.gl/graph/gpu-tables | GPU record batches, tables, schemas, bindings, computations, and generic table planners. |
@luma.gl/engine/models | Experimental path and polygon rendering models. GPU input preparation remains in @luma.gl/graph/experimental/models. |
@luma.gl/graph/gpu-core | Schedule reusable GPU algorithms, validate resource dependencies, reuse transient storage, and drive indirect work. |
@luma.gl/graph/gpu-graph-algorithms | GPU-resident topology, traversal, connectivity, ranking, community, and layout algorithms. |
| GPU Raster | Validity-aware raster overviews, statistics, filters, morphology, contours, and bounded residency. |
| GPU Volume Algorithms | CuCIM-inspired dense 3D volume thresholding, morphology, connected components, and region measurements. |
| GPU Project | Adaptive high-precision coordinate projection on WebGPU. |
| GPU DGGS cells | H3 and A5 cell-center decoding for GPU-resident split-uint64 indexes. |
| GPU Trace | Large GPU-resident trace scenes, interaction, aggregation, temporal indexing, comparison, and causal analysis. |
| GPU Dataframe | Immutable GPU-resident dataframe expressions, grouping, aggregation, sorting, indexes, and joins. |
| GPU SQL | Bounded SQL planning over registered GPU Dataframe inputs. |
| GPU Crossfilter | Linked GPU filtering, histograms, aggregates, and rendering masks. |
| Geospatial kernels | Projection, distance, point-in-polygon, nearest-feature, and spatial-query operations. |
Rendering moved to ANARI
The following APIs are owned by @luma.gl/anari.
| Module | Use it for |
|---|---|
| SceneRenderer | Retained physically based forward rendering on WebGPU and WebGL 2. |
| DeferredSceneRenderer | G-buffer-based opaque lighting with forward fallbacks for unsupported materials. |
| PBR environments | Diffuse irradiance, prefiltered specular cubemaps, and BRDF lookup textures. |
| GBuffer | Standard scene color, normal, roughness, velocity, and depth attachments. |
| Selection outlines | Visible placement boundaries from exact integer ID textures. |
| Deferred lighting | Fullscreen lighting from G-buffer material targets. |
| Clustered lighting | Compute-binned local lights for deferred shading. |
| Shadow maps | Cascaded, spot-array, and point cube-array shadows with PCSS filtering. |
Materials and transparency
| Module | Use it for |
|---|---|
| A-buffer renderer | Accurate bounded per-pixel fragment storage, sorting, and compositing. |
| Weighted blended OIT | Portable approximate order-independent transparency without sorting. |
| Glass material | Screen-space refraction, Fresnel reflection, dispersion, and absorption. |
| Reflective material | Lightweight glossy environment reflection. |
| Spectral caustics | Geometry-derived multi-wavelength planar caustic lighting. |
| Comparison splitter | Accessible before-and-after canvas comparisons. |
Simulation and immersive input
| Module | Use it for |
|---|---|
| MLS-MPM fluid | Fixed-capacity two-dimensional particle/grid fluid simulation. |
| Spectral ocean | Deterministic FFT-based ocean displacement and foam. |
| Volumetric fire | GPU-resident volumetric combustion and rendering. |
| WebXR | Experimental WebGPU/WebGL session, frame, and camera helpers. |
Core concepts
Experimental modules follow the same ownership model as the rest of luma.gl: callers own the frame loop and command submission unless a reference explicitly says otherwise. GPU Core contributors declare work but do not submit it. Renderer and simulation references state which resources they own, borrow, cache, or expose.
Use the shared glossary for resource, ownership, binding, pipeline, pass, submission, data hazard, indirect work, and GPU residency terminology.
Limits and compatibility
Experimental APIs may change or be removed without the compatibility guarantees of stable packages. Many GPU Core and simulation modules require WebGPU; individual references state backend, feature, capacity, and memory requirements. Treat benchmark results as workload- and adapter- specific rather than universal performance claims.
Related modules
DepthTextureCopy transfers projected ray depth to a render attachment for raster overlays.
getRayTracingQualityPreset supplies interactive and still settings without changing camera or sampling seed.