implement and document new analyse API