structure code with #%% sections for readability

[stefanfluck]

update code cells (introduced by #%%) to contain intelligible descriptions and provide logical hierarchy with using #%% and #%%%, where three % is of one lower hierarchy than two %s.