Leander Fischer

Broken/missing documentation of analysis

2

The notebook in [the analysis readme is missing](https://github.com/icecube/pisa/blob/master/pisa/analysis/README.md). A working notebook and/or at least some sentences on how this should be used are needed.

possible duplication: various metric/likelihood definitions

1

Is it intended that there are multiple (possible duplicate) definitions of the same likelihoods [stats.py](pisa/utils/stats.py), [likelihood_functions.py](pisa/utils/likelihood_functions.py), and [llh_defs](pisa/utils/llh_defs)? Maybe these could be streamlined/combined.

The README in the [pipeline examples](https://github.com/icecube/pisa/tree/master/pisa_examples/resources/settings/pipeline) seems to be super out of date. Maybe someone could clean this up a bit.

In [these lines](https://github.com/icecube/pisa/blob/15eed8557db13638ff241cfbaee8a5ca779f175a/pisa/stages/discr_sys/ultrasurfaces.py#L136-L137), the US fit results are loaded, but this expects an absolute path (so not generic for different clusters/wgs. This could simply be replaced with the [find_resource](https://github.com/icecube/pisa/blob/master/pisa/utils/resources.py#L38) function...