ENH: Auto-cleanup BigIO test outputs and enforce serial execution

Add ITK_REMOVE_BIGIO_FILES_ON_SUCCESS (advanced, default ON) that
automatically removes multi-gigabyte BigIO test output files after
successful completion using CTest fixtures. When a BigIO write-read
test passes, a cleanup test runs to delete its output files. When a
test fails, files are retained for debugging. Set the option to OFF
to always retain output files.

Additionally ensure all BigIO tests (>1 GB output) run serially via
RUN_SERIAL to prevent concurrent disk exhaustion.

New CMake function itk_add_bigio_test_cleanup() uses CTest FIXTURES
to wire up SETUP (main test) and CLEANUP (file removal) phases.
For .mhd files, companion .raw/.zraw files are also removed.

Affected modules:
- IO/Meta: LargeMetaImageWriteReadTest 1-4 (.mhd + .raw)
- IO/TIFF: LargeTIFFImageWriteReadTest 1-4 (.tif)
- IO/ImageBase: LargeImageWriteReadTest 2D/3D, WriteConvertRead (.mha)

These 11 tests produce up to 47 GB of temporary files total.
Without cleanup, they can exhaust disk space on CI runners
(GitHub Actions ubuntu-22.04 has 146 GB total).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hjmjohnson

CMake/ITKModuleTest.cmake

@@ -337,3 +337,70 @@ function(itk_memcheck_ignore)
         ${ARGN}
   )
 endfunction()
+
+#-----------------------------------------------------------------------------
+# Option to automatically remove BigIO test output files on success.
+# BigIO write-read tests can produce multi-gigabyte temporary files
+# that exhaust disk space on CI runners and local builds.
+option(
+  ITK_REMOVE_BIGIO_FILES_ON_SUCCESS
+  "Remove BigIO test output files after successful completion"
+  ON
+)
+mark_as_advanced(ITK_REMOVE_BIGIO_FILES_ON_SUCCESS)
+
+#-----------------------------------------------------------------------------
+# itk_add_bigio_test_cleanup(<test_name> <output_file> [<output_file2> ...])
+#
+# Adds a cleanup test that removes the given output files after <test_name>
+# passes.  Uses CTest fixtures: the main test is the SETUP, the cleanup
+# test is the CLEANUP.  The cleanup test only runs after the main test
+# succeeds (CTest fixture semantics: CLEANUP runs after all REQUIRED tests,
+# but only if the fixture's SETUP passed).
+#
+# When ITK_REMOVE_BIGIO_FILES_ON_SUCCESS is OFF, no cleanup test is added
+# and the output files are retained for manual inspection.
+#
+function(itk_add_bigio_test_cleanup TEST_NAME)
+  if(NOT ITK_REMOVE_BIGIO_FILES_ON_SUCCESS)
+    return()
+  endif()
+
+  set(FIXTURE_NAME "BigIO_${TEST_NAME}")
+
+  # Make the main test the SETUP of this fixture
+  set_tests_properties(
+    ${TEST_NAME}
+    PROPERTIES
+      FIXTURES_SETUP
+        ${FIXTURE_NAME}
+  )
+
+  # Build the removal command for all output files
+  set(RM_ARGS "")
+  foreach(OUTPUT_FILE ${ARGN})
+    # For .mhd files, also remove the companion .raw/.zraw
+    get_filename_component(EXT "${OUTPUT_FILE}" LAST_EXT)
+    get_filename_component(NAME_WE "${OUTPUT_FILE}" NAME_WLE)
+    get_filename_component(DIR "${OUTPUT_FILE}" DIRECTORY)
+    list(APPEND RM_ARGS "${OUTPUT_FILE}")
+    if("${EXT}" STREQUAL ".mhd")
+      list(APPEND RM_ARGS "${DIR}/${NAME_WE}.raw")
+      list(APPEND RM_ARGS "${DIR}/${NAME_WE}.zraw")
+    endif()
+  endforeach()
+
+  add_test(
+    NAME ${TEST_NAME}_cleanup
+    COMMAND
+      ${CMAKE_COMMAND} -E rm -f ${RM_ARGS}
+  )
+  set_tests_properties(
+    ${TEST_NAME}_cleanup
+    PROPERTIES
+      FIXTURES_CLEANUP
+        ${FIXTURE_NAME}
+      LABELS
+        "BigIO;CLEANUP"
+  )
+endfunction()

Modules/IO/ImageBase/test/CMakeLists.txt

@@ -52,12 +52,6 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 16)
       ${ITK_TEST_OUTPUT_DIR}/itkLargeImageWriteConvertReadTest.mha
       30000L
   )
-  set_tests_properties(
-    itkLargeImageWriteConvertReadTest
-    PROPERTIES
-      RESOURCE_LOCK
-        MEMORY_SIZE
-  )
 
   itk_add_test(
     NAME itkLargeImageWriteReadTest_2D
@@ -67,12 +61,6 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 16)
       ${ITK_TEST_OUTPUT_DIR}/itkLargeImageWriteReadTest_2D.mha
       30000L
   )
-  set_tests_properties(
-    itkLargeImageWriteReadTest_2D
-    PROPERTIES
-      RESOURCE_LOCK
-        MEMORY_SIZE
-  )
 
   itk_add_test(
     NAME itkLargeImageWriteReadTest_3D
@@ -83,11 +71,30 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 16)
       30000L
       4L
   )
+
+  # BigIO tests produce multi-gigabyte files and must run serially
   set_tests_properties(
+    itkLargeImageWriteConvertReadTest
+    itkLargeImageWriteReadTest_2D
     itkLargeImageWriteReadTest_3D
     PROPERTIES
       RESOURCE_LOCK
         MEMORY_SIZE
+      LABELS
+        "BigIO;RUNS_LONG"
+      RUN_SERIAL
+        True
+  )
+
+  # Clean up BigIO output files after successful completion
+  itk_add_bigio_test_cleanup(
+    itkLargeImageWriteConvertReadTest ${ITK_TEST_OUTPUT_DIR}/itkLargeImageWriteConvertReadTest.mha
+  )
+  itk_add_bigio_test_cleanup(
+    itkLargeImageWriteReadTest_2D ${ITK_TEST_OUTPUT_DIR}/itkLargeImageWriteReadTest_2D.mha
+  )
+  itk_add_bigio_test_cleanup(
+    itkLargeImageWriteReadTest_3D ${ITK_TEST_OUTPUT_DIR}/itkLargeImageWriteReadTest_3D.mha
   )
 endif()
 

Modules/IO/Meta/test/CMakeLists.txt

@@ -482,7 +482,7 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       50000L
   )
 
-  # Due to the large memory requirements this tests must be run one by one
+  # Due to the large memory requirements these tests must be run one by one
   set_tests_properties(
     itkLargeMetaImageWriteReadTest1
     itkLargeMetaImageWriteReadTest2
@@ -494,6 +494,8 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
         MEMORY_SIZE
       COST
         10
+      RUN_SERIAL
+        True
   )
   set_property(
     TEST
@@ -519,6 +521,10 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       LABELS
         RUNS_LONG
   )
+  # Clean up BigIO output files after successful completion
+  itk_add_bigio_test_cleanup(itkLargeMetaImageWriteReadTest1 ${ITK_TEST_OUTPUT_DIR}/LargeImage01.mhd)
+  itk_add_bigio_test_cleanup(itkLargeMetaImageWriteReadTest2 ${ITK_TEST_OUTPUT_DIR}/LargeImage02.mhd)
+  itk_add_bigio_test_cleanup(itkLargeMetaImageWriteReadTest3 ${ITK_TEST_OUTPUT_DIR}/LargeImage03.mhd)
 endif()
 
 if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
@@ -532,7 +538,7 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
       70000L
   )
 
-  # Due to the large memory requirements this tests must be run one by one
+  # Due to the large memory requirements this test must be run serially
   set_tests_properties(
     itkLargeMetaImageWriteReadTest4
     PROPERTIES
@@ -542,6 +548,8 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
         MEMORY_SIZE
       COST
         30
+      RUN_SERIAL
+        True
   )
   set_property(
     TEST
@@ -551,12 +559,5 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
       LABELS
         RUNS_LONG
   )
-  set_property(
-    TEST
-      itkLargeMetaImageWriteReadTest4
-    APPEND
-    PROPERTY
-      RUN_SERIAL
-        True
-  )
+  itk_add_bigio_test_cleanup(itkLargeMetaImageWriteReadTest4 ${ITK_TEST_OUTPUT_DIR}/LargeImage04.mhd)
 endif()

Modules/IO/TIFF/test/CMakeLists.txt

@@ -486,7 +486,7 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       50000L
   )
 
-  # Due to the large memory requirements this tests must be run one by one
+  # Due to the large memory requirements these tests must be run one by one
   set_tests_properties(
     itkLargeTIFFImageWriteReadTest1
     itkLargeTIFFImageWriteReadTest2
@@ -496,6 +496,8 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
         BigIO
       RESOURCE_LOCK
         MEMORY_SIZE
+      RUN_SERIAL
+        True
   )
   set_property(
     TEST
@@ -505,14 +507,6 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       LABELS
         RUNS_LONG
   )
-  set_property(
-    TEST
-      itkLargeTIFFImageWriteReadTest1
-    APPEND
-    PROPERTY
-      RUN_SERIAL
-        True
-  )
   set_property(
     TEST
       itkLargeTIFFImageWriteReadTest2
@@ -521,14 +515,6 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       LABELS
         RUNS_LONG
   )
-  set_property(
-    TEST
-      itkLargeTIFFImageWriteReadTest2
-    APPEND
-    PROPERTY
-      RUN_SERIAL
-        True
-  )
   set_property(
     TEST
       itkLargeTIFFImageWriteReadTest3
@@ -537,14 +523,10 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 5)
       LABELS
         RUNS_LONG
   )
-  set_property(
-    TEST
-      itkLargeTIFFImageWriteReadTest3
-    APPEND
-    PROPERTY
-      RUN_SERIAL
-        True
-  )
+  # Clean up BigIO output files after successful completion
+  itk_add_bigio_test_cleanup(itkLargeTIFFImageWriteReadTest1 ${ITK_TEST_OUTPUT_DIR}/LargeImage01.tif)
+  itk_add_bigio_test_cleanup(itkLargeTIFFImageWriteReadTest2 ${ITK_TEST_OUTPUT_DIR}/LargeImage02.tif)
+  itk_add_bigio_test_cleanup(itkLargeTIFFImageWriteReadTest3 ${ITK_TEST_OUTPUT_DIR}/LargeImage03.tif)
 endif()
 
 if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
@@ -558,7 +540,7 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
       70000L
   )
 
-  # Due to the large memory requirements this tests must lock the memory size resource
+  # Due to the large memory requirements this test must be run serially
   set_tests_properties(
     itkLargeTIFFImageWriteReadTest4
     PROPERTIES
@@ -568,6 +550,8 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
         MEMORY_SIZE
       COST
         30
+      RUN_SERIAL
+        True
   )
   set_property(
     TEST
@@ -577,14 +561,7 @@ if("${ITK_COMPUTER_MEMORY_SIZE}" GREATER 12)
       LABELS
         RUNS_LONG
   )
-  set_property(
-    TEST
-      itkLargeTIFFImageWriteReadTest4
-    APPEND
-    PROPERTY
-      RUN_SERIAL
-        True
-  )
+  itk_add_bigio_test_cleanup(itkLargeTIFFImageWriteReadTest4 ${ITK_TEST_OUTPUT_DIR}/LargeImage04.tif)
 endif()
 
 # expand + RGB image