Skip to content

Commit 94c1a7f

Browse files
committed
Modernize docstrings: drop @multitable spacer columns, use * in @math dimensions.
* inst/mvksdensity.m: Replace the bare 'x' with '*' in the @math matrix dimension expressions (NxD, MxD, Mx1, 1xD). * inst/dist_obj/StableDistribution.m: Likewise for 4x1, 4x4, and 2x4. * inst/dist_obj/BinomialDistribution.m: Drop the empty middle spacer column from the plot Name-Value @multitable (@columnfractions 0.18 0.02 0.8 -> 0.18 0.8), removing the extra @tab from the header and item rows. * inst/dist_obj/MultinomialDistribution.m: Likewise. * inst/dist_obj/BetaDistribution.m: Likewise. * inst/doc-cache: Regenerate the mvksdensity entry.
1 parent f48146d commit 94c1a7f

6 files changed

Lines changed: 28 additions & 28 deletions

File tree

inst/dist_obj/BetaDistribution.m

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -521,10 +521,10 @@ function disp (this)
521521
## @code{plot (@var{pd}, @var{Name}, @var{Value})} specifies additional
522522
## options with the @qcode{Name-Value} pair arguments listed below.
523523
##
524-
## @multitable @columnfractions 0.18 0.02 0.8
525-
## @headitem @tab @var{Name} @tab @var{Value}
524+
## @multitable @columnfractions 0.18 0.8
525+
## @headitem @var{Name} @tab @var{Value}
526526
##
527-
## @item @qcode{'PlotType'} @tab @tab A character vector specifying the plot
527+
## @item @qcode{'PlotType'} @tab A character vector specifying the plot
528528
## type. @qcode{'pdf'} plots the probability density function (PDF). When
529529
## @var{pd} is fit to data, the PDF is superimposed on a histogram of the
530530
## data. @qcode{'cdf'} plots the cumulative density function (CDF). When
@@ -533,14 +533,14 @@ function disp (this)
533533
## and a CDF of the fitted probability distribution. This option is
534534
## available only when @var{pd} is fitted to data.
535535
##
536-
## @item @qcode{'Discrete'} @tab @tab A logical scalar to specify whether to
536+
## @item @qcode{'Discrete'} @tab A logical scalar to specify whether to
537537
## plot the PDF or CDF of a discrete distribution object as a line plot or a
538538
## stem plot, by specifying @qcode{false} or @qcode{true}, respectively. By
539539
## default, it is @qcode{true} for discrete distributions and @qcode{false}
540540
## for continuous distributions. When @var{pd} is a continuous distribution
541541
## object, option is ignored.
542542
##
543-
## @item @qcode{'Parent'} @tab @tab An axes graphics object for plot. If
543+
## @item @qcode{'Parent'} @tab An axes graphics object for plot. If
544544
## not specified, the @code{plot} function plots into the current axes or
545545
## creates a new axes object if one does not exist.
546546
## @end multitable

inst/dist_obj/BinomialDistribution.m

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -529,10 +529,10 @@ function disp (this)
529529
## @code{plot (@var{pd}, @var{Name}, @var{Value})} specifies additional
530530
## options with the @qcode{Name-Value} pair arguments listed below.
531531
##
532-
## @multitable @columnfractions 0.18 0.02 0.8
533-
## @headitem @tab @var{Name} @tab @var{Value}
532+
## @multitable @columnfractions 0.18 0.8
533+
## @headitem @var{Name} @tab @var{Value}
534534
##
535-
## @item @qcode{'PlotType'} @tab @tab A character vector specifying the plot
535+
## @item @qcode{'PlotType'} @tab A character vector specifying the plot
536536
## type. @qcode{'pdf'} plots the probability density function (PDF). When
537537
## @var{pd} is fit to data, the PDF is superimposed on a histogram of the
538538
## data. @qcode{'cdf'} plots the cumulative density function (CDF). When
@@ -541,14 +541,14 @@ function disp (this)
541541
## and a CDF of the fitted probability distribution. This option is
542542
## available only when @var{pd} is fitted to data.
543543
##
544-
## @item @qcode{'Discrete'} @tab @tab A logical scalar to specify whether to
544+
## @item @qcode{'Discrete'} @tab A logical scalar to specify whether to
545545
## plot the PDF or CDF of a discrete distribution object as a line plot or a
546546
## stem plot, by specifying @qcode{false} or @qcode{true}, respectively. By
547547
## default, it is @qcode{true} for discrete distributions and @qcode{false}
548548
## for continuous distributions. When @var{pd} is a continuous distribution
549549
## object, option is ignored.
550550
##
551-
## @item @qcode{'Parent'} @tab @tab An axes graphics object for plot. If
551+
## @item @qcode{'Parent'} @tab An axes graphics object for plot. If
552552
## not specified, the @code{plot} function plots into the current axes or
553553
## creates a new axes object if one does not exist.
554554
## @end multitable

inst/dist_obj/MultinomialDistribution.m

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -405,10 +405,10 @@ function disp (this)
405405
## @code{plot (@var{pd}, @var{Name}, @var{Value})} specifies additional
406406
## options with the @qcode{Name-Value} pair arguments listed below.
407407
##
408-
## @multitable @columnfractions 0.18 0.02 0.8
409-
## @headitem @tab @var{Name} @tab @var{Value}
408+
## @multitable @columnfractions 0.18 0.8
409+
## @headitem @var{Name} @tab @var{Value}
410410
##
411-
## @item @qcode{'PlotType'} @tab @tab A character vector specifying the plot
411+
## @item @qcode{'PlotType'} @tab A character vector specifying the plot
412412
## type. @qcode{'pdf'} plots the probability density function (PDF). When
413413
## @var{pd} is fit to data, the PDF is superimposed on a histogram of the
414414
## data. @qcode{'cdf'} plots the cumulative density function (CDF). When
@@ -417,14 +417,14 @@ function disp (this)
417417
## and a CDF of the fitted probability distribution. This option is
418418
## available only when @var{pd} is fitted to data.
419419
##
420-
## @item @qcode{'Discrete'} @tab @tab A logical scalar to specify whether to
420+
## @item @qcode{'Discrete'} @tab A logical scalar to specify whether to
421421
## plot the PDF or CDF of a discrete distribution object as a line plot or a
422422
## stem plot, by specifying @qcode{false} or @qcode{true}, respectively. By
423423
## default, it is @qcode{true} for discrete distributions and @qcode{false}
424424
## for continuous distributions. When @var{pd} is a continuous distribution
425425
## object, option is ignored.
426426
##
427-
## @item @qcode{'Parent'} @tab @tab An axes graphics object for plot. If
427+
## @item @qcode{'Parent'} @tab An axes graphics object for plot. If
428428
## not specified, the @code{plot} function plots into the current axes or
429429
## creates a new axes object if one does not exist.
430430
## @end multitable

inst/dist_obj/StableDistribution.m

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@
139139
##
140140
## Names of parameters
141141
##
142-
## A @math{4x1} cell array of character vectors with each element containing
142+
## A @math{4*1} cell array of character vectors with each element containing
143143
## the name of a distribution parameter. This property is read-only.
144144
##
145145
## @end deftp
@@ -150,7 +150,7 @@
150150
##
151151
## Description of parameters
152152
##
153-
## A @math{4x1} cell array of character vectors with each element containing
153+
## A @math{4*1} cell array of character vectors with each element containing
154154
## a short description of a distribution parameter. This property is
155155
## read-only.
156156
##
@@ -172,7 +172,7 @@
172172
##
173173
## Distribution parameter values
174174
##
175-
## A @math{4x1} numeric vector containing the values of the distribution
175+
## A @math{4*1} numeric vector containing the values of the distribution
176176
## parameters, matching the order in @qcode{ParameterNames}. This property
177177
## is read-only; use dot name assignment on the @qcode{alpha}, @qcode{beta},
178178
## @qcode{gam}, and @qcode{delta} properties.
@@ -185,7 +185,7 @@
185185
##
186186
## Covariance matrix of the parameter estimates
187187
##
188-
## A @math{4x4} numeric matrix containing the variance-covariance of the
188+
## A @math{4*4} numeric matrix containing the variance-covariance of the
189189
## distribution parameters. This property is read-only.
190190
##
191191
## @end deftp
@@ -196,7 +196,7 @@
196196
##
197197
## Confidence intervals for the parameter estimates
198198
##
199-
## A @math{2x4} numeric matrix containing the lower and upper boundaries of
199+
## A @math{2*4} numeric matrix containing the lower and upper boundaries of
200200
## the confidence interval for each parameter, when the distribution has been
201201
## fitted to data. This property is read-only.
202202
##
@@ -208,7 +208,7 @@
208208
##
209209
## Flags for fixed parameters
210210
##
211-
## A @math{4x1} logical vector specifying which parameters are held fixed
211+
## A @math{4*1} logical vector specifying which parameters are held fixed
212212
## rather than estimated. This property is read-only.
213213
##
214214
## @end deftp

inst/doc-cache

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9619,9 +9619,9 @@ mvksdensity
96199619
Multivariate kernel smoothing density estimate.
96209620

96219621
‘F = mvksdensity (X, PTS)’ computes a probability density estimate of the
9622-
sample in the NxD matrix X, evaluated at the points in the MxD matrix PTS.
9622+
sample in the N*D matrix X, evaluated at the points in the M*D matrix PTS.
96239623
Each row of X is a single D-dimensional observation, and each row of PTS is
9624-
a point at which to evaluate the estimate. The result F is an Mx1 vector,
9624+
a point at which to evaluate the estimate. The result F is an M*1 vector,
96259625
with one density value per row of PTS.
96269626

96279627
The density estimate uses a product kernel: the multivariate kernel is the
@@ -9634,7 +9634,7 @@ mvksdensity
96349634

96359635
----------------------------------------------------------------------------------
96369636
'Bandwidth' The kernel bandwidth, either a positive scalar applied to every
9637-
dimension or a 1xD vector of positive values, one per dimension.
9637+
dimension or a 1*D vector of positive values, one per dimension.
96389638
The default is a diagonal normal-reference (Silverman) rule
96399639
computed from X.
96409640

inst/mvksdensity.m

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,10 @@
2121
## Multivariate kernel smoothing density estimate.
2222
##
2323
## @code{@var{f} = mvksdensity (@var{x}, @var{pts})} computes a probability
24-
## density estimate of the sample in the @math{NxD} matrix @var{x}, evaluated at
25-
## the points in the @math{MxD} matrix @var{pts}. Each row of @var{x} is a
24+
## density estimate of the sample in the @math{N*D} matrix @var{x}, evaluated at
25+
## the points in the @math{M*D} matrix @var{pts}. Each row of @var{x} is a
2626
## single @math{D}-dimensional observation, and each row of @var{pts} is a point
27-
## at which to evaluate the estimate. The result @var{f} is an @math{Mx1}
27+
## at which to evaluate the estimate. The result @var{f} is an @math{M*1}
2828
## vector, with one density value per row of @var{pts}.
2929
##
3030
## The density estimate uses a product kernel: the multivariate kernel is the
@@ -37,7 +37,7 @@
3737
## @headitem @var{Name} @tab @var{Value}
3838
##
3939
## @item @qcode{'Bandwidth'} @tab The kernel bandwidth, either a positive scalar
40-
## applied to every dimension or a @math{1xD} vector of positive values, one per
40+
## applied to every dimension or a @math{1*D} vector of positive values, one per
4141
## dimension. The default is a diagonal normal-reference (Silverman) rule
4242
## computed from @var{x}.
4343
##

0 commit comments

Comments
 (0)