Skip to contents

This class inherits from GaussianEmpiricalBayesPP and implements the PDCCPP method.

Format

R6Class object.

Super classes

Model -> GaussianConjugate -> GaussianStaticBorrowing -> GaussianEmpiricalBayesPP -> GaussianPDCCPP

Public fields

null_space

Side of the null hypothesis space

method

Method name

Methods

Inherited methods


GaussianPDCCPP$new()

Initialize the GaussianPDCCPP object.

Usage

GaussianPDCCPP$new(prior, theta_0, null_space)

Arguments

prior

The prior object.

theta_0

The theta_0 value.

null_space

Null space

Returns

NULL Estimate the power parameter using the PDCCPP method.


GaussianPDCCPP$power_parameter_estimation()

Usage

GaussianPDCCPP$power_parameter_estimation(target_data)

Arguments

target_data

The target data.

source_treatment_effect_estimate

The source treatment effect estimate.

target_treatment_effect_estimate

The target treatment effect estimate.

Returns

The estimated power parameter.


GaussianPDCCPP$vectorised_power_parameter()

The power parameter for every replicate at once

The calibration depends on a replicate only through its target sampling variance, and it is a smooth function of it. Rather than search for it once per replicate, it is computed at 200 variances spaced evenly on the log scale across the replicates' range and interpolated linearly. Near the borrowing cut-off the power parameter is very sensitive to the calibration, so these few searches are run to a tolerance of 1e-9 rather than the configured one: the interpolated calibration is then closer to the exact one than a per-replicate search at the configured tolerance would be. Equation (9) is evaluated for every replicate, exactly as power_parameter_estimation() does.

Usage

GaussianPDCCPP$vectorised_power_parameter(target_data, samples)

Arguments

target_data

Target study data.

samples

Data frame of generated replicates.

Returns

A vector of power parameters, one per replicate.


GaussianPDCCPP$calibration_parameter()

The calibration parameter z_1-c/2 for one target sampling variance

Usage

GaussianPDCCPP$calibration_parameter(
  target_data_sampling_variance,
  target_sample_size_per_arm,
  source_treatment_effect_estimate,
  tolerance = self$parameters$tolerance
)

Arguments

target_data_sampling_variance

Target sampling variance, per patient.

target_sample_size_per_arm

Target sample size per arm.

source_treatment_effect_estimate

Source estimate, after hypothesis_space_transformation().

tolerance

Tolerance of the search; the configured one by default.

Returns

The calibration parameter, a positive number.


GaussianPDCCPP$power_parameter_from_calibration()

The power parameter given the calibration, equation (9) of Nikolakopoulos et al (2018)

Vectorised over its arguments, so it serves one replicate or all of them.

Usage

GaussianPDCCPP$power_parameter_from_calibration(
  target_treatment_effect_estimate,
  source_treatment_effect_estimate,
  target_data_sampling_variance,
  target_sample_size_per_arm,
  calibration_parameter
)

Arguments

target_treatment_effect_estimate

Target estimates, after hypothesis_space_transformation().

source_treatment_effect_estimate

Source estimate, after the same transformation.

target_data_sampling_variance

Target sampling variances, per patient.

target_sample_size_per_arm

Target sample size per arm.

calibration_parameter

Calibration parameters z_1-c/2.

Returns

The power parameters.


GaussianPDCCPP$clone()

The objects of this class are cloneable with this method.

Usage

GaussianPDCCPP$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.