Skip to content

Commit

Permalink
Add fixed list of categories for TIAB screening
Browse files Browse the repository at this point in the history
  • Loading branch information
mellelieuwes committed Dec 20, 2024
1 parent 561d747 commit 18aa519
Show file tree
Hide file tree
Showing 5 changed files with 180 additions and 0 deletions.
28 changes: 28 additions & 0 deletions core/priv/gettext/de/LC_MESSAGES/eyra-enums.po
Original file line number Diff line number Diff line change
Expand Up @@ -474,3 +474,31 @@ msgstr ""
#, elixir-autogen, elixir-format
msgid "templates.paper_screening"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.comparison"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.context"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.intervention"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.outcome"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.phenomenon_of_interest"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.population"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.setting"
msgstr ""
28 changes: 28 additions & 0 deletions core/priv/gettext/en/LC_MESSAGES/eyra-enums.po
Original file line number Diff line number Diff line change
Expand Up @@ -473,3 +473,31 @@ msgstr "Paper screening"
#, elixir-autogen, elixir-format
msgid "templates.paper_screening"
msgstr "Paper screening"

#, elixir-autogen, elixir-format
msgid "categories.comparison"
msgstr "The control group or alternative intervention. (PICO, SPICE)"

#, elixir-autogen, elixir-format
msgid "categories.context"
msgstr "The environment, setting, or situational focus. (PICo, SPICE)"

#, elixir-autogen, elixir-format
msgid "categories.intervention"
msgstr "The treatment, exposure, or action studied. (PICO, SPICE)"

#, elixir-autogen, elixir-format
msgid "categories.outcome"
msgstr "The measurable result of the intervention. (PICO, PICOS, SPICE)"

#, elixir-autogen, elixir-format
msgid "categories.phenomenon_of_interest"
msgstr " The qualitative research focus. (SPIDER, PICo)"

#, elixir-autogen, elixir-format
msgid "categories.population"
msgstr "The group, subjects or sample being studied. (PICO, PICo, SPIDER)"

#, elixir-autogen, elixir-format
msgid "categories.setting"
msgstr "A specific geographic or organizational location. (SPICE)"
28 changes: 28 additions & 0 deletions core/priv/gettext/eyra-enums.pot
Original file line number Diff line number Diff line change
Expand Up @@ -473,3 +473,31 @@ msgstr ""
#, elixir-autogen, elixir-format
msgid "templates.paper_screening"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.comparison"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.context"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.intervention"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.outcome"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.phenomenon_of_interest"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.population"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.setting"
msgstr ""
28 changes: 28 additions & 0 deletions core/priv/gettext/nl/LC_MESSAGES/eyra-enums.po
Original file line number Diff line number Diff line change
Expand Up @@ -473,3 +473,31 @@ msgstr "Data Donatie"
#, elixir-autogen, elixir-format
msgid "templates.paper_screening"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.comparison"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.context"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.intervention"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.outcome"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.phenomenon_of_interest"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.population"
msgstr ""

#, elixir-autogen, elixir-format
msgid "categories.setting"
msgstr ""
68 changes: 68 additions & 0 deletions core/systems/onyx/categories.ex
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
defmodule Systems.Onyx.Categories do
@moduledoc """
Defines the screening criteria categories used in the TIAB screening phase of the literature review.
## Purpose
This module specifies a focused subset of research elements (categories) derived from established frameworks
like PICO, PICo, SPIDER, and SPICE. These categories are used to guide the screening process by structuring
the evaluation of titles and abstracts (TIAB). The categories provide a conceptual foundation for assessing
paper relevance.
## Current Scope
The categories in this module are scoped specifically to the TIAB screening phase of a literature review.
They are not intended to represent the entirety of any framework but instead focus on elements most relevant
for this phase of the research process.
| **Category** | **Description** | **Framework of Origin** |
|----------------------------|--------------------------------------------------|-------------------------|
| **Population** | The group, subjects, or sample being studied. | PICO, PICo, SPIDER |
| **Intervention** | The treatment, exposure, or action studied. | PICO, SPICE |
| **Comparison** | The control group or alternative intervention. | PICO, SPICE |
| **Outcome** | The measurable result of the intervention. | PICO, PICOS, SPICE |
| **Phenomenon of Interest** | The qualitative research focus. | SPIDER, PICo |
| **Context** | The environment, setting, or situational focus. | PICo, SPICE |
| **Setting** | A specific geographic or organizational location.| SPICE |
## Future Integration
### Ontology-Based Annotation Labels
- These categories will eventually be replaced by **Annotation Labels** represented as **Terms** in the
Onyx Ontology.
- Each Term will have:
- **Multiple Definitions**: Reflecting different interpretations across domains and study types.
- **Context-Dependent Mapping**: Definitions will adapt dynamically based on the researcher's context,
such as the type of study they are conducting.
### Mappings in Onyx
- Onyx will define mappings between:
- **Ontology Terms**: Categories as Ontology Terms.
- **Study Contexts**: Study types provided by the researcher.
- These mappings ensure precise and flexible use of terms across diverse scientific disciplines.
## Note
The current implementation focuses on the immediate needs of the TIAB screening phase. However, the modular
design ensures future adaptability as Onyx evolves to incorporate an ontology-driven framework for annotations.
## Usage
### In the Screening Process
These categories are used to structure the evaluation criteria applied during the TIAB screening phase. They
guide both manual reviews and AI-assisted tools to assess paper relevance against predefined criteria.
### Transition to Ontology
As Onyx develops, these categories will form the conceptual basis for a broader, ontology-driven annotation
framework, ensuring scalability and cross-domain applicability.
"""

use Core.Enums.Base,
{:categories,
[
:population,
:intervention,
:comparison,
:outcome,
:phenomenon_of_interest,
:context,
:setting
]}
end

0 comments on commit 18aa519

Please sign in to comment.