Class: TechnicalAnalysis::Obv

Inherits:
Indicator show all
Defined in:
lib/technical_analysis/indicators/obv.rb

Overview

On-balance Volume

Class Method Summary collapse

Methods inherited from Indicator

find, roster

Class Method Details

.calculate(data) ⇒ Array<ObvValue>

Calculates the on-balance volume (OBV) for the data over the given period en.wikipedia.org/wiki/On-balance_volume



52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# File 'lib/technical_analysis/indicators/obv.rb', line 52

def self.calculate(data)
  Validation.validate_numeric_data(data, :close, :volume)
  Validation.validate_length(data, min_data_size({}))
  Validation.validate_date_time_key(data)

  data = data.sort_by { |row| row[:date_time] }

  current_obv = 0
  output = []
  prior_close = nil
  prior_volume = nil

  data.each do |v|
    volume = v[:volume]
    close = v[:close]

    unless prior_close.nil?
      current_obv += volume if close > prior_close
      current_obv -= volume if close < prior_close
    end

    output << ObvValue.new(date_time: v[:date_time], obv: current_obv)

    prior_volume = volume
    prior_close = close
  end

  output.sort_by(&:date_time).reverse
end

.indicator_nameString

Returns the name of the technical indicator



15
16
17
# File 'lib/technical_analysis/indicators/obv.rb', line 15

def self.indicator_name
  "On-balance Volume"
end

.indicator_symbolString

Returns the symbol of the technical indicator



8
9
10
# File 'lib/technical_analysis/indicators/obv.rb', line 8

def self.indicator_symbol
  "obv"
end

.min_data_size(**params) ⇒ Integer

Calculates the minimum number of observations needed to calculate the technical indicator



42
43
44
# File 'lib/technical_analysis/indicators/obv.rb', line 42

def self.min_data_size(**params)
  1
end

.valid_optionsArray

Returns an array of valid keys for options for this technical indicator



22
23
24
# File 'lib/technical_analysis/indicators/obv.rb', line 22

def self.valid_options
  []
end

.validate_options(options) ⇒ Boolean

Validates the provided options for this technical indicator



31
32
33
34
# File 'lib/technical_analysis/indicators/obv.rb', line 31

def self.validate_options(options)
  return true if options == {}
  raise Validation::ValidationError.new "This indicator doesn't accept any options."
end