ADA-SVR (3/4) PR example of models

doc_conf/api.rst

@@ -16,6 +16,7 @@ Functions
    :toctree: generated/
 
    ada_svr
+   ada_svr_pvalue
    aggregate_quantiles
    clustered_inference
    data_simulation

doc_conf/conf.py

@@ -90,7 +90,7 @@
 # built documents.
 #
 # The short X.Y version.
-from hidimstat._version import __version__  # noqa
+from hidimstat import __version__
 
 # The full version, including alpha/beta/rc tags.
 release = __version__
@@ -217,9 +217,9 @@
     "python": ("https://docs.python.org/3", None),
     "numpy": ("https://numpy.org/devdocs", None),
     "scipy": ("https://scipy.github.io/devdocs", None),
-    "matplotlib": ("https://matplotlib.org", None),
+    "matplotlib": ("https://matplotlib.org/stable/", None),
     "sklearn": ("https://scikit-learn.org/stable", None),
-    "numba": ("https://numba.pydata.org/numba-doc/latest", None),
+    "numba": ("https://numba.readthedocs.io/en/stable/", None),
     "joblib": ("https://joblib.readthedocs.io/en/latest", None),
     "pandas": ("https://pandas.pydata.org/pandas-docs/stable", None),
     "seaborn": ("https://seaborn.pydata.org/", None),
@@ -228,7 +228,6 @@
 
 examples_dirs = ["../examples"]
 gallery_dirs = ["auto_examples"]
-import mne
 
 scrapers = ("matplotlib",)
 try:
@@ -240,6 +239,7 @@
     pass
 if any(x in scrapers for x in ("pyvista")):
     from traits.api import push_exception_handler
+    import mne
 
     push_exception_handler(reraise_exceptions=True)
     report_scraper = mne.report._ReportScraper()
@@ -259,6 +259,8 @@
     "abort_on_example_error": False,
     "image_scrapers": scrapers,
     "show_memory": True,
+    'filename_pattern': r'\.py',
+    'ignore_pattern': r'__init__\.py',
     # 'reference_url': {
     #     'numpy': 'http://docs.scipy.org/doc/numpy-1.9.1',
     #     'scipy': 'http://docs.scipy.org/doc/scipy-0.17.0/reference',

doc_conf/index.rst

@@ -46,8 +46,7 @@ is also needed to install ``pytest``.
 Documentation & Examples
 ------------------------
 
-Documentation about the main HiDimStat functions is available
-`here <api.html>`_ and examples are available `here <auto_examples/index.html>`_.
+Documentation of HiDimStat is composed of an `API <api.html>`_ and `examples <auto_examples/index.html>`_.
 
 As of now, there are three different examples (Python scripts) that
 illustrate how to use the main HiDimStat functions.
@@ -118,15 +117,15 @@ Application to source localization (MEG/EEG data):
 
 Single/Group statistically validated importance using conditional permutations:
 
-* Chamma, A., Thirion, B., & Engemann, D. (2024). **Variable importance in
-high-dimensional settings requires grouping**. In Proceedings of the 38th
-Conference of the Association for the Advancement of Artificial
-Intelligence(AAAI 2024), Vancouver, Canada.
+* Chamma, A., Thirion, B., & Engemann, D. (2024). Variable importance in
+  high-dimensional settings requires grouping. In Proceedings of the 38th
+  Conference of the Association for the Advancement of Artificial
+  Intelligence(AAAI 2024), Vancouver, Canada.
 
-* Chamma, A., Engemann, D., & Thirion, B. (2023). **Statistically Valid Variable
-Importance Assessment through Conditional Permutations**. In Proceedings of the
-37th Conference on Neural Information Processing Systems (NeurIPS 2023), New
-Orleans, USA.
+* Chamma, A., Engemann, D., & Thirion, B. (2023). Statistically Valid Variable
+  Importance Assessment through Conditional Permutations. In Proceedings of the
+  37th Conference on Neural Information Processing Systems (NeurIPS 2023), New
+  Orleans, USA.
 
 If you use our packages, we would appreciate citations to the relevant
 aforementioned papers.

doc_conf/references.bib

@@ -177,4 +177,28 @@ @article{liuFastPowerfulConditional2021
   archiveprefix = {arxiv},
   keywords = {Statistics - Methodology},
   file = {/home/ahmad/Zotero/storage/8HRQZX3H/Liu et al. - 2021 - Fast and Powerful Conditional Randomization Testin.pdf;/home/ahmad/Zotero/storage/YFNDKN2B/2006.html}
-}
+}
+
+@article{gaonkar_deriving_2012,
+	title = {Deriving statistical significance maps for {SVM} based image classification and group comparisons},
+	volume = {15},
+	url = {https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3703958/},
+	abstract = {Population based pattern analysis and classification for quantifying structural and functional differences between diverse groups has been shown to be a powerful tool for the study of a number of diseases, and is quite commonly used especially in neuroimaging. The alternative to these pattern analysis methods, namely mass univariate methods such as voxel based analysis and all related methods, cannot detect multivariate patterns associated with group differences, and are not particularly suitable for developing individual-based diagnostic and prognostic biomarkers. A commonly used pattern analysis tool is the support vector machine ({SVM}). Unlike univariate statistical frameworks for morphometry, analytical tools for statistical inference are unavailable for the {SVM}. In this paper, we show that null distributions ordinarily obtained by permutation tests using {SVMs} can be analytically approximated from the data. The analytical computation takes a small fraction of the time it takes to do an actual permutation test, thereby rendering it possible to quickly create statistical significance maps derived from {SVMs}. Such maps are critical for understanding imaging patterns of group differences and interpreting which anatomical regions are important in determining the classifier's decision.},
+	pages = {723--730},
+	number = {0},
+	journaltitle = {Medical image computing and computer-assisted intervention : {MICCAI} ... International Conference on Medical Image Computing and Computer-Assisted Intervention},
+	journal = {Med Image Comput Comput Assist Interv},
+	author = {Gaonkar, Bilwaj and Davatzikos, Christos},
+	urldate = {2024-12-16},
+	year = {2012},
+	pmid = {23285616},
+	pmcid = {PMC3703958},
+	file = {PubMed Central Full Text PDF:/home/likusch/Zotero/storage/DX8QQAF5/Gaonkar and Davatzikos - 2012 - Deriving statistical significance maps for SVM based image classification and group comparisons.pdf:application/pdf},
+}
+
+@book{molnar2020interpretable,
+  title={Interpretable machine learning},
+  author={Molnar, Christoph},
+  year={2020},
+  publisher={Lulu. com}
+}

examples/README.txt

@@ -5,4 +5,4 @@ Examples Gallery
 
 .. contents:: Contents
    :local:
-   :depth: 3
+   :depth: 0