# ------------------------------------------------
# CITATION.cff file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# ------------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "NSCA" in publications use:'
type: software
license: GPL-3.0-or-later
title: 'NSCA: Necessary and Sufficient Condition Analysis'
version: 0.4.5
identifiers:
- type: doi
  value: 10.32614/CRAN.package.NSCA
abstract: 'Tests and quantifies bivariate statements in which a condition is both
  necessary and sufficient for an outcome. Necessity and sufficiency are estimated
  as two empty-space frontiers on diagonally opposite corners of the same scatter
  plot, using the ''NCA'' package of Dul (2016) <https://doi.org/10.1177/1094428115584005>
  for the necessity side and ''SCAtools'' for the sufficiency side. The two empty
  zones and the region between them tile the analytic scope, which yields the reported
  areas as one identity rather than as separate definitions: a weakest-component effect,
  a normalised geometric mean of the two components, the share of the scope the claims
  jointly rule out, and the data zone they still admit. The conjunction is decided
  by an intersection-union combination of the two directional permutation tests, optionally
  driven by a single shared permutation sequence so that a statistic of both components
  can also be tested. These are random-pairing screens rather than direct tests of
  a causal necessary-and-sufficient relation, no magnitude benchmarks are asserted
  for the joint indices, and a dual-threshold table separates outcome levels that
  are out of reach, admitted, or guaranteed. An ordinary least-squares line can be
  drawn alongside the two frontiers as a central-tendency reference; it is an average-effect
  summary and is never treated as a component of either claim.'
authors:
- family-names: Chan
  given-names: Young
  email: youngchanresearcher@gmail.com
preferred-citation:
  type: manual
  title: 'NSCA: Necessary and Sufficient Condition Analysis'
  authors:
  - family-names: Chan
    given-names: Young
    email: youngchanresearcher@gmail.com
  year: '2026'
  notes: R package version 0.4.5
repository: https://youngchanresearcher.r-universe.dev
repository-code: https://github.com/youngchanresearcher/NSCA
commit: 6e08781c5b8682443c64cb7010f56678badb2277
url: https://github.com/youngchanresearcher/NSCA
date-released: '2026-09-30'
contact:
- family-names: Chan
  given-names: Young
  email: youngchanresearcher@gmail.com
references:
- type: manual
  title: 'SCAtools: Direction-Aware Sufficiency Condition Analysis'
  authors:
  - family-names: Chan
    given-names: Young
  year: '2026'
  notes: R package
- type: article
  title: 'Necessary Condition Analysis (NCA): Logic and Methodology of ''Necessary
    but Not Sufficient'' Causality'
  authors:
  - family-names: Dul
    given-names: Jan
  journal: Organizational Research Methods
  year: '2016'
  volume: '19'
  issue: '1'
  doi: 10.1177/1094428115584005
  start: '10'
  end: '52'