add w2lists_def readout

Add function to automatically read out w2list_XXX_idx from definitions for an offline file

src/km3io/tools.py

@@ -540,6 +540,15 @@ def is_3dmuon(trigger_mask):
 
 
 def get_w2defs_idx(f):
+    """
+    Get the correct w2list_idx for the given file, or None if there is none.
+
+    Parameters
+    ----------
+    f : km3io.OfflineReader
+        The file.
+
+    """
     w2s_idx = {
         "genhen": km3io.definitions.w2list_genhen_idx,
         "gseagen": km3io.definitions.w2list_gseagen_idx,