Class: Veritas::Optimizer

Inherits:
Object
  • Object
show all
Includes:
AbstractType, Adamantium
Defined in:
lib/veritas/optimizer.rb,
lib/veritas/optimizer/version.rb,
lib/veritas/optimizer/function.rb,
lib/veritas/optimizer/aggregate.rb,
lib/veritas/optimizer/optimizable.rb,
lib/veritas/optimizer/algebra/join.rb,
lib/veritas/optimizer/algebra/union.rb,
lib/veritas/optimizer/aggregate/sum.rb,
lib/veritas/optimizer/algebra/rename.rb,
lib/veritas/optimizer/aggregate/mean.rb,
lib/veritas/optimizer/function/unary.rb,
lib/veritas/optimizer/algebra/product.rb,
lib/veritas/optimizer/aggregate/count.rb,
lib/veritas/optimizer/function/binary.rb,
lib/veritas/optimizer/function/numeric.rb,
lib/veritas/optimizer/aggregate/minimum.rb,
lib/veritas/optimizer/aggregate/maximum.rb,
lib/veritas/optimizer/algebra/extension.rb,
lib/veritas/optimizer/function/predicate.rb,
lib/veritas/optimizer/algebra/projection.rb,
lib/veritas/optimizer/aggregate/variance.rb,
lib/veritas/optimizer/algebra/difference.rb,
lib/veritas/optimizer/algebra/restriction.rb,
lib/veritas/optimizer/algebra/intersection.rb,
lib/veritas/optimizer/relation/materialized.rb,
lib/veritas/optimizer/algebra/summarization.rb,
lib/veritas/optimizer/function/string/length.rb,
lib/veritas/optimizer/function/numeric/modulo.rb,
lib/veritas/optimizer/relation/operation/order.rb,
lib/veritas/optimizer/relation/operation/limit.rb,
lib/veritas/optimizer/relation/operation/unary.rb,
lib/veritas/optimizer/function/predicate/match.rb,
lib/veritas/optimizer/relation/operation/offset.rb,
lib/veritas/optimizer/function/numeric/addition.rb,
lib/veritas/optimizer/function/numeric/division.rb,
lib/veritas/optimizer/function/numeric/absolute.rb,
lib/veritas/optimizer/relation/operation/binary.rb,
lib/veritas/optimizer/function/connective/binary.rb,
lib/veritas/optimizer/relation/operation/reverse.rb,
lib/veritas/optimizer/relation/operation/deletion.rb,
lib/veritas/optimizer/function/numeric/unary_plus.rb,
lib/veritas/optimizer/support/predicate_partition.rb,
lib/veritas/optimizer/function/predicate/equality.rb,
lib/veritas/optimizer/function/predicate/no_match.rb,
lib/veritas/optimizer/function/numeric/subtraction.rb,
lib/veritas/optimizer/function/numeric/square_root.rb,
lib/veritas/optimizer/function/predicate/inclusion.rb,
lib/veritas/optimizer/function/numeric/unary_minus.rb,
lib/veritas/optimizer/aggregate/standard_deviation.rb,
lib/veritas/optimizer/function/connective/negation.rb,
lib/veritas/optimizer/function/predicate/less_than.rb,
lib/veritas/optimizer/relation/operation/insertion.rb,
lib/veritas/optimizer/function/predicate/exclusion.rb,
lib/veritas/optimizer/function/predicate/enumerable.rb,
lib/veritas/optimizer/function/predicate/inequality.rb,
lib/veritas/optimizer/function/predicate/comparable.rb,
lib/veritas/optimizer/relation/operation/combination.rb,
lib/veritas/optimizer/function/connective/disjunction.rb,
lib/veritas/optimizer/function/numeric/exponentiation.rb,
lib/veritas/optimizer/function/predicate/greater_than.rb,
lib/veritas/optimizer/function/numeric/multiplication.rb,
lib/veritas/optimizer/function/connective/conjunction.rb,
lib/veritas/optimizer/function/predicate/less_than_or_equal_to.rb,
lib/veritas/optimizer/function/predicate/greater_than_or_equal_to.rb

Overview

A optimization for an operation

Defined Under Namespace

Modules: Algebra, Function, Optimizable, Relation Classes: Aggregate, PredicatePartition

Constant Summary

Identity =

An optimizer that returns the operation

lambda { |operation| operation }.freeze
VERSION =
'0.0.7'

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(operation) ⇒ undefined

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Initialize an Optimizer



29
30
31
# File 'lib/veritas/optimizer.rb', line 29

def initialize(operation)
  @operation = operation
end

Instance Attribute Details

#operationOptimizable (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

The operation to optimize



19
20
21
# File 'lib/veritas/optimizer.rb', line 19

def operation
  @operation
end

Class Method Details

.chain(*optimizers) ⇒ #call

Chain together a list of optimizer classes into a callable object

Examples:

Optimizer.chain(Optimizer::Foo, Optimizer::Bar)


68
69
70
71
72
# File 'lib/veritas/optimizer.rb', line 68

def self.chain(*optimizers)
  optimizers.reverse_each.reduce(Identity) do |successor, optimizer|
    link_optimizers(optimizer, successor)
  end
end

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Link an optimizer to a successor



84
85
86
87
88
89
# File 'lib/veritas/optimizer.rb', line 84

def self.link_optimizers(optimizer, successor)
  lambda do |operation|
    op = optimizer.new(operation)
    op.optimizable? ? op.optimize : successor.call(operation)
  end
end

Instance Method Details

#optimizable?Boolean

Abstract method that tests if the optimization should be applied

Examples:

optimizer.optimizable?  # => true or false

Raises:

  • (NotImplementedError)


41
42
43
# File 'lib/veritas/optimizer.rb', line 41

def optimizable?
  raise NotImplementedError, "#{self.class}#optimizable? must be implemented"
end

#optimizeOptimizable

Abstract method that executes the optimization for the operation

Examples:

optimized = optimizer.optimize

Raises:

  • (NotImplementedError)


53
54
55
# File 'lib/veritas/optimizer.rb', line 53

def optimize
  raise NotImplementedError, "#{self.class}#optimize must be implemented"
end