Merge pull request #471 from asogaard/pisa-documentation

Update READMEs in PISA examples folder

examples/05_pisa/README.md

@@ -1,3 +1,6 @@
 # PISA examples
 
 Be aware that the examples in this folder presuppose that GraphNeT is installed with [PISA](https://github.com/icecube/pisa).
+In addition, it should be noted that the use of PISA is a highly specialised case, albeit an important one for neutrino oscillation physics in IceCube, and that any oscillation analysis example would require an amount of statistics that is not feasible to bundle with a software package like GraphNeT.
+For these reasons, examples in this folder are intentionally not self-contained, in contrast to the other provided examples.
+However, the GraphNeT developers are happy to work with users who are interested in leveraging the PISA functionality that is included in this package.

examples/README.md

@@ -7,7 +7,7 @@ Examples are grouped into five numbered subfolders, roughly in order of how you
 2. **Data.** Reading in data in intermediate formats, plotting feature distributions, and converting data between intermediate file formats. These examples are entirely self-contained and can be run by anyone.
 3. **Weights.** Fitting per-event weights.
 4. **Training.** Training GNN models on various physics tasks.
-5. **PISA.** Fitting and plotting oscillation analysis contours. These examples presuppose that GraphNeT has been installed with [PISA](https://github.com/icecube/pisa).
+5. **PISA.** Fitting and plotting oscillation analysis contours. These examples presuppose that GraphNeT has been installed with [PISA](https://github.com/icecube/pisa), and the examples are intentionally not self-contained due to their specialised nature.
 
 Each subfolder contains similarly numbered example scripts.
 Each example script comes with a simple command-line interface and help functionality, e.g.