fix field ID calculation
update docstring + other minor changes