documented matrix construction