reformat and renaming of variables (documented in README.md)