completed documentation for analyze functions