Document functions.

master
junos 2023-07-03 20:45:39 +02:00
parent 825380a47e
commit e3ff4846e1
2 changed files with 38 additions and 0 deletions

View File

@ -128,6 +128,25 @@ DICT_COPE_QUESTION_IDS = {
def reassign_question_ids(df_cope_cleaned: pd.DataFrame) -> pd.DataFrame: def reassign_question_ids(df_cope_cleaned: pd.DataFrame) -> pd.DataFrame:
"""
Fix question IDs to match their actual content.
Unfortunately, when altering the protocol to adapt to COVID pandemic,
we did not retain original question IDs.
This means that for participants before 2021, they are different
from for the rest of them.
This function searches for question IDs by matching their strings.
Parameters
----------
df_cope_cleaned: pd.DataFrame
A cleaned up dataframe, which must also include esm_user_answer_numeric.
Returns
-------
df_cope_fixed: pd.DataFrame
The same dataframe but with fixed question IDs.
"""
df_esm_cope_unique_questions = ( df_esm_cope_unique_questions = (
df_cope_cleaned.groupby("question_id") df_cope_cleaned.groupby("question_id")
.esm_instructions.value_counts() .esm_instructions.value_counts()

View File

@ -447,6 +447,25 @@ def extract_event_duration(df_esm_sam_clean: pd.DataFrame) -> pd.DataFrame:
def reassign_question_ids(df_sam_cleaned: pd.DataFrame) -> pd.DataFrame: def reassign_question_ids(df_sam_cleaned: pd.DataFrame) -> pd.DataFrame:
"""
Fix question IDs to match their actual content.
Unfortunately, when altering the protocol to adapt to COVID pandemic,
we did not retain original question IDs.
This means that for participants before 2021, they are different
from for the rest of them.
This function searches for question IDs by matching their strings.
Parameters
----------
df_sam_cleaned: pd.DataFrame
A cleaned up dataframe, which must also include esm_user_answer_numeric.
Returns
-------
df_sam_fixed: pd.DataFrame
The same dataframe but with fixed question IDs.
"""
df_esm_sam_unique_questions = ( df_esm_sam_unique_questions = (
df_sam_cleaned.groupby("question_id") df_sam_cleaned.groupby("question_id")
.esm_instructions.value_counts() .esm_instructions.value_counts()