New Upstream Snapshot - r-cran-estimability
Ready changes
Summary
Merged new upstream version: 1.4.1+git20220804.1.ac57dfd (was: 1.4.1).
Resulting package
Built on 2022-10-15T18:45 (took 5m56s)
The resulting binary packages can be installed (if you have the apt repository enabled) by running one of:
apt install -t fresh-snapshots r-cran-estimability
Lintian Result
Diff
diff --git a/DESCRIPTION b/DESCRIPTION
index f624f1d..0ce39c1 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -12,10 +12,8 @@ Description: Provides tools for determining estimability of linear functions
many linear-models textbooks including Chapter 3 of Monahan, JF (2008),
"A Primer on Linear Models", Chapman and Hall (ISBN 978-1-4200-6201-4).
ByteCompile: yes
-License: GPL (>= 3)
+License: GPL(>=3)
NeedsCompilation: no
-Packaged: 2022-08-04 17:40:33 UTC; rlenth
+Packaged: 2022-10-15 18:41:31 UTC; root
Author: Russell Lenth [aut, cre, cph]
Maintainer: Russell Lenth <russell-lenth@uiowa.edu>
-Repository: CRAN
-Date/Publication: 2022-08-05 15:00:13 UTC
diff --git a/MD5 b/MD5
deleted file mode 100644
index 68dbf7f..0000000
--- a/MD5
+++ /dev/null
@@ -1,11 +0,0 @@
-d3a486e8c5d3be43ba671cff010dc4b0 *DESCRIPTION
-f3edaa682f331f0f437f5cd973a80255 *NAMESPACE
-584c7aa35dc12a50863e410d1a6c9407 *R/epredict.lm.R
-db937ec225a2778864ac557a0bd09511 *R/estble-subsp.R
-9af8a357295aee4c10572c6d2e7c4630 *R/estimability.R
-c26e3592530d871ea5e4b3652a99d838 *README.md
-f3285d85bd1243c2a65511f28b4ca884 *inst/NEWS
-a80594f2fc3d419746baa553f5de57df *man/epredict.lm.Rd
-76344948cf755a7caf150250283fedd2 *man/estble-subspace.Rd
-aae9f4ed984b658a3c55772610998377 *man/estimability-package.Rd
-7315561c67d6467d5951b1122c913a58 *man/nonest.basis.Rd
diff --git a/R/estble-subsp.R b/R/estble-subsp.R
index f3e8609..a6ad475 100644
--- a/R/estble-subsp.R
+++ b/R/estble-subsp.R
@@ -1,40 +1,40 @@
-##############################################################################
-# Copyright (c) 2015-2018 Russell V. Lenth #
-# #
-# This file is part of the estimability package for R (*estimability*) #
-# #
-# *estimability* is free software: you can redistribute it and/or modify #
-# it under the terms of the GNU General Public License as published by #
-# the Free Software Foundation, either version 2 of the License, or #
-# (at your option) any later version. #
-# #
-# *estimability* is distributed in the hope that it will be useful, #
-# but WITHOUT ANY WARRANTY; without even the implied warranty of #
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
-# GNU General Public License for more details. #
-# #
-# A copy of the GNU General Public License is available at #
-# <https://www.r-project.org/Licenses/> #
-##############################################################################
-
-# Obtain an estimable subspace from the rows of a matrix L
-# i.e., B %*% L such that B %*% L %*% N = 0 (where N = nbasis)
-# Thus, (LN)'B' = 0, i.e., B' is in null space of LN'
-# We are tooled-up to find that!
-#
-# The function returns BL, with B as an attribute
-estble.subspace = function(L, nbasis, tol = 1e-8) {
- if (all(apply(L, 1, is.estble, nbasis, tol)))
- B = diag(nrow(L))
- else {
- LN = L %*% nbasis
- LN[abs(LN) <= tol] = 0 # don't be jerked around by small values
- B = t(nonest.basis(t(LN)))
- }
- if (is.na(B[1])) # nothing is estimable
- result = matrix(0, nrow = 0, ncol = ncol(L))
- else
- result = B %*% L
- attr(result, "B") = B
- result
+##############################################################################
+# Copyright (c) 2015-2018 Russell V. Lenth #
+# #
+# This file is part of the estimability package for R (*estimability*) #
+# #
+# *estimability* is free software: you can redistribute it and/or modify #
+# it under the terms of the GNU General Public License as published by #
+# the Free Software Foundation, either version 2 of the License, or #
+# (at your option) any later version. #
+# #
+# *estimability* is distributed in the hope that it will be useful, #
+# but WITHOUT ANY WARRANTY; without even the implied warranty of #
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
+# GNU General Public License for more details. #
+# #
+# A copy of the GNU General Public License is available at #
+# <https://www.r-project.org/Licenses/> #
+##############################################################################
+
+# Obtain an estimable subspace from the rows of a matrix L
+# i.e., B %*% L such that B %*% L %*% N = 0 (where N = nbasis)
+# Thus, (LN)'B' = 0, i.e., B' is in null space of LN'
+# We are tooled-up to find that!
+#
+# The function returns BL, with B as an attribute
+estble.subspace = function(L, nbasis, tol = 1e-8) {
+ if (all(apply(L, 1, is.estble, nbasis, tol)))
+ B = diag(nrow(L))
+ else {
+ LN = L %*% nbasis
+ LN[abs(LN) <= tol] = 0 # don't be jerked around by small values
+ B = t(nonest.basis(t(LN)))
+ }
+ if (is.na(B[1])) # nothing is estimable
+ result = matrix(0, nrow = 0, ncol = ncol(L))
+ else
+ result = B %*% L
+ attr(result, "B") = B
+ result
}
\ No newline at end of file
diff --git a/README.md b/README.md
index 8414906..f4ecb8a 100644
--- a/README.md
+++ b/README.md
@@ -1,43 +1,43 @@
----
-title: "estimability"
-output: html_document
-date: '2022-07-03'
----
-
-R package **estimability**: Support for determining estimability of linear functions
-====
-
-[![Build Status](https://travis-ci.org/rvlenth/estimability.svg?branch=master)](https://travis-ci.org/rvlenth/estimability/)
-[![cran version](https://www.r-pkg.org/badges/version/estimability)](https://cran.r-project.org/package=estimability)
-[![downloads](https://cranlogs.r-pkg.org/badges/estimability)](https://cranlogs.r-pkg.org/badges/estimability)
-[![total downloads](https://cranlogs.r-pkg.org/badges/grand-total/estimability)](https://cranlogs.r-pkg.org/badges/grand-total/estimability)
-[![Research software impact](http://depsy.org/api/package/cran/estimability/badge.svg)](http://depsy.org/package/r/estimability/)
-
-
-## Features
- * A `nonest.basis()` function is provided that determines a basis for the null
- space of a matrix. This may be used in conjunction with `is.estble()` to
- determine the estimability (within a tolerance) of a given linear function of
- the regression coefficients in a linear model.
- * A set of `epredict()` methods are provided for `lm`, `glm`, and `mlm` objects.
- These work just like `predict()`, except an `NA` is returned for any cases that
- are not estimable. This is a useful alternative to the generic warning that
- "predictions from rank-deficient models are unreliable."
- * A function `estble.subspace()` that projects a set of linear functions onto an
- estimable subspace (possibly of smaller dimension). This can be useful in
- creating a set of estimable contrasts for joint testing.
- * Package developers may wish to import this package and incorporate
- estimability checks for their `predict` methods.
-
-## Installation
- * To install latest version from CRAN, run
-```
-install.packages("estimability")
-```
-Release notes for the latest CRAN version are found at [https://cran.r-project.org/package=estimability/NEWS](https://cran.r-project.org/package=estimability/NEWS) -- or do `news(package = "estimability")` for notes on the version you have installed.
-
-* To install the latest development version from Github, have the newest **devtools** package installed, then run
-```
-devtools::install_github("rvlenth/estimability", dependencies = TRUE)
-```
-For latest release notes on this development version, see the [NEWS file](https://github.com/rvlenth/estimability/blob/master/inst/NEWS)
+---
+title: "estimability"
+output: html_document
+date: '2022-07-03'
+---
+
+R package **estimability**: Support for determining estimability of linear functions
+====
+
+[![Build Status](https://travis-ci.org/rvlenth/estimability.svg?branch=master)](https://travis-ci.org/rvlenth/estimability/)
+[![cran version](https://www.r-pkg.org/badges/version/estimability)](https://cran.r-project.org/package=estimability)
+[![downloads](https://cranlogs.r-pkg.org/badges/estimability)](https://cranlogs.r-pkg.org/badges/estimability)
+[![total downloads](https://cranlogs.r-pkg.org/badges/grand-total/estimability)](https://cranlogs.r-pkg.org/badges/grand-total/estimability)
+[![Research software impact](http://depsy.org/api/package/cran/estimability/badge.svg)](http://depsy.org/package/r/estimability/)
+
+
+## Features
+ * A `nonest.basis()` function is provided that determines a basis for the null
+ space of a matrix. This may be used in conjunction with `is.estble()` to
+ determine the estimability (within a tolerance) of a given linear function of
+ the regression coefficients in a linear model.
+ * A set of `epredict()` methods are provided for `lm`, `glm`, and `mlm` objects.
+ These work just like `predict()`, except an `NA` is returned for any cases that
+ are not estimable. This is a useful alternative to the generic warning that
+ "predictions from rank-deficient models are unreliable."
+ * A function `estble.subspace()` that projects a set of linear functions onto an
+ estimable subspace (possibly of smaller dimension). This can be useful in
+ creating a set of estimable contrasts for joint testing.
+ * Package developers may wish to import this package and incorporate
+ estimability checks for their `predict` methods.
+
+## Installation
+ * To install latest version from CRAN, run
+```
+install.packages("estimability")
+```
+Release notes for the latest CRAN version are found at [https://cran.r-project.org/package=estimability/NEWS](https://cran.r-project.org/package=estimability/NEWS) -- or do `news(package = "estimability")` for notes on the version you have installed.
+
+* To install the latest development version from Github, have the newest **devtools** package installed, then run
+```
+devtools::install_github("rvlenth/estimability", dependencies = TRUE)
+```
+For latest release notes on this development version, see the [NEWS file](https://github.com/rvlenth/estimability/blob/master/inst/NEWS)
diff --git a/debian/changelog b/debian/changelog
index 36c3011..20288f1 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+r-cran-estimability (1.4.1+git20220804.1.ac57dfd-1) UNRELEASED; urgency=low
+
+ * New upstream snapshot.
+
+ -- Debian Janitor <janitor@jelmer.uk> Sat, 15 Oct 2022 18:41:34 -0000
+
r-cran-estimability (1.4.1-1) unstable; urgency=medium
* Team upload.
diff --git a/man/estble-subspace.Rd b/man/estble-subspace.Rd
index 1c6c6ee..ac756e0 100644
--- a/man/estble-subspace.Rd
+++ b/man/estble-subspace.Rd
@@ -1,75 +1,75 @@
-% Copyright (c) 2015-2018 Russell V. Lenth
-
-\name{estble.subspace}
-\alias{estble.subspace}
-
-\title{Find an estimable subspace}
-
-\description{
- Determine a transformation \code{B} of the rows of a matrix \code{L}
- such that \code{B \%*\% L} is estimable.
- A practical example is in jointly testing a set of contrasts \code{L}
- in a linear model, and we need to restrict to the subspace spanned by
- the rows of \code{L} that are estimable.
-}
-
-\usage{
-estble.subspace (L, nbasis, tol = 1e-8)
-}
-
-\arguments{
- \item{L}{A matrix of dimensions \emph{k} by \emph{p}}
- \item{nbasis}{A \emph{k} by \emph{b} matrix whose columns form a
- basis for non-estimable linear functions -- such as is returned
- by \code{\link{nonest.basis}}}
- \item{tol}{Numeric tolerance for assessing nonestimability. See
- \code{\link{is.estble}}.}
-}
-
-\details{
- We require \code{B} such that all the rows of \code{M = B \%*\% L}
- are estimable, i.e. orthogonal to the columns of \code{nbasis}.
- Thus, we need \code{B \%*\% L \%*\% nbasis} to be zero, or equivalently,
- \code{t(B)} must be in the null space of \code{t(L \%*\% nbasis)}.
- This can be found using \code{\link{nonest.basis}}.
-}
-
-
-\value{
- An \emph{r} by \emph{p} matrix \code{M = B \%*\% L}
- whose rows are all orthogonal to the columns of
- \code{nbasis}. The matrix \code{B} is attached as \code{attr(M, "B")}.
- Note that if any rows of \code{L} were non-estimable, then \emph{r}
- will be less than \emph{k}. In fact, if there are no estimable functions
- in the row space of \code{L}, then \emph{r} = 0.
-}
-
-
-\author{
-Russell V. Lenth <russell-lenth@uiowa.edu>
-}
-
-
-\examples{
-### Find a set of estimable interaction contrasts for a 3 x 4 design
-### with two empty cells.
-des <- expand.grid(A = factor(1:3), B = factor(1:4))
-des <- des[-c(5, 12), ] # cells (2,2) and (3,4) are empty
-
-X <- model.matrix(~ A * B, data = des)
-N <- nonest.basis(X)
-
-L <- cbind(matrix(0, nrow = 6, ncol = 6), diag(6))
-# i.e., give nonzero weight only to interaction effects
-
-estble.subspace(L, N)
-
-# Tougher demo: create a variation where all rows of L are non-estimable
-LL <- matrix(rnorm(36), ncol = 6) \%*\% L
-estble.subspace(LL, N)
-}
-
-% Add one or more standard keywords, see file 'KEYWORDS' in the
-% R documentation directory.
-\keyword{ models }
-\keyword{ regression }
+% Copyright (c) 2015-2018 Russell V. Lenth
+
+\name{estble.subspace}
+\alias{estble.subspace}
+
+\title{Find an estimable subspace}
+
+\description{
+ Determine a transformation \code{B} of the rows of a matrix \code{L}
+ such that \code{B \%*\% L} is estimable.
+ A practical example is in jointly testing a set of contrasts \code{L}
+ in a linear model, and we need to restrict to the subspace spanned by
+ the rows of \code{L} that are estimable.
+}
+
+\usage{
+estble.subspace (L, nbasis, tol = 1e-8)
+}
+
+\arguments{
+ \item{L}{A matrix of dimensions \emph{k} by \emph{p}}
+ \item{nbasis}{A \emph{k} by \emph{b} matrix whose columns form a
+ basis for non-estimable linear functions -- such as is returned
+ by \code{\link{nonest.basis}}}
+ \item{tol}{Numeric tolerance for assessing nonestimability. See
+ \code{\link{is.estble}}.}
+}
+
+\details{
+ We require \code{B} such that all the rows of \code{M = B \%*\% L}
+ are estimable, i.e. orthogonal to the columns of \code{nbasis}.
+ Thus, we need \code{B \%*\% L \%*\% nbasis} to be zero, or equivalently,
+ \code{t(B)} must be in the null space of \code{t(L \%*\% nbasis)}.
+ This can be found using \code{\link{nonest.basis}}.
+}
+
+
+\value{
+ An \emph{r} by \emph{p} matrix \code{M = B \%*\% L}
+ whose rows are all orthogonal to the columns of
+ \code{nbasis}. The matrix \code{B} is attached as \code{attr(M, "B")}.
+ Note that if any rows of \code{L} were non-estimable, then \emph{r}
+ will be less than \emph{k}. In fact, if there are no estimable functions
+ in the row space of \code{L}, then \emph{r} = 0.
+}
+
+
+\author{
+Russell V. Lenth <russell-lenth@uiowa.edu>
+}
+
+
+\examples{
+### Find a set of estimable interaction contrasts for a 3 x 4 design
+### with two empty cells.
+des <- expand.grid(A = factor(1:3), B = factor(1:4))
+des <- des[-c(5, 12), ] # cells (2,2) and (3,4) are empty
+
+X <- model.matrix(~ A * B, data = des)
+N <- nonest.basis(X)
+
+L <- cbind(matrix(0, nrow = 6, ncol = 6), diag(6))
+# i.e., give nonzero weight only to interaction effects
+
+estble.subspace(L, N)
+
+# Tougher demo: create a variation where all rows of L are non-estimable
+LL <- matrix(rnorm(36), ncol = 6) \%*\% L
+estble.subspace(LL, N)
+}
+
+% Add one or more standard keywords, see file 'KEYWORDS' in the
+% R documentation directory.
+\keyword{ models }
+\keyword{ regression }
Debdiff
File lists identical (after any substitutions)
No differences were encountered in the control files