Fix CVMFS LArCV runtime setup

Author: francois-drielsma

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [Unreleased]
+
+### Fixed
+- **CVMFS container setup**: Restore LArCV feature flags in `/opt/spine/setup.sh` so unpacked-image runtimes expose PyUtil bindings such as `larcv.fill_3d_voxels`, and make `/opt/spine/check-env.sh` validate that binding explicitly.
+
 ## [0.14.1] - 2026-06-27
 
 ### Fixed

docker/spine/Dockerfile

@@ -189,7 +189,9 @@ RUN pip install --no-cache-dir --no-build-isolation .[all]
 # recipe both provide the compiled dependency imports SPINE needs at runtime.
 RUN python -c "import ROOT, larcv, spine; print('container runtime imports ok')"
 RUN /opt/spine/check-env.sh
-RUN env -u ROOTSYS -u LARCV_BASEDIR -u LARCV_LIBDIR -u LARCV_PYTHONDIR \
+RUN env -u ROOTSYS -u LARCV_BASEDIR -u LARCV_BUILDDIR -u LARCV_LIBDIR \
+    -u LARCV_PYTHONDIR -u LARCV_INCDIR -u LARCV_BINDIR -u LARCV_COREDIR \
+    -u LARCV_APPDIR -u LARCV_NUMPY -u LARCV_OPENCV -u LARCV_ROOT6 \
     -u PYTHONPATH -u LD_LIBRARY_PATH bash -lc \
     "source /opt/spine/setup.sh && /opt/spine/check-env.sh"
 

docker/spine/check-env.sh

@@ -13,8 +13,11 @@ print(f"sys.executable: {sys.executable}")
 for key in (
     "ROOTSYS",
     "LARCV_BASEDIR",
+    "LARCV_BUILDDIR",
     "LARCV_LIBDIR",
     "LARCV_PYTHONDIR",
+    "LARCV_NUMPY",
+    "LARCV_OPENCV",
     "PYTHONPATH",
     "LD_LIBRARY_PATH",
 ):
@@ -28,6 +31,16 @@ import larcv
 
 print(f"larcv OK: {larcv}")
 
+from larcv import larcv as larcv_cpp
+
+if not hasattr(larcv_cpp, "fill_3d_voxels"):
+    raise RuntimeError(
+        "larcv imported, but larcv.fill_3d_voxels is missing. "
+        "This usually means the LArCV PyUtil dictionary was not loaded."
+    )
+
+print("larcv PyUtil OK: fill_3d_voxels available")
+
 import spine
 
 print(f"spine OK: {spine}")

docker/spine/setup.sh

@@ -33,8 +33,16 @@ _spine_prepend_path() {
 export SPINE_RUNTIME_DIR="${SPINE_RUNTIME_DIR:-/opt/spine}"
 export ROOTSYS="${ROOTSYS:-/opt/root}"
 export LARCV_BASEDIR="${LARCV_BASEDIR:-/app/larcv2}"
+export LARCV_BUILDDIR="${LARCV_BUILDDIR:-${LARCV_BASEDIR}/build}"
 export LARCV_LIBDIR="${LARCV_LIBDIR:-${LARCV_BASEDIR}/build/lib}"
 export LARCV_PYTHONDIR="${LARCV_PYTHONDIR:-${LARCV_BASEDIR}/python}"
+export LARCV_INCDIR="${LARCV_INCDIR:-${LARCV_BASEDIR}/build/include}"
+export LARCV_BINDIR="${LARCV_BINDIR:-${LARCV_BASEDIR}/build/bin}"
+export LARCV_COREDIR="${LARCV_COREDIR:-${LARCV_BASEDIR}/larcv/core}"
+export LARCV_APPDIR="${LARCV_APPDIR:-${LARCV_BASEDIR}/larcv/app}"
+export LARCV_NUMPY="${LARCV_NUMPY:-1}"
+export LARCV_OPENCV="${LARCV_OPENCV:-1}"
+export LARCV_ROOT6="${LARCV_ROOT6:-1}"
 export FMATCH_BASEDIR="${FMATCH_BASEDIR:-/opt/OpT0Finder}"
 export FMATCH_BUILDDIR="${FMATCH_BUILDDIR:-${FMATCH_BASEDIR}/build}"
 export FMATCH_LIBDIR="${FMATCH_LIBDIR:-${FMATCH_BUILDDIR}/lib}"
@@ -43,6 +51,7 @@ export FMATCH_BINDIR="${FMATCH_BINDIR:-${FMATCH_BUILDDIR}/bin}"
 export FMATCH_DATADIR="${FMATCH_DATADIR:-${FMATCH_BASEDIR}/dat}"
 
 _spine_prepend_path PATH "${ROOTSYS}/bin"
+_spine_prepend_path PATH "${LARCV_BINDIR}"
 _spine_prepend_path PATH "${FMATCH_BASEDIR}/bin"
 _spine_prepend_path PATH "${FMATCH_BINDIR}"