tioga 1.4

data/split/Tioga/lib/Coordinate_Conversions.rb

@@ -0,0 +1,194 @@
+#  Coordinate_Conversions.rb
+
+module Tioga
+
+=begin rdoc
+
+There are four different coordinate systems used in Tioga.  The contents of the figure or plot
+are positioned using "figure" coordinates which correspond to the values along the x and y axes
+as determined by the boundary attributes.  Things like the title and axis labels are positioned using
+"frame" coordinates that run from (0, 0) at the lower left corner of the frame to (1, 1) at the upper right
+corner.  The frame is positioned on the page using "page" coordinates that run from (0, 0)
+at the lower left of the page to (1, 1) at the upper right.  The actual numbers used in PDF and TeX files
+are given in "output" coordinates which are a tenth of a point (i.e., 720 in output coords equals 1 inch).
+
+The coordinate systems are naturally related in the following manner:
+
+    figure <-> frame <-> page <-> output
+    
+There are conversion routines between each adjacent pair in this chain.  There are separate
+routines for locations (x and y) and for distances (dx and dy).  And finally, the chain is closed
+by conversion routines between figure and output coordinates.
+
+=end
+
+module Coordinate_Conversions
+# Convert the position _x_ measured in page x coordinates to the 
+# position in output x coordinates.
+    def convert_page_to_output_x(x)
+    end
+    
+# Convert the position _y_ measured in page y coordinates to the 
+# position in output y coordinates.
+    def convert_page_to_output_y(y)
+    end
+
+# Convert the distance _dx_ measured in page x coordinates to the 
+# distance in output x coordinates.
+    def convert_page_to_output_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in page y coordinates to the 
+# distance in output y coordinates.
+    def convert_page_to_output_dy(dy)
+    end
+
+# Convert the position _x_ measured in output x coordinates to the 
+# position in page x coordinates.
+    def convert_output_to_page_x(x)
+    end
+
+# Convert the position _y_ measured in output y coordinates to the 
+# position in page y coordinates.
+    def convert_output_to_page_y(y)
+    end
+
+# Convert the distance _dx_ measured in output x coordinates to the 
+# distance in page x coordinates.
+    def convert_output_to_page_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in output y coordinates to the same
+# distance in page y coordinates.
+    def convert_output_to_page_dy(dy)
+    end
+
+# Convert the position _x_ measured in page x coordinates to the 
+# position in frame x coordinates.
+    def convert_page_to_frame_x(x)
+    end
+
+# Convert the position _y_ measured in page y coordinates to the 
+# position in frame y coordinates.
+    def convert_page_to_frame_y(y)
+    end
+
+# Convert the distance _dx_ measured in page x coordinates to the 
+# distance in frame x coordinates.
+    def convert_page_to_frame_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in page y coordinates to the 
+# distance in frame y coordinates.
+    def convert_page_to_frame_dy(dy)
+    end
+
+# Convert the position _x_ measured in frame x coordinates to the 
+# position in page x coordinates.
+    def convert_frame_to_page_x(x)
+    end
+
+# Convert the position _y_ measured in frame y coordinates to the 
+# position in page y coordinates.
+    def convert_frame_to_page_y(y)
+    end
+
+# Convert the distance _dx_ measured in frame x coordinates to the 
+# distance in page x coordinates.
+    def convert_frame_to_page_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in frame y coordinates to the 
+# distance in page y coordinates.
+    def convert_frame_to_page_dy(dy)
+    end
+
+# Convert the position _x_ measured in figure x coordinates to the 
+# position in frame x coordinates.
+    def convert_figure_to_frame_x(x)
+    end
+
+# Convert the position _y_ measured in figure y coordinates to the 
+# position in frame y coordinates.
+    def convert_figure_to_frame_y(y)
+    end
+
+# Convert the distance _dx_ measured in figure x coordinates to the 
+# distance in frame x coordinates.
+    def convert_figure_to_frame_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in figure y coordinates to the 
+# distance in frame y coordinates.
+    def convert_figure_to_frame_dy(dy)
+    end
+
+# Convert the position _x_ measured in frame x coordinates to the 
+# position in figure x coordinates.
+    def convert_frame_to_figure_x(x)
+    end
+
+# Convert the position _y_ measured in frame y coordinates to the 
+# position in figure y coordinates.
+    def convert_frame_to_figure_y(y)
+    end
+
+# Convert the distance _dx_ measured in frame x coordinates to the 
+# distance in figure x coordinates.
+    def convert_frame_to_figure_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in frame y coordinates to the 
+# distance in figure y coordinates.
+    def convert_frame_to_figure_dy(dy)
+    end
+
+# Convert the position _x_ measured in figure x coordinates to the 
+# position in output x coordinates.
+    def convert_figure_to_output_x(x)
+    end
+
+# Convert the position _y_ measured in figure y coordinates to the 
+# position in output y coordinates.
+    def convert_figure_to_output_y(y) 
+    end
+
+# Convert the distance _dx_ measured in figure x coordinates to the 
+# distance in output x coordinates.
+    def convert_figure_to_output_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in figure y coordinates to the 
+# distance in output y coordinates.
+    def convert_figure_to_output_dy(dy)
+    end
+
+# Convert the position _x_ measured in output x coordinates to the 
+# position in figure x coordinates.
+    def convert_output_to_figure_x(x)
+    end
+
+# Convert the position _y_ measured in output y coordinates to the 
+# position in figure y coordinates.
+    def convert_output_to_figure_y(y)
+    end
+
+# Convert the distance _dx_ measured in output x coordinates to the 
+# distance in figure x coordinates.
+    def convert_output_to_figure_dx(dx)
+    end
+
+# Convert the distance _dy_ measured in output y coordinates to the 
+# distance in figure y coordinates.
+    def convert_output_to_figure_dy(dy)
+    end
+
+# Returns the angle measured in degrees clockwise from the horizontal for the
+# slope specified by _dx_ and _dy_ given in figure coordinates.
+    def convert_to_degrees(dx, dy)
+    end
+
+
+end # module CoordinateConversions
+
+end # module Tioga

data/split/Tioga/lib/Creating_Paths.rb

@@ -0,0 +1,94 @@
+#  Creating_Paths.rb
+
+module Tioga
+
+# These are the general methods for creating paths for later use in PDF graphics operations.  See also Tutorial::SimpleFigure.
+
+class Creating_Paths < Doc < FigureMaker
+
+# Begin a new subpath by moving to the point given by the figure coordinates (x, y),
+# omitting any connecting line segment. If the previous path construction
+# operator in the current path was also move_to_point, the new move_to_point
+# overrides it; no vestige of the previous move_to_point operation remains in the path.
+#
+# Note that once you start a path, you must finish with it before going on to anything else.
+# So you need to do a sequence of path producer operations followed by a single path consumer operation.
+# After the path consumer operation finishes, the current path is reset to empty and you can
+# then safely do other operations such as change the line width or the line type.
+   def move_to_point(x, y)
+   end
+   
+# Append a straight line segment from the current path end to the point given by
+# the figure coordinates (_x_, _y_).  The new path end point is (_x_, _y_).
+   def append_point_to_path(x, y)
+   end
+   
+# Append a cubic Bezier curve to the current path. The curve extends from the current
+# path end to the point given by the figure coordinates (x3, y3), using (x1, y1) and
+# (x2, y2) as the Bezier control points (also in figure coordinates).  The new path
+# end is (x3, y3).
+#
+# The illustration shows in dark blue the curve that is added for the control points given in red.
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/append_curve.jpg
+#
+   def append_curve_to_path(x1, y1, x2, y2, x3, y3)
+   end
+
+# :call-seq:
+#               close_path      
+#                   
+# Closing a path has the effect of adding a line from the end of the current subpath
+# to the start of that subpath as determined by the previous move_to_point.
+# Typically, the last action for a closed path should be a call to close_path so that
+# the line join will be done properly at the junction point; see #stroke for details. 
+   def close_path
+   end
+
+# The arguments <i>x_vec</i> and <i>y_vec</i> should be Dvectors of equal lengths holding
+# figure coordinates for points.  If there is an open subpath already under
+# construction, the first point is added with append_point_to_path, but if the
+# path is empty or has just been closed, then the first point is passed to move_to_point
+# instead.  All subsequent points are used for calls to append_point_to_path.
+   def append_points_to_path(x_vec, y_vec)
+   end
+
+# Like append_points_to_path, but where there is a gap, it does move_to_point
+# instead of append_point_to_path.  If the flag <i>close_subpaths</i> is +true+, then does
+# close_path before doing the move_to_point for each gap. The array _gaps_ holds
+# integer indices in <i>x_vec</i> and <i>y_vec</i> for locations that should be moved to.
+# This routine is useful with sources that provide paths that may consist of many subpaths
+# (such as make_contour).
+   def append_points_with_gaps_to_path(x_vec, y_vec, gaps, close_subpaths)
+   end
+
+# :call-seq:
+#               discard_path                         
+#                   
+# Reset the path to empty.  This is done automatically after each #stroke, #fill, or #clip.
+   def discard_path
+   end
+
+
+# Adds the figure coordinates point (_x_, _y_) to the bounding box.  Not usually needed, but
+# can be helpful with text that is outside the box determined by the graphics since the
+# tioga kernel does not have exact information about how large the text bbox will be once
+# TeX has done the typesetting.
+   def update_bbox(x, y)
+   end
+
+
+   # If #croak_on_nonok_numbers is set, the kernel will emit a warning when
+   # it encounters a weird point (such as with infinite or NaN coordinates)
+   # in a primitive path operation. In any case, the faulty element in the
+   # path will be discarded.
+   def croak_on_nonok_numbers
+   end
+
+   # Sets the #croak_on_nonok_numbers warning. On by default.
+   def croak_on_nonok_numbers=(bool)
+   end
+
+
+end # class
+end # module Tioga

data/split/Tioga/lib/Doc.rb

@@ -0,0 +1,91 @@
+#  Doc.rb
+
+
+=begin rdoc
+
+:main: Tioga
+
+===The tioga kernel
+
+This is the reference document for using of the tioga kernel to create figures and plots using Ruby, PDF, and TeX.
+Please understand that this is more like a dictionary than a textbook.  
+It is written assuming that you've already familiarized yourself with how things work to the level covered in the Tutorial.  
+Without that background, much of the following may be incomprehensible.
+
+
+
+Page Layout and System Control
+
+- Page_Frame_Bounds
+- Figures_and_Plots
+- Executive
+
+Graphics
+
+- ColorConstants
+- Creating_Paths
+- Using_Paths
+- Strokes (Lines and Curves)
+- Rectangles
+- Arcs_and_Circles
+- Special_Paths (Contours, Splines, Steps, Arrows, Error Bars)
+- Colormaps
+- Images (JPEGs and Sampled Data)
+- Shading (Radial and Axial Blends)
+- Transparency
+- FigureConstants
+
+Text
+
+- MarkerConstants
+- Markers
+- TeX_Text
+
+Extras for Plots
+
+- Titles_and_Labels
+- X_and_Y_Axes
+- Legends
+- Colorbars
+
+Facilities for Storing Numeric Data
+
+- Dobjects::Dvector
+- Dobjects::Dtable
+
+For more information on PDF, consult the Adode PDF Reference document.  
+It's a huge collection of details (over 1000 pages at last count), and I've borrowed 
+extensively from it in some of the following descriptions of methods that map directly to PDF operations.
+
+
+=end
+
+
+module Tioga
+    
+class FigureMaker
+
+# :call-seq:
+#               FigureMaker.default                         
+#               FigureMaker.default = a_FigureMaker
+#
+# The default FigureMaker is typically the one to use.  Most tioga figure class definitions begin their
+# initialization by storing this in an instance variable for easy access in the figure methods.
+    def FigureMaker.default
+    end
+
+    def FigureMaker.default=(fm)
+    end
+    
+# :call-seq:
+#               FigureMaker.version
+#
+# Returns a string defining the current tioga version.
+    def FigureMaker.version
+    end
+
+    
+end # class FigureMaker
+
+end # module Tioga
+

data/split/Tioga/lib/Executive.rb

@@ -0,0 +1,515 @@
+#  Executive.rb
+
+module Tioga
+
+# These are the methods and attributes for controlling the FigureMaker executive routines.
+
+class Executive < Doc < FigureMaker
+
+# :call-seq:
+#   def_figure(name) do ... end
+#
+# The block of code is saved to be executed later when the _name_ string is given to make_figure.
+# The name is entered in the table of figure_names.  If the name was already listed, then the new code
+# replaces the previous definition.
+#
+    def def_figure(name, &cmd)
+    end
+
+# :call-seq:
+#   require_pdf(name)
+#   require_pdf(number)
+#
+# Calls make_pdf if the pdf for the figure has not yet been created.
+# Returns the full file name of the pdf.
+#
+    def require_pdf(name)
+    end
+
+# :call-seq:
+#   require_all(fignums=nil,report=false)
+#
+# Calls require_pdf for each of the figures listed in _fignums_.  
+# Does all the defined figures if _fignums_ is +nil+.
+# Writes pdf information to terminal as it goes if _report_ is true.
+#
+    def require_all(fignums=nil,report=false)
+    end
+
+# :call-seq:
+#   make_all(fignums=nil,report=false)
+#
+# Calls make_pdf for each of the figures listed in _fignums_.  
+# Does all the defined figures if _fignums_ is +nil+. See also require_all.
+# Writes pdf information to terminal as it goes if _report_ is true.
+#
+    def make_all(fignums=nil,report=false)
+    end
+
+# :call-seq:
+#   make_figure(name)
+#   make_figure(number)
+#
+# Executes the corresponding code that was previously saved by def_figure.
+# Output is written to the currently specified save_dir directory. 
+# Alias for make_pdf.
+#
+    def make_figure(name)
+    end
+
+# :call-seq:
+#   make_pdf(name)
+#   make_pdf(number)
+#
+# Executes the corresponding code that was previously saved by def_figure.
+# Output is written to the currently specified save_dir directory.
+# See also require_pdf.
+#
+    def make_pdf(n)
+    end
+
+# :call-seq:
+#   make_portfolio(name,fignums=nil,report=false)
+#
+# Creates a multipage pdf file containing the figures listed in _fignums_.  
+# Does all the defined figures if _fignums_ is +nil+. 
+# Writes pdf information to terminal as it goes if _report_ is true.
+#
+# First, make_portfolio calls require_all(fignums) so that all the pdfs will be available.  
+# The portfolio will
+# have the given _name_ with a ".pdf" extension and will be placed in the save_dir.
+#
+    def make_portfolio(name,fignums=nil,report=false)
+    end
+
+# :call-seq:
+#   make_portfolio_pdf(name,fignums=nil,report=false)
+#
+# Alias for make_portfolio.
+#
+    def make_portfolio_pdf(name,fignums=nil,report=false)
+    end
+
+
+# :call-seq:
+#   figure_index(name)
+#
+# Returns the index of the figure with the given name.
+
+
+    def figure_index(name)
+    end
+
+# :call-seq:
+#   reset_state
+#
+# Reinitializes the FigureMaker.  This is automatically called when you load or reload a tioga document file.
+    def reset_state
+    end
+   
+# :call-seq:
+#   reset_figures                                     
+#
+# Alias for reset_state.
+   def reset_figures
+   end
+
+
+
+# :call-seq:
+#   reset_eval_function
+#
+# Removes the current definition for the eval_function.  See also def_eval_function.
+#
+    def reset_eval_function
+    end
+
+# :call-seq:
+#   def_eval_function { |string| ... }
+#
+# The block of code is saved to be executed later when eval_function is called.  See also reset_eval_function.
+#
+    def def_eval_function(&cmd)
+    end
+
+# Calls the function block defined by a previous call to def_eval_function passing the string as argument.
+# If no function is currently defined, it calls Ruby's +eval+ with _string_.
+#
+    def eval_function(string)
+    end
+
+
+
+# :call-seq:
+#   def_enter_page_function { |string| ... }
+#
+# The block of code is saved to be executed later whenever make_pdf is called to create a page for a figure.  
+# See also reset_enter_page_function, default_enter_page_function.
+#
+    def def_enter_page_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_enter_page_function
+#
+# Removes the current definition for the enter_page_function.  See also def_enter_page_function, default_enter_page_function.
+#
+    def reset_enter_page_function
+    end
+
+# :call-seq:
+#   default_enter_page_function
+#
+# Calls page_setup with the current default_page_width and default_page_height.
+# Then calls set_frame_sides with default_frame_left, default_frame_right, default_frame_top, and default_frame_bottom.
+#
+    def default_enter_page_function
+    end
+
+# :call-seq:
+#   default_page_width
+#   default_page_width = a_float
+#
+# The page width for use by default_enter_page_function.
+#
+    def default_page_width
+    end
+
+# :call-seq:
+#   default_page_height
+#   default_page_height = a_float
+#
+# The page height for use by default_enter_page_function.
+#
+    def default_page_height
+    end
+
+# :call-seq:
+#   default_frame_left
+#   default_frame_left = a_float
+#
+# The frame left for use by default_enter_page_function.
+#
+    def default_frame_left
+    end
+
+# :call-seq:
+#   default_frame_right
+#   default_frame_right = a_float
+#
+# The frame right for use by default_enter_page_function.
+#
+    def default_frame_right
+    end
+
+# :call-seq:
+#   default_frame_top
+#   default_frame_top = a_float
+#
+# The frame top for use by default_enter_page_function.
+#
+    def default_frame_top
+    end
+
+# :call-seq:
+#   default_frame_bottom
+#   default_frame_bottom = a_float
+#
+# The frame bottom for use by default_enter_page_function.
+#
+    def default_frame_bottom
+    end
+
+
+
+# :call-seq:
+#   def_exit_page_function { |string| ... }
+#
+# The block of code is saved to be executed later after make_pdf has returned from creating a page for a figure.  
+# See also reset_exit_page_function.
+#
+    def def_exit_page_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_exit_page_function
+#
+# Removes the current definition for the exit_page_function.  See also def_exit_page_function.
+#
+    def reset_exit_page_function
+    end
+
+
+
+# :call-seq:
+#   def_enter_show_plot_function { |string| ... }
+#
+# The block of code is saved to be executed later whenever show_plot is called.  
+# See also reset_enter_show_plot_function.
+#
+    def def_enter_show_plot_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_enter_show_plot_function
+#
+# Removes the current definition for the enter_show_plot_function.  See also def_enter_show_plot_function.
+#
+    def reset_enter_show_plot_function
+    end
+
+
+
+# :call-seq:
+#   def_exit_show_plot_function { |string| ... }
+#
+# The block of code is saved to be executed whenever show_plot returns.  
+# See also reset_exit_show_plot_function.
+#
+    def def_exit_show_plot_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_exit_show_plot_function
+#
+# Removes the current definition for the exit_show_plot_function.  See also def_exit_show_plot_function.
+#
+    def reset_exit_show_plot_function
+    end
+
+
+
+
+
+
+# :call-seq:
+#   def_enter_subfigure_function { |string| ... }
+#
+# The block of code is saved to be executed later whenever subfigure is called.  
+# See also reset_enter_subfigure_function.
+#
+    def def_enter_subfigure_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_enter_subfigure_function
+#
+# Removes the current definition for the enter_subfigure_function.  See also def_enter_subfigure_function.
+#
+    def reset_enter_subfigure_function
+    end
+
+
+
+# :call-seq:
+#   def_exit_subfigure_function { |string| ... }
+#
+# The block of code is saved to be executed whenever subfigure returns.  
+# See also reset_exit_subfigure_function.
+#
+    def def_exit_subfigure_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_exit_subfigure_function
+#
+# Removes the current definition for the exit_subfigure_function.  See also def_exit_subfigure_function.
+#
+    def reset_exit_subfigure_function
+    end
+
+
+
+
+
+
+# :call-seq:
+#   def_enter_subplot_function { |string| ... }
+#
+# The block of code is saved to be executed later whenever subplot is called.  
+# See also reset_enter_subplot_function.
+#
+    def def_enter_subplot_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_enter_subplot_function
+#
+# Removes the current definition for the enter_subplot_function.  See also def_enter_subplot_function.
+#
+    def reset_enter_subplot_function
+    end
+
+
+
+# :call-seq:
+#   def_exit_subplot_function { |string| ... }
+#
+# The block of code is saved to be executed whenever subplot returns.  
+# See also reset_exit_subplot_function.
+#
+    def def_exit_subplot_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_exit_subplot_function
+#
+# Removes the current definition for the exit_subplot_function.  See also def_exit_subplot_function.
+#
+    def reset_exit_subplot_function
+    end
+
+
+
+
+
+
+
+
+
+
+# :call-seq:
+#   def_enter_context_function { |string| ... }
+#
+# The block of code is saved to be executed later whenever context is called.  
+# See also reset_enter_context_function.
+#
+    def def_enter_context_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_enter_context_function
+#
+# Removes the current definition for the enter_context_function.  See also def_enter_context_function.
+#
+    def reset_enter_context_function
+    end
+
+
+
+# :call-seq:
+#   def_exit_context_function { |string| ... }
+#
+# The block of code is saved to be executed whenever context returns.  
+# See also reset_exit_context_function.
+#
+    def def_exit_context_function(&cmd)
+    end
+
+# :call-seq:
+#   reset_exit_context_function
+#
+# Removes the current definition for the exit_context_function.  See also def_exit_context_function.
+#
+    def reset_exit_context_function
+    end
+
+
+# :call-seq:
+#               run_dir                                     
+#
+# The path name for the FigureMaker working directory.
+   def run_dir
+   end
+
+# :call-seq:
+#               save_dir                                     
+#               save_dir = a_string
+#
+# The path name for the directory where output files will be created.
+   def save_dir
+   end
+
+# :call-seq:
+#               create_save_dir                                     
+#               create_save_dir = a_boolean
+#
+# Whether or not to create +save_dir+ if it doesn't exist.
+   def create_save_dir
+   end
+
+# :call-seq:
+#               autocleanup                                     
+#               autocleanup = a_boolean
+#
+# Whether or not to do automatic cleanup of the temporary files when create a PDF for a figure (default is true).
+   def autocleanup
+   end
+
+# :call-seq:
+#               multithreads_okay_for_tioga                                     
+#               multithreads_okay_for_tioga = a_boolean
+#
+# Whether or not to use multithreading wherever possible (default is true).  Currently, this only is used when making
+# a batch of pdfs -- if multithreads_okay_for_tioga is true, then we launch all the pdflatex shells in parallel.
+   def multithreads_okay_for_tioga
+   end
+
+# :call-seq:
+#               pdflatex                                     
+#               pdflatex = a_string
+#
+# The name for the pdflatex to use.  Defaults to 'pdflatex'.
+   def pdflatex
+   end
+
+# :call-seq:
+#               quiet_mode                                     
+#               quiet_mode = true or false
+#
+# Defaults to +false+.
+# If +true+, turns off all but essential messages.
+   def quiet_mode
+   end
+
+# :call-seq:
+#               get_save_filename(name) -> a_string
+#
+# Returns a string with the filename that will be used for saving the figure with the given _name_.
+   def get_save_filename(name)
+   end
+
+# :call-seq:
+#               num_figures                                     
+#
+# The current number of defined figures for this FigureMaker.
+   def num_figures
+   end
+
+# :call-seq:
+#               figure_names                                     
+#
+# An array of names for the currently defined figures.
+   def figure_names
+   end
+
+# :call-seq:
+#               figure_name(num) -> a_string                                     
+#
+# Returns the name from the figure_names array.
+   def figure_name(num)
+   end
+
+# :call-seq:
+#               figure_pdfs                                     
+#
+# An array of full pdf filenames for the currently defined figures.
+# All entries in the array initialized to +nil+.  When a pdf is created
+# for a figure, the full filename for the pdf is placed in this array
+# in position corresponding to the figure's location in figure_names. 
+   def figure_pdfs
+   end
+
+# :call-seq:
+#               figure_pdf(num) -> a_string or nil                                 
+#               figure_pdf(name) -> a_string or nil                    
+#
+# Returns the corresponding entry from the figure_pdfs array.
+   def figure_pdf(num)
+   end
+   
+
+
+
+end # class
+end # module Tioga