document for basic computation routines