Boost logo

Boost-Commit :

From: pbristow_at_[hidden]
Date: 2008-02-18 14:53:06


Author: pbristow
Date: 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
New Revision: 43307
URL: http://svn.boost.org/trac/boost/changeset/43307

Log:
Various updates, including removing the default tiel and axis labels (to avoid them prefixing provided title etc)
Removed:
   sandbox/SOC/2007/visualization/libs/svg_plot/example/math_special_functions.cpp
Text files modified:
   sandbox/SOC/2007/visualization/boost/svg_plot/detail/axis_plot_frame.hpp | 97 +-
   sandbox/SOC/2007/visualization/boost/svg_plot/detail/svg_tag.hpp | 132 ++-
   sandbox/SOC/2007/visualization/boost/svg_plot/show_2d_settings.hpp | 14
   sandbox/SOC/2007/visualization/boost/svg_plot/svg_1d_plot.hpp | 8
   sandbox/SOC/2007/visualization/boost/svg_plot/svg_2d_plot.hpp | 65 +
   sandbox/SOC/2007/visualization/boost/svg_plot/svg_style.hpp | 28
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/index.html | 2
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_1d_plot_interface.html | 286 +++++++-
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_2d_plot_interface.html | 1369 ++++++++++++++++++++++++++++++++-------
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_boxplot_interface.html | 130 +--
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_interface.html | 3
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/interface.qbk | 350 ++++++----
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/svg_interface.qbk | 20
   sandbox/SOC/2007/visualization/libs/svg_plot/example/demo_2d_simple.cpp | 8
   14 files changed, 1810 insertions(+), 702 deletions(-)

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/axis_plot_frame.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/axis_plot_frame.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/axis_plot_frame.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -1403,6 +1403,12 @@
           {
             return derived().x_ticks_.strip_e0s_;
           }
+
+ Derived& title(const std::string title)
+ { // Plot title.
+ derived().title_info_.text(title);
+ return derived();
+ }
 
           const std::string title()
           {
@@ -1843,14 +1849,7 @@
             return derived().x_label_info_.style().font_family();
           }
 
-
- Derived& title(const std::string title)
- { // Plot title.
- derived().title_info_.text(title);
- return derived();
- }
-
- Derived& x_axis_label_color(const svg_color& col)
+ Derived& x_axis_label_color(const svg_color& col)
           { // Set BOTH stroke and fill to the same color.
             derived().image.g(detail::PLOT_X_LABEL).style().fill_color(col);
             derived().image.g(detail::PLOT_X_LABEL).style().stroke_color(col);
@@ -1989,53 +1988,57 @@
           // colors .stroke_color, .stroke_width and font are set in the appropriate g_element.
 
           Derived& title_color(const svg_color& col)
- {
- derived().image.g(PLOT_TITLE).style().stroke_color(col);
+ { // Function title_color could set both fill (middle) and stroke (outside),
+ // but just setting fill if simplest,
+ // but does not allow separate inside & outside colors.
             derived().image.g(PLOT_TITLE).style().fill_color(col);
+ //derived().image.g(PLOT_TITLE).style().stroke_color(col);
             return derived();
           }
 
           svg_color title_color()
- { // Function title_color sets both fill and stroke,
- // but stroke (outside) is considered 'more important'.
- return derived().image.g(PLOT_TITLE).style().stroke_color();
+ { // Function title_color could get either fill and stroke,
+ // return derived().image.g(PLOT_TITLE).style().stroke_color();
+ return derived().image.g(PLOT_TITLE).style().fill_color();
           }
 
- Derived& title_font_width(double width)
- { // width of text is effectively the boldness.
- // Not useful with current browsers, setting this may cause lower quality graphic fonts
- // perhaps because the font is created using graphics rather than a built-in font.
- derived().image.g(PLOT_TITLE).style().stroke_width(width);
- return derived();
- }
+ //Derived& title_font_width(double width)
+ //{ // width of text is effectively the boldness.
+ // // Not useful with current browsers, setting this may cause lower quality graphic fonts
+ // // perhaps because the font is created using graphics rather than a built-in font.
+ // derived().image.g(PLOT_TITLE).style().stroke_width(width);
+ // return derived();
+ //}
 
- double title_font_width()
- {
- return derived().image.g(PLOT_TITLE).style().stroke_width();
- }
+ //double title_font_width()
+ //{
+ // return derived().image.g(PLOT_TITLE).style().stroke_width();
+ //}
 
           Derived& legend_color(const svg_color& col)
           {
- derived().image.g(PLOT_LEGEND_TEXT).style().stroke_color(col);
+ // derived().image.g(PLOT_LEGEND_TEXT).style().stroke_color(col);
+ derived().image.g(PLOT_LEGEND_TEXT).style().fill_color(col);
             return derived();
           }
 
           svg_color legend_color()
           { // Function legend_color sets only stroke, assuming that 'filled' text is not being used.
             // (It produces much lower quality fonts on some browsers).
- return derived().image.g(PLOT_LEGEND_TEXT).style().stroke_color();
+ return derived().image.g(PLOT_LEGEND_TEXT).style().fill_color();
+ // return derived().image.g(PLOT_LEGEND_TEXT).style().stroke_color();
           }
 
- Derived& legend_font_width(double width)
- { // width of text is effectively the boldness.
- derived().image.g(PLOT_LEGEND_TEXT).style().stroke_width(width);
- return derived();
- }
+ //Derived& legend_font_width(double width)
+ //{ // width of text is effectively the boldness.
+ // derived().image.g(PLOT_LEGEND_TEXT).style().stroke_width(width);
+ // return derived();
+ //}
 
- double legend_font_width()
- { // Probably not useful at present (se above).
- return derived().image.g(PLOT_LEGEND_TEXT).style().stroke_width();
- }
+ //double legend_font_width()
+ //{ // Probably not useful at present (se above).
+ // return derived().image.g(PLOT_LEGEND_TEXT).style().stroke_width();
+ //}
 
           Derived& background_color(const svg_color& col)
           { //
@@ -2065,7 +2068,8 @@
 
           svg_color legend_border_color()
           {
- return derived().image.g(PLOT_LEGEND_BACKGROUND).style().stroke_color();
+ return derived().legend_box_.stroke();
+ // return derived().image.g(PLOT_LEGEND_BACKGROUND).style().stroke_color();
           }
 
           Derived& plot_background_color(const svg_color& col)
@@ -2080,7 +2084,7 @@
           }
 
           const std::string x_axis_position()
- {
+ { // Return the position of the X-axis.
             switch(derived().x_axis_position_)
             {
             case top:
@@ -2123,16 +2127,17 @@
             return derived();
           }
 
- Derived& x_label_width(double width)
- { // width of text is effectively the boldness.
- derived().image.g(PLOT_X_LABEL).style().stroke_width(width);
- return derived();
- }
+ // Removed until browsers implement better.
+ //Derived& x_label_width(double width)
+ //{ // width of text is effectively the boldness.
+ // derived().image.g(PLOT_X_LABEL).style().stroke_width(width);
+ // return derived();
+ //}
 
- double x_label_width()
- {
- return derived().image.g(PLOT_X_LABEL).style().stroke_width();
- }
+ //double x_label_width()
+ //{
+ // return derived().image.g(PLOT_X_LABEL).style().stroke_width();
+ //}
 
           svg_color x_label_color()
           {

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/svg_tag.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/svg_tag.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/svg_tag.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -1,7 +1,7 @@
 // svg_tag.hpp
 
-// Copyright Jacob Voytko 2007
-// Copyright Paul A Bristow 2007
+// Copyright Jacob Voytko 2007, 2008
+// Copyright Paul A Bristow 2007, 2008
 
 // Use, modification and distribution are subject to the
 // Boost Software License, Version 1.0.
@@ -13,8 +13,7 @@
 #define BOOST_SVG_TAG_HPP
 
 // -----------------------------------------------------------------------------
-// This file svg_tag.hpp defines all classes that can occur in the
-// SVG parse tree.
+// File svg_tag.hpp defines all classes that can occur in the SVG parse tree.
 // -----------------------------------------------------------------------------
 
 #include <boost/ptr_container/ptr_container.hpp>
@@ -37,12 +36,15 @@
 namespace svg
 {
   // Forward declarations of classes defined in this module.
- // Copied to svg_fwd.hpp TODO delete?
+ // Also copied to svg_fwd.hpp.
 
   class svg_element; // svg_element is base class for:
   // g_element (group element)
   // rect_element, circle_element, line_element, text_element,
   // polyline_element, polygon_element, path_element, clip_path_element,
+ class text_parent; // Ancestor to both tspan and strings for the text_element class.
+ class text_element_text;
+ class tspan_element; // Within a text_element, adjust text and font properties.
   class text_element; // text with position, size, font, (& styles) & orientation.
   class rect_element; // clipping path restricts the region to which paint can be applied.
   class circle_element; // Represents a single circle.
@@ -418,67 +420,80 @@
   };
 
 class text_parent
-{ // An ancestor to both tspan and strings for the text_element
- // class. This allows an array of both to be stored in text_element.
+{ // An ancestor to both tspan and strings for the text_element class.
+ // This allows an array of both to be stored in text_element.
   protected:
     std::string text_;
 
   public:
- virtual void write(std::ostream& o_str) { }
+ virtual void write(std::ostream& /* o_str */)
+ {
+ }
 
- text_parent(const std::string& text): text_(text) { }
- text_parent(const text_parent& rhs): text_(rhs.text_) { }
-};
+ text_parent(const std::string& text): text_(text)
+ {
+ }
+ text_parent(const text_parent& rhs): text_(rhs.text_)
+ {
+ }
+}; // class text_parent
 
-class text_element_text: public text_parent
+class text_element_text : public text_parent
 {
 public:
- text_element_text(const std::string& text): text_parent(text) { }
- text_element_text(const text_element_text& rhs): text_parent(rhs){ }
+ text_element_text(const std::string& text): text_parent(text)
+ {
+ }
+ text_element_text(const text_element_text& rhs): text_parent(rhs)
+ {
+ }
   void write(std::ostream& o_str)
   {
- o_str<<text_;
+ o_str << text_;
   }
-};
+}; // class text_element_text
 
-class tspan_element: public text_parent, public svg_element
-{
+class tspan_element : public text_parent, public svg_element
+{ // See 10.5 tspan element http://www.w3.org/TR/SVG/text.html#TSpanElement
 private:
   
- // Absolute position
- double x_, y_;
-
- // Relative position
- double dx_, dy_;
-
- int rotate_;
+ double x_; // Absolute positions.
+ double y_;
+ double dx_; // Relative positions.
+ double dy_;
+ int rotate_; // of text.
+ // A list of shifts or rotations for several characters is not yet implemented.
   
- // Allows the author to provide exact alignment
- double text_length_;
+ double text_length_; // Allows the author to provide exact alignment.
 
- // dx_, dy_, and rotate_ can all be omitted if they have a certain value,
+ // dx_, dy_, and rotate_ can all be omitted, usually meaning no shift or rotation,
+ // but see http://www.w3.org/TR/SVG/text.html#TSpanElement for ancestor rules.
   // but x_, y_, and text_length need a flag.
- bool use_x_, use_y_, use_text_length_;
+ bool use_x_;
+ bool use_y_;
+ bool use_text_length_;
 
   text_style style_; // font variants.
 
 public:
- tspan_element(const std::string& text, const text_style& style = no_style):
+ tspan_element(const std::string& text, const text_style& style = no_style)
+ :
     x_(0), y_(0), dx_(0), dy_(0), rotate_(0), text_length_(0),
     use_x_(false), use_y_(false), use_text_length_(false),
     style_(style), text_parent(text)
   {
   }
 
- tspan_element(const tspan_element& rhs):
- x_(rhs.x_), y_(rhs.y_), dx_(rhs.dx_), dy_(rhs.dy_), rotate_(rhs.rotate_),
- text_length_(rhs.text_length_), use_x_(rhs.use_x_), use_y_(rhs.use_y_),
- use_text_length_(rhs.use_text_length_), style_(rhs.style_),
- text_parent(rhs)
+ tspan_element(const tspan_element& rhs)
+ :
+ x_(rhs.x_), y_(rhs.y_), dx_(rhs.dx_), dy_(rhs.dy_), rotate_(rhs.rotate_),
+ text_length_(rhs.text_length_), use_x_(rhs.use_x_), use_y_(rhs.use_y_),
+ use_text_length_(rhs.use_text_length_), style_(rhs.style_),
+ text_parent(rhs)
   {
   }
 
- // All of the setters.
+ // All setters (chainable).
   tspan_element& text(const std::string& text)
   {
     text_=text;
@@ -524,7 +539,7 @@
     return *this;
   }
 
- // All of the getters.
+ // All getters.
   std::string text(){ return text_; }
   double x() { return x_; }
   double y() { return y_; }
@@ -543,46 +558,45 @@
     return style_;
   }
 
-
   void write(std::ostream& os)
   {
- os<<"<tspan";
+ os << "<tspan";
 
     write_attributes(os); // id & clip_path
     style_info_.write(os); // fill, stroke, width...
 
     // All of the conditional writes within tspan_element.
     
- // First, all of the elements that can be tested based on their value.
+ // First, all elements that can be tested based on their value.
     if(rotate_ != 0)
     {
- os<<" rotate=\""<<rotate_<<"\"";
+ os << " rotate=\"" << rotate_ << "\"";
     }
 
     if(dx_!= 0)
     {
- os<<" dx=\""<<dx_<<"\"";
+ os << " dx=\"" << dx_ << "\"";
     }
 
     if(dy_!= 0)
     {
- os<<" dy=\""<<dy_<<"\"";
+ os << " dy=\"" << dy_ << "\"";
     }
 
- // Now, add all of the elements that can be tested with the flags.
- if(use_x_)
+ // Now, add all elements that can be tested with the flags.
+ if(use_x_ == true)
     {
- os<<"x=\""<<x_<<"\"";
+ os << "x=\"" << x_ << "\"";
     }
 
- if(use_y_)
+ if(use_y_ == true)
     {
- os<<"y=\""<<y_<<"\"";
+ os << "y=\"" << y_ << "\"";
     }
 
- if(use_text_length_)
+ if(use_text_length_ == true)
     {
- os<<"textLength=\""<<text_length_<<"\"";
+ os << "textLength=\"" << text_length_ << "\"";
     }
 
     if (style_.font_size() != 0)
@@ -609,12 +623,11 @@
     {
     os << " font-decoration=\"" << style_.font_decoration() << "\"";
     }
- os<<">"<<text_<<"</tspan>";
+ os << ">" << text_ << "</tspan>";
+ } // void write(std::ostream& os)
+}; // class tspan_element
 
- }
-};
-
-class text_element: public svg_element
+class text_element : public svg_element
 { // Holds text with position, size, font, (& styles) & orientation.
   // Not necessarily shown correctly by all browsers, alas.
  private: // Access only via member functions below.
@@ -736,8 +749,8 @@
     data_.push_back(new text_element_text(text));
   }
 
- text_element(const text_element& rhs):
- x_(rhs.x_), y_(rhs.y_), style_(rhs.style_),
+ text_element(const text_element& rhs) :
+ x_(rhs.x_), y_(rhs.y_), style_(rhs.style_),
     align_(rhs.align_), rotate_(rhs.rotate_)
   {
      data_ = (const_cast<text_element&>(rhs)).data_.release();
@@ -748,7 +761,7 @@
     x_ = rhs.x_;
     y_ = rhs.y_;
     data_.clear();
- data_.insert(data_.end(), rhs.data_.begin(), rhs.data_.end());
+ data_.insert(data_.end(), rhs.data_.begin(), rhs.data_.end());
     style_ = rhs.style_;
     align_ = rhs.align_;
     rotate_ = rhs.rotate_;
@@ -762,6 +775,7 @@
 
    return os.str();
   }
+
   void write(std::ostream& os)
   { // text_element, style & attributes to stream.
     // Changed to new convention on spaces:
@@ -1774,8 +1788,6 @@
     {
       children.clear();
     }
-
-
   }; // class g_element
 
 } // namespace svg

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/show_2d_settings.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/show_2d_settings.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/show_2d_settings.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -1,4 +1,4 @@
-// default_2d_plot.cpp
+// show_2d_settings.cpp
 
 // Copyright Jacob Voytko 2007
 // Copyright Paul A. Bristow 2007
@@ -23,6 +23,9 @@
 namespace svg
 {
 
+ // Declaration, defined below.
+ void show_plot_settings(svg_2d_plot& plot);
+
 const char* fmtFlagWords[16] =
 { // Descriptions of each bit.
         "skipws", "unitbuf", "uppercase","showbase","showpoint","showpos","left","right",
@@ -182,7 +185,8 @@
   cout << "legend_title " << plot.legend_title() << endl;
   cout << "legend_title_font_size " << plot.legend_title_font_size() << endl;
   cout << "legend_font_weight " << plot.legend_font_weight() << endl;
- cout << "legend_font_width " << plot.legend_font_width() << endl;
+ // Not useful at present, so not longer implemented.
+ // cout << "legend_font_width " << plot.legend_font_width() << endl;
   cout << "legend_width " << plot.legend_width() << endl;
   cout << "legend_lines " << plot.legend_lines() << endl;
   cout << "license_on " << plot.license_on() << endl;
@@ -211,7 +215,8 @@
   cout << "title_font_stretch " << plot.title_font_stretch() << endl;
   cout << "title_font_style " << plot.title_font_style() << endl;
   cout << "title_font_weight " << plot.title_font_weight() << endl;
- cout << "title_font_width " << plot.title_font_width() << endl;
+ //cout << "title_font_width " << plot.title_font_width() << endl;
+ // Not useful at present, so not longer implemented.
   cout << "x_value_precision " << plot.x_value_precision() << endl;
   cout << "x_value_ioflags " << hex << plot.x_value_ioflags() << dec << ' ';
   outFmtFlags(plot.x_value_ioflags(), cout, ".\n");
@@ -234,7 +239,8 @@
   cout << "x_label_font_size " << plot.x_label_font_size() << endl;
   cout << "x_label_units " << plot.x_label_units() << endl;
   cout << "x_label_units_on " << plot.x_label_units_on() << endl;
- cout << "x_label_width " << plot.x_label_width() << endl;
+ //cout << "x_label_width " << plot.x_label_width() << endl;
+ // Not useful at present, so not longer implemented.
   cout << "x_major_value_labels_side " << l_or_r(plot.x_major_value_labels_side()) << endl;
   cout << "x_major_label_rotation " << plot.x_major_label_rotation() << endl;
   cout << "x_major_grid_color " << plot.x_major_grid_color() << endl;

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/svg_1d_plot.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/svg_1d_plot.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/svg_1d_plot.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -76,7 +76,7 @@
 
   std::string title_; // title of data series (to show on legend).
   plot_point_style point_style_; // circle, square...
- plot_point_style limit_point_style_;
+ plot_point_style limit_point_style_; // Default is cone pointing down.
   plot_line_style line_style_; // No line style for 1-D, only for 2-D.
 
   // -------------------------------------------------------------
@@ -178,6 +178,8 @@
   std::vector<svg_1d_plot_series> series;
   // These are sorted into two vectors for normal and abnormal (max, inf and NaN).
 
+
+
   svg image; // Stored so as to avoid rewriting style information constantly.
 
   // Member data names conventionally end with _.
@@ -211,6 +213,7 @@
   // Border information for the plot window (not the full image size).
   box_style image_border_; // rectangular border of all image width, color...
   box_style plot_window_border_; // rectangular border of plot window width, color...
+ box_style legend_box_; // rectangular box of legend width, color...
 
   double plot_left_; // calculate_plot_window() sets these values.
   double plot_top_;
@@ -280,6 +283,7 @@
     x_ticks_(X),// so for defaults see ticks_labels_style.
     image_border_(yellow, white, 2, 10, true, true), // margin should be about axis label font size.
     plot_window_border_(yellow, svg_color(255, 255, 255), 2, 3, true, false),
+ legend_box_(yellow, azure, 1, 2, true, true),
     legend_header_(0, 0, "", legend_style_, center_align, horizontal),
     legend_width_(200), // width of legend box (pixels) // TODO isn't this calculated?
     legend_height_(0), // height of legend box (pixels)
@@ -565,7 +569,7 @@
   // document node, which calls all other nodes through the Visitor pattern.
   // ------------------------------------------------------------------------
 
- svg_1d_plot& write(std::string& file)
+ svg_1d_plot& write(const std::string& file)
   {
     std::string filename(file); // Copy to avoid problems with const if need to append.
     if (filename.find(".svg") == std::string::npos)

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/svg_2d_plot.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/svg_2d_plot.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/svg_2d_plot.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -69,10 +69,15 @@
         std::string title) // Title of data series.
         :
         title_(title),
+ // plot_point_style(const svg_color& fill = blank, const svg_color& stroke = black,
+ // int size = 10, point_shape shape = round, const std::string& symbols = "X")
         point_style_(black, blank, 10, round), // Default point style.
         limit_point_style_(grey, blank, 10, cone), // Default limit (inf or NaN) point style.
- // plot_line_style(const svg_color& col = black, const svg_color& acol = true, bool on = true, bool bezier_on = false)
+
+ // plot_line_style(const svg_color& col = black, const svg_color& acol = true, double width = 2, bool line_on = true, bool bezier_on = false)
         line_style_(black, true, 2, true, false) // Default line style, no fill.
+
+ // TODO doesn't pick up line width.
       { // Constructor.
         for(T i = begin; i != end; ++i)
         { // Sort into normal and limited series.
@@ -119,8 +124,8 @@
       }
 
       svg_2d_plot_series& line_width(double wid_)
- { // Doesn't have desired effect yet.
- line_style_.width_ = wid_;
+ {
+ line_style_.width_ = wid_; // Sets legend line width too.
         return *this;
       }
 
@@ -156,7 +161,8 @@
     private:
       // Member data names conventionally end with _,
       // for example: border_margin_
- // and set/get accessor functions border_margin() & border_margin(int).
+ // and set & get accessor functions are named without _ suffix:
+ // border_margin() & border_margin(int).
 
       friend class detail::axis_plot_frame<svg_2d_plot>;
       // axis_plot_frame.hpp contains functions common to 1 and 2-D.
@@ -251,7 +257,7 @@
       // TODO check that *all* options are initialized here.
       // See documentation for default settings rationale.
       // text_styles:
- title_style_(16, "Verdana", "", ""), // last "bold" ?
+ title_style_(18, "Verdana", "", ""), // last "bold" ?
         legend_style_(14, "Verdana", "", ""), // 2nd "italic"?
         x_axis_label_style_(14, "Verdana", "", ""),
         x_value_label_style_(12, "Verdana", "", ""),
@@ -259,9 +265,12 @@
         y_axis_label_style_(14, "Verdana", "", ""),
         y_value_label_style_(12, "Verdana", "", ""),
         point_symbols_style_(12, "Lucida Sans Unicode"), // Used for data point marking.
- title_info_(0, 0, "Plot of data", title_style_, center_align, horizontal),
- x_label_info_(0, 0, "X Axis", x_axis_label_style_, center_align, horizontal),
- x_units_info_(0, 0, " (units)", x_value_label_style_, center_align, horizontal),
+ title_info_(0, 0, "", title_style_, center_align, horizontal),
+ // title_info_(0, 0, "Plot of data", title_style_, center_align, horizontal),
+ x_label_info_(0, 0, "", x_axis_label_style_, center_align, horizontal),
+ x_units_info_(0, 0, "", x_value_label_style_, center_align, horizontal),
+ // x_label_info_(0, 0, "X Axis", x_axis_label_style_, center_align, horizontal),
+ // x_units_info_(0, 0, " (units)", x_value_label_style_, center_align, horizontal),
         x_label_value_(0, 0, "", x_value_label_style_, center_align, horizontal),
         x_axis_(X, -10., +10., black, 1, 0, true, false, true),
         y_axis_(Y, -10., +10., black, 1, 0, true, false, true),
@@ -269,17 +278,19 @@
         // And this would separate any changes in styles defaults from plot default. TODO?
         x_ticks_(X, x_value_label_style_),// so for other defaults see ticks_labels_style.
         y_ticks_(Y, y_value_label_style_),
- y_label_info_(0, 0, "Y Axis", y_axis_label_style_, center_align, upward),
- y_units_info_(0, 0, " (units)", y_axis_label_style_, center_align, upward),
+ y_label_info_(0, 0, "", y_axis_label_style_, center_align, upward),
+ y_units_info_(0, 0, "", y_axis_label_style_, center_align, upward),
+ // y_label_info_(0, 0, "Y Axis", y_axis_label_style_, center_align, upward),
+ // y_units_info_(0, 0, " (units)", y_axis_label_style_, center_align, upward),
         y_label_value_(0, 0, "", y_value_label_style_, center_align, upward),
         text_margin_(2.), // for axis label text, as a multiplier of the font size.
         image_border_(yellow, white, 2, 10, true, true), // margin should be about axis label font size.
- plot_window_border_(red, svg_color(255, 255, 255), 2, 3, true, false),
- legend_box_(yellow, azure, 1, 2, true, true),
+ plot_window_border_(lightslategray, svg_color(255, 255, 255), 2, 3, true, false),
+ legend_box_(yellow, white, 1, 2, true, true),
         legend_header_(0, 0, "", legend_style_, center_align, horizontal),
         legend_width_(200), // width of legend box (pixels) // TODO isn't this calculated?
         legend_height_(0), // height of legend box (pixels)
- legend_left_(-1), legend_right_(-1),legend_top_(-1),legend_bottom_(-1), // Default top left of plot window.
+ legend_left_(-1), legend_right_(-1), legend_top_(-1), legend_bottom_(-1), // Default top left of plot window.
         legend_place_(outside_right), // default but interacts with using plot_window.
         legend_on_(false),
         legend_longest_(0),
@@ -1075,6 +1086,7 @@
         g_ptr.clip_id(plot_window_clip_);
         g_ptr.style().stroke_color(series.line_style_.color_);
         g_ptr.style().fill_color(series.line_style_.area_fill_);
+ g_ptr.style().stroke_width(series.line_style_.width_);
         path_element& path = g_ptr.path();
         path.style().fill_color(series.line_style_.area_fill_);
 
@@ -1349,7 +1361,6 @@
       // These below only refer to 2D plot.
       // See axis_plot_label.hpp for all the many 1D functions X-Axis.
 
-
       axis_line_style& x_axis()
       {
         return x_axis_;
@@ -1371,7 +1382,7 @@
       }
 
       svg_2d_plot& y_label_on(bool cmd)
- { // Y axis name or label.
+ { // If Y axis name or label.
         y_axis_.label_on_ = cmd;
         return *this; // Make chainable.
       }
@@ -1477,6 +1488,7 @@
 
       svg_color y_axis_label_color()
       { // But only return the stroke color.
+ //return y_label_info_.style().stroke_color();
         return image.g(detail::PLOT_VALUE_LABELS).style().stroke_color();
       }
 
@@ -1651,13 +1663,13 @@
       }
 
       svg_2d_plot& y_label_axis(const std::string& str)
- { // Label for Y-axis.
+ { // Set label for Y-axis.
         y_label_info_.text(str);
         return *this;
       }
 
       std::string y_label_axis()
- {
+ { // text to label Y axis.
         return y_label_info_.text();
       }
 
@@ -1811,16 +1823,17 @@
         return y_axis_label_style_.font_size();
       }
 
- svg_2d_plot& y_label_weight(std::string s)
- { // "bold" is only one that works so far.
- x_axis_label_style_.font_weight(s);
- return *this;
- }
+ // Note useful until browsers support.
+ //svg_2d_plot& y_label_weight(std::string s)
+ //{ // "bold" is only one that works so far.
+ // x_axis_label_style_.font_weight(s);
+ // return *this;
+ //}
 
- const std::string& y_label_weight()
- {
- return x_axis_label_style_.font_weight();
- }
+ //const std::string& y_label_weight()
+ //{
+ // return x_axis_label_style_.font_weight();
+ //}
 
       svg_2d_plot& y_label_font_family(const std::string& family)
       {

Modified: sandbox/SOC/2007/visualization/boost/svg_plot/svg_style.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/svg_style.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/svg_style.hpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -76,7 +76,8 @@
     
 public:
     svg_style() :
- fill_(svg_color(0, 0, 0)), // == black
+ fill_(blank), // Should avoid any fill =
+ //fill_(svg_color(0, 0, 0)), // == black
       stroke_(svg_color(0, 0, 0)), // == black
       width_(0), // No width
       fill_on_(false), stroke_on_(false), width_on_(false)
@@ -111,11 +112,10 @@
       return fill_on_;
     }
 
- // TODO why are these not chainable? svg_style& fill_on(bool is)
- void fill_on(bool is)
+ svg_style& fill_on(bool is)
     {
       fill_on_ = is;
- // return *this; // Make chainable.
+ return *this; // Make chainable.
     }
 
     bool stroke_on() const
@@ -123,9 +123,10 @@
       return stroke_on_;
     }
 
- void stroke_on(bool is)
+ svg_style& stroke_on(bool is)
     {
       stroke_on_ = is;
+ return *this; // Make chainable.
     }
 
     bool width_on() const
@@ -133,16 +134,17 @@
       return width_on_;
     }
 
- void width_on(bool is)
+ svg_style& width_on(bool is)
     {
       width_on_ = is;
+ return *this; // Make chainable.
     }
  
     // Set svg_style member functions to set fill, stroke & width.
     svg_style& fill_color(const svg_color& col)
     {
         fill_ = col;
- fill_on_ = ! col.blank; // if blank fill is off or "none"
+ fill_on_ = ! col.blank; // If blank fill is off or "none".
         return *this; // Make chainable.
     }
 
@@ -150,14 +152,14 @@
     {
         stroke_ = col;
         stroke_on_ = true; // Assume want a stroke if color is set.
- return *this;
+ return *this; // Make chainable.
     }
 
     svg_style& stroke_width(double width)
     {
         width_ = width;
         width_on_ = ((width > 0) ? true : false);
- return *this;
+ return *this; // Make chainable.
     }
     
     void write(std::ostream& rhs)
@@ -168,8 +170,8 @@
           stroke_.write(rhs);
           rhs << "\"";
       }
- if(fill_on_)
- {
+ if(fill_on_ && (fill_ != blank))
+ { // Don't add fill info if color is blank.
           rhs << " fill=\"";
           fill_.write(rhs);
           rhs << "\"";
@@ -433,9 +435,9 @@
       int size = 10, point_shape shape = round, const std::string& symbols = "X")
         :
         fill_color_(fill), stroke_color_(stroke), size_(size), shape_(shape), symbols_(symbols)
- { // Best to have a fixed width font for symbols?
- symbols_style_.font_size(size);
+ { // Best to have a fixed-width font for symbols?
       symbols_style_.font_family("Lucida Sans Unicode");
+ symbols_style_.font_size(size);
     }
 
   plot_point_style& size(int i)

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/index.html
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/index.html (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/index.html 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -96,7 +96,7 @@
 </div>
 </div>
 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: January 24, 2008 at 13:17:20 GMT</small></p></td>
+<td align="left"><p><small>Last revised: February 01, 2008 at 18:13:38 GMT</small></p></td>
 <td align="right"><div class="copyright-footer"></div></td>
 </tr></table>
 <hr>

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_1d_plot_interface.html
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_1d_plot_interface.html (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_1d_plot_interface.html 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -28,7 +28,7 @@
 <a name="svg_plot.interface.svg_1d_plot_interface"></a> svg_1d_plot Public Interface
 </h3></div></div></div>
 <div class="table">
-<a name="id697440"></a><p class="title"><b>Table 8. 1D_plot Miscellaneous Functions</b></p>
+<a name="id697454"></a><p class="title"><b>Table 8. 1D_plot Miscellaneous Functions</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Miscellaneous Functions">
 <colgroup>
 <col>
@@ -45,6 +45,11 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
@@ -58,6 +63,10 @@
               See the defaults section for further details
             </p>
             </td>
+<td>
+ <p>
+ </p>
+ </td>
 </tr>
 <tr>
 <td>
@@ -72,6 +81,11 @@
               Sets the size of the image produced (pixels)
             </p>
             </td>
+<td>
+ <p>
+ 500, 200
+ </p>
+ </td>
 </tr>
 <tr>
 <td>
@@ -82,8 +96,12 @@
             </td>
 <td>
             <p>
- Sets the precision output for coordinates (decimal digits, default
- 3).
+ Sets the precision output for coordinates (decimal digits).
+ </p>
+ </td>
+<td>
+ <p>
+ 3
             </p>
             </td>
 </tr>
@@ -100,11 +118,14 @@
               Document title&lt;/title&gt;
             </p>
             </td>
-</tr>
-<tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ ""
+ </p>
+ </td>
+<td>
+ <p>
+ [<code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
               <span class="identifier">description</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">)</span></code>
             </p>
             </td>
@@ -128,6 +149,13 @@
               Sets the font size for the legend title.
             </p>
             </td>
+<td>
+ <p>
+ 14
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -141,6 +169,13 @@
               Sets the color to be used for the legend text.
             </p>
             </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -154,6 +189,13 @@
               Sets the string to be used for the title.
             </p>
             </td>
+<td>
+ <p>
+ ""
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -167,6 +209,13 @@
               Sets the font size for the title.
             </p>
             </td>
+<td>
+ <p>
+ 16
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -180,6 +229,13 @@
               Sets the color to be used for the title.
             </p>
             </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -193,6 +249,9 @@
               Writes the plot to the file passed as a parameter.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -206,16 +265,20 @@
               Writes the plot to a stream passed as a parameter.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 </tbody>
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id698278"></a><p class="title"><b>Table 9. 1D_plot Commands</b></p>
+<a name="id698354"></a><p class="title"><b>Table 9. 1D_plot Commands</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Commands">
 <colgroup>
 <col>
 <col>
+<col>
 </colgroup>
 <thead><tr>
 <th>
@@ -228,6 +291,11 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
@@ -239,7 +307,12 @@
             </td>
 <td>
             <p>
- Sets whether the axis is on (true) or off.
+ Sets if the X-axis is on (true) or off.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -252,7 +325,12 @@
             </td>
 <td>
             <p>
- Sets whether the legend is on (true) or off.
+ Sets if the legend is on (true) or off.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -265,8 +343,12 @@
             </td>
 <td>
             <p>
- Sets whether the plot will be displayed in its own window, or will
- be "full screen" in the image.
+ Sets if the plot window border will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
 </tr>
@@ -279,7 +361,12 @@
             </td>
 <td>
             <p>
- Determines whether or not the image title is displayed.
+ Sets if image title is displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -292,9 +379,10 @@
             </td>
 <td>
             <p>
- Determines whether or not the X-axis is displayed.
+ Sets if X-axis is displayed.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -305,8 +393,12 @@
             </td>
 <td>
             <p>
- Determines whether or not the axis is inside or outside of the plot.
- Defaults is <code class="computeroutput"><span class="keyword">false</span></code>.
+ Sets if axis is inside or outside of the plot.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
 </tr>
@@ -319,7 +411,12 @@
             </td>
 <td>
             <p>
- Sets whether or not the X-axis label will show
+ Sets if X-axis label will show.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -332,7 +429,12 @@
             </td>
 <td>
             <p>
- sets whether or not the major ticks will be labelled on the X-axis.
+ Sets if major ticks will be labelled on the X-axis.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -345,7 +447,12 @@
             </td>
 <td>
             <p>
- Determines whether or not the major grid on the X axis will be displayed.
+ Sets if major grid on the X axis will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
 </tr>
@@ -358,7 +465,12 @@
             </td>
 <td>
             <p>
- Determines whether or not the minor grid on the X axis will be displayed.
+ Sets if minor grid on the X axis will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
 </tr>
@@ -371,7 +483,12 @@
             </td>
 <td>
             <p>
- Determines whether or not the Y axis is displayed.
+ Sets if Y axis is displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
 </tr>
@@ -379,7 +496,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id698966"></a><p class="title"><b>Table 10. 1D_plot Colors</b></p>
+<a name="id699102"></a><p class="title"><b>Table 10. 1D_plot Colors</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Colors">
 <colgroup>
 <col>
@@ -396,6 +513,11 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
@@ -587,7 +709,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id700028"></a><p class="title"><b>Table 11. 1D_plot X-Axis Definition</b></p>
+<a name="id700171"></a><p class="title"><b>Table 11. 1D_plot X-Axis Definition</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot X-Axis Definition">
 <colgroup>
 <col>
@@ -604,6 +726,11 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
@@ -628,8 +755,46 @@
             </td>
 <td>
             <p>
- Sets the label of the X-axis. This does not guarantee that it will
- be shown. You must call <code class="computeroutput"><span class="identifier">x_label_on</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display.
+ Sets the label of the X-axis. You must call <code class="computeroutput"><span class="identifier">x_label_on</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_label_units</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the units label of the X-axis. You must call <code class="computeroutput"><span class="identifier">x_label_on</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_label_font_family</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">family</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the font for label of the X-axis.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_label_font_size</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the font size for label of the X-axis.
             </p>
             </td>
 </tr>
@@ -715,13 +880,41 @@
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_range</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x1</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">x2</span><span class="special">)</span></code>
+ <span class="identifier">x_range</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x_min</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">x_max</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the scale of the x axis from x_min to x2. Throws an exception
+ if x2 &lt;= x1, or if the range is too small to produce a useful plot.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_min</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the scale of the x axis from x1 to x2. Throws an exception if
- x2&lt;=x1, or if the range is too small to produce a useful plot.
+ Sets the minimum scale of the x axis. Cannot check that x_min &lt;=
+ x_max!
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_1d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_max</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the maximum scale of the x axis. Cannot check that x_min &lt;=
+ x_max!
             </p>
             </td>
 </tr>
@@ -729,7 +922,7 @@
 </table></div>
 </div>
 <br class="table-break"><a name="svg_plot.interface.svg_1d_plot_interface.the_1d_plot__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__method"></a><h5>
-<a name="id700691"></a>
+<a name="id701216"></a>
         <a href="svg_1d_plot_interface.html#svg_plot.interface.svg_1d_plot_interface.the_1d_plot__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__method">The
         1D_plot <code class="computeroutput"><span class="identifier">plot</span><span class="special">()</span></code>
         Method</a>
@@ -740,7 +933,7 @@
         named parameters, as well as a deduced parameter.
       </p>
 <div class="table">
-<a name="id700750"></a><p class="title"><b>Table 12. 1D_plot Required parameter</b></p>
+<a name="id701274"></a><p class="title"><b>Table 12. 1D_plot Required parameter</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Required parameter">
 <colgroup>
 <col>
@@ -763,12 +956,17 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
 <td>
             <p>
- _container
+ container
             </p>
             </td>
 <td>
@@ -785,7 +983,7 @@
 <tr>
 <td>
             <p>
- _title
+ title
             </p>
             </td>
 <td>
@@ -803,7 +1001,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id700871"></a><p class="title"><b>Table 13. 1D_plot Deduced parameter</b></p>
+<a name="id701403"></a><p class="title"><b>Table 13. 1D_plot Deduced parameter</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Deduced parameter">
 <colgroup>
 <col>
@@ -832,11 +1030,16 @@
               Default
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody><tr>
 <td>
             <p>
- _fill_color
+ fill_color
             </p>
             </td>
 <td>
@@ -859,7 +1062,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id700978"></a><p class="title"><b>Table 14. 1D_plot Optional Parameters</b></p>
+<a name="id701516"></a><p class="title"><b>Table 14. 1D_plot Optional Parameters</b></p>
 <div class="table-contents"><table class="table" summary="1D_plot Optional Parameters">
 <colgroup>
 <col>
@@ -888,12 +1091,17 @@
               Default
             </p>
             </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
 <td>
             <p>
- _stroke_color
+ stroke_color
             </p>
             </td>
 <td>
@@ -915,7 +1123,7 @@
 <tr>
 <td>
             <p>
- _point_style
+ point_style
             </p>
             </td>
 <td>
@@ -938,7 +1146,7 @@
 <tr>
 <td>
             <p>
- _size
+ size
             </p>
             </td>
 <td>
@@ -960,7 +1168,7 @@
 <tr>
 <td>
             <p>
- _x_functor
+ x_functor
             </p>
             </td>
 <td>
@@ -1010,7 +1218,7 @@
         method:
       </p>
 <a name="svg_plot.interface.svg_1d_plot_interface.using_1d_plot_fill_and_stroke_colors"></a><h5>
-<a name="id701530"></a>
+<a name="id702076"></a>
         <a href="svg_1d_plot_interface.html#svg_plot.interface.svg_1d_plot_interface.using_1d_plot_fill_and_stroke_colors">Using
         1D_plot fill and stroke colors</a>
       </h5>

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_2d_plot_interface.html
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_2d_plot_interface.html (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_2d_plot_interface.html 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -27,11 +27,12 @@
 <a name="svg_plot.interface.svg_2d_plot_interface"></a> svg_2d_plot Public Interface
 </h3></div></div></div>
 <div class="table">
-<a name="id701684"></a><p class="title"><b>Table 15. 2D_plot Miscellaneous</b></p>
+<a name="id702230"></a><p class="title"><b>Table 15. 2D_plot Miscellaneous</b></p>
 <div class="table-contents"><table class="table" summary="2D_plot Miscellaneous">
 <colgroup>
 <col>
 <col>
+<col>
 </colgroup>
 <thead><tr>
 <th>
@@ -44,6 +45,11 @@
               Description
             </p>
             </th>
+<th>
+ <p>
+ Default (if any)
+ </p>
+ </th>
 </tr></thead>
 <tbody>
 <tr>
@@ -57,6 +63,7 @@
               See the defaults section for further details.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -71,6 +78,11 @@
               Sets the size (pixels) of the plot image produced.
             </p>
             </td>
+<td>
+ <p>
+ 500, 400
+ </p>
+ </td>
 </tr>
 <tr>
 <td>
@@ -84,6 +96,11 @@
               Sets the string to be used for the title.
             </p>
             </td>
+<td>
+ <p>
+ Null string.
+ </p>
+ </td>
 </tr>
 <tr>
 <td>
@@ -97,6 +114,11 @@
               Sets the font size for the title.
             </p>
             </td>
+<td>
+ <p>
+ 16
+ </p>
+ </td>
 </tr>
 <tr>
 <td>
@@ -110,16 +132,22 @@
               Sets the font size for the legend title.
             </p>
             </td>
+<td>
+ <p>
+ 14
+ </p>
+ </td>
 </tr>
 </tbody>
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id702042"></a><p class="title"><b>Table 16. 2D_plot Commands</b></p>
-<div class="table-contents"><table class="table" summary="2D_plot Commands">
+<a name="id702621"></a><p class="title"><b>Table 16. 2D_plot On/Off Switches</b></p>
+<div class="table-contents"><table class="table" summary="2D_plot On/Off Switches">
 <colgroup>
 <col>
 <col>
+<col>
 </colgroup>
 <thead><tr>
 <th>
@@ -132,18 +160,60 @@
               Description
             </p>
             </th>
+<td class="auto-generated"> </td>
 </tr></thead>
 <tbody>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">axis_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ <span class="identifier">axes_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ If <span class="bold"><strong>both</strong></span> X &amp; Y axes drawn.
+ </p>
+ </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_axis_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set if X-axis drawn.
+ </p>
+ </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_axis_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set if Y-axis drawn.
             </p>
             </td>
 <td>
             <p>
- Sets whether the axis is on (true) or off.
+ true
             </p>
             </td>
 </tr>
@@ -156,7 +226,12 @@
             </td>
 <td>
             <p>
- Sets whether the legend is on (true) or off.
+ Sets if the legend box is shown.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -169,8 +244,28 @@
             </td>
 <td>
             <p>
- Sets whether the plot will be displayed in its own window, or will
- be "full screen" in the image.
+ Sets if the plot window border will be drawn.
+ </p>
+ </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+<td>
+ <p>
+ [<code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">title_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets if image title is displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
 </tr>
@@ -178,14 +273,22 @@
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">title_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ <span class="identifier">title_color</span><span class="special">(</span><span class="identifier">svg_color</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines whether or not the image title is displayed.
+ Sets color for title.
             </p>
             </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -196,9 +299,17 @@
             </td>
 <td>
             <p>
- Sets whether or not the X axis label will show.
+ Sets if X axis label is displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ true
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -212,6 +323,14 @@
               Determines whether or not the major grid on the X axis will be displayed.
             </p>
             </td>
+<td>
+ <p>
+ false
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -226,6 +345,14 @@
               0 means down (default), 0 (false) means none, &gt; 0 means to top)
             </p>
             </td>
+<td>
+ <p>
+ down
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -236,9 +363,17 @@
             </td>
 <td>
             <p>
- Determines whether or not the minor grid on the X axis will be displayed.
+ Sets if the minor grid on the X axis will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -252,6 +387,14 @@
               Sets whether or not the Y axis label will show.
             </p>
             </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -262,9 +405,17 @@
             </td>
 <td>
             <p>
- Determines whether or not the major grid on the Y axis will be displayed.
+ Sets if the major grid on the Y axis will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -279,6 +430,14 @@
               0 means to left (default), 0 (false) means none, &gt; 0 means to right.
             </p>
             </td>
+<td>
+ <p>
+ left
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -289,123 +448,806 @@
             </td>
 <td>
             <p>
- Determines whether or not the minor grid on the Y axis will be displayed.
+ Sets if the minor grid on the Y axis will be displayed.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_value_precision</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">x_label_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the iostream precison for value labels on the X axis major
- ticks will be displayed. Default is 3 (rather than the iostream default
- of 6).
+ Sets the label string for the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_value_ioflags</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">x_label_on</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the iostream flags for value labels on the X axis major
- ticks will be displayed. Default is std::ios::dec. This allows fine
- control of the value labels using, for example (ios::dec | ios::scientific),
- or (ios::dec | ios::fixed), particularly in conjunction with precision.
+ Returns if to show the label string for the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_value_precision</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_label_on</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the iostream precison for value labels on the Y axis major
- ticks will be displayed. Default is 3 (rather than the iostream default
- of 6).
+ Sets to show the label string for the Y-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_value_ioflags</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_label_on</span><span class="special">()</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Returns if to show the label string for the Y-axis.
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_major_labels_on</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets if to show the value labels for the X-axis. &lt; 0 means to down
+ (default), 0 (false) means none, &gt; 0 means to top
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_major_labels_on</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets if to show the value labels for the Y-axis. &lt; 0 means to left(default),
+ 0 (false) means none, &gt; 0 means to right
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_value_precision</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the iostream precison for value labels on the X axis major ticks
+ will be displayed. Default is 3 (rather than the iostream default of
+ 6).
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_value_ioflags</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the iostream flags for value labels on the Y axis major
- ticks will be displayed. Default is std::ios::dec. This allows fine
- control of the value labels using, for example (ios::dec | ios::scientific),
+ Sets the iostream flags for value labels on the X axis major ticks
+ will be displayed. Default is std::ios::dec. This allows fine control
+ of the value labels using, for example (ios::dec | ios::scientific),
               or (ios::dec | ios::fixed), particularly in conjunction with precision.
             </p>
             </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>y_major_label_rotation
+ <span class="identifier">y_value_precision</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the direction of writing of value labels from the Y axis
- ticks. <code class="computeroutput"><span class="keyword">enum</span> <span class="identifier">rotate_style</span></code>
- provides control is 45 degree steps. The default is horizontal.
+ Sets the iostream precison for value labels on the Y axis major ticks
+ will be displayed. Default is 3 (rather than the iostream default of
+ 6).
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_value_ioflags</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
+ </td>
+<td>
             <p>
- `enum rotate_style { <span class="emphasis"><em>/ Rotation in degrees from horizontal.
- horizontal = 0, /</em></span> normal left to right. uphill = -45, <span class="emphasis"><em>/
- slope up. upward = -90, /</em></span> vertical writing up. backup =
- -135, <span class="emphasis"><em>/ slope up backwards. downhill = 45, /</em></span> slope
- down. downward = 90, <span class="emphasis"><em>/ vertical writing down. backdown =
- 135, /</em></span> slope down backwards. upsidedown = 180 // == -180
- };
+ Sets the iostream flags for value labels on the Y axis major ticks
+ will be displayed. Default is std::ios::dec. This allows fine control
+ of the value labels using, for example (ios::dec | ios::scientific),
+ or (ios::dec | ios::fixed), particularly in conjunction with precision.
             </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_major_label_rotation</span></code>(int)
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the direction of writing of value labels from the X axis ticks.
+ <code class="computeroutput"><span class="keyword">enum</span> <span class="identifier">rotate_style</span></code>
+ provides control is 45 degree steps. Default is horizontal.
+</p>
+<pre class="programlisting">
+<span class="keyword">enum</span> <span class="identifier">rotate_style</span>
+ <span class="special">{</span> <span class="comment">// Rotation in degrees from horizontal. horizontal = 0, // normal left to right.
+</span> <span class="identifier">uphill</span> <span class="special">=</span> <span class="special">-</span><span class="number">45</span><span class="special">,</span> <span class="comment">// slope up.
+</span> <span class="identifier">upward</span> <span class="special">=</span> <span class="special">-</span><span class="number">90</span><span class="special">,</span> <span class="comment">// vertical writing up.
+</span> <span class="identifier">backup</span> <span class="special">=</span> <span class="special">-</span><span class="number">135</span><span class="special">,</span> <span class="comment">// slope up backwards.
+</span> <span class="identifier">downhill</span> <span class="special">=</span> <span class="number">45</span><span class="special">,</span> <span class="comment">// slope down.
+</span> <span class="identifier">downward</span> <span class="special">=</span> <span class="number">90</span><span class="special">,</span> <span class="comment">// vertical writing down.
+</span> <span class="identifier">backdown</span> <span class="special">=</span> <span class="number">135</span><span class="special">,</span> <span class="comment">// slope down backwards.
+</span> <span class="identifier">upsidedown</span> <span class="special">=</span> <span class="number">180</span> <span class="comment">// == -180
+</span> <span class="special">};</span></pre>
+<p>
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_major_label_rotation</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Determines the direction of writing of value labels from the Y axis
+ ticks. <code class="computeroutput"><span class="keyword">enum</span> <span class="identifier">rotate_style</span></code>
+ provides control is 45 degree steps.
+ </p>
+ </td>
+<td>
+ <p>
+ Horizontal
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ </code>x_major_value_labels_on(int)<code class="computeroutput"><span class="special">]</span>
+ <span class="special">[</span><span class="identifier">If</span>
+ <span class="identifier">label</span> <span class="identifier">values</span>
+ <span class="keyword">for</span> <span class="identifier">X</span>
+ <span class="identifier">major</span> <span class="identifier">ticks</span><span class="special">,</span> <span class="keyword">and</span> <span class="identifier">direction</span><span class="special">:</span>
+ <span class="special">-</span><span class="number">1</span>
+ <span class="special">=</span> <span class="identifier">bottom</span><span class="special">,</span> <span class="number">0</span> <span class="special">=</span> <span class="special">*</span><span class="identifier">no</span><span class="special">*</span> <span class="identifier">value</span> <span class="identifier">labels</span><span class="special">,</span> <span class="special">+</span><span class="number">1</span> <span class="special">=</span> <span class="identifier">top</span><span class="special">.</span> <span class="identifier">Default</span> <span class="special">-</span><span class="number">1</span><span class="special">,</span> <span class="identifier">bottom</span>
+ <span class="identifier">of</span> <span class="identifier">plot</span>
+ <span class="identifier">window</span><span class="special">.]</span>
+ <span class="special">[</span><span class="identifier">bottom</span><span class="special">]]</span> <span class="special">[[</span></code>svg_2d_plot&amp;
+ <code class="computeroutput"><span class="identifier">y_major_value_labels_on</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ If label values for Y major ticks, and direction: -1 = left, 0 = <span class="bold"><strong>no</strong></span> value labels, +1 = right. Default -1, left
+ of plot window.
+ </p>
+ </td>
+<td>
+ <p>
+ left
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ </code>x_ticks_on_plot_window_on(int)<code class="computeroutput"><span class="special">]</span>
+ <span class="special">[</span><span class="identifier">Position</span>
+ <span class="identifier">of</span> <span class="identifier">Y</span>
+ <span class="identifier">axis</span> <span class="identifier">of</span>
+ <span class="identifier">value</span> <span class="identifier">labels</span>
+ <span class="special">&amp;</span> <span class="identifier">ticks</span><span class="special">:</span> <span class="special">-</span><span class="number">1</span> <span class="special">=</span> <span class="identifier">left</span><span class="special">,</span> <span class="number">0</span> <span class="special">=</span> <span class="identifier">on</span> <span class="identifier">Y</span><span class="special">-</span><span class="identifier">axis</span><span class="special">,</span> <span class="special">+</span><span class="number">1</span> <span class="special">=</span> <span class="identifier">right</span><span class="special">.</span>
+ <span class="identifier">Default</span> <span class="special">-</span><span class="number">1</span><span class="special">,</span> <span class="identifier">left</span>
+ <span class="identifier">of</span> <span class="identifier">plot</span>
+ <span class="identifier">window</span><span class="special">.]</span>
+ <span class="special">[</span><span class="identifier">bottom</span><span class="special">]]</span> <span class="special">[[</span></code>svg_2d_plot&amp;
+ <code class="computeroutput"><span class="identifier">y_ticks_on_plot_window_on</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Position of X axis of value labels &amp; ticks: -1 = bottom, 0 = on
+ X-axis, +1 = top. Default -1, bottom of plot window.
+ </p>
+ </td>
+<td>
+ <p>
+ left
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ </code>x_label_strip_e0s(bool)<code class="computeroutput"><span class="special">]</span>
+ <span class="special">[</span><span class="identifier">If</span>
+ <span class="identifier">X</span> <span class="identifier">axis</span>
+ <span class="identifier">value</span> <span class="identifier">labels</span>
+ <span class="keyword">for</span> <span class="identifier">major</span>
+ <span class="identifier">ticks</span> <span class="identifier">are</span>
+ <span class="identifier">stripped</span> <span class="identifier">of</span>
+ <span class="identifier">redundant</span> <span class="identifier">zero</span><span class="special">(</span><span class="identifier">s</span><span class="special">),</span> <span class="identifier">e</span> <span class="keyword">or</span> <span class="identifier">E</span><span class="special">,</span> <span class="keyword">and</span> <span class="special">+</span> <span class="identifier">sign</span><span class="special">.</span> <span class="identifier">This</span>
+ <span class="identifier">can</span> <span class="identifier">markedly</span>
+ <span class="identifier">reduce</span> <span class="identifier">visual</span>
+ <span class="identifier">clutter</span><span class="special">,</span>
+ <span class="keyword">for</span> <span class="identifier">example</span><span class="special">,</span> <span class="identifier">reducing</span>
+ <span class="string">"1.2e+000"</span> <span class="identifier">to</span>
+ <span class="string">"1.2"</span><span class="special">.]</span>
+ <span class="special">[</span><span class="keyword">true</span><span class="special">]]</span> <span class="special">[[</span></code>svg_2d_plot&amp;
+ <code class="computeroutput"><span class="identifier">y_label_strip_e0s</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ If Y axis value labels for major ticks are stripped of redundant zero(s),
+ e or E, and + sign. This can markedly reduce visual clutter, for example,
+ reducing "1.2e+000" to "1.2".
+ </p>
+ </td>
+<td>
+ <p>
+ true
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ </code>x_axis_width(double)<code class="computeroutput"><span class="special">]</span>
+ <span class="special">[</span><span class="identifier">Sets</span>
+ <span class="identifier">X</span> <span class="identifier">axis</span>
+ <span class="identifier">line</span> <span class="identifier">width</span><span class="special">.]</span> <span class="special">[</span><span class="number">2</span><span class="special">]]</span> <span class="special">[[</span></code>svg_2d_plot&amp; <code class="computeroutput"><span class="identifier">y_axis_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets Y axis line width.
+ </p>
+ </td>
+<td>
+ <p>
+ 2
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ </code>x_axis_color(double)<code class="computeroutput"><span class="special">]</span>
+ <span class="special">[</span><span class="identifier">Sets</span>
+ <span class="identifier">X</span> <span class="identifier">axis</span>
+ <span class="identifier">line</span> <span class="identifier">color</span><span class="special">.][</span><span class="identifier">black</span><span class="special">.]]</span> <span class="special">[[</span></code>svg_2d_plot&amp;
+ <code class="computeroutput"><span class="identifier">y_axis_color</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets Y axis line color.
+ </p>
+ </td>
+<td>
+ <p>
+ black.
+ </p>
+ </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+<td class="auto-generated"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<br class="table-break"><div class="table">
+<a name="id705939"></a><p class="title"><b>Table 17. 2D_plot Colors</b></p>
+<div class="table-contents"><table class="table" summary="2D_plot Colors">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Signature
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+<th>
+ <p>
+ Default
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">title_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the plot title color.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the background color for the whole image as <code class="computeroutput"><span class="identifier">col</span></code>,
+ an RGB color..
+ </p>
+ </td>
+<td>
+ <p>
+ white
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">legend_background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the background color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
+ an RGB color.
+ </p>
+ </td>
+<td>
+ <p>
+ white
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">legend_border_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the border color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
+ an RGB color.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">legend_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the fill color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
+ an RGB color.
+ </p>
+ </td>
+<td>
+ <p>
+ white
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">background_border_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the background border color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
+ an RGB color.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">plot_background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Set the fill color of the plot area.
+ </p>
+ </td>
+<td>
+ <p>
+ white
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_axis_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the lines that form the axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_label_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the labels that go along the X axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_major_grid_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the grid that runs perpindicular to the X axis
+ </p>
+ </td>
+<td>
+ <p>
+ cyan
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_major_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the major ticks of the X-axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">x_minor_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the minor ticks of the X-axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_axis_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the lines that form the Y axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_label_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the labels that go along the Y axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_major_grid_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the grid that runs perpendicular to the Y axis.
+ </p>
+ </td>
+<td>
+ <p>
+ cyan
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_major_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the major ticks of the Y-axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
+ <span class="identifier">y_minor_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
+ <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Sets the color of the minor ticks of the Y-axis.
+ </p>
+ </td>
+<td>
+ <p>
+ black
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<br class="table-break"><div class="table">
+<a name="id707451"></a><p class="title"><b>Table 18. 2D_plot Axis Information</b></p>
+<div class="table-contents"><table class="table" summary="2D_plot Axis Information">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Signature
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+<th>
             <p>
+ Default
             </p>
- </td>
-</tr>
+ </th>
+</tr></thead>
+<tbody>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>x_major_value_labels<span class="underline">on</span>
- </p>
- </td>
-<td>
- <p>
- Determines if label values for X major ticks, and direction.: -1 =
- bottom, 0 = no value labels, +1 = top. Default -1, bottom of plot window.
+ <span class="identifier">x_axis_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
-</tr>
-<tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>y_major_value_labels<span class="underline">on</span>
+ Sets the line or stroke width (pixels) of the X-axis.
             </p>
             </td>
 <td>
             <p>
- Determines if label values for Y major ticks, and direction.: -1 =
- left, 0 = no value labels, +1 = right. Default -1, left of plot window.
+ 2
             </p>
             </td>
 </tr>
@@ -413,620 +1255,598 @@
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>x_ticks_on_plot_window_on
+ <span class="identifier">x_label</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the side of Y axis of value labels &amp; ticks: -1 = left,
- 0 = on Y-axis, +1 = right. Default -1, left of plot window.
+ Sets the label of the X-axis. You must set <code class="computeroutput"><span class="identifier">x_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>y_ticks_on_plot_window_on
+ <span class="identifier">x_label_units</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines the side or X axis of value labels &amp; ticks: -1 = bottom,
- 0 = on X-axis, +1 = top. Default -1, bottom of plot window.
+ Sets the units of label of the X-axis. You must set <code class="computeroutput"><span class="identifier">x_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_label_strip_e0s</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ <span class="identifier">x_label_font_family</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">family</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines whether or not the X axis value labels for major ticks are
- stripped of redundant zero, e or E,, and + sign. This can markedly
- reduce visual clutter, for example, reducing "1.2e+000" to
- "1.2".
+ Sets the font family for label of the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_label_strip_e0s</span><span class="special">(</span><span class="keyword">bool</span><span class="special">)</span></code>
+ <span class="identifier">x_label_font_size</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Determines whether or not the Y axis value labels for major ticks are
- stripped of redundant zero, e or E,, and + sign. This can markedly
- reduce visual clutter, for example, reducing "1.2e+000" to
- "1.2".
+ Sets the font size for label of the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
-</tbody>
-</table></div>
-</div>
-<br class="table-break"><div class="table">
-<a name="id703487"></a><p class="title"><b>Table 17. 2D_plot Colors</b></p>
-<div class="table-contents"><table class="table" summary="2D_plot Colors">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- <p>
- Signature
- </p>
- </th>
-<th>
- <p>
- Description
- </p>
- </th>
-</tr></thead>
-<tbody>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">title_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_major_interval</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the plot title color.
+ Sets the distance (Cartesian units) between ticks on the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the background color for the whole image.
+ Sets the length (pixels) of the X-axis major ticks.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">legend_background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_major_tick_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the background color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
- an RGB color.
+ Sets the width (pixels) of the major ticks on the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">legend_border_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_minor_tick</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the border color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
- an RGB color.
+ Sets the length (pixels) of the X-axis minor ticks.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">background_border_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_minor_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the background border color for the legend as <code class="computeroutput"><span class="identifier">col</span></code>,
- an RGB color.
+ Sets the length (pixels) of the X-axis minor tick lengths.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">plot_background_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_minor_tick_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Set the color of the plot area. Note: this only goes into effect if
- plot_area(true) has been called.
+ Sets the width (pixels) of the minor ticks on the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_axis_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_major_grid_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the lines that form the axis.
+ Sets the width (pixels) of the grid on the X axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_label_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_num_minor_ticks</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the labels that go along the X axis.
+ Sets the number of minor ticks between each major tick.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_major_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_range</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x1</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">x2</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the major ticks of the X-axis.
+ Sets the scale of the x axis from x1 to x2. Throws an exception if
+ x2 &lt;= x1.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_major_grid_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_min</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the grid that runs perpindicular to the X axis
+ Sets the minimum scale of the x axis. Cannot check that x_min &lt;=
+ x_max!
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_minor_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">x_max</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the minor ticks of the X-axis.
+ Sets the maximum scale of the x axis. Cannot check that x_min &lt;=
+ x_max!
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_axis_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">y_axis_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the lines that form the Y axis.
+ Sets the stroke width of the X-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_label_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">y_label</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the labels that go along the Y axis.
+ Sets the label of the Y-axis. You must set <code class="computeroutput"><span class="identifier">x_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">y_label_units</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the major ticks of the Y-axis.
+ Sets the units of label of the Y-axis. You must set <code class="computeroutput"><span class="identifier">y_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_grid_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">y_label_font_family</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">family</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the grid that runs perpindicular to the Y axis.
+ Sets the font family for label of the Y-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_minor_tick_color</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">svg_color</span>
- <span class="special">&amp;</span><span class="identifier">col</span><span class="special">)</span></code>
+ <span class="identifier">y_label_font_size</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the color of the minor ticks of the Y-axis.
+ Sets the font size for label of the Y-axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
-</tbody>
-</table></div>
-</div>
-<br class="table-break"><div class="table">
-<a name="id704776"></a><p class="title"><b>Table 18. 2D_plot Axis Information</b></p>
-<div class="table-contents"><table class="table" summary="2D_plot Axis Information">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- <p>
- Signature
- </p>
- </th>
-<th>
- <p>
- Description
- </p>
- </th>
-</tr></thead>
-<tbody>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_axis_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_major_tick</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the line or stroke width (pixels) of the X-axis.
+ Sets the distance (in Cartesian units) between ticks on the Y axis
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_label</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
+ <span class="identifier">y_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the label of the X-axis. You must set <code class="computeroutput"><span class="identifier">x_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
+ Sets the length (pixels) of the Y axis major ticks.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_major_interval</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
+ <span class="identifier">y_major_tick_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the distance (Cartesian units) between ticks on the X-axis.
+ Sets the width (pixels) of the major ticks on the Y axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_minor_tick</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the X-axis major ticks.
+ Sets the length (pixels) of the Y axis minor ticks.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_major_tick_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the width (pixels) of the major ticks on the X-axis.
+ Sets the length (pixels) of the Y axis minor tick lengths.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_minor_tick</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_major_grid_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the X-axis minor ticks.
+ Sets the width (pixels) of the grid on the Y axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_minor_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_minor_tick_width</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the X-axis minor tick lengths.
+ Sets the width (pixels) of the minor ticks on the Y axis.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_minor_tick_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_num_minor_ticks</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the width (pixels) of the minor ticks on the X-axis.
+ Sets the number of minor ticks between each major tick.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_num_minor_ticks</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_scale</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">y1</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">y2</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the number of minor ticks between each major tick.
+ Sets the scale of the Y axis from y1 to y2. Throws an exception if
+ y2 &lt;= y1.
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">x_range</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x1</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">x2</span><span class="special">)</span></code>
+ <span class="identifier">y_min</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the scale of the x axis from x1 to x2. Throws an exception if
- x2 &lt;= x1.
+ Sets the minimum scale of the Y axis. Cannot check that y_min &lt;=
+ y_max!
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_axis_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <span class="identifier">y_max</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">x</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the stroke width of the X-axis.
+ Sets the maximum scale of the Y axis. Cannot check that y_min &lt;=
+ y_max!
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
               <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_label</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;)</span></code>
+ <span class="identifier">data_lines_width</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">width</span><span class="special">)</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the label of the Y-axis. You must set <code class="computeroutput"><span class="identifier">x_label</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span></code> to display the label.
+ Sets the width of lines joining data points. [2
             </p>
             </td>
+<td class="auto-generated"> </td>
 </tr>
-<tr>
-<td>
+</tbody>
+</table></div>
+</div>
+<br class="table-break"><p>
+ Accessor get functions having the same name and returning the same type are
+ also provided for all the above set functions. These allow one to check the
+ current value (returning default if not changed by the preceeding code).
+ </p>
+<p>
+ For example, after a call of
+ </p>
+<pre class="programlisting">
+<span class="identifier">my_plot</span><span class="special">.</span><span class="identifier">y_num_minor_ticks</span><span class="special">(</span><span class="number">9</span><span class="special">);</span> <span class="comment">// Chose 9 minor ticks between y major ticks.
+</span>
+<span class="identifier">my_plot</span><span class="special">.</span><span class="identifier">y_num_minor_ticks</span><span class="special">()</span> <span class="special">==</span> <span class="number">9</span>
+</pre>
+<p>
+ The function show_2d_settings displayed <span class="bold"><strong>all</strong></span>
+ the settings from accessors below.
+ </p>
+<div class="table">
+<a name="id709834"></a><p class="title"><b>Table 19. 2D_plot Accessor functions</b></p>
+<div class="table-contents"><table class="table" summary="2D_plot Accessor functions">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_tick</span><span class="special">(</span><span class="keyword">double</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">axis_line_style</span><span class="special">&amp;</span>
+ <span class="identifier">x_axis</span><span class="special">()</span></code>
             </p>
- </td>
-<td>
+ </th>
+<th>
             <p>
- Sets the distance (in Cartesian units) between ticks on the Y axis
+ returns reference to X axis_line_style.
             </p>
- </td>
-</tr>
+ </th>
+</tr></thead>
+<tbody>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">axis_line_style</span><span class="special">&amp;</span>
+ <span class="identifier">y_axis</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the Y axis major ticks.
+ returns reference to Y axis_line_style.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_tick_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">ticks_labels_style</span><span class="special">&amp;</span> <span class="identifier">x_ticks</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the width (pixels) of the major ticks on the Y axis.
+ returns reference to X ticks_labels_style.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_minor_tick</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">ticks_labels_style</span><span class="special">&amp;</span> <span class="identifier">y_ticks</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the Y axis minor ticks.
+ returns reference to Y ticks_labels_style.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_major_tick_length</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">x_label</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the length (pixels) of the Y axis minor tick lengths.
+ Returns string labelling the X-axis.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_minor_tick_width</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">y_label</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the width (pixels) of the minor ticks on the Y axis.
+ Returns string labelling the Y-axis.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_num_minor_ticks</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">x_label_units</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the number of minor ticks between each major tick.
+ Returns string labelling units of the X-axis.
             </p>
             </td>
 </tr>
 <tr>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">svg_2d_plot</span><span class="special">&amp;</span>
- <span class="identifier">y_scale</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">y1</span><span class="special">,</span> <span class="keyword">double</span> <span class="identifier">y2</span><span class="special">)</span></code>
+ <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">y_label_units</span><span class="special">()</span></code>
             </p>
             </td>
 <td>
             <p>
- Sets the scale of the Y axis from y1 to y2. Throws an exception if
- y2 &lt;= y1.
+ Returns string labelling units of the Y-axis.
             </p>
             </td>
 </tr>
 </tbody>
 </table></div>
 </div>
-<br class="table-break"><p>
- Accessor get functions are also provided for all the above set functions.
- These allow one to check the current value (default if not changed by the
- preceeding code).
- </p>
-<a name="svg_plot.interface.svg_2d_plot_interface.the__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__method"></a><h5>
-<a name="id706181"></a>
+<br class="table-break"><a name="svg_plot.interface.svg_2d_plot_interface.the__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__method"></a><h5>
+<a name="id710266"></a>
         <a href="svg_2d_plot_interface.html#svg_plot.interface.svg_2d_plot_interface.the__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__method">The
         <code class="computeroutput"><span class="identifier">plot</span><span class="special">()</span></code>
         Method</a>
       </h5>
 <p>
         The <code class="computeroutput"><span class="identifier">plot</span><span class="special">()</span></code>
- method is defined using Boost.Parameter. As such, it supports a few extra
- named parameters, as well as a deduced parameter.
+ method supports two parameters &amp; some chained functions.
       </p>
 <div class="table">
-<a name="id706241"></a><p class="title"><b>Table 19. 2D_plot Required parameter</b></p>
-<div class="table-contents"><table class="table" summary="2D_plot Required parameter">
+<a name="id710325"></a><p class="title"><b>Table 20. 2D_plot Required Parameter</b></p>
+<div class="table-contents"><table class="table" summary="2D_plot Required Parameter">
 <colgroup>
 <col>
 <col>
@@ -1053,7 +1873,7 @@
 <tr>
 <td>
             <p>
- _container
+ container
             </p>
             </td>
 <td>
@@ -1070,7 +1890,7 @@
 <tr>
 <td>
             <p>
- _title
+ title
             </p>
             </td>
 <td>
@@ -1088,8 +1908,8 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id706362"></a><p class="title"><b>Table 20. 2D_plot Deduced parameter</b></p>
-<div class="table-contents"><table class="table" summary="2D_plot Deduced parameter">
+<a name="id710446"></a><p class="title"><b>Table 21. 2D_plotChained Functions</b></p>
+<div class="table-contents"><table class="table" summary="2D_plotChained Functions">
 <colgroup>
 <col>
 <col>
@@ -1143,7 +1963,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id706460"></a><p class="title"><b>Table 21. 2D_plot Optional Parameters</b></p>
+<a name="id710546"></a><p class="title"><b>Table 22. 2D_plot Optional Parameters</b></p>
 <div class="table-contents"><table class="table" summary="2D_plot Optional Parameters">
 <colgroup>
 <col>
@@ -1177,7 +1997,7 @@
 <tr>
 <td>
             <p>
- _bezier_on
+ bezier_on
             </p>
             </td>
 <td>
@@ -1187,18 +2007,21 @@
             </td>
 <td>
             <p>
- This determines whether or not Bézier curve interpolation will be
- applied to the plot lines. It is important to note that the curve interpolation
- is still in its infancy, and should only be used with reasonably nice
- data sets
+ Sets if Bézier curve interpolation will be applied to the plot lines.
+ It is important to note that the curve interpolation will produce artefacts
+ if data is 'ill-behaved' with discontinuities.
+ </p>
+ </td>
+<td>
+ <p>
+ false
             </p>
             </td>
-<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
- _line_on
+ line_on
             </p>
             </td>
 <td>
@@ -1208,7 +2031,7 @@
             </td>
 <td>
             <p>
- This determines whether or not there are lines drawn between data points.
+ Sets if lines are drawn between data points.
             </p>
             </td>
 <td>
@@ -1220,7 +2043,7 @@
 <tr>
 <td>
             <p>
- _line_color
+ line_color
             </p>
             </td>
 <td>
@@ -1242,7 +2065,7 @@
 <tr>
 <td>
             <p>
- _area_fill_color
+ area_fill_color
             </p>
             </td>
 <td>
@@ -1252,19 +2075,22 @@
             </td>
 <td>
             <p>
- Defining this enables the "Fill Area Under Axis" feature.
- the color you define will be the fill color between a line and the
- area under the axis. This only takes effect if <code class="computeroutput"><span class="identifier">_line_on</span>
- <span class="special">=</span> <span class="keyword">true</span></code>
- is called.
+ Enables the 'Fill Area Under Axis' feature. The color will be the fill
+ color between a line and the area under the axis. This only takes effect
+ if <code class="computeroutput"><span class="identifier">line_on</span><span class="special">()</span>
+ <span class="special">==</span> <span class="keyword">true</span></code>.
+ </p>
+ </td>
+<td>
+ <p>
+ grey
             </p>
             </td>
-<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
             <p>
- _stroke_color
+ stroke_color
             </p>
             </td>
 <td>
@@ -1286,17 +2112,17 @@
 <tr>
 <td>
             <p>
- _point_style
+ point_style
             </p>
             </td>
 <td>
             <p>
- <code class="computeroutput"><span class="identifier">point_shape</span></code>
+ <code class="computeroutput"><span class="identifier">shape</span></code>
             </p>
             </td>
 <td>
             <p>
- This is the shape of the point. Options currently are between <code class="literal">none</code>,
+ Shape marking the data point. Examples are: <code class="literal">none</code>,
               <code class="literal">circle</code>, and <code class="literal">square</code>.
             </p>
             </td>
@@ -1309,7 +2135,7 @@
 <tr>
 <td>
             <p>
- _size
+ size
             </p>
             </td>
 <td>
@@ -1319,7 +2145,7 @@
             </td>
 <td>
             <p>
- This is the height/width of the circle and square.
+ This is the height/width of the point.
             </p>
             </td>
 <td>
@@ -1331,7 +2157,7 @@
 <tr>
 <td>
             <p>
- _x_functor
+ x_functor
             </p>
             </td>
 <td>
@@ -1342,8 +2168,9 @@
 <td>
             <p>
               A class or that contains a conversion function. You will not have to
- worry about this, unless you are trying to accomplish stuff like plotting
- a vector of humans. For example:
+ worry about this unless you are trying to do plot a type that does
+ not convert to double, for example, like plotting a vector of humans:
+
 </p>
 <pre class="programlisting">
 <span class="keyword">class</span> <span class="identifier">my_functor</span>
@@ -1352,8 +2179,8 @@
 
   <span class="identifier">pair</span><span class="special">&lt;</span><span class="keyword">double</span><span class="special">,</span> <span class="keyword">double</span><span class="special">&gt;</span> <span class="keyword">operator</span><span class="special">()(</span><span class="keyword">const</span> <span class="identifier">human</span><span class="special">&amp;</span> <span class="identifier">_hum</span><span class="special">)</span> <span class="keyword">const</span>
   <span class="special">{</span>
- <span class="keyword">return</span> <span class="identifier">pair</span><span class="special">&lt;</span><span class="keyword">double</span><span class="special">,</span> <span class="keyword">double</span><span class="special">&gt;(</span><span class="identifier">i</span><span class="special">,</span> <span class="identifier">_hum</span><span class="special">.</span><span class="identifier">age</span><span class="special">());</span>
- <span class="special">}</span>
+ <span class="keyword">return</span> <span class="identifier">pair</span><span class="special">&lt;</span><span class="keyword">double</span><span class="special">,</span> <span class="keyword">double</span><span class="special">&gt;(</span><span class="identifier">i</span><span class="special">,</span> <span class="identifier">_hum</span><span class="special">.</span><span class="identifier">age</span><span class="special">());</span> <span class="comment">// age *is* a double.
+</span> <span class="special">}</span>
 <span class="special">}</span>
 
 <span class="comment">// snip
@@ -1378,7 +2205,7 @@
         Here are some examples of correct uses:
       </p>
 <a name="svg_plot.interface.svg_2d_plot_interface.using_fill_and_stroke_colors"></a><h4>
-<a name="id707265"></a>
+<a name="id711374"></a>
         <a href="svg_2d_plot_interface.html#svg_plot.interface.svg_2d_plot_interface.using_fill_and_stroke_colors">Using
         fill and stroke colors</a>
       </h4>

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_boxplot_interface.html
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_boxplot_interface.html (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_boxplot_interface.html 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -27,7 +27,7 @@
 <a name="svg_plot.interface.svg_boxplot_interface"></a> svg_boxplot Public Interface
 </h3></div></div></div>
 <div class="table">
-<a name="id707409"></a><p class="title"><b>Table 22. Boxplot Miscellaneous</b></p>
+<a name="id711518"></a><p class="title"><b>Table 23. Boxplot Miscellaneous</b></p>
 <div class="table-contents"><table class="table" summary="Boxplot Miscellaneous">
 <colgroup>
 <col>
@@ -102,7 +102,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id707704"></a><p class="title"><b>Table 23. Boxplot Commands</b></p>
+<a name="id711813"></a><p class="title"><b>Table 24. Boxplot Commands</b></p>
 <div class="table-contents"><table class="table" summary="Boxplot Commands">
 <colgroup>
 <col>
@@ -190,7 +190,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id708033"></a><p class="title"><b>Table 24. Boxplot Colors</b></p>
+<a name="id712142"></a><p class="title"><b>Table 25. Boxplot Colors</b></p>
 <div class="table-contents"><table class="table" summary="Boxplot Colors">
 <colgroup>
 <col>
@@ -341,7 +341,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id708765"></a><p class="title"><b>Table 25. Boxplot Axis Information</b></p>
+<a name="id712874"></a><p class="title"><b>Table 26. Boxplot Axis Information</b></p>
 <div class="table-contents"><table class="table" summary="Boxplot Axis Information">
 <colgroup>
 <col>
@@ -528,7 +528,7 @@
         preceeding code).
       </p>
 <a name="svg_plot.interface.svg_boxplot_interface.the__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__function"></a><h5>
-<a name="id709669"></a>
+<a name="id713778"></a>
         <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.the__code__phrase_role__identifier__plot__phrase__phrase_role__special______phrase___code__function">The
         <code class="computeroutput"><span class="identifier">plot</span><span class="special">()</span></code>
         Function</a>
@@ -539,7 +539,7 @@
         control their display.
       </p>
 <div class="table">
-<a name="id709729"></a><p class="title"><b>Table 26. Required parameters</b></p>
+<a name="id713838"></a><p class="title"><b>Table 27. Required parameters</b></p>
 <div class="table-contents"><table class="table" summary="Required parameters">
 <colgroup>
 <col>
@@ -602,7 +602,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id709851"></a><p class="title"><b>Table 27. Optional Functions</b></p>
+<a name="id713960"></a><p class="title"><b>Table 28. Optional Functions</b></p>
 <div class="table-contents"><table class="table" summary="Optional Functions">
 <colgroup>
 <col>
@@ -894,10 +894,10 @@
 </tbody>
 </table></div>
 </div>
-<br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.styles_providing_addition_control"></a><h5>
-<a name="id710995"></a>
- <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.styles_providing_addition_control">Styles
- providing addition control</a>
+<br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.styles___provide_additional_control"></a><h5>
+<a name="id715104"></a>
+ <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.styles___provide_additional_control">Styles
+ - provide Additional Control</a>
       </h5>
 <p>
         Several style classes are used internally but are available for external
@@ -913,22 +913,23 @@
 </span><span class="keyword">class</span> <span class="identifier">ticks_labels_style</span><span class="special">;</span> <span class="comment">// Parameters of the axis, grids, &amp; ticks and their value labels.
 </span></pre>
 <a name="svg_plot.interface.svg_boxplot_interface.box_style_defines_a_rectangular_box_"></a><h4>
-<a name="id711176"></a>
+<a name="id715284"></a>
         <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.box_style_defines_a_rectangular_box_">Box
         Style defines a rectangular box.</a>
       </h4>
 <p>
- A box has a border and may be filled with the same or different colors.
+ A box has a border and may be filled with the same or a different color.
       </p>
 <pre class="programlisting">
 <span class="keyword">class</span> <span class="identifier">box_style</span>
 <span class="special">{</span> <span class="comment">// Style of a rectangular box.
-</span> <span class="comment">// Use for image and plot window.
+</span> <span class="comment">// Use for image, legend &amp; plot window.
 </span><span class="keyword">public</span><span class="special">:</span>
     <span class="identifier">svg_color</span> <span class="identifier">stroke_</span><span class="special">;</span> <span class="comment">// Box line stroke color.
 </span> <span class="identifier">svg_color</span> <span class="identifier">fill_</span><span class="special">;</span> <span class="comment">// Box fill color.
 </span> <span class="keyword">double</span> <span class="identifier">width_</span><span class="special">;</span> <span class="comment">// plot border rectangle width.
-</span> <span class="keyword">double</span> <span class="identifier">margin_</span><span class="special">;</span> <span class="comment">// Marginal (svg units) space around the box (inside or out).
+</span> <span class="keyword">double</span> <span class="identifier">margin_</span><span class="special">;</span> <span class="comment">// Marginal (svg units) space inside or around the box,
+</span> <span class="comment">// used to avoid writing or drawing too near the box border.
 </span> <span class="keyword">bool</span> <span class="identifier">border_on_</span><span class="special">;</span> <span class="comment">// Display the border.
 </span> <span class="keyword">bool</span> <span class="identifier">fill_on_</span><span class="special">;</span> <span class="comment">// Color fill the box.
 </span>
@@ -948,7 +949,7 @@
 <span class="special">};</span> <span class="comment">// class box_style
 </span></pre>
 <div class="table">
-<a name="id711812"></a><p class="title"><b>Table 28. Box Style Constructor</b></p>
+<a name="id715928"></a><p class="title"><b>Table 29. Box Style Constructor</b></p>
 <div class="table-contents"><table class="table" summary="Box Style Constructor">
 <colgroup>
 <col>
@@ -997,7 +998,7 @@
             </td>
 <td>
             <p>
- stroke color of the border of the rectangle.
+ Stroke color of the border of the rectangle.
             </p>
             </td>
 </tr>
@@ -1041,7 +1042,7 @@
             </td>
 <td>
             <p>
- Width the svg units of border
+ Width of border(svg units).
             </p>
             </td>
 </tr>
@@ -1086,7 +1087,7 @@
             </td>
 <td>
             <p>
- if true, the a border is drawn.
+ If true, then a border is drawn.
             </p>
             </td>
 </tr>
@@ -1108,7 +1109,7 @@
             </td>
 <td>
             <p>
- if true, fill color drawn inside border, if any.
+ If true, fill color drawn inside border (if any).
             </p>
             </td>
 </tr>
@@ -1116,7 +1117,7 @@
 </table></div>
 </div>
 <br class="table-break"><div class="table">
-<a name="id712063"></a><p class="title"><b>Table 29. Box Style Accessor functions (all are chainable).</b></p>
+<a name="id716178"></a><p class="title"><b>Table 30. Box Style Accessor functions (all are chainable).</b></p>
 <div class="table-contents"><table class="table" summary="Box Style Accessor functions (all are chainable).">
 <colgroup>
 <col>
@@ -1171,7 +1172,7 @@
             </td>
 <td>
             <p>
- Sets color of border of box
+ Sets color of border of box.
             </p>
             </td>
 <td>
@@ -1198,7 +1199,7 @@
             </td>
 <td>
             <p>
- Sets fill color of box
+ Sets fill color of box.
             </p>
             </td>
 <td>
@@ -1318,10 +1319,10 @@
 </tbody>
 </table></div>
 </div>
-<br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.text_style_defines_text_font__size_etc_"></a><h4>
-<a name="id712378"></a>
- <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.text_style_defines_text_font__size_etc_">Text
- Style defines text Font, Size etc.</a>
+<br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.text_style_defines_font__size__style___amp__stretch__weight__decoration__"></a><h4>
+<a name="id716496"></a>
+ <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.text_style_defines_font__size__style___amp__stretch__weight__decoration__">Text
+ Style defines Font, Size, Style (&amp; stretch, weight, decoration).</a>
       </h4>
 <p>
         Text style constructor.
@@ -1329,11 +1330,12 @@
 <pre class="programlisting">
 <span class="identifier">text_style</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">size</span> <span class="special">=</span> <span class="number">20</span><span class="special">,</span>
 <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">font</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span> <span class="comment">// Default is sans with Firefox &amp; IE, but serif with Opera.
-</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">style</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span>
-<span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">weight</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span>
-<span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">stretch</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span>
-<span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">decoration</span> <span class="special">=</span> <span class="string">""</span><span class="special">)</span>
-<span class="special">:</span> <span class="comment">// Constructor.
+</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">style</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span> <span class="comment">// italic, bold.
+</span> <span class="comment">// Functions not yet implemented by most browsers.
+</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">stretch</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span> <span class="comment">// wider, narrower.
+</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">weight</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span> <span class="comment">// lighter, bolder.
+</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">decoration</span> <span class="special">=</span> <span class="string">""</span> <span class="comment">// underline, overline, strike-thru.
+</span><span class="special">)</span> <span class="special">:</span> <span class="comment">// Constructor.
 </span><span class="identifier">font_size_</span><span class="special">(</span><span class="identifier">size</span><span class="special">),</span>
   <span class="identifier">font_family_</span><span class="special">(</span><span class="identifier">font</span><span class="special">),</span>
   <span class="identifier">style_</span><span class="special">(</span><span class="identifier">style</span><span class="special">),</span>
@@ -1344,7 +1346,7 @@
 </span><span class="special">}</span>
 </pre>
 <div class="table">
-<a name="id712876"></a><p class="title"><b>Table 30. Text Style Constructor</b></p>
+<a name="id717028"></a><p class="title"><b>Table 31. Text Style Constructor</b></p>
 <div class="table-contents"><table class="table" summary="Text Style Constructor">
 <colgroup>
 <col>
@@ -1534,7 +1536,7 @@
         produces a Lucida Sans Unicode font of size of 14 svg units (usually pixels).
       </p>
 <div class="table">
-<a name="id713212"></a><p class="title"><b>Table 31. Text Style Accessor functions</b></p>
+<a name="id717363"></a><p class="title"><b>Table 32. Text Style Accessor functions</b></p>
 <div class="table-contents"><table class="table" summary="Text Style Accessor functions">
 <colgroup>
 <col>
@@ -1748,7 +1750,7 @@
 </table></div>
 </div>
 <br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.plot_point_style_defines_how_data_points_are_marked_"></a><h4>
-<a name="id713538"></a>
+<a name="id717689"></a>
         <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.plot_point_style_defines_how_data_points_are_marked_">plot_point_style
         defines how data points are marked.</a>
       </h4>
@@ -1775,27 +1777,23 @@
   <span class="special">}</span>
 </pre>
 <div class="table">
-<a name="id714170"></a><p class="title"><b>Table 32. Plot Point Style Constructor</b></p>
+<a name="id718322"></a><p class="title"><b>Table 33. Plot Point Style Constructor</b></p>
 <div class="table-contents"><table class="table" summary="Plot Point Style Constructor">
 <colgroup>
 <col>
 <col>
 <col>
 <col>
-<col>
-<col>
-<col>
-<col>
 </colgroup>
 <thead><tr>
 <th>
             <p>
- parameter #
+ Parameter #
             </p>
             </th>
 <th>
             <p>
- name
+ Name
             </p>
             </th>
 <th>
@@ -1808,10 +1806,6 @@
               Description
             </p>
             </th>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
 </tr></thead>
 <tbody>
 <tr>
@@ -1835,10 +1829,6 @@
               SVG fill color.
             </p>
             </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -1861,10 +1851,6 @@
               SVG stroke color.
             </p>
             </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -1887,10 +1873,6 @@
               size of marker (svg units).
             </p>
             </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
-<td class="auto-generated"> </td>
 </tr>
 <tr>
 <td>
@@ -1913,9 +1895,11 @@
               shape in enum point_shape
             </p>
             </td>
+</tr>
+<tr>
 <td>
             <p>
- [5
+ 5
             </p>
             </td>
 <td>
@@ -1982,8 +1966,8 @@
 </span><span class="special">};</span>
 </pre>
 <div class="table">
-<a name="id715043"></a><p class="title"><b>Table 33. Plot Point Style Accessor functions</b></p>
-<div class="table-contents"><table class="table" summary="Plot Point Style Accessor functions">
+<a name="id719200"></a><p class="title"><b>Table 34. Plot Point Style Accessor Functions</b></p>
+<div class="table-contents"><table class="table" summary="Plot Point Style Accessor Functions">
 <colgroup>
 <col>
 <col>
@@ -2037,7 +2021,7 @@
             </td>
 <td>
             <p>
- Sets size of point marker or font in svg units
+ Sets size of point marker or font in svg units.
             </p>
             </td>
 <td>
@@ -2064,7 +2048,7 @@
             </td>
 <td>
             <p>
- Sets fill color
+ Sets fill color.
             </p>
             </td>
 <td>
@@ -2118,7 +2102,7 @@
             </td>
 <td>
             <p>
- Sets plot point marker
+ Sets plot point marker.
             </p>
             </td>
 <td>
@@ -2185,7 +2169,7 @@
 </table></div>
 </div>
 <br class="table-break"><a name="svg_plot.interface.svg_boxplot_interface.plot_line_style_defines_how_data_points_are_joined_"></a><h4>
-<a name="id715359"></a>
+<a name="id719516"></a>
         <a href="svg_boxplot_interface.html#svg_plot.interface.svg_boxplot_interface.plot_line_style_defines_how_data_points_are_joined_">plot_line_style
         defines how data points are joined.</a>
       </h4>
@@ -2206,8 +2190,8 @@
 </span> <span class="special">}</span>
 </pre>
 <div class="table">
-<a name="id715870"></a><p class="title"><b>Table 34. Plot line Style Constructor</b></p>
-<div class="table-contents"><table class="table" summary="Plot line Style Constructor">
+<a name="id720026"></a><p class="title"><b>Table 35. Plot Line Style Constructor</b></p>
+<div class="table-contents"><table class="table" summary="Plot Line Style Constructor">
 <colgroup>
 <col>
 <col>
@@ -2263,7 +2247,7 @@
             </td>
 <td>
             <p>
- line color (SVG stroke color).
+ Line color (SVG stroke color).
             </p>
             </td>
 <td class="auto-generated"> </td>
@@ -2289,7 +2273,7 @@
             </td>
 <td>
             <p>
- area_fill color (if required).
+ Area fill color (if required).
             </p>
             </td>
 <td class="auto-generated"> </td>
@@ -2315,7 +2299,7 @@
             </td>
 <td>
             <p>
- width of line (svg units).
+ Width of line (svg units).
             </p>
             </td>
 <td class="auto-generated"> </td>
@@ -2341,7 +2325,7 @@
             </td>
 <td>
             <p>
- true if straight line required.
+ If straight line joins data points.
             </p>
             </td>
 <td>
@@ -2361,7 +2345,7 @@
             </td>
 <td>
             <p>
- true if bezier smoothed line required.
+ If bezier smoothed line joins data points.
             </p>
             </td>
 </tr>
@@ -2383,7 +2367,7 @@
 <span class="identifier">my_plot</span><span class="special">.</span><span class="identifier">plot</span><span class="special">(</span><span class="identifier">data3</span><span class="special">,</span> <span class="string">"-1 + 2x"</span><span class="special">).</span><span class="identifier">bezier_on</span><span class="special">(</span><span class="keyword">true</span><span class="special">).</span><span class="identifier">line_color</span><span class="special">(</span><span class="identifier">blue</span><span class="special">);</span>
 </pre>
 <div class="table">
-<a name="id716273"></a><p class="title"><b>Table 35. Plot Line Style Accessor functions</b></p>
+<a name="id720430"></a><p class="title"><b>Table 36. Plot Line Style Accessor functions</b></p>
 <div class="table-contents"><table class="table" summary="Plot Line Style Accessor functions">
 <colgroup>
 <col>

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_interface.html
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_interface.html (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/html/svg_plot/interface/svg_interface.html 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -991,7 +991,8 @@
             </td>
 <td>
             <p>
- Writes the document to the file represented by the argument.
+ Writes the document to the file represented by the argument. (If not
+ file type sufix is provided, the default file suffix <code class="computeroutput"><span class="string">".svg"</span></code> is appended.
             </p>
             </td>
 <td>

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/interface.qbk
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/interface.qbk (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/interface.qbk 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -4,40 +4,40 @@
 
 [section:svg_1d_plot_interface `svg_1d_plot` Public Interface]
 [table 1D_plot Miscellaneous Functions
- [[Signature] [Description]]
- [[`svg_1d_plot()`] [See the defaults section for further details]]
- [[`svg_1d_plot& image_size(unsigned int, unsigned int)`] [Sets the size of the image produced (pixels)]]
- [[`svg_1d_plot& coord_precision(int)`] [Sets the precision output for coordinates (decimal digits, default 3).]]
- [[`svg_1d_plot& document_title(std::string)`] [Sets title for the SVG XML document (not the plot). <title>My Document title</title>]]
+ [[Signature] [Description] [Default]]
+ [[`svg_1d_plot()`] [See the defaults section for further details] []]
+ [[`svg_1d_plot& image_size(unsigned int, unsigned int)`] [Sets the size of the image produced (pixels)] [500, 200]]
+ [[`svg_1d_plot& coord_precision(int)`] [Sets the precision output for coordinates (decimal digits).] [3]]
+ [[`svg_1d_plot& document_title(std::string)`] [Sets title for the SVG XML document (not the plot). <title>My Document title</title>] [""]
   [[`svg_1d_plot& description(std::string)`] [Sets description for the SVG XML document, as comment and XML, for example: <!-- My Document description -->
 <desc>My Document description</desc>]]
   
- [[`svg_1d_plot& legend_title_font_size(unsigned int)`] [Sets the font size for the legend title.]]
- [[`svg_1d_plot& legend_color(const svg_color& col)`] [Sets the color to be used for the legend text.]]
- [[`svg_1d_plot& title(const std::string&)`] [Sets the string to be used for the title.]]
- [[`svg_1d_plot& title_font_size(unsigned int)`] [Sets the font size for the title.]]
- [[`svg_1d_plot& title_color(const svg_color& col)`] [Sets the color to be used for the title.]]
+ [[`svg_1d_plot& legend_title_font_size(unsigned int)`] [Sets the font size for the legend title.] [14]]
+ [[`svg_1d_plot& legend_color(const svg_color& col)`] [Sets the color to be used for the legend text.] [black]]
+ [[`svg_1d_plot& title(const std::string&)`] [Sets the string to be used for the title.] [""]]
+ [[`svg_1d_plot& title_font_size(unsigned int)`] [Sets the font size for the title.] [16]]
+ [[`svg_1d_plot& title_color(const svg_color& col)`] [Sets the color to be used for the title.] [black]]
   [[`svg_1d_plot& write(const std::string&)`] [Writes the plot to the file passed as a parameter.]]
   [[`svg_1d_plot& write(ostream&)`] [Writes the plot to a stream passed as a parameter.]]
 ] [/ table 1D_plot Miscellaneous Functions]
 
 [table 1D_plot Commands
- [[Signature] [Description]]
- [[`svg_1d_plot& axis_on(bool)`] [Sets whether the axis is on (true) or off.]]
- [[`svg_1d_plot& legend_on(bool)`] [Sets whether the legend is on (true) or off.]]
- [[`svg_1d_plot& plot_window_on(bool)`] [Sets whether the plot will be displayed in its own window, or will be "full screen" in the image.]]
- [[`svg_1d_plot& title_on(bool)`] [Determines whether or not the image title is displayed.]]
- [[`svg_1d_plot& x_axis_on(bool)`] [Determines whether or not the X-axis is displayed.]]
- [[`svg_1d_plot& x_external_style_on(bool)`] [Determines whether or not the axis is inside or outside of the plot. Defaults is `false`.]]
- [[`svg_1d_plot& x_label_on(bool)`] [Sets whether or not the X-axis label will show]]
- [[`svg_1d_plot& x_major_labels_on(int)`] [sets whether or not the major ticks will be labelled on the X-axis. ]]
- [[`svg_1d_plot& x_major_grid_on(bool)`] [Determines whether or not the major grid on the X axis will be displayed.]]
- [[`svg_1d_plot& x_minor_grid_on(bool)`] [Determines whether or not the minor grid on the X axis will be displayed.]]
- [[`svg_1d_plot& y_axis_on(bool)`] [Determines whether or not the Y axis is displayed.]]
+ [[Signature] [Description] [Default]]
+ [[`svg_1d_plot& axis_on(bool)`] [Sets if the X-axis is on (true) or off.] [true]]
+ [[`svg_1d_plot& legend_on(bool)`] [Sets if the legend is on (true) or off.] [true]]
+ [[`svg_1d_plot& plot_window_on(bool)`] [Sets if the plot window border will be displayed.] [false]]
+ [[`svg_1d_plot& title_on(bool)`] [Sets if image title is displayed.] [true]]
+ [[`svg_1d_plot& x_axis_on(bool)`] [Sets if X-axis is displayed.]]
+ [[`svg_1d_plot& x_external_style_on(bool)`] [Sets if axis is inside or outside of the plot.] [false]]
+ [[`svg_1d_plot& x_label_on(bool)`] [Sets if X-axis label will show.][true]]
+ [[`svg_1d_plot& x_major_labels_on(int)`] [Sets if major ticks will be labelled on the X-axis. ][true]]
+ [[`svg_1d_plot& x_major_grid_on(bool)`] [Sets if major grid on the X axis will be displayed.] [false]]
+ [[`svg_1d_plot& x_minor_grid_on(bool)`] [Sets if minor grid on the X axis will be displayed.] [false]]
+ [[`svg_1d_plot& y_axis_on(bool)`] [Sets if Y axis is displayed.] [false]]
   ] [/ table 1D_plot Commands]
 
 [table 1D_plot Colors
- [[Signature] [Description]]
+ [[Signature] [Description] [Default]]
   [[`svg_1d_plot& background_color(const svg_color &col)`] [Set the background color for the whole image.]]
   [[`svg_1d_plot& background_border_color(const svg_color &col)`] [Set the background border color for the whole image as `col`, an RGB color.]]
   [[`svg_1d_plot& background_border_width(const svg_color &col)`] [Set the background border width for the whole image.]]
@@ -54,16 +54,21 @@
 ] [/ table 1D_plot Colors]
 
 [table 1D_plot X-Axis Definition
- [[Signature] [Description]]
+ [[Signature] [Description] [Default]]
   [[`svg_1d_plot& x_axis_width(unsigned int)`] [Sets the stroke width of the X-axis.] ]
- [[`svg_1d_plot& x_label(const std::string&)`] [Sets the label of the X-axis. This does not guarantee that it will be shown. You must call `x_label_on(true)` to display.] ]
+ [[`svg_1d_plot& x_label(const std::string&)`] [Sets the label of the X-axis. You must call `x_label_on(true)` to display.] ]
+ [[`svg_1d_plot& x_label_units(const std::string&)`] [Sets the units label of the X-axis. You must call `x_label_on(true)` to display.] ]
+ [[`svg_1d_plot& x_label_font_family(const std::string& family)`] [Sets the font for label of the X-axis. ] ]
+ [[`svg_1d_plot& x_label_font_size(double)`] [Sets the font size for label of the X-axis.] ]
   [[`svg_1d_plot& x_major_interval(double)`] [Sets the distance (in Cartesian units) between ticks on the X-axis.] ]
   [[`svg_1d_plot& x_major_tick_length(int)`] [Sets the length (pixels) of the X-axis major ticks.] ]
   [[`svg_1d_plot& x_major_tick_width(unsigned int)`] [Sets the width (pixels) of the major ticks on the X-axis.] ]
   [[`svg_1d_plot& x_minor_tick_length(int)`] [Sets the length (pixels) of the X-axis minor tick lengths.] ]
   [[`svg_1d_plot& x_minor_tick_width(unsigned int)`] [Sets the width (pixels) of the minor ticks on the X-axis.] ]
   [[`svg_1d_plot& x_num_minor_ticks(int)`] [Sets the number of minor ticks between each major tick.] ]
- [[`svg_1d_plot& x_range(double x1, double x2)`] [Sets the scale of the x axis from x1 to x2. Throws an exception if x2<=x1, or if the range is too small to produce a useful plot. ] ]
+ [[`svg_1d_plot& x_range(double x_min, double x_max)`] [Sets the scale of the x axis from x_min to x2. Throws an exception if x2 <= x1, or if the range is too small to produce a useful plot. ] ]
+ [[`svg_1d_plot& x_min(double x)`] [Sets the minimum scale of the x axis. Cannot check that x_min <= x_max!] ]
+ [[`svg_1d_plot& x_max(double x)`] [Sets the maximum scale of the x axis. Cannot check that x_min <= x_max!] ]
 ] [/table 1D_plot X-Axis Definition]
 
 
@@ -72,22 +77,22 @@
 few extra named parameters, as well as a deduced parameter.
 
 [table 1D_plot Required parameter
-[[ID] [Type (* is a wildcard)] [Description]]
-[[_container] [*] [Any object that can return an iterator with begin() and end()]]
-[[_title] [`std::string`] [The name of this data series.]]
+[[ID] [Type (* is a wildcard)] [Description] [Default]]
+[[container] [*] [Any object that can return an iterator with begin() and end()]]
+[[title] [`std::string`] [The name of this data series.]]
 ] [/ table 1D_plot Required parameter]
 
 [table 1D_plot Deduced parameter
-[[ID] [Type] [Description] [Default]]
-[[_fill_color] [`svg_color`] [Color that shows *inside the circle* being drawn.] [white]]
+[[ID] [Type] [Description] [Default] [Default]]
+[[fill_color] [`svg_color`] [Color that shows *inside the circle* being drawn.] [white]]
 ] [/ table 1D_plot Deduced parameter]
 
 [table 1D_plot Optional Parameters
-[[ID] [Type] [Description] [Default]]
-[[_stroke_color] [`svg_color`] [Outline of the circle that is being drawn.] [black] ]
-[[_point_style] [`point_shape`] [Shape of the point. Options currently are: [^none], [^circle], and [^square].] [circle]]
-[[_size] [`unsigned int`] [Height/width of the circle and square.] [10]]
-[[_x_functor] [*] [A class or functor that contains a conversion function. You will not have to worry about this, unless you are trying to plot a container of type that does not have a conversion to double, for example, age of a user-defined type `humans`. For example:
+[[ID] [Type] [Description] [Default] [Default]]
+[[stroke_color] [`svg_color`] [Outline of the circle that is being drawn.] [black] ]
+[[point_style] [`point_shape`] [Shape of the point. Options currently are: [^none], [^circle], and [^square].] [circle]]
+[[size] [`unsigned int`] [Height/width of the circle and square.] [10]]
+[[x_functor] [*] [A class or functor that contains a conversion function. You will not have to worry about this, unless you are trying to plot a container of type that does not have a conversion to double, for example, age of a user-defined type `humans`. For example:
 ``
 class my_functor
 {
@@ -119,37 +124,51 @@
 
 [section:svg_2d_plot_interface `svg_2d_plot` Public Interface]
 [table 2D_plot Miscellaneous
- [[Signature] [Description]]
+ [[Signature] [Description] [Default (if any)]]
   [[`svg_2d_plot()`] [See the defaults section for further details.]]
- [[`svg_2d_plot& image_size(unsigned int, unsigned int)`] [Sets the size (pixels) of the plot image produced.]]
- [[`svg_2d_plot& title(const std::string&)`] [Sets the string to be used for the title.]]
- [[`svg_2d_plot& title_font_size(unsigned int)`] [Sets the font size for the title.]]
- [[`svg_2d_plot& legend_title_font_size(unsigned int)`] [Sets the font size for the legend title.]]
+ [[`svg_2d_plot& image_size(unsigned int, unsigned int)`] [Sets the size (pixels) of the plot image produced.] [500, 400]]
+ [[`svg_2d_plot& title(const std::string&)`] [Sets the string to be used for the title.] [Null string.]]
+ [[`svg_2d_plot& title_font_size(unsigned int)`] [Sets the font size for the title.] [16]]
+ [[`svg_2d_plot& legend_title_font_size(unsigned int)`] [Sets the font size for the legend title.] [14]]
+
  ] [/ table 2D_plot Miscellaneous]
 
-[table 2D_plot Commands
+[table 2D_plot On/Off Switches
   [[Signature] [Description]]
- [[`svg_2d_plot& axis_on(bool)`] [Sets whether the axis is on (true) or off.]]
- [[`svg_2d_plot& legend_on(bool)`] [Sets whether the legend is on (true) or off.]]
- [[`svg_2d_plot& plot_window_on(bool)`] [Sets whether the plot will be displayed in its own window, or will be "full screen" in the image.]]
- [[`svg_2d_plot& title_on(bool)`] [Determines whether or not the image title is displayed.]]
- [[`svg_2d_plot& x_label_on(bool)`] [Sets whether or not the X axis label will show.]]
- [[`svg_2d_plot& x_major_grid_on(bool)`] [Determines whether or not the major grid on the X axis will be displayed.]]
+ [[`svg_2d_plot& axes_on(bool)`] [If *both* X & Y axes drawn.] [true]]
+ [[`svg_2d_plot& x_axis_on(bool)`] [Set if X-axis drawn.] [true]]
+ [[`svg_2d_plot& y_axis_on(bool)`] [Set if Y-axis drawn.] [true]]
+ [[`svg_2d_plot& legend_on(bool)`] [Sets if the legend box is shown.] [true]]
+ [[`svg_2d_plot& plot_window_on(bool)`] [Sets if the plot window border will be drawn.] [true]
+ [[`svg_2d_plot& title_on(bool)`] [Sets if image title is displayed.] [true]]
+ [[`svg_2d_plot& title_color(svg_color)`] [Sets color for title.] [true]]
+ [[`svg_2d_plot& x_label_on(bool)`] [Sets if X axis label is displayed.] [true]]
+ [[`svg_2d_plot& x_major_grid_on(bool)`] [Determines whether or not the major grid on the X axis will be displayed.] [false]]
   [[`svg_2d_plot& x_major_labels_on(int)`] [Sets if and how the major ticks will be labelled on the x axis.
-< 0 means down (default), 0 (false) means none, > 0 means to top)]]
- [[`svg_2d_plot& x_minor_grid_on(bool)`] [Determines whether or not the minor grid on the X axis will be displayed.]]
- [[`svg_2d_plot& y_label_on(bool)`] [Sets whether or not the Y axis label will show.]]
- [[`svg_2d_plot& y_major_grid_on(bool)`] [Determines whether or not the major grid on the Y axis will be displayed.]]
+< 0 means down (default), 0 (false) means none, > 0 means to top)] [down]]
+ [[`svg_2d_plot& x_minor_grid_on(bool)`] [Sets if the minor grid on the X axis will be displayed.] [false]]
+ [[`svg_2d_plot& y_label_on(bool)`] [Sets whether or not the Y axis label will show.] [true]]
+ [[`svg_2d_plot& y_major_grid_on(bool)`] [Sets if the major grid on the Y axis will be displayed.] [false]]
   [[`svg_2d_plot& y_major_labels_on(int)`] [sets if and how the major ticks will be labelled on the Y axis.
- < 0 means to left (default), 0 (false) means none, > 0 means to right.]]
- [[`svg_2d_plot& y_minor_grid_on(bool)`] [Determines whether or not the minor grid on the Y axis will be displayed.]]
- [[`svg_2d_plot& x_value_precision(int)`] [Determines the iostream precison for value labels on the X axis major ticks will be displayed. Default is 3 (rather than the iostream default of 6).]]
- [[`svg_2d_plot& x_value_ioflags(int)`] [Determines the iostream flags for value labels on the X axis major ticks will be displayed. Default is std::ios::dec. This allows fine control of the value labels using, for example (ios::dec | ios::scientific), or (ios::dec | ios::fixed), particularly in conjunction with precision.]]
- [[`svg_2d_plot& y_value_precision(int)`] [Determines the iostream precison for value labels on the Y axis major ticks will be displayed. Default is 3 (rather than the iostream default of 6).]]
- [[`svg_2d_plot& y_value_ioflags(int)`] [Determines the iostream flags for value labels on the Y axis major ticks will be displayed. Default is std::ios::dec. This allows fine control of the value labels using, for example (ios::dec | ios::scientific), or (ios::dec | ios::fixed), particularly in conjunction with precision.]]
- [[`svg_2d_plot& `y_major_label_rotation(int)] [Determines the direction of writing of value labels from the Y axis ticks. `enum rotate_style` provides control is 45 degree steps. The default is horizontal.
+ < 0 means to left (default), 0 (false) means none, > 0 means to right.] [left]]
+ [[`svg_2d_plot& y_minor_grid_on(bool)`] [Sets if the minor grid on the Y axis will be displayed.] [false]]
   
- ``enum rotate_style { // Rotation in degrees from horizontal. horizontal = 0, // normal left to right.
+ [[`svg_2d_plot& x_label_on(bool)`] [Sets the label string for the X-axis.] ]
+ [[`svg_2d_plot& x_label_on()`] [Returns if to show the label string for the X-axis.] ]
+ [[`svg_2d_plot& y_label_on(bool)`] [Sets to show the label string for the Y-axis.] ]
+ [[`svg_2d_plot& y_label_on()`] [Returns if to show the label string for the Y-axis.] ]
+
+ [[`svg_2d_plot& x_major_labels_on(int)`] [Sets if to show the value labels for the X-axis. < 0 means to down (default), 0 (false) means none, > 0 means to top] ]
+ [[`svg_2d_plot& y_major_labels_on(int)`] [Sets if to show the value labels for the Y-axis. < 0 means to left(default), 0 (false) means none, > 0 means to right ] ]
+
+
+ [[`svg_2d_plot& x_value_precision(int)`] [Sets the iostream precison for value labels on the X axis major ticks will be displayed. Default is 3 (rather than the iostream default of 6).]]
+ [[`svg_2d_plot& x_value_ioflags(int)`] [Sets the iostream flags for value labels on the X axis major ticks will be displayed. Default is std::ios::dec. This allows fine control of the value labels using, for example (ios::dec | ios::scientific), or (ios::dec | ios::fixed), particularly in conjunction with precision.]]
+ [[`svg_2d_plot& y_value_precision(int)`] [Sets the iostream precison for value labels on the Y axis major ticks will be displayed. Default is 3 (rather than the iostream default of 6).]]
+ [[`svg_2d_plot& y_value_ioflags(int)`] [Sets the iostream flags for value labels on the Y axis major ticks will be displayed. Default is std::ios::dec. This allows fine control of the value labels using, for example (ios::dec | ios::scientific), or (ios::dec | ios::fixed), particularly in conjunction with precision.]]
+ [[`svg_2d_plot& x_major_label_rotation`(int)] [Sets the direction of writing of value labels from the X axis ticks. `enum rotate_style` provides control is 45 degree steps. Default is horizontal.
+ ``enum rotate_style
+ { // Rotation in degrees from horizontal. horizontal = 0, // normal left to right.
       uphill = -45, // slope up.
       upward = -90, // vertical writing up.
       backup = -135, // slope up backwards.
@@ -157,78 +176,118 @@
       downward = 90, // vertical writing down.
       backdown = 135, // slope down backwards.
       upsidedown = 180 // == -180
- };
- ``
-
+ };``
   ]]
- [[`svg_2d_plot& `x_major_value_labels_on(int)`] [Determines if label values for X major ticks, and direction: -1 = bottom, 0 = *no* value labels, +1 = top. Default -1, bottom of plot window.]]
- [[`svg_2d_plot& `y_major_value_labels_on(int)`] [Determines if label values for Y major ticks, and direction: -1 = left, 0 = *no* value labels, +1 = right. Default -1, left of plot window.]]
- [[`svg_2d_plot& `x_ticks_on_plot_window_on(int)`] [Determines the position of Y axis of value labels & ticks: -1 = left, 0 = on Y-axis, +1 = right. Default -1, left of plot window.]]
- [[`svg_2d_plot& `y_ticks_on_plot_window_on(int)`] [Determines the position of X axis of value labels & ticks: -1 = bottom, 0 = on X-axis, +1 = top. Default -1, bottom of plot window.]]
- [[`svg_2d_plot& `x_label_strip_e0s(bool)`] [Determines whether or not the X axis value labels for major ticks are stripped of redundant zero(s), e or E, and + sign. This can markedly reduce visual clutter, for example, reducing "1.2e+000" to "1.2".]]
- [[`svg_2d_plot& `y_label_strip_e0s(bool)`] [Determines whether or not the Y axis value labels for major ticks are stripped of redundant zero(s), e or E, and + sign. This can markedly reduce visual clutter, for example, reducing "1.2e+000" to "1.2".]]
+ [[`svg_2d_plot& y_major_label_rotation(int)`] [Determines the direction of writing of value labels from the Y axis ticks. `enum rotate_style` provides control is 45 degree steps.] [Horizontal]]
+
+ [[`svg_2d_plot& `x_major_value_labels_on(int)`] [If label values for X major ticks, and direction: -1 = bottom, 0 = *no* value labels, +1 = top. Default -1, bottom of plot window.] [bottom]]
+ [[`svg_2d_plot& `y_major_value_labels_on(int)`] [If label values for Y major ticks, and direction: -1 = left, 0 = *no* value labels, +1 = right. Default -1, left of plot window.] [left]]
+ [[`svg_2d_plot& `x_ticks_on_plot_window_on(int)`] [Position of Y axis of value labels & ticks: -1 = left, 0 = on Y-axis, +1 = right. Default -1, left of plot window.] [bottom]]
+ [[`svg_2d_plot& `y_ticks_on_plot_window_on(int)`] [Position of X axis of value labels & ticks: -1 = bottom, 0 = on X-axis, +1 = top. Default -1, bottom of plot window.][left]]
+ [[`svg_2d_plot& `x_label_strip_e0s(bool)`] [If X axis value labels for major ticks are stripped of redundant zero(s), e or E, and + sign. This can markedly reduce visual clutter, for example, reducing "1.2e+000" to "1.2".] [true]]
+ [[`svg_2d_plot& `y_label_strip_e0s(bool)`] [If Y axis value labels for major ticks are stripped of redundant zero(s), e or E, and + sign. This can markedly reduce visual clutter, for example, reducing "1.2e+000" to "1.2".] [true]]
+ [[`svg_2d_plot& `x_axis_width(double)`] [Sets X axis line width.] [2]]
+ [[`svg_2d_plot& `y_axis_width(double)`] [Sets Y axis line width.] [2]]
+ [[`svg_2d_plot& `x_axis_color(double)`] [Sets X axis line color.][black.]]
+ [[`svg_2d_plot& `y_axis_color(double)`] [Sets Y axis line color.] [black.]]
   
 ] [/ table 2D_plot Commands]
 
 [table 2D_plot Colors
- [[Signature] [Description]]
- [[`svg_2d_plot& title_color(const svg_color &col)`] [Set the plot title color.]]
- [[`svg_2d_plot& background_color(const svg_color &col)`] [Set the background color for the whole image.]]
- [[`svg_2d_plot& legend_background_color(const svg_color &col)`] [Set the background color for the legend as `col`, an RGB color.]]
- [[`svg_2d_plot& legend_border_color(const svg_color &col)`] [Set the border color for the legend as `col`, an RGB color.]]
- [[`svg_2d_plot& background_border_color(const svg_color &col)`] [Set the background border color for the legend as `col`, an RGB color.]]
- [[`svg_2d_plot& plot_background_color(const svg_color &col)`] [Set the color of the plot area. Note: this only goes into effect if plot_area(true) has been called.]]
- [[`svg_2d_plot& x_axis_color(const svg_color &col)`] [Sets the color of the lines that form the axis.]]
- [[`svg_2d_plot& x_label_color(const svg_color &col)`] [Sets the color of the labels that go along the X axis.]]
- [[`svg_2d_plot& x_major_tick_color(const svg_color &col)`] [Sets the color of the major ticks of the X-axis.]]
- [[`svg_2d_plot& x_major_grid_color(const svg_color &col)`] [Sets the color of the grid that runs perpindicular to the X axis]]
- [[`svg_2d_plot& x_minor_tick_color(const svg_color &col)`] [Sets the color of the minor ticks of the X-axis.]]
- [[`svg_2d_plot& y_axis_color(const svg_color &col)`] [Sets the color of the lines that form the Y axis.]]
- [[`svg_2d_plot& y_label_color(const svg_color &col)`] [Sets the color of the labels that go along the Y axis.]]
- [[`svg_2d_plot& y_major_tick_color(const svg_color &col)`] [Sets the color of the major ticks of the Y-axis.]]
- [[`svg_2d_plot& y_major_grid_color(const svg_color &col)`] [Sets the color of the grid that runs perpindicular to the Y axis.]]
- [[`svg_2d_plot& y_minor_tick_color(const svg_color &col)`] [Sets the color of the minor ticks of the Y-axis.]]
+ [[Signature] [Description] [Default]]
+ [[`svg_2d_plot& title_color(const svg_color &col)`] [Set the plot title color.] [black]]
+ [[`svg_2d_plot& background_color(const svg_color &col)`] [Set the background color for the whole image as `col`, an RGB color..] [white]]
+ [[`svg_2d_plot& legend_background_color(const svg_color &col)`] [Set the background color for the legend as `col`, an RGB color.] [white]]
+ [[`svg_2d_plot& legend_border_color(const svg_color &col)`] [Set the border color for the legend as `col`, an RGB color.] [black]]
+ [[`svg_2d_plot& legend_color(const svg_color &col)`] [Set the fill color for the legend as `col`, an RGB color.] [white]]
+ [[`svg_2d_plot& background_border_color(const svg_color &col)`] [Set the background border color for the legend as `col`, an RGB color.] [black]]
+ [[`svg_2d_plot& plot_background_color(const svg_color &col)`] [Set the fill color of the plot area.] [white]]
+ [[`svg_2d_plot& x_axis_color(const svg_color &col)`] [Sets the color of the lines that form the axis.] [black]]
+ [[`svg_2d_plot& x_label_color(const svg_color &col)`] [Sets the color of the labels that go along the X axis.] [black]]
+ [[`svg_2d_plot& x_major_grid_color(const svg_color &col)`] [Sets the color of the grid that runs perpindicular to the X axis] [cyan]]
+ [[`svg_2d_plot& x_major_tick_color(const svg_color &col)`] [Sets the color of the major ticks of the X-axis.] [black]]
+ [[`svg_2d_plot& x_minor_tick_color(const svg_color &col)`] [Sets the color of the minor ticks of the X-axis.] [black]]
+ [[`svg_2d_plot& y_axis_color(const svg_color &col)`] [Sets the color of the lines that form the Y axis.] [black]]
+ [[`svg_2d_plot& y_label_color(const svg_color &col)`] [Sets the color of the labels that go along the Y axis.] [black]]
+ [[`svg_2d_plot& y_major_grid_color(const svg_color &col)`] [Sets the color of the grid that runs perpendicular to the Y axis.] [cyan]]
+ [[`svg_2d_plot& y_major_tick_color(const svg_color &col)`] [Sets the color of the major ticks of the Y-axis.] [black]]
+ [[`svg_2d_plot& y_minor_tick_color(const svg_color &col)`] [Sets the color of the minor ticks of the Y-axis.] [black]]
   ]
 
 [table 2D_plot Axis Information
- [[Signature] [Description]]
- [[`svg_2d_plot& x_axis_width(unsigned int)`] [Sets the line or stroke width (pixels) of the X-axis.] ]
+ [[Signature] [Description] [Default]]
+ [[`svg_2d_plot& x_axis_width(double)`] [Sets the line or stroke width (pixels) of the X-axis.] [2]]
   [[`svg_2d_plot& x_label(const std::string&)`] [Sets the label of the X-axis. You must set `x_label(true)` to display the label.] ]
+ [[`svg_2d_plot& x_label_units(const std::string&)`] [Sets the units of label of the X-axis. You must set `x_label(true)` to display the label.] ]
+ [[`svg_2d_plot& x_label_font_family(const std::string& family)`] [Sets the font family for label of the X-axis. ] ]
+ [[`svg_2d_plot& x_label_font_size(double)`] [Sets the font size for label of the X-axis.] ]
   [[`svg_2d_plot& x_major_interval(double)`] [Sets the distance (Cartesian units) between ticks on the X-axis.] ]
   [[`svg_2d_plot& x_major_tick_length(int)`] [Sets the length (pixels) of the X-axis major ticks.] ]
- [[`svg_2d_plot& x_major_tick_width(unsigned int)`] [Sets the width (pixels) of the major ticks on the X-axis.] ]
- [[`svg_2d_plot& x_minor_tick(unsigned int)`] [Sets the length (pixels) of the X-axis minor ticks.] ]
+ [[`svg_2d_plot& x_major_tick_width(double)`] [Sets the width (pixels) of the major ticks on the X-axis.] ]
+ [[`svg_2d_plot& x_minor_tick(double)`] [Sets the length (pixels) of the X-axis minor ticks.] ]
   [[`svg_2d_plot& x_minor_tick_length(int)`] [Sets the length (pixels) of the X-axis minor tick lengths.] ]
- [[`svg_2d_plot& x_minor_tick_width(unsigned int)`] [Sets the width (pixels) of the minor ticks on the X-axis.] ]
+ [[`svg_2d_plot& x_minor_tick_width(double)`] [Sets the width (pixels) of the minor ticks on the X-axis.] ]
+ [[`svg_2d_plot& x_major_grid_width(double)`] [Sets the width (pixels) of the grid on the X axis.] ]
   [[`svg_2d_plot& x_num_minor_ticks(int)`] [Sets the number of minor ticks between each major tick.] ]
   [[`svg_2d_plot& x_range(double x1, double x2)`] [Sets the scale of the x axis from x1 to x2. Throws an exception if x2 <= x1.] ]
- [[`svg_2d_plot& y_axis_width(unsigned int)`] [Sets the stroke width of the X-axis.] ]
+ [[`svg_2d_plot& x_min(double x)`] [Sets the minimum scale of the x axis. Cannot check that x_min <= x_max!] ]
+ [[`svg_2d_plot& x_max(double x)`] [Sets the maximum scale of the x axis. Cannot check that x_min <= x_max!] ]
+
+ [[`svg_2d_plot& y_axis_width(double)`] [Sets the stroke width of the X-axis.] ]
   [[`svg_2d_plot& y_label(const std::string&)`] [Sets the label of the Y-axis. You must set `x_label(true)` to display the label.] ]
+ [[`svg_2d_plot& y_label_units(const std::string&)`] [Sets the units of label of the Y-axis. You must set `y_label(true)` to display the label.] ]
+ [[`svg_2d_plot& y_label_font_family(const std::string& family)`] [Sets the font family for label of the Y-axis. ] ]
+ [[`svg_2d_plot& y_label_font_size(double)`] [Sets the font size for label of the Y-axis.] ]
   [[`svg_2d_plot& y_major_tick(double)`] [Sets the distance (in Cartesian units) between ticks on the Y axis] ]
   [[`svg_2d_plot& y_major_tick_length(int)`] [Sets the length (pixels) of the Y axis major ticks.] ]
- [[`svg_2d_plot& y_major_tick_width(unsigned int)`] [Sets the width (pixels) of the major ticks on the Y axis.] ]
- [[`svg_2d_plot& y_minor_tick(unsigned int)`] [Sets the length (pixels) of the Y axis minor ticks.] ]
+ [[`svg_2d_plot& y_major_tick_width(double)`] [Sets the width (pixels) of the major ticks on the Y axis.] ]
+ [[`svg_2d_plot& y_minor_tick(double)`] [Sets the length (pixels) of the Y axis minor ticks.] ]
   [[`svg_2d_plot& y_major_tick_length(int)`] [Sets the length (pixels) of the Y axis minor tick lengths.] ]
- [[`svg_2d_plot& y_minor_tick_width(unsigned int)`] [Sets the width (pixels) of the minor ticks on the Y axis.] ]
+ [[`svg_2d_plot& y_major_grid_width(double)`] [Sets the width (pixels) of the grid on the Y axis.] ]
+ [[`svg_2d_plot& y_minor_tick_width(double)`] [Sets the width (pixels) of the minor ticks on the Y axis.] ]
   [[`svg_2d_plot& y_num_minor_ticks(int)`] [Sets the number of minor ticks between each major tick.] ]
   [[`svg_2d_plot& y_scale(double y1, double y2)`] [Sets the scale of the Y axis from y1 to y2. Throws an exception if y2 <= y1.] ]
-]
+ [[`svg_2d_plot& y_min(double x)`] [Sets the minimum scale of the Y axis. Cannot check that y_min <= y_max!] ]
+ [[`svg_2d_plot& y_max(double x)`] [Sets the maximum scale of the Y axis. Cannot check that y_min <= y_max!] ]
+ [[`svg_2d_plot& data_lines_width(double width)`] [Sets the width of lines joining data points. [2] ]
+] [/ table 2D_plot Axis Information]
 
-Accessor get functions are also provided for all the above set functions.
+
+Accessor get functions having the same name and returning the same type are also provided
+for all the above set functions.
 These allow one to check the current value
-(default if not changed by the preceeding code).
+(returning default if not changed by the preceeding code).
+
+For example, after a call of
+
+ my_plot.y_num_minor_ticks(9); // Chose 9 minor ticks between y major ticks.
+
+ my_plot.y_num_minor_ticks() == 9
+
+The function show_2d_settings displayed *all* the settings from accessors below.
+
+[table 2D_plot Accessor functions
+ [[`axis_line_style& x_axis()`] [returns reference to X axis_line_style.] ]
+ [[`axis_line_style& y_axis()`] [returns reference to Y axis_line_style.] ]
+ [[`ticks_labels_style& x_ticks()`] [returns reference to X ticks_labels_style.] ]
+ [[`ticks_labels_style& y_ticks()`] [returns reference to Y ticks_labels_style.] ]
+ [[`std::string x_label()`] [Returns string labelling the X-axis.] ]
+ [[`std::string y_label()`] [Returns string labelling the Y-axis.] ]
+ [[`std::string x_label_units()`] [Returns string labelling units of the X-axis.] ]
+ [[`std::string y_label_units()`] [Returns string labelling units of the Y-axis.] ]
+ ] [/table 2D_plot Accessor functions]
+
 
 [heading The `plot()` Method]
-The `plot()` method is defined using Boost.Parameter. As such, it supports a
-few extra named parameters, as well as a deduced parameter.
+The `plot()` method supports two parameters & some chained functions.
 
-[table 2D_plot Required parameter
+[table 2D_plot Required Parameter
 [[ID] [Type (* is a wildcard)] [Description]]
-[[_container] [*] [Any object that can return an iterator with begin() and end().]]
-[[_title] [`std::string`] [The name of this series.]]
+[[container] [*] [Any object that can return an iterator with begin() and end().]]
+[[title] [`std::string`] [The name of this series.]]
 ] [/ table 2D_plot Required parameter]
 
-[table 2D_plot Deduced parameter
+[table 2D_plotChained Functions
 [[ID] [Type] [Description] [Default]]
 [[fill_color] [`svg_color`] [This is the color that shows inside of the circle that is
 being drawn.] [white]]
@@ -236,14 +295,14 @@
 
 [table 2D_plot Optional Parameters
 [[ID] [Type] [Description] [Default]]
-[[_bezier_on] [`bool`] [ This determines whether or not Bézier curve interpolation will be applied to the plot lines. It is important to note that the curve interpolation is still in its infancy, and should only be used with reasonably nice data sets]]
-[[_line_on] [`bool`] [ This determines whether or not there are lines drawn between data points.] [false]]
-[[_line_color] [`bool`] [ This determines the color of the lines between data points.] [black ]]
-[[_area_fill_color] [`svg_color`][Defining this enables the "Fill Area Under Axis" feature. the color you define will be the fill color between a line and the area under the axis. This only takes effect if `_line_on = true` is called.]]
-[[_stroke_color] [`svg_color`] [The outline of the circle that is being drawn.] [black] ]
-[[_point_style] [`point_shape`] [This is the shape of the point. Options currently are between [^none], [^circle], and [^square].] [circle]]
-[[_size] [`unsigned int`] [This is the height/width of the circle and square.] [10]]
-[[_x_functor] [*] [A class or that contains a conversion function. You will not have to worry about this, unless you are trying to accomplish stuff like plotting a vector of humans. For example:
+[[bezier_on] [`bool`] [ Sets if Bézier curve interpolation will be applied to the plot lines. It is important to note that the curve interpolation will produce artefacts if data is 'ill-behaved' with discontinuities.] [false]]
+[[line_on] [`bool`] [ Sets if lines are drawn between data points.] [false]]
+[[line_color] [`bool`] [ This determines the color of the lines between data points.] [black ]]
+[[area_fill_color] [`svg_color`][Enables the 'Fill Area Under Axis' feature. The color will be the fill color between a line and the area under the axis. This only takes effect if `line_on() == true`.] [grey]]
+[[stroke_color] [`svg_color`] [The outline of the circle that is being drawn.] [black] ]
+[[point_style] [`shape`] [Shape marking the data point. Examples are: [^none], [^circle], and [^square].] [circle]]
+[[size] [`unsigned int`] [This is the height/width of the point.] [10]]
+[[x_functor] [*] [A class or that contains a conversion function. You will not have to worry about this unless you are trying to do plot a type that does not convert to double, for example, like plotting a vector of humans:
 ``
 class my_functor
 {
@@ -251,7 +310,7 @@
 
   pair<double, double> operator()(const human& _hum) const
   {
- return pair<double, double>(i, _hum.age());
+ return pair<double, double>(i, _hum.age()); // age *is* a double.
   }
 }
 
@@ -259,9 +318,10 @@
 
 plot(my_plot, my_data, "People", _x_functor = my_functor());
 ``
-][
-`boost_default_2d_convert` (the default) is sufficient in all cases where the data stored in
-the container can be directly cast to a double.]]
+]
+[`boost_default_2d_convert` (the default) is sufficient in all cases where the data stored in
+the container can be directly cast to a double.] ]
+
 ] [/ table 2D_plot Optional Parameters]
 
 Here are some examples of correct uses:
@@ -364,7 +424,7 @@
 [`boost_default_convert` (default) is sufficient in all cases where the data stored in the container can be directly cast to a double.]]
 ] [/ table Optional Functions]
 
-[h4 Styles providing addition control]
+[h4 Styles - provide Additional Control]
 
 Several style classes are used internally but are available for external use too.
 For most applications the functions listed above will provide enough control,
@@ -378,16 +438,17 @@
   class ticks_labels_style; // Parameters of the axis, grids, & ticks and their value labels.
 
 [h6 Box Style defines a rectangular box.]
-A box has a border and may be filled with the same or different colors.
+A box has a border and may be filled with the same or a different color.
 
   class box_style
   { // Style of a rectangular box.
- // Use for image and plot window.
+ // Use for image, legend & plot window.
   public:
       svg_color stroke_; // Box line stroke color.
       svg_color fill_; // Box fill color.
       double width_; // plot border rectangle width.
- double margin_; // Marginal (svg units) space around the box (inside or out).
+ double margin_; // Marginal (svg units) space inside or around the box,
+ // used to avoid writing or drawing too near the box border.
       bool border_on_; // Display the border.
       bool fill_on_; // Color fill the box.
 
@@ -408,35 +469,36 @@
 
 [table Box Style Constructor
 [[parameter #] [name] [Default] [Description]]
-[[1] [scolor] [black] [stroke color of the border of the rectangle.]]
+[[1] [scolor] [black] [Stroke color of the border of the rectangle.]]
 [[2] [fcolor] [white] [Fill color of the rectangle.]]
-[[3] [width] [1] [Width the svg units of border]]
+[[3] [width] [1] [Width of border(svg units).]]
 [[4] [margin] [2] [Margin provided to avoid text etc being too close to the border, or the border colliding with other rectangles.]]
-[[4] [border_on] [true (border drawn)] [if true, the a border is drawn.]]
-[[5] [fill_on] [false (not filled)] [if true, fill color drawn inside border, if any.]]
+[[4] [border_on] [true (border drawn)] [If true, then a border is drawn.]]
+[[5] [fill_on] [false (not filled)] [If true, fill color drawn inside border (if any).]]
 ] [/ table Box Style]
 
 [table Box Style Accessor functions (all are chainable).
 [[name] [parameter type] [Default value] [Description] [Examples]]
-[[scolor] [svg_color] [black] [Sets color of border of box] [my_box.scolor(red); my_box.scolor();]]
-[[fcolor] [svg_color] [white] [Sets fill color of box] [my_box.fcolor(red); my_box.fcolor();]]
+[[scolor] [svg_color] [black] [Sets color of border of box.] [my_box.scolor(red); my_box.scolor();]]
+[[fcolor] [svg_color] [white] [Sets fill color of box.] [my_box.fcolor(red); my_box.fcolor();]]
 [[width] [real_type] [1 svg unit] [Sets width of border.] [my_box.width(2); my_box.width()]]
 [[margin] [real_type] [1 svg unit] [Sets margin around border (inside and out).] [my_box.width(2); my_box.width()]]
 [[border_on] [bool] [true] [If true, draws a border of box.] [my_box.border_on(true); my_box.border();]]
 [[fill_on] [bool] [false] [If true, color fills the box.] [my_box.fill_on(true); my_box.fill();]]
 ] [/table Box style Accessor functions]
 
-[h6 Text Style defines text Font, Size etc.]
+[h6 Text Style defines Font, Size, Style (& stretch, weight, decoration).]
 
 Text style constructor.
 
   text_style(int size = 20,
   const std::string& font = "", // Default is sans with Firefox & IE, but serif with Opera.
- const std::string& style = "",
- const std::string& weight = "",
- const std::string& stretch = "",
- const std::string& decoration = "")
- : // Constructor.
+ const std::string& style = "", // italic, bold.
+ // Functions not yet implemented by most browsers.
+ const std::string& stretch = "", // wider, narrower.
+ const std::string& weight = "", // lighter, bolder.
+ const std::string& decoration = "" // underline, overline, strike-thru.
+ ) : // Constructor.
   font_size_(size),
     font_family_(font),
     style_(style),
@@ -501,11 +563,11 @@
     }
     
 [table Plot Point Style Constructor
-[[parameter #] [name] [Default] [Description]]
+[[Parameter #] [Name] [Default] [Description]]
 [[1] [fill] [blank] [SVG fill color.]]
 [[2] [stroke] [blank] [SVG stroke color.]]
 [[3] [size] [10] [size of marker (svg units).]]
-[[4] [shape] [round] [shape in enum point_shape]
+[[4] [shape] [round] [shape in enum point_shape]]
 [[5] [symbol(s)] ["X"] [Unicode symbol(s) (letters, digits, squiggles etc)]]
 ] [/ table Plot point Style]
 
@@ -546,12 +608,12 @@
     // Other shapes may be added.
   };
 
-[table Plot Point Style Accessor functions
+[table Plot Point Style Accessor Functions
 [[name] [parameter type] [Default value] [Description] [Examples]]
-[[size] [int] [10] [Sets size of point marker or font in svg units] [my_mark.size(10); my_mark.font_size();]]
-[[fill_color] [svg_color] [none] [Sets fill color] [my_mark.fill_color(red); my_mark.fill_color();]]
+[[size] [int] [10] [Sets size of point marker or font in svg units.] [my_mark.size(10); my_mark.font_size();]]
+[[fill_color] [svg_color] [none] [Sets fill color.] [my_mark.fill_color(red); my_mark.fill_color();]]
 [[stroke_color] [black] [""] [Sets stroke color for mark.] [my_mark.stroke_color(green); my_mark.stroke_color()]]
-[[shape] [point_shape] [none] [Sets plot point marker] [my_mark.shape(egg); my_mark.shape()]]
+[[shape] [point_shape] [none] [Sets plot point marker.] [my_mark.shape(egg); my_mark.shape()]]
 [[symbols] [std::string] ["X"] [Sets symbol as plot point marker.] [my_mark.symbols("&#x3A9;"); (greek omega) my_mark.symbols();]]
 [[style] [svg::text_style] ["Lucida Sans Unicode" with plot_point size.] [Set font and size for a symbol marking points.] [my_mark.style(my_symbol_style); my_mark.style();]]
 ] [/table Plot Point style Accessor functions]
@@ -574,13 +636,13 @@
       }
 
     
-[table Plot line Style Constructor
+[table Plot Line Style Constructor
 [[parameter #] [name] [Default] [Description]]
-[[1] [color] [black] [line color (SVG stroke color).]]
-[[2] [area_fill] [blank] [area_fill color (if required).]]
-[[3] [width] [2] [width of line (svg units).]]
-[[4] [line_on] [true] [true if straight line required.]
-[[5] [bezier_on] [false] [true if bezier smoothed line required.]]
+[[1] [color] [black] [Line color (SVG stroke color).]]
+[[2] [area_fill] [blank] [Area fill color (if required).]]
+[[3] [width] [2] [Width of line (svg units).]]
+[[4] [line_on] [true] [If straight line joins data points.]
+[[5] [bezier_on] [false] [If bezier smoothed line joins data points.]]
 ] [/ table Plot Line Style]
 
 Examples:

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/svg_interface.qbk
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/svg_interface.qbk (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/svg_interface.qbk 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -129,26 +129,6 @@
   [[`void write(std::ostream&)`] [Writes the document to the stream represented by the argument.][]]
 ] [/table `svg` document settings and writing]
 
-[table `tspan` attributes
- [[Signature] [Description] [Notes & Examples]]
- [[`tspan_element(const std::string&, const text_style&)`][Constructor. Adds the text and an optional style][]]
- [[`tspan_element& text(const std::string&)`][Changes the text to the member function input][<tspan>Text goes here</tspan>]]
- [[`tspan_element& dx(double)`][The "change in x" attribute][]]
- [[`tspan_element& dy(double)`][The "change in y" attribute][]]
- [[`tspan_element& rotation(int)`][Currently, this is broken and only rotates the first character of the string.][]]
- [[`tspan_element& x(double)`][The "position of x" attribute][]]
- [[`tspan_element& y(double)`][The "position of y" attribute][]]
- [[`tspan_element& text_length(double)`][Allows the absolute maximum length of the text to be defined][]]
- [[`double dx()`][The getter for the "change in x" attribute][]]
- [[`double dy()`][The getter for the "change in y" attribute][]]
- [[`int rotation()`][The getter for the rotation function.][]]
- [[`double x()`][The getter for the "position of x" attribute][]]
- [[`double y()`][The getter for the "position of y" attribute][]]
- [[`std::string text()`][Getter for the text][<tspan>Text goes here</tspan>]]
- [[`text_style& font_style()`][Allows access to the font style][]]
- [[`const text_style& font_style()`][`const` access to the font style][]]
- [[`void write(std::ostream&)`][Outputs the text of the element into the stream][]]
-]
 [endsect] [/section:svg_interface]
 
 

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/example/demo_2d_simple.cpp
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/example/demo_2d_simple.cpp (original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/example/demo_2d_simple.cpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
@@ -87,16 +87,20 @@
 
   // Add the data series to the plot:
   my_plot.title("demo_2d_simple");
- my_plot.title(" more title");
- cout << my_plot.title() << endl;
+ my_plot.title(" title");
+ cout << " my_plot.title() " << my_plot.title() << endl;
+ my_plot.x_label("X-axis");
+ my_plot.y_label("Y-axis");
 
   std::string s = my_plot.title();
 
   my_plot.plot(data1, "Sqrt(x)").fill_color(red);
         my_plot.plot(data2, "-2 + x^2").fill_color(orange).size(5);
         my_plot.plot(data3, "-1 + 2x").fill_color(yellow).bezier_on(true).line_color(blue).shape(square);
+ cout << " my_plot.title() " << my_plot.title() << endl;
 
   my_plot.write("./demo_2d_simple.svg");
+ cout << " my_plot.title() " << my_plot.title() << endl;
 
   show_plot_settings(my_plot);
 

Deleted: sandbox/SOC/2007/visualization/libs/svg_plot/example/math_special_functions.cpp
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/example/math_special_functions.cpp 2008-02-18 14:53:04 EST (Mon, 18 Feb 2008)
+++ (empty file)
@@ -1,441 +0,0 @@
-// JM_Specials.cpp
-
-// Copyright John Maddock 2007
-// Copyright Paul A. Bristow 2007
-
-// Use, modification and distribution are subject to the
-// Boost Software License, Version 1.0.
-// (See accompanying file LICENSE_1_0.txt
-// or copy at http://www.boost.org/LICENSE_1_0.txt)
-
-#ifdef _MSC_VER
-# pragma warning (disable : 4800) // forcing value to bool 'true' or 'false' (performance warning)
-# pragma warning (disable : 4180) // qualifier applied to function type has no meaning; ignored
-# pragma warning (disable : 4224) // nonstandard extension used : formal parameter 'function_ptr' was previously defined as a type
-//# pragma warning (disable : 4267) // conversion from 'size_t' to 'const unsigned int', possible loss of data
-# pragma warning (disable : 4127) // conditional expression is constant
-# pragma warning (disable : 4512) // assignment operator could not be generated (in fusion)
-# pragma warning (disable : 4503) // decorated name length exceeded, name was truncated
-# pragma warning (disable : 4180) // qualifier applied to function type has no meaning; ignored
-# pragma warning (disable : 4267) // conversion from 'size_t' to 'const unsigned int', possible loss of data
-//# pragma warning (disable : 4172) // returning address of local variable or temporary
-#endif
-
-#include <boost/math/special_functions.hpp>
-#include <boost/math/tools/roots.hpp>
-#include <boost/function.hpp>
-#include <boost/bind.hpp>
-#include <boost/svg_plot/svg_2d_plot.hpp>
-#include <boost/svg_plot/show_2d_settings.hpp>
-// Only needed for showing which settings in use.
-
-#include <list>
-#include <map>
-#include <string>
-
-
-class function_arity1_plotter
-{
-public:
- function_arity1_plotter() : m_min_x(0), m_max_x(0), m_min_y(0), m_max_y(0), m_has_legend(false) {}
-
- void add(boost::function<double(double)> f, double a, double b, const std::string& name)
- {
- if(name.size())
- m_has_legend = true;
- //
- // Now set our x-axis limits:
- //
- if(m_max_x == m_min_x)
- {
- m_max_x = b;
- m_min_x = a;
- }
- else
- {
- if(a < m_min_x)
- m_min_x = a;
- if(b > m_max_x)
- m_max_x = b;
- }
- m_points.push_back(std::pair<std::string, std::map<double,double> >(name, std::map<double,double>()));
- std::map<double,double>& points = m_points.rbegin()->second;
- double interval = (b - a) / 200;
- for(double x = a; x <= b; x += interval)
- {
- //
- // Evaluate the function, set the Y axis limits
- // if needed and then store the pair of points:
- //
- double y = f(x);
- if((m_min_y == m_max_y) && (m_min_y == 0))
- m_min_y = m_max_y = y;
- if(m_min_y > y)
- m_min_y = y;
- if(m_max_y < y)
- m_max_y = y;
- points[x] = y;
- }
- }
-
- void add(const std::map<double, double>& m, const std::string& name)
- {
- if(name.size())
- m_has_legend = true;
- m_points.push_back(std::pair<std::string, std::map<double,double> >(name, m));
- std::map<double, double>::const_iterator i = m.begin();
-
- while(i != m.end())
- {
- if((m_min_x == m_min_y) && (m_min_y == 0))
- {
- m_min_x = m_max_x = i->first;
- }
- if(i->first < m_min_x)
- {
- m_min_x = i->first;
- }
- if(i->first > m_max_x)
- {
- m_max_x = i->first;
- }
-
- if((m_min_y == m_max_y) && (m_min_y == 0))
- {
- m_min_y = m_max_y = i->second;
- }
- if(i->second < m_min_y)
- {
- m_min_y = i->second;
- }
- if(i->second > m_max_y)
- {
- m_max_y = i->second;
- }
- ++i;
- }
- } // add
-
- void plot(const std::string& title, const std::string& file,
- const std::string& x_lable = std::string(),
- const std::string& y_lable = std::string())
- {
- using namespace boost::svg;
-
- static const svg_color colors[5] =
- {
- darkblue,
- darkred,
- darkgreen,
- darkorange,
- chartreuse
- };
-
- svg_2d_plot plot;
- plot.image_size(600, 400);
- plot.copyright_holder("John Maddock").copyright_date("2008").boost_license_on(true);
- plot.coord_precision(4); // Ciould be 3 for smaller plots.
- plot.title(title).legend_title_font_size(15).title_on(true);
- plot.legend_on(m_has_legend);
- //plot.legend_place(outside_right);
-
- plot
- .x_major_value_labels_side(-1).y_major_value_labels_side(-1) // left and bottom
- .x_label_units_on(false).y_label_units_on(false);
- double x_delta = (m_max_x - m_min_x) / 50;
- double y_delta = (m_max_y - m_min_y) / 50;
- plot.x_range(m_min_x - x_delta, m_max_x + x_delta)
- .y_range(m_min_y - y_delta, m_max_y + y_delta);
- plot.x_label_on(true).x_label(x_lable);
- plot.y_label_on(true).y_label(y_lable);
- plot.y_major_grid_on(false).x_major_grid_on(false);
- plot.x_num_minor_ticks(3);
- plot.y_num_minor_ticks(3);
- //
- // Work out axis tick intervals:
- double l = std::floor(std::log10((m_max_x - m_min_x) / 10) + 0.5);
- double interval = std::pow(10.0, (int)l);
- if(((m_max_x - m_min_x) / interval) > 10)
- {
- interval *= 5;
- }
- plot.x_major_interval(interval);
- l = std::floor(std::log10((m_max_y - m_min_y) / 10) + 0.5);
- interval = std::pow(10.0, (int)l);
- if(((m_max_y - m_min_y) / interval) > 10)
- {
- interval *= 5;
- }
- plot.y_major_interval(interval);
- plot.plot_window_on(true).plot_border_color(floralwhite); //
-
- int color_index = 0;
-
- for(std::list<std::pair<std::string, std::map<double,double> > >::const_iterator i = m_points.begin();
- i != m_points.end(); ++i)
- {
- plot.plot(i->second, i->first)
- .shape(none)
- .line_on(true)
- //.bezier(true)
- .line_color(colors[color_index]);
-
- if(i->first.size())
- {
- ++color_index;
- }
- color_index = color_index % (sizeof(colors)/sizeof(colors[0]));
- }
- plot.write(file);
- show_plot_settings(plot);
- }
-
- void clear()
- {
- m_points.clear();
- m_min_x = m_min_y = m_max_x = m_max_y = 0;
- m_has_legend = false;
- }
-
-private:
- std::list<std::pair<std::string, std::map<double, double> > > m_points;
- double m_min_x, m_max_x, m_min_y, m_max_y;
- bool m_has_legend;
-};
-
-struct location_finder
-{
- location_finder(double(*_f)(double), double t, double x0) : f(_f), target(t), x_off(x0){}
-
- double operator()(double x)
- {
- try
- {
- return f(x + x_off) - target;
- }
- catch(const std::overflow_error&)
- {
- return boost::math::tools::max_value<double>();
- }
- catch(const std::domain_error&)
- {
- if(x + x_off == x_off)
- return f(x_off + boost::math::tools::epsilon<double>() * x_off);
- throw;
- }
- }
-
-private:
- double(*f)(double);
- double target;
- double x_off;
-};
-
-double find_end_point(double (*f)(double), double x0, double target, bool rising, double x_off = 0)
-{
- boost::math::tools::eps_tolerance<double> tol(50);
- boost::uintmax_t max_iter = 1000;
- return boost::math::tools::bracket_and_solve_root(
- location_finder(f, target, x_off),
- x0,
- double(1.5),
- rising,
- tol,
- max_iter).first;
-}
-
-double sqrt1pm1(double x)
-{
- return boost::math::sqrt1pm1(x);
-}
-
-double lbeta(double a, double b)
-{
- return std::log(boost::math::beta(a, b));
-}
-
-int main()
-{
- function_arity1_plotter plot;
- double (*f)(double);
- double (*f2)(double, double);
-
- f = boost::math::zeta;
- plot.add(f, 1.01, 20, "");
- plot.add(f, -20, 0.99, "");
- plot.plot("Zeta Function Over [-20,20]", "zeta1.svg", "z", "zeta(z)");
-
- plot.clear();
- plot.add(f, -14, 0, "");
- plot.plot("Zeta Function Over [-14,0.5]", "zeta2.svg", "z", "zeta(z)");
-
- f = boost::math::tgamma;
- double max_val = f(6);
- plot.clear();
- plot.add(f, find_end_point(f, 0.1, max_val, false), 6, "");
- plot.add(f, -1 + find_end_point(f, 0.1, -max_val, true, -1), find_end_point(f, -0.1, -max_val, false), "");
- plot.add(f, -2 + find_end_point(f, 0.1, max_val, false, -2), -1 + find_end_point(f, -0.1, max_val, true, -1), "");
- plot.add(f, -3 + find_end_point(f, 0.1, -max_val, true, -3), -2 + find_end_point(f, -0.1, -max_val, false, -2), "");
- plot.add(f, -4 + find_end_point(f, 0.1, max_val, false, -4), -3 + find_end_point(f, -0.1, max_val, true, -3), "");
- plot.plot("tgamma", "tgamma.svg", "z", "tgamma(z)");
-
- f = boost::math::lgamma;
- max_val = f(10);
- plot.clear();
- plot.add(f, find_end_point(f, 0.1, max_val, false), 10, "");
- plot.add(f, -1 + find_end_point(f, 0.1, max_val, false, -1), find_end_point(f, -0.1, max_val, true), "");
- plot.add(f, -2 + find_end_point(f, 0.1, max_val, false, -2), -1 + find_end_point(f, -0.1, max_val, true, -1), "");
- plot.add(f, -3 + find_end_point(f, 0.1, max_val, false, -3), -2 + find_end_point(f, -0.1, max_val, true, -2), "");
- plot.add(f, -4 + find_end_point(f, 0.1, max_val, false, -4), -3 + find_end_point(f, -0.1, max_val, true, -3), "");
- plot.add(f, -5 + find_end_point(f, 0.1, max_val, false, -5), -4 + find_end_point(f, -0.1, max_val, true, -4), "");
- plot.plot("lgamma", "lgamma.svg", "z", "lgamma(z)");
-
- f = boost::math::digamma;
- max_val = 10;
- plot.clear();
- plot.add(f, find_end_point(f, 0.1, -max_val, true), 10, "");
- plot.add(f, -1 + find_end_point(f, 0.1, -max_val, true, -1), find_end_point(f, -0.1, max_val, true), "");
- plot.add(f, -2 + find_end_point(f, 0.1, -max_val, true, -2), -1 + find_end_point(f, -0.1, max_val, true, -1), "");
- plot.add(f, -3 + find_end_point(f, 0.1, -max_val, true, -3), -2 + find_end_point(f, -0.1, max_val, true, -2), "");
- plot.add(f, -4 + find_end_point(f, 0.1, -max_val, true, -4), -3 + find_end_point(f, -0.1, max_val, true, -3), "");
- plot.plot("digamma", "digamma.svg", "z", "digamma(z)");
-
- f = boost::math::erf;
- plot.clear();
- plot.add(f, -3, 3, "");
- plot.plot("erf", "erf.svg", "z", "erf(z)");
- f = boost::math::erfc;
- plot.clear();
- plot.add(f, -3, 3, "");
- plot.plot("erfc", "erfc.svg", "z", "erfc(z)");
-
- f = boost::math::erf_inv;
- plot.clear();
- plot.add(f, -1 + find_end_point(f, 0.1, -3, true, -1), 1 + find_end_point(f, -0.1, 3, true, 1), "");
- plot.plot("erf_inv", "erf_inv.svg", "z", "erf_inv(z)");
- f = boost::math::erfc_inv;
- plot.clear();
- plot.add(f, find_end_point(f, 0.1, 3, false), 2 + find_end_point(f, -0.1, -3, false, 2), "");
- plot.plot("erfc_inv", "erfc_inv.svg", "z", "erfc_inv(z)");
-
- f = boost::math::log1p;
- plot.clear();
- plot.add(f, -1 + find_end_point(f, 0.1, -10, true, -1), 10, "");
- plot.plot("log1p", "log1p.svg", "z", "log1p(z)");
-
- f = boost::math::expm1;
- plot.clear();
- plot.add(f, -4, 2, "");
- plot.plot("expm1", "expm1.svg", "z", "expm1(z)");
-
- f = boost::math::cbrt;
- plot.clear();
- plot.add(f, -10, 10, "");
- plot.plot("cbrt", "cbrt.svg", "z", "cbrt(z)");
-
- f = sqrt1pm1;
- plot.clear();
- plot.add(f, -1 + find_end_point(f, 0.1, -10, true, -1), 5, "");
- plot.plot("sqrt1pm1", "sqrt1pm1.svg", "z", "sqrt1pm1(z)");
-
- f = boost::math::sinc_pi;
- plot.clear();
- plot.add(f, -10, 10, "");
- plot.plot("sinc_pi", "sinc_pi.svg", "z", "sinc_pi(z)");
-
- f = boost::math::sinhc_pi;
- plot.clear();
- plot.add(f, -5, 5, "");
- plot.plot("sinhc_pi", "sinhc_pi.svg", "z", "sinhc_pi(z)");
-
- f = boost::math::acosh;
- plot.clear();
- plot.add(f, 1, 10, "");
- plot.plot("acosh", "acosh.svg", "z", "acosh(z)");
-
- f = boost::math::asinh;
- plot.clear();
- plot.add(f, -10, 10, "");
- plot.plot("asinh", "asinh.svg", "z", "asinh(z)");
-
- f = boost::math::atanh;
- plot.clear();
- plot.add(f, -1 + find_end_point(f, 0.1, -5, true, -1), 1 + find_end_point(f, -0.1, 5, true, 1), "");
- plot.plot("atanh", "atanh.svg", "z", "atanh(z)");
-
- f2 = boost::math::tgamma_delta_ratio;
- plot.clear();
- plot.add(boost::bind(f2, _1, -0.5), 1, 40, "delta = -0.5");
- plot.add(boost::bind(f2, _1, -0.2), 1, 40, "delta = -0.2");
- plot.add(boost::bind(f2, _1, -0.1), 1, 40, "delta = -0.1");
- plot.add(boost::bind(f2, _1, 0.1), 1, 40, "delta = 0.1");
- plot.add(boost::bind(f2, _1, 0.2), 1, 40, "delta = 0.2");
- plot.add(boost::bind(f2, _1, 0.5), 1, 40, "delta = 0.5");
- plot.add(boost::bind(f2, _1, 1.0), 1, 40, "delta = 1.0");
- plot.plot("tgamma_delta_ratio", "tgamma_delta_ratio.svg", "z", "tgamma_delta_ratio(delta, z)");
-
- f2 = boost::math::gamma_p;
- plot.clear();
- plot.add(boost::bind(f2, 0.5, _1), 0, 20, "a = 0.5");
- plot.add(boost::bind(f2, 1.0, _1), 0, 20, "a = 1.0");
- plot.add(boost::bind(f2, 5.0, _1), 0, 20, "a = 5.0");
- plot.add(boost::bind(f2, 10.0, _1), 0, 20, "a = 10.0");
- plot.plot("gamma_p", "gamma_p.svg", "z", "gamma_p(a, z)");
-
- f2 = boost::math::gamma_q;
- plot.clear();
- plot.add(boost::bind(f2, 0.5, _1), 0, 20, "a = 0.5");
- plot.add(boost::bind(f2, 1.0, _1), 0, 20, "a = 1.0");
- plot.add(boost::bind(f2, 5.0, _1), 0, 20, "a = 5.0");
- plot.add(boost::bind(f2, 10.0, _1), 0, 20, "a = 10.0");
- plot.plot("gamma_q", "gamma_q.svg", "z", "gamma_q(a, z)");
-
- f2 = lbeta;
- plot.clear();
- plot.add(boost::bind(f2, 0.5, _1), 0.00001, 5, "a = 0.5");
- plot.add(boost::bind(f2, 1.0, _1), 0.00001, 5, "a = 1.0");
- plot.add(boost::bind(f2, 5.0, _1), 0.00001, 5, "a = 5.0");
- plot.add(boost::bind(f2, 10.0, _1), 0.00001, 5, "a = 10.0");
- plot.plot("beta", "beta.svg", "z", "log(beta(a, z))");
-
- /*
- std::list<std::pair<double, double> > circle;
- for(double x = -2; x <= 2; x += 0.1)
- {
- circle.push_back(std::make_pair(x, -sqrt(4 - x * x)));
- }
- for(double x = 2; x >= -2; x -= 0.1)
- {
- circle.push_back(std::make_pair(x, sqrt(4 - x * x)));
- }
-
- boost::svg::svg_2d_plot surface;
- surface.image_size(600, 400);
- surface.title_font_size(20);
- surface.legend_title_font_size(15);
- surface.title("Circle");
- surface.legend_on(false).title_on(true);
- surface.x_major_value_labels_side(true).y_major_value_labels_side(true);
- surface.x_range(-2.2, 2.2)
- .y_range(-2.2, 2.2);
- surface.x_label_on(true).x_label("x");
- surface.y_label_on(true).y_label("y");
- surface.y_major_grid_on(false).x_major_grid_on(false);
- surface.x_num_minor_ticks(3);
- surface.y_num_minor_ticks(3);
- surface.x_major_interval(0.5);
- surface.y_major_interval(0.5);
- surface.plot_window_on(false);
-
-
- using namespace boost::svg;
-
- surface.plot(circle, "",
- //_bezier_on = true,
- _line_on = true,
- _point_style = none);
- surface.write("circle.svg");
- */
-
- return 0;
-}


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk