# weekmatrix

Recent research [MON2015] shows
how deep learning methods (CNN) can achieve state-of-the-art classification
performance on mobile phone metadata. These methods can exploit the temporal
structure in mobile metadata by using specialized neural network architectures.

Note

See the convnet-metadata
repository on Github to learn how to use bandicoot `weekmatrix`

features with the Caffe deep learning framework.

This module contains functions for outputting the *week-matrix* data
representation, which can used with these deep learning methods. The mobile
metadata is represented as 8 matrices summarizing mobile phone usage on a
given week with hours of the day on the x-axis and the weekdays on the
y-axis. These 8 matrices are the number of unique contacts, calls, texts and
the total duration of calls for respectively incoming and outgoing
interactions. Every cell in the matrices represents the amount of activity
for a given variable of interest in that hour interval (e.g. between 2 and
3pm). In this way, any number of interactions during the week is binned.
These 8 matrices are combined into a 3-dimensional matrix with a separate
'channel' for each of the 8 variables of interest. Such a 3-dimensional
matrix is named a *week-matrix*.

`create_weekmatrices` (user[, split_interval]) |
Computes raw indicators (e.g. |

`read_csv` (filename) |
Read a list of week-matrices from a CSV file. |

`to_csv` (weekmatrices, filename[, digits]) |
Exports a list of week-matrices to a specified filename in the CSV format. |

## References

[MON2015] | Felbo, B., Sundsøy, P., Pentland, A. S., Lehmann, S., & de
Montjoye, Y. A. (2015). Using Deep Learning to Predict Demographics
from Mobile Phone Metadata. arXiv preprint arXiv:1511.06660. |