equivalence: Equivalence theorem for discrimination design

In PingYangChen/DiscrimOD: DiscrimOD: Finding Optimal Discrimination Designs by Hybridizing Particle Swarm and L-BFGS Algorithms

Equivalence theorem for discrimination design

Description

Computes the values of directional derivative function on an user-defined grid and returns its maximal value.

Computes the values of directional derivative function on an user-defined grid and returns its maximal value.

Usage

equivalence(
  DESIGN = NULL,
  PSO_RESULT = NULL,
  ngrid = 100,
  IFPLOT = FALSE,
  MODEL_INFO,
  DISTANCE,
  dsLower,
  dsUpper,
  crit_type = "pair_fixed_true",
  MaxMinStdVals = NULL,
  PSO_INFO = NULL,
  LBFGS_INFO = NULL,
  ALPHA_PSO_INFO = NULL,
  environment,
  ...
)

equivalence(
  DESIGN = NULL,
  PSO_RESULT = NULL,
  ngrid = 100,
  IFPLOT = FALSE,
  MODEL_INFO,
  DISTANCE,
  dsLower,
  dsUpper,
  crit_type = "pair_fixed_true",
  MaxMinStdVals = NULL,
  PSO_INFO = NULL,
  LBFGS_INFO = NULL,
  ALPHA_PSO_INFO = NULL,
  environment,
  ...
)

Arguments

PSO_RESULT	list.
ngrid	integer. The default is 100.
IFPLOT	logical.
MODEL_INFO	list of information of competing models. For details, run emptyModelList() and see the instruction below.
DISTANCE	function.
dsLower	vector. The finite lower bounds of the design space. Its length should be equal to the dimension of design space.
dsUpper	vector. The finite upper bounds of the design space. Its length should be equal to the dimension of design space.
crit_type	string. The name of the case of the discrimination design problem. The default is 'pair_fixed_true'.
MaxMinStdVals	vector. The values of demoninators in the design efficiency calculation for finding max-min discrimination design.
PSO_INFO	list. PSO and BFGS options.
DESIGN1	matrix.

Value

An List.

• Grid_1 a vector of grid points on the design space. For 2-D case, this vector is the grid of the first dimension.

• Grid_2 a vector of grid points on the second dimension of the 2-D design space. For 1_d case, this output can be ignored.

• DirDeriv a vector (1-D case) or a matrix (2-D case) of the directional derivative function values on the grid points.

• MAX_DD the maximal value of the directional derivative function in DirDeriv.

• alpha a vector of weights of efficiency values that satisfies the equivalence theorem for max-min optimal discrimination design.

An List.

• Grid_1 a vector of grid points on the design space. For 2-D case, this vector is the grid of the first dimension.

• Grid_2 a vector of grid points on the second dimension of the 2-D design space. For 1_d case, this output can be ignored.

• DirDeriv a vector (1-D case) or a matrix (2-D case) of the directional derivative function values on the grid points.

• MAX_DD the maximal value of the directional derivative function in DirDeriv.

• alpha a vector of weights of efficiency values that satisfies the equivalence theorem for max-min optimal discrimination design.

PingYangChen/DiscrimOD documentation built on June 10, 2025, 11:32 p.m.