added ASHS example notebook

https://github.com/fphammerle/freesurfer-volume-reader/issues/15

examples/README.md

@@ -0,0 +1,5 @@
+# freesurfer-volume-reader examples
+
+```sh
+pipenv run jupyter notebook
+```

tests/ashs_test.py

@@ -102,12 +102,14 @@ def test_hippocampal_subfields_volume_file_read_volumes_dataframe_not_found():
     (os.path.join(SUBJECTS_DIR, 'bert'),
      {os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_corr_nogray_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_corr_usegray_volumes.txt'),
+      os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_heur_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_right_corr_nogray_volumes.txt')}),
     (SUBJECTS_DIR,
      {os.path.join(SUBJECTS_DIR, 'alice', 'final', 'alice_left_heur_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'alice', 'final', 'alice_left_corr_nogray_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_corr_nogray_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_corr_usegray_volumes.txt'),
+      os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_left_heur_volumes.txt'),
       os.path.join(SUBJECTS_DIR, 'bert', 'final', 'bert_right_corr_nogray_volumes.txt')}),
 ])
 def test_hippocampal_subfields_volume_file_find(root_dir_path, expected_file_paths):

tests/subjects/all-hippocampal-volumes.csv

@@ -34,6 +34,13 @@ ashs,bert,right,nogray,ERC,789.013,,
 ashs,bert,right,nogray,PHC,2345.878,,
 ashs,bert,right,nogray,PRC,2345.67,,
 ashs,bert,right,nogray,SUB,457.781,,
+ashs,bert,left,,CA1,678.903,,
+ashs,bert,left,,CA2+3,123.458,,
+ashs,bert,left,,DG,901.236,,
+ashs,bert,left,,ERC,789.014,,
+ashs,bert,left,,PHC,2345.878,,
+ashs,bert,left,,PRC,2345.670,,
+ashs,bert,left,,SUB,457.781,,
 freesurfer-hipposf,alice,left,,Hippocampal_tail,173.456789,True,
 freesurfer-hipposf,alice,left,,subiculum,734.567891,True,
 freesurfer-hipposf,alice,left,,CA1,34.567891,True,

tests/subjects/ashs-hippocampal-volumes.csv

@@ -34,3 +34,10 @@ ashs,bert,nogray,right,ERC,789.013
 ashs,bert,nogray,right,PHC,2345.878
 ashs,bert,nogray,right,PRC,2345.670
 ashs,bert,nogray,right,SUB,457.781
+ashs,bert,,left,CA1,678.903
+ashs,bert,,left,CA2+3,123.458
+ashs,bert,,left,DG,901.236
+ashs,bert,,left,ERC,789.014
+ashs,bert,,left,PHC,2345.878
+ashs,bert,,left,PRC,2345.670
+ashs,bert,,left,SUB,457.781

tests/subjects/bert/ashs-hippocampal-volumes.csv

@@ -20,3 +20,10 @@ ashs,bert,nogray,right,ERC,789.013
 ashs,bert,nogray,right,PHC,2345.878
 ashs,bert,nogray,right,PRC,2345.670
 ashs,bert,nogray,right,SUB,457.781
+ashs,bert,,left,CA1,678.903
+ashs,bert,,left,CA2+3,123.458
+ashs,bert,,left,DG,901.236
+ashs,bert,,left,ERC,789.014
+ashs,bert,,left,PHC,2345.878
+ashs,bert,,left,PRC,2345.670
+ashs,bert,,left,SUB,457.781

tests/subjects/bert/final/bert_left_heur_volumes.txt

@@ -0,0 +1,7 @@
+bert left CA1 26 678.903
+bert left CA2+3 26 123.458
+bert left DG 25 901.236
+bert left ERC 18 789.014
+bert left PHC 16 2345.878
+bert left PRC 26 2345.670
+bert left SUB 26 457.781