complete decomp function with readme examples