Necessary Condition Analysis
Overview
Performs a Necessary Condition Analysis (NCA). (Dul, J. 2016. Necessary Condition Analysis (NCA). ''Logic and Methodology of 'Necessary but not Sufficient' causality." Organizational Research Methods 19(1), 10-52) doi:10.1177/1094428115584005. NCA identifies necessary (but not sufficient) conditions in datasets, where x causes (e.g. precedes) y. Instead of drawing a regression line ''through the middle of the data'' in an xy-plot, NCA draws the ceiling line. The ceiling line y = f(x) separates the area with observations from the area without observations. (Nearly) all observations are below the ceiling line: y <= f(x). The empty zone is in the upper left hand corner of the xy-plot (with the convention that the x-axis is ''horizontal'' and the y-axis is ''vertical'' and that values increase ''upwards'' and ''to the right''). The ceiling line is a (piecewise) linear non-decreasing line: a linear step function or a straight line. It indicates which level of x (e.g., an effort, a characteristic) is necessary but not sufficient for a (desired or undesired) level of y (e.g., good performance or disease). A quick start guide for using this package can be found here: https://repub.eur.nl/pub/78323/ or https://papers.ssrn.com/sol3/papers.cfm?abstract_id=2624981.
- nca_output: Fix bug when using corner with multiple independent variables
- nca_difference: Fixate seed for each permuation test
- nca_difference: Move to common_scope instead of 2 independent scopes
- nca_difference: Fix bug: environment variables on Windows
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
Show 2 earlier changesHide 2 earlier changes
- ERROR12 OK, 1 ERROR2026-06-08
- OK14 OK2026-03-10
Documentation
- Help pages
- 19includes a package overview page
- Examples that run
- 91%10 run in a plain check · 1 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 63%
- Documented parameters
- 100%
- Return-value docs
- 13%
- Help pages citing references
- 5%
Downloads
Dependencies
Installing NCA adds 81 packages (45 with compiled code, 76 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 5.0.2Latest
- 5.0.12026-04-28 · diff ↗
- RR 4.6.0 released · 2026-04-24
- 5.0.0
- 4.0.52025-12-21 · diff ↗
- 4.0.42025-11-14 · diff ↗
- 4.0.32025-10-14 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 4.0.22024-11-09 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 4.0.12024-02-23 · diff ↗
- 4.0.0
- 3.3.32023-09-05 · diff ↗
- 3.3.22023-06-27 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 3.3.12023-02-10 · diff ↗
Show 20 earlier eventsHide 20 earlier events
- 3.3.02023-02-06 · diff ↗
- 3.2.12022-09-15 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 3.2.0
- RR 4.1.0 released · 2021-05-18
- 3.1.12021-05-03 · diff ↗
- 3.1.02021-03-02 · diff ↗
- 3.0.32020-06-11 · diff ↗
- RR 4.0.0 released · 2020-04-24
- 3.0.2
- RR 3.6.0 released · 2019-04-26
- 3.0.12018-08-21 · diff ↗
- 3.02018-08-01 · diff ↗
- RR 3.5.0 released · 2018-04-23
- RR 3.4.0 released · 2017-04-21
- 2.02016-05-18 · diff ↗ ·
removed 1 export
pattern:^[^p\\_]added 8 exports
nca, nca_analysis, nca_output, ceilings, line.colors, line.types, line.width, point.type - RR 3.3.0 released · 2016-05-03
- 1.12015-10-10 · diff ↗
- 1.02015-07-02
- RR 3.2.0 released · 2015-04-16
Package metadata
- First published
- 2015-07-02
- Total releases
- 24 / 11 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 3.5.0
- Bundled data
- 1.2 KB / 3 files
- Download size
- 71 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("NCA")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-17, which the citation names so these numbers can be found later. More on citing and the projects behind them.