Merge branch 'main' into fix-submit-docs

Author: tsalo

docs/installation.rst

@@ -34,7 +34,7 @@ We have a `yaml` file on our repo for easily installing BABS and its dependencie
     wget https://raw.githubusercontent.com/PennLINC/babs/refs/heads/main/environment_hpc.yml
 
     # Install into a new environment called babs:
-    mamba create -f environment_hpc.yml
+    mamba env create -f environment_hpc.yml
 
     # Activate the environment:
     mamba activate babs
@@ -43,6 +43,12 @@ We have a `yaml` file on our repo for easily installing BABS and its dependencie
     If you are using ``conda`` or ``micromamba`` instead of ``mamba``, simply replace ``mamba``
     with either ``conda`` or ``micromamba`` in the commands above.
 
+.. note::
+    On older HPC systems, compiled scientific dependencies (for example ``scipy`` via ``niworkflows``)
+    should be installed from conda-forge rather than built by ``pip`` from source.
+    If environment creation fails while building wheels, re-run using the
+    ``environment_hpc.yml`` from this repository and prefer ``mamba/micromamba env create``.
+
 Before proceeding, make sure your ``Git`` identity has been configured.
 You can check whether this has already been done via::
 

environment_hpc.yml

@@ -9,10 +9,12 @@ dependencies:
   - pip
   # Core packages from conda-forge when available
   - numpy
+  - scipy
   - pandas
   - pyyaml>=6.0
   - jinja2
   - nibabel
+  - niworkflows
   - tqdm
   - regex
   # Testing packages
@@ -26,7 +28,6 @@ dependencies:
       - datalad-osf
       - filelock>=3.8.0
       - backoff
-      - niworkflows
       - qstat>=0.0.5
       - pytest-cov>=5.0.0
       - pytest-env>=1.1.0