buhtzology.khq

module documentation
(source)

Scoring mode of the German version of the King's Health Questionnaire described in Bjelic-Radisci V et al. (2005) DOI: 10.1055/s-2005-872957.

Function score_KHQ Auswertungsmodus der deutschen Version des King's Health Questionnaire nach Bjelic-Radisci V et al. (2005) doi: 10.1055/s-2005-872957
Function _calculate_KHQ_score_row_by_row Attention: Keep in mind that pythons list index for 'col_names' starts with 0 but the questionnaire starts with item 1. So list item number 10 means questionnaire item number 11.
Function _calculate_one_score Helper for _calculate_KHQ_score_row_by_row() to reduce cyclomatic complexity.
Function _imputate_KHQ_row_by_row Imputation fehlender Werte in der deutschen Version des King's Health Questionnaire.
def score_KHQ(data, col_names=None, suffix=''): (source)

Auswertungsmodus der deutschen Version des King's Health Questionnaire nach Bjelic-Radisci V et al. (2005) doi: 10.1055/s-2005-872957

Missing values (pandas.NA) werden durch 0 ersetzt bei den KHQ Items 9-11 und 22-32. Weitere missing values können imputiert werden, wenn mindestens 2/3 der Items einer Subskala beantwortet wurden. Bedingt durch die Struktur des KHQ, besteht diese Möglichkeit nur bei den Subskalen 7 und 9 bzw. den Items 12-14 und 17-21 möglich. Imputiert wird der gerundete mittlere Wert der validen Items. Gemittelt wird mit 'pandas.Series.mean()'. Gerundet wird mit 'decimal.ROUND_HALF_EVEN'; d.h. zur nächstgelegenen geraden Zahl ('to the nearest even value'). Bzgl. Mittelwert und Rundungsmethode macht das deutsche KHQ Manual keine Angaben und auch die Erstautoren hat diese Frage nicht beantworten können.

Parameters
data:pandas.DataFrameData including all raw KHQ items.
col_names:listNaming relevant columns in 'data'.
suffix:strAdded to the name of resulting columns.
Returns
(pandas.DataFrame)The 'data' with raw item values and new KHQ scale columns.
Raises
(TypeError)If 'data' is not a 'pandas.DataFrame'.
(ValueError)If the KHQ items have invalid values.
def _calculate_KHQ_score_row_by_row(row, col_names, suffix): (source)

Attention: Keep in mind that pythons list index for 'col_names' starts with 0 but the questionnaire starts with item 1. So list item number 10 means questionnaire item number 11.

Raises
ValueErrorCalculate score out of range.
def _calculate_one_score(score, minus_offset, divide_by): (source)

Helper for _calculate_KHQ_score_row_by_row() to reduce cyclomatic complexity.

def _imputate_KHQ_row_by_row(row, col_names): (source)

Imputation fehlender Werte in der deutschen Version des King's Health Questionnaire.

Für weitere Details siehe 'score_KHQ()'.