added helper methods with documentation to transform