Tutorials rehaul

Author: DraTeots

.gitignore

@@ -191,3 +191,5 @@ analysis/edm4eic-true-decays/10x100/
 analysis/edm4eic-true-decays/18x275/
 
 analysis/edm4eic-true-decays/5x41/
+
+uv.lock

docs/.vitepress/config.mts

@@ -61,9 +61,9 @@ export default withMermaid({
                 link: '/tutorials',
                 items: [
                     { text: 'Overview', link: '/tutorials' },
-                    { text: 'py1 Uproot', link: '/tutorials/01_using_uproot' },
-                    { text: 'py2 Metadata', link: '/tutorials/02_metadata' },
-                    { text: 'py3 References', link: '/tutorials/03_references' },
+                    { text: 'py-edm4eic-01 Uproot', link: '/tutorials/01_using_uproot' },
+                    { text: 'py-edm4eic-02 Metadata', link: '/tutorials/02_metadata' },
+                    { text: 'py-edm4eic-03 References', link: '/tutorials/03_references' },
                     { text: 'cpp1 EDM4EIC', link: '/tutorials/cpp01_edm4eic' },
                 ]
             },

csv_data.md docs/data-csv.mdcsv_data.md renamed to docs/data-csv.md

@@ -1,4 +1,6 @@
-# CSV Tables
+# CSV Data
+
+
 
 The CSV (Comma-Separated Values) format is exceptionally convenient for data processing. 
 It is simple, yet processed efficiently, supported by many analysis and introspection tools, 
@@ -98,7 +100,9 @@ erDiagram
     }
 ```
 
-## The Key Challenge: Multiple Files = Broken Relationships
+## Combine Multiple Files
+
+The Key Challenge: Multiple Files = Broken Relationships
 
 When we have multiple CSV files from different runs or datasets, each file starts its event numbering from 0:
 
@@ -110,17 +114,16 @@ File 3: evt = [0, 1, 2, 3, 4, ...]  ← ID Collision!
 
 **Problem**: Event 0 from File 1 is completely different from Event 0 from File 2, but they have the same ID!
 
-## Solution: Global Unique Event IDs
+**Solution**: Global Unique Event IDs
 
 We need to create globally unique event IDs across all files:
 
 ```python
 import pandas as pd
 import glob
 
-def concat_csvs_with_unique_events(pattern):
+def concat_csvs_with_unique_events(files):
     """Load and concatenate CSV files with globally unique event IDs"""
-    files = sorted(glob.glob(pattern))
     dfs = []
     offset = 0
 
@@ -133,8 +136,8 @@ def concat_csvs_with_unique_events(pattern):
     return pd.concat(dfs, ignore_index=True)
 
 # Load both tables with unique event IDs
-lambda_df = concat_csvs_with_unique_events("mcpart_lambda*.csv")
-dis_df = concat_csvs_with_unique_events("dis_parameters*.csv")
+lambda_df = concat_csvs_with_unique_events(sorted(glob.glob("mcpart_lambda*.csv")))
+dis_df = concat_csvs_with_unique_events(sorted(glob.glob("dis_parameters*.csv")))
 ```
 
 **Result**: Now we have globally unique event IDs: