Add two more doc-strings

Add doc-strings to extract_decays and find_decay_in_reference to comply
with standards and explain the purpose of these functions
Change some more variable names
Add doc-string to check_sanity
Create function to open files with try + exception

It is often necessary to open files with same surrounding code of try +
exception. This functionality will now be outsourced to it's own
function