add comments in lattice.h for other users