computeForestMaxLeafIndex function

Compute and return the largest possible leaf index computable by computeForestLeafIndices for the forests in a designated forest sample container.