Fix typos and tweak/comment data structures

Fix typo pmbp -> pbmp in data_structures and test_data_structures. Optional
parameters were added to some constructors of data_structures. Add some
documentation on data_structures.