Skip to main content

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.

GitHub
0s

Module catalog​

GPU Core and GPU analytics​

ModuleUse it for
@luma.gl/graph/gpu-dataPrimitive GPU chunks, views, vectors, constants, memory formats, and basic layout helpers.
@luma.gl/graph/gpu-tablesGPU record batches, tables, schemas, bindings, computations, and generic table planners.
@luma.gl/engine/modelsExperimental path and polygon rendering models. GPU input preparation remains in @luma.gl/graph/experimental/models.
@luma.gl/graph/gpu-coreSchedule reusable GPU algorithms, validate resource dependencies, reuse transient storage, and drive indirect work.
@luma.gl/graph/gpu-graph-algorithmsGPU-resident topology, traversal, connectivity, ranking, community, and layout algorithms.
GPU RasterValidity-aware raster overviews, statistics, filters, morphology, contours, and bounded residency.
GPU Volume AlgorithmsCuCIM-inspired dense 3D volume thresholding, morphology, connected components, and region measurements.
GPU ProjectAdaptive high-precision coordinate projection on WebGPU.
GPU DGGS cellsH3 and A5 cell-center decoding for GPU-resident split-uint64 indexes.
GPU TraceLarge GPU-resident trace scenes, interaction, aggregation, temporal indexing, comparison, and causal analysis.
GPU DataframeImmutable GPU-resident dataframe expressions, grouping, aggregation, sorting, indexes, and joins.
GPU SQLBounded SQL planning over registered GPU Dataframe inputs.
GPU CrossfilterLinked GPU filtering, histograms, aggregates, and rendering masks.
Geospatial kernelsProjection, distance, point-in-polygon, nearest-feature, and spatial-query operations.

Rendering moved to ANARI​

The following APIs are owned by @luma.gl/anari.

ModuleUse it for
SceneRendererRetained physically based forward rendering on WebGPU and WebGL 2.
DeferredSceneRendererG-buffer-based opaque lighting with forward fallbacks for unsupported materials.
PBR environmentsDiffuse irradiance, prefiltered specular cubemaps, and BRDF lookup textures.
GBufferStandard scene color, normal, roughness, velocity, and depth attachments.
Selection outlinesVisible placement boundaries from exact integer ID textures.
Deferred lightingFullscreen lighting from G-buffer material targets.
Clustered lightingCompute-binned local lights for deferred shading.
Shadow mapsCascaded, spot-array, and point cube-array shadows with PCSS filtering.

Materials and transparency​

ModuleUse it for
A-buffer rendererAccurate bounded per-pixel fragment storage, sorting, and compositing.
Weighted blended OITPortable approximate order-independent transparency without sorting.
Glass materialScreen-space refraction, Fresnel reflection, dispersion, and absorption.
Reflective materialLightweight glossy environment reflection.
Spectral causticsGeometry-derived multi-wavelength planar caustic lighting.
Comparison splitterAccessible before-and-after canvas comparisons.

Simulation and immersive input​

ModuleUse it for
MLS-MPM fluidFixed-capacity two-dimensional particle/grid fluid simulation.
Spectral oceanDeterministic FFT-based ocean displacement and foam.
Volumetric fireGPU-resident volumetric combustion and rendering.
WebXRExperimental 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.

DepthTextureCopy transfers projected ray depth to a render attachment for raster overlays.

getRayTracingQualityPreset supplies interactive and still settings without changing camera or sampling seed.