pyActigraphy.light.LightMetricsMixin.IV

LightMetricsMixin.IV(binarize=False, threshold=0)[source]

Intradaily variability

The Intradaily Variability (IV) quantifies the variability of the light exposure pattern.

Parameters
  • binarize (bool, optional) – If set to True, the data are binarized. Default is False.

  • threshold (int, optional) – If binarize is set to True, data above this threshold are set to 1 and to 0 otherwise. Default is 4.

Returns

iv – A pandas DataFrame with IV per channel.

Return type

pd.DataFrame

Notes

It is defined in ref [1]:

\[IV = \frac{c^{1h}}{d^{1h}}\]

with:

\[d^{1h} = \sum_{i}^{n}\frac{\left(x_{i}-\bar{x}\right)^{2}}{n}\]

where \(x_{i}\) is the number of active (counts higher than a predefined threshold) minutes during the \(i^{th}\) period, \(\bar{x}\) is the mean of all data and \(n\) is the number of periods covered by the actigraphy data,

and with:

\[c^{1h} = \sum_{i}^{n-1} \frac{ \left( x_{i+1} - x_{i} \right)^{2} }{n-1}\]

References

1

Witting W., Kwa I.H., Eikelenboom P., Mirmiran M., Swaab D.F. Alterations in the circadian rest–activity rhythm in aging and Alzheimer׳s disease. Biol Psychiatry. 1990;27:563–572.