Struct OverlapRefuter 

pub struct OverlapRefuter {
    pub eps: f64,
    pub min_ess_fraction: f64,
    pub glm_options: GlmOptions,
}

Overlap / positivity assessment.

No silent propensity rebuild: when problem.original.overlap_report is Some (the original estimate came from a propensity-based estimator), that report is reused verbatim. When it is None (the linear-adjustment path, which deliberately skips propensity via OverlapPolicy::ExplicitOverride), this refuter fits its own diagnostic-only logistic propensity model on the adjustment covariates — explicitly, and only to populate the diagnostics this check needs. That fit never feeds back into the original point estimate.

Fields

eps: f64

Minimum acceptable margin from the propensity boundary: pass requires propensities in [eps, 1 - eps].

min_ess_fraction: f64

Minimum acceptable fraction of effective sample size retained (ess / n).

glm_options: GlmOptions

GLM options used only for the diagnostic-only fit (linear-adjustment path).

Implementations

impl OverlapRefuter

pub fn new() -> Self

Defaults: eps = 0.05, min_ess_fraction = 0.5.

pub fn refute( &self, problem: &RefutationProblem<'_>, ) -> Result<RefutationReport, ValidationError>

Run the overlap / positivity refuter.

Complete separation / non-converged diagnostic GLM fits are treated as overlap failures (extreme propensities), not as hard errors.

Errors

Data failures while building a diagnostic-only propensity fit.

pub fn refute_with_propensity( &self, problem: &RefutationProblem<'_>, propensity: &mut PropensityWorkspace, ) -> Result<RefutationReport, ValidationError>

Like Self::refute, reusing a warmed propensity workspace for diagnostic fits.

Errors

Data failures while building a diagnostic-only propensity fit.

Trait Implementations

impl Clone for OverlapRefuter

fn clone(&self) -> OverlapRefuter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OverlapRefuter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OverlapRefuter

fn default() -> Self

Returns the “default value” for a type.

impl<'a> Validator<RefutationProblem<'a>> for OverlapRefuter

type Prepared = PreparedRefutation<'a>

Prepared artifact produced by Self::prepare.

type Report = RefutationReport

Report produced by Self::validate.

fn prepare( &self, artifact: &RefutationProblem<'a>, _ctx: &ExecutionContext, ) -> Result<Self::Prepared, ValidationError>

Compile artifact into a reusable prepared form.

fn validate( &self, prepared: &mut Self::Prepared, _workspace: &mut EstimationWorkspace, _ctx: &ExecutionContext, ) -> Result<Self::Report, ValidationError>

Run the check on a prepared artifact.