Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clean up expr analysis immediate accesses #1999

Merged
merged 4 commits into from
Jan 20, 2025
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
84 changes: 84 additions & 0 deletions vortex-expr/src/transform/immediate_access.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
use itertools::Itertools;
use vortex_array::aliases::hash_map::HashMap;
use vortex_array::aliases::hash_set::HashSet;
use vortex_dtype::{FieldName, StructDType};
use vortex_error::VortexResult;

use crate::traversal::{Node, NodeVisitor, TraversalOrder};
use crate::{ExprRef, GetItem, Identity, Select};

pub(crate) type FieldAccesses<'a> = HashMap<&'a ExprRef, HashSet<FieldName>>;

/// For all subexpressions in an expression, find the fields that are accessed directly from the
/// scope, but not any fields in those fields
/// e.g. scope = {a: {b: .., c: ..}, d: ..}, expr = ident().a.b + ident().d accesses {a,d} (not b).
pub(crate) struct ImmediateIdentityAccessesAnalysis<'a> {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we're cleaning up, can we start the convention of exporting a single function with the same name as the module, then keeping all structs internal?

You may have to define a result type struct for complex result.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You should move the comment to the public function

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sub_expressions: FieldAccesses<'a>,
scope_dtype: &'a StructDType,
}

impl<'a> ImmediateIdentityAccessesAnalysis<'a> {
fn new(scope_dtype: &'a StructDType) -> Self {
Self {
sub_expressions: HashMap::new(),
scope_dtype,
}
}

pub(crate) fn analyze(
expr: &'a ExprRef,
scope_dtype: &'a StructDType,
) -> VortexResult<FieldAccesses<'a>> {
let mut analysis = Self::new(scope_dtype);
expr.accept(&mut analysis)?;
Ok(analysis.sub_expressions)
}
}

// This is a very naive, but simple analysis to find the fields that are accessed directly on an
// identity node. This is combined to provide an over-approximation of the fields that are accessed
// by an expression.
impl<'a> NodeVisitor<'a> for ImmediateIdentityAccessesAnalysis<'a> {
type NodeTy = ExprRef;

fn visit_down(&mut self, node: &'a Self::NodeTy) -> VortexResult<TraversalOrder> {
assert!(
!node.as_any().is::<Select>(),
"cannot analyse select, simply the expression"
);
if let Some(get_item) = node.as_any().downcast_ref::<GetItem>() {
if get_item
.child()
.as_any()
.downcast_ref::<Identity>()
.is_some()
{
self.sub_expressions
.insert(node, HashSet::from_iter(vec![get_item.field().clone()]));

return Ok(TraversalOrder::Skip);
}
} else if node.as_any().downcast_ref::<Identity>().is_some() {
let st_dtype = &self.scope_dtype;
self.sub_expressions
.insert(node, st_dtype.names().iter().cloned().collect());
}

Ok(TraversalOrder::Continue)
}

fn visit_up(&mut self, node: &'a ExprRef) -> VortexResult<TraversalOrder> {
let accesses = node
.children()
.iter()
.filter_map(|c| self.sub_expressions.get(c).cloned())
.collect_vec();

let node_accesses = self.sub_expressions.entry(node).or_default();
accesses
.into_iter()
.for_each(|fields| node_accesses.extend(fields.iter().cloned()));

Ok(TraversalOrder::Continue)
}
}
1 change: 1 addition & 0 deletions vortex-expr/src/transform/mod.rs
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
//! A collection of transformations that can be applied to a [`crate::ExprRef`].
mod immediate_access;
pub mod partition;
pub(crate) mod remove_select;
pub mod simplify;
Expand Down
112 changes: 10 additions & 102 deletions vortex-expr/src/transform/partition.rs
Original file line number Diff line number Diff line change
@@ -1,14 +1,12 @@
use itertools::Itertools;
use vortex_array::aliases::hash_map::HashMap;
use vortex_array::aliases::hash_set::HashSet;
use vortex_dtype::{DType, Field, FieldName, StructDType};
use vortex_error::{vortex_bail, VortexExpect, VortexResult};

use crate::transform::immediate_access::{FieldAccesses, ImmediateIdentityAccessesAnalysis};
use crate::transform::simplify_typed::simplify_typed;
use crate::traversal::{
FoldDown, FoldUp, Folder, FolderMut, MutNodeVisitor, Node, TransformResult,
};
use crate::{get_item, ident, pack, ExprRef, GetItem, Identity, Select, SelectField};
use crate::traversal::{FoldDown, FoldUp, FolderMut, MutNodeVisitor, Node, TransformResult};
use crate::{get_item, ident, pack, ExprRef, GetItem, Identity};

/// Partition an expression over the fields of the scope.
///
Expand Down Expand Up @@ -58,99 +56,15 @@ pub struct Partition {
pub expr: ExprRef,
}

type FieldAccesses<'a> = HashMap<&'a ExprRef, HashSet<FieldName>>;

// For all subexpressions in an expression, find the fields that are accessed directly from the scope.
struct ImmediateIdentityAccessesAnalysis<'a> {
sub_expressions: FieldAccesses<'a>,
scope_dtype: &'a StructDType,
}

impl<'a> ImmediateIdentityAccessesAnalysis<'a> {
fn new(scope_dtype: &'a StructDType) -> Self {
Self {
sub_expressions: HashMap::new(),
scope_dtype,
}
}
}

// This is a very naive, but simple analysis to find the fields that are accessed directly on an
// identity node. This is combined to provide an over-approximation of the fields that are accessed
// by an expression.
// TODO(ngates): rewrite to use Visitor not Folder
impl<'a> Folder<'a> for ImmediateIdentityAccessesAnalysis<'a> {
type NodeTy = ExprRef;
type Out = ();
type Context = ();

fn visit_down(
&mut self,
node: &'a Self::NodeTy,
_context: (),
) -> VortexResult<FoldDown<Self::Out, Self::Context>> {
// TODO(joe): Resolve idx -> name for Field, this should be done as a separate,
// previous (not impl, yet), pass
if let Some(get_item) = node.as_any().downcast_ref::<GetItem>() {
if get_item
.child()
.as_any()
.downcast_ref::<Identity>()
.is_some()
{
self.sub_expressions
.insert(node, HashSet::from_iter(vec![get_item.field().clone()]));

return Ok(FoldDown::SkipChildren(()));
}
} else if let Some(select) = node.as_any().downcast_ref::<Select>() {
assert!(matches!(select.fields(), SelectField::Include(_)));
if select.child().as_any().downcast_ref::<Identity>().is_some() {
self.sub_expressions.insert(
node,
HashSet::from_iter(select.fields().fields().iter().cloned()),
);
}
return Ok(FoldDown::SkipChildren(()));
} else if node.as_any().downcast_ref::<Identity>().is_some() {
let st_dtype = &self.scope_dtype;
self.sub_expressions
.insert(node, st_dtype.names().iter().cloned().collect());
}

Ok(FoldDown::Continue(()))
}

fn visit_up(
&mut self,
node: &'a ExprRef,
_context: (),
_children: Vec<()>,
) -> VortexResult<FoldUp<()>> {
let accesses = node
.children()
.iter()
.filter_map(|c| self.sub_expressions.get(c).cloned())
.collect_vec();

let node_accesses = self.sub_expressions.entry(node).or_default();
accesses
.into_iter()
.for_each(|fields| node_accesses.extend(fields.iter().cloned()));

Ok(FoldUp::Continue(()))
}
}

#[derive(Debug)]
struct StructFieldExpressionSplitter<'a> {
sub_expressions: HashMap<FieldName, Vec<ExprRef>>,
accesses: FieldAccesses<'a>,
accesses: &'a FieldAccesses<'a>,
scope_dtype: &'a StructDType,
}

impl<'a> StructFieldExpressionSplitter<'a> {
fn new(accesses: FieldAccesses<'a>, scope_dtype: &'a StructDType) -> Self {
fn new(accesses: &'a FieldAccesses<'a>, scope_dtype: &'a StructDType) -> Self {
Self {
sub_expressions: HashMap::new(),
accesses,
Expand All @@ -168,16 +82,9 @@ impl<'a> StructFieldExpressionSplitter<'a> {
_ => vortex_bail!("Expected a struct dtype, got {:?}", dtype),
};

let mut expr_top_level_ref = ImmediateIdentityAccessesAnalysis::new(scope_dtype);
expr.accept_with_context(&mut expr_top_level_ref, ())?;

let expression_accesses = expr_top_level_ref
.sub_expressions
.get(&expr)
.map(|ac| ac.len());
let field_accesses = ImmediateIdentityAccessesAnalysis::analyze(&expr, scope_dtype)?;

let mut splitter =
StructFieldExpressionSplitter::new(expr_top_level_ref.sub_expressions, scope_dtype);
let mut splitter = StructFieldExpressionSplitter::new(&field_accesses, scope_dtype);

let split = expr.clone().transform_with_context(&mut splitter, ())?;

Expand Down Expand Up @@ -212,11 +119,12 @@ impl<'a> StructFieldExpressionSplitter<'a> {
})
.try_collect()?;

let expression_access_counts = field_accesses.get(&expr).map(|ac| ac.len());
// Ensure that there are not more accesses than partitions, we missed something
assert!(expression_accesses.unwrap_or(0) <= partitions.len());
assert!(expression_access_counts.unwrap_or(0) <= partitions.len());
// Ensure that there are as many partitions as there are accesses/fields in the scope,
// this will affect performance, not correctness.
debug_assert_eq!(expression_accesses.unwrap_or(0), partitions.len());
debug_assert_eq!(expression_access_counts.unwrap_or(0), partitions.len());

let split = split
.result()
Expand Down
Loading