changing default linearisation function
updating documentation