stupid GitHub won't let me comment on hidden lines.  regarding lines 317-8 (338-9) I'm not sure that comment is necessary any more since there's a separate `_stamp_trial_id` method.  Maybe it should read "for trial IDs, it is recommended to use the convenience function `_stamp_trial_id` with a list of integers."