doc + run time calculations