tioga 1.4

data/split/Tioga/lib/Arcs_and_Circles.rb

@@ -0,0 +1,64 @@
+#  Arcs_and_Circles.rb
+
+module Tioga
+
+# These are the methods for creating and using arcs and circles in PDF graphics.
+
+class Arcs_and_Circles < Doc < FigureMaker
+
+# Like adding lines from _start_ to _corner_ to _end_, but with the corner rounded
+# with a radius equal to the minimum of the actual output distances for _dx_ and _dy_.
+#
+# The illustration shows in dark blue the arc that is added for the control points given in red.
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/append_arc.jpg
+#
+   def append_arc_to_path(x_start, y_start, x_corner, y_corner, x_end, y_end, dx, dy)
+   end
+
+# Create a circle with center at (_x_, _y_) having radius _r_ (given in x units).
+   def append_circle_to_path(x, y, r)
+   end
+
+# Calls append_circle_to_path followed by #clip.
+   def clip_circle(x, y, r)
+   end
+   
+# Calls append_circle_to_path followed by #fill.
+   def fill_circle(x, y, r)
+   end
+
+# Calls append_circle_to_path followed by #stroke.
+   def stroke_circle(x, y, r)
+   end
+
+# Calls append_circle_to_path followed by fill_and_stroke.
+   def fill_and_stroke_circle(x, y, r)
+   end
+   
+# Equivalent to the following: create a unit circle with center at (_x_, _y_), scale it by _dx_ in the x direction,
+# scale it by _dy_ in the y direction, then rotate it counter-clockwise by _angle_ degrees.
+   def append_oval_to_path(x, y, dx, dy, angle)
+   end
+
+# Calls append_oval_to_path followed by #clip.
+   def clip_oval(x, y, dx, dy, angle)
+   end
+   
+# Calls append_oval_to_path followed by #fill.
+   def fill_oval(x, y, dx, dy, angle)
+   end
+   
+# Calls append_oval_to_path followed by #stroke.
+   def stroke_oval(x, y, dx, dy, angle)
+   end
+
+# Calls append_oval_to_path followed by fill_and_stroke.
+   def fill_and_stroke_oval(x, y, dx, dy, angle)
+   end
+
+
+
+
+end # class
+end # module Tioga

data/split/Tioga/lib/ColorConstants.rb

@@ -0,0 +1,274 @@
+module Tioga
+
+# = Color names
+#
+# The table at the end of this webpage has about 200 color names
+# and the corresponding red-green-blue triples of intensities.  These color names can be used wherever a color is called for in tioga.
+# To use the same colors in text, your TeX preamble should have the following:
+#        \include{color_names}
+# The file <tt>color_names.tex</tt> is included in the tioga download and defines the full set of
+# color names given below.  To set some text in color, simply use something like the following:
+#        \textcolor{Crimson}{This will appear in crimson.}
+#
+# By the way, if you want to use color_names.tex, but don't want copies of it scattered around, you can
+# put it in a directory that is on the LaTeX search path.  Check your system for details.  On Linux, I believe
+# you can "export" the path to TEXINPUTS.  On the Mac, you can try putting the file in ~/Library/texmf/tex/latex.
+# Then add the needed line to your TeX files by doing this in your initialize method for the plots:
+#       t.tex_preamble += "\n\\include{color_names}\n"
+#
+# In addition to the list of predefined color names, there is a table below giving a small sample of each color.
+#
+# ---
+#
+# = Concerning the use of colors in plots
+#
+# When you pick colors for your plots, keep in mind that color deficiency, commonly known as "color blindness",
+# is a common genetic trait.  People with color deficiency are not blind to colors, they simply don't distinguish
+# as many different colors as someone with normal color vision.  For example, reds and greens might be the same
+# ("reens" or "geds"?) and only brightness would show up as different.  But the reds/greens would still appear to be
+# different colors than the blues. 
+#
+# Two common forms of color deficiency are called "protanopia" and "deuteranopia".  Here's how they are
+# described on the website {What Is Colorblindness}[http://colorvisiontesting.com/color2.htm].
+#
+# - For the protanope, the brightness of red, orange, and yellow is much reduced compared to normal. This dimming can be so pronounced that reds may be confused with black or dark gray, and red traffic lights may appear to be extinguished. They may learn to distinguish reds from yellows and from greens primarily on the basis of their apparent brightness or lightness, not on any perceptible hue difference. Violet, lavender, and purple are indistinguishable from various shades of blue because their reddish components are so dimmed as to be invisible. E.g. Pink flowers, reflecting both red light and blue light, may appear just blue to the protanope.
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/normalcolor72gif.gif
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/protanope72gif.gif
+#
+# - The deuteranope suffers the same hue discrimination problems as the protanope, but without the abnormal dimming. The names red, orange, yellow, and green really mean very little to him aside from being different names that every one else around him seems to be able to agree on. Similarly, violet, lavender, purple, and blue, seem to be too many names to use logically for hues that all look alike to him.
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/normalcolor72gif.gif
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/deuteranope72gif.gif
+#
+# ---
+#
+# To be considerate of your color deficient friends, pick color sets that are distinguishable for them too.
+# Here's an example of a plot using six colors.
+# In the first version on the left, the colors of the lines are BrightBlue, Goldenrod, Coral, Lilac, FireBrick, and RoyalPurple.
+# The lower left version uses the often seen combination of red, green, blue, cyan, magenta, and yellow.
+#
+# On the right are the same plots as they might appear to someone with protanopia
+# (made using VischeckURL[http://www.vischeck.com/vischeck/vischeckURL.php] -- a very useful site).
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/color_choices.jpg
+#
+# By using the first set of colors rather than the second, you get a plot that looks good for
+# those in your audience with normal color vision and is much easier on those with a color deficiency.
+# Why not do it?
+#
+# ---
+#
+# ---
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/colors1.jpg
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/colors2.jpg
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/colors3.jpg
+#
+# http://theory.kitp.ucsb.edu/~paxton/tioga_jpegs/colors4.jpg
+#
+
+module ColorConstants
+    AliceBlue = [ 0.94, 0.972, 1 ]
+    AntiqueWhite = [ 0.98, 0.92, 0.844 ]
+    Aqua = [ 0, 1, 1 ]
+    Aquamarine = [ 0.498, 1, 0.83 ]
+    Avocado = [ 0.6, 0.6, 0 ]
+    Azure = [ 0.94, 1, 1 ]
+    Beige = [ 0.96, 0.96, 0.864 ]
+    Bisque = [ 1, 0.894, 0.77 ]
+    Black = [ 0, 0, 0 ]
+    BlanchedAlmond = [ 1, 0.92, 0.804 ]
+    Blue = [ 0, 0, 1 ]
+    BlueGreen = [ 0, 0.6, 0.4 ]
+    BlueViolet = [ 0.54, 0.17, 0.888 ]
+    BrickRed = [ 0.645, 0, 0.129 ]
+    BrightBlue = [ 0, 0.4, 1.0 ]
+    BrightPink = [ 1.0, 0.4, 0.8 ]
+    Brown = [ 0.648, 0.165, 0.165 ]
+    Burgundy = [ 0.6, 0, 0.2 ]
+    BurlyWood = [ 0.87, 0.72, 0.53 ]
+    CadetBlue = [ 0.372, 0.62, 0.628 ]
+    Cement = [ 0.8, 0.8, 0.6 ]
+    Chartreuse = [ 0.498, 1, 0 ]
+    Chiffon = [ 0.98, 0.98, 0.824 ]
+    Chocolate = [ 0.824, 0.41, 0.116 ]
+    Coral = [ 1, 0.498, 0.312 ]
+    CornflowerBlue = [ 0.392, 0.585, 0.93 ]
+    Cornsilk = [ 1, 0.972, 0.864 ]
+    Crimson = [ 0.8, 0, 0.2 ]
+    Cyan = [ 0, 1, 1 ]
+    DarkBlue = [ 0, 0, 0.545 ]
+    DarkChocolate = [ 0.4, 0.2, 0 ]
+    DarkCyan = [ 0, 0.545, 0.545 ]
+    DarkGoldenrod = [ 0.72, 0.525, 0.044 ]
+    DarkGray = [ 0.664, 0.664, 0.664 ]
+    DarkGreen = [ 0, 0.392, 0 ]
+    DarkGrey = [ 0.664, 0.664, 0.664 ]
+    DarkKhaki = [ 0.74, 0.716, 0.42 ]
+    DarkLavender = [ 0.4, 0.2, 0.6 ]
+    DarkMagenta = [ 0.545, 0, 0.545 ]
+    DarkOliveGreen = [ 0.332, 0.42, 0.185 ]
+    DarkOrange = [ 1, 0.55, 0 ]
+    DarkOrchid = [ 0.6, 0.196, 0.8 ]
+    DarkPeriwinkle = [ 0.4, 0.4, 1.0 ]
+    DarkPurpleBlue = [ 0.4, 0, 0.8 ]
+    DarkRed = [ 0.545, 0, 0 ]
+    DarkRoyalBlue = [ 0, 0.2, 0.8 ]
+    DarkSalmon = [ 0.912, 0.59, 0.48 ]
+    DarkSeaGreen = [ 0.56, 0.736, 0.56 ]
+    DarkSlateBlue = [ 0.284, 0.24, 0.545 ]
+    DarkSlateGray = [ 0.185, 0.31, 0.31 ]
+    DarkSlateGrey = [ 0.185, 0.31, 0.31 ]
+    DarkSmoke = [ 0.92, 0.92, 0.92 ]
+    DarkTurquoise = [ 0, 0.808, 0.82 ]
+    DarkViolet = [ 0.58, 0, 0.828 ]
+    DeepPink = [ 1, 0.08, 0.576 ]
+    DeepSkyBlue = [ 0, 0.75, 1 ]
+    DimGray = [ 0.41, 0.41, 0.41 ]
+    DimGrey = [ 0.41, 0.41, 0.41 ]
+    DodgerBlue = [ 0.116, 0.565, 1 ]
+    FireBrick = [ 0.698, 0.132, 0.132 ]
+    FloralWhite = [ 1, 0.98, 0.94 ]
+    ForestGreen = [ 0.132, 0.545, 0.132 ]
+    Fuchsia = [ 1, 0, 1 ]
+    Gainsboro = [ 0.864, 0.864, 0.864 ]
+    GhostWhite = [ 0.972, 0.972, 1 ]
+    Gold = [ 1, 0.844, 0 ]
+    GoldenBrown = [ 0.6, 0.4, 0 ]
+    Goldenrod = [ 0.855, 0.648, 0.125 ]
+    GrassGreen = [ 0.2, 0.6, 0 ]
+    Gray = [ 0.5, 0.5, 0.5 ]
+    GrayBlue = [ 0, 0.4, 0.6 ]
+    Green = [ 0, 0.5, 0 ]
+    GreenYellow = [ 0.68, 1, 0.185 ]
+    Grey = [ 0.5, 0.5, 0.5 ]
+    Honeydew = [ 0.94, 1, 0.94 ]
+    HotPink = [ 1, 0.41, 0.705 ]
+    IndianRed = [ 0.804, 0.36, 0.36 ]
+    Indigo = [ 0.294, 0, 0.51 ]
+    Ivory = [ 1, 1, 0.94 ]
+    Khaki = [ 0.94, 0.9, 0.55 ]
+    Lavender = [ 0.9, 0.9, 0.98 ]
+    LavenderBlue = [ 0.4, 0.2, 1.0 ]
+    LavenderBlush = [ 1, 0.94, 0.96 ]
+    LawnGreen = [ 0.488, 0.99, 0 ]
+    LemonChiffon = [ 1, 0.98, 0.804 ]
+    LightBlue = [ 0.68, 0.848, 0.9 ]
+    LightBrightGreen = [ 0, 0.8, 0.2 ]
+    LightCoral = [ 0.94, 0.5, 0.5 ]
+    LightCrimson = [ 0.864, 0.08, 0.235 ]
+    LightCyan = [ 0.88, 1, 1 ]
+    LightDullGreen = [ 0.4, 1.0, 0.6 ]
+    LightGold = [ 0.8, 0.8, 0.4 ]
+    LightGrassGreen = [ 0.4, 1.0, 0.4 ]
+    LightGray = [ 0.828, 0.828, 0.828 ]
+    LightGreen = [ 0.565, 0.932, 0.565 ]
+    LightGrey = [ 0.828, 0.828, 0.828 ]
+    LightMustard = [ 1.0, 0.8, 0.4 ]
+    LightOliveGreen = [ 0.6, 0.8, 0.6 ]
+    LightOrchid = [ 0.6, 0.4, 0.8 ]
+    LightPlum = [ 0.8, 0.6, 0.8 ]
+    LightRose = [ 1.0, 0.6, 0.8 ]
+    LightSalmon = [ 1, 0.628, 0.48 ]
+    LightSandyBrown = [ 1.0, 0.8, 0.6 ]
+    LightSeaGreen = [ 0.125, 0.698, 0.668 ]
+    LightSienna = [ 0.8, 0.4, 0 ]
+    LightSkyBlue = [ 0.53, 0.808, 0.98 ]
+    LightSlateGray = [ 0.468, 0.532, 0.6 ]
+    LightSlateGrey = [ 0.468, 0.532, 0.6 ]
+    LightSteelBlue = [ 0.69, 0.77, 0.87 ]
+    LightTurquoise = [ 0.2, 1.0, 0.8 ]
+    LightYellow = [ 1, 1, 0.88 ]
+    LightYellowGreen = [ 0.8, 0.8, 0.2 ]
+    Lilac = [ 0.8, 0.6, 1.0 ]
+    Lime = [ 0, 1, 0 ]
+    LimeGreen = [ 0.196, 0.804, 0.196 ]
+    Linen = [ 0.98, 0.94, 0.9 ]
+    Magenta = [ 1, 0, 1 ]
+    Maroon = [ 0.5, 0, 0 ]
+    Mauve = [ 0.8, 0.2, 0.4 ]
+    MediumAquamarine = [ 0.4, 0.804, 0.668 ]
+    MediumBlue = [ 0, 0, 0.804 ]
+    MediumGreen = [ 0, 0.6, 0 ]
+    MediumOrange = [ 1.0, 0.4, 0 ]
+    MediumOrchid = [ 0.73, 0.332, 0.828 ]
+    MediumPurple = [ 0.576, 0.44, 0.86 ]
+    MediumSeaGreen = [ 0.235, 0.7, 0.444 ]
+    MediumSlateBlue = [ 0.484, 0.408, 0.932 ]
+    MediumSpringGreen = [ 0, 0.98, 0.604 ]
+    MediumTurquoise = [ 0.284, 0.82, 0.8 ]
+    MediumVioletRed = [ 0.78, 0.084, 0.52 ]
+    YellowGreen = [ 0.8, 0.8, 0 ]
+    MidnightBlue = [ 0.098, 0.098, 0.44 ]
+    MintCream = [ 0.96, 1, 0.98 ]
+    MistyRose = [ 1, 0.894, 0.884 ]
+    Moccasin = [ 1, 0.894, 0.71 ]
+    MustardSeed = [ 0.8, 0.6, 0 ]
+    NavajoWhite = [ 1, 0.87, 0.68 ]
+    Navy = [ 0, 0, 0.5 ]
+    OldLace = [ 0.992, 0.96, 0.9 ]
+    Olive = [ 0.5, 0.5, 0 ]
+    OliveDrab = [ 0.42, 0.556, 0.136 ]
+    Orange = [ 1, 0.648, 0 ]
+    OrangeRed = [ 1, 0.27, 0 ]
+    Orchid = [ 0.855, 0.44, 0.84 ]
+    PaleGoldenrod = [ 0.932, 0.91, 0.668 ]
+    PaleGreen = [ 0.596, 0.985, 0.596 ]
+    PaleTurquoise = [ 0.688, 0.932, 0.932 ]
+    PaleVioletRed = [ 0.86, 0.44, 0.576 ]
+    PapayaWhip = [ 1, 0.936, 0.835 ]
+    PeachPuff = [ 1, 0.855, 0.725 ]
+    Periwinkle = [ 0.6, 0, 1.0 ]
+    Peru = [ 0.804, 0.52, 0.248 ]
+    Pink = [ 1, 0.752, 0.796 ]
+    Plum = [ 0.868, 0.628, 0.868 ]
+    PowderBlue = [ 0.69, 0.88, 0.9 ]
+    Pumpkin = [ 1.0, 0.6, 0.2 ]
+    Purple = [ 0.5, 0, 0.5 ]
+    PurpleBlue = [ 0.4, 0.2, 0.8 ]
+    PurpleGray = [ 0.6, 0.6, 0.8 ]
+    Red = [ 1, 0, 0 ]
+    RedBrown = [ 0.8, 0.4, 0.2 ]
+    RedOrange = [ 0.8, 0.2, 0 ]
+    Rose = [ 1.0, 0.4, 0.6 ]
+    RosyBrown = [ 0.736, 0.56, 0.56 ]
+    RoyalBlue = [ 0.255, 0.41, 0.884 ]
+    RoyalPurple = [ 0.4, 0, 0.6 ]
+    SaddleBrown = [ 0.545, 0.27, 0.075 ]
+    LightChartreuse = [ 0.8, 1.0, 0.4 ]
+    Saffron = [ 1.0, 0.8, 0 ]
+    Salmon = [ 0.98, 0.5, 0.448 ]
+    SalmonRed = [ 1.0, 0.4, 0.4 ]
+    SandyBrown = [ 0.956, 0.644, 0.376 ]
+    SeaGreen = [ 0.18, 0.545, 0.34 ]
+    Seashell = [ 1, 0.96, 0.932 ]
+    Sienna = [ 0.628, 0.32, 0.176 ]
+    Silver = [ 0.752, 0.752, 0.752 ]
+    SkyBlue = [ 0.53, 0.808, 0.92 ]
+    SlateBlue = [ 0.415, 0.352, 0.804 ]
+    SlateGray = [ 0.44, 0.5, 0.565 ]
+    SlateGrey = [ 0.44, 0.5, 0.565 ]
+    Smoke = [ 0.95, 0.95, 0.95 ]
+    Snow = [ 1, 0.98, 0.98 ]
+    SoftYellow = [ 1.0, 1.0, 0.4 ]
+    SpringGreen = [ 0, 1, 0.498 ]
+    SteelBlue = [ 0.275, 0.51, 0.705 ]
+    Tan = [ 0.824, 0.705, 0.55 ]
+    Teal = [ 0, 0.5, 0.5 ]
+    Thistle = [ 0.848, 0.75, 0.848 ]
+    Tomato = [ 1, 0.39, 0.28 ]
+    Turquoise = [ 0.25, 0.88, 0.815 ]
+    Violet = [ 0.932, 0.51, 0.932 ]
+    WarmGray = [ 0.678, 0.66, 0.562 ]
+    Wheat = [ 0.96, 0.87, 0.7 ]
+    White = [ 1, 1, 1 ]
+    WhiteSmoke = [ 0.97, 0.97, 0.97 ]
+    Yellow = [ 1, 1, 0 ]
+
+end # module ColorConstants
+end # module Tioga
+
+

data/split/Tioga/lib/Colorbars.rb

@@ -0,0 +1,10 @@
+#  Colorbars.rb
+
+module Tioga
+
+# Color bars are done using subplots and axial_shading.  There is an example in the Tutorial::SampledData information.
+
+class Colorbars < Doc < FigureMaker
+
+end # class
+end # module Tioga

data/split/Tioga/lib/Colormaps.rb

@@ -0,0 +1,105 @@
+#  Colormaps.rb
+
+module Tioga
+
+# These are the methods for creating and using colormaps and color spaces in PDF graphics.
+
+class Colormaps < Doc < FigureMaker
+
+=begin rdoc
+Returns a color map as specified by the dictionary argument _dict_.  The 'length' parameter determines the
+number of entries in the map and must be an integer between 2 and 256.  The 'points' vector gives positions
+between 0.0 and 1.0 where the colors are explicitly specified for the map.  The first color map entry corresponds to
+position 0.0, the last map entry is for position 1.0, and intermediate map entries are spaced evenly in between.
+The color specifications are given either as RGB triples (in the vectors 'Rs', 'Gs', and 'Bs') or as
+HLS triples (in the vectors 'Hs', 'Ls', and 'Ss').  In either case, there must be the same number of triples as
+there are positions in the 'points' vector.  The color position points[i] is assigned the color from the
+corresponding Rs[i], Gs[i], and Bs[i] for the RGB case.  In the HLS case, the triple Hs[i], Ls[i], and Ss[i]
+is converted to a triple of RGB intensities, and that is assigned to the color position given by points[i].  Color map
+entries for other positions are determined by linear interpolation from the neighboring assigned colors.
+
+See also the prebuilt colormaps: intense_colormap, mellow_colormap, and rainbow_colormap.
+
+Dictionary Entries
+    'length'   => an_integer      # integer between 2 and 256.  default is 256.
+    'points'   => a_dvector       # increasing locations starting at 0.0 and ending at 1.0
+    'Rs'       => a_dvector       # red intensities (between 0.0 and 1.0)
+    'Gs'       => a_dvector       # green intensities (between 0.0 and 1.0)
+    'Bs'       => a_dvector       # blue intensities (between 0.0 and 1.0)
+    'Hs'       => a_dvector       # hue angles in degrees (between 0 and 360)
+    'Ls'       => a_dvector       # lightness (between 0.0 and 1.0)
+    'Ss'       => a_dvector       # saturation (between 0.0 and 1.0)
+
+=end
+    def create_colormap(dict)
+    end
+
+# :call-seq:
+#  intense_colormap
+#
+# Returns a colormap with fully saturated reds and blues.
+    def intense_colormap
+    end
+
+# :call-seq:
+#  mellow_colormap
+#
+# Returns a colormap with reds and blues in which the saturation drops for high and low color positions,
+    def mellow_colormap 
+    end
+
+# :call-seq:
+#  rainbow_colormap
+#
+# Returns a colormap covering the spectrum from red, orange, yellow, green, blue, indigo, to violet
+# (special thanks to Roy G. Biv for providing this).
+    def rainbow_colormap
+    end
+
+=begin rdoc
+Returns a color map for a gradient of HLS colors as specified by the dictionary argument _dict_.
+The hue is either fixed ('hue') or varies linearly (from 'starting_H' to 'ending_H').
+The lightness is either fixed ('lightness') or varies linearly (from 'starting_L' to 'ending_L').
+The saturation is either fixed ('saturation') or varies linearly (from 'starting_S' to 'ending_S').
+
+Dictionary Entries
+    'hue'             => a_float   # hue angle in degrees (default 0)
+    'starting_H'      => a_float   # the starting hue angle
+    'ending_H'        => a_float   # the ending hue angle
+    'lightness'       => a_float   # lightness (default 0.5)
+    'starting_L'      => a_float   # the starting lightness
+    'ending_L'        => a_float   # the ending lightness
+    'saturation'      => a_float   # saturation (default 0.5)
+    'starting_S'      => a_float   # the starting saturation
+    'ending_S'        => a_float   # the ending saturation
+
+=end
+    def create_gradient_colormap(dict)
+    end
+
+# Returns a colormap corresponding to the given vectors of intensities.
+# The intensities must be numbers between 0 and 1, and the vectors must
+# be of equal lengths.
+   def convert_to_colormap(reds, greens, blues)
+   end
+
+# Returns the triple [ red, green, blue ] for the intensities of the color
+# at the given <i>color_position</i> in _colormap_.  Recall that a color position
+# is a number between 0 and 1.  See create_colormap.
+   def get_color_from_colormap(colormap, color_position)
+   end
+
+# Returns a vector of [ red, green, blue ] intensities corresponding to the
+# <i>hls_vec</i> color given as [ hue, lightness, saturation].  See also rgb_to_hls.
+    def hls_to_rgb(hls_vec)
+    end
+    
+# Returns a vector of [ hue, lightness, saturation ] corresponding to the
+# <i>rgb_vec</i> color given as [ red, green, blue] intensities.  See also hls_to_rgb.
+    def rgb_to_hls(rgb_vec)
+    end
+
+
+
+end # class
+end # module Tioga