fix: preserve original image resolution when empty dimensions are specified

Author: Bob Strahan

CHANGELOG.md

@@ -28,6 +28,7 @@ SPDX-License-Identifier: MIT-0
   - Updated all lambda functions and notebooks to use new simplified pattern
 
 ### Fixed
+- Fixed issue where empty image configuration were incorrectly resizing images to default 951x1268 pixels instead of preserving original resolution
 - Fixed issue where PNG files were being unnecessarily converted to JPEG format and resized to lower resolution with lost quality
 - Fixed issue where PNG and JPG image files were not rendering inline in the Document Details page
 - Fixed issue where PDF files were being downloaded instead of displayed inline

docs/assessment.md

@@ -536,49 +536,76 @@ StateTaxes[0]:
 
 The assessment service supports configurable image dimensions for optimal confidence evaluation:
 
-### Default Configuration
+### New Default Behavior (Preserves Original Resolution)
+
+**Important Change**: Empty strings or unspecified image dimensions now preserve the original document resolution for maximum assessment accuracy:
 
 ```yaml
 assessment:
   model: "anthropic.claude-3-5-sonnet-20241022-v2:0"
-  # Image processing settings
+  # Image processing settings - preserves original resolution
   image:
-    target_width: 951    # Default width in pixels
-    target_height: 1268  # Default height in pixels
+    target_width: ""     # Empty string = no resizing (recommended)
+    target_height: ""    # Empty string = no resizing (recommended)
 ```
 
 ### Custom Image Dimensions
 
-Configure image dimensions based on assessment requirements:
+Configure specific dimensions when performance optimization is needed:
 
 ```yaml
-# For detailed visual assessment
+# For detailed visual assessment with controlled dimensions
 assessment:
   image:
-    target_width: 1200
-    target_height: 1600
+    target_width: "1200"   # Resize to 1200 pixels wide
+    target_height: "1600"  # Resize to 1600 pixels tall
 
 # For standard confidence evaluation
 assessment:
   image:
-    target_width: 800
-    target_height: 1000
+    target_width: "800"    # Smaller for faster processing
+    target_height: "1000"  # Maintains good quality
 ```
 
 ### Image Resizing Features for Assessment
 
-- **Aspect Ratio Preservation**: Images maintain proportions for accurate visual analysis
+- **Original Resolution Preservation**: Empty strings preserve full document resolution for maximum assessment accuracy
+- **Aspect Ratio Preservation**: Images maintain proportions for accurate visual analysis when dimensions are specified
 - **Smart Scaling**: Only downsizes when necessary to preserve visual detail
 - **High-Quality Resampling**: Better image quality for confidence assessment
-- **Performance Optimization**: Optimized images reduce assessment processing time
+- **Performance Optimization**: Configurable dimensions allow balancing accuracy vs. speed
 
 ### Configuration Benefits for Assessment
 
-- **Enhanced Visual Analysis**: Appropriate resolution improves confidence evaluation accuracy
+- **Maximum Assessment Accuracy**: Empty strings preserve full document resolution for best confidence evaluation
+- **Enhanced Visual Analysis**: Original resolution improves confidence evaluation accuracy
 - **Better OCR Verification**: Higher quality images help verify extraction results against visual content
 - **Improved Confidence Scoring**: Better image quality leads to more accurate confidence assessments
 - **Service-Specific Tuning**: Optimize image dimensions for different assessment complexity levels
-- **Resource Optimization**: Balance assessment quality and processing costs
+- **Resource Optimization**: Choose between accuracy (original resolution) and performance (smaller dimensions)
+
+### Migration from Previous Versions
+
+**Previous Behavior**: Empty strings defaulted to 951x1268 pixel resizing
+**New Behavior**: Empty strings preserve original image resolution
+
+If you were relying on the previous default resizing behavior, explicitly set dimensions:
+
+```yaml
+# To maintain previous default behavior
+assessment:
+  image:
+    target_width: "951"
+    target_height: "1268"
+```
+
+### Best Practices for Assessment
+
+1. **Use Empty Strings for High Accuracy**: For critical confidence assessment, use empty strings to preserve original resolution
+2. **Consider Assessment Complexity**: Complex documents with fine details benefit from higher resolution
+3. **Test Assessment Quality**: Evaluate confidence assessment accuracy with your specific document types
+4. **Monitor Resource Usage**: Higher resolution images consume more memory and processing time
+5. **Balance Accuracy vs Performance**: Choose appropriate settings based on your assessment requirements and processing volume
 
 ## Granular Assessment
 

docs/classification.md

@@ -341,49 +341,75 @@ For comprehensive details on configuring few-shot examples, including multimodal
 
 The classification service supports configurable image dimensions for optimal performance and quality:
 
-### Default Configuration
+### New Default Behavior (Preserves Original Resolution)
+
+**Important Change**: Empty strings or unspecified image dimensions now preserve the original document resolution for maximum classification accuracy:
 
 ```yaml
 classification:
   model: us.amazon.nova-pro-v1:0
-  # Image processing settings
+  # Image processing settings - preserves original resolution
   image:
-    target_width: 951    # Default width in pixels
-    target_height: 1268  # Default height in pixels
+    target_width: ""     # Empty string = no resizing (recommended)
+    target_height: ""    # Empty string = no resizing (recommended)
 ```
 
 ### Custom Image Dimensions
 
-Configure image dimensions based on your specific requirements:
+Configure specific dimensions when performance optimization is needed:
 
 ```yaml
-# For high-accuracy classification
+# For high-accuracy classification with controlled dimensions
 classification:
   image:
-    target_width: 1200
-    target_height: 1600
+    target_width: "1200"   # Resize to 1200 pixels wide
+    target_height: "1600"  # Resize to 1600 pixels tall
 
 # For fast processing with lower resolution
 classification:
   image:
-    target_width: 600
-    target_height: 800
+    target_width: "600"    # Smaller for faster processing
+    target_height: "800"   # Maintains reasonable quality
 ```
 
 ### Image Resizing Features
 
-- **Aspect Ratio Preservation**: Images are resized proportionally without distortion
+- **Original Resolution Preservation**: Empty strings preserve full document resolution for maximum accuracy
+- **Aspect Ratio Preservation**: Images are resized proportionally without distortion when dimensions are specified
 - **Smart Scaling**: Only downsizes images when necessary (scale factor < 1.0)
 - **High-Quality Resampling**: Better visual quality after resizing
-- **Performance Optimization**: Smaller, optimized images process faster with lower memory usage
+- **Performance Optimization**: Configurable dimensions allow balancing accuracy vs. speed
 
 ### Configuration Benefits
 
+- **Maximum Classification Accuracy**: Empty strings preserve full document resolution for best results
 - **Service-Specific Tuning**: Each service can use optimal image dimensions
 - **Runtime Configuration**: No code changes needed to adjust image processing
-- **Backward Compatibility**: Default values maintain existing behavior
-- **Memory Optimization**: Configurable dimensions allow memory optimization
-- **Better Resource Utilization**: Service-specific sizing reduces unnecessary processing
+- **Backward Compatibility**: Existing numeric values continue to work as before
+- **Memory Optimization**: Configurable dimensions allow resource optimization
+- **Better Resource Utilization**: Choose between accuracy (original resolution) and performance (smaller dimensions)
+
+### Migration from Previous Versions
+
+**Previous Behavior**: Empty strings defaulted to 951x1268 pixel resizing
+**New Behavior**: Empty strings preserve original image resolution
+
+If you were relying on the previous default resizing behavior, explicitly set dimensions:
+
+```yaml
+# To maintain previous default behavior
+classification:
+  image:
+    target_width: "951"
+    target_height: "1268"
+```
+
+### Best Practices for Classification
+
+1. **Use Empty Strings for High Accuracy**: For critical document classification, use empty strings to preserve original resolution
+2. **Consider Document Types**: Complex layouts benefit from higher resolution, simple text documents may work well with smaller dimensions
+3. **Test Performance Impact**: Higher resolution images provide better accuracy but consume more resources
+4. **Monitor Processing Time**: Balance classification accuracy with processing speed based on your requirements
 
 ## JSON and YAML Output Support
 

docs/configuration.md

@@ -241,6 +241,87 @@ The solution includes built-in cost tracking capabilities:
 
 For detailed cost analysis and optimization strategies, see [cost-calculator.md](cost-calculator.md).
 
+## Image Processing Configuration
+
+The solution supports configurable image dimensions across all processing services (OCR, classification, extraction, and assessment) to optimize performance and accuracy for different document types.
+
+### New Default Behavior (Preserves Original Resolution)
+
+**Important Change**: As of the latest version, empty strings or unspecified image dimensions now preserve the original document resolution instead of resizing to default dimensions.
+
+```yaml
+# Preserves original image resolution (recommended for high-accuracy processing)
+classification:
+  image:
+    target_width: ""     # Empty string = no resizing
+    target_height: ""    # Empty string = no resizing
+
+extraction:
+  image:
+    target_width: ""     # Preserves original resolution
+    target_height: ""    # Preserves original resolution
+
+assessment:
+  image:
+    target_width: ""     # No resizing applied
+    target_height: ""    # No resizing applied
+```
+
+### Custom Image Dimensions
+
+You can still specify exact dimensions when needed for performance optimization:
+
+```yaml
+# Custom dimensions for specific requirements
+classification:
+  image:
+    target_width: "1200"   # Resize to 1200 pixels wide
+    target_height: "1600"  # Resize to 1600 pixels tall
+
+# Performance-optimized dimensions
+extraction:
+  image:
+    target_width: "800"    # Smaller for faster processing
+    target_height: "1000"  # Maintains good quality
+```
+
+### Image Resizing Features
+
+- **Aspect Ratio Preservation**: Images are resized proportionally without distortion
+- **Smart Scaling**: Only downsizes images when necessary (scale factor < 1.0)
+- **High-Quality Resampling**: Better visual quality after resizing
+- **Original Format Preservation**: Maintains PNG, JPEG, and other formats when possible
+
+### Configuration Benefits
+
+- **High-Resolution Processing**: Empty strings preserve full document resolution for maximum OCR accuracy
+- **Service-Specific Tuning**: Each service can use optimal image dimensions
+- **Runtime Configuration**: No code changes needed to adjust image processing
+- **Backward Compatibility**: Existing numeric values continue to work as before
+- **Memory Optimization**: Configurable dimensions allow resource optimization
+
+### Best Practices
+
+1. **Use Empty Strings for High Accuracy**: For critical documents requiring maximum OCR accuracy, use empty strings to preserve original resolution
+2. **Specify Dimensions for Performance**: For high-volume processing, consider smaller dimensions to improve speed
+3. **Test Different Settings**: Evaluate the trade-off between accuracy and performance for your specific document types
+4. **Monitor Resource Usage**: Higher resolution images consume more memory and processing time
+
+### Migration from Previous Versions
+
+**Previous Behavior**: Empty strings defaulted to 951x1268 pixel resizing
+**New Behavior**: Empty strings preserve original image resolution
+
+If you were relying on the previous default resizing behavior, explicitly set dimensions:
+
+```yaml
+# To maintain previous default behavior
+classification:
+  image:
+    target_width: "951"
+    target_height: "1268"
+```
+
 ## Additional Configuration Resources
 
 The solution provides additional configuration options through:

docs/extraction.md

@@ -403,50 +403,77 @@ Examples are class-specific - only examples from the same document class being p
 
 The extraction service supports configurable image dimensions for optimal performance and quality:
 
-### Default Configuration
+### New Default Behavior (Preserves Original Resolution)
+
+**Important Change**: Empty strings or unspecified image dimensions now preserve the original document resolution for maximum extraction accuracy:
 
 ```yaml
 extraction:
   model: us.amazon.nova-pro-v1:0
-  # Image processing settings
+  # Image processing settings - preserves original resolution
   image:
-    target_width: 951    # Default width in pixels
-    target_height: 1268  # Default height in pixels
+    target_width: ""     # Empty string = no resizing (recommended)
+    target_height: ""    # Empty string = no resizing (recommended)
 ```
 
 ### Custom Image Dimensions
 
-Configure image dimensions based on your extraction requirements:
+Configure specific dimensions when performance optimization is needed:
 
 ```yaml
-# For high-accuracy extraction with detailed visual analysis
+# For high-accuracy extraction with controlled dimensions
 extraction:
   image:
-    target_width: 1200
-    target_height: 1600
+    target_width: "1200"   # Resize to 1200 pixels wide
+    target_height: "1600"  # Resize to 1600 pixels tall
 
 # For fast processing with standard resolution
 extraction:
   image:
-    target_width: 800
-    target_height: 1000
+    target_width: "800"    # Smaller for faster processing
+    target_height: "1000"  # Maintains good quality
 ```
 
 ### Image Resizing Features
 
-- **Aspect Ratio Preservation**: Images are resized proportionally without distortion
+- **Original Resolution Preservation**: Empty strings preserve full document resolution for maximum extraction accuracy
+- **Aspect Ratio Preservation**: Images are resized proportionally without distortion when dimensions are specified
 - **Smart Scaling**: Only downsizes images when necessary (scale factor < 1.0)
 - **High-Quality Resampling**: Better visual quality after resizing for improved field detection
-- **Performance Optimization**: Optimized images reduce processing time and memory usage
+- **Performance Optimization**: Configurable dimensions allow balancing accuracy vs. speed
 
 ### Configuration Benefits for Extraction
 
-- **Enhanced Field Detection**: Appropriate image resolution improves accuracy for table and form extraction
-- **Visual Element Processing**: Better handling of signatures, stamps, checkboxes, and visual indicators
+- **Maximum Extraction Accuracy**: Empty strings preserve full document resolution for best field detection
+- **Enhanced Field Detection**: Original resolution improves accuracy for table and form extraction
+- **Visual Element Processing**: Better handling of signatures, stamps, checkboxes, and visual indicators at full resolution
 - **OCR Error Correction**: Higher quality images help verify and correct text extraction results
 - **Service-Specific Tuning**: Optimize image dimensions for different document types and extraction complexity
 - **Runtime Configuration**: Adjust image processing without code changes
-- **Resource Optimization**: Balance quality and performance based on extraction requirements
+- **Resource Optimization**: Choose between accuracy (original resolution) and performance (smaller dimensions)
+
+### Migration from Previous Versions
+
+**Previous Behavior**: Empty strings defaulted to 951x1268 pixel resizing
+**New Behavior**: Empty strings preserve original image resolution
+
+If you were relying on the previous default resizing behavior, explicitly set dimensions:
+
+```yaml
+# To maintain previous default behavior
+extraction:
+  image:
+    target_width: "951"
+    target_height: "1268"
+```
+
+### Best Practices for Extraction
+
+1. **Use Empty Strings for High Accuracy**: For critical data extraction, use empty strings to preserve original resolution
+2. **Consider Document Complexity**: Forms and tables benefit significantly from higher resolution
+3. **Test with Representative Documents**: Evaluate extraction accuracy with your specific document types
+4. **Monitor Resource Usage**: Higher resolution images consume more memory and processing time
+5. **Balance Accuracy vs Performance**: Choose appropriate settings based on your accuracy requirements and processing volume
 
 ## JSON and YAML Output Support