Subject: [Boost-commit] svn:boost r80135 - in sandbox/SOC/2007/visualization/boost/svg_plot: . detail
From: pbristow_at_[hidden]
Date: 2012-08-22 04:58:17
Author: pbristow
Date: 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
New Revision: 80135
URL: http://svn.boost.org/trac/boost/changeset/80135
Log:
Update.
Properties modified:
sandbox/SOC/2007/visualization/boost/svg_plot/ (props changed)
Text files modified:
sandbox/SOC/2007/visualization/boost/svg_plot/detail/auto_axes.hpp | 19
sandbox/SOC/2007/visualization/boost/svg_plot/detail/axis_plot_frame.hpp | 3835 ++++-----------------------------------
sandbox/SOC/2007/visualization/boost/svg_plot/detail/functors.hpp | 113
sandbox/SOC/2007/visualization/boost/svg_plot/detail/numeric_limits_handling.hpp | 23
sandbox/SOC/2007/visualization/boost/svg_plot/detail/pair.hpp | 35
sandbox/SOC/2007/visualization/boost/svg_plot/detail/svg_tag.hpp | 9
sandbox/SOC/2007/visualization/boost/svg_plot/show_1d_settings.hpp | 13
sandbox/SOC/2007/visualization/boost/svg_plot/show_2d_settings.hpp | 56
sandbox/SOC/2007/visualization/boost/svg_plot/svg.hpp | 15
sandbox/SOC/2007/visualization/boost/svg_plot/svg_1d_plot.hpp | 810 -------
sandbox/SOC/2007/visualization/boost/svg_plot/svg_2d_plot.hpp | 151 +
sandbox/SOC/2007/visualization/boost/svg_plot/svg_boxplot.hpp | 26
sandbox/SOC/2007/visualization/boost/svg_plot/svg_style.hpp | 96
13 files changed, 841 insertions(+), 4360 deletions(-)
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/auto_axes.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/auto_axes.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/auto_axes.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -28,6 +28,7 @@
#endif
#include <boost\svg_plot\detail\FP_compare.hpp> // is_small & is_close
+#include <boost/quan/meas.hpp> // for value_of.
#include <boost\math\special_functions\fpclassify.hpp>
// for template <class FPT> bool boost::math::isfinite(FPT t);
@@ -281,12 +282,14 @@
double x_max;
if (!check_limits)
{
+ //std::pair<T::iterator, T::iterator> result = boost::minmax_element(container.begin(), container.end());
std::pair<T::const_iterator, T::const_iterator> result = boost::minmax_element(container.begin(), container.end());
// minmax_element is efficient because can use knowledge of being sorted,
// BUT only if it can be assumed that no values are 'at limits',
// infinity, NaN, max_value, min_value, denorm_min.
- x_min = value_of(*(result.first));
- x_max = value_of(*(result.second));
+
+ x_min = value_of(*(result.first));
+ x_max = value_of(*(result.second));
}
else
{ // It is necessary to inspect all values individually.
@@ -345,11 +348,11 @@
{ // BUT only if it can be assumed that no values are 'at limits',
// infinity, NaN, max_value, min_value, denorm_min.
// minmax_element is efficient for maps because it can use knowledge of all maps being sorted,
- // And also sadly it doesn't work right - Y minimum is wrong!
- // TODO
+ // And also sadly it doesn't work right - Y minimum is wrong! // TODO ??
+
std::pair<T::const_iterator, T::const_iterator> result = boost::minmax_element(container.begin(), container.end());
- std::pair<const double, double> px = values_of(*result.first); // x min & y_min
- std::pair<const double, double> py = values_of(*result.second); // y min & max
+ std::pair<double, double> px = values_of(*result.first); // X min & X max.
+ std::pair<double, double> py = values_of(*result.second); // Y min & Y max.
x_min = px.first;
x_max = py.first;
// x are OK, but Y are only those corresponding to those X, not min and max.,
@@ -662,7 +665,7 @@
template <typename T> // T an STL container: array, vector ...
size_t show(const T& container)
-{ //! Utility functios to display STL containers.
+{ //! Utility functions to display STL containers.
cout << container.size() << " values in container: ";
for (T::const_iterator it = container.begin(); it != container.end(); it++)
{
@@ -710,7 +713,7 @@
minmax.first = *result.first;
minmax.second = *result.second;
return minmax;
-} // template <class T> scale
+} // template <class T> range
template <class T> // T an STL container: array, vector, set, map ...
std::pair<double, double> range_all(const T& containers) // Container of STL containers of Data series.
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -6,7 +6,7 @@
*/
// Copyright Jacob Voytko 2007
-// Copyright Paul A. Bristow 2007, 2008, 2009
+// Copyright Paul A. Bristow 2007, 2008, 2009, 2012
// Use, modification and distribution are subject to the
// Boost Software License, Version 1.0.
@@ -25,8 +25,9 @@
// template <class T>bool isfinite (T);
// template <class T>bool isinf (T);
// template <class T> bool isnan (T);
-#include <boost/svg_plot/uncertain.hpp>
+#include <boost/quan/unc.hpp>
// using boost::svg::unc;
+#include <boost/quan/meas.hpp>
#include <limits>
#include <string>
@@ -37,6 +38,8 @@
//using std::cout;
//using std::endl;
+#include <sstream>
+//using std::ostream;
#include <utility>
// using std::pair
@@ -47,8 +50,11 @@
// JV: G++ can't resolve names in these enums in axis_plot_frame
// when they are in svg_2d_plot.hpp
+ //static const double text_plusminus = 2.; /*!< Number of standard deviations used for text_plusminus text display.\n
+ //Nominal factor of 2 (strictly 1.96) corresponds to 95% confidence limit. */
+
static const double sin45 = 0.707; //!< Use to calculate 'length' if axis value labels are sloping.
- static const double reducer = 0.9; //!< To make uncertainty and degrees of freedom estimates a bit smaller font to help distinguish from value.
+ static const double reducer = 0.9; //!< To make std_dev and degrees of freedom estimates a bit smaller font to help distinguish from value.
// x_axis_position_ and y_axis_position_ use x_axis_intersect & y_axis_intersect
enum x_axis_intersect
@@ -90,1602 +96,39 @@
// We don't use the SVG coordinate transform because then text would
// be flipped. Might use it to scale the image for resizes.
- // Protected Member Functions Declarations (defined below):
+ // Protected (?) Member Functions Declarations (defined below):
- // void transform_point(double &x, double &y); // Scale & shift both X & Y to graph Cartesian coordinates.
- // void transform_x(double &x); // Scale & shift both X to graph Cartesian coordinates.
- // void transform_y(double &y); // Scale & shift both Y to graph Cartesian coordinates.
- // void draw_x_minor_tick(double j, path_element& tick_path, path_element& grid_path); // (& grid).
- // void draw_x_major_tick(double i, path_element& tick_path, path_element& grid_path); // (& grid).
- // void draw_x_axis();
- // void draw_legend();
- // void draw_title();
- // void adjust_limits(double& x, double& y);
- // void draw_plot_point(double x, double y, g_element& g_ptr, const plot_point_style& sty);
- // void draw_plot_point_value(double x, double y, g_element& g_ptr, value_style& val_style, plot_point_style& point_style, unc uvalue);
- // void draw_plot_point_values(double x, double y, g_element& x_g_ptr, g_element& y_g_ptr, const value_style& x_sty, const value_style& y_sty, unc uncx, unc uncy);
+ void transform_point(double &x, double &y); // Scale & shift both X & Y to graph Cartesian coordinates.
+ void transform_x(double &x); // Scale & shift both X to graph Cartesian coordinates.
+ void transform_y(double &y); // Scale & shift both Y to graph Cartesian coordinates.
+ void draw_x_minor_tick(double j, path_element& tick_path, path_element& grid_path); // (& grid).
+ void draw_x_major_tick(double i, path_element& tick_path, path_element& grid_path); // (& grid).
+ void draw_x_axis();
+ void draw_legend();
+ void size_legend_box();
+ void place_legend_box();
+ void draw_title();
+ void adjust_limits(double& x, double& y);
+ void draw_x_axis_label();
+ void draw_plot_point(double x, double y, g_element& g_ptr, const plot_point_style& sty);
+ void draw_plot_point(double x, double y, g_element& g_ptr, plot_point_style& sty, unc<false> ux, unc<false> uy);
+ void draw_plot_point_value(double x, double y, g_element& g_ptr, value_style& val_style, plot_point_style& point_style, Meas uvalue);
+ void draw_plot_point_values(double x, double y, g_element& x_g_ptr, g_element& y_g_ptr, const value_style& x_sty, const value_style& y_sty, Meas uncx, Meas uncy);
+ void draw_plot_point_values(double x, double y, g_element& x_g_ptr, g_element& y_g_ptr, const value_style& x_sty, const value_style& y_sty, Meas uncx, unc<false> uncy);
// Clear functions.
- // void clear_all(); // Calls all the other clear_* functions.
- // void clear_legend();
- // void clear_background();
- // void clear_x_axis();
- // void clear_y_axis();
- // void clear_title();
- // void clear_points();
- // void clear_plot_background();
- // void clear_grids();
-
- // Protected Member Functions Definitions:
-
- void transform_point(double& x, double& y)
- { //! Scale & shift both X & Y to graph Cartesian coordinates.
- x = derived().x_scale_ * x + derived().x_shift_;
- y = derived().y_scale_ * y + derived().y_shift_;
- adjust_limits(x, y); // In case either hits max, min, infinity or NaN.
- }
- // TODO do we need to adjust_limit(x); // In case hits max, min, infinity or NaN?
- // This implies that user's choice of X-axis range is wrong?
- // So more drastic action like throwing might be least worst action?
-
- void transform_x(double& x)
- { //! Scale and shift X value only.
- x = derived().x_scale_ * x + derived().x_shift_;
- }
-
- void transform_y(double& y)
- { //! Scale and shift Y value only.
- y = derived().y_scale_ * y + derived().y_shift_;
- }
-
- void draw_x_minor_tick(double value, path_element& tick_path, path_element& grid_path)
- { //! Draw X-axis minor ticks, and optional grid. (Value is NOT (yet) shown beside the minor tick).
- double x(value); // Tick position and tick value label,
- transform_x(x); // Convert to svg.
- double y_bottom(0.); // Start on the horizontal X-axis line.
- double y_top(derived().image_.y_size()); // Image top.
-
- // Draw the minor grid, if wanted.
- if(derived().x_ticks_.minor_grid_on_)
- {
- if(!derived().plot_window_on_)
- { // Use whole image.
- // Make space for title and X-axis labels.
- if(derived().title_on_)
- { // Allow text_margin_ * font_size around text (pixels).
- y_bottom += derived().title_info_.textstyle().font_size() * derived().text_margin_;
- }
- if(derived().x_axis_.label_on_)
- {
- y_top -= derived().x_label_info_.textstyle().font_size() * derived().text_margin_;
- }
- }
- else
- { // plot_window_on_ == true.
- y_bottom = derived().plot_top_ + derived().plot_window_border_.width_; // Top.
- y_top = derived().plot_bottom_ - derived().plot_window_border_.width_; // Bottom. Ensure *inside* window.
- }
- // Make sure that we are drawing inside the allowed window.
- if((x >= derived().plot_left_) && (x <= derived().plot_right_)) // allow = too?
- {
- //std::cerr << "Writing draw_x_minor_tick grid inside plot window: x = "
- // << x << ", plot_left_ = " << derived().plot_left_ << ", plot_right_ = " << derived().plot_right_ << std::endl;
- grid_path.M(x, y_bottom).L(x, y_top); // Draw grid line.
- }
- else
- { // This will happen but is designed to be ignored!
- // See comment in draw_x_axis
- // std::cerr << "Writing draw_x_minor_tick grid OUTside plot window: x = "
- // << x << ", plot_left_ = " << derived().plot_left_ << ", plot_right_ = " << derived().plot_right_ << std::endl;
- }
- } // x_minor_grid
-
- // Draw x minor ticks.
- if (derived().x_ticks_.ticks_on_window_or_on_axis_ < 0)
- { // Put minor ticks on the plot window border bottom.
- y_bottom = derived().plot_bottom_; // on the window line.
- y_top = derived().plot_bottom_; // y_bottom = upper, y_top = lower end of tick.
- }
- else if (derived().x_ticks_.ticks_on_window_or_on_axis_ > 0)
- { // Put minor ticks on the plot window border top.
- y_bottom = derived().plot_top_; // on the window line.
- y_top = derived().plot_top_; // y_bottom = upper, y_top = lower end of tick.
- }
- else // derived().x_ticks_.ticks_on_window_or_on_axis_ == 0
- { // Internal style, draw tick up and/or down from the X-axis line.
- y_bottom = derived().x_axis_.axis_; // ON X-axis horizontal line.
- y_top = derived().x_axis_.axis_;
- }
- if(derived().x_ticks_.up_ticks_on_)
- {
- y_bottom -= derived().x_ticks_.minor_tick_length_; // up
- }
- if (derived().x_ticks_.down_ticks_on_)
- {
- y_top += derived().x_ticks_.minor_tick_length_; // down.
- }
- // Make sure that we are drawing inside the allowed window.
- if((x >= derived().plot_left_) && (x <= derived().plot_right_)) // TODO allow < or <=
- {
- tick_path.M(x, y_bottom).L(x, y_top);
- // No value labels on minor ticks, at present.
- }
- else
- { // This will happen but is designed to be ignored!
- // See comment in draw_x_axis
- //std::cerr << "Writing draw_x_minor_tick OUTside plot window: x = "
- // << x << ", plot_left_ = " << derived().plot_left_ << ", plot_right_ = " << derived().plot_right_ << std::endl;
- }
- } // void draw_x_minor_tick
-
- void draw_x_major_tick(double value, path_element& tick_path, path_element& grid_path)
- { //! Draw major ticks - and grid too if wanted.
- //! If major_value_labels_side then value shown beside the major tick.
- double x(value); //
- transform_x(x); // x value in svg.
- if((x < derived().plot_left_ - 0.01) || (x > derived().plot_right_ + 0.01))
- // Allow a bit extra to allow for round-off errors.
- { // tick value is way outside plot window, so nothing to do.
- //std::cout << derived().plot_left_ << ' '<< x << std::endl;
- // This *was* displayed for a plot.
- return;
- }
- double y_up(0.); // upper end of tick.
- double y_down(derived().image_.x_size()); // y_down = lower end of tick.
- if(derived().x_ticks_.major_grid_on_)
- { // Draw major grid vertical line.
- if(!derived().plot_window_on_)
- { // Allow a modest margin around text of title and X-axis labels, if in use.
- if(derived().title_on_)
- {
- y_up += derived().title_info_.textstyle().font_size() * derived().text_margin_;
- }
- if(derived().x_ticks_.major_value_labels_side_ != 0)
- { // Value may be shown either side the major tick.
- y_down -= derived().x_label_info_.textstyle().font_size() * derived().text_margin_;
- }
- }
- else
- { // plot_window_on_ == true
- y_up = derived().plot_top_; // Bottom of plot window.
- y_down = derived().plot_bottom_; // Top of plot window.
- }
- //if((y_down <= derived().plot_bottom_) && (y_up >= derived().plot_top_) && (x >= derived().plot_left_) && (x <= derived().plot_right_))
- //{ // Make sure that we are drawing inside the allowed window.
- grid_path.M(x, y_up).L(x, y_down); // Vertical grid line.
- //}
- } // use_x_major_grid
-
- // Draw major tick (perhaps as well as grid - ticks might be wider than grid).
- // Make sure that we are drawing inside the allowed plot window.
- //if((x >= derived().plot_left_) && (x <= derived().plot_right_)) // now <=
- //{ Removed these checks as round off causes trouble.
- double x_tick_length = derived().x_ticks_.major_tick_length_;
- if(derived().x_ticks_.ticks_on_window_or_on_axis_ < 0)
- { // Put the ticks on the plot window border (was external).
- y_up = derived().plot_bottom_; // on the window line.
- y_down = derived().plot_bottom_; // y_up = upper, y_down = lower.
- if(derived().x_ticks_.up_ticks_on_)
- {
- y_up -= x_tick_length; // up
- }
- if (derived().x_ticks_.down_ticks_on_)
- {
- y_down += x_tick_length; // down.
- }
- }
- else if(derived().x_ticks_.ticks_on_window_or_on_axis_ > 0)
- { // Put the ticks on the plot window border (was external).
- y_up = derived().plot_top_; // on the window line.
- y_down = derived().plot_top_; // y_up = upper, y_down = lower.
- if(derived().x_ticks_.up_ticks_on_)
- {
- y_up -= x_tick_length; // up
- }
- if (derived().x_ticks_.down_ticks_on_)
- {
- y_down += x_tick_length; // down.
- }
- }
- else
- { // Draw tick from the central X axis line (Internal_style).
- y_up = derived().x_axis_.axis_; // X-axis line.
- y_down = derived().x_axis_.axis_;
- if(derived().x_ticks_.up_ticks_on_)
- {
- y_up -= x_tick_length; // up
- }
- if (derived().x_ticks_.down_ticks_on_)
- {
- y_down += x_tick_length; // down.
- }
- }
- tick_path.M(x, y_up).L(x, y_down);
- // Leaving current position at the bottom end of the tick.
- // y_up and y-down are the ends of the tick.
- // These may be on the axis line, or the plot window.
-
- if(derived().x_ticks_.major_value_labels_side_ != 0)
- { // Show a value by the horizontal X-axis tick as "1.2" or "3.4e+000"...
- std::stringstream tick_value_label;
- tick_value_label.precision(derived().x_ticks_.value_precision_);
- tick_value_label.flags(derived().x_ticks_.value_ioflags_);
- tick_value_label << value; // for tick "4", "1.2" or "3.4e+000"...
- if (derived().x_ticks_.strip_e0s_)
- { // Remove unecessary e, +, leadings 0s.
- std::string v = strip_e0s(tick_value_label.str());
- tick_value_label.str(v);
- }
- double y = 0; // Where to start writing from, at end of bottom or top tick, if any.
- // = 0 is only to avoid unitialised warning.
- align_style alignment = center_align;
- // Adjustments to provide space from end of tick before or after writing label.
- if (derived().x_ticks_.label_rotation_ == upward) // vertical writing up.
- { // Shift to center value digits and minus sign on tick.
- x += derived().x_value_label_style_.font_size() * 0.2;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little below y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.6;
- alignment = right_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little above y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.5;
- alignment = left_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == downward)
- { // Should handle other directions too.
- x -= derived().x_value_label_style_.font_size() * 0.3;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little below y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.5;
- alignment = left_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little above y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.5;
- alignment = right_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == steepup)
- { // Should handle other directions too.
- x -= derived().x_value_label_style_.font_size() * 0.3;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels upward, so start a little below y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.5;
- alignment = left_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little above y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.5;
- alignment = right_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == uphill)
- { // Assume some 45 slope, so need about sqrt(2) less space.
- x += derived().x_value_label_style_.font_size() * 0.5;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little to bottom of y_bottom.
- y = y_down + derived().x_value_label_style_.font_size() * sin45;
- // Seems to need a bit more space for top than bottom if rotated.
- alignment = right_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little to top of y_top.
- y = y_up - derived().x_value_label_style_.font_size() * 0.3;
- alignment = left_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == slopeup)
- { // Assume for 30 degree slope, need about sqrt(2) less space.
- x += derived().x_value_label_style_.font_size() * 0.5;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little to bottom of y_bottom.
- y = y_down + derived().x_value_label_style_.font_size() * sin45;
- // Seems to need a bit more space for top than bottom if rotated.
- alignment = right_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little to top of y_top.
- y = y_up - derived().x_value_label_style_.font_size() * 0.2;
- alignment = left_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == downhill)
- { // Assume some 45 slope, so need about sqrt(2) less space.
- x -= derived().x_value_label_style_.font_size() * 0.3;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little to bottom of y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.7;
- // Seems to need a bit more space for top than bottom if rotated.
- alignment = left_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little to top of y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.3;
- alignment = right_align;
- }
- }
- else if (derived().x_ticks_.label_rotation_ == slopedownhill)
- { // Assume some 30 slope, so need about sqrt(2) less space.
- x -= derived().x_value_label_style_.font_size() * 0.3;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little to bottom of y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.7;
- // Seems to need a bit more space for top than bottom if rotated.
- alignment = left_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little to top of y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.3;
- alignment = right_align;
- }
- }
-
-
- else if (derived().x_ticks_.label_rotation_ == steepdown)
- { // Should handle other directions too.
- x -= derived().x_value_label_style_.font_size() * 0.3;
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom, so start a little below y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 0.5;
- alignment = left_align;
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little above y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.5;
- alignment = right_align;
- }
- }
-
- else if (derived().x_ticks_.label_rotation_ == horizontal)
- { // Tick value label on X-axis is normal default horizontal.
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // labels to bottom of tick, so start a little below bottom of y_down.
- y = y_down + derived().x_value_label_style_.font_size() * 1.3; // 1.3 allows 1/3 font space.
- alignment = center_align; // center on the tick.
- }
- else if(derived().x_ticks_.major_value_labels_side_ > 0)
- { // labels to top, so start a little to top of y_up.
- y = y_up - derived().x_value_label_style_.font_size() * 0.7;
- alignment = center_align;
- }
- }
- else
- { // upsidedown, backup... - can't see any conceivable use for these.
- return; // Others not yet implemented.
- } // rotations
- if (x <= 0)
- { // Sanity checks on svg coordinates.
- throw std::runtime_error("X-tick X value wrong!");
- }
- if (y <= 0)
- {
- throw std::runtime_error("X-tick Y value wrong!");
- }
- // Draw the X ticks value labels, "1", "2" "3" ...
- if(derived().x_ticks_.ticks_on_window_or_on_axis_ != 0)
- { // External to plot window style bottom or top.
- // Always want all values including "0", if labeling external to plot window.
- // x_ticks_.ticks_on_window_or_on_axis_ == true != 0
- derived().image_.g(detail::PLOT_X_TICKS_VALUES).text(
- x,
- y,
- tick_value_label.str(),
- derived().x_value_label_info_.textstyle(), // font, size etc
- alignment, derived().x_ticks_.label_rotation_);
- }
- else
- {
- if ((value != 0) && derived().x_axis_.axis_line_on_)
- { // Avoid a "0" below the X-axis if it would be cut through by any internal vertical Y-axis line.
- derived().image_.g(detail::PLOT_X_TICKS_VALUES).text(
- x,
- y,
- tick_value_label.str(),
- derived().x_value_label_info_.textstyle(), // font, size etc
- alignment,
- derived().x_ticks_.label_rotation_);
- }
- } // on plot window or 'on axis'.
- }
- else
- { // Outside plot window - so do nothing? Warning?
- //std::cerr << "Writing draw_x_major_tick OUTside plot window: "
- // "x = " << x << ", plot_left_ = " << derived().plot_left_ << ", plot_right_ = " << derived().plot_right_ << std::endl;
- }
- } // draw_x_major_tick
-
- void draw_x_axis()
- { //! Draw horizontal X-axis line & plot window line to hold, and ticks and grids.
- if(derived().x_axis_.axis_line_on_)
- { // Want a horizontal X-axis line drawn.
- double xleft = derived().plot_left_;
- double xright = derived().plot_right_;
- if (derived().x_axis_position_ == x_intersects_y)
- { // Draw the horizontal X-axis line the full width of the plot window,
- // perhaps including an addition in lieu of a major tick.
- if (derived().y_ticks_.left_ticks_on_)
- {
- if (derived().y_ticks_.ticks_on_window_or_on_axis_ < 0) // left
- { // Extend the horizontal line left in lieu of longest tick.
- xleft -= (std::max)(derived().y_ticks_.minor_tick_length_, derived().y_ticks_.major_tick_length_);
- }
- }
- else if (derived().y_ticks_.right_ticks_on_)
- {
- if (derived().y_ticks_.ticks_on_window_or_on_axis_ > 0) // right
- { // Extend the horizontal line right in lieu of longest tick.
- xright += (std::max)(derived().y_ticks_.minor_tick_length_, derived().y_ticks_.major_tick_length_);
- }
- }
- double y = derived().x_axis_.axis_; // y = 0, (provided y range includes zero).
- derived().image_.g(PLOT_X_AXIS).line(xleft, y, xright, y);
- if (derived().x_ticks_.ticks_on_window_or_on_axis_ < 0) // bottom
- { // Draw a vertical line holding the ticks on the top of plot window.
- derived().image_.g(PLOT_X_AXIS).line(xleft, derived().plot_bottom_, xright, derived().plot_bottom_);
- }
- else if (derived().x_ticks_.ticks_on_window_or_on_axis_ > 0) // top
- {// Draw a vertical line holding the ticks on the bottom of plot window.
- derived().image_.g(PLOT_X_AXIS).line(xleft, derived().plot_top_, xright, derived().plot_top_);
- }
- }
- else if (derived().x_axis_position_ == top)
- {
- derived().image_.g(PLOT_X_AXIS).line(xleft, derived().plot_top_, xright, derived().plot_top_);
- }
- else if (derived().x_axis_position_ == bottom)
- {
- derived().image_.g(PLOT_X_AXIS).line(xleft, derived().plot_bottom_, xright, derived().plot_bottom_);
- }
- else
- { // warn that things have gone wrong?
- }
- } // x_axis_.axis_line_on_
-
- // Access the paths for the ticks & grids, ready for additions.
- path_element& minor_tick_path = derived().image_.g(PLOT_X_MINOR_TICKS).path();
- path_element& major_tick_path = derived().image_.g(PLOT_X_MAJOR_TICKS).path();
- path_element& minor_grid_path = derived().image_.g(PLOT_X_MINOR_GRID).path();
- path_element& major_grid_path = derived().image_.g(PLOT_X_MAJOR_GRID).path();
-
- // x_minor_jump is the interval between minor ticks.
- double x_minor_jump = derived().x_ticks_.major_interval_ /
- (derived().x_ticks_.num_minor_ticks_ + 1.);
-
- // Draw the ticks on the positive side (right of zero).
- for(double x = 0.; x <= derived().x_axis_.max_; x += derived().x_ticks_.major_interval_)
- {
- for(double j = x + x_minor_jump;
- j < (x + derived().x_ticks_.major_interval_) * (1. - 2 * std::numeric_limits<double>::epsilon());
- j += x_minor_jump)
- // Reduce test value by a few bits to avoid accumulated rounding error
- // that intermittently puts minor ticks *at same value as* major ticks.
- { // This will output 'orphaned' minor ticks that are beyond the plot window,
- // if the last major tick does not coincide with the plot window.
- // These are just ignored in draw_x_minor_tick.
- // There might be 9 of them, so
- // if you have the common 9 minor tick between major ticks!
- // TODO this seems ugly - as does the negative ones below.
- draw_x_minor_tick(j, minor_tick_path, minor_grid_path);
- } // for j
- if ((x != 0. || !derived().y_axis_.axis_line_on_) || (derived().x_ticks_.ticks_on_window_or_on_axis_ != 0))
- { // Avoid a major tick at x == 0 where there *is* a vertical Y-axis line.
- // (won't be Y-axis line for 1-D where the zero tick is always wanted).
- draw_x_major_tick(x, major_tick_path, major_grid_path);
- }
- }
-
- // Draw the ticks on the negative side (left of zero).
- for(double x = 0.; x >= derived().x_axis_.min_; // ?? * (1. + 2 * std::numeric_limits<double>::epsilon());
- x -= derived().x_ticks_.major_interval_) // Want a close to test here?
- {
- // Draw minor ticks.
- for(double j = x - x_minor_jump;
- j > (x - derived().x_ticks_.major_interval_ + x_minor_jump) * (1. + 2 * std::numeric_limits<double>::epsilon());
- // Increase test value by a few bits to avoid accumulated rounding error
- // that intermittently puts minor ticks *at same value as* major ticks.
- j -= x_minor_jump)
- {
- if ((j != 0. || !derived().y_axis_.axis_line_on_) || (derived().x_ticks_.ticks_on_window_or_on_axis_ != 0))
- { // Avoid a minor tick at x == 0 where there *is* a vertical Y-axis line.
- // (won't be Y-axis line for 1-D where the zero tick is always wanted).
- // But no tick means no value label 0 either unless on_plot_window.
- draw_x_minor_tick(j, minor_tick_path, minor_grid_path);
- }
- }
- if ((x != 0. || !derived().y_axis_.axis_line_on_) || (derived().x_ticks_.ticks_on_window_or_on_axis_ != 0))
- { // Avoid a major tick at x == 0 where there *is* a vertical Y-axis line.
- // (won't be Y-axis line for 1-D where the zero tick is always wanted).
- // But no tick means no value label 0 either unless on_plot_window.
- draw_x_major_tick(x, major_tick_path, major_grid_path);
- }
- }
- } // void draw_x_axis()
-
- void draw_x_axis_label()
- { //! Draw the X-axis label text (for example, length),
- //! and append any optional units (for example, km).
- // X-label color default is set in constructor thus:
- // image_.g(detail::PLOT_X_LABEL).style().stroke_color(black);
- // and changed using x_label_color(color);
- // Similarly for font family and size etc (must be same for both label and units).
-
- std::string x_label = derived().x_label_info_.text(); // x_axis_ label, and optional units.
- if (derived().x_axis_.label_units_on_ && (derived().x_units_info_.text() != ""))
- { // Append the units, if any, user providing brackets () if required.
- x_label += derived().x_units_info_.text(); // for example: "time (sec)".
- }
-
- double y = derived().plot_bottom_;
- // Glyphs for western characters are aligned with the left bottom of capital letter,
- // so need to allow 1/3 more below for any descenders.
-
- // cout << "derived().x_ticks_.ticks_on_window_or_on_axis_ " << derived().x_ticks_.ticks_on_window_or_on_axis_ << endl;
- // using derived(0 means debugging doesn't work! So resort to old-fashioned print statements.
- if (derived().x_ticks_.ticks_on_window_or_on_axis_ < 0) // -1 means ticks on bottom of plot window.
- { // Ticks value labels below plot window.
- if (derived().x_ticks_.major_value_labels_side_ < 0) // bottom
- { // Shift down to allow for any tick value labels.
- if ((derived().x_ticks_.label_rotation_ == downward) || (derived().x_ticks_.label_rotation_ == upward))
- { // downward tick value label direction 90 up or down.
- y += derived().x_ticks_.label_max_space_;
- if (derived().x_ticks_.down_ticks_on_ == true)
- { // Move down for any downward ticks.
- y += 1.1 * (std::max)(derived().x_ticks_.major_tick_length_, derived().x_ticks_.minor_tick_length_); // And avoid macro max trap!
- // and a small space.
- y += 0.7 * (derived().x_label_info_.textstyle().font_size() + derived().x_value_label_info_.textstyle().font_size()); // best compromise?
- }
- }
- else if ((derived().x_ticks_.label_rotation_ == steepdown) || (derived().x_ticks_.label_rotation_ == steepup))
- { // downward tick value label direction 60 up or down.
- y += derived().x_ticks_.label_max_space_;
- if (derived().x_ticks_.down_ticks_on_ == true)
- { // Move down for any downward ticks.
- y += 1.1 * (std::max)(derived().x_ticks_.major_tick_length_, derived().x_ticks_.minor_tick_length_); // And avoid macro max trap!
- // and a small space.
- y += 0.5 * (derived().x_label_info_.textstyle().font_size() + derived().x_value_label_info_.textstyle().font_size()); // best compromise?
- }
- }
- else if ((derived().x_ticks_.label_rotation_ == uphill) || (derived().x_ticks_.label_rotation_ == downhill))
- { // sloping 45 degrees up or down.
- y += derived().x_ticks_.label_max_space_ * sin45; // Move down from end of tick.
- if (derived().x_ticks_.down_ticks_on_ == true)
- { // Move down for any downward ticks.
- y += 1.1 * (std::max)(derived().x_ticks_.major_tick_length_, derived().x_ticks_.minor_tick_length_); // And avoid macro max trap!
- // and a small space.
- y += 0.7 * (derived().x_label_info_.textstyle().font_size() + derived().x_value_label_info_.textstyle().font_size()); // best compromise?
- }
- }
- else if ((derived().x_ticks_.label_rotation_ == slopeup) || (derived().x_ticks_.label_rotation_ == slopedownhill))
- { // sloping 30 degrees.
- y += derived().x_ticks_.label_max_space_ * sin45; // Move down from end of tick.
- if (derived().x_ticks_.down_ticks_on_ == true)
- { // Move down for any downward ticks.
- y += 1.1 * (std::max)(derived().x_ticks_.major_tick_length_, derived().x_ticks_.minor_tick_length_); // And avoid macro max trap!
- // and a small space.
- y += 0.5 * (derived().x_label_info_.textstyle().font_size() + derived().x_value_label_info_.textstyle().font_size()); // best compromise?
- }
- }
- else if (derived().x_ticks_.label_rotation_ == horizontal)
- { // horizontal X ticks value labels (default).
- if (derived().x_ticks_.major_value_labels_side_ < 0)
- { // Move down to allow space for font size of tick value labels below X-axis.
- y += derived().x_value_label_info_.textstyle().font_size() ;
- }
- y += derived().x_label_info_.textstyle().font_size() * 1.3; // Allow for the X-axis label font and space.
- // See also 1.3 factor drawing ticks.
- }
- else
- {
- std::cout << " Rotation of X label rotation" << derived().x_ticks_.label_rotation_ << "not yet implemented!" << std::endl;
- }
- }
- else if (derived().x_ticks_.major_value_labels_side_ > 0)
- { // Tick labels above, only ticks below, so just move down for height of label font.
- y += derived().x_label_info_.textstyle().font_size() * 1.3; // Allow for the X-axis label font and space.
- }
- else
- { // derived().x_ticks_.major_value_labels_side_ == 0
- // So no change for labels.
- y += derived().x_label_info_.textstyle().font_size() * 1.3; // Allow for the X-axis label font and space.
- }
-
- if (derived().x_ticks_.down_ticks_on_)
- { // Shift down for biggest of any ticks, and bit of space.
- y += 1.1 * (std::max)(derived().x_ticks_.minor_tick_length_, derived().x_ticks_.major_tick_length_);
- // y += derived().x_ticks_.value_label_style_.font_size() * 1.; // Shift down to suit tick labels?
- }
- }
- else if (derived().x_ticks_.ticks_on_window_or_on_axis_ > 0)
- { // = +1 means ticks are on top of plot window.
- // Shift down from plot window bottom to suit X-axis label.
- y += derived().x_label_info_.textstyle().font_size() * 1.7;
- }
- else if (derived().x_ticks_.ticks_on_window_or_on_axis_ == 0)
- { // Ticks are ON the X-axis line, so X label is just below the plot bottom.
- // No space needed for ticks.
- // Character starts at bottom of capital letter, so allow for descenders.
- //y = derived().image_.y_size() - derived().image_border_width(); // Place X Label just above the image bottom.
- //y -= derived().image_border_.margin_;
- y += derived().x_label_info_.textstyle().font_size() * 1.7;
- }
-
- derived().image_.g(PLOT_X_LABEL).push_back(new text_element(
- ( // x position relative to the x-axis which is middle of plot window.
- derived().plot_right_ + derived().plot_left_) / 2, // x coordinate - middle.
- y, // Down from plot window.
- x_label,
- derived().x_label_info_.textstyle(),
- center_align, horizontal)
- );
- } // void draw_x_axis_label()
-
- void adjust_limits(double& x, double& y)
- { //! If value of a data point reaches limit of max, min, infinity,
- //! use the appropriate plot min or max value instead.
- if(detail::limit_max(x))
- {
- x = derived().plot_right_;
- }
- if(detail::limit_max(y))
- {
- y = derived().plot_top_;
- }
- if(detail::limit_min(x))
- {
- x = derived().plot_left_;
- }
- if(detail::limit_min(y))
- {
- y = derived().plot_top_;
- }
- // If value is NaN, use zero instead.
- // TODO Do we want/get a different color or shape for NaNs?
- if(detail::limit_NaN(x))
- {
- x = 0.;
- transform_x(x);
- }
- if(detail::limit_NaN(y))
- {
- y = 0.;
- transform_y(y);
- }
- } // void adjust_limits
-
-
- void draw_title()
- { /*! Draw title (for the whole plot).
- Update title_info_ with position.
- Assumes align = center_align
- Using center_align will ensure that title will center correctly
- because the render engine does the centering.
- (Even if the original string is made much longer because it contains Unicode,
- Greek, math symbols etc, taking about 8 characters per symbol.
- For example, the Unicode symbol for square root is "√" but takes only about one character width).
- */
- derived().title_info_.x(derived().image_.x_size() / 2.); // Center of image.
- double y;
- y = derived().title_info_.textstyle().font_size() * derived().text_margin_; // Leave a linespace above.
- derived().title_info_.y(y);
- derived().image_.g(PLOT_TITLE).push_back(new text_element(derived().title_info_));
- } // void draw_title()
-
- void size_legend_box()
- { //! Calculate how big the legend box needs to be.
- if(derived().legend_on_ == false)
- { // No legend wanted, so set values to show legend positions invalid?
- //derived().legend_left_ = -1.;
- //derived().legend_right_ = -1.;
- //derived().legend_top_ = -1.;
- //derived().legend_bottom_ = -1.;
- derived().legend_height_ = 0.; // At least set the size to zero.
- derived().legend_width_ = 0.;
- return;
- }
- else
- { // legend_on_ == true
- // Work out the size the legend box needs to be to hold the
- // header, markers, lines & text.
- size_t num_series = derived().serieses_.size(); // How many data series.
- int font_size = derived().legend_header_.textstyle().font_size();
- int point_size = derived().serieses_[0].point_style_.size();
- // Use height of whichever is the biggest of point marker and font.
- double spacing = (std::max)(font_size, point_size);
- // std::cout << spacing << ' ' << font_size << ' ' << point_size << std::endl;
- bool is_header = (derived().legend_header_.text() != "");
- //text_element legend_header_; // legend box header or title (if any).
- //text_style legend_style_;
- double longest = string_svg_length(derived().legend_header_.text(), derived().legend_style_);
- //std::cout << "\nLegend header " << longest << " svg units." << std::endl;
- derived().legend_width_ = 2 * (derived().legend_box_.margin() * derived().legend_box_.width());
- // Don't plan to write on either side border, or on the 'forbidden' margins of the box.
- for(size_t i = 0; i < num_series; ++i)
- { // Find the longest text (if longer than header) in all the data series.
- std::string s = derived().serieses_[i].title_;
- double siz = string_svg_length(s, derived().legend_style_);
- if (siz > longest)
- {
- longest = siz;
- }
- } // for
- // std::cout << "\nLongest legend header or data descriptor " << longest << " svg units." << std::endl;
- derived().legend_width_ += longest * 0.8; // Space for longest text.
- // Kludge factor to allow for not knowing the real length.
-
- // Allow width for a leading space, and trailing
- derived().legend_width_ += spacing * 2.5;
-
- // & trailing space before box margin.
- // if (derived().serieses_[i].line_style_.line_on_) // line joining points.
- if (derived().legend_lines_)
- { // Add for colored line marker in legend.
- derived().legend_width_ += spacing * 1.5;
- }
- if(derived().serieses_[0].point_style_.shape() != none)
- { // Add for any colored data point marker, cross, round... & space.
- derived().legend_width_ += 1.5 * derived().serieses_[0].point_style_.size();
- }
- // else no point marker.
-
- // legend_height must be *at least* enough for
- // any legend header and text_margin(s) around it
- // (if any) plus a text_margin_ top and bottom.
- // Add more height depending on the number of lines of text.
- derived().legend_height_ = spacing; // At top
- if ( (is_header) // is a legend header line.
- && (derived().legend_header_.text() != "") )
- {
- derived().legend_height_ += 2 * font_size; // text & space after.
- }
- derived().legend_height_ += num_series * spacing * 2; // Space for the data point symbols & text.
- } // legend_on_ == true
-
- //std::cout << "Legend width " << derived().legend_width_ << ", height " << derived().legend_height_ << std::endl;
- } // void size_legend_box()
-
- void place_legend_box()
- { //! Place legend box (if required).
- if(derived().legend_on_ == true) // Legend box required.
- {
- derived().outside_legend_on_ = true; // Unless proves to be inside.
- //double spacing = derived().legend_box_.margin(); // Might be better to use this, but needs redoing.
- double spacing = derived().y_axis_label_style_.font_size() * 1.; // Around any legend box - beyond any border.
- switch (derived().legend_place_)
- {
- case nowhere:
- return; // Actually places it at (0, 0), probably overwriting the plot.
- case somewhere:
- // Assume legend_top_left will place it somewhere where there is nothing else.
- //derived().legend_left_; set by legend_top_left
- //derived().legend_top_;
- derived().legend_bottom_ = derived().legend_top_ + derived().legend_height_;
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- break;
- case inside:
- derived().outside_legend_on_ = false;
- if (derived().legend_left_ == -1)
- { // Legend box position NOT been set by legend_top_left.
- // Default inside position is top left level with plot window.
- derived().legend_left_ = derived().image_border_.width_ + derived().image_border_.margin_; // left image edge + space.
- derived().plot_left_ += derived().legend_width_ + spacing; // Push plot window right same amount to make room,
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- derived().legend_top_ = derived().plot_top_; // Level with top of plot window.
- derived().legend_bottom_ = derived().legend_top_ + derived().legend_height_;
- }
- else
- { // Legend position has been specified by legend_top_left.
- break;
- }
- break;
- // If outside then reserve space for legend by reducing plot window.
- case outside_right: // Default legend position is outside_right,
- // so that it isn't too close to the image edge or the plot window.
- derived().plot_right_ -= derived().legend_width_ + spacing; // Narrow plot window from right.
- derived().legend_left_ = derived().plot_right_ + spacing; // plot + border.
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- derived().legend_top_ = derived().plot_top_; // Level with top of plot window.
- derived().legend_bottom_ = derived().legend_top_ + derived().legend_height_;
- break;
- case outside_left:
- derived().plot_left_ += derived().legend_width_ + spacing /2 ; // Push plot window right same amount to make room,
- derived().legend_left_ = derived().image_border_.width_ + derived().image_border_.margin_; // left image edge + space.
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- derived().legend_top_ = derived().plot_top_; // Level with top of plot window.
- derived().legend_bottom_ = derived().legend_top_ + derived().legend_height_;
- break;
- case outside_top:
- // Centered.
- derived().legend_left_ = derived().image_.x_size() / 2. - derived().legend_width_ / 2; // Center.
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- derived().plot_top_ += derived().legend_height_ + spacing;
- derived().legend_top_ = derived().title_info_.y() + derived().title_font_size() * derived().text_margin_;
- derived().legend_top_ += spacing;
- derived().legend_bottom_ = derived().legend_top_ + derived().legend_height_;
- break;
- case outside_bottom:
- // Centered.
- derived().legend_bottom_ = derived().image_.y_size();
- derived().legend_bottom_ -= (derived().image_border_.width_ + derived().image_border_.margin_); // up
- derived().legend_top_ = derived().legend_bottom_ - derived().legend_height_;
- derived().legend_left_ = derived().image_.x_size()/ 2. - derived().legend_width_ / 2; // Center.
- derived().legend_right_ = derived().legend_left_ + derived().legend_width_;
- derived().plot_bottom_ = derived().legend_top_;
- derived().plot_bottom_ -= 2 * spacing;
- break;
- } // switch
-
- //std::cout << "Legend: left " << derived().legend_left_
- // << ", right " << derived().legend_right_
- // << ", top " << derived().legend_top_
- // << ", bottom " << derived().legend_bottom_
- // << std::endl;
-
- // Check if the location requested will fit,
- // now that we know the size of box needed.
- if ( (derived().legend_left_ < 0) || (derived().legend_left_ > derived().image_.x_size()))
- { // left outside image?
- std::cout << "Legend top left " << derived().legend_left_
- << " is outside image size = " << derived().image_.x_size() << std::endl;
- }
- if ((derived().legend_right_ < 0) || (derived().legend_right_ > derived().image_.x_size()))
- { // right outside image?
- std::cout << "Legend top right " << derived().legend_right_
- << " is outside image size = " << derived().image_.x_size() << std::endl;
- }
- if ((derived().legend_top_ < 0) || (derived().legend_top_ > derived().image_.y_size()))
- { // top outside image?
- std::cout << "Legend top " << derived().legend_top_
- << " outside image!" << derived().image_.y_size() << std::endl;
- }
- if ((derived().legend_bottom_ < 0 ) || (derived().legend_bottom_ > derived().image_.y_size()))
- { // bottom outside image?
- std::cout << "Legend bottom " << derived().legend_bottom_
- << " outside " << derived().image_.y_size() << std::endl;
- }
-
- derived().image_.g(detail::PLOT_LEGEND_BACKGROUND)
- .style().fill_color(derived().legend_box_.fill()) //
- .stroke_color(derived().legend_box_.stroke())
- .stroke_width(derived().legend_box_.width())
- .stroke_on(derived().legend_box_.border_on())
- ;
-
- // Draw border box round legend.
- g_element* g_ptr = &(derived().image_.g(PLOT_LEGEND_BACKGROUND));
- g_ptr->push_back(new
- rect_element(derived().legend_left_, derived().legend_top_, derived().legend_width_, derived().legend_height_));
- } // if legend_on_
- } // void calculate_legend_box()
-
- void draw_legend()
- { //! Draw the legend border, text header (if any) and marker lines and/or shapes.
- // size_t num_points = derived().series.size();
- // cout << derived().legend_box_.width() << ' ' << derived().legend_box_.margin() << endl;
-
- int font_size = derived().legend_header_.textstyle().font_size();
- int point_size = derived().serieses_[0].point_style_.size();
- // Use whichever is the biggest of point marker and font.
- double spacing = (std::max)(font_size, point_size);
- // std::cerr << spacing << ' ' << font_size << ' ' << point_size << endl;
- bool is_header = (derived().legend_header_.text() != "");
-
- // Assume legend box position has already been sized and positioned by function calculate_legend_box.
- double legend_x_start = derived().legend_left_; // Saved box location.
- double legend_width = derived().legend_width_;
- double legend_y_start = derived().legend_top_;
- double legend_height = derived().legend_height_;
-
- // Draw border box round legend.
- g_element* g_ptr = &(derived().image_.g(PLOT_LEGEND_BACKGROUND));
-
- g_ptr->push_back(new
- rect_element(legend_x_start, legend_y_start, legend_width, legend_height));
-
- double legend_y_pos = legend_y_start + derived().text_margin_ * spacing;
- if (is_header)
- { // Draw the legend header text for example: "My Plot Legend".
- derived().legend_header_.x(legend_x_start + legend_width / 2.); // / 2. to center in legend box.
- // Might be better to use center_align here because will fail if legend contains symbols in Unicode.
- derived().legend_header_.y(legend_y_pos);
- derived().image_.g(PLOT_LEGEND_TEXT).push_back(new text_element(derived().legend_header_));
- legend_y_pos += 2 * spacing; // Might be 1.5? - useful if many series makes the box too tall.
- }
-
- g_ptr = &(derived().image_.g(PLOT_LEGEND_POINTS));
- g_element* g_inner_ptr = g_ptr;
- g_inner_ptr = &(derived().image_.g(PLOT_LEGEND_TEXT));
-
- for(unsigned int i = 0; i < derived().serieses_.size(); ++i)
- { // Show point marker, perhaps line, & text info for each of the data series.
-
- // cout << "Series " << i << endl;
- // derived().serieses_[i].point_style_ << endl;
- // cout << derived().serieses_[i].line_style_ << endl;
-
- double legend_x_pos = legend_x_start;
- legend_x_pos += spacing; // space before point marker and/or line & text.
- g_inner_ptr = &(g_ptr->add_g_element());
- // Use both stroke & fill colors from the points' style.
- // Applies to both shape AND line.
- g_inner_ptr->style().stroke_color(derived().serieses_[i].point_style_.stroke_color_);
- g_inner_ptr->style().fill_color(derived().serieses_[i].point_style_.fill_color_);
- g_inner_ptr->style().stroke_width(derived().serieses_[i].line_style_.width_);
-
- //cout << "g_inner_ptr.style().stroke_color() " << g_inner_ptr->style() << endl;
- plot_point_style& sty = derived().serieses_[i].point_style_;
-
- if(sty.shape_ != none)
- { // Is some data point marker shape to show in legend box.
- bool was_unc_ellipse = false;
- if (sty.shape_ == unc_ellipse)
- { // Problem here with unc_ellipse with calculation of a suitable size
- // and also, more fundamentally, the legend box overwrites the PLOT_DATA_UNC layers.
- // so as a hack, use a round instead.
- sty.shape_ = round;
- was_unc_ellipse = true; // Note so restore after showing circle.
- }
-
- draw_plot_point( // Show a plot point like circle (==round), square, vertical bar...
- legend_x_pos,
- legend_y_pos,
- *g_inner_ptr,
- sty, unc<false>(), unc<false>());
- //was derived().serieses_[i].point_style_, unc(0.), unc(0.));
- legend_x_pos += 1.5 * spacing;
- if (was_unc_ellipse)
- { // Restore (or the data points won't use the unc_ellipse!
- sty.shape_ = unc_ellipse;
- }
- }
-
- // Line markers are only really useful for 2-D lines and curves showing functions.
- if (derived().legend_lines_)
- { // Need to draw a short line to show color for that data series.
- // Line joining points option is true.
- if (derived().serieses_[i].line_style_.line_on_ || derived().serieses_[i].line_style_.bezier_on_)
- { // Use stroke color from line style.
- g_inner_ptr->style().stroke_color(derived().serieses_[i].line_style_.stroke_color_);
- }
- else
- { // Use point stroke color instead.
- g_inner_ptr->style().stroke_color(derived().serieses_[i].point_style_.stroke_color_); // OK with 1D
- }
- //std::cout << "line g_inner_ptr->style().stroke_color() " << g_inner_ptr->style().stroke_color() << std::endl;
-
- g_inner_ptr->push_back(new line_element( // Draw horizontal lines with appropriate color.
- legend_x_pos,
- legend_y_pos,
- legend_x_pos + spacing, // Line sample is one char long.
- legend_y_pos));
- legend_x_pos += 1.5 * spacing; // Total is short line & a space.
- } // legend_lines_
-
- // Legend text for each Data Series added to the plot.
- g_inner_ptr = &(derived().image_.g(PLOT_LEGEND_TEXT));
- g_inner_ptr->push_back(new text_element(
- legend_x_pos, // allow space for the marker.
- legend_y_pos,
- derived().serieses_[i].title_, // Text for this data series.
- derived().legend_header_.textstyle(),
- left_align));
- legend_y_pos += 2 * spacing;
- } // for
- } // void draw_legend()
-
- void draw_plot_point(double x, double y, // SVG coordinates.
- //void draw_plot_point(unc x, unc y, // SVG coordinates.
- g_element& g_ptr,
- plot_point_style& sty,
- unc<false> ux, unc<false> uy) // Default unc ux = 0.? and uy = 0.
- { /*! Draw a plot data point marker shape
- whose size and stroke and fill colors are specified in plot_point_style.
- */
- /*
- For 1-D plots, the points do not *need* to be centered on the X-axis,
- and putting them just above, or sitting on, the X-axis is much clearer.
- For 2-D plots, the symbol center should, of course, be centered exactly on x, y.
- circle and ellipse are naturally centered on the point.
- for rect x and y half_size offset centers square on the point.
- But symbols are in a rectangular box and the offset is different for x & y
- even assuming that the symbol is centered in the rectangle.
- the vertical and horizontal ticks are deliberately offset above the axes.
- TODO Not sure this is fully resolved.
- */
- int size = sty.size_;
- double half_size = size / 2.;
- //cout << "point style() "<< sty.style() << endl;
- // Whatever shape, text or line, want to use the point style.
- g_ptr.style().stroke_color(sty.stroke_color_);
- g_ptr.style().fill_color(sty.fill_color_);
-
- //cout << "g_ptr.style() " << g_ptr.style() << endl;
-
- switch(sty.shape_) // from enum point_shape none, round, square, point, egg
- {
- case round:
- g_ptr.circle(x, y, (int)half_size);
- break;
-
- case point:
- g_ptr.circle(x, y, 1); // Fixed size round.
- break;
-
- case square:
- g_ptr.rect(x - half_size, y - half_size, size, size);
- break;
- case egg:
- g_ptr.ellipse(x, y, half_size, size * 2.); // Tall thin egg!
- break;
-
- case unc_ellipse:
- { // Uncertainty horizontal (and, for 2D, vertical) ellipses for one, two and three standard deviations.
- double xu = ux.value(); //
- if (ux.uncertainty() > 0)
- { // uncertainty is meaningful.
- xu += ux.uncertainty();
- }
- transform_x(xu); // To SVG coordinates.
- double x_radius = abs(xu - x);
- if (x_radius <= 0.)
- { // Make sure something is visible.
- x_radius = 1.; // Or size?
- }
-
- double yu = uy.value();
- if (uy.uncertainty() > 0)
- { // uncertainty is meaningful.
- yu += uy.uncertainty();
- }
-
- transform_y(yu);
- double y_radius = abs(yu - y);
- if (y_radius <= 0.)
- { // Make sure something is visible.
- y_radius = 1.;
- }
- //image_.g(PLOT_DATA_UNC).style().stroke_color(magenta).fill_color(pink).stroke_width(1);
- // color set in svg_1d_plot data at present.
- g_element* gu3_ptr = &(derived().image_.g(PLOT_DATA_UNC3));
- g_element* gu2_ptr = &(derived().image_.g(PLOT_DATA_UNC2));
- g_element* gu1_ptr = &(derived().image_.g(PLOT_DATA_UNC1));
- gu1_ptr->ellipse(x, y, x_radius, y_radius); // Radii are one standard deviation.
- gu2_ptr->ellipse(x, y, x_radius * 2, y_radius * 2); // Radii are two standard deviation..
- gu3_ptr->ellipse(x, y, x_radius * 3, y_radius * 3); // Radii are three standard deviation..
- g_ptr.circle(x, y, 1); // Show x and y values at center using stroke and fill color of data point marker.
- }
- break;
-
- // Offset from center is not an issue with vertical or horizontal ticks.
-
- case vertical_tick: // Especially neat for 1-D points.
- g_ptr.line(x, y, x , y - size); // tick up from axis.
- break;
- case vertical_line:
- g_ptr.line(x, y + size, x , y - size); // line up & down from axis.
- break;
- case horizontal_tick:
- // horizontal_tick is pretty useless for 1-D because the horizontal line is on the X-axis.
- g_ptr.line(x, y, x + size, y ); // tick right from axis.
- break;
- case horizontal_line:
- g_ptr.line(x, y - size, x + size, y ); // line left & right from axis.
- // horizontal_line is pretty useless for 1-D because the horizontal line is on the X-axis.
- break;
- case symbol:
- g_ptr.text(x, y + half_size, sty.symbols(), sty.style(), center_align, horizontal); // symbol(s), size and centre.
-
- // Unicode symbols that work on most browsers are listed at
- // boost\math\libs\math\doc\sf_and_dist\html4_symbols.qbk,
- // http://www.htmlhelp.com/reference/html40/entities/symbols.html
- // and http://www.alanwood.net/demos/ent4_frame.html
- // The Unicode value in decimal 9830 or hex x2666 must be prefixed with & and terminated with ;
- // for example &x2666; for xml
- // and then enveloped with "" to convert to a std::string, for example: "♦" for diamond.
-
- break;
- case diamond:
- g_ptr.text(x, y, "♦", sty.symbols_style_, center_align, horizontal);
- // size / 4. puts bottom tip on the X-axis,
- // size / 2. put center above the X-axis
- // x, y, put on the X-axis - probably what is needed for 2-D plots.
- // diamond, spades, clubs & hearts fill with expected fill_color.
- break;
- case asterisk:
- g_ptr.text(x, y - size / 3., "∗", sty.symbols_style_, center_align, horizontal);
- // asterisk is black filled.
- // size /3 puts the bottom tip on the X-axis.
- break;
- case lozenge:
- g_ptr.text(x, y - size / 3., "◊", sty.symbols_style_, center_align, horizontal);
- // size / 3 to get tip of lozenge just on the X-axis.
- // lozenge seems not to fill?
- break;
- case club:
- g_ptr.text(x, y, "♣", sty.symbols_style_, center_align, horizontal);
- // x, y, puts club just on the X-axis
- break;
- case spade:
- g_ptr.text(x, y, "♠", sty.symbols_style_, center_align, horizontal);
- //
- break;
- case heart:
- g_ptr.text(x, y , "♥", sty.symbols_style_, center_align, horizontal);
- //
- break;
- case cone: // Pointing down triangle.
- {
- bool fill = (sty.fill_color() != blank);
- g_ptr.triangle(x - half_size, y - size, x + half_size, y - size, x, y, fill);
- // Last point puts the bottom tip of the triangle on the X-axis (may not be wanted for 2-D).
- }
- break;
- case cross: // Not X.
- g_ptr.line(x, y + size, x , y - size); // line up & down from axis,
- g_ptr.line(x, y - size, x + size, y ); // & line left & right from axis.
- // Cross is pretty useless for 1-D because the horizontal line is on the X-axis.
- break;
- // TODO Other point_shapes do nothing yet.
- }
- } // void draw_plot_point
-
- void draw_plot_point_value(double x, double y, g_element& g_ptr, value_style& val_style, plot_point_style& point_style, unc<false> uvalue)
- { /*!
- Write one data point (X or Y) value as a string, for example "1.23e-2",
- near the data point marker.
- Unecessary e, +, \& leading exponent zeros may optionally be stripped,
- and the position and rotation controlled.
- Uncertainty estimate, typically standard deviation
- (half conventional 95% confidence 'plus or minus') may be optionally be appended.
- Degrees of freedom estimate (number of replicates) may optionally be appended.
- For example: "3.45 +-0.1(10)"\n
- The precision and format (scientific, fixed), and color and font type and size can be controlled too.
- */
- double value = uvalue.value(); // Most likely value.
- double u = uvalue.uncertainty(); // Uncertainty standard devision or 1/2 plusminus for value.
- double df = uvalue.deg_free(); // Degrees of freedom estimate for value.
-
- std::stringstream label;
- label.precision(val_style.value_precision_);
- label.flags(val_style.value_ioflags_);
- label << value; // "1.2" or "3.4e+001"...
- std::string stripped = (derived().x_ticks_.strip_e0s_) ?
- // Default is to strip unecessary e, +, & leading exponent zeros.
- strip_e0s(label.str()) // "1.2" or "3.4e1"...
- :
- stripped = label.str();
- if (val_style.prefix_ != "")
- { // Want a prefix like "[" or "time = ".
- stripped = val_style.prefix_ + stripped;
- }
- int marker_size = point_style.size_; // point marker size
- int label_size = val_style.values_text_style_.font_size();
- // Offset of value label from point must be related mainly to
- // size of the data marker, less the value label font size.
- // May need to combine these two?
-
- rotate_style rot = val_style.value_label_rotation_;
- // http://www.w3.org/TR/SVG/coords.html#RotationDefined
- // transform="rotate(-45)" == uphill
-
- align_style al; // = center_align;
- switch (rot)
- {
- case horizontal: // OK
- al = center_align;
- y -= marker_size * 2; // Up marker font size;
- // center_align means no x correction.
- break;
- case leftward: // horizontal but to left of marker.
- al = right_align;
- x -= marker_size * 1.3; // left
- y += label_size * 0.3; // down label font size;
- rot = horizontal;
- break;
- case rightward: // horizontal but to right of marker.
- al = left_align;
- x += marker_size * 1.1; // right
- y += label_size * 0.3; // down label font size;
- rot = horizontal;
- break;
- case upsidedown: // OK but upsidedown so not very useful!
- al = center_align;
- y += marker_size; // Down marker font size;
- break;
- case slopeup: // -30 - OK
- case steepup: // -45 - OK
- case uphill: // -60 - OK
- al = left_align;
- x += label_size /3; // Right third label font size - centers on marker.
- y -= marker_size * 0.6; // UP marker font size;
- break;
- case upward: // -90 vertical writing up - OK.
- al = left_align;
- x += label_size /3; // Right third label font size - centers on marker.
- y -= marker_size * 0.9; // Up marker font size;
- break;
- case backup: // OK
- al = right_align;
- x -= marker_size * 1.5; // Left
- y -= marker_size * 0.8; // Up
- rot = downhill;
- break;
-
- case slopedownhill: // 30 gentle slope down.
- case downhill: // 45 down.
- case steepdown: // 60 steeply down.
- al = left_align;
- x += marker_size * 0.4; // Right;
- y += marker_size * 0.9; // Down
- break;
- case downward: // OK
- al = left_align;
- x -= marker_size; // Left
- y += marker_size; // Up
- break;
- case backdown: // OK
- al = right_align;
- x -= marker_size * 0.5; // Left
- y += marker_size * 1.5; // down
- rot = uphill;
- break;
- } // switch
- text_element& t = g_ptr.text(x, y, stripped, val_style.values_text_style_, al, rot); // X or Y value "1.23".
- int udf_font = static_cast<int>(val_style.values_text_style_.font_size() * reducer);
-
- std::string label_u; // Uncertainty or plusminus.
- std::string label_df; // Degrees of freedom estimate.
- std::string pm = " ±"; //! Unicode space plusminus glyph.
- // Might also use ANSI symbol for plusminus 0xF1 == '\361' or char(241)
- // but seems to vary with different codepages
- // LOCALE_SYSTEM_DEFAULT LOCALE_IDEFAULTANSICODEPAGE == 1252
- // LOCALE_SYSTEM_DEFAULT LOCALE_IDEFAULTCODEPAGE == 850 for country 44 (UK)
- // And seems to vary from console to printable files.
- // Spaces seem to get lost, so use 00A0 as an explicit space glyph.
- // Layout seems to vary with font - Times New Roman leaves no space after.
- //text_element& t = g_ptr.text(x, y, label_v, val_style.values_text_style_, al, rot);
- // Optionally, show uncertainty as 95% confidence plus minus: 2.1 +-0.012 (23)
-
- if ((val_style.plusminus_on_ == true) // Is wanted.
- && (u > 0.) // Is a valid uncertainty estimate.
- )
- { // Uncertainty estimate usually expressed 95% confidence interval + or - 2 standard deviation.
- u = u * plusminus; // typically + or - 2 standard deviations.
- label_u = sv(u, val_style, true); // stripped.
- t.tspan(pm).fill_color(val_style.plusminus_color_);
- t.tspan(label_u).fill_color(val_style.plusminus_color_).font_size(udf_font);
- }
- if (val_style.df_on_ == true // Is wanted.
- && (df != (std::numeric_limits<unsigned short int>::max)()) // and deg_free is defined OK.
- )
- { // Degrees of freedom or number of values-1 used for this estimate of value.
- std::stringstream label;
- label.precision(4); // Might need 5 to show 65535?
- //label.flags(sty.value_ioflags_); // Leave at default.
- label << " (" << df << ")"; // "123"
- // Explicit space "\ " seems necessary.
- label_df = label.str();
- t.tspan(label_df).fill_color(val_style.df_color_).font_size(udf_font);
- }
- if (val_style.suffix_ != "")
- { // Want a suffix like "]" or " sec]".
- t.tspan(val_style.suffix_);
- }
-
- } // void draw_plot_point_value(double x, double y, g_element& g_ptr, double value)
-
- std::string sv(double v, const value_style& sty, bool precise = false)
- { //! Strip from double value any unecessary e, +, & leading exponent zeros, reducing "1.200000" to "1.2" or "3.4e1"...
- // TODO rename fo strip_value?
- std::stringstream label;
- // Precision of uncertainty is usually less than precision of value,
- // label.precision((unc) ? ((sty.value_precision_ > 3) ? sty.value_precision_-2 : 1) : sty.value_precision_);
- // Possible but simpler to fix at precision=2
- label.precision((precise) ? 2 : sty.value_precision_);
- label.flags(sty.value_ioflags_);
- label << v; // "1.2" or "3.4e+001"...
- return (sty.strip_e0s_) ?
- // Default is to strip unecessary e, +, & leading exponent zeros.
- strip_e0s(label.str()) // reduce to "1.2" or "3.4e1"...
- :
- label.str(); // Leave unstripped.
- } // std::string sv(double v, const value_style& sty)
-
- void draw_plot_point_values(double x, double y, g_element& x_g_ptr, g_element& y_g_ptr, const value_style& x_sty, const value_style& y_sty, unc<false> uncx, unc<false> uncy)
- { /*! \brief Write the \b pair of data point's X and Y values as a string.
- \details
- \verbatim If a separator, then both on the same line, for example "1.23, 3.45", or "[5.6, 7.8]
- X value_style is used to provide the prefix and separator, and Y value_style to provide the suffix.
- For example, x_style prefix("[ X=", and separator ", Y= ", " and Y value_style = "]"
- will produce a value label like "[X=-1.23, Y=4.56]"
- Note the need to use a Unicode space for get space for all browsers.
- For as long a string as this you may need to make the total image size bigger,
- and to orient the value labels with care.
- draw_plot_point_values is only when both x and Y pairs are wanted.
- \endverbatim
- */
- // verbatim needed to avoid a warning about using   within Doxygen comment.
- using std::string;
- using std::stringstream;
- double vx = uncx.value();
- double vy = uncy.value();
- double ux = uncx.uncertainty();
- double uy = uncy.uncertainty();
- double dfx = uncx.deg_free();
- double dfy = uncy.deg_free();
-
- std::string label_xv = sv(vx, x_sty); //! Also strip unnecessary e, + and leading exponent zeros, if required.
- std::string label_yv = sv(vy, y_sty);
- if (x_sty.prefix_ != "")
- { // Want a prefix like "["
- label_xv = x_sty.prefix_ + label_xv;
- }
- std::string label_xu; // X uncertainty as string.
- std::string label_yu;
- std::string label_xdf; // X degrees of freedom as string.
- std::string label_ydf;
-
- int marker_size = derived().serieses_[0].point_style_.size_;
- int label_size = x_sty.values_text_style_.font_size();
- // Offset of value labels from point must be related mainly to
- // size of the data marker, less the value label font size.
-
- rotate_style rot = x_sty.value_label_rotation_;
- align_style al; // = center_align;
- switch (rot)
- {
- case horizontal: // OK
- al = center_align;
- y -= marker_size * 2; // Up marker font size;
- // center_align means no x correction.
- break;
- case leftward: // horizontal but to left of marker. OK
- al = right_align;
- x -= marker_size * 1.3; // left
- y += label_size * 0.3; // down label font size;
- rot = horizontal;
- break;
- case rightward: // horizontal but to right of marker.OK
- al = left_align;
- x += marker_size * 1.1; // right
- y += label_size * 0.3; // down label font size;
- rot = horizontal;
- break;
- case upsidedown: // OK but upsidedown so not very useful!
- al = center_align;
- y += marker_size; // Down marker font size;
- break;
- case slopeup: // -30 - OK
- case steepup: // -45 - OK
- case uphill: // -60 - OK
- al = left_align;
- x += label_size /3; // Right third label font size - centers on marker.
- y -= marker_size * 0.6; // UP marker font size;
- break;
- case upward: // -90 vertical writing up - OK.
- al = left_align;
- x += label_size /3; // Right third label font size - centers on marker.
- y -= marker_size * 0.9; // Up marker font size;
- break;
- case backup: // OK
- al = right_align;
- x -= marker_size * 1.5; // Left
- y -= marker_size * 0.8; // Up
- rot = downhill;
- break;
- case slopedownhill: // 30 gentle slope down.
- case downhill: // 45 down.
- case steepdown: // 60 steeply down.
- al = left_align;
- x += marker_size * 0.4; // Right;
- y += marker_size * 0.9; // Down
- break;
- case downward: // OK
- al = left_align;
- x -= marker_size; // Left
- y += marker_size; // Up
- break;
- case backdown: // OK
- al = right_align;
- x -= marker_size * 0.5; // Left
- y += marker_size * 1.5; // down
- rot = uphill;
- break;
- } // switch
-
- // If would be simpler to prepare a single string like "1.23 +- -0.3, 3.45 +- -0.1(10)"
- // but this would not allow change of font size, type and color
- // something that proves to be very effective at visually separating
- // value and uncertainty, and degrees of freedom estimate.
- // So the coding complexity is judged with it (even if it may not always work right yet ;-)
- // prefix, separator and suffix are all black at present.
- // Tasteless colors and font changes are purely proof of concept.
-
- int fx = static_cast<int>(x_sty.values_text_style_.font_size() * reducer);
- // Make uncertainty and df a bit smaller to distinguish from value by default (but make configurable).
- // Write X value (and optional uncertainty and df).
- text_element& t = x_g_ptr.text(x, y, label_xv, x_sty.values_text_style_, al, rot);
- // Optionally, show uncertainty as 95% confidence plus minus: 2.1 +-0.012
- // and also optionally show degrees of freedom (23).
-
- string pm = " ±"; //! Unicode space plusminus glyph.
- // Spaces seem to get lost, so use \&x00A0 as an explicit space glyph.
- // Layout seems to vary with font - Times New Roman leaves no space after.
- if ((x_sty.plusminus_on_ == true)
- && (ux > 0.)
- )
- { // Uncertainty estimate usually 95% confidence interval + or - 2 standard deviation.
- ux *= plusminus; // typically + or - 2 standard deviations.
- label_xu = sv(ux, x_sty, true);
- //t.tspan(pm).fill_color(darkcyan);
- // Should this be stroke_color?
- t.tspan(pm).fill_color(x_sty.plusminus_color_);
- t.tspan(label_xu).fill_color(x_sty.plusminus_color_).font_size(fx); // .font_weight("bold")
- }
- if (
- (x_sty.df_on_ == true) // Is wanted.
- &&
- (dfx != (std::numeric_limits<unsigned short int>::max)()) // and deg_free is defined OK.
- )
- { // Degrees of freedom (usually number of observations-1) used for this estimate of value.
- stringstream label;
- label.precision(4); // Might need 5 to show 65535?
- //label.flags(sty.value_ioflags_); // Leave at default.
- label << " (" << dfx << ")"; // "123.5"
- // Explicit space "\ " seems necessary.
- label_xdf = label.str();
- t.tspan(label_xdf).fill_color(x_sty.df_color_).font_size(fx);
- }
- int fy = static_cast<int>(y_sty.values_text_style_.font_size() * reducer);
- // If there a comma is 1st char in separator, put values on the same line, else as below put below the marker.
- bool sameline = (x_sty.separator_[0] == ',');
- if (sameline)
- { // On same line so use X style for separator. But Y style for any text.
- t.tspan(x_sty.separator_).fill_color(x_sty.fill_color_).font_size(x_sty.values_text_style_.font_size());
- t.tspan(y_sty.separator_).fill_color(y_sty.fill_color_).font_size(y_sty.values_text_style_.font_size());
- if (y_sty.prefix_ != "")
- { // Want a prefix, for example: "length ="
- t.tspan(y_sty.prefix_).fill_color(y_sty.fill_color_).font_size(y_sty.values_text_style_.font_size());
- }
-
- t.tspan(label_yv, y_sty.values_text_style_); // Color
- if (
- (y_sty.plusminus_on_) // Is wanted.
- && (uy > 0.) // Is valid uncertainty estimate.
- )
- { // Uncertainty estimate (usually 95% confidence interval + or - 2 standard deviation).
- // Precision of uncertainty is usually less than value,
- uy *=plusminus; // Tylically + or - 2 standard deviations.
- label_yu = " " + sv(uy, y_sty, true);
- t.tspan(pm).font_family("arial").font_size(fy).fill_color(green);
- t.tspan(label_yu).fill_color(y_sty.plusminus_color_).font_size(fy);
- }
- if ((y_sty.df_on_ == true)
- && (dfy != (std::numeric_limits<unsigned short int>::max)())
- )
- { // degrees of freedom or number of values -1 used for this estimate.
- std::stringstream label;
- label.precision(4);
- //label.flags(sty.value_ioflags_); // Leave at default.
- label <<" (" << dfy << ")"; // "123.5"
- label_ydf = label.str();
- t.tspan(label_ydf).fill_color(y_sty.df_color_).font_size(fy);
- }
- if (y_sty.suffix_ != "")
- { // Want a suffix like "]" - with the Y values font size, (not reduced for uncertainty info), and same color as prefix.
- t.tspan(y_sty.suffix_).fill_color(y_sty.fill_color_).font_size(y_sty.values_text_style_.font_size());
- }
- }
- else
- { // Move ready to put Y value on 'newline' below point marker.
- // Problem here if orientation is changed? - Yes - doesn't line up :-(
- if (y_sty.prefix_ != "")
- { //
- label_yv = y_sty.prefix_ + label_yv;
- }
- double dy = y_sty.values_text_style_.font_size() * 2.2; // "newline"
- // Need to start a new text_element here because tspan rotation doesn't apply to whole string?
- text_element& ty = y_g_ptr.text(x, y + dy, label_yv, y_sty.values_text_style_, al, rot);
-
- if ((y_sty.plusminus_on_ == true) // Is wanted.
- && (uy > 0.) // Is valid uncertainty estimate.
- )
- { // Uncertainty estimate usually 95% confidence interval + or - 2 standard deviation.
- // Precision of uncertainty is usually less than value,
- label_yu = " " + sv(uy, y_sty, true);
- ty.tspan(pm).font_family("arial").font_size(fy).fill_color(y_sty.plusminus_color_);
- ty.tspan(label_yu).fill_color(y_sty.plusminus_color_).font_size(fy);
- }
- if ((y_sty.df_on_ == true) // Is wanted.
- && (dfy != (std::numeric_limits<unsigned short int>::max)()) // and deg_free is defined OK.
- )
- { // degrees of freedom or number of values -1 used for this estimate.
- std::stringstream label;
- label.precision(4);
- //label.flags(sty.value_ioflags_); // Leave at default.
- label <<" (" << dfy << ")"; // "123.5"
- label_ydf = label.str();
- ty.tspan(label_ydf).fill_color(y_sty.df_color_).font_size(fy);
- }
- if (y_sty.suffix_ != "")
- { // Want a suffix like "]" or "sec]" or " sec]"
- ty.tspan(y_sty.suffix_).fill_color(y_sty.fill_color_).font_size(y_sty.values_text_style_.font_size());
- }
- }
- } // void draw_plot_point_values(double x, double y, g_element& g_ptr, double value)
-
- void clear_all()
- { //! Clear all layers of the plot.
- /*! \details
- When writing to multiple documents, the contents of the plot
- may change significantly between. Rather than figuring out what
- has and has not changed, just erase the contents of the
- legend, title... in the document and start over.
- */
- clear_legend();
- clear_background();
- clear_x_axis();
- clear_y_axis();
- clear_title();
- clear_points();
- clear_plot_background();
- clear_grids();
- }
+ void clear_all(); // Calls all the other clear_* functions.
+ void clear_legend();
+ void clear_background();
+ void clear_x_axis();
+ void clear_y_axis();
+ void clear_title();
+ void clear_points();
+ void clear_plot_background();
+ void clear_grids();
- void clear_background()
- { //! Clear the whole image background layer of the SVG plot.
- derived().image_.g(PLOT_BACKGROUND).clear();
- }
-
- void clear_title()
- { //! Clear the plot title layer of the SVG plot.
- derived().image_.g(PLOT_TITLE).clear();
- }
-
- void clear_points()
- { //! Clear the data points layer of the SVG plot.
- derived().image_.g(PLOT_DATA_POINTS).clear();
- }
-
- void clear_plot_background()
- { //! Clear the plot area background layer of the SVG plot.
- derived().image_.g(PLOT_WINDOW_BACKGROUND).clear();
- }
-
- void clear_legend()
- { //! Clear the legend layer of the SVG plot.
- derived().image_.g(PLOT_LEGEND_BACKGROUND).clear();
- derived().image_.g(PLOT_LEGEND_POINTS).clear();
- derived().image_.g(PLOT_LEGEND_TEXT).clear();
- }
-
- void clear_x_axis()
- { //! Clear the X axis layer of the SVG plot.
- derived().image_.g(PLOT_X_AXIS).clear();
- derived().image_.g(PLOT_X_MINOR_TICKS).clear();
- derived().image_.g(PLOT_X_MAJOR_TICKS).clear();
- derived().image_.g(PLOT_X_LABEL).clear();
- derived().image_.g(PLOT_X_TICKS_VALUES).clear();
- }
-
- void clear_y_axis()
- { //! Clear the Y axis layer of the SVG plot.
- derived().image_.g(PLOT_Y_AXIS).clear();
- derived().image_.g(PLOT_Y_MINOR_TICKS).clear();
- derived().image_.g(PLOT_Y_MAJOR_TICKS).clear();
- derived().image_.g(PLOT_Y_LABEL).clear();
- }
- void clear_grids()
- { //! Clear the grids layer of the SVG plot.
- derived().image_.g(PLOT_X_MAJOR_GRID).clear();
- derived().image_.g(PLOT_X_MINOR_GRID).clear();
- derived().image_.g(PLOT_Y_MAJOR_GRID).clear();
- derived().image_.g(PLOT_Y_MINOR_GRID).clear();
- }
- public: //temporary for experimental gil
+ public: // Could be private but benefits unclear?
// private:
Derived& derived()
@@ -1828,6 +271,8 @@
bool legend_lines();//!< \return true if legend should include samples of the lines joining data points.
Derived& legend_on(bool cmd); //!< Set true if a legend is wanted.
bool legend_on(); //!< \return true if a legend is wanted.
+ Derived& x_axis_vertical(double fraction); //! Set vertical position of X-axis for 1D as fraction of plot window.
+ bool x_axis_vertical(); //! \return vertical position of X-axis for 1D as fraction of plot window.
Derived& legend_place(legend_places l); //!< Set the position of the legend, \see boost::svg::legend_places
legend_places legend_place(); //!< \return the position of the legend, \see boost::svg::legend_places
bool legend_outside(); //!< \return if the legend should be outside the plot area.
@@ -2003,19 +448,39 @@
int x_values_precision(); //!< \return iostream decimal digits precision of data point X values near data points markers.
Derived& x_values_ioflags(std::ios_base::fmtflags f); //!< Set iostream format flags of data point X values near data points markers.
std::ios_base::fmtflags x_values_ioflags(); //!< \return iostream format flags of data point X values near data points markers.
- Derived& x_plusminus_on(bool b); //!< Set if to append uncertainty estimate to data point X values near data points markers.
- bool x_plusminus_on(); //!< \return true if to append uncertainty estimate to data point X values near data points markers.
- Derived& x_plusminus_color(const svg_color& col); //!< Set the color of X uncertainty of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
- svg_color x_plusminus_color(); //!< \return the color of X uncertainty of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
+ Derived& x_plusminus_on(bool b); //!< Set if to append std_dev estimate to data point X values near data points markers.
+ bool x_plusminus_on(); //!< \return true if to append std_dev estimate to data point X values near data points markers.
+ Derived& x_plusminus_color(const svg_color& col); //!< Set the color of X std_dev of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
+ svg_color x_plusminus_color(); //!< \return the color of X std_dev of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
+
+ Derived& x_addlimits_on(bool b); //!< Set if to append confidence limits to data point X values near data points markers.
+ bool x_addlimits_on(); //!< \return true if to append confidence limits estimate to data point X values near data points markers.
+ Derived& x_addlimits_color(const svg_color& col); //!< Set the color of X confidence limits of value, for example, the color in "<1.23, 1.45>".
+ svg_color x_addlimits_color(); //!< \return the color of X confidence limits of value, for example, the color of "<1.23, 1.45>)".
+
+
Derived& x_df_on(bool b); //!< Set true if to append a degrees of freedom estimate to data point X values near data points markers.
bool x_df_on(); //!< \return true if to append a degrees of freedom estimate to data point X values near data points markers.
Derived& x_df_color(const svg_color& col); //!< Set the color of X degrees of freedom, for example, the color of 9 in "1.23 +-0.02 (9)".
svg_color x_df_color(); //!< \return the color of X degrees of freedom, for example, the color of 9 in "1.23 +-0.02 (9)".
+ Derived& x_id_on(bool b); //!< Set true if to append append an ID or name to data point X values near data points markers.
+ bool x_id_on(); //!< \return true if to append an ID or name to data point X values near data points markers.
+ Derived& x_id_color(const svg_color& col); //!< Set the color of X id or name, for example, the color of text in "my_id".
+ svg_color x_id_color(); //!< \return the color of X X id or name, for example, the color of text in "my_id".
+ Derived& x_datetime_on(bool b); //!< Set true if to append date time to data point X values near data points markers.
+ bool x_datetime_on(); //!< \return true if to append an date time to data point X values near data points markers.
+ Derived& x_datetime_color(const svg_color& col); //!< Set the color of X date time , for example, the color of text in "".
+ svg_color x_datetime_color(); //!< \return the color of X date time, for example, the color of text in "".
+ Derived& x_order_on(bool b); //!< Set true if to append append an order # to data point X values near data points markers.
+ bool x_order_on(); //!< \return true if to append an order # to data point X values near data points markers.
+ Derived& x_order_color(const svg_color& col); //!< Set the color of X order #, for example, the color of #42.
+ svg_color x_order_color(); //!< \return the color of X order #, for example, the color of #42.
Derived& x_decor(const std::string& pre, const std::string& sep = "", const std::string& suf = "");
/*!< Set prefix, separator and suffix together for x_ values.
Note if you want a space, you must use a Unicode space " ",
for example, ", " rather than ASCII space", ".
- */
+ If 1st char in separator == \n, then Y values and info will be on a newline below.
+ */
const std::string x_suffix(); //!< \return the suffix (only used if separator != "")
const std::string x_separator(); //!< \return the separator, perhaps including Unicode.
const std::string x_prefix(); //!< \return the prefix.
@@ -2047,8 +512,12 @@
// autoscale set & get parameters,
// Note: all these *MUST* preceed x_autoscale(data) call.
- Derived& autoscale_plusminus(double); //!< Set how many uncertainty or standard deviation to allow for ellipse when autoscaling.
- double autoscale_plusminus(); //!< \return how many uncertainty or standard deviations to allow for ellipse when autoscaling.
+ Derived& autoscale_plusminus(double); //!< Set how many std_dev or standard deviation to allow for ellipse when autoscaling.
+ double autoscale_plusminus(); //!< \return how many std_dev or standard deviations to allow for ellipse when autoscaling.
+
+ Derived& confidence(double); //!< Set confidence alpha for display of confidence intervals (default 0.05 for 95%).
+ double confidence(); //!< \return Confidence alpha for display of confidence intervals (default 0.05 for 95%).
+
Derived& autoscale_check_limits(bool b); //!< Set to check that values used for autoscale are within limits.
//! Default is true, but can switch off checks for speed if can be sure all are 'inside limits'.
bool autoscale_check_limits();//!< \return True if to check that values used for autoscale are within limits.
@@ -2114,7 +583,7 @@
svg_color three_sd_color(); //!< \return Color for three standard deviation (~99% confidence) ellipse fill.
//// Stylesheet.
- // Removed for now to avoid compile warning in spirit.
+ // Removed for now to avoid compile warning in Spirit.
//Derived& load_stylesheet(const std::string& file)
//{
@@ -2139,2171 +608,645 @@
// class axis_plot_frame Member function Definitions (for .ipp file):
- template <class Derived>
- /*! \tparam Derived plot class, svg_1d_plot or svg_2d_plot or svg_boxplot.
- */
- template <class T>
- /*! \tparam T an STL container: array, vector, list, map ...
- */
-
- Derived& axis_plot_frame<Derived>::x_autoscale(const T& begin, const T& end)
- { //! Data series (range accessed using iterators) to use to calculate autoscaled X-axis values.
- scale_axis(begin, end,
- &derived().x_auto_min_value_, &derived().x_auto_max_value_, &derived().x_auto_tick_interval_, &derived().x_auto_ticks_,
- derived().autoscale_check_limits_, derived().autoscale_plusminus_,
- derived().x_include_zero_, derived().x_tight_, derived().x_min_ticks_, derived().x_steps_);
-
- derived().x_autoscale_ = true; //! Default to use calculated values.
- return derived();
- } // x_autoscale(const T& begin, const T& end)
+
+ template <class Derived>/*! \tparam Derived plot class, svg_1d_plot or svg_2d_plot or svg_boxplot. */
+ template <class T> /*! \tparam T an STL container: array, vector, list, map ... */
+ Derived& axis_plot_frame<Derived>::x_autoscale(const T& begin, const T& end);
template <class Derived>
template <class T> // T an STL container: array, vector...
- Derived& axis_plot_frame<Derived>::x_autoscale(const T& container) // Use whole 1D data series.
- { //! Data series (all values) to use to calculate autoscaled X-axis values.
- //scale_axis(container.begin(), container.end(), // All the container.
- scale_axis(container, // All the container.
- &derived().x_auto_min_value_, &derived().x_auto_max_value_, &derived().x_auto_tick_interval_, &derived().x_auto_ticks_,
- derived().autoscale_check_limits_, derived().autoscale_plusminus_,
- derived().x_include_zero_, derived().x_tight_, derived().x_min_ticks_, derived().x_steps_);
-
- derived().x_autoscale_ = true; // Default is to use calculated values.
- return derived();
- } // x_autoscale(const T& container)
-
- template <class Derived>
- Derived& axis_plot_frame<Derived>::size(unsigned int x, unsigned int y)
- { //! Set SVG image size (SVG units, default pixels).
- // Might put default sizes here?
- // Check on sanity of these values?
- derived().image_.size(x, y);
- return derived();
- }
-
- template <class Derived>
- std::pair<double, double> axis_plot_frame<Derived>::size()
- { //! \return SVG image size, both horizontal width and vertical height (SVG units, default pixels).
- return derived().image_.xy_sizes();
- }
+ Derived& axis_plot_frame<Derived>::x_autoscale(const T& container); // Use whole 1D data series.
template <class Derived>
- unsigned int axis_plot_frame<Derived>::image_x_size() //!< Obselete - deprecated.
- { //! \return SVG image X-axis size as horizontal width (SVG units, default pixels).
- return derived().image_.x_size();
- }
+ Derived& axis_plot_frame<Derived>::size(unsigned int x, unsigned int y);
+ template <class Derived>
+ std::pair<double, double> axis_plot_frame<Derived>::size();
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_size()
- { //! \return SVG image X-axis size as horizontal width (SVG units, default pixels).
- return derived().image_.x_size();
- }
+ unsigned int axis_plot_frame<Derived>::image_x_size(); //!< Obselete - deprecated.
- template <class Derived>
- Derived& axis_plot_frame<Derived>::image_x_size(unsigned int i) //!< Obselete - deprecated.
- { //! Set SVG image X-axis size (SVG units, default pixels).
- // Can't this be x_size(unsigned int i)
- derived().image_.x_size(i);
- return derived();
- }
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_size(unsigned int i);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_size(unsigned int i)
- { //! Set SVG image X-axis size (SVG units, default pixels).
- // Can't this be x_size(unsigned int i)
- derived().image_.x_size(i);
- return derived();
- }
+ unsigned int axis_plot_frame<Derived>::x_size();
template <class Derived>
- unsigned int axis_plot_frame<Derived>::image_y_size() //!< Obselete - deprecated.
- { //! \return SVG image Y-axis size as vertical height (SVG units, default pixels).
- return derived().image_.y_size();
- }
+ Derived& axis_plot_frame<Derived>::image_x_size(unsigned int i); //!< Obselete - deprecated.
template <class Derived>
- Derived& axis_plot_frame<Derived>::image_y_size(unsigned int i) //!< Obselete - deprecated.
- {//! Set SVG image Y-axis size (SVG units, default pixels).
- derived().image_.y_size(i);
- return derived();
- }
+ unsigned int axis_plot_frame<Derived>::image_y_size(); //!< Obselete - deprecated.
template <class Derived>
- unsigned int axis_plot_frame<Derived>::y_size()
- { //! \return SVG image Y-axis size as vertical height (SVG units, default pixels).
- return derived().image_.y_size();
- }
+ Derived& axis_plot_frame<Derived>::image_y_size(unsigned int i); //!< Obselete - deprecated.
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_size(unsigned int i)
- {//! Set SVG image Y-axis size (SVG units, default pixels).
- derived().image_.y_size(i);
- return derived();
- }
+ unsigned int axis_plot_frame<Derived>::y_size();
template <class Derived>
- svg_color axis_plot_frame<Derived>::background_color()
- { //! \return plot background color.
- return derived().image_.g(PLOT_BACKGROUND).style().fill_color();
- }
+ Derived& axis_plot_frame<Derived>::y_size(unsigned int i);
+ template <class Derived>
+ svg_color axis_plot_frame<Derived>::background_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::background_color(const svg_color& col)
- { //! Set plot background color.
- derived().image_.g(PLOT_BACKGROUND).style().fill_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::background_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::background_border_color(const svg_color& col)
- { //! Set plot background border color.
- derived().image_.g(PLOT_BACKGROUND).style().stroke_color(col);
- /*!
- background_border_color example:
- \code
-svg_2d_plot my_plot(my_data, "My Data").background_border_color(red).background_color(azure);
- \endcode
- */
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::background_border_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::background_border_color()
- { //! \return plot background border color.
- return derived().image_.g(PLOT_BACKGROUND).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::background_border_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::background_border_width(double w)
- { //! Set plot background border width.
- derived().image_.g(PLOT_BACKGROUND).style().stroke_width(w);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::background_border_width(double w);
template <class Derived>
- double axis_plot_frame<Derived>::background_border_width()
- { //! \return plot background border width.
- return derived().image_.g(PLOT_BACKGROUND).style().stroke_width();
- }
-
+ double axis_plot_frame<Derived>::background_border_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::description(const std::string d)
- { //! Writes description to the document for header as \verbatim <desc> My Data </desc> \endverbatim
- derived().image_.description(d);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::description(const std::string d);
+
template <class Derived>
- const std::string& axis_plot_frame<Derived>::description()
- { //! \return description of the document for header as \verbatim <desc> ... </desc> \endverbatim
- return derived().image_.description();
- }
-
+ const std::string& axis_plot_frame<Derived>::description();
template <class Derived>
- Derived& axis_plot_frame<Derived>::document_title(const std::string d)
- { //! Write document title to the SVG document for header as \verbatim <title> My Title </title> \endverbatim
- derived().image_.document_title(d);
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::document_title(const std::string d);
template <class Derived>
- std::string axis_plot_frame<Derived>::document_title()
- { //! \return document title to the document for header as \verbatim <title> My Title </title> \endverbatim
- return derived().image_.document_title();
- }
+ std::string axis_plot_frame<Derived>::document_title();
template <class Derived>
- Derived& axis_plot_frame<Derived>::copyright_holder(const std::string d)
- { //! Writes copyright_holder to the document
- //! (for header as <!-- SVG Plot Copyright Paul A. Bristow 2007 --> )
- //! and as \verbatim metadata: <meta name="copyright" content="Paul A. Bristow" /meta> \endverbatim
- derived().image_.copyright_holder(d);
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::copyright_holder(const std::string d);
template <class Derived>
- const std::string axis_plot_frame<Derived>::copyright_holder()
- { //! \return copyright holder.
- return derived().image_.copyright_holder();
- }
-
+ const std::string axis_plot_frame<Derived>::copyright_holder();
template <class Derived>
- Derived& axis_plot_frame<Derived>::copyright_date(const std::string d)
- { //! Writes copyright date to the document.
- //! and as \verbatim metadata <meta name="date" content="2007" /> \endverbatim
- derived().image_.copyright_date(d);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::copyright_date(const std::string d);
template <class Derived>
- const std::string axis_plot_frame<Derived>::copyright_date()
- { //! \return copyright_date.
- return derived().image_.copyright_date();
- }
+ const std::string axis_plot_frame<Derived>::copyright_date();
template <class Derived>
Derived& axis_plot_frame<Derived>::license(std::string repro,
std::string distrib,
std::string attrib,
std::string commercial,
- std::string derivative)
- { //! Set license conditions for reproduction, attribution, commercial use, and derivative works,
- //! usually "permits", "requires", or "prohibits",
- //! and set license_on == true.
- // Might check these are "permits", "requires", or "prohibits"?
- derived().image_.license(repro, distrib, attrib, commercial, derivative);
- return derived();
- }
-
- template <class Derived>
- bool axis_plot_frame<Derived>::license_on()
- { //! \return true if license conditions should be included in the SVG document.
- //! \see axis_plot_frame::license
- return derived().image_.license_on();
- }
+ std::string derivative);
template <class Derived>
- Derived& axis_plot_frame<Derived>::license_on(bool l)
- { //! Set if license conditions should be included in the SVG document.
- //! \see axis_plot_frame::license
- derived().image_.license_on(l);
- return derived();
- }
+ bool axis_plot_frame<Derived>::license_on();
template <class Derived>
- bool axis_plot_frame<Derived>::boost_license_on()
- { //! \return if the Boost license conditions should be included in the SVG document.
- //! To set see axis_plot_frame::boost_license_on(bool).
- return derived().image_.boost_license_one();
- }
+ Derived& axis_plot_frame<Derived>::license_on(bool l);
template <class Derived>
- Derived& axis_plot_frame<Derived>::boost_license_on(bool l)
- { //! Set if the Boost license conditions should be included in the SVG document.
- derived().image_.boost_license_on(l);
- return derived();
- }
+ bool axis_plot_frame<Derived>::boost_license_on();
template <class Derived>
- const std::string axis_plot_frame<Derived>::license_reproduction()
- { //! \return reproduction license conditions, usually "permits", "requires", or "prohibits".
- return derived().image_.reproduction();
- }
-
+ const std::string axis_plot_frame<Derived>::license_reproduction();
template <class Derived>
- const std::string axis_plot_frame<Derived>::license_distribution()
- { //! \return distribution license conditions, usually "permits", "requires", or "prohibits".
- return derived().image_.distribution();
- }
-
+ const std::string axis_plot_frame<Derived>::license_distribution();
template <class Derived>
- const std::string axis_plot_frame<Derived>::license_attribution()
- { //! \return attribution license conditions, usually "permits", "requires", or "prohibits".
- return derived().image_.attribution();
- }
-
+ const std::string axis_plot_frame<Derived>::license_attribution();
template <class Derived>
- const std::string axis_plot_frame<Derived>::license_commercialuse()
- { //! \return commercial use license conditions, usually "permits", "requires", or "prohibits".
- return derived().image_.commercialuse();
- }
-
+ Derived& axis_plot_frame<Derived>::coord_precision(int digits);
template <class Derived>
- Derived& axis_plot_frame<Derived>::coord_precision(int digits)
- { /*! Precision of SVG coordinates in decimal digits (default 3).
- 3 decimal digits precision is sufficient for small images.
- 4 or 5 decimal digits precision will give higher quality plots,
- especially for larger images, at the expense of larger .svg files,
- particularly if there are very many data points.
- */
- derived().image_.coord_precision(digits);
- return derived();
- }
-
+ int axis_plot_frame<Derived>::coord_precision();
template <class Derived>
- int axis_plot_frame<Derived>::coord_precision()
- { //! \return precision of SVG coordinates in decimal digits.
- return derived().image_.coord_precision();
- }
-
+ Derived& axis_plot_frame<Derived>::x_value_precision(int digits);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_value_precision(int digits)
- { /*! Precision of X tick label values in decimal digits (default 3).
- 3 decimal digits precision is sufficient for small images.
- 4 or 5 decimal digits precision will give more cluttered plots.
- If the range of labels is very small, then more digits will be essential.
- */
+ int axis_plot_frame<Derived>::x_value_precision();
- derived().x_ticks_.value_precision_ = digits;
- return derived();
- }
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_value_ioflags(int flags);
template <class Derived>
- int axis_plot_frame<Derived>::x_value_precision()
- { //! \return precision of X tick label values in decimal digits
- return derived().x_ticks_.value_precision_;
- }
+ int axis_plot_frame<Derived>::x_value_ioflags();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_value_ioflags(int flags)
- { /*! Set iostream std::ios::fmtflags for X value label (default decimal == 0X201).
- Mainly useful for changing to scientific, fixed or hexadecimal format.
- For example: .x_value_ioflags(std::ios::dec | std::ios::scientific)
- */
- derived().x_ticks_.value_ioflags_ = flags;
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::x_labels_strip_e0s(bool cmd);
template <class Derived>
- int axis_plot_frame<Derived>::x_value_ioflags()
- { //! \return stream ioflags for control of format of X value labels.
- return derived().x_ticks_.value_ioflags_;
- }
+ bool axis_plot_frame<Derived>::y_labels_strip_e0s();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_labels_strip_e0s(bool cmd)
- { //! Set if to strip redundant zeros, signs and exponents, for example, reducing "1.2e+000" to "1.2"
- //! This markedly reduces visual clutter, and is the default.
- derived().x_ticks_.strip_e0s_ = cmd;
- return derived();
- }
+ const std::string axis_plot_frame<Derived>::title();
template <class Derived>
- bool axis_plot_frame<Derived>::y_labels_strip_e0s()
- { //! \return if to strip redundant zeros, signs and exponents, for example, reducing "1.2e+000" to "1.2"
- return derived().x_ticks_.strip_e0s_;
- }
+ Derived& axis_plot_frame<Derived>::title_font_size(unsigned int i);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title(const std::string title)
- { /*!
- Set a title for plot.
- The string may include Unicode for greek letter and symbols.
- For example a title that includes a greek omega and degree symbols:
- \verbatim my_plot.title("Plot of Ω function (°C)"); \endverbatim
+ unsigned int axis_plot_frame<Derived>::title_font_size();
- Unicode symbols are at http://unicode.org/charts/symbols.html .
- */
- // Plot title. TODO
- // new text parent code pushback
- // effectively concatenates with any existing title.
- // So clear the existing string first but doesn't work,
- // so need to clear the whole g_element.
- //derived().image_.g(PLOT_TITLE).clear();
- derived().title_info_.text(title);
- derived().title_on_ = true; // Assume display wanted, if bother to set title.
- return derived();
- }
template <class Derived>
- const std::string axis_plot_frame<Derived>::title()
- { //! \return a title for plot, whose string may include Unicode for greek letter and symbols.
- return derived().title_info_.text();
- }
+ Derived& axis_plot_frame<Derived>::title_font_family(const std::string& family);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_size(unsigned int i)
- { //! Sets the font size for the title (svg units, default pixels).
- derived().title_info_.textstyle().font_size(i);
- return derived();
- }
+ const std::string& axis_plot_frame<Derived>::title_font_family();
template <class Derived>
- unsigned int axis_plot_frame<Derived>::title_font_size()
- { //! \return the font size for the title (svg units, default pixels).
- return derived().title_info_.textstyle().font_size();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_style(const std::string& style);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_family(const std::string& family)
- { //! Set the font family for the title (for example: .title_font_family("Lucida Sans Unicode");
- derived().title_info_.textstyle().font_family(family);
- return derived();
- }
-
+ const std::string& axis_plot_frame<Derived>::title_font_style();
template <class Derived>
- const std::string& axis_plot_frame<Derived>::title_font_family()
- { //! \return the font family for the title
- return derived().title_info_.textstyle().font_family();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_weight(const std::string& weight);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_style(const std::string& style)
- { //! Set the font style for the title (default normal).
- derived().title_info_.textstyle().font_style(style);
- return derived();
- }
-
+ const std::string& axis_plot_frame<Derived>::title_font_weight();
template <class Derived>
- const std::string& axis_plot_frame<Derived>::title_font_style()
- { //! \return the font style for the title (default normal).
- return derived().title_info_.textstyle().font_style();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_stretch(const std::string& stretch);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_weight(const std::string& weight)
- { //! Set the font weight for the title (default normal).
- derived().title_info_.textstyle().font_weight(weight);
- return derived();
- }
-
+ const std::string& axis_plot_frame<Derived>::title_font_stretch();
template <class Derived>
- const std::string& axis_plot_frame<Derived>::title_font_weight()
- {//! \return the font weight for the title.
- return derived().title_info_.textstyle().font_weight();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_decoration(const std::string& decoration);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_stretch(const std::string& stretch)
- { //! Set the font stretch for the title (default normal), wider or narrow.
- derived().title_info_.textstyle().font_stretch(stretch);
- return derived();
- }
-
+ const std::string& axis_plot_frame<Derived>::title_font_decoration();
template <class Derived>
- const std::string& axis_plot_frame<Derived>::title_font_stretch()
- { //! \return the font stretch for the title.
- return derived().title_info_.textstyle().font_stretch();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_rotation(rotate_style rotate);
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_decoration(const std::string& decoration)
- { //! Set the font decoration for the title (default normal, or underline, overline or strike-thru).
- derived().title_info_.textstyle().font_decoration(decoration);
- return derived();
- }
-
- template <class Derived>
- const std::string& axis_plot_frame<Derived>::title_font_decoration()
- { //! \return the font decoration for the title (default normal, or underline, overline or strike-thru).
- return derived().title_info_.textstyle().font_decoration();
- }
-
+ int axis_plot_frame<Derived>::title_font_rotation();
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_rotation(rotate_style rotate)
- { //! Set the rotation for the title font (degrees, 0 to 360).
- derived().title_info_.rotation(rotate);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::title_font_alignment(align_style alignment);
template <class Derived>
- int axis_plot_frame<Derived>::title_font_rotation()
- { //! \return the rotation for the title font (degrees).
- return derived().title_info_.rotation();
- }
-
+ align_style axis_plot_frame<Derived>::title_font_alignment();
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_font_alignment(align_style alignment)
- { //! Set the alignment for the title.
- derived().title_info_.alignment(alignment);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_width(double width);
template <class Derived>
- align_style axis_plot_frame<Derived>::title_font_alignment()
- { //! \return the alignment for the title.
- return derived().title_info_.alignment();
- }
-
- // Legend.
-
+ double axis_plot_frame<Derived>::legend_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_width(double width)
- { //! Set the width for the legend.
- derived().legend_width_ = width;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_title(const std::string title);
template <class Derived>
- double axis_plot_frame<Derived>::legend_width()
- { //! \return the width for the legend.
- return derived().legend_width_;
- }
-
+ const std::string axis_plot_frame<Derived>::legend_title();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_title(const std::string title)
- { //! Set the title for the legend.
- derived().legend_header_.text(title);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_font_weight(const std::string& weight);
template <class Derived>
- const std::string axis_plot_frame<Derived>::legend_title()
- { //! \return the title for the legend.
- return derived().legend_header_.text();
- }
-
+ const std::string& axis_plot_frame<Derived>::legend_font_weight();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_font_weight(const std::string& weight)
- { //! Set the font weight for the legend title.
- derived().legend_header_.textstyle().font_weight(weight);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_font_family(const std::string& family);
template <class Derived>
- const std::string& axis_plot_frame<Derived>::legend_font_weight()
- { //! \return the font weight for the legend title.
- return derived().legend_header_.textstyle().font_weight();
- }
-
+ const std::string& axis_plot_frame<Derived>::legend_font_family();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_font_family(const std::string& family)
- { //! Set the font family for the legend title.
- derived().legend_header_.textstyle().font_family(family);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_title_font_size(unsigned int size);
template <class Derived>
- const std::string& axis_plot_frame<Derived>::legend_font_family()
- { //! \return the font family for the legend title.
- return derived().legend_header_.textstyle().font_family();
- }
-
+ unsigned int axis_plot_frame<Derived>::legend_title_font_size();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_title_font_size(unsigned int size)
- { //! Set the font size for the legend title (svg units, default pixels).
- derived().legend_header_.textstyle().font_size(size);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_top_left(double x, double y);
template <class Derived>
- unsigned int axis_plot_frame<Derived>::legend_title_font_size()
- { //! \return the font size for the legend title (svg units, default pixels).
- return derived().legend_header_.textstyle().font_size();
- }
-
+ const std::pair<double, double> axis_plot_frame<Derived>::legend_top_left();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_top_left(double x, double y)
- { //! Set position of top left of legend box (svg coordinates, default pixels).
- //! Bottom right is controlled by contents, so the user cannot set it.
- if((x < 0) || (x > derived().image_.x_size()) || (y < 0) || (y > derived().image_.y_size()))
- {
- throw std::runtime_error("Legend box position outside image!");
- }
- derived().legend_left_ = x;
- derived().legend_top_ = y;
- return derived();
- }
+ const std::pair<double, double> axis_plot_frame<Derived>::legend_bottom_right();
template <class Derived>
- const std::pair<double, double> axis_plot_frame<Derived>::legend_top_left()
- { //! \return svg coordinate (default pixels) of top left of legend box.
- std::pair<double, double> r;
- r.first = derived().legend_left_;
- r.second = derived().legend_top_;
- return r;
- }
-
+ Derived& axis_plot_frame<Derived>::legend_lines(bool is);
template <class Derived>
- const std::pair<double, double> axis_plot_frame<Derived>::legend_bottom_right()
- { //! \return svg coordinate (default pixels) of Bottom right of legend box.
- std::pair<double, double> r;
- r.first = derived().legend_right_;
- r.second = derived().legend_bottom_;
- return r;
- }
+ bool axis_plot_frame<Derived>::legend_lines();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_lines(bool is)
- { //! Set true if legend should include samples of the lines joining data points.
- //! \details This allows different series of data points to be distinguished by different color and/or width.
- //! This is especially useful to show plots of different functions and/or different parameters in different colors.
- derived().legend_lines_ = is;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_on(bool cmd);
template <class Derived>
- bool axis_plot_frame<Derived>::legend_lines()
- {//! \return true if legend should include samples of the lines joining data points.
- return derived().legend_lines_;
- }
-
+ bool axis_plot_frame<Derived>::legend_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_on(bool cmd)
- { //! Set true if a legend is wanted.
- derived().legend_on_ = cmd;
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::x_axis_vertical(double fraction);
template <class Derived>
- bool axis_plot_frame<Derived>::legend_on()
- { //! \return true if a legend is wanted.
- return derived().legend_on_;
- }
-
+ bool axis_plot_frame<Derived>::x_axis_vertical();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_place(legend_places l)
- { //! Set the position of the legend, \see boost::svg::legend_places
- derived().legend_place_ = l;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_place(legend_places l);
template <class Derived>
- legend_places axis_plot_frame<Derived>::legend_place()
- { //! \return the position of the legend, \see boost::svg::legend_places
- return derived().legend_place_;
- }
-
+ legend_places axis_plot_frame<Derived>::legend_place();
template <class Derived>
- bool axis_plot_frame<Derived>::legend_outside()
- { //! \return if the legend should be outside the plot area.
- return derived().outside_legend_on_;
- }
-
+ bool axis_plot_frame<Derived>::legend_outside();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_header_font_size(int size)
- { //! Set legend header font size (svg units, default pixels).
- derived().legend_header_.textstyle().font_size(size);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_header_font_size(int size);
template <class Derived>
- int axis_plot_frame<Derived>::legend_header_font_size()
- { //! \return legend header font size (svg units, default pixels).
- return derived().legend_header_.textstyle().font_size();
- }
-
+ int axis_plot_frame<Derived>::legend_header_font_size();
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_window_on(bool cmd)
- { //! Set true if a plot window is wanted (or false if the whole image is to be used).
- derived().plot_window_on_ = cmd;
- if(cmd)
- { // Set plot window.
- derived().image_.g(detail::PLOT_WINDOW_BACKGROUND).style()
- .fill_color(derived().plot_window_border_.fill_) // background color and
- .stroke_color(derived().plot_window_border_.stroke_); // border color.
- }
- //derived().legend_place_ = outside_right;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::plot_window_on(bool cmd);
template <class Derived>
- bool axis_plot_frame<Derived>::plot_window_on()
- {//! \return true if a plot window is wanted (or false if the whole image is to be used).
- return derived().plot_window_on_;
- }
-
+ bool axis_plot_frame<Derived>::plot_window_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_border_color(const svg_color& col)
- { //! Set the color for the plot window background.
- derived().plot_window_border_.stroke_ = col;
- derived().image_.g(detail::PLOT_WINDOW_BACKGROUND).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::plot_border_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::plot_border_color()
- { //! \return the color for the plot window background.
- return derived().image_.g(detail::PLOT_WINDOW_BACKGROUND).style().stroke_color();
- }
-
+ double axis_plot_frame<Derived>::plot_border_width();
template <class Derived>
- double axis_plot_frame<Derived>::plot_border_width()
- { //! \return the width for the plot window border (svg units, default pixels).
- return derived().image_.g(detail::PLOT_WINDOW_BACKGROUND).style().stroke_width();
- }
-
+ Derived& axis_plot_frame<Derived>::plot_border_width(double w);
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_border_width(double w)
- { //! Set the width for the plot window border (svg units, default pixels).
- derived().plot_window_border_.width_ = w;
- derived().image_.g(detail::PLOT_WINDOW_BACKGROUND).style().stroke_width(w);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::image_border_margin(double w);
+ template <class Derived>
+ double axis_plot_frame<Derived>::image_border_margin();
template <class Derived>
- Derived& axis_plot_frame<Derived>::image_border_margin(double w)
- { //! Set the margin around the plot window border (svg units, default pixels).
- //! \details This prevents the plot window getting too close to other elements of the plot.
- derived().image_border_.margin_ = w;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::image_border_width(double w);
template <class Derived>
- double axis_plot_frame<Derived>::image_border_margin()
- { //! \return the margin around the plot window border (svg units, default pixels).
- return derived().image_border_.margin_;
- }
-
+ double axis_plot_frame<Derived>::image_border_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::image_border_width(double w)
- { //! Set the svg image border width (svg units, default pixels).
- derived().image_border_.width_ = w;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::plot_window_x(double min_x, double max_x);
template <class Derived>
- double axis_plot_frame<Derived>::image_border_width()
- { //! \return the svg image border width (svg units, default pixels).
- return derived().image_border_.width_;
- }
+ Derived& axis_plot_frame<Derived>::plot_window_y(double min_y, double max_y);
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_window_x(double min_x, double max_x)
- { //! Set the minimum and maximum (cartesian data units) for the plot window X axis.
- //! This is normally calculated from other plot values.
- if(max_x <= min_x)
- {
- throw std::runtime_error("plot_window X: x_max_ <= x_min_");
- }
- if((max_x - min_x) < std::numeric_limits<double>::epsilon() * 1000)
- { // Range too small to display.
- throw std::runtime_error("plot_window X range too small!" );
- }
- derived().plot_left_ = min_x;
- derived().plot_right_ = max_x;
- return derived();
- }
+ double axis_plot_frame<Derived>::plot_window_x_left();
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_window_y(double min_y, double max_y)
- { //! Set the minimum and maximum (cartesian data units) for the plot window Y axis.
- //! This is normally calculated from other plot values.
-
- if(max_y <= min_y)
- {
- throw std::runtime_error("plot_window Y: y_max_ <= x_min_");
- }
- if(max_y <= min_y)
- {
- throw std::runtime_error("plot_window Y range too small!");
- }
- derived().plot_top_ = min_y;
- derived().plot_bottom_ = max_y;
- return derived();
- }
-
- // Get the minimum and maximum (cartesian data units) for the plot window axes.
-
+ double axis_plot_frame<Derived>::plot_window_x_right();
template <class Derived>
- double axis_plot_frame<Derived>::plot_window_x_left()
- { //! \return left of the plot window.
- return derived().plot_left_;
- }
+ double axis_plot_frame<Derived>::plot_window_y_top();
template <class Derived>
- double axis_plot_frame<Derived>::plot_window_x_right()
- { //! \return right of the plot window.
- return derived().plot_right_;
- }
+ double axis_plot_frame<Derived>::plot_window_y_bottom();
template <class Derived>
- double axis_plot_frame<Derived>::plot_window_y_top()
- { //! \return top of the plot window.
- return derived().plot_top_;
- }
-
+ std::pair<double, double> axis_plot_frame<Derived>::plot_window_x();
template <class Derived>
- double axis_plot_frame<Derived>::plot_window_y_bottom()
- { //! \return top of the plot window.
- return derived().plot_bottom_;
- }
-
+ std::pair<double, double> axis_plot_frame<Derived>::plot_window_y();
template <class Derived>
- std::pair<double, double> axis_plot_frame<Derived>::plot_window_x()
- { //! \return both the left and right (X axis) of the plot window.
- std::pair<double, double> r;
- r.first = derived().plot_left_;
- r.second = derived().plot_right_;
- return r;
- }
-
+ double axis_plot_frame<Derived>::x_minor_interval();
template <class Derived>
- std::pair<double, double> axis_plot_frame<Derived>::plot_window_y()
- { //! \return both the top and bottom (Y axis) of the plot window.
- std::pair<double, double> r;
- r.first = derived().plot_top_;
- r.second = derived().plot_bottom_;
- return r;
- }
-
+ double axis_plot_frame<Derived>::y_minor_interval();
template <class Derived>
- double axis_plot_frame<Derived>::x_minor_interval()
- { //! \return interval between X minor ticks.
- return derived().x_ticks_.minor_interval_; // interval
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_up_on(bool cmd);
template <class Derived>
- double axis_plot_frame<Derived>::y_minor_interval()
- { //! \return interval between Y minor ticks.
- return derived().y_ticks_.minor_interval_; // interval
- }
-
+ bool axis_plot_frame<Derived>::x_ticks_up_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_up_on(bool cmd)
- { //! Set true if X major ticks should mark upwards.
- derived().x_ticks_.up_ticks_on_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_down_on(bool cmd);
template <class Derived>
- bool axis_plot_frame<Derived>::x_ticks_up_on()
- { //! \return true if X major ticks should mark upwards.
- return derived().x_ticks_.up_ticks_on_;
- }
-
+ bool axis_plot_frame<Derived>::x_ticks_down_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_down_on(bool cmd)
- { //! Set true if X major ticks should mark downwards.
- derived().x_ticks_.down_ticks_on_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_on(bool cmd);
template <class Derived>
- bool axis_plot_frame<Derived>::x_ticks_down_on()
- { //! \return true if X major ticks should mark downwards.
- return derived().x_ticks_.down_ticks_on_;
- }
- // Only need y_ticks_left_on & y_ticks_right_on in 2D, so not defined here.
-
+ bool axis_plot_frame<Derived>::x_label_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_on(bool cmd)
- { //! Set true if want to show X-axis label text.
- //! \details Also switched on by setting label text.
- //! (on the assumption that if label text is set, display is also wanted,
- //! but can be switched off if \b not required).
- derived().x_axis_.label_on_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_font_size(unsigned int i);
template <class Derived>
- bool axis_plot_frame<Derived>::x_label_on()
- { //! \return true if want to show X-axis label text.
- return derived().x_axis_.label_on_;
- }
-
+ unsigned int axis_plot_frame<Derived>::x_label_font_size();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_font_size(unsigned int i)
- { //! Set X axis label font size (svg units, default pixels).
- derived().x_label_info_.textstyle().font_size(i);
- // Also duplicated at
- // derived().x_axis_label_style_.font_size(i);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_value_font_size(unsigned int i);
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_label_font_size()
- { //! \return X axis label font size (svg units, default pixels).
- return derived().x_label_info_.textstyle().font_size();
- }
-
+ unsigned int axis_plot_frame<Derived>::x_value_font_size();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_value_font_size(unsigned int i)
- { //! Set X tick value label font size (svg units, default pixels).
- derived().x_value_value.textstyle().font_size(i);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_font_family(const std::string& family);
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_value_font_size()
- { //! \return X tick value label font size (svg units, default pixels).
- return derived().x_value_value.textstyle().font_size();
- }
-
+ const std::string& axis_plot_frame<Derived>::x_label_font_family();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_font_family(const std::string& family)
- { //! Set X tick value label font family.
- derived().x_label_info_.textstyle().font_family(family);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_axis_label_color(const svg_color& col);
template <class Derived>
- const std::string& axis_plot_frame<Derived>::x_label_font_family()
- { //! \return X tick value label font family.
- return derived().x_label_info_.textstyle().font_family();
- }
-
+ svg_color axis_plot_frame<Derived>::x_axis_label_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_axis_label_color(const svg_color& col)
- { //! Set X axis label color.
- derived().image_.g(detail::PLOT_X_LABEL).style().fill_color(col);
- //derived().image_.g(detail::PLOT_X_LABEL).style().stroke_color(col);
- // Setting the stroke color produces fuzzy characters :-(
- // Set BOTH stroke and fill to the same color?
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::x_ticks_values_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_axis_label_color()
- { //! \return X axis label color.
- // But only return the fill color.
- return derived().image_.g(detail::PLOT_X_LABEL).style().fill_color();
- }
+ svg_color axis_plot_frame<Derived>::x_ticks_values_color();
- // X-axis tick label style.
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_values_color(const svg_color& col)
- { //! Set X axis tick value label color.
- // Set BOTH stroke and fill to the same color.
- derived().image_.g(detail::PLOT_X_TICKS_VALUES).style().fill_color(col);
- //derived().image_.g(detail::PLOT_X_TICK_VALUE_LABELS).style().stroke_color(col);
- // Setting the stroke color produces fuzzy characters :-(
- //derived().x_ticks_.color_ = col;
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::x_ticks_values_precision(int p);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_ticks_values_color()
- { //! \return X-axis ticks value label color.
- // But only return the fill color.
- return derived().image_.g(detail::PLOT_X_TICKS_VALUES).style().fill_color();
- //return x_ticks_.color_ ;
- }
-
- // ticks_labels_style x_ticks
+ int axis_plot_frame<Derived>::x_ticks_values_precision();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_values_precision(int p)
- { //! Set iostream decimal digits precision of data point X values near data points markers.
- derived().x_ticks_.value_precision_ = p;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_values_ioflags(std::ios_base::fmtflags f);
template <class Derived>
- int axis_plot_frame<Derived>::x_ticks_values_precision()
- { //! \return iostream decimal digits precision of data point X values near data points markers.
- return derived().x_ticks_.value_precision_;
- }
-
+ std::ios_base::fmtflags axis_plot_frame<Derived>::x_ticks_values_ioflags();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_values_ioflags(std::ios_base::fmtflags f)
- { //! Set iostream format flags of data point X values near data points markers.
- //! Useful to set hexadecimal, fixed and scientific, (std::ios::scientific).
- derived().x_ticks_.value_ioflags_ = f;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_values_font_size(unsigned int i);
template <class Derived>
- std::ios_base::fmtflags axis_plot_frame<Derived>::x_ticks_values_ioflags()
- { //! \return iostream format flags of data point X values near data points markers.
- //! Might be used to set hexadecimal, fixed and scientific, (std::ios::scientific).
- return derived().x_ticks_.value_ioflags_;
- }
-
+ unsigned int axis_plot_frame<Derived>::x_ticks_values_font_size();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_values_font_size(unsigned int i)
- { //! Set X ticks value label font size (svg units, default pixels).
- //derived().x_ticks_.value_label_style_.font_size(i);
- derived().x_value_label_info_.textstyle().font_size(i);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_values_font_family(const std::string& family);
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_ticks_values_font_size()
- { //! \return X ticks value label font size (svg units, default pixels).
- // return derived().x_ticks_.value_label_style_.font_size();
- return derived().x_value_label_info_.textstyle().font_size();
-
- //return derived().x_ticks_.value_label_info_.font_size();
- }
-
+ const std::string& axis_plot_frame<Derived>::x_ticks_values_font_family();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_values_font_family(const std::string& family)
- { //! Set X ticks value label font family.
- //derived().x_ticks_.value_label_style_.font_family(family); // is effect same as:
- derived().x_value_label_info_.textstyle().font_family(family);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_ticks_on_window_or_axis(int cmd);
template <class Derived>
- const std::string& axis_plot_frame<Derived>::x_ticks_values_font_family()
- { //! \return X ticks value label font family.
- return derived().x_ticks_.value_label_style_.font_family();
- }
-
+ int axis_plot_frame<Derived>::x_ticks_on_window_or_axis();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_ticks_on_window_or_axis(int cmd)
- { /*! Set X ticks on window or axis
- \arg cmd -1 bottom of plot window,
- \arg cmd 0 on X axis.
- \arg cmd +1 top of plot window.
- */
- derived().x_ticks_.ticks_on_window_or_on_axis_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_units_on(bool cmd);
template <class Derived>
- int axis_plot_frame<Derived>::x_ticks_on_window_or_axis()
- { //! \return if X axis ticks wanted on the window (rather than on axis).\n
- //! -1 bottom of plot window, 0 on X axis, +1 top of plot window.
- return derived().x_ticks_.ticks_on_window_or_on_axis_;
- }
+ bool axis_plot_frame<Derived>::x_label_units_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_units_on(bool cmd)
- { //! Set true if want X axis label to include units (as well as label like "length").
- //! \see x_label_units which also sets true.
- derived().x_axis_.label_units_on_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_labels_side(int place);
template <class Derived>
- bool axis_plot_frame<Derived>::x_label_units_on()
- { //! Set true if want X axis label to include units (as well as label like "length").
- return derived().x_axis_.label_units_on_;
- }
+ int axis_plot_frame<Derived>::x_major_labels_side();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_labels_side(int place)
- { /*! Position of labels for major ticks on horizontal X axis line.
- \arg \c place > 0 labels to left of Y axis line (default),
- \arg \c place = 0 (false) no major tick labels on Y axis.
- \arg \c place > 0 labels to right of Y axis line.
- */
- derived().x_ticks_.major_value_labels_side_ = place;
- return derived(); //! \return reference to svg_2d_plot to make chainable.
- }
+ Derived& axis_plot_frame<Derived>::x_major_label_rotation(rotate_style rot);
template <class Derived>
- int axis_plot_frame<Derived>::x_major_labels_side()
- { //! \return the side for X ticks major value labels.
- return derived().x_ticks_.major_value_labels_side_;
- }
-
+ rotate_style axis_plot_frame<Derived>::x_major_label_rotation();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_label_rotation(rotate_style rot)
- { /*! Set rotation for X ticks major value labels. (Default horizontal).
- \see rotate_style
- */
- derived().x_ticks_.label_rotation_ = rot;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::title_on(bool cmd);
template <class Derived>
- rotate_style axis_plot_frame<Derived>::x_major_label_rotation()
- { /*! \return rotation for X ticks major value labels.
- \see rotate_style
- */
- return derived().x_ticks_.label_rotation_;
- }
-
+ bool axis_plot_frame<Derived>::title_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_on(bool cmd)
- { //! If set true, show a title for the plot.
- derived().title_on_ = cmd;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_grid_on(bool is);
template <class Derived>
- bool axis_plot_frame<Derived>::title_on()
- {//! If true, will show a title for the plot.
- return derived().title_on_;
- }
-
+ bool axis_plot_frame<Derived>::x_major_grid_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_grid_on(bool is)
- { //! If set true, will include a major X-axis grid.
- derived().x_ticks_.major_grid_on_ = is;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_grid_on(bool is);
template <class Derived>
- bool axis_plot_frame<Derived>::x_major_grid_on()
- { //! If true, will include a major X-axis grid.
- return derived().x_ticks_.major_grid_on_;
- }
-
+ bool axis_plot_frame<Derived>::x_minor_grid_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_grid_on(bool is)
- { //! If set true, will include a minor X-axis grid.
- derived().x_ticks_.minor_grid_on_ = is;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::axes_on(bool is);
template <class Derived>
- bool axis_plot_frame<Derived>::x_minor_grid_on()
- {//! If true, will include a minor X-axis grid.
- return derived().x_ticks_.minor_grid_on_;
- }
-
+ bool axis_plot_frame<Derived>::axes_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::axes_on(bool is)
- { //! If set true, draw \b both x and y axes (note plural axes).
- derived().x_axis_.axis_line_on_ = is;
- derived().y_axis_.axis_line_on_ = is; // No meaning for 1D, but set anyway?
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_axis_on(bool is);
template <class Derived>
- bool axis_plot_frame<Derived>::axes_on()
- { //! \return true if \b both x and y axis on.
- return derived().x_axis_.axis_line_on_ && derived().y_axis_.axis_line_on_;
- }
+ bool axis_plot_frame<Derived>::x_axis_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_axis_on(bool is)
- { //! If set true, draw a horizontal X-axis line.
- derived().x_axis_.axis_line_on_ = is;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::background_border_width(double w);
template <class Derived>
- bool axis_plot_frame<Derived>::x_axis_on()
- { //! If true, draw a horizontal X-axis line.
- // Use X in preference to Y for 1D.
- return derived().x_axis_.axis_line_on_;
- }
-
+ double axis_plot_frame<Derived>::background_border_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_axis_on(bool is)
- { //! If set true, draw a vertical Y-axis line.
- derived().y_axis_.axis_line_on_ = is;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::description(const std::string d);
template <class Derived>
- bool axis_plot_frame<Derived>::y_axis_on()
- { //! If true, draw a vertical Y-axis line.
- // Should be always false for 1D.
- return derived().y_axis_.axis_line_on_;
- }
-
- // enums like PLOT_TITLE provide a std:string like "title"
- // colors .stroke_color, .stroke_width and font are set in the appropriate g_element.
+ const std::string& axis_plot_frame<Derived>::description();
template <class Derived>
- Derived& axis_plot_frame<Derived>::title_color(const svg_color& col)
- { //! Set the color of any title of the plot.
- // 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();
- }
+ Derived& axis_plot_frame<Derived>::y_axis_on(bool is);
template <class Derived>
- svg_color axis_plot_frame<Derived>::title_color()
- { //! \return the color of any title of the plot.
- // 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)
- //{ // Set the width of the font for the title of the plot.
- // 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& legend_font_width(double width)
- //{ //! \return the width of the font for the title of the plot.
- // width of text is effectively the boldness.
- // derived().image_.g(PLOT_LEGEND_TEXT).style().stroke_width(width);
- // return derived();
- //}
-
- //double legend_font_width()
- //{ // Set the width of the font for the title of the legend.
- // Probably not useful at present (se above).
- // return derived().image_.g(PLOT_LEGEND_TEXT).style().stroke_width();
- //}
- //double legend_font_width()
- //{ //! \return the width of the font for the title of the legend.
- // return derived().image_.g(PLOT_TITLE).style().stroke_width();
- //}
-
+ bool axis_plot_frame<Derived>::y_axis_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_color(const svg_color& col)
- { //! Set the color of the title of the legend.
- // derived().image_.g(PLOT_LEGEND_TEXT).style().stroke_color(col);
- derived().image_.g(PLOT_LEGEND_TEXT).style().fill_color(col);
- return derived();
- }
+ Derived& axis_plot_frame<Derived>::title_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::legend_color()
- { //! \return the color of the title of the legend.
- // 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().fill_color();
- // return derived().image_.g(PLOT_LEGEND_TEXT).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::title_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_background_color(const svg_color& col)
- { //! Set the background fill color of the legend box.
- derived().legend_box_.fill(col);
- derived().image_.g(PLOT_LEGEND_BACKGROUND).style().fill_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::legend_background_color()
- { //! \return the background fill color of the legend box.
- return derived().image_.g(PLOT_LEGEND_BACKGROUND).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::legend_color();
template <class Derived>
- bool axis_plot_frame<Derived>::legend_box_fill_on()
- { //! \return true if legend box has a background fill color.
- return derived().legend_box_.fill_on();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_background_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::legend_border_color(const svg_color& col)
- { //! Set the border stroke color of the legend box.
- derived().legend_box_.stroke(col);
- derived().image_.g(PLOT_LEGEND_BACKGROUND).style().stroke_color(col);
- return derived();
- }
-
+ svg_color axis_plot_frame<Derived>::legend_background_color();
template <class Derived>
- svg_color axis_plot_frame<Derived>::legend_border_color()
- { //! \return the border stroke color of the legend box.
- return derived().legend_box_.stroke();
- // return derived().image_.g(PLOT_LEGEND_BACKGROUND).style().stroke_color();
- }
-
+ bool axis_plot_frame<Derived>::legend_box_fill_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::plot_background_color(const svg_color& col)
- { //! Set the fill color of the plot window background.
- derived().image_.g(PLOT_WINDOW_BACKGROUND).style().fill_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::legend_border_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::plot_background_color()
- { //! \return the fill color of the plot window background.
- return derived().image_.g(PLOT_WINDOW_BACKGROUND).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::legend_border_color();
template <class Derived>
- const std::string axis_plot_frame<Derived>::x_axis_position()
- { //! \return the position (or intersection with Y-axis) of the X-axis.
- switch(derived().x_axis_position_)
- {
- case top:
- return "x_axis_position top (all Y values < 0)"; break;
- case x_intersects_y:
- return "x_axis_position intersects Y axis (Y range includes zero)"; break;
- case bottom:
- return "x_axis_position bottom (all Y values > 0)"; break;
- default:
- return "?"; break;
- }
- }
-
+ Derived& axis_plot_frame<Derived>::plot_background_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_axis_color(const svg_color& col)
- { //! Set the color of the X-axis line.
- // Note only stroke color is set.
- derived().image_.g(PLOT_X_AXIS).style().stroke_color(col);
- return derived();
- }
-
+ svg_color axis_plot_frame<Derived>::plot_background_color();
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_axis_color()
- { //! \return the color of the X-axis line.
- return derived().image_.g(PLOT_X_AXIS).style().stroke_color();
- }
-
+ const std::string axis_plot_frame<Derived>::x_axis_position();
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_axis_color(const svg_color& col)
- { //! Set the color of the Y-axis line.
- derived().image_.g(PLOT_Y_AXIS).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_axis_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::y_axis_color()
- { //! \return the color of the Y-axis line.
- return derived().image_.g(PLOT_Y_AXIS).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::x_axis_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_color(const svg_color& col)
- { //! Set the color of X-axis label (including any units).
- // add fill as well PAB Oct 07
- derived().image_.g(PLOT_X_LABEL).style().fill_color(col);
- derived().image_.g(PLOT_X_LABEL).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::y_axis_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_label_color()
- { //! \return the color of X-axis label (including any units).
- return derived().image_.g(PLOT_X_LABEL).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::y_axis_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_width(double width)
- { //! Set the width (boldness) of X-axis label (including any units).
- //! (not recommended until browsers implement better).
- // width of text is effectively the boldness.
- derived().image_.g(PLOT_X_LABEL).style().stroke_width(width);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_color(const svg_color& col);
template <class Derived>
- double axis_plot_frame<Derived>::x_label_width()
- { //! \return the width (boldness) of X-axis label (including any units).
- return derived().image_.g(PLOT_X_LABEL).style().stroke_width();
- }
-
+ svg_color axis_plot_frame<Derived>::x_label_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_label_color(const svg_color& col)
- { //! Set the color of Y-axis label (including any units).
- derived().image_.g(PLOT_Y_LABEL).style().fill_color(col);
- derived().image_.g(PLOT_Y_LABEL).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_width(double width);
template <class Derived>
- svg_color axis_plot_frame<Derived>::y_label_color()
- { //! \return the color of Y-axis label (including any units).
- return derived().image_.g(PLOT_Y_LABEL).style().fill_color();
- }
-
+ double axis_plot_frame<Derived>::x_label_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_tick_color(const svg_color& col)
- { //! Set the color of X-axis major ticks.
- derived().image_.g(PLOT_X_MAJOR_TICKS).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::y_label_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_major_tick_color()
- { //! \return the color of X-axis major ticks.
- return derived().image_.g(PLOT_X_MAJOR_TICKS).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::y_label_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_tick_color(const svg_color& col)
- { //! Set the color of X-axis minor ticks.
- derived().image_.g(PLOT_X_MINOR_TICKS).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_tick_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_minor_tick_color()
- { //! \return the color of X-axis minor ticks.
- return derived().image_.g(PLOT_X_MINOR_TICKS).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::x_major_tick_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_grid_color(const svg_color& col)
- { //! Set the color of X-axis major grid lines.
- derived().image_.g(PLOT_X_MAJOR_GRID).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_tick_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_major_grid_color()
- { //! \return the color of X-axis major grid lines.
- return derived().image_.g(PLOT_X_MAJOR_GRID).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::x_minor_tick_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_grid_width(double w)
- { //! Set the width of X-axis major grid lines.
- derived().image_.g(PLOT_X_MAJOR_GRID).style().stroke_width(w);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_grid_color(const svg_color& col);
template <class Derived>
- double axis_plot_frame<Derived>::x_major_grid_width()
- { //! \return the color of X-axis major grid lines.
- return derived().image_.g(PLOT_X_MAJOR_GRID).style().stroke_width();
- }
-
+ svg_color axis_plot_frame<Derived>::x_minor_tick_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_grid_color(const svg_color& col)
- { //! Set the color of X-axis minor grid lines.
- derived().image_.g(PLOT_X_MINOR_GRID).style().stroke_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_grid_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_minor_grid_color()
- { //! \return the color of X-axis minor grid lines.
- return derived().image_.g(PLOT_X_MINOR_GRID).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::x_major_grid_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_grid_width(double w)
- { //! Set the width of X-axis minor grid lines.
- derived().image_.g(PLOT_X_MINOR_GRID).style().stroke_width(w);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_grid_width(double w);
template <class Derived>
- double axis_plot_frame<Derived>::x_minor_grid_width()
- { //! \return the width of X-axis minor grid lines.
- return derived().image_.g(PLOT_X_MINOR_GRID).style().stroke_width();
- }
-
+ double axis_plot_frame<Derived>::x_major_grid_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_axis_width(double width)
- { //! Set the width of X-axis lines.
- derived().image_.g(PLOT_X_AXIS).style().stroke_width(width);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_grid_color(const svg_color& col);
template <class Derived>
- double axis_plot_frame<Derived>::x_axis_width()
- { //! \return the width of X-axis lines.
- return derived().image_.g(PLOT_X_AXIS).style().stroke_width();
- }
-
+ svg_color axis_plot_frame<Derived>::x_minor_grid_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::data_lines_width(double width)
- { //! Set the width of lines joining data points.
- derived().image_.g(PLOT_DATA_LINES).style().stroke_width(width);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_grid_width(double w);
template <class Derived>
- double axis_plot_frame<Derived>::data_lines_width()
- { //! \return the width of lines joining data points.
- return derived().image_.g(PLOT_DATA_LINES).style().stroke_width();
- }
-
+ double axis_plot_frame<Derived>::x_minor_grid_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label(const std::string& str)
- { //! Set the text to label the X-axis (and set x_label_on(true)).
- derived().x_label_info_.text(str);
- derived().x_axis_.label_on_ = true; // Assume want x_label string displayed.
- // Might switch label_on false if null string?
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_axis_width(double width);
template <class Derived>
- std::string axis_plot_frame<Derived>::x_label()
- { //! \return the text to label the X-axis.
- return derived().x_label_info_.text();
- }
-
+ double axis_plot_frame<Derived>::x_axis_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_label_units(const std::string& str)
- { //! Set the text to add units to the X-axis label.
- derived().x_units_info_.text(str);
- derived().x_axis_.label_on_ = true; // Assume want x_label string displayed.
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::data_lines_width(double width);
template <class Derived>
- std::string axis_plot_frame<Derived>::x_label_units()
- { //! \return the text to add units to the X-axis label.
- //! The label will only be shown if x_label_on() == true.
- return derived().x_units_info_.text();
- }
-
- // y_label not needed in 1D.
+ double axis_plot_frame<Derived>::data_lines_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_label(const std::string& str)
- { //! Set the text for the Y-axis label (and set y_label_on(true)).
- derived().y_label_info_.text(str);
- derived().y_axis_.label_on_ = true; // Assume want y_label string displayed.
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label(const std::string& str);
template <class Derived>
- std::string axis_plot_frame<Derived>::y_label()
- { //! \return the text for the Y-axis label.
- //! The label will only be shown if y_label_on() == true.
- return derived().y_label_info_.text();
- }
-
+ std::string axis_plot_frame<Derived>::x_label();
template <class Derived>
- Derived& axis_plot_frame<Derived>::y_label_units(const std::string& str)
- { //! Set the text to add units to the Y-axis label.
- derived().y_units_info_.text(str);
- derived().y_axis_.label_on_ = true; // Assume want y_label string displayed.
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_label_units(const std::string& str);
template <class Derived>
- std::string axis_plot_frame<Derived>::y_label_units()
- { //! \return the text to add units to the X-axis label.
- return derived().y_units_info_.text();
- }
-
+ std::string axis_plot_frame<Derived>::x_label_units();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_on(bool b)
- { //! \return true if values of X data points are shown (for example: 1.23).
- // (Want override xy_values_on that would otherwise cause overwriting).
- // So the last values_on setting will prevail.
- // But this is only defined in 2D
- //if(derived().xy_values_on())
- //{ // Would be overwritten by XY pair.
- // derived().xy_values_on(false);
- //}
- derived().x_values_on_ = b;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::y_label(const std::string& str);
template <class Derived>
- bool axis_plot_frame<Derived>::x_values_on()
- { //! If true, show data point values near data points markers.
- return derived().x_values_on_;
- }
-
+ std::string axis_plot_frame<Derived>::y_label();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_font_size(unsigned int i)
- { //! Set font size of data point X values near data points markers.
- derived().x_values_style_.values_text_style_.font_size(i);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::y_label_units(const std::string& str);
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_values_font_size()
- { //! \return font size of data point X values near data points markers.
- return derived().x_values_style_.values_text_style_.font_size();
- }
-
+ std::string axis_plot_frame<Derived>::y_label_units();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_font_family(const std::string& family)
- { //! Set font family of data point X values near data points markers.
- derived().x_values_style_.values_text_style_.font_family(family);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_on(bool b);
template <class Derived>
- const std::string& axis_plot_frame<Derived>::x_values_font_family()
- { //! Set font family of data point X values near data points markers.
- return derived().x_values_style_.values_text_style_.font_family();
- }
-
+ bool axis_plot_frame<Derived>::x_values_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_interval(double inter)
- { //! Set the interval between X-axis major ticks.
- derived().x_ticks_.major_interval_ = inter;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_font_size(unsigned int i);
+
template <class Derived>
- double axis_plot_frame<Derived>::x_major_interval()
- { //! \return the interval between X-axis major ticks.
- return derived().x_ticks_.major_interval_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_font_family(const std::string& family);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_color(const svg_color& col)
- { //! Set the color of data point X values near data points markers.
- // Function could set both fill (middle) and stroke (outside),
- // but just setting fill is simplest,
- // but does not allow separate inside & outside colors.
- // Might be better to set in x_values_style
- derived().image_.g(PLOT_X_POINT_VALUES).style().fill_color(col);
- //derived().image_.g(PLOT_X_POINT_VALUES).style().stroke_color(col);
-
- return derived();
- }
+ unsigned int axis_plot_frame<Derived>::x_values_font_size();
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_values_color()
- { //! \return the color of data point X values near data points markers.
- // Function could get either fill and stroke,
- // return derived().image_.g(PLOT_X_POINT_VALUES).style().stroke_color();
- return derived().image_.g(PLOT_X_POINT_VALUES).style().fill_color();
- }
-
+ const std::string& axis_plot_frame<Derived>::x_values_font_family();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_rotation(rotate_style rotate)
- { //! \return the rotation (rotate_style) of data point X values near data points markers.
- //! (Degrees: 0 to 360 in 45 steps).
- derived().x_values_style_.value_label_rotation_ = rotate;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_interval(double inter);
template <class Derived>
- int axis_plot_frame<Derived>::x_values_rotation()
- { //! \return the rotation of data point X values near data points markers.
- return derived().x_values_style_.value_label_rotation_;
- }
-
+ double axis_plot_frame<Derived>::x_major_interval();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_precision(int p)
- { //! Set iostream decimal digits precision of data point X values near data points markers.
- derived().x_values_style_.value_precision_ = p;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_color(const svg_color& col);
template <class Derived>
- int axis_plot_frame<Derived>::x_values_precision()
- { //! \return iostream decimal digits precision of data point X values near data points markers.
- return derived().x_values_style_.value_precision_;
- }
-
+ svg_color axis_plot_frame<Derived>::x_values_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_values_ioflags(std::ios_base::fmtflags f)
- { //! Set iostream format flags of data point X values near data points markers.
- //! Useful to set hexadecimal, fixed and scientific, (std::ios::scientific).
- derived().x_values_style_.value_ioflags_ = f;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_rotation(rotate_style rotate);
template <class Derived>
- std::ios_base::fmtflags axis_plot_frame<Derived>::x_values_ioflags()
- { //! \return iostream format flags of data point X values near data points markers.
- //! Might be used to set hexadecimal, fixed and scientific, (std::ios::scientific).
- return derived().x_values_style_.value_ioflags_;
- }
-
+ int axis_plot_frame<Derived>::x_values_rotation();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_plusminus_on(bool b)
- { //! Set if to append uncertainty estimate to data point X values near data points markers.
- //! (May not be implemented yet).
- derived().x_values_style_.plusminus_on_ = b;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_precision(int p);
template <class Derived>
- bool axis_plot_frame<Derived>::x_plusminus_on()
- { //! \return if to append uncertainty estimate to data point X values near data points markers.
- //! (May not be implemented yet).
- return derived().x_values_style_.plusminus_on_;
- }
-
+ int axis_plot_frame<Derived>::x_values_precision();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_plusminus_color(const svg_color& col)
- { //! Set the color of X uncertainty of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
- derived().x_values_style_.plusminus_color_ = col;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_values_ioflags(std::ios_base::fmtflags f);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_plusminus_color()
- { //! Get the color of X uncertainty of value, for example, the color of 0.02 in "1.23 +-0.02 (9)".
- return derived().x_values_style_.plusminus_color_;
- }
-
+ std::ios_base::fmtflags axis_plot_frame<Derived>::x_values_ioflags();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_df_on(bool b)
- { //! Set true if to append a degrees of freedom estimate to data point X values near data points markers.
- //! (May not be implemented yet).
- derived().x_values_style_.df_on_ = b;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_plusminus_on(bool b);
template <class Derived>
- bool axis_plot_frame<Derived>::x_df_on()
- { //! \return true if to append a degrees of freedom estimate to data point X values near data points markers.
- //! (May not be implemented yet).
- return derived().x_values_style_.df_on_;
- }
-
+ bool axis_plot_frame<Derived>::x_plusminus_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_df_color(const svg_color& col)
- { //! Set the color of X degrees of freedom, for example, the color of 9 in "1.23 +-0.02 (9)".
- derived().x_values_style_.df_color_ = col;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_plusminus_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::x_df_color()
- { //! Get the color of X degrees of freedom, for example, the color of 9 in "1.23 +-0.02 (9)".
- return derived().x_values_style_.df_color_;
- }
+ svg_color axis_plot_frame<Derived>::x_plusminus_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_decor(const std::string& pre, const std::string& sep, const std::string& suf)
- { //! Set prefix, separator and suffix for x_style
- //! Note if you want a space, you must use a Unicode space "\ ",
- //! for example, ",\ " rather than ", ".
- derived().x_values_style_.prefix_ = pre;
- derived().x_values_style_.separator_ = sep;
- derived().x_values_style_.suffix_ = suf;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_addlimits_on(bool b);
template <class Derived>
- const std::string axis_plot_frame<Derived>::x_prefix()
- { //! Get the prefix (only used if separator != "")
- return derived().x_values_style_.prefix_;
- }
-
+ bool axis_plot_frame<Derived>::x_addlimits_on();
template <class Derived>
- const std::string axis_plot_frame<Derived>::x_suffix()
- { //! Get the suffix (only used if separator != "")
- return derived().x_values_style_.suffix_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_addlimits_color(const svg_color& col);
template <class Derived>
- const std::string axis_plot_frame<Derived>::x_separator()
- { //! Get separator (also controls use of the prefix & suffix - they are only used if separator != "").
- //! Note For a space, you must use a Unicode space "\ ",
- //! for example, ",\ " rather than ", ".
- return derived().x_values_style_.separator_;
- }
+ svg_color axis_plot_frame<Derived>::x_addlimits_color();
- template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_tick_length(double length)
- { //! Set length of X major ticks.
- derived().x_ticks_.major_tick_length_ = length;
- return derived();
- }
template <class Derived>
- double axis_plot_frame<Derived>::x_major_tick_length()
- {//! \return length of X major ticks.
- return derived().x_ticks_.major_tick_length_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_df_on(bool b);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_tick_width(double width)
- { //! Set width of X major ticks.
- derived().x_ticks_.major_tick_width_ = width; // Redundant?
- derived().image_.g(PLOT_X_MAJOR_TICKS).style().stroke_width(width);
- return derived();
- }
-
+ bool axis_plot_frame<Derived>::x_df_on();
template <class Derived>
- double axis_plot_frame<Derived>::x_major_tick_width()
- {//! \return width of X major ticks.
- return derived().image_.g(PLOT_X_MAJOR_TICKS).style().stroke_width();
- }
-
+ Derived& axis_plot_frame<Derived>::x_df_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_tick_length(double length)
- { //! Set length of X minor ticks.
- derived().x_ticks_.minor_tick_length_ = length;
- return derived();
- }
-
+ svg_color axis_plot_frame<Derived>::x_df_color();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_id_on(bool b);
template <class Derived>
- double axis_plot_frame<Derived>::x_minor_tick_length()
- { //! \return length of X minor ticks.
- return derived().x_ticks_.minor_tick_length_;
- }
-
+ bool axis_plot_frame<Derived>::x_id_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_tick_width(double width)
- { //! Set width of X minor ticks.
- derived().x_ticks_.minor_tick_width_ = width;
- derived().image_.g(PLOT_X_MINOR_TICKS).style().stroke_width(width);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_id_color(const svg_color& col);
template <class Derived>
- double axis_plot_frame<Derived>::x_minor_tick_width()
- { //! \return width of X minor ticks.
- // return derived().x_minor_tick_width_; // should be the same but store in stroke_width is definitive.
- return derived().image_.g(PLOT_X_MINOR_TICKS).style().stroke_width();
- }
-
+ svg_color axis_plot_frame<Derived>::x_id_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_major_tick(double d)
- { //! Set interval (Cartesian units) between major ticks.
- derived().x_ticks_.major_interval_ = d;
- }
-
+ Derived& axis_plot_frame<Derived>::x_datetime_on(bool b);
template <class Derived>
- double axis_plot_frame<Derived>::x_major_tick()
- { //! \return interval (Cartesian units) between major ticks.
- return derived().x_ticks_.major_interval_;
- }
-
+ bool axis_plot_frame<Derived>::x_datetime_on();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_minor_interval(double interval)
- { //! Set interval between X-axis minor ticks.
- // aka x_minor_tick
- derived().x_ticks_.minor_interval_ = interval;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_datetime_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_num_minor_ticks(unsigned int num)
- { //! Set number of X-axis minor ticks between major ticks.
- derived().x_ticks_.num_minor_ticks_ = num;
- return derived();
- }
-
+ svg_color axis_plot_frame<Derived>::x_datetime_color();
template <class Derived>
- unsigned int axis_plot_frame<Derived>::x_num_minor_ticks()
- { //! \return number of X-axis minor ticks between major ticks.
- //! Note: NOT float or double!
- return derived().x_ticks_.num_minor_ticks_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_order_on(bool b);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_range(double min_x, double max_x)
- { //! Set the range of values on the X-axis.
- //! The minimum and maximum values must be finite and not too near
- //! to the minima or maxima that can be represented by floating point doubles,
- //! and the range must not be too small.
- if (!boost::math::isfinite(min_x))
- {
- throw std::runtime_error("X range: min not finite!");
- }
- if (!boost::math::isfinite(max_x))
- {
- throw std::runtime_error("X range: max not finite!");
- }
- if(max_x <= min_x)
- { // max_x <= min_x.
- std::stringstream message("X range: max <= min! ");
- message << max_x << " <= " << min_x << std::ends;
- throw std::runtime_error(message.str());
- //throw std::runtime_error("X range: max <= min!");
- }
- if( (abs(max_x - min_x) < std::numeric_limits<double>::epsilon() * 1000 * abs(max_x))
- || (abs(max_x - min_x) < std::numeric_limits<double>::epsilon() * 1000 * abs(min_x))
- )
- { // Range too small to display.
- throw std::runtime_error("X range too small!" );
- }
- derived().x_axis_.min_ = min_x;
- derived().x_axis_.max_ = max_x;
- //derived().x_ticks_.max_ = min_x;
- //derived().y_ticks_.max_ = max_x;
- // done in calculate_plot_window, so need to duplicate here.
- derived().x_autoscale_ = false; // Because explicit range has just been set.
- return derived();
- }
-
+ bool axis_plot_frame<Derived>::x_order_on();
template <class Derived>
- std::pair<double, double> axis_plot_frame<Derived>::x_range()
- { //! \return the range of values on the X-axis.
- //! (Need to use boost::svg::detail::operator<< to display this).
- std::pair<double, double> r;
- r.first = derived().x_axis_.min_;
- r.second = derived().x_axis_.max_;
- return r;
- }
-
+ Derived& axis_plot_frame<Derived>::x_order_color(const svg_color& col);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_min(double min_x)
- { //! Set the minimum value on the X-axis.
- // Not useful to check here that x_max_ > x_min_ because may not have set x_min_ yet.
- derived().x_axis_.min_ = min_x;
- return derived();
- }
-
+ svg_color axis_plot_frame<Derived>::x_order_color();
template <class Derived>
- double axis_plot_frame<Derived>::x_min()
- { //! \return the minimum value on the X-axis.
- //! (Can also get both minimum and maximum as a std::pair).
- return derived().x_axis_.min_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_decor(const std::string& pre, const std::string& sep, const std::string& suf);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_max(double x)
- { //! Set the maximum value on the X-axis.
- // Not useful to check here that x_max_ > x_min_ because may not have set x_min_ yet.
- derived().x_axis_.max_ = x;
- return derived();
- }
-
+ const std::string axis_plot_frame<Derived>::x_prefix();
template <class Derived>
- double axis_plot_frame<Derived>::x_max()
- { //! \return the maximum value on the X-axis.
- //! (Can also get both minimum and maximum as a std::pair).
- return derived().x_axis_.max_;
- }
-
+ const std::string axis_plot_frame<Derived>::x_suffix();
template <class Derived>
- Derived& axis_plot_frame<Derived>::autoscale_check_limits(bool b)
- { //! Set to check that values used for autoscale are within limits.
- //! Default is true, but can switch off checks for speed.
- derived().autoscale_check_limits_ = b;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_tick_length(double length);
template <class Derived>
- bool axis_plot_frame<Derived>::autoscale_check_limits()
- { //! \return to check that values used for autoscale are within limits.
- //! Default is true, but can switch off checks for speed.
- return derived().autoscale_check_limits_;
- }
-
+ double axis_plot_frame<Derived>::x_major_tick_length();
template <class Derived>
- bool axis_plot_frame<Derived>::x_autoscale()
- { //! \return true if to use autoscale value for X-axis.
- return derived().x_autoscale_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_tick_width(double width);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_autoscale(bool b)
- { //! Set true if to use autoscale values for X-axis.
- if (b && derived().x_auto_tick_interval_ < 0)
- { // No autoscale values have been calculated, so not safe to make x_autoscale true.
- throw std::runtime_error("X autoscale has not been calculated yet!" );
- }
- derived().x_autoscale_ = b;
- return derived();
- }
-
+ double axis_plot_frame<Derived>::x_major_tick_width();
template <class Derived>
- bool axis_plot_frame<Derived>::autoscale()
- { //! \return true if to use autoscale values for X-axis.
- //! autoscale() is same as x_autoscale.
- return derived().x_autoscale_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_tick_length(double length);
template <class Derived>
- Derived& axis_plot_frame<Derived>::autoscale(bool b)
- { //! Set whether to use X autoscaled values.
- //! Same as x_autoscale, and used by boxplot too.
- if (derived().x_auto_tick_interval_ < 0)
- { // No autoscale values have been calculated, so not safe to make x_autoscale true.
- throw std::runtime_error("X-axis autoscale has not been calculated yet!" );
- }
- derived().x_autoscale_ = b;
- return derived();
- }
-
-
+ double axis_plot_frame<Derived>::x_minor_tick_length();
template <class Derived>
- Derived& axis_plot_frame<Derived>::autoscale_plusminus(double pm)
- { //! Set how many uncertainty or standard deviation to allow for ellipse when autoscaling.
- //! Default is 3 for 99% confidence.
- derived().autoscale_plusminus_ = pm;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_tick_width(double width);
template <class Derived>
- double axis_plot_frame<Derived>::autoscale_plusminus()
- { //! \return how many uncertainty or standard deviation to allow for ellipse when autoscaling.
- //! Default is 3 for 99% confidence.
- return derived().autoscale_plusminus_;
- }
-
+ double axis_plot_frame<Derived>::x_minor_tick_width();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_autoscale(std::pair<double, double> p)
- { //! Set to use X min & max pair of double values to autoscale X-axis.
- scale_axis(p.first, p.second, // double min and max from pair.
- &derived().x_auto_min_value_, &derived().x_auto_max_value_, &derived().x_auto_tick_interval_, &derived().x_auto_ticks_,
- derived().autoscale_check_limits_, derived().autoscale_plusminus_,
- derived().x_include_zero_, derived().x_tight_, derived().x_min_ticks_, derived().x_steps_);
- derived().x_autoscale_ = true; // Default to use any calculated values?
- return derived();
- } // autoscale(pair<double, double> p)
-
- template <class Derived>
- Derived& axis_plot_frame<Derived>::x_with_zero(bool b)
- { //! Set X-axis autoscale to include zero (default = false).
- //! Must preceed x_autoscale(data) call.
- derived().x_include_zero_ = b;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_major_tick(double d);
template <class Derived>
- bool axis_plot_frame<Derived>::x_with_zero()
- { //! \return true if X-axis autoscale to include zero (default = false).
- return derived().x_include_zero_;
- }
-
+ double axis_plot_frame<Derived>::x_major_tick();
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_min_ticks(int min_ticks)
- { //! Set X-axis autoscale to include at least minimum number of ticks (default = 6).
- //! Must preceed x_autoscale(data) call.
- derived().x_min_ticks_ = min_ticks;
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::x_minor_interval(double interval);
template <class Derived>
- int axis_plot_frame<Derived>::x_min_ticks()
- { //! \return X-axis autoscale minimum number of ticks.
- return derived().x_min_ticks_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_num_minor_ticks(unsigned int num);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_steps(int steps)
- { /*! Set autoscale to set ticks in steps multiples of:\n
- 2,4,6,8,10, if 2\n
- or 1,5,10 if 5\n
- or 2,5,10 if 10.\n
- default = 0 (none).
- \note: Must \b preceed x_autoscale(data) call).
- */
- derived().x_steps_ = steps;
- return derived();
- }
-
+ unsigned int axis_plot_frame<Derived>::x_num_minor_ticks();
template <class Derived>
- int axis_plot_frame<Derived>::x_steps()
- { //! \return autoscale to set ticks in steps.
- return derived().x_steps_;
- }
-
+ Derived& axis_plot_frame<Derived>::x_range(double min_x, double max_x);
template <class Derived>
- Derived& axis_plot_frame<Derived>::x_tight(double tight)
- { //! Set tolerance to autoscale to permit data points slightly outside both end ticks.
- //! default 0.
- //! Must preceed x_autoscale(data) call.
- derived().x_tight_ = tight;
- return derived();
- }
-
+ double axis_plot_frame<Derived>::x_max();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::autoscale_check_limits(bool b);
+ template <class Derived>
+ bool axis_plot_frame<Derived>::autoscale_check_limits();
+ template <class Derived>
+ bool axis_plot_frame<Derived>::x_autoscale();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_autoscale(bool b);
+ template <class Derived>
+ bool axis_plot_frame<Derived>::autoscale();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::autoscale_plusminus(double pm);
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::autoscale(bool b);
+ template <class Derived>
+ double axis_plot_frame<Derived>::autoscale_plusminus();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_autoscale(std::pair<double, double> p);
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_with_zero(bool b);
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_min_ticks(int min_ticks);
+ template <class Derived>
+ int axis_plot_frame<Derived>::x_min_ticks();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_steps(int steps);
+ template <class Derived>
+ int axis_plot_frame<Derived>::x_steps();
+ template <class Derived>
+ Derived& axis_plot_frame<Derived>::x_tight(double tight);
template <class Derived>
- double axis_plot_frame<Derived>::x_tight()
- { //! \return tolerance given to autoscale to permit data points slightly outside both end ticks.
- return derived().x_tight_;
- }
-
+ double axis_plot_frame<Derived>::x_tight();
template <class Derived>
- double axis_plot_frame<Derived>::x_auto_min_value()
- { //! \return the X-axis minimum value computed by autoscale.
- return derived().x_auto_min_value_;
- }
-
+ double axis_plot_frame<Derived>::x_auto_min_value();
template <class Derived>
- double axis_plot_frame<Derived>::x_auto_max_value()
- { //! \return the X-axis maximum value computed by autoscale.
- return derived().x_auto_max_value_;
- }
-
+ double axis_plot_frame<Derived>::x_auto_max_value();
template <class Derived>
- double axis_plot_frame<Derived>::x_auto_tick_interval()
- { //! \return the X-axis major tick interval computed by autoscale.
- return derived().x_auto_tick_interval_;
- }
-
+ double axis_plot_frame<Derived>::x_auto_tick_interval();
template <class Derived>
- int axis_plot_frame<Derived>::x_auto_ticks()
- { //! \return the X-axis number of major ticks computed by autoscale.
- return derived().x_auto_ticks_;
- }
-
+ int axis_plot_frame<Derived>::x_auto_ticks();
template <class Derived>
- Derived& axis_plot_frame<Derived>::limit_color(const svg_color& col)
- { //! Set the color for 'at limit' point stroke color.
- // Need to set the series
- derived().image_.g(detail::PLOT_LIMIT_POINTS).style().stroke_color(col);
- // derived().serieses_[0].limit_point_color(col); // Would require to add some data first!
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::limit_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::limit_color()
- { //! \return the color for the 'at limit' point stroke color.
- return derived().image_.g(detail::PLOT_LIMIT_POINTS).style().stroke_color();
- }
-
+ svg_color axis_plot_frame<Derived>::limit_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::limit_fill_color(const svg_color& col)
- { //! Set the color for 'at limit' point fill color.
- derived().image_.g(detail::PLOT_LIMIT_POINTS).style().fill_on(true);
- derived().image_.g(detail::PLOT_LIMIT_POINTS).style().fill_color(col);
- //derived().serieses_[0].limit_point_style_.fill_color(col);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::limit_fill_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::limit_fill_color()
- { //! \return the color for the 'at limit' point fill color.
- return derived().image_.g(detail::PLOT_LIMIT_POINTS).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::limit_fill_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::one_sd_color(const svg_color& col)
- { //! Set the color for the one standard deviation (~67% confidence) ellipse fill.
- derived().image_.g(detail::PLOT_DATA_UNC1).style().fill_on(true);
- derived().image_.g(detail::PLOT_DATA_UNC1).style().fill_color(col);
- derived().image_.g(detail::PLOT_DATA_UNC1).style().stroke_color(blank);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::one_sd_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::one_sd_color()
- { //! \return Color for the one standard deviation (~67% confidence) ellipse fill.
- return derived().image_.g(detail::PLOT_DATA_UNC1).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::one_sd_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::two_sd_color(const svg_color& col)
- { //! Set the color for two standard deviation (~95% confidence) ellipse fill.
- derived().image_.g(detail::PLOT_DATA_UNC2).style().fill_on(true);
- derived().image_.g(detail::PLOT_DATA_UNC2).style().fill_color(col);
- derived().image_.g(detail::PLOT_DATA_UNC2).style().stroke_color(blank);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::two_sd_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::two_sd_color()
- { //! \return Color for two standard deviation (~95% confidence) ellipse fill.
- return derived().image_.g(detail::PLOT_DATA_UNC2).style().fill_color();
- }
-
+ svg_color axis_plot_frame<Derived>::two_sd_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::three_sd_color(const svg_color& col)
- { //! Set the color for three standard deviation (~99% confidence) ellipse fill.
- derived().image_.g(detail::PLOT_DATA_UNC3).style().fill_on(true);
- derived().image_.g(detail::PLOT_DATA_UNC3).style().fill_color(col);
- derived().image_.g(detail::PLOT_DATA_UNC3).style().stroke_color(blank);
- return derived();
- }
-
+ Derived& axis_plot_frame<Derived>::three_sd_color(const svg_color& col);
template <class Derived>
- svg_color axis_plot_frame<Derived>::three_sd_color()
- { //! \return Color for three standard deviation (~99% confidence) ellipse fill.
- return derived().image_.g(detail::PLOT_DATA_UNC3).style().fill_color();
- }
-
- template <class Derived>
- Derived& axis_plot_frame<Derived>::draw_note(double x, double y, std::string note, rotate_style rot /*= horizontal*/, align_style al/* = center_align*/, const svg_color& col /* black */, text_style& tsty/* = no_style*/)
- { /*! \brief Annotate plot with a text string (perhaps including Unicode), putting note at SVG Coordinates X, Y.
- \details Defaults color black, rotation horizontal and align = center_align
- Using center_align is recommended as it will ensure that will center correctly
- (even if original string is made much longer because it contains Unicode,
- for example Greek or math symbols, taking about 6 characters per symbol)
- because the render engine does the centering.
- */
- g_element* g = &(derived()).image_.add_g_element(); // New group.
- g->style().fill_color(col); // Set its color
- g->push_back(new text_element(x, y, note, tsty, al, rot)); // Add to document image.
- // No checks on X or Y - leave to SVG to not draw outside image.
- // Could warn if X and/or Y outside - but even if OK, then text could still stray outside image.
- return derived();
- } // void draw_note()
-
+ svg_color axis_plot_frame<Derived>::three_sd_color();
template <class Derived>
- Derived& axis_plot_frame<Derived>::draw_line(double x1, double y1, double x2, double y2, const svg_color& col /* black */)
- { /*! \brief Annotate plot with a line from SVG Coordinates X1, Y1 to X2, Y2.
- \details Default color black.
- */
- g_element* g = &(derived()).image_.add_g_element(); // New group.
- g->style().stroke_color(col);
- //g->style().width(w); // todo
- g->push_back(new line_element(x1, y1, x2, y2));
- // No checks on X or Y - leave to SVG to not draw outside image.
- // Could warn if X and/or Y outside ?
- return derived();
- } // void draw_line()
-
+ Derived& axis_plot_frame<Derived>::draw_note(double x, double y, std::string note, rotate_style rot /*= horizontal*/, align_style al/* = center_align*/, const svg_color& col /* black */, text_style& tsty/* = no_style*/);
template <class Derived>
- Derived& axis_plot_frame<Derived>::draw_plot_line(double x1, double y1, double x2, double y2, const svg_color& col /* black */)
- { /*! \brief Annotate plot with a line from user's Cartesian Coordinates X1, Y1 to X2, Y2.
- \details For example, -10, -10, +10, +10, Default color black.
- */
- derived().calculate_plot_window(); // To ensure the scale and shift are setup for transform.
- // It would be better to store the line (and curve and text) information like plot data series to
- // ensure that transform works correctly.
- // This assumes that the notes, lines and curves are the last item before the write.
- transform_point(x1, y1);
- transform_point(x2, y2);
- g_element* g = &(derived()).image_.add_g_element(); // New group.
- g->style().stroke_color(col);
- g->push_back(new line_element(x1, y1, x2, y2));
- // No checks on X or Y - leave to SVG to not draw outside image.
- // Actually we want to use clip_path for the plot area.
- // Could warn if X and/or Y outside ?
- return derived();
- } // void draw_plot_line()
-
+ Derived& axis_plot_frame<Derived>::draw_line(double x1, double y1, double x2, double y2, const svg_color& col /* black */);
template <class Derived>
- Derived& axis_plot_frame<Derived>::draw_plot_curve(double x1, double y1, double x2, double y2, double x3, double y3, const svg_color& col /* black */)
- { /*! \brief Annotate plot with a line from user's Cartesian Coordinates X1, Y1 via X2, Y2 to X3, Y3.
- \details For example, -10, -10, +10, +10, Default color black.
- */
- derived().calculate_plot_window(); // To ensure the scale and shift are setup for transform.
- // It would be better to store the line (and curve and text) information like plot data series to
- // ensure that transform works correctly.
- // This assumes that the notes, lines and curves are the last item before the write.
- transform_point(x1, y1);
- transform_point(x2, y2);
- transform_point(x3, y3);
- g_element* g = &(derived()).image_.add_g_element(); // New group.
- g->style().stroke_color(col);
- g->push_back(new qurve_element(x1, y1, x2, y2, x3, y3));
- // No checks on X or Y - leave to SVG to not draw outside image.
- // Actually we want to use clip_path for the plot area.
- // Could warn if X and/or Y outside ?
- return derived();
- } // void draw_plot_curve
-
+ Derived& axis_plot_frame<Derived>::draw_plot_line(double x1, double y1, double x2, double y2, const svg_color& col /* black */);
} // detail
} // svg
} // boost
+#ifndef BOOST_SVG_AXIS_PLOT_FRAME_IPP
+# include <boost/svg_plot/impl/axis_plot_frame.ipp>
+#endif
+
#endif // BOOST_SVG_AXIS_PLOT_FRAME_HPP
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/functors.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/functors.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/functors.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -11,7 +11,7 @@
*/
// Copyright Jacob Voytko 2007
-// Copyright Paul A. Bristow 2009
+// Copyright Paul A. Bristow 2009, 2012
// Use, modification and distribution are subject to the
// Boost Software License, Version 1.0.
@@ -26,8 +26,9 @@
# pragma warning (disable : 4244)
#endif
-#include <boost/svg_plot/uncertain.hpp>
-//using boost::svg::unc;
+//#include <boost/svg_plot/uncertain.hpp>
+#include <boost/quan/unc.hpp>
+#include <boost/quan/meas.hpp>
namespace boost {
namespace svg {
@@ -49,13 +50,69 @@
}
}; // class double_1d_convert
+template <bool correlated>
+class unc_1d_convert
+{ /*! \class boost::svg::detail::unc_1d_convert
+ \brief This functor allows any 1D data convertible to unc (uncertain doubles) to be plotted.
+ \details Defaults provided by the unc class constructor ensure that
+ uncertainty, degrees of freedom information, and type are suitably set too.
+*/
+public:
+ typedef unc<correlated> result_type; //!< result type is an uncertain floating-point type.
+
+ //! \tparam T Any data type with a value convertible to double, for example: double, unc, Meas.
+ template <class T>
+ unc<correlated> operator()(T val) const
+ /*!< Convert to uncertain type,
+ providing defaults for uncertainty, degrees of freedom information, and type (meaning undefined).
+ \return value including uncertainty information.
+ */
+ {
+ return (unc<correlated>)val;
+ /*! \return uncertain type (uncertainty, degrees of freedom information, and type meaning undefined).
+ warning C4244: 'argument' : conversion from 'long double' to 'double', possible loss of data.
+ because unc only holds values to double precision.
+ Suppressed by pragma for MSVC above. Need similar for other compilers.
+ */
+ }
+}; // template <bool correlated> class default_1d_convert
+
+class meas_1d_convert
+{ /*! \class boost::svg::detail::meas_1d_convert
+ \brief This functor allows any 1D data convertible to measurements
+ (with uncertain doubles) to be plotted.
+ \details Defaults provided by the meas class constructor ensure that
+ uncertainty, degrees of freedom information, type, and order, timestamp and id are suitably set too.
+*/
+public:
+ typedef Meas result_type; //!< result type includes an uncertain floating-point type.
+
+ //! \tparam T Any data type with a value convertible to double, for example: double, unc, Meas.
+ template <class T>
+ Meas operator()(T val) const
+ /*!< Convert to Meas type,
+ providing defaults for uncertainty, degrees of freedom information, and type (meaning undefined).
+ \return value including uncertainty and other information.
+ */
+ {
+ return (Meas)val;
+ /*! \return uncertain type (uncertainty, degrees of freedom information, and type meaning undefined).
+ Warning C4244: 'argument' : conversion from 'long double' to 'double', possible loss of data.
+ because unc only holds values to double precision.
+ Suppressed by pragma for MSVC above. Need similar for other compilers.
+ */
+ }
+}; // class default_1d_convert
+
class pair_double_2d_convert
{ /*! \class boost::svg::detail::pair_double_2d_convert
\brief This functor allows any 2 D data convertible to type std::pair<double, double> to be plotted.
*/
public:
typedef std::pair<double, double> result_type; //!< result type is a pair (X and Y) of doubles.
+
double i; //!< Start value.
+
void start(double i)
{ //! Set a start value.
i = i;
@@ -84,8 +141,10 @@
\brief This functor allows any 2D data convertible to type std::pair<unc, unc> to be plotted.
*/
public:
- typedef std::pair<unc<correlated>, unc<correlated>> result_type; //!< result type is pair of uncertain values.
+ typedef std::pair<unc<correlated>, unc<correlated> > result_type; //!< result type is pair of uncertain values.
+
unc<correlated> i; //!< Start uncertain value.
+
void start(unc<correlated> i)
{ //!< Set a start value.
i = i;
@@ -102,37 +161,39 @@
template <class T> //!< \tparam T Any type convertible to double.
std::pair<unc<correlated>, unc<correlated> > operator()(T a)
{ //!< Convert a pair of X and Y uncertain type values to a pair of unc.
- return std::pair<un<correlated>c, unc<correlated> >(i++, (unc<correlated>)a); //! \return pair of unc.
+ return std::pair<unc <correlated>, unc<correlated> >(i++, (unc<correlated>)a); //! \return pair of unc.
}
}; // class pair_unc_2d_convert
template <bool correlated>
-class unc_1d_convert
-{ /*! \class boost::svg::detail::unc_1d_convert
- \brief This functor allows any 1D data convertible to unc (uncertain doubles) to be plotted.
- \details Defaults provided by the unc class constructor ensure that
- uncertainty, degrees of freedom information, and type are suitably set too.
+class pair_Meas_2d_convert
+{ /*! \class boost::svg::detail::pair_unc_2d_convert
+ \brief This functor allows any 2D data convertible to type std::pair<Meas, unc> to be plotted.
*/
public:
- typedef unc<correlated> result_type; //!< result type is an uncertain floating-point type.
+ typedef std::pair<Meas, unc<correlated> > result_type; //!< result type is pair of uncertain values.
- //! \tparam T Any data type with a value convertible to double, for example: double, unc, Meas.
- template <class T>
- unc<correlated> operator()(T val) const
- /*!< Convert to uncertain type,
- providing defaults for uncertainty, degrees of freedom information, and type (meaning undefined).
- \return value including uncertainty information.
- */
- {
- return (unc<correlated>)val;
- /*! \return uncertain type (uncertainty, degrees of freedom information, and type meaning undefined).
- warning C4244: 'argument' : conversion from 'long double' to 'double', possible loss of data.
- because unc only holds values to double precision.
- Suppressed by pragma for MSVC above. Need similar for other compilers.
- */
+ Meas i; //!< Start Meas (uncun + daetime etc) value.
+
+ void start(Meas i)
+ { //!< Set a start value.
+ i = i;
}
-}; // class default_1d_convert
+ //!< \tparam T type convertible to double.
+ template <class T, class U>
+ std::pair<Meas, unc<correlated> > operator()(const std::pair<T, U>& a) const
+ { //!< Convert a pair of X and Y uncertain type values to a pair of doubles.
+ //! \return pair of Meas & uncs.
+ return std::pair<Meas, unc<correlated> >((Meas)(a.first), (unc<correlated>)(a.second));
+ }
+
+ template <class T> //!< \tparam T Any type convertible to double.
+ std::pair<Meas, unc<correlated> > operator()(T a)
+ { //!< Convert a pair of X and Y uncertain type values to a pair of Meas & unc.
+ return std::pair<Meas, unc<correlated> >(i++, (unc<correlated>)a); //! \return pair of Meas & unc.
+ }
+}; // class pair_unc_2d_convert
} // namespace detail
} // namespace svg
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/numeric_limits_handling.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/numeric_limits_handling.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/numeric_limits_handling.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -20,7 +20,10 @@
#define BOOST_SVG_NUMERIC_LIMITS_HANDLING_DETAIL_HPP
#include <boost/math/special_functions/fpclassify.hpp>
-#include <boost/svg_plot/uncertain.hpp>
+
+#include <boost/quan/unc.hpp>
+#include <boost/quan/meas.hpp>
+
// using boost::svg::unc;
// TODO use the boost version instead to be more portable?
@@ -111,6 +114,22 @@
|| limit_max(value_of(a.second)) || limit_min(value_of(a.second)) || limit_NaN(value_of(a.second));
}
+template <bool correlated>
+inline bool pair_is_limit(std::pair<Meas, unc<correlated> > a) // const version
+{ //! Check on values of both x Meas and y unc data points.
+ // \return false if either or both are at limit.
+ return limit_max(value_of(a.first)) || limit_min(value_of(a.first)) || limit_NaN(value_of(a.first))
+ || limit_max(value_of(a.second)) || limit_min(value_of(a.second)) || limit_NaN(value_of(a.second));
+}
+
+template <bool correlated>
+inline bool pair_is_limit(std::pair<const Meas, unc<correlated> > a)
+{ //! Check on values of both x Meas and y unc data points.
+ // \return false if either or both are at limit.
+ return limit_max(value_of(a.first)) || limit_min(value_of(a.first)) || limit_NaN(value_of(a.first))
+ || limit_max(value_of(a.second)) || limit_min(value_of(a.second)) || limit_NaN(value_of(a.second));
+}
+
} // namespace detail
} // namespace svg
} // namespace boost
@@ -124,6 +143,6 @@
bool boost::svg::detail::pair_is_limit(std::pair<const double, double>); // x and/or y not a proper data value.
template <bool correlated>
-bool boost::svg::detail::pair_is_limit(std::pair<const unc<correlated>, unc<correlated> >); // x and/or y not a proper data value.
+bool boost::svg::detail::pair_is_limit(std::pair<const unc<correlated>, unc<correlated> >); // x and/or y not a proper data value!
#endif // BOOST_SVG_NUMERIC_LIMITS_HANDLING_DETAIL_HPP
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/detail/pair.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/detail/pair.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/detail/pair.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -1,12 +1,12 @@
/*! \file pair.hpp
\brief Provides a private implementation of operator<< for std::pair that
outputs pairs with a comma separated format, for example: 1.2, 3.4
- \details Hidden in namespace detail to avoid clashes with other implementations of std::pair operator<<.
+ \details Hidden in namespace `detail` to avoid clashes with other implementations of `std::pair operator<<`.
\date Mar 2009
\author Paul A. Bristow
*/
-// Copyright Paul A. Bristow 2006 - 2009.
+// Copyright Paul A. Bristow 2006 - 2012.
// Use, modification and distribution are subject to the
// Boost Software License, Version 1.0.
@@ -16,8 +16,9 @@
#ifndef BOOST_SVG_PAIR
#define BOOST_SVG_PAIR
-#include <boost/svg_plot/uncertain.hpp>
-// using boost::svg::unc;
+#ifdef _MSC_VER
+# pragma once
+#endif
#include<iostream>
// using std::ostream;
@@ -32,12 +33,14 @@
{
namespace detail
{
+ std::ostream& operator<< (std::ostream& os, const std::pair<double, double>& p); //! Output pair of doubles to ostream.
- // Hidden in namespace detail to avoid clashes with other implementations of std::pair operator<<.
+ // Hidden in namespace `detail` to avoid potential clashes with other implementations of `std::pair operator<<`.
template<class T1, class T2>
std::ostream& operator<< (std::ostream& os, const std::pair<T1, T2>& p); //! Output pair of type T1 and T2 to ostream.
- std::ostream& operator<< (std::ostream& os, const std::pair<double, double>& p); //! Output pair of doubles to ostream.
- // std::ostream& operator<< (std::ostream& os, const std::pair<boost::svg::unc, boost::svg::unc>& p);
+
+
+ // std::ostream& operator<< (std::ostream& os, const std::pair<boost::svg::uncun, boost::svg::uncun>& p);
template<class T1, class T2>
std::ostream& operator<< (std::ostream& os, const std::pair<T1, T2>& p)
@@ -48,15 +51,14 @@
} // std::ostream& operator<<
std::ostream& operator<< (std::ostream& os, const std::pair<double, double>& p)
- { //! Output a pair of double values to ostream.
- //int precision = os.precision(5); // Save & use rather than default precision(6).
+ { //! Output a pair of const double values to ostream.
+ //int precision = os.precision(5); // Save & use 5 rather than default precision(6).
os << p.first << ", " << p.second;
// Outputs: 1.2, 3.4
//os.precision(precision); // Restore.
return os;
} // std::ostream& operator<<
-
//std::pair<class T1, class T2>& operator=(const pair& rhs)
//{
// first = rhs.first;
@@ -71,12 +73,13 @@
// return os << p.first << ", " << p.second;
//}
//
- //// Explicit double, double.
- //template<typename charT, typename traits>
- //inline std::basic_ostream<charT, traits>& operator<<(std::basic_ostream<charT, traits>& os, const std::pair<double, double>& p)
- //{
- // return os << p.first << ", " << p.second;
- //}
+
+ // Explicit double, double.
+ template<typename charT, typename traits>
+ inline std::basic_ostream<charT, traits>& operator<<(std::basic_ostream<charT, traits>& os, const std::pair<double, double>& p)
+ {
+ return os << p.first << ", " << p.second;
+ }
// but OK for this purpose.
} // namespace detail
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -114,6 +114,8 @@
// should transform be here allow translate and rotate?
/*! \details
Classes inherited from svg_element add other references, 5.3.1, like color, fill, stroke, gradients...
+ */
+ /*
\verbatim
Example id: <g id="yMinorGrid" ></g>
Example class: <g class="grid_style"></g>
@@ -259,9 +261,10 @@
}
void write(std::ostream& rhs)
- { //! output line from (x1_, y1_) to (x2_, y2_)
- //! \brief Write XML SVG command to draw a straight line.
- //! \details \verbatim Example: <line x1="5" y1="185" x2="340" y2="185"/> \endverbatim
+ { /*! output line from (x1_, y1_) to (x2_, y2_) by
+ writeing XML SVG command to draw a straight line.
+ */
+ /* \verbatim Example: <line x1="5" y1="185" x2="340" y2="185"/> \endverbatim */
rhs << "<line x1=\"" << x1_ << "\" y1=\"" << y1_
<< "\" x2=\"" << x2_ << "\" y2=\"" << y2_ << "\"/>";
}
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/show_1d_settings.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/show_1d_settings.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/show_1d_settings.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -241,8 +241,20 @@
outFmtFlags(plot.x_value_ioflags(), cout, ".\n");
cout << "x_plusminus_on " << plot.x_plusminus_on() << endl;
cout << "x_plusminus_color " << plot.x_plusminus_color() << endl;
+ cout << "x_addlimits_on " << plot.x_addlimits_on() << endl;
+ cout << "x_addlimits_color " << plot.x_addlimits_color() << endl;
cout << "x_df_on " << plot.x_df_on() << endl;
cout << "x_df_color " << plot.x_df_color() << endl;
+
+ cout << "x_id_on " << plot.x_id_on() << endl;
+ cout << "x_id_color " << plot.x_id_color() << endl;
+
+ cout << "x_datetime_on " << plot.x_datetime_on() << endl;
+ cout << "x_datetime_color " << plot.x_datetime_color() << endl;
+
+ cout << "x_order_on " << plot.x_df_on() << endl;
+ cout << "x_order_color " << plot.x_df_color() << endl;
+
cout << "x_prefix \"" << plot.x_prefix() << '"' << endl;
cout << "x_separator \"" << plot.x_separator() << '"' << endl;
cout << "x_suffix \"" << plot.x_suffix() << '"' << endl;
@@ -296,6 +308,7 @@
cout << "x_axis_position " << plot.x_axis_position() << endl;
cout << "x_autoscale " << plot.x_autoscale() << endl;
cout << "x_autoscale_check_limits " << plot.autoscale_check_limits() << endl;
+ cout << "confidence alpha " << plot.confidence() << endl;
cout << "data lines width " << plot.data_lines_width() << endl;
cout.flags(iostate); // Restore.
} // void show_plot_settings(svg_1d_plot& plot)
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -2,11 +2,11 @@
\brief Shows settings and options for 2D Plot.
- \see show_1d_settings.cpp for 1-D plot.
+ \see show_1d_settings.cpp for 1-D plot.
*/
// Copyright Jacob Voytko 2007
-// Copyright Paul A. Bristow 2007, 2009
+// Copyright Paul A. Bristow 2007, 2009, 2012
// Use, modification and distribution are subject to the
// Boost Software License, Version 1.0.
@@ -16,6 +16,12 @@
#ifndef BOOST_SVG_SHOW_2D_SETTINGS_HPP
#define BOOST_SVG_SHOW_2D_SETTINGS_HPP
+#ifdef _MSC_VER
+# pragma once
+#endif
+
+#include <boost/svg_plot/detail/pair.hpp>
+
#include <iostream>
namespace boost
@@ -58,12 +64,17 @@
*/
}; // const char* fmtFlagWords
+/*
+
+Now use the version in xiostream.ipp
+void outFmtFlags(std::ios_base::fmtflags fmtFlags = cout.flags(), std::ostream& os = std::cerr, const char* term = ".\n");
+
void outFmtFlags(std::ios_base::fmtflags fmtFlags, std::ostream& os, const char* term)
{ //! Output strings describing format flags of each bit in std::ios_base::fmtflags.
- /*! Usage: outFmtFlags(flags, cerr);
- For example, logs to cerr "FormatFlags: skipws showbase right dec"
- */
+ //! Usage: outFmtFlags(flags, cerr);
+ //! For example, logs to cerr "FormatFlags: skipws showbase right dec"
+
//void outFmtFlags(std::ios_base::fmtflags fmtFlags = cout.flags(), ostream& os = cerr, const char* term = ".\n");
const int up = 16; // Words across page.
const int count = 16; // cos using unsigned short int.
@@ -93,20 +104,21 @@
os << term; // eg "\n" or ". "
os.flags(flags); // Restore.
} // outFmtFlags
+ */
- const std::string l_or_r(int i)
- {
- return ((i < 0) ? "left" : ((i == 0) ? "none" : "right"));
- }
+const std::string l_or_r(int i)
+{
+ return ((i < 0) ? "left" : ((i == 0) ? "none" : "right"));
+}
- const std::string t_or_b(int i)
- {
- return ((i < 0) ? "bottom" : ((i == 0) ? "none" : "top"));
- }
+const std::string t_or_b(int i)
+{
+ return ((i < 0) ? "bottom" : ((i == 0) ? "none" : "top"));
+}
void show_2d_plot_settings(svg_2d_plot& plot)
{ /*! Diagnostic display of all of a 2D plot's settings.
- Outputs a long list of about hundred of plot parameter settings to @c cout:
+ Outputs a long list of about 100 plot parameter settings to @c std::cout:
invaluable if the plot does not look as expected.
\warning This creates about 100 lines of output, so should be used sparingly!
*/
@@ -118,11 +130,11 @@
using std::boolalpha;
using std::fixed;
- using boost::svg::detail::operator<<;
- // std::ostream& operator<< (std::ostream&, const std::pair<double, double>&);
- // defined above.
+ using boost::svg::detail::operator<<;
+
+ //std::ostream& operator<< (std::ostream& os, const std::pair<double, double>& p); //! Output pair of doubles to ostream.
- int iostate = cout.flags(); // Save to restore one exit.
+ int iostate = cout.flags(); // Save to restore on exit.
cout << dec << std::boolalpha << endl;
cout << endl;
@@ -140,7 +152,7 @@
//cout << plot.draw_bezier_lines() << endl;
cout << "x_size " << plot.x_size() << endl;
cout << "image y_size " << plot.y_size() << endl;
- cout << "image x_size " << plot.size() << endl;
+ //cout << "image x & y sizes " << plot.size() << endl;
cout << "image_filename " << plot.image_.image_filename() << endl;
cout << "legend_on " << plot.legend_on() << endl;
std::pair<double, double> lt = plot.legend_top_left();
@@ -296,15 +308,19 @@
cout << "y_values_on " << plot.y_values_on() << endl;
cout << "y_plusminus_on " << plot.y_plusminus_on() << endl;
cout << "y_plusminus_color " << plot.y_plusminus_color() << endl;
+ cout << "x_addlimits_on " << plot.x_addlimits_on() << endl;
+ cout << "x_addlimits_color " << plot.x_addlimits_color() << endl;
+
cout << "y_df_on " << plot.y_df_on() << endl;
cout << "y_df_color " << plot.y_df_color() << endl;
cout << "y_prefix \"" << plot.y_prefix() << '"' << endl;
cout << "y_separator \"" << plot.y_separator() << '"' << endl;
cout << "y_suffix \"" << plot.y_suffix() << '"' << endl;
+ cout << "confidence alpha " << plot.confidence() << endl;
cout << "data lines width " << plot.data_lines_width() << endl;
- cout.flags(iostate); // Restore.
+ cout.flags(iostate); // Restore saved iostate.
} // void show_plot_settings(svg_2d_plot& plot)
} // svg
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/svg.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/svg.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/svg.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -61,20 +61,22 @@
has
\htmlonly
<a href="http://www.opera.com/docs/specs/svg/"> SVG support</a>
- \endhtmlonly
- but the quality of rendering is sometimes not as good as other browsers.
+ \endhtmlonly.
- - Microsoft Internet Explorer, \b provided a suitable
+ - Microsoft Internet Explorer 9 and later, (or earlier versions \b provided a suitable
\htmlonly
<a href="http://www.adobe.com/svg/"> Adobe SVG Viewer plug-in for SVG files</a>
\endhtmlonly
- is installed.
+ is installed). Sadly, rendering quality is so poor that IE9 cannot be recommended.
- \htmlonly
<a href="http://www.inkscape.org"> Inkscape</a>
\endhtmlonly
, a fine Open Source SVG editor with excellent rendering, full scaling and other editing features,
- including conversion to wide variety of other graphics formats like Portable Network Graphics .png.
+ including conversion to wide variety of other graphics formats
+ like Portable Network Graphics .png.
+
+ Inkscape is the 'gold standard' for viewing SVG files.
The Inkscape download also includes Inkview, a convenient <b>SVG viewer and slide show </b>.
@@ -113,14 +115,11 @@
- Google www.google.com/chrome Chrome,
-
- And by Many other graphics programs, for example
\htmlonly
<a href="http://svg.software.informer.com/software/"> Most popular SVG software</a>
\endhtmlonly
-
-
The goals of the project are:
- To let users produce simple plots with minimal intervention by using sane defaults.
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -33,18 +33,21 @@
#include <boost/svg_plot/detail/functors.hpp>
using boost::svg::detail::unc_1d_convert;
#include <boost/svg_plot/detail/numeric_limits_handling.hpp>
-#include <boost/svg_plot/uncertain.hpp>
-// using boost::svg::unc;
+//#include <boost/quan/unc.hpp>
+//#include <boost/quan/unc_init.hpp>
+//#include <boost/quan/meas.hpp>
+//#include <boost/svg_plot/impl/src.hpp>
using boost::svg::detail::limit_NaN;
-#include <boost/svg_plot/detail/auto_axes.hpp> // provides:
-// void scale_axis(double min_value, double max_value, // Input range
-// double* axis_min_value, double* axis_max_value, double* axis_tick_increment, int* auto_ticks, // All 4 updated.
-// bool origin, // If true, ensures that zero is a tick value.
-// double tight, // Allows user to avoid a small fraction over a tick using another tick.
-// int min_ticks, // Minimum number of ticks.
-// int steps); // Round up and down to 2, 4, 6, 8, 10, or 5, 10 or 2, 5, 10 systems.
+#include <boost/svg_plot/detail/auto_axes.hpp> /*! provides:
+void scale_axis(double min_value, double max_value, // Input range
+ double* axis_min_value, double* axis_max_value, double* axis_tick_increment, int* auto_ticks, // All 4 updated.
+ bool origin, // If true, ensures that zero is a tick value.
+ double tight, // Allows user to avoid a small fraction over a tick using another tick.
+ int min_ticks, // Minimum number of ticks.
+ int steps); // Round up and down to 2, 4, 6, 8, 10, or 5, 10 or 2, 5, 10 systems.
+*/
#include <vector>
#include <ostream>
@@ -60,8 +63,9 @@
// Forward declarations.
const std::string strip_e0s(std::string s); // Strip unnecessary zeros and e and sign.
- class svg_1d_plot; // 1D Plot (that may include one or more data series).
- class svg_1d_plot_series; // A data series to be added to a 1D Plot.
+ class svg_1d_plot; //! 1D Plot (that may include one or more data series).
+
+ class svg_1d_plot_series; //! A data series to be added to a 1D Plot.
// ------------------------------------------------------------------
// This allows us to store plot state locally in svg_plot.
@@ -80,9 +84,10 @@
*/
public:
- std::vector<unc<false> > series_; //!< Normal 'OK to plot' data values.
+ std::vector<Meas> series_; //!< Normal 'OK to plot' data values.
+ //std::vector<unc<false> > series_; //!< Normal 'OK to plot' data values.
std::vector<double> series_limits_; //!< 'limit' values: too big, too small or NaN.
- // TODO should these be unc too?
+ // TODO should these be unc too? Uncertainty info is meaningless, but timestamp etc are OK.
std::string title_; //!< title of data series (to show on legend).
plot_point_style point_style_; //!< circle, square...
@@ -122,167 +127,6 @@
size_t series_limits_count();//!< Get number of 'at limits' data points in this data series.
}; // class svg_1d_plot_series
-// class svg_1d_plot_series Constructor.
-template <class C> //! \tparam C an iterator into STL container: array, vector<double>, vector<unc>, set, map ...
-svg_1d_plot_series::svg_1d_plot_series(C begin, C end, const std::string& title)
-: // Constructor.
-title_(title),
-point_style_(black, blank, 5, vertical_line), // Default point style.
-limit_point_style_(lightgrey, red, 10, cone), // Default limit (inf or NaN) point style.
-//limit_point_style_(lightgrey, whitesmoke, 10, cone), // Default limit (inf or NaN) point style.
-line_style_(black, blank, 2, false, false) // Default line style, black, no fill, width, line_on, bezier_on false
-{
- //cout << "typeid(C).name() = " << typeid(C).name() << endl;
- /*
- typeid(C).name() =
- class boost::transform_iterator
- <
- class boost::svg::detail::unc_1d_convert, class std::_Vector_const_iterator
- <
- class std::_Vector_val
- <
- class boost::svg::unc, class std::allocator
- <
- class boost::svg::unc
- >
- >
- >,
- struct boost::use_default, struct boost::use_default
- >
- */
-
- for(C i = begin; i != end; ++i)
- { // Might be useful to have defaults for begin and end? But unclear how.
- //double temp = *i; // assume type is just double.
- //boost::svg::unc temp = *i; // Assumes unc type.
- // So use auto to automatically make temp the right type.
-
- auto temp = *i; // Should provide double, unc, ... type.
-
- //cout << "typeid(temp).name() = " << typeid(temp).name() << endl;
- // typeid(temp).name() = class boost::svg::unc
- if(detail::is_limit(temp.value()))
- {
- series_limits_.push_back(temp.value()); // 'limit' values: too big, too small or NaN.
- // This assumes that uncertainty info is meaningless?
- }
- else
- {
- series_.push_back(temp); // Normal 'OK to plot' data values (including uncertainty info).
- // Should copy name and other info too if applicable.
- }
- }
-} // svg_plot_series constructor.
-
-// Definitions of svg_plot_series Member Functions.
-svg_1d_plot_series& svg_1d_plot_series::fill_color(const svg_color& col_)
-{ //! Set fill color for plot point marker(s) (chainable).
- point_style_.fill_color_ = col_;
- return *this; //! \return reference to svg_1d_plot_series to make chainable.
-}
-
-svg_1d_plot_series& svg_1d_plot_series::stroke_color(const svg_color& col_)
-{ //! Set stroke color for plot point marker(s) (chainable).
- point_style_.stroke_color_ = col_;
- return *this; //! \return reference to svg_1d_plot_series to make chainable.
-}
-
-svg_1d_plot_series& svg_1d_plot_series::shape(point_shape shape_)
-{ //! Set shape for plot point marker(s) (chainable).
- point_style_.shape_ = shape_;
- return *this; //! \return reference to svg_1d_plot_series to make chainable.
-}
-
-point_shape svg_1d_plot_series::shape()
-{ //! \return shape for plot point marker(s).
- return point_style_.shape_;
-}
-
-svg_1d_plot_series& svg_1d_plot_series::symbols(const std::string s)
-{ //! Set symbol for plot point marker(s).
- point_style_.symbols_ = s;
- return *this; //! \return reference to svg_1d_plot_series to make chainable.
-}
-
-svg_1d_plot_series& svg_1d_plot_series::size(int size_)
-{ //! Set size of plot point marker(s).
- //point_style_.size_ = size_;
- //point_style_.symbols_style_.font_size(i); // in case using a symbol.
- point_style_.size(size_);
- return *this; //! \return reference to svg_1d_plot_series to make chainable.
-}
-
-int svg_1d_plot_series::size()
-{ //! \return size of plot point marker(s).
- return point_style_.size();
-}
-
-const std::string svg_1d_plot_series::symbols()
-{ //! \return symbol for plot point marker(s).
- return point_style_.symbols_;
-}
-
-svg_1d_plot_series& svg_1d_plot_series::line_color(const svg_color& col_)
-{ //! Set color of any line joining plot points.
- line_style_.stroke_color_ = col_;
- return *this; // Make chainable.
-}
-
-svg_1d_plot_series& svg_1d_plot_series::line_width(double wid_)
-{ /*! Set width of any line joining plot points.
- \return @c *this to make chainable.
- */
- line_style_.width_ = wid_;
- return *this; // Make chainable.
-}
-
-double svg_1d_plot_series::line_width()
-{ //! \return Width of any line joining plot points.
- return line_style_.width_;
-}
-
-svg_1d_plot_series& svg_1d_plot_series::line_on(bool on_)
-{ /*! Set @c true if to draw a line joining plot points.
- \return @c *this to make chainable.
- */
- line_style_.line_on_ = on_;
- return *this; // Make chainable.
-}
-
-bool svg_1d_plot_series::line_on()
-{ //! \return @c true if to draw a line joining plot points.
- return line_style_.bezier_on_;
-}
-
-svg_1d_plot_series& svg_1d_plot_series::bezier_on(bool on_)
-{ //! Set @c true if to draw bezier curved line joining plot points.
- line_style_.bezier_on_ = on_;
- return *this; // Make chainable.
-}
-
-bool svg_1d_plot_series::bezier_on()
-{ //! \return @c true if to draw bezier curved line joining plot points.
- return line_style_.bezier_on_;
-}
-
-size_t svg_1d_plot_series::series_count()
-{ //! \return Number of normal 'OK to plot' data values in data series.
- return series_.size();
-}
-
-size_t svg_1d_plot_series::series_limits_count()
-{ //! \return Number of 'at limit' values: too big, too small or NaN data values in data series.
- return series_limits_.size();
-}
-
-svg_1d_plot_series& svg_1d_plot_series::limit_point_color(const svg_color& col_)
-{ //! Set of stroke color of 'at limits' points.
- limit_point_style_.stroke_color_ = col_;
- return *this; // Make chainable.
-}
-
-
-// End Definitions of svg_plot_series Public Member Functions.
class svg_1d_plot : public detail::axis_plot_frame<svg_1d_plot>
{ /*! \class boost::svg::svg_1d_plot
@@ -297,15 +141,15 @@
//friend void show_2d_plot_settings(svg_1d_plot&); // Surely not needed?
friend class detail::axis_plot_frame<svg_1d_plot>;
- //protected:
+ //protected: // but seems little benefit?
// Member data names conventionally end with _, for example: border_margin_,
// and set & get accessor functions are named *without* _ suffix,
// for example: border_margin() & border_margin(int).
- double x_scale_; //!< scale used for transform from Cartesian to SVG coordinates.
- double x_shift_; //!< shift from SVG origin is top left, Cartesian is bottom right.
- double y_scale_; //!< scale used for transform from Cartesian to SVG coordinates.
- double y_shift_; //!< shift from SVG origin is top left, Cartesian is bottom right.
+ double x_scale_; //!< Scale used for transform from Cartesian to SVG coordinates.
+ double x_shift_; //!< Shift from SVG origin is top left, Cartesian is bottom right.
+ double y_scale_; //!< Scale used for transform from Cartesian to SVG coordinates.
+ double y_shift_; //!< Shift from SVG origin is top left, Cartesian is bottom right.
svg image_; //!< Stored so as to avoid rewriting style information constantly.
@@ -356,6 +200,11 @@
// Both optionally set by legend_top_left.
double legend_right_; //!< SVG Coordinates of right of legend box,
double legend_bottom_; //!< bottom of legend box.
+ double x_axis_vertical_; //!< Vertical position of 1D horizontal X-axis line as fraction of window.
+ //! 0.5 is at middle(useful if no labels) (default),
+ //! 0.8 is near bottom (useful if value labels go upward),
+ //! 0.2 is near top (useful if value labels go downward).
+
size_t legend_longest_; //!< longest (both header & data) string in legend box,
axis_line_style x_axis_; //!< style of X axis line.
@@ -371,12 +220,22 @@
bool plot_window_on_; //!< Use a separate plot window (not whole image).
bool x_ticks_on_; //!< Ticks on X axis will be shown.
bool x_values_on_; //!< values of data are shown by markers.
- int x_axis_position_; //!< \see boost::svg::x_axis_intersect
+ int x_axis_position_; //!< \see boost::svg::x_axis_intersect.
+
+ // Parameters for calculating confidence intervals (for both X and Y values).
+ // These might be picked up from uncertain types.
+ double alpha_; // = 0.05; // oss.iword(confidenceIndex) / 1.e6; // Pick up alpha.
+ double epsilon_; // = 0.01; // = oss.iword(roundingLossIndex) / 1.e3; // Pick up rounding loss.
+ int uncSigDigits_; // = 2; // = oss.iword(setUncSigDigitsIndex); // Pick up significant digits for uncertainty.
+ bool isNoisyDigit_; // = false; // Pick up?
+
+ // Autoscaling
bool autoscale_check_limits_; //!< If true, then check autoscale values for infinity, NaN, max, min.
bool x_autoscale_; //!< If true, use any autoscale values for scaling the X axis.
- double autoscale_plusminus_; //!< For uncertain values, allow for plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
+ double autoscale_plusminus_; //!< For uncertain values, allow for text_plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
//!< For example, if a max value is 1.2 +or- 0.02, then 1.4 will be used for autoscaling the maximum.\n
//!< Similarly, if a min value is 1.2 +or- 0.02, then 1.0 will be used for autoscaling the minimum.
+ double text_plusminus_; // Nominal factor of 1. (default) corresponds to 67% confidence limit.
bool x_include_zero_; //!< If autoscaled, include zero.
int x_min_ticks_; //!< If autoscaled, set a minimum number of ticks.
double x_tight_; //!< How much a value can go beyond the tick value before another tick is required.
@@ -402,434 +261,14 @@
//!< These are sorted into two vectors for normal and abnormal (max, inf and NaN).
public:
- svg_1d_plot()
- : // Default constructor.
- // Many ( but not all - see below) default values here.
- // See documentation for default settings rationale.
-
- title_style_(18, "Verdana", "", ""), // last "bold" ?
- legend_style_(14, "Verdana", "", ""), // 2nd "italic"?
- x_axis_label_style_(14, "Verdana", "", ""),
- x_value_label_style_(12, "Verdana", "", ""),
- point_symbols_style_(12, "Lucida Sans Unicode"), // Used for data point marking.
- value_style_(10, "Verdana", "", ""), // Used for data point values.
-
- title_info_(0, 0, "", title_style_, center_align, horizontal),
- //title_info_(0, 0, "Plot of data", title_style_, center_align, horizontal), when text concatenation solved?
- //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_info_(0, 0, "", x_axis_label_style_, center_align, horizontal), // Null strings for now.
- x_value_label_info_(0, 0, "", x_value_label_style_, center_align, horizontal), // X-axis tick value label, for example: "1.2" or "1.2e1".
- x_units_info_(0, 0, "", x_value_label_style_, center_align, horizontal),
- x_axis_(X, -10., +10., black, 1, 0, true, false, true),
- y_axis_(Y, 0., +1., black, 1, 0, false, false, false), // Not used for 1D.
-
- // Might fill in all values, but there are rather many for ticks_labels_style,
- x_ticks_(X, x_value_label_style_),// so for defaults see ticks_labels_style.
- text_margin_(2.), // for text as a multiplier of the font size.
- image_border_(yellow, white, 1, 10, true, true), // margin should be about axis label font size.
- plot_window_border_(lightgoldenrodyellow, svg_color(255, 255, 255), 1, 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_place_(outside_right), // default but interacts with using plot_window.
- legend_on_(false),
- legend_longest_(0),
- outside_legend_on_(true),
- legend_lines_(false), // Not very useful for 1 D as already showing data point marker shapes.
- plot_window_clip_("plot_window"), // for <clipPath id="plot_window" ...
- title_on_(true),
- plot_window_on_(true),
- x_values_on_(false), // By default, don't label point values.
- x_values_style_(horizontal, 3, std::ios::dec, true, value_style_, black, black, false, false),
- // Autoscaling.
- autoscale_check_limits_(true), // Do check all value for limits, infinity, max, min, NaN.
- autoscale_plusminus_(3.), // Allow 3 uncertainty (standard deviation) for 99% confidence ellipse.
-
- x_autoscale_(false),
- x_include_zero_(false), // If autoscaled, include zero.
- x_min_ticks_(6), // If autoscaled, set a minimum number of ticks, default 6.
- x_steps_(0), // If autoscaled, set any prescaling to decimal 1, 2, 5, 10 etc, default none.
- x_tight_(1e-6), // margin that point can lie outside top and bottom tick.
- y_autoscale_(false), // Not used for 1-D.
- // Used to transform Cartesian to SVG.
- x_scale_(1.), x_shift_(0.),
- y_scale_(1.), y_shift_(0.),
- x_axis_position_(0) // Move into axis_style?
- {
- size(500, 200); // Default image size.
- // Only needs to be quite shallow (y_size) for a 1-D plot.
- // (But may need more height if long value labels are used, for example: "[time = 1.23 +-0.02 sec]").
- // 200 barely leaves enough room for five data series in any legend box).
- // (2-D usually needs to be much more rectangular).
-
- using namespace boost::svg::detail; // Avoid detail:: specification.
-
- // Build the document tree & add all the children of the root node.
- for(int i = 0; i < detail::SVG_PLOT_DOC_CHILDREN; ++i)
- {
- image_.add_g_element();
- }
- set_ids();
-
- // Set other SVG color, stroke & width defaults for various child PLOT nodes.
- image_.g(PLOT_BACKGROUND).style().stroke_color(image_border_.stroke_);
- image_.g(PLOT_BACKGROUND).style().stroke_width(image_border_.width_); //
- image_.g(PLOT_BACKGROUND).style().fill_color(image_border_.fill_);
- image_.g(PLOT_WINDOW_BACKGROUND).style().fill_color(plot_window_border_.fill_);
- image_.g(PLOT_WINDOW_BACKGROUND).style().stroke_width(plot_window_border_.width_).stroke_color(plot_window_border_.stroke_);
- image_.g(PLOT_LIMIT_POINTS).style().stroke_color(lightslategray).fill_color(antiquewhite);
- image_.g(PLOT_X_AXIS).style().stroke_color(black).stroke_width(x_axis_.width());
- image_.g(PLOT_DATA_UNC3).style().stroke_color(lightgoldenrodyellow).fill_color(lightgoldenrodyellow).stroke_width(1);
- image_.g(PLOT_DATA_UNC2).style().stroke_color(peachpuff).fill_color(peachpuff).stroke_width(1);
- image_.g(PLOT_DATA_UNC1).style().stroke_color(magenta).fill_color(pink).stroke_width(1);
-
- // Note that widths are stored in member data *and* copied here.
- // Not sure if this is wise but ...
- // Font info defaults are set by the constructor above.
- // Ticks.
-
- y_ticks_.left_ticks_on_ = false; // Needed to ensure don't extend X-axis line.
- y_ticks_.right_ticks_on_ = false;
-
- if(x_ticks_.use_up_ticks() || x_ticks_.use_down_ticks())
- {
- image_.g(PLOT_X_MAJOR_TICKS).style().stroke_width(x_ticks_.major_tick_width_).stroke_color(black);
- image_.g(PLOT_X_MINOR_TICKS).style().stroke_width(x_ticks_.minor_tick_width_).stroke_color(black);
- }
- // Grids.
- // Default color & width for grid, used or not.
- image_.g(PLOT_X_MAJOR_GRID).style().stroke_width(x_ticks_.major_grid_width_).stroke_color(svg_color(200, 220, 255));
- image_.g(PLOT_X_MINOR_GRID).style().stroke_width(x_ticks_.minor_grid_width_).stroke_color(svg_color(200, 220, 255));
- //image_.g(PLOT_DATA_LINES).style().stroke_width(2); // default width.
- // Alter with, for example: plot.data_lines_width(4);
-
- legend_place_ = (plot_window_on_) ? outside_right : inside; // Defaults.
- // Note if set plot_window_on() then also need to set legend_place.
- // (if set a default in plot_window then call to set legend place must to come *after* it.
- // So not set a default? But leaving it as inside is worse?)
-
- x_ticks_on_ = x_ticks_.up_ticks_on_ || x_ticks_.down_ticks_on_;
- // Only 2D has left and right y ticks.
- x_ticks_.ticks_on_window_or_on_axis_ = 0; // Make ticks (and ticks value labels) on X-axis line the default.
- // This will place the labels just under the horizontal X-axis line,
- // rather than below the plot window border.
- // This over-rides the default in class ticks_labels_style.
- //
-
- if (title_info_.text() == "")
- { // Avoid leaving unnecessary space etc for a title.
- title_on_ = false;
- }
- else
- {
- title_on_ = true; // Can be switched off later with `my_1d_plot.title_on(true);`
- }
-
- } // svg_1d_plot() Default constructor.
-
- void set_ids()
- { //! Document ids for use in identifying group elements, for example: <g id = "PLOT_TITLE".../g>
- for(int i = 0; i < detail::SVG_PLOT_DOC_CHILDREN; ++i)
- {
- image_.g(i).id(detail::document_ids_[i]);
- }
- } // void set_ids()
-
- void calculate_plot_window()
- { //! Calculate the size and position of the plot window,
- //! taking account of the length and font size of axes labels, axis ticks, title and legend box.
- //! This version is only for 1-D.
- //! All calculations use SVG units, pixels by default.
-
- // Start by assuming we can use all the svg image,
- // but reduce by the width of any image border.
- plot_left_ = 0 + image_border_width(); // Top left of image.
- plot_top_ = 0 + image_border_width();
- plot_right_ = image_.x_size() - image_border_width(); // Bottom right of image.
- plot_bottom_ = image_.y_size() - image_border_width();
-
- if(title_on_ && title_info_.text() != "")
- { // Leave space at top for title.
- // Title at bottom (or sides even) option not implemented.
- plot_top_ += title_font_size() * (text_margin_ + 0.5);
- }
-
- // Assume that X-axis labels are always at bottom for 1D plot.
- if(x_axis_.label_on_ == true && x_label_info_.text() != "")
- { // Leave space below plot window at bottom for X axis label (unless empty string).
- plot_bottom_ -= x_axis_label_style_.font_size() * text_margin_;
- }
- if(plot_window_on_ == true)
- { // Needed to allow any plot window border rectangle to show OK.
- // A small margin is to prevent it overlapping the image border.
- // Also allows for axis value labels that mark the min and max
- // that must extend about half a font width beyond the plot window border.
- plot_left_ += image_border_.margin_;
- plot_right_ -= image_border_.margin_;
- plot_top_ += image_border_.margin_;
- plot_bottom_ -= image_border_.margin_;
- }
-
- // Size if necessary - else (re-)initialise to zero.
- size_legend_box(); // depending on its contents.
- place_legend_box();
-
- // Because there may be several datasets,
- // and the scaling can be done by any one or all of them.
- // my_plot.autoscale(my_data1) // for 1 dataset.
- // or my_plot.autoscale(my_datas) // for a vector of several datasets.
- // calculates the min & max, increments & ticks.
- if (x_autoscale_)
- { // Use calculated autoscale values.
- // Autoscale has been done in my_data.autoscale(my_data);
- // and saved in x_auto_min_value_, x_auto_max_value_, & x_auto_tick_interval_,
- // so copy these values to use them:
- x_axis_.min_ = x_auto_min_value_;
- x_axis_.max_ = x_auto_max_value_;
- x_ticks_.major_interval_ = x_auto_tick_interval_;
- }
- else
- { // Ignore auto values, even if they have been calculated.
- }
- // Copy X-axis min & max to ticks.
- x_ticks_.min_ = x_axis_.min_;
- x_ticks_.max_ = x_axis_.max_;
- // Ensure both axis and ticks have the *same* range.
- // (To use them separately (designed to give the potential for different ranges)
- // one would have to *not* do this,
- // but to make sure they are both assigned correctly).
-
- x_axis_.axis_ = (plot_bottom_ + plot_top_) / 2.; // Put X-axis halfway up plot window.
-
- if(plot_window_on_ == true)
- { // Using a plot window and NOT using all image.
- // Calculate the number of chars of the longest tick value label.
- x_ticks_.longest_label(); // Updates label_max_length_
- x_ticks_.label_max_space_ = 0; // Work out the longest tick value label for X-Axis.
- if (x_ticks_.label_rotation_ == horizontal)
- { // Only 1 char height & 1 space needed if labels are horizontal.
- x_ticks_.label_max_space_ = 2 * x_value_label_style_.font_size() * wh; // SVG chars.
- // Should this be just 2 * font_size
- }
- else if ((x_ticks_.label_rotation_ == upward) || (x_ticks_.label_rotation_ == downward))
- { // ! horizontal so will need more than 2 chars worth.
- x_ticks_.label_max_space_+= x_ticks_.label_max_length_ * x_value_label_style_.font_size() * wh; // SVG chars.
- }
- else
- { // Assume label is sloping, say 45, so * sin(45) = 0.707.
- x_ticks_.label_max_space_+= x_ticks_.label_max_length_ * x_value_label_style_.font_size() * wh * sin45; // SVG 'chars'.
- }
-
- // Make space for any ticks pointing below the plot window.
- if(x_ticks_.down_ticks_on_)
- { // Start bottom of plot higher to give space for any external down ticks.
- plot_bottom_ -= (std::max)(x_ticks_.major_tick_length_, x_ticks_.minor_tick_length_);// And avoid macro max trap!
- }
-
- if (x_axis_.axis_line_on_)
- { // Want a X-axis line, so check if range includes zero, meaning that X and Y axes intersect,
- // and x_axis_ is svg coordinate of Y-axis (usually y = 0).
- // If not fix axis to bottom of the plot window.
- if ((x_axis_position_ == bottom) // All X data values definitely > zero.
- && !(x_ticks_.ticks_on_window_or_on_axis_ < 0) ) // & not already on bottom of plot window.
- { // y_min_ > 0 so X-axis will not intersect Y-axis, so use plot window border.
- plot_bottom_ -= x_ticks_.label_max_space_; // Move up for the value labels.
- x_axis_.axis_ = plot_bottom_; // Put X-axis on bottom on plot window.
- }
- else if ((x_axis_position_ == top) // All x data values definitely < zero.
- && !(x_ticks_.ticks_on_window_or_on_axis_ > 0) ) // & not already on top of plot window.
- { // // y_max_ < 0 so X-axis will not intersect Y-axis, so use plot window border.
- plot_top_ += x_ticks_.label_max_space_; // Move down for labels.
- x_axis_.axis_ = plot_top_; // Put X-axis on top of plot window border.
- }
- else
- { // y_axis_position_ == y_intersects_x
- // Calculate below after transform is calculated.
- }
- } // if (use_x_axis_line_)
-
- // Make space for any tick value labels.
- if (x_ticks_.major_value_labels_side_ != 0)
- { // There are some tick value labels.
- // If ticks and value labels are on plot window border, the need to allow space for them.
- if ((x_ticks_.ticks_on_window_or_on_axis_ < 0) // ticks on bottom of plot window.
- && (x_ticks_.major_value_labels_side_ < 0) ) // & tick value labels below axis line too.
- { // Contract plot window bottom edge up to make space for X tick value labels on bottom.
- plot_bottom_ -= x_ticks_.label_max_space_; // Move up.
- }
- else if ((x_ticks_.ticks_on_window_or_on_axis_ > 0) //
- && (x_ticks_.major_value_labels_side_ > 0) ) // & X tick value labels to top of plot window.
- { // Move top of plot window down to give space for X tick value labels.
- plot_top_ += x_ticks_.label_max_space_; // Move window top down.
- }
- else // (x_ticks_.major_value_labels_side_ == 0)
- { // X-ticks on the X-axis line (not on plot window border).
- // Don't need to allow any extra space.
- // (But if X axis is near plot window border, may overlap it, and any X axis labels!)
- }
- } // x_ticks_. major_value_labels_side
-
- } // plot_window_on_
-
- if(plot_window_on_ == true)
- { // Draw plot window border as a rectangular box.
- image_.g(detail::PLOT_WINDOW_BACKGROUND).push_back(
- new rect_element(plot_left_, plot_top_, (plot_right_ - plot_left_), plot_bottom_ - plot_top_));
- } // plot_window_on_
- } // void calculate_plot_window()
-
- void calculate_transform()
- { //! Calculate scale and shift factors for transforming from Cartesian to SVG plot.
- //! SVG image is (0, 0) at top left, Cartesian (0, 0) at bottom left.
- x_scale_ = (plot_right_ - plot_left_) / (x_axis_.max_ - x_axis_.min_);
- x_shift_ = plot_left_ - (x_axis_.min_ * (plot_right_ - plot_left_) / (x_axis_.max_ - x_axis_.min_));
- y_scale_ = 1.;
- y_shift_ = plot_top_ - (plot_top_ - plot_bottom_) / 2.;
- } // void calculate_transform()
-
- void draw_axes()
- { //! Add information to the plot image for X axis lines.
- //! (For 1-D, there is, of course, only the horizontal X-axis!)
- double x(0.);
- double y1(0.);
- double y2(image_.y_size());
- transform_x(x);
- // Draw origin, making sure it is in the plot window.
- if(x_axis_.axis_line_on_ && (x >= plot_left_) && (x <= plot_right_))
- {
- if(!plot_window_on_)
- { // Use whole image.
- if(title_on_)
- { // Allow space for title, taking account of font size.
- y1 += title_info_.textstyle().font_size() * text_margin_;
- }
- if(x_axis_.label_on_)
- {// Allow space for x tick values, taking account of font size.
- y2 -= x_label_info_.textstyle().font_size() * text_margin_;
- }
- }
- else
- { // Use plot window.
- y1 = plot_top_;
- y2 = plot_bottom_;
- }
- image_.g(detail::PLOT_X_AXIS).line(x, y1, x, y2);
- }
- draw_x_axis();
- } // draw_axes()
-
- void update_image()
- { //! Calls functions to add all plot information to the image, including
- // plot window, axes, ticks, labels, grids, legend, and finally all the data series.
-
- clear_all(); // Removes all elements that will show up in a subsequent draw.
-
- // Draw plot background.
- image_.g(detail::PLOT_BACKGROUND).push_back(
- new rect_element(0, 0, image_.x_size(), image_.y_size()));
-
- calculate_plot_window();
- calculate_transform();
- draw_title(); // Call after above to the plot_x and y are defined.
- if(x_axis_.axis_line_on_)
- {
- draw_axes();
- }
- if(legend_on_)
- {
- draw_legend();
- }
- if(x_axis_.label_on_)
- {
- draw_x_axis_label();
- }
- double y(0.); // All 1-D points are plotted are on the horizontal X axis (y = 0) axis.
- transform_y(y);
- if ((y < plot_top_) || (y > plot_bottom_))
- { // Should never happen!
- throw std::runtime_error("transform_y(y=0) outside plot window!");
- }
-
- for(unsigned int i = 0; i < serieses_.size(); ++i)
- { // Plot the data points for each of the data series.
- g_element& g_ptr = image_.g(detail::PLOT_DATA_POINTS).add_g_element();
- g_ptr.style().stroke_color(serieses_[i].point_style_.stroke_color_);
- g_ptr.style().fill_color(serieses_[i].point_style_.fill_color_);
-
- for(unsigned int j = 0; j < serieses_[i].series_.size(); ++j)
- { // Draw jth point for ith serieses.
- unc<false> ux = serieses_[i].series_[j];
- double x = ux.value();
- // TODO symbols are offset downwards because
- // the origin of the point is the top left of the glyph.
- // Need to offset by the height and width of the font size?
- transform_x(x);
- if((x >= plot_left_) && (x <= plot_right_)) // Check point is inside plot_window.
- // May need a margin here to avoid points just over the window not being shown.
- {
- draw_plot_point(x, y, g_ptr, serieses_[i].point_style_, ux, unc<false>()); // Marker. (y uncertainty is zero)
- if (x_values_on_)
- { // Show the value (& perhaps uncertainty) of the data point too.
- g_element& g_ptr_v = image_.g(detail::PLOT_X_POINT_VALUES).add_g_element();
- draw_plot_point_value(x, y, g_ptr_v, x_values_style_, serieses_[i].point_style_, ux);
- // TODO Might separate X and Y colors?
- }
- else
- { // don't plot anything? Might leave a marker to show an 'off the scale' value?
- }
- } // if in window
- } // for j
- } // for i all normal
-
- // Draw all the 'bad' or at_limit points.
- for(unsigned int i = 0; i < serieses_.size(); ++i)
- {
- g_element& g_ptr = image_.g(detail::PLOT_LIMIT_POINTS);
-
- for (unsigned int j = 0; j != serieses_[i].series_limits_.size(); ++j)
- {
- double x = serieses_[i].series_limits_[j];
- if (limit_NaN(x))
- { // is NaN rather than too big or too small.
- double x = 0.;
- transform_x(x);
- // If include zero, OK, else plot on left or right as appropriate.
- if (x < plot_left_)
- {
- x = plot_left_;
- }
- else if (x > plot_right_)
- {
- x = plot_right_;
- }
- //else X axis includes zero, so x is OK.
- draw_plot_point(x, y, g_ptr, serieses_[i].limit_point_style_, unc<false>(), unc<false>());
- }
- else
- { // Not NaN
- transform_x(x);
- if (x < plot_left_)
- {
- x = plot_left_;
- }
- else if (x > plot_right_)
- {
- x = plot_right_;
- }
- // else is inside plot window, so draw a limit point marker.
- // draw_plot_point(x, y, g_ptr, plot_point_style(lightgray, whitesmoke, s, cone)); default.
- serieses_[i].limit_point_style_.stroke_color_ = image_.g(detail::PLOT_LIMIT_POINTS).style().stroke_color();
- serieses_[i].limit_point_style_.fill_color_ = image_.g(detail::PLOT_LIMIT_POINTS).style().fill_color();
- // This is a kludge. limit_point_style_ should probably be common to all data series.
-
- draw_plot_point(x, y, g_ptr, serieses_[i].limit_point_style_, unc<false>(), unc<false>());
- }
- } // for j
- } // for i limits point
- } // void update_image()
+
+ svg_1d_plot::svg_1d_plot(); //! Constructor of a 1-D plot.
+ void set_ids(); //! Set the XML ids for various layers of the plot.
+ void calculate_plot_window(); //! Calculate the position of the plot window.
+ void calculate_transform(); //! Calculate transform form euclidian to svg coordinate.
+ void draw_axes(); //! Draw the X axis (and, for 2-D, also the Y axis) of the plot.
+ void update_image(); /*! Calls functions to add all plot information to the image, including
+ plot window, axes, ticks, labels, grids, legend, and finally all the data series.*/
// ------------------------------------------------------------------------
// write() has two versions: to an ostream and to a file.
@@ -852,160 +291,19 @@
svg_1d_plot_series& plot(const T& container, const std::string& title = "", U functor = double_1d_convert);
}; // class svg_1d_plot
-// svg_1d_plot Member functions definitions.
-
- svg_1d_plot& svg_1d_plot::write(const std::string& file)
- { /*! Write SVG image to the specified file, providing the suffix .svg if none given.
-
- \details write() has two versions: to an ostream and to a file.
- The stream version first clears all unnecessary data from the graph,
- builds the document tree, and then calls the write function for the root
- document node, which calls all other nodes through the Visitor pattern.
-
- \note This file version opens an ostream, and calls the ostream version of write.
-
- \return *this to make chainable.
- */
- std::string filename(file); // Copy to avoid problems with const if need to append.
- if (filename.find(".svg") == std::string::npos)
- { // No file type suffix, so provide the default .svg.
- filename.append(".svg");
- }
- std::ofstream fout(filename.c_str());
- if(fout.fail())
- {
- throw std::runtime_error("Failed to open " + filename);
- }
- image_.image_filename(filename);
- // Note filename for optional output as comment in the .svg file.
- svg_1d_plot::write(fout); // Use the ostream version.
- return *this;
- }
-
- svg_1d_plot& svg_1d_plot::write(std::ostream& s_out)
- { /*! Write SVG image to the specified std::ostream.
- \note This function also is used by the write to file function.
- \return @c *this to make chainable.
- */
- update_image();
- /*!
- The default stream precision of 6 decimal digits is probably excessive.
- 4.1 Basic data types, integer or float in decimal or scientific (using E format).
- If image size is under 1000 x 1000, the SVG plot default precision of 3 is probably sufficient.
- This reduces .svg file sizes significantly for curves represented with many data points.
- For example, if a curve is shown using 100 points,
- reducing to coord_precision(3) from default of 6 will reduce file size by 300 bytes.
- */
- image_.write(s_out);
- return (svg_1d_plot&) *this;
- } // write
-
- template <class T> //! \tparam T Floating-point type of the data (@c T must be convertible to double).
- svg_1d_plot_series& svg_1d_plot::plot(const T& container, const std::string& title /*= "" */)
- { /*! Add a data series to the plot (by default, converting to unc doubles), with optional title.
- \code
-std::vector<float> my_data; // my container.
-my_data.pushback(2.f); // Fill container with some data.
-my_data.pushback(3.f);
-my_data.pushback(4.f);
-my_1d_plot.plot(my_data, "All data in my container"); // Plot all data in container.
- \endcode
-
- \param container Container (for example vector) for the data to be added to the plot.
- \param title Optional title for the data series (default none).
-
- \return Reference to data series just added (to make chainable).
-
- \note This version assumes that \b ALL the data values in the container are used.
- */
- serieses_.push_back(
- svg_1d_plot_series(
- boost::make_transform_iterator(container.begin(), detail::unc_1d_convert<false>()),
- boost::make_transform_iterator(container.end(), detail::unc_1d_convert<false>()),
- title)
- );
- return serieses_[serieses_.size() - 1];
- } // plot(const T& container, const std::string& title)
-
- template <class T> //! \tparam T floating-point type of the data (T must be convertable to double).
- svg_1d_plot_series& svg_1d_plot::plot(const T& begin, const T& end, const std::string& title)
- { /*! Add a data series to the plot (by default, converting to unc doubles), with optional title.
- \note This version permits a partial range of the container, from begin to end, to be used.
- \return a reference to the data series just added.
- \param begin Iterator to 1st data item in container.
- \param end Iterator to one-beyond-end of data in container.
- \param title Optional title for the plot (default is no title).
-
- */
- serieses_.push_back(
- svg_1d_plot_series(
- boost::make_transform_iterator(begin, detail::unc_1d_convert()),
- boost::make_transform_iterator(end, detail::unc_1d_convert()),
- title)
- );
- /*! For example:\n
- @c my_1d_plot.plot(my_data.begin(), my_data.end(), "My container");\n
- @c my_1d_plot.plot(&my_data[1], &my_data[4], "my_data 1 to 4"); // Add part of data series
-
- \warning last == end which is one past the last, so this only does 1, 2 & 3 - \b not 4!
- */
- return serieses_[serieses_.size() - 1]; // Reference to data series just added.
- } // plot
-
- template <class T, class U> /*!
- \tparam T floating-point type of the data (which must be convertable to double).
- \tparam U functor floating-point type (default is double_1d_convert).
- */
- svg_1d_plot_series& svg_1d_plot::plot(const T& begin, const T& end, const std::string& title /* = ""*/, U functor /* = double_1d_convert */)
- { /*! Add a data series to the plot, with optional title. (Version with custom functor, rather than to double).
- \note This version permits a @b partial range, begin to end, of the container to be used.
-
- \param begin Iterator to 1st data item in container.
- \param end Iterator to one-beyond-end of data in container.
- \param title Optional title for the plot (default is no title).
- \param functor Custom functor.
- \return a reference to data series just added (to make chainable).
- */
- serieses_.push_back(
- svg_1d_plot_series(
- boost::make_transform_iterator(container.begin(), functor),
- boost::make_transform_iterator(container.end(), functor),
- title)
- );
- return serieses_[serieses_.size() - 1]; //!< \return Reference to data series just added.
- } // plot
-
- template <class T, class U> /*!
- \tparam T floating-point type of the data (which must be convertable to double).
- \tparam U functor floating-point type (default is @c double_1d_convert).
- */
- svg_1d_plot_series& svg_1d_plot::plot(const T& container, const std::string& title /* = "" */, U functor/*= double_1d_convert*/)
- { //! Add a data series to the plot, with optional title.
- /*!
- This version of plot includes a functor, allowing other than just convert data values to double(the default).
- \param container Container for data (for example vector) that contains the data to be added to the plot.
- \param title Optional title for the plot (default is no title).
- \param functor Custom functor to convert data value to double.
-
-
- \return a reference to data series just added (to make chainable).
- */
- serieses_.push_back(
- svg_1d_plot_series(
- boost::make_transform_iterator(container.begin(), functor),
- boost::make_transform_iterator(container.end(), functor),
- title)
- );
- return serieses_[serieses_.size() - 1]; // Reference to data series just added.
- } // plot
// End svg_1d_plot Member functions definitions.
-#if defined (BOOST_MSVC)
+#if defined (_MSC_VER)
# pragma warning(pop)
#endif
} // namespace svg
} // namespace boost
+// Definitions are in svg_1d_plot.ipp
+#ifndef BOOST_SVG_SVG_1D_PLOT_IPP
+# include <boost/svg_plot/impl/svg_1d_plot.ipp>
+#endif
+
#endif // BOOST_SVG_SVG_1D_PLOT_HPP
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -9,7 +9,7 @@
*/
// Copyright Jacob Voytko 2007
-// Copyright Paul A. Bristow 2007, 2008, 2009
+// Copyright Paul A. Bristow 2007, 2008, 2009, 2012
// Use, modification and distribution are subject to the
// Boost Software License, Version 1.0.
@@ -28,17 +28,23 @@
#include <boost/iterator/transform_iterator.hpp>
// using boost::make_transform_iterator;
-#include "svg_style.hpp"
-#include "uncertain.hpp"
+#include <boost/quan/unc.hpp>
+#include <boost/quan/unc_init.hpp>
// using boost.svg::unc;
-#include "detail/axis_plot_frame.hpp"
-#include "detail/numeric_limits_handling.hpp"
-#include "detail/functors.hpp"
-#include "detail/auto_axes.hpp"
-#include "detail/numeric_limits_handling.hpp"
+
+#include <boost/svg_plot/svg.hpp>
+#include <boost/svg_plot/svg_style.hpp>
+#include <boost/svg_plot/detail/axis_plot_frame.hpp> // Code shared with 2D.
+#include <boost/svg_plot/detail/functors.hpp>
+// using boost::svg::detail::unc_2d_convert;
+#include <boost/svg_plot/detail/numeric_limits_handling.hpp>
+#include <boost/svg_plot/detail/functors.hpp>
+#include <boost/svg_plot/detail/auto_axes.hpp>
using boost::svg::detail::limit_NaN;
-#include "svg.hpp"
+#include <boost/quan/meas.hpp>
+
+#include <boost/svg_plot/svg.hpp>
#include <map> // for map & multimap
#include <string>
@@ -75,7 +81,8 @@
public:
// 2-D Data series points to plot.
- std::multimap<unc<false>, unc<false>> series_; //!< Normal 'OK to plot' data values.
+ std::multimap<Meas, unc<false> > series_; //!< Normal 'OK to plot' data values.
+ // std::multimap<unc<false>, unc<false>> series_; //!< Normal 'OK to plot' data values.
std::multimap<double, double> series_limits_; //!< 'limit' values: too big or small, or NaN.
std::string title_; //!< Title of data series (to show on legend using legend style).
@@ -140,8 +147,8 @@
:
title_(title), //!< Title of a series of data values.
// plot_point_style(const svg_color& fill = blank, const svg_color& stroke = black,
- // int size = 5, point_shape shape = round, const std::string& symbols = "X")
- point_style_(black, white, 5, round), // Default point style (default fill white).
+ // int size = 5, point_shape shape = circlet, const std::string& symbols = "X")
+ point_style_(black, white, 5, circlet), // Default point style (default fill white).
limit_point_style_(grey, blank, 10, cone), // Default limit (infinity or NaN) point style.
line_style_(black, blank, 2, false, false), // Default line style, no fill, width 2, no line_on, no bezier.
bar_style_(black, blank, 3, no_bar), // Default black, no fill, stick width 3, no bar.
@@ -150,8 +157,9 @@
{ // Constructor.
for(T i = begin; i != end; ++i)
{ // Sort data points into normal and limited series.
- std::pair<unc<false>, unc<false>> temp = *i;
- unc<false> ux = temp.first;
+ std::pair<Meas, unc<false> > temp = *i;
+ //std::pair<unc<false>, unc<false>> temp = *i;
+ Meas ux = temp.first;
unc<false> uy = temp.second;
std::pair<double, double> xy = std::make_pair<double, double>(ux.value(), uy.value());
if(detail::pair_is_limit(xy))
@@ -432,12 +440,21 @@
int x_axis_position_; //!< Intersection with Y axis, or not.
int y_axis_position_; //!< Intersection with X axis, or not.
+ // Parameters for calculating confidence intervals (for both X and Y values).
+ // These might be picked up from uncertain types.
+ double alpha_; // = 0.05; // oss.iword(confidenceIndex) / 1.e6; // Pick up alpha.
+ double epsilon_; // = 0.01; // = oss.iword(roundingLossIndex) / 1.e3; // Pick up rounding loss.
+ int uncSigDigits_; // = 2; // = oss.iword(setUncSigDigitsIndex); // Pick up significant digits for uncertainty.
+ bool isNoisyDigit_; // = false; // Pick up?
+
bool autoscale_check_limits_; //!< true if to check autoscale values for infinity, NaN, max, min.
bool x_autoscale_; //!< true if to use any X-axis autoscale values.
- double autoscale_plusminus_; //!< For uncertain values, allow for plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
+ double autoscale_plusminus_; //!< For uncertain values, allow for text_plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
//!< For example, if a max value is 1.2 +or- 0.02, then 1.4 will be used for autoscaling the maximum.\n
//!< Similarly, if a min value is 1.2 +or- 0.02, then 1.0 will be used for autoscaling the minimum.
+ double text_plusminus_; // Nominal factor of 1. (default) corresponds to 67% confidence limit.
+
bool x_include_zero_; //!< true if autoscaled, to include zero.
int x_min_ticks_; //!< If autoscaled, set a minimum number of X ticks.
double x_tight_; //!< Tolerance used by autoscale to avoid extra ticks.
@@ -461,7 +478,7 @@
int y_auto_ticks_; //!< Number of ticks (calculated by Y autoscale).
std::vector<svg_2d_plot_series> serieses_; //!< Store of several series of data points for transformation.
- std::vector<text_element> notes_; //!< Store of text for annotation.
+ std::vector<text_element> notes_; //!< Store of text for annotation. (Not used yet?)
std::string plot_window_clip_; /*!< = "clip_plot_window" id for clippath
http://www.w3.org/TR/SVG/masking.html#ClipPathElement 14.1 Introduction clipping paths,\n
@@ -542,6 +559,14 @@
x_values_style_(horizontal, 3, std::ios::dec, true, value_style_, black, black, false, false),
y_values_style_(downward, 3, std::ios::dec, true, value_style_, black, black, false, false),
+ text_plusminus_(1.),
+ // Confidence interval parameters.
+ // (Could provide functions for the user to control these).
+ alpha_(0.05), // oss.iword(confidenceIndex) / 1.e6; 95% confidence.
+ epsilon_(0.05), // = oss.iword(roundingLossIndex) / 1.e3; // = allow 5% rounding loss.
+ uncSigDigits_(2), // = oss.iword(setUncSigDigitsIndex); // ISO standard =2 by default.
+ isNoisyDigit_(false), // Add extra digit to display?
+
// Autoscaling defaults.
autoscale_check_limits_(true), // Do check all value for limits, infinity, max, min, NaN.
autoscale_plusminus_(3.), // Allow 3 uncertainty (standard deviation) for 99% confidence ellipse.
@@ -1620,13 +1645,15 @@
double prev_y;
if(series.series_.size() > 1)
{ // Need at least two points for a line ;-)
- std::multimap<unc<false>, unc<false>>::const_iterator j = series.series_.begin();
+ std::multimap<Meas, unc<false> >::const_iterator j = series.series_.begin();
+ //std::multimap<unc<false>, unc<false> >::const_iterator j = series.series_.begin();
// If required to fill the area under the plot,
// we first have to move from the X-axis (y = 0) to the first point,
// and again to the X-axis (y = 0) at the end after the last point.
// std::multimap<double, double> was prev_x = (*j).first;
- unc<false> prev_ux = (*j).first;
+ Meas prev_ux = (*j).first;
+ //unc<false> prev_ux = (*j).first;
prev_x = prev_ux.value(); // 1st point X-value.
prev_y = 0.; // y = 0, so on horizontal X-axis.
transform_point(prev_x, prev_y);
@@ -1699,23 +1726,25 @@
if(series.series_.size() > 2)
{ // Need >= 3 points for a cubic curve (start point, 2 control points, and end point).
- std::multimap<unc<false>, unc<false> >::const_iterator iter = series.series_.begin();
- std::pair<unc<false>, unc<false> > un_minus_1 = *(iter++); // 1st unc X & Y data.
+ std::multimap<Meas, unc<false> >::const_iterator iter = series.series_.begin();
+ // std::multimap<unc<false>, unc<false> >::const_iterator iter = series.series_.begin();
+ std::pair<Meas, unc<false> > un_minus_1 = *(iter++); // 1st unc X & Y data.
+// std::pair<unc<false>, unc<false> > un_minus_1 = *(iter++); // 1st unc X & Y data.
n_minus_1 = std::make_pair(un_minus_1.first.value(), un_minus_1.second.value()); // X and Y values.
//n_minus_1 = *(iter++); // begin()
transform_pair(n_minus_1);
- std::pair<unc<false>, unc<false> > un = *(iter++); // middle
+ std::pair<Meas, unc<false> > un = *(iter++); // middle
n = std::make_pair(un.first.value(), un.second.value()); // X and Y values.
transform_pair(n);
path.M(n_minus_1.first, n_minus_1.second); // move m_minus_1, the 1st data point.
double control = 0.1;
- //0.2 is a scaling factor that Jake used to define the magnitude of the
- //vector of the current control point to be placed. I was basically
- //taking advantage of the auto-drawing of Bezier curves that exists in
- //the SVG format, and this is my attempt to give the control point the
- //proper length.
+ // 0.2 is a scaling factor that Jake used to define the magnitude of the
+ // vector of the current control point to be placed, basically
+ // taking advantage of the auto-drawing of Bezier curves that exists in
+ // the SVG format, and this is his attempt to give the control point the
+ // proper length.
// Experiment suggests that 0.2 gives distorsions with exp curves.
// 0.05 is just visually OK with 50 points, but 100 are better.
@@ -1724,7 +1753,7 @@
{
n_minus_2 = n_minus_1;
n_minus_1 = n;
- std::pair<unc<false>, unc<false> > un = *iter; // middle
+ std::pair<Meas, unc<false> > un = *iter; // middle
n = std::make_pair(un.first.value(), un.second.value()); // X and Y values.
transform_pair(n);
@@ -1785,15 +1814,17 @@
.fill_color(serieses_[i].point_style_.fill_color_)
.stroke_color(serieses_[i].point_style_.stroke_color_);
- for(std::multimap<unc<false>, unc<false> >::const_iterator j = serieses_[i].series_.begin();
+ for(std::multimap<Meas, unc<false> >::const_iterator j = serieses_[i].series_.begin();
+ //for(std::multimap<unc<false>, unc<false> >::const_iterator j = serieses_[i].series_.begin();
j != serieses_[i].series_.end(); ++j)
{
- unc<false> ux = j->first;
+ Meas ux = j->first;
+ //unc<false> ux = j->first;
x = ux.value(); // Just the X value.
//double vx = x; // Note the true X value.
unc<false> uy = j->first;
uy = j->second;
- y = uy.value(); // Just the Y value
+ y = uy.value(); // Just the Y value.
//double vy = y; // Note the true Y value.
transform_point(x, y); // Note x and y are now SVG coordinates.
if((x > plot_left_) && (x < plot_right_) && (y > plot_top_) && (y < plot_bottom_))
@@ -1813,7 +1844,7 @@
draw_plot_point_value(x, y, g_ptr_vy, y_values_style_,serieses_[i].point_style_, uy);
}
if (xy_values_on_)
- { // Show the values of the X & Y data as a pair.
+ { // Show the two values of the X & Y data as a pair.
draw_plot_point_values(x, y, g_ptr_vx, g_ptr_vy, x_values_style_, y_values_style_, ux, uy);
}
} // if in side window
@@ -1926,10 +1957,10 @@
double h_w = serieses_[i].bar_style_.width_; // For block bar chart.
//double h_h = 0.;
- for(std::multimap<unc<false>, unc<false> >::const_iterator j = serieses_[i].series_.begin();
+ for(std::multimap<Meas, unc<false> >::const_iterator j = serieses_[i].series_.begin();
j != serieses_[i].series_.end(); ++j)
{ // All the 'good' data points.
- unc<false> ux = j->first;
+ Meas ux = j->first;
x = ux.value();
unc<false> uy = j->second;
y = uy.value();
@@ -2017,26 +2048,26 @@
path.style().fill_color(blank);
}
- std::multimap<unc<false>, unc<false> >::const_iterator last = serieses_[i].series_.end();
+ std::multimap<Meas, unc<false> >::const_iterator last = serieses_[i].series_.end();
last--; // Final pair with first the last bin end, and value zero or NaN.
- unc<false> u = last->second;
+ Meas u = last->second;
if (u.value() != 0)
{
std::cout << "Last bin end " << last->first << " should have zero value! but is " << last->second << std::endl;
// Or Throw? or skip this series?
}
- for(std::multimap<unc<false>, unc<false> >::const_iterator j = serieses_[i].series_.begin();
+ for(std::multimap<Meas, unc<false> >::const_iterator j = serieses_[i].series_.begin();
j != last; ++j)
{ // All the 'good' 'real' data points.
- unc<false> ux = j->first;
+ Meas ux = j->first;
double x = ux.value();
unc<false> uy = j->second;
double y = uy.value();
- std::multimap<unc<false>, unc<false> >::const_iterator j_next = j;
+ std::multimap<Meas, unc<false> >::const_iterator j_next = j;
j_next++;
if (j != last)
{ // Draw a column (perhaps filled) to show bin.
- unc<false> ux_next= j_next->first;
+ Meas ux_next= j_next->first;
double x_next = ux_next.value();
double w = x_next - x;
double h = y / w;
@@ -2178,6 +2209,13 @@
svg_2d_plot& y_plusminus_on(bool b);
svg_2d_plot& y_plusminus_color(const svg_color& col);
const svg_color y_plusminus_color();
+
+ bool y_addlimits_on();
+ svg_2d_plot& y_addlimits_on(bool b);
+ svg_2d_plot& y_addlimits_color(const svg_color& col);
+ const svg_color y_addlimits_color();
+
+
bool y_df_on();
svg_2d_plot& y_df_on(bool b);
svg_2d_plot& y_df_color(const svg_color& col);
@@ -2630,6 +2668,33 @@
return y_values_style_.plusminus_color_;
}
+
+
+ bool svg_2d_plot::y_addlimits_on()
+ {//! \return true if values of Y data points are to include confidence interval.
+ return y_values_style_.addlimits_on_;
+ }
+
+ svg_2d_plot& svg_2d_plot::y_addlimits_on(bool b)
+ { //! Set true if values of Y data points are to include confidence interval.
+ y_values_style_.addlimits_on_ = b;
+ return *this;
+ } //! \return reference to svg_2d_plot to make chainable.
+
+ svg_2d_plot& svg_2d_plot::y_addlimits_color(const svg_color& col)
+ { //! Set color of Y confidence interval.
+ y_values_style_.addlimits_color_ = col;
+ return *this; //! \return reference to svg_2d_plot to make chainable.
+ }
+
+ const svg_color svg_2d_plot::y_addlimits_color()
+ { //! \return color of Y confidence interval.
+ return y_values_style_.addlimits_color_;
+ }
+
+
+
+
bool svg_2d_plot::y_df_on()
{ //! \return true if values of Y data points are to include degrees of freedom estimates.
return svg_2d_plot::y_values_style_.df_on_;
@@ -3151,19 +3216,19 @@
return *this; //! \return reference to svg_2d_plot to make chainable.
} // write(file)
- template <class T> //! \tparam T Type of data in series (must be convertible to unc double).
+ template <class T> //! \tparam T Type of data in series (must be convertible to Meas).
svg_2d_plot_series& svg_2d_plot::plot(const T& container, const std::string& title)
{ /*! Add a container of a data series to the plot.
This version assumes that \b ALL the data values in the container are to be plotted.
\code
my_plot.plot(data1, "Sqrt(x)");
\endcode
- Version converting to double with \c pair_double_2d_convert.
+ Version converting to Meas using double with \c pair_double_2d_convert.
*/
serieses_.push_back(
svg_2d_plot_series(
- boost::make_transform_iterator(container.begin(), detail::pair_unc_2d_convert<false>()),
- boost::make_transform_iterator(container.end(), detail::pair_unc_2d_convert<false>()),
+ boost::make_transform_iterator(container.begin(), detail::pair_Meas_2d_convert<false>()),
+ boost::make_transform_iterator(container.end(), detail::pair_Meas_2d_convert<false>()),
title)
);
return serieses_[serieses_.size()-1]; //! \return Reference to data series just added to make chainable.
Modified: sandbox/SOC/2007/visualization/boost/svg_plot/svg_boxplot.hpp
==============================================================================
--- sandbox/SOC/2007/visualization/boost/svg_plot/svg_boxplot.hpp (original)
+++ sandbox/SOC/2007/visualization/boost/svg_plot/svg_boxplot.hpp 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -47,7 +47,9 @@
#include <boost/svg_plot/detail/axis_plot_frame.hpp>
#include <boost/svg_plot/detail/auto_axes.hpp>
#include <boost/svg_plot/quantile.hpp>
-#include <boost/svg_plot/uncertain.hpp>
+
+#include <boost/quan/unc.hpp>
+
#include <vector>
#include <string>
@@ -60,9 +62,6 @@
{
namespace svg
{
- //static const double sin45 = 0.707; // Use if axis value labels are sloping.
- //static svg_style not_a_svg_style; // Used as a test for not set.
-
//// x_axis_position_ and y_axis_position_ use these.
//enum x_axis_intersect {bottom = -1, x_intersects_y = 0, top = +1};
//// bottom = X-axis free below bottom of end of Y-axis (case of all Y definitely < 0).
@@ -701,10 +700,14 @@
int x_auto_ticks_; //!< Number of ticks calculated by scale_axis.
bool y_autoscale_; //!< If true then to use any y_axis autoscale values.
- double autoscale_plusminus_; //!< For uncertain values, allow for plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
+ double autoscale_plusminus_; //!< For uncertain values, allow for text_plusminus ellipses showing 67%, 95% and 99% confidence limits.\n
//!< For example, if a max value is 1.2 +or- 0.02, then 1.4 will be used for autoscaling the maximum.\n
//!< Similarly, if a min value is 1.2 +or- 0.02, then 1.0 will be used for autoscaling the minimum.
+ double text_plusminus_; /*!< Number of standard deviations used for text_plusminus text display.\n
+ Nominal factor of 1. (default) corresponds to 67% confidence limit,
+ 2 (strictly 1.96) corresponds to 95% confidence limit. */
+
bool y_include_zero_; //!< If autoscaled, include zero.
int y_min_ticks_; //!< If autoscaled, set a minimum number of Y ticks.
double y_tight_; //!< How much a point is allowed beyond the Y minimum or maximum before another tick is used.
@@ -724,7 +727,14 @@
bool median_values_on_; //!< true if median of data is shown as well as a line marker.
bool outlier_values_on_; //!< true if outlier values of data are shown.
bool extreme_outlier_values_on_; //!< true if values of extreme outlier data are shown.
-
+
+ // Parameters for calculating confidence intervals (for both X and Y values).
+ // These might be picked up from uncertain types.
+ double alpha_; // = 0.05; // oss.iword(confidenceIndex) / 1.e6; // Pick up alpha.
+ double epsilon_; // = 0.01; // = oss.iword(roundingLossIndex) / 1.e3; // Pick up rounding loss.
+ int uncSigDigits_; // = 2; // = oss.iword(setUncSigDigitsIndex); // Pick up significant digits for uncertainty.
+ bool isNoisyDigit_; // = false; // Pick up?
+
std::vector<svg_boxplot_series> series; //!< Storing the data points for sorting by value.
// Defaults (see below) for the box'n'whiskers
@@ -813,7 +823,7 @@
axis_style_(black, blank, 1),
min_whisker_style_(magenta, black, 1),
max_whisker_style_(cyan, black, 1),
- mild_outlier_(brown, blank, 5, round),
+ mild_outlier_(brown, blank, 5, circlet),
ext_outlier_(red, blank, 5, cone)
{ //! Default constructor providing all the default colors, style etc,
using std::cout;
@@ -1737,7 +1747,7 @@
{ // Inside plot window so want to show.
y = value;
transform_y(y); // to SVG.
- draw_plot_point(x, y, g_mild_ptr, const_cast<plot_point_style&>(mild_style), unc(0), unc(0)); // Kludge!
+ draw_plot_point(x, y, g_mild_ptr, const_cast<plot_point_style&>(mild_style), unc<false>(0), unc<false>(0)); // Kludge!
if (outlier_values_on_)
{ // Show the value of the data point too.
draw_plot_point_value(x, y, image_.g(boxplot::DATA_VALUE_LABELS).add_g_element(), const_cast<value_style&>(values_style), mild_outlier_, value);
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 2012-08-22 04:58:14 EDT (Wed, 22 Aug 2012)
@@ -539,7 +539,8 @@
class value_style
{ /*! \class boost::svg::value_style
- \brief Data series point value label information, text, color, orientation, (uncertainty & df).
+ \brief Data series point value label information, text, color, orientation, (uncertainty & df),
+ name ID string, order in sequence, time and date.
\details For example, to output: 5.123 +- 0.01 (19).
Uncertainty and degrees of freedom estimate.
Prefix, separator and suffix allow X and Y values to be together on one line, for example\n
@@ -547,8 +548,9 @@
Used in draw_plot_point_values (note plural - not used in singular draw_plot_point_value)
where X value_style is used to provide the prefix and separator, and Y value_style to provide the suffix.
Prefix, separator and suffix are ignored when X or Y are shown separately using draw_plot_point_value.
+ "4.5+- 0.01 (3) Second #2, 2012-Mar-13 13:01:00"
+
*/
-// private: // would require lots of set/get functions or lots of friend statements?
public:
rotate_style value_label_rotation_; //!< Direction point value labels written.
int value_precision_; //!< Decimal digits of precision of value.
@@ -562,30 +564,48 @@
\details See http://en.wikipedia.org/wiki/Plus-minus_sign
*/
svg_color plusminus_color_; //!< Color for uncertainty, for example: 0.02 in "1.23 +-0.02".
+ bool addlimits_on_; //!< If an confidence interval is to be added, for example <4.5, 4.8>.
+ svg_color addlimits_color_; //!< Color for confidence interval.
bool df_on_; //!< If a degrees of freedom estimate is to be appended.
svg_color df_color_; //!< Color for degrees for freedom, for example: 99 in "1.23 +-0.02 (99)".
+ bool id_on_; //!< If an id or name string to be appended. default == false,
+ svg_color id_color_; //!< Color for id or name string".
+ bool datetime_on_; //!< If an time and/or date string to be appended. default == false,
+ svg_color datetime_color_; //!< Color for time and date string".
+ bool order_on_; //!< If an order in sequence number # to be appended. default == false,
+ svg_color order_color_; //!< Color for sequence number #".
std::string prefix_; //!< Prefix to data point value, default none, but typically "[".
std::string separator_; //!< Separator between x and y values, if both on same line (none if only X or only Y, or Y below X).
std::string suffix_; //!< Suffix to data point value, default none, but typically "]".
- public:
- value_style(); //!< Default style for a data point value label.
- value_style( //!< Set style for a data point value label.
- rotate_style r, //!< Label orientation, default horizontal.
- int p, //!< Precision, reduced from default of 6 which is usually too long.
- std::ios_base::fmtflags f, //!< Any std::ios::ioflags, for example, hex, fixed, scientific.
- bool s, //!< If true, then unnecessary zeros will be stripped to reduce length.
- text_style ts, //!< Value text style, all defaults, black etc.
- const svg_color& scol, //!< stroke color == black.
- const svg_color& fcol, //!< fill color== black.
- bool pm, //!< If uncertainty estimate to be appended. == false,
- const svg_color& plusminus_color, //!< Default color for uncertainty of value.
- bool df, //!< If a degrees of freedom estimate to be appended. == false,
- const svg_color& df_color, //!< Default color for degrees of freedom.
- std::string pre, //!< Prefix, for example: "[",
- std::string sep, //!< separator, for example: ", ",
- //!< (If just put ", " the trailing space seems to be ignored, so add Unicode explicit space).
- std::string suf ); //!< suffix, for example: "]"
+ // Constructors declarations.
+ value_style(); //!< Default style for a data point value label.
+
+ value_style( //!< Set style for a data point value label.
+ rotate_style r, //!< Label orientation, default horizontal.
+ int p, //!< Precision, reduced from default of 6 which is usually too long.
+ std::ios_base::fmtflags f, //!< Any std::ios::ioflags, for example, hex, fixed, scientific.
+ bool s, //!< If true, then unnecessary zeros will be stripped to reduce length.
+ text_style ts, //!< Value text style, all defaults, black etc.
+ const svg_color& scol, //!< stroke color == black.
+ const svg_color& fcol, //!< fill color== black.
+ bool pm, //!< If uncertainty estimate to be appended. == false,
+ const svg_color& plusminus_color, //!< Default color for uncertainty of value.
+ bool lim, //!< If uncertainty estimate to be appended. == false,
+ const svg_color& addlimits_color, //!< Default color for uncertainty of value.
+ bool df, //!< If a degrees of freedom estimate to be appended. == false,
+ const svg_color& df_color, //!< Default color for degrees of freedom.
+ bool id, //!< If an id or name string to be appended. default == false,
+ const svg_color& id_color, //!< Default color for id or name of value.
+ bool dt, //!< If an time and/or date string to be appended. default == false,
+ const svg_color& dt_color, //!< Default color for date and time.
+ bool ordno, //!< If an order in sequence number # to be appended. default == false,
+ const svg_color& ordno_color, //!< Default color for degrees of freedom.
+ std::string pre, //!< Prefix, for example: "[",
+ std::string sep, //!< separator, for example: ", ",
+ //!< (If just put ", " the trailing space seems to be ignored, so add Unicode explicit space).
+ std::string suf //!< suffix, for example: "]"
+ );
}; // class value_style
@@ -603,11 +623,23 @@
fill_color_(svg_color(0, 0, 0)), //!< no fill.
plusminus_on_(false), //!< If uncertainty estimate to be appended.
plusminus_color_(black), //!< Default color for uncertainty of value.
+ addlimits_on_(false), //!< If uncertainty estimate to be appended.
+ addlimits_color_(black), //!< Default color for uncertainty of value.
df_on_(false), //!< If a degrees of freedom estimate to be appended.
- df_color_(black) //!< Default color for degrees of freedom.
+ df_color_(black), //!< Default color for degrees of freedom is black.
+ id_on_(false), //!< If an id or name string to be appended.
+ id_color_(black), //!< Default color for an id or name string is black.
+ datetime_on_(false), //!< If a date and date to be appended.
+ datetime_color_(black), //!< Default color for date and date is black.
+ order_on_(false), //!< If a order # to be appended.
+ order_color_(black), //!< Default color for order # is black.
+ prefix_(""),
+ separator_(","),
+ suffix_("")
{ //! Default constructor initialises all private data.
}
+ //!< Constructor Data point value label style (provides default color and font).
value_style::value_style(rotate_style r, //!< Label orientation, default horizontal.
int p, //!< Reduced from default of 6 which is usually too long.
std::ios_base::fmtflags f, //!< Any std::ios::ioflags, for example, hex, fixed, scientific.
@@ -617,8 +649,16 @@
const svg_color& fcol = black, //!< no fill.
bool pm = false, //!< If uncertainty estimate to be appended.
const svg_color& plusminus_color = black, //!< Default color for uncertainty of value.
+ bool lim = false, //!< If confidence limits to be appended.
+ const svg_color& addlimits_color = black, //!< Default color for confidence limits.
bool df = false, //!< If a degrees of freedom estimate to be appended.
const svg_color& df_color = black,//!< Default color for uncertainty of value.
+ bool id = false, //!< If a degrees of freedom estimate to be appended.
+ const svg_color& id_color = black,//!< Default color for uncertainty of value.
+ bool dt = false, //!< If a degrees of freedom estimate to be appended.
+ const svg_color& dt_color = black,//!< Default color for uncertainty of value.
+ bool ordno = false, //!< If a degrees of freedom estimate to be appended.
+ const svg_color& order_color = black,//!< Default color for uncertainty of value.
// Separators [,] provide, for example: [1.23+-0.01 (3), 4.56 +-0.2 (10)]
std::string pre = "", //!< Prefix, for example: "[",
std::string sep = "", //!< separator, for example: ,\&\#x00A0;", // If put ", " the trailing space seems to be ignored, so add Unicode explicit space.
@@ -626,7 +666,12 @@
:
value_label_rotation_(r), value_precision_(p), value_ioflags_(f), strip_e0s_(s),
values_text_style_(ts), stroke_color_(scol), fill_color_(fcol),
- plusminus_on_(pm), plusminus_color_(plusminus_color), df_on_(df), df_color_(df_color),
+ plusminus_on_(pm), plusminus_color_(plusminus_color),
+ addlimits_on_(lim), addlimits_color_(addlimits_color),
+ df_on_(df), df_color_(df_color),
+ id_on_(id), id_color_(id_color),
+ datetime_on_(dt), datetime_color_(dt_color),
+ order_on_(ordno), order_color_(order_color),
prefix_(pre), separator_(sep), suffix_(suf)
{ //! Constructor setting parameters with some defaults.
}
@@ -637,7 +682,10 @@
{ //! \enum point_shape used for marking a data point.
// Used in draw_plot_point in axis_plot_frame.hpp
none = 0, //!< No marker for data point.
- round, //!< Circle but name changed to round to avoid clash with function named circle.
+ circlet, /*!< Circle. Name was changed to round to avoid clash with function named circle,
+ but was then found to clash with C++ Standard numeric function round.
+ Full qualification `point_shape::round` requires C++11 support to compile, so then changed to circlet.
+ */
square, //!< Square.
point, //!< Small solid point.
egg, //!< Ellipse.
@@ -705,7 +753,7 @@
const svg_color& stroke = black, //!< Color of circumference of shape.
const svg_color& fill = blank, //!< Fill color of the centre of the shape.
int size = 5, //!< Diameter of circle, height of square, font_size ...
- point_shape shape = round, //!< shape: round, square, point...
+ point_shape shape = circlet, //!< shape: circlet, square, point...
const std::string& symbols = "X"); //!< Unicode symbol(s) (letters, digits, squiggles etc).
plot_point_style& size(int i);