in docs params go from 1 to 9, explain directed edges