Improvement to pysynphot based on stsynphot refactoring work

This PR contains bugs and enhancements discovered while refactoring `stsynphot`. This PR should remain open until `stsynphot` refactoring is complete (minus commissioning tests). Do not merge without consulting @pllim first.