File: summary.optimx.Rd

package info (click to toggle)
r-cran-optimx 2022-4.30%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 1,524 kB
  • sloc: sh: 21; makefile: 5
file content (60 lines) | stat: -rw-r--r-- 2,302 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
\name{summary.optimx}
\alias{summary.optimx}
\encoding{UTF-8}
\title{Summarize optimx object}
\concept{minimization}
\concept{maximization}
\description{
  Summarize an \code{"optimx"} object.
}
\usage{
  \method{summary}{optimx}(object, order = NULL, par.select = TRUE, ...) 

}
\arguments{
 \item{object}{Object returned by \code{optimx}.}
 \item{order}{A column name, character vector of columns names, R 
    expression in terms of column names or a list of R expressions in terms of
    column names.   \code{NULL}, the default, means no re-ordering.
    \code{rownames} can be used to 
    alphabetic ordering by method name.
    \code{NULL}, the default, causes
    it not to be reordered.  Note that if 
    \code{follow.on} is TRUE re-ordering likely makes no sense. 
    The result is ordered by the \code{order}
    specification, each specified column in ascending order (except for 
    \code{value} which is in descending order if the optimization problem is a 
    maximization problem).}
 \item{par.select}{a numeric, character or logical vector selecting
   those \code{par} values to display. For example, \code{par=1:5} means
   display only the first 5 parameters.  Recycled so \code{par.select=FALSE}
   selects no parameters.}
 \item{\dots}{Further arguments to be passed to the function. Currently not
used.}
}
\details{
If \code{order} is specified then the result is reordered by the specified
columns, each in ascending order (except possibly for the
\code{value} column which is re-ordered in descending order for
maximization problems).}
\value{
  \code{summary.optimx} returns \code{object} with the rows ordered according
to \code{order} and with those parameters selected by \code{par.select}.
}
\examples{
ans <- optimx(fn = function(x) sum(x*x), par = 1:2)

# order by method name.
summary(ans, order = rownames)

# order by objective value. Do not show parameter values.
summary(ans, order = value, par.select = FALSE)

# order by objective value and then number of function evaluations
# such that objectives that are the same to 3 decimals are 
# considered the same.  Show only first parameter.
summary(ans, order = list(round(value, 3), fevals), par.select = 1)
}
\keyword{nonlinear}
\keyword{optimize}