annotated time series numerical and representation routines