Add explicit option to control how densities are resolved

vega · Nov 11, 2023 · 0a9c26f · 0a9c26f
1 parent c229a32
commit 0a9c26f
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 3 deletions.
diff --git a/src/compile/data/density.ts b/src/compile/data/density.ts
@@ -40,9 +40,7 @@ export class DensityTransformNode extends DataFlowNode {
       field: density,
       ...rest
     };
-    if (this.transform.groupby) {
-      result.resolve = 'shared';
-    }
+    result.resolve = this.transform.resolve;
     return result;
   }
 }
diff --git a/src/transform.ts b/src/transform.ts
@@ -496,6 +496,14 @@ export interface DensityTransform {
    * __Default value:__ `["value", "density"]`
    */
   as?: [FieldName, FieldName];
+  /**
+   * Indicates how parameters for multiple densities should be resolved.
+   * If "independent", each density may have its own domain extent and dynamic number of curve sample steps.
+   * If "shared", the KDE transform will ensure that all densities are defined over a shared domain and curve steps, enabling stacking.
+   *
+   * __Default value:__ `"independent"`
+   */
+  resolve?: 'independent' | 'shared';
 }
 
 export function isDensity(t: Transform): t is DensityTransform {