reformat a bit and explain user input and heavy self-energies