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.
Function _calculate_KHQ_score_row_by_row Calculate KHQ score.
Function _calculate_one_score Undocumented
Function _imputate_KHQ_row_by_row Imputate missing values.
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)

Calculate KHQ score.

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)

Undocumented

def _imputate_KHQ_row_by_row(row, col_names): (source)

Imputate missing values.

See 'score_KHQ()' for more details.