From 18aa5192d0a7f97d97d4e1b1bb2df6cc22defd29 Mon Sep 17 00:00:00 2001 From: Emiel Date: Fri, 20 Dec 2024 11:52:59 +0100 Subject: [PATCH] Add fixed list of categories for TIAB screening --- .../priv/gettext/de/LC_MESSAGES/eyra-enums.po | 28 ++++++++ .../priv/gettext/en/LC_MESSAGES/eyra-enums.po | 28 ++++++++ core/priv/gettext/eyra-enums.pot | 28 ++++++++ .../priv/gettext/nl/LC_MESSAGES/eyra-enums.po | 28 ++++++++ core/systems/onyx/categories.ex | 68 +++++++++++++++++++ 5 files changed, 180 insertions(+) create mode 100644 core/systems/onyx/categories.ex diff --git a/core/priv/gettext/de/LC_MESSAGES/eyra-enums.po b/core/priv/gettext/de/LC_MESSAGES/eyra-enums.po index 0d8874986..1158ede21 100644 --- a/core/priv/gettext/de/LC_MESSAGES/eyra-enums.po +++ b/core/priv/gettext/de/LC_MESSAGES/eyra-enums.po @@ -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 "" diff --git a/core/priv/gettext/en/LC_MESSAGES/eyra-enums.po b/core/priv/gettext/en/LC_MESSAGES/eyra-enums.po index 872a32c01..79b71fcfb 100644 --- a/core/priv/gettext/en/LC_MESSAGES/eyra-enums.po +++ b/core/priv/gettext/en/LC_MESSAGES/eyra-enums.po @@ -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)" \ No newline at end of file diff --git a/core/priv/gettext/eyra-enums.pot b/core/priv/gettext/eyra-enums.pot index ec45415b6..afb4b5da4 100644 --- a/core/priv/gettext/eyra-enums.pot +++ b/core/priv/gettext/eyra-enums.pot @@ -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 "" diff --git a/core/priv/gettext/nl/LC_MESSAGES/eyra-enums.po b/core/priv/gettext/nl/LC_MESSAGES/eyra-enums.po index 9a1d6e501..9207eb2b6 100644 --- a/core/priv/gettext/nl/LC_MESSAGES/eyra-enums.po +++ b/core/priv/gettext/nl/LC_MESSAGES/eyra-enums.po @@ -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 "" diff --git a/core/systems/onyx/categories.ex b/core/systems/onyx/categories.ex new file mode 100644 index 000000000..24b242ef3 --- /dev/null +++ b/core/systems/onyx/categories.ex @@ -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