improved documentation for Francis weighting functions