Class: Gnuplot::Plot

Inherits:
Object
  • Object
show all
Defined in:
lib/gnuplot.rb

Overview

Holds command information and performs the formatting of that command information to a Gnuplot process. When constructing a new plot for gnuplot, this is the first object that must be instantiated. On this object set the various properties and add data sets.

Direct Known Subclasses

SPlot

Constant Summary collapse

QUOTED = 
[ "title", "output", "xlabel", "x2label", "ylabel", "y2label", "clabel", "cblabel", "zlabel" ]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(io = nil, cmd = "plot") {|_self| ... } ⇒ Plot

Returns a new instance of Plot.

Yields:

  • (_self)

Yield Parameters:

  • _self (Gnuplot::Plot) —

    the object that the method was called on



95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/gnuplot.rb', line 95

def initialize (io = nil, cmd = "plot")
  @cmd = cmd
  @sets = []
  @arbitrary_lines = []
  @data = []
  yield self if block_given?
  puts "writing this to gnuplot:\n" + to_gplot + "\n" if $VERBOSE

  if io    
    io << to_gplot
    io << store_datasets
  end
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(methId, *args) ⇒ Object

Invoke the set method on the plot using the name of the invoked method as the set variable and any arguments that have been passed as the value. See the set method for more details.



114
115
116
 
# File 'lib/gnuplot.rb', line 114

def method_missing( methId, *args )
  set methId.id2name, *args
end

Instance Attribute Details

#arbitrary_lines ⇒ Object

Returns the value of attribute arbitrary_lines.



108
109
110
 
# File 'lib/gnuplot.rb', line 108

def arbitrary_lines
  @arbitrary_lines
end

#cmd ⇒ Object

Returns the value of attribute cmd.



91
92
93
 
# File 'lib/gnuplot.rb', line 91

def cmd
  @cmd
end

#data ⇒ Object

Returns the value of attribute data.



91
92
93
 
# File 'lib/gnuplot.rb', line 91

def data
  @data
end

#sets ⇒ Object

Returns the value of attribute sets.



91
92
93
 
# File 'lib/gnuplot.rb', line 91

def sets
  @sets
end

Instance Method Details

#[](var) ⇒ Object

Return the current value of the variable. This will return the setting that is currently in the instance, not one that’s been given to a gnuplot process.



136
137
138
139
 
# File 'lib/gnuplot.rb', line 136

def [] ( var )
  v = @sets.assoc( var )
  v[1] || nil
end

#add_data(ds) ⇒ Object 



142
143
144
 
# File 'lib/gnuplot.rb', line 142

def add_data ( ds )
  @data << ds
end

#set(var, value = "") ⇒ Object

Set a variable to the given value. Var must be a gnuplot variable and value must be the value to set it to. Automatic quoting will be performed if the variable requires it.

This is overloaded by the method_missing method so see that for more readable code.



126
127
128
129
 
# File 'lib/gnuplot.rb', line 126

def set ( var, value = "" )
  value = "\"#{value}\"" if QUOTED.include? var unless value =~ /^'.*'$/
  @sets << [ var, value ]
end

#store_datasets(io = "") ⇒ Object 



154
155
156
157
158
159
160
161
162
163
164
 
# File 'lib/gnuplot.rb', line 154

def store_datasets (io = "")
  if @data.size > 0
    io << @cmd << " " << @data.collect { |e| e.plot_args }.join(", ")
    io << "\n"

    v = @data.collect { |ds| ds.to_gplot }
  	io << v.compact.join("e\n")
  end
  
  io
end

#to_gplot(io = "") ⇒ Object 



147
148
149
150
151
152
 
# File 'lib/gnuplot.rb', line 147

def to_gplot (io = "")
  @sets.each { |var, val| io << "set #{var} #{val}\n" }
  @arbitrary_lines.each{|line| io << line << "\n" }

  io
end