From: pbristow_at_[hidden]
Date: 2008-05-24 12:54:00
Author: pbristow
Date: 2008-05-24 12:54:00 EDT (Sat, 24 May 2008)
New Revision: 45731
URL: http://svn.boost.org/trac/boost/changeset/45731
Log:
Description of dist explorer as Quickbook to go on sourceforge & jamfile to build.
Added:
sandbox/math_toolkit/libs/math/doc/distexplorer/
sandbox/math_toolkit/libs/math/doc/distexplorer/Jamfile.v2 (contents, props changed)
sandbox/math_toolkit/libs/math/doc/distexplorer/distexplorer.qbk (contents, props changed)
Added: sandbox/math_toolkit/libs/math/doc/distexplorer/Jamfile.v2
==============================================================================
--- (empty file)
+++ sandbox/math_toolkit/libs/math/doc/distexplorer/Jamfile.v2 2008-05-24 12:54:00 EDT (Sat, 24 May 2008)
@@ -0,0 +1,63 @@
+# Copyright Paul A. Bristow 2008
+# Copyright John Maddock 2008
+
+# Distributed under the Boost Software License, Version 1.0.
+# (See accompanying file LICENSE_1_0.txt
+# or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+# Reminder: whitespace MUST terminate variable name!
+# so space BEFORE ; and :
+
+# Distexplorer documentation as html from Quickbook.
+
+# project boost/doc ;
+
+using quickbook ;
+
+#path-constant images_location : html ;
+# location of SVG images referenced by Quickbook.
+# screenshots installed as recomended by Sourceforge.
+
+xml distexplorer
+ :
+ distexplorer.qbk
+ :
+;
+
+# import boostbook : boostbook ;
+
+boostbook standalone
+ :
+ distexplorer
+ :
+
+ # Path for links to Boost:
+ <xsl:param>boost.root=../../../../../../../../trunk
+ # Path for libraries index:
+ <xsl:param>boost.libraries=$(boost-root)/libs/libraries.htm
+ # Use the main Boost stylesheet:
+ <xsl:param>html.stylesheet=../../../../../../../../trunk/doc/html/boostbook.css
+ # Use the distexplorer local Boost stylesheet:
+ # <xsl:param>html.stylesheet=./html/boostbook.css
+
+ # Some general style settings:
+ <xsl:param>table.footnote.number.format=1
+ <xsl:param>footnote.number.format=1
+
+ # HTML options first:
+ # Use graphics not text for navigation:
+ <xsl:param>navig.graphics=1
+ # How far down we chunk nested sections, basically all of them:
+ <xsl:param>chunk.section.depth=10
+ # Don't put the first section on the same page as the TOC:
+ <xsl:param>chunk.first.sections=1
+ # How far down sections get TOC's
+ <xsl:param>toc.section.depth=10
+ # Max depth in each TOC:
+ <xsl:param>toc.max.depth=4
+ # How far down we go with TOC's
+ <xsl:param>generate.section.toc.level=10
+ #<xsl:param>root.filename="distexplorer"
+;
+
+
Added: sandbox/math_toolkit/libs/math/doc/distexplorer/distexplorer.qbk
==============================================================================
--- (empty file)
+++ sandbox/math_toolkit/libs/math/doc/distexplorer/distexplorer.qbk 2008-05-24 12:54:00 EDT (Sat, 24 May 2008)
@@ -0,0 +1,105 @@
+[article Statistical Distribution Explorer
+ [quickbook 1.4]
+ [copyright 2008 Paul A. Bristow, John Maddock]
+ [license
+ Distributed under the Boost Software License, Version 1.0.
+ (See accompanying file LICENSE_1_0.txt or copy at
+ [@http://www.boost.org/LICENSE_1_0.txt])
+ ]
+ [authors [Bristow, Paul A.], [Maddock, John]]
+ [category math]
+ [purpose mathematics]
+ [/last-revision $Date$]
+]
+
+A Windows utility to show the properties of statistical distributions
+using parameters provided interactively by the user.
+
+The distributions provided are:
+
+*bernoulli
+*beta_distribution
+*binomial_distribution
+*cauchy
+*chi_squared
+*exponential
+*extreme_value
+*fisher_f
+*gamma_distribution
+*lognormal_distribution
+*negative_binomial_distribution
+*normal_distribution
+*pareto
+*poisson
+*rayleigh
+*students_t
+*triangular
+*uniform
+*weibull
+
+Properties of distributions computed are:
+
+*mean
+*mode
+*median
+*variance
+*standard deviation
+*coefficient of variation,
+*skewness
+*kurtosis
+*excess
+*range supported
+
+Calculated, from values provided, are:
+
+*probability density (or mass) function (PDF)
+*cumulative distribution function (CDF), and complement
+*Quantiles (percentiles) are calculated for typical risk (alpha) probabilities (0.001, 0.01, 0.5, 0.1, 0.333)
+and for additional probabilities provided by the user.
+
+Results can be saved to text files using Save or SaveAs.
+All the values on the four tabs are output to the file chosen,
+and are tab separated to assist input to other programs,
+for example, spreadsheets or text editors.
+
+Note: Excel (for example), only shows 10 decimal digits, by default:
+to display the maximum possible precision (abotu 15 decimal digits),
+it is necessary to format all cells to display this precision.
+Although unusually accurate, not all values computed by Distexplorer will be as accurate as this.
+Values shown as NaN cannot be calculated from the value(s) given,
+most commonly because the value input is outside the range for the distribution.
+
+For more information, including downloads, see
+
+[@http://distexplorer.sourceforge.net/ Distexplorer at Sourceforge]
+
+This Microsoft Windows 32 package distribution.exe
+was generated from a C# program
+and uses a boost_math.dll generated using the
+Boost.Math C++ source code from the Boost.Math Toolkit, compiled in CLI mode,
+containing the underlying statistical distribution classes and functions.
+
+All source code is freely available for view and use under the
+[@http://www.boost.org/LICENSE_1_0.txt Boost Open Source License].
+
+[@https://svn.boost.org/svn/boost/sandbox\math_toolkit\libs\math\dot_net_example
+Math Toolkit C++ source code]
+to produce boost_math.dll is in the most recent [@http://www.boost.org Boost] release, initially 1.35.0.
+
+It is distributed as a single Windows Installer package Setupdistex.msi.
+Unzip the distexplorer.zip to a temporary location of your choice and run setup.exe.
+
+(Note that .NET framework 2.0 and VCredist are requirements for this program.
+Most recent and updated Windows environments will already have these,
+but they are quickly, easily and safely installed from the Microsoft site if required.)
+
+(The package cannot be run on other platforms at present but it should be possible
+to build an equivalent utility on any C/C++ platform if anyone would like to undertake this task.)
+
+[/ Distexplorer.qbk
+ Copyright 2008 John Maddock and Paul A. Bristow.
+ Distributed under the Boost Software License, Version 1.0.
+ (See accompanying file LICENSE_1_0.txt or copy at
+ http://www.boost.org/LICENSE_1_0.txt).
+]
+