added more precise comments and doc about ellipticity calculations