add mapping function and doc strings