Merge remote-tracking branch 'upstream/main' into triage-6243-rebase

# Conflicts:
#	pyproject.toml

Author: hjmjohnson

CMake/ITKModuleTest.cmake

@@ -11,6 +11,8 @@
 #   KitTests - a list of tests to be included in the test driver
 #   ADDITIONAL_SRC (optional) - additional source files, which don't contain tests
 
+include(ITKWindowsUtf8)
+
 function(CreateTestDriver KIT KIT_LIBS KitTests)
   set(ADDITIONAL_SRC ${ARGN})
   if(EMSCRIPTEN)

CMakeLists.txt

@@ -180,7 +180,6 @@ include(PreventInSourceBuilds)
 include(PreventInBuildInstalls)
 include(ITKModuleMacros)
 include(ITKExternalData)
-include(ITKWindowsUtf8)
 include(ITKModuleTest)
 include(itkCheckSourceTree)
 

Modules/Filtering/ImageGrid/test/itkResampleImageTest7.cxx

@@ -19,6 +19,8 @@
 #include <iostream>
 
 #include "itkAffineTransform.h"
+#include "itkCastImageFilter.h"
+#include "itkPipelineMonitorImageFilter.h"
 #include "itkResampleImageFilter.h"
 #include "itkStreamingImageFilter.h"
 #include "itkTestingMacros.h"
@@ -79,8 +81,13 @@ itkResampleImageTest7(int, char *[])
   ITK_EXERCISE_BASIC_OBJECT_METHODS(resample, ResampleImageFilter, ImageToImageFilter);
   resample->SetInterpolator(interp);
 
-  resample->SetInput(image);
-  ITK_TEST_SET_GET_VALUE(image.GetPointer(), resample->GetInput());
+  const auto upstream = itk::CastImageFilter<ImageType, ImageType>::New();
+  upstream->SetInput(image);
+  using MonitorType = itk::PipelineMonitorImageFilter<ImageType>;
+  const auto monitor = MonitorType::New();
+  monitor->SetInput(upstream->GetOutput());
+  resample->SetInput(monitor->GetOutput());
+  ITK_TEST_SET_GET_VALUE(monitor->GetOutput(), resample->GetInput());
 
   resample->SetSize(size);
   ITK_TEST_SET_GET_VALUE(size, resample->GetSize());
@@ -109,12 +116,20 @@ itkResampleImageTest7(int, char *[])
   const ImagePointerType outputNoSDI = streamer->GetOutput(); // save output for later comparison
   outputNoSDI->DisconnectPipeline();                          // disconnect to create new output
 
-  // Run the resampling filter with streaming
+  monitor->ClearPipelineSavedInformation();
+
   image->Modified();
-  numStreamDiv = 8; // split into numStream pieces for streaming.
+  numStreamDiv = 8;
   streamer->SetNumberOfStreamDivisions(numStreamDiv);
   ITK_TRY_EXPECT_NO_EXCEPTION(streamer->UpdateLargestPossibleRegion());
 
+  if (!monitor->VerifyInputFilterExecutedStreaming(static_cast<int>(numStreamDiv)))
+  {
+    std::cerr << "Streaming did not chunk the input as expected." << std::endl;
+    std::cerr << monitor;
+    return EXIT_FAILURE;
+  }
+
   // Verify that we only requested a smaller chunk when streaming
   const ImageRegionType finalRequestedRegion(image->GetRequestedRegion());
   ITK_TEST_SET_GET_VALUE(0, finalRequestedRegion.GetIndex(0));

Modules/Filtering/ImageGrid/test/itkWarpImageFilterTest.cxx

@@ -21,6 +21,7 @@
 #include "itkMath.h"
 #include "itkWarpImageFilter.h"
 #include "itkCastImageFilter.h"
+#include "itkPipelineMonitorImageFilter.h"
 #include "itkStreamingImageFilter.h"
 #include "itkVectorImage.h"
 #include "itkTestingMacros.h"
@@ -318,23 +319,35 @@ itkWarpImageFilterTest(int, char *[])
 
   std::cout << "Run ExpandImageFilter with streamer" << std::endl;
 
+  // Streaming verified on displacement-field input only; WarpImageFilter requests the full image input.
   using VectorCasterType = itk::CastImageFilter<FieldType, FieldType>;
   auto vcaster = VectorCasterType::New();
-
   vcaster->SetInput(warper->GetDisplacementField());
 
+  using FieldMonitorType = itk::PipelineMonitorImageFilter<FieldType>;
+  auto vmonitor = FieldMonitorType::New();
+  vmonitor->SetInput(vcaster->GetOutput());
+
   auto warper2 = WarperType::New();
 
   warper2->SetInput(warper->GetInput());
-  warper2->SetDisplacementField(vcaster->GetOutput());
+  warper2->SetDisplacementField(vmonitor->GetOutput());
   warper2->SetEdgePaddingValue(warper->GetEdgePaddingValue());
 
   using StreamerType = itk::StreamingImageFilter<ImageType, ImageType>;
   auto streamer = StreamerType::New();
   streamer->SetInput(warper2->GetOutput());
-  streamer->SetNumberOfStreamDivisions(3);
+  constexpr int numStreamDivisions = 3;
+  streamer->SetNumberOfStreamDivisions(numStreamDivisions);
   streamer->Update();
 
+  if (!vmonitor->VerifyInputFilterExecutedStreaming(numStreamDivisions))
+  {
+    std::cerr << "Displacement field did not stream as expected." << std::endl;
+    std::cerr << vmonitor;
+    return EXIT_FAILURE;
+  }
+
   std::cout << "Compare standalone and streamed outputs" << std::endl;
 
   Iterator streamIter(streamer->GetOutput(), streamer->GetOutput()->GetBufferedRegion());

Modules/Filtering/ImageGrid/test/itkWarpVectorImageFilterTest.cxx

@@ -20,6 +20,7 @@
 
 #include "itkWarpVectorImageFilter.h"
 #include "itkCastImageFilter.h"
+#include "itkPipelineMonitorImageFilter.h"
 #include "itkStreamingImageFilter.h"
 #include "itkTestingMacros.h"
 
@@ -297,18 +298,31 @@ itkWarpVectorImageFilterTest(int, char *[])
 
   vcaster->SetInput(warper->GetDisplacementField());
 
+  // Streaming verified on displacement-field input only; WarpVectorImageFilter requests the full image input.
+  using FieldMonitorType = itk::PipelineMonitorImageFilter<FieldType>;
+  auto vmonitor = FieldMonitorType::New();
+  vmonitor->SetInput(vcaster->GetOutput());
+
   auto warper2 = WarperType::New();
 
   warper2->SetInput(warper->GetInput());
-  warper2->SetDisplacementField(vcaster->GetOutput());
+  warper2->SetDisplacementField(vmonitor->GetOutput());
   warper2->SetEdgePaddingValue(warper->GetEdgePaddingValue());
 
   using StreamerType = itk::StreamingImageFilter<ImageType, ImageType>;
   auto streamer = StreamerType::New();
   streamer->SetInput(warper2->GetOutput());
-  streamer->SetNumberOfStreamDivisions(3);
+  constexpr int numStreamDivisions = 3;
+  streamer->SetNumberOfStreamDivisions(numStreamDivisions);
   streamer->Update();
 
+  if (!vmonitor->VerifyInputFilterExecutedStreaming(numStreamDivisions))
+  {
+    std::cerr << "Displacement field did not stream as expected." << std::endl;
+    std::cerr << vmonitor;
+    return EXIT_FAILURE;
+  }
+
   std::cout << "Compare standalone and streamed outputs" << std::endl;
 
   Iterator streamIter(streamer->GetOutput(), streamer->GetOutput()->GetBufferedRegion());

Modules/Numerics/PrincipalComponentsAnalysis/CMakeLists.txt

@@ -0,0 +1,3 @@
+project(PrincipalComponentsAnalysis)
+
+itk_module_impl()

Modules/Numerics/PrincipalComponentsAnalysis/README.md

@@ -0,0 +1,24 @@
+# PrincipalComponentsAnalysis
+
+In-tree ITK module providing a principal component analysis filter for
+scalar, vector, and mesh-vertex data. The flagship class is
+`itk::VectorFieldPCA`, which computes the principal components of an
+ensemble of vector fields defined on a common mesh, useful for
+shape-modeling and multivariate statistics workflows.
+
+## Origin
+
+Ingested from the standalone remote module
+[**InsightSoftwareConsortium/ITKPrincipalComponentsAnalysis**](https://github.com/InsightSoftwareConsortium/ITKPrincipalComponentsAnalysis)
+on 2026-05-08, following the v4 ingestion guidelines defined in
+InsightSoftwareConsortium/ITK#6204. The upstream repository will be
+archived read-only after this PR merges; it remains reachable at the
+URL above for historical reference (notably the `doc/` and
+`examples/` directories, which were intentionally left in the
+upstream archive).
+
+## References
+
+- Bowers M., Younes L. *Principal Components Analysis of Scalar,
+  Vector, and Mesh Vertex Data.* The Insight Journal. August, 2013.
+  <https://doi.org/10.54294/loekqj>