---
title: "Glossary"
output: rmarkdown::html_vignette
vignette: >
%\VignetteIndexEntry{Glossary}
%\VignetteEncoding{UTF-8}
%\VignetteEngine{knitr::rmarkdown}
editor_options:
markdown:
wrap: 72
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
```
- **Condition**: The term "condition" is used for IF and IFNOT parts
of steps (*IF conditions*, *IFNOT conditions*). See
`vignette("steplist")`.
- **CC**: Component cause. A *step type*. Component causes are *start
steps*, i.e., they have no *IF condition* but they might have an
*IFNOT condition*. Unlike *interventions*, they appear in *IF
conditions* of other *steps*. See `vignette("steplist")`.
- **DAG**: Directed acyclic graph. In maths, graphs are
networks consisting of nodes and edges. `Directed` means that edges
are arrows. `Acyclic` means that, when you follow the arrows, you
never get back to the same node. DAG is the form used for causal
graphs. (Nodes are variables. Edges are causal relations. Causal
relations are asymmetric =\> directed. Variables cannot cause
themselves =\> acyclic.)
- **DOES**: The second *segment* in the `WHAT DOES WHAT WHERE`
structure of *THEN statements*. Refers usually to a verb in a
sentence. See `vignette("steplist")`.
- **End step**: A *step type*. *Outcome definitions* consist of end
steps combined with AND/OR logic.
- **epicmodel**: Causal Modeling in Epidemiology
- **IF condition**: The condition that has to be fulfilled for a
*step* to occur. See `vignette("steplist")`.
- **IFNOT condition**: The condition that must **not** be fulfilled
for a step to occur. See `vignette("steplist")`.
- **ICC**: Incompatible component causes. If a pair of *component
causes* cannot be part of the same *sufficient cause*, they can be
defined as ICC. Sets of *component causes*, which include both, are
assumed to be invalid and are not checked during *SCC* model
creation. See `vignette("steplist")`.
- **Intervention**: A *step type*. Interventions are *start steps*,
i.e., they have no *IF condition* but they might have an *IFNOT
condition*. Unlike *component causes*, they do **not** appear in *IF
conditions* of other *steps* but only in *IFNOT conditions*. See
`vignette("steplist")`.
- **Module**: *Steps* can be grouped together into modules, which
might be informative for certain *SCC* models. See
`vignette("modules")`.
- **Minimal**: A *sufficient cause (SC)* is minimal, if there exists
no smaller SC. SC1 is smaller than SC2 if SC1 only contains
*component causes* that are also in SC2, but not all of them. See
`vignette("scc")`.
- **Object**: The third *segment* in the `WHAT DOES WHAT WHERE`
structure of *THEN statements*. It is usually a *WHAT* *segment*,
but also may be a *THEN statement* if a *DOES* *segment* with
`then_object_does == 1` is used. See `vignette("steplist")`.
- **Outcome definition**: It defines based on the occurrence of
certain *steps* that the outcome of interest has occurred. See
`?create_scc`.
- **Prevention**: The avoidance of (a set of) *component causes*.
- **SC**: Sufficient cause. A *minimal* set of *component causes*,
which fulfills the *outcome definition*. See `vignette("scc")`.
- **SCC**: Sufficient-component cause. The causal modeling framework
at the core of `epicmodel`. For an explanation of what "this thing
called SCC model" is to `epicmodel`, see `vignette("scc")`.
- **Scenario**: When creating *IF conditions* and *IFNOT conditions*,
*steps* within the same scenario are combined with AND, while the
scenarios themselves are combined with OR.
- **Segment**: *THEN statements* follow a `WHAT DOES WHAT WHERE`
structure. These elements, i.e., *WHAT*, *DOES*, and *WHERE*, are
called segments. See `vignette("steplist")`.
- **Start step**: A *step type*. They have no *IF condition* but they
might have an *IFNOT condition*. *Component causes* and
*interventions* are start steps. See `vignette("steplist")`.
- **Statement**: The term "statement" is used for THEN parts of steps
(*THEN statement*). See `vignette("steplist")`.
- **Step**: Steps are small parts of the complex mechanism that leads
to outcome occurrence. See `vignette("steplist")`.
- **Step types**: *Steps* can play different roles in *SCC* model
creation. Examples are *start steps*, *component causes*,
*interventions*, *end steps*, IFNOT steps, as well as non-starting
steps. IFNOT steps are *steps* with *IFNOT condition*. Non-starting
steps are *steps* with *IF condition*. See `vignette("steplist")`.
- **Steplist**: The steplist is the collection of all *steps* in a
pre-defined format. It is the only input for *SCC* model creation.
See `vignette("steplist")`.
- **Subject**: The first *WHAT* *segment* in the
`WHAT DOES WHAT WHERE` structure of *THEN statements*. See
`vignette("steplist")`.
- **THEN**: THEN statements are a part of *steps* and describe what
actually happens. The THEN statement happens if the *IF condition*
is fulfilled and if the *IFNOT condition* is not fulfilled. See
`vignette("steplist")`.
- **WHAT**: *Segments* of the *THEN statements*, which are used in
*subjects* and *objects* and represent people, things, concepts,
etc. See `vignette("steplist")`.
- **WHERE**: The last *segment* in the `WHAT DOES WHAT WHERE`
structure of *THEN statements*. Refers usually to a location. See
`vignette("steplist")`.