make partsMask optional and fix documentation