Skip to content

Commit

Permalink
updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
samuel-rosa committed Jul 31, 2015
1 parent b653032 commit 5d8a8b7
Show file tree
Hide file tree
Showing 9 changed files with 36 additions and 36 deletions.
4 changes: 2 additions & 2 deletions man-roxygen/spSANN_doc.R
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Template documentation for spatial simulated annealing
################################################################################
#' @param iterations Integer. The maximum number of iterations that should be
#' used for the optimization. Defaults to \code{iterations = 100}. IS 100 A GOOD NUMBER? I WOULD THINK IT IS TOO LITTLE.
#' used for the optimization. Defaults to \code{iterations = 100}.
#'
#' @param acceptance List with two named sub-arguments: \code{initial} --
#' numeric value between 0 and 1 defining the initial acceptance probability,
Expand All @@ -21,7 +21,7 @@
#' are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.
#'
#' @param boundary SpatialPolygon. The boundary of the spatial domain.
#' If missing, it is calculated as the bounding box of \code{candi} using \code{\link[sp]{bbox}}.
#' If missing, it is estimated from \code{candi}.
#'
#' @param progress Logical for printing a progress bar. Defaults to
#' \code{progress = TRUE}.
Expand Down
16 changes: 8 additions & 8 deletions man/optimACDC.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -74,7 +74,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down Expand Up @@ -252,9 +252,9 @@ The \emph{correlation} between two numeric covariates is measured using the
Pearson's r, a descriptive statistic that ranges from $-1$ to $+1$.
This statistic is also known as the linear correlation coefficient.
When the set of covariates includes factor covariates, any numeric covariate
is transformed into a factor covariate. The factor levels are defined
using the marginal sampling strata created using one of the two methods
When the set of covariates includes factor covariates, all numeric covariates
are transformed into factor covariates. The factor levels are defined
using the marginal sampling strata created from one of the two methods
available (equal-area or equal-range strata).
The \emph{association} between two factor covariates is measured using the
Expand All @@ -270,7 +270,7 @@ of association (weak or strong).

Reproducing the marginal distribution of the numeric covariates depends upon
the definition of marginal sampling strata. These marginal sampling strata
are also used to define the factor levels of any numeric covariate when they
are also used to define the factor levels of all numeric covariates that
are passed together with factor covariates.

Two types of marginal sampling strata can be used. \emph{Equal-area}
Expand All @@ -285,7 +285,7 @@ relatively high frequency in the population of covariate values. The number
of repeated break points increases with the number of marginal sampling
strata. Only unique break points are used to create marginal sampling strata.

\emph{Equal-range} sampling strata are defined breaking the range of
\emph{Equal-range} sampling strata are defined by breaking the range of
covariate values into pieces of equal size. This method usually creates
break points that do not occur in the population of existing covariate
values. Such break points are replaced by the nearest existing covariate
Expand All @@ -302,7 +302,7 @@ some of them with different area/size. Because the goal is to have a sample
that reproduces the marginal distribution of the covariate, each marginal
sampling strata will have a different number of sample points. The wanted
distribution of the number of sample points per marginal strata is estimated
empirically computing the proportion of points of the population of existing
empirically as the proportion of points in the population of existing
covariate values that fall in each marginal sampling strata.
}
\examples{
Expand Down
10 changes: 5 additions & 5 deletions man/optimCORR.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -71,7 +71,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down Expand Up @@ -240,9 +240,9 @@ The \emph{correlation} between two numeric covariates is measured using the
Pearson's r, a descriptive statistic that ranges from $-1$ to $+1$.
This statistic is also known as the linear correlation coefficient.
When the set of covariates includes factor covariates, any numeric covariate
is transformed into a factor covariate. The factor levels are defined
using the marginal sampling strata created using one of the two methods
When the set of covariates includes factor covariates, all numeric covariates
are transformed into factor covariates. The factor levels are defined
using the marginal sampling strata created from one of the two methods
available (equal-area or equal-range strata).
The \emph{association} between two factor covariates is measured using the
Expand Down
10 changes: 5 additions & 5 deletions man/optimDIST.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -71,7 +71,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down Expand Up @@ -238,7 +238,7 @@ function B.

Reproducing the marginal distribution of the numeric covariates depends upon
the definition of marginal sampling strata. These marginal sampling strata
are also used to define the factor levels of any numeric covariate when they
are also used to define the factor levels of all numeric covariates that
are passed together with factor covariates.

Two types of marginal sampling strata can be used. \emph{Equal-area}
Expand All @@ -253,7 +253,7 @@ relatively high frequency in the population of covariate values. The number
of repeated break points increases with the number of marginal sampling
strata. Only unique break points are used to create marginal sampling strata.

\emph{Equal-range} sampling strata are defined breaking the range of
\emph{Equal-range} sampling strata are defined by breaking the range of
covariate values into pieces of equal size. This method usually creates
break points that do not occur in the population of existing covariate
values. Such break points are replaced by the nearest existing covariate
Expand All @@ -270,7 +270,7 @@ some of them with different area/size. Because the goal is to have a sample
that reproduces the marginal distribution of the covariate, each marginal
sampling strata will have a different number of sample points. The wanted
distribution of the number of sample points per marginal strata is estimated
empirically computing the proportion of points of the population of existing
empirically as the proportion of points in the population of existing
covariate values that fall in each marginal sampling strata.
}
\examples{
Expand Down
4 changes: 2 additions & 2 deletions man/optimMKV.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -79,7 +79,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down
4 changes: 2 additions & 2 deletions man/optimMSSD.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -59,7 +59,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down
4 changes: 2 additions & 2 deletions man/optimPPL.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -97,7 +97,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down
16 changes: 8 additions & 8 deletions man/optimSPAN.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -108,7 +108,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down Expand Up @@ -280,9 +280,9 @@ The \emph{correlation} between two numeric covariates is measured using the
Pearson's r, a descriptive statistic that ranges from $-1$ to $+1$.
This statistic is also known as the linear correlation coefficient.
When the set of covariates includes factor covariates, any numeric covariate
is transformed into a factor covariate. The factor levels are defined
using the marginal sampling strata created using one of the two methods
When the set of covariates includes factor covariates, all numeric covariates
are transformed into factor covariates. The factor levels are defined
using the marginal sampling strata created from one of the two methods
available (equal-area or equal-range strata).
The \emph{association} between two factor covariates is measured using the
Expand All @@ -298,7 +298,7 @@ of association (weak or strong).

Reproducing the marginal distribution of the numeric covariates depends upon
the definition of marginal sampling strata. These marginal sampling strata
are also used to define the factor levels of any numeric covariate when they
are also used to define the factor levels of all numeric covariates that
are passed together with factor covariates.

Two types of marginal sampling strata can be used. \emph{Equal-area}
Expand All @@ -313,7 +313,7 @@ relatively high frequency in the population of covariate values. The number
of repeated break points increases with the number of marginal sampling
strata. Only unique break points are used to create marginal sampling strata.

\emph{Equal-range} sampling strata are defined breaking the range of
\emph{Equal-range} sampling strata are defined by breaking the range of
covariate values into pieces of equal size. This method usually creates
break points that do not occur in the population of existing covariate
values. Such break points are replaced by the nearest existing covariate
Expand All @@ -330,7 +330,7 @@ some of them with different area/size. Because the goal is to have a sample
that reproduces the marginal distribution of the covariate, each marginal
sampling strata will have a different number of sample points. The wanted
distribution of the number of sample points per marginal strata is estimated
empirically computing the proportion of points of the population of existing
empirically as the proportion of points in the population of existing
covariate values that fall in each marginal sampling strata.
}

Expand Down
4 changes: 2 additions & 2 deletions man/optimUSER.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ the projected x- and y-coordinates. If missing, they are estimated from
\item{acceptance}{List with two named sub-arguments: \code{initial} --
numeric value between 0 and 1 defining the initial acceptance probability,
and \code{cooling} -- a numeric value defining the exponential factor by
witch the acceptance probability decreases at each iteration. Defaults to
which the acceptance probability decreases at each iteration. Defaults to
\code{acceptance = list(initial = 0.99, cooling = iterations / 10)}.}

\item{stopping}{List with one named sub-argument: \code{max.count} --
Expand All @@ -63,7 +63,7 @@ are updated at each 10 iterations. Defaults to \code{plotit = FALSE}.}

\item{track}{Logical value. Should the evolution of the energy state and
acceptance probability be recorded and returned with the result? If
\code{track = FALSE} (the default), only the starting and ending enery state
\code{track = FALSE} (the default), only the starting and ending energy state
values are returned with the result.}

\item{boundary}{SpatialPolygon. The boundary of the spatial domain.
Expand Down

0 comments on commit 5d8a8b7

Please sign in to comment.