solarwindpy 0.0.1.dev0__py3-none-any.whl → 0.1.0__py3-none-any.whl

plans/completed/combined_test_plan_with_checklist_plotting/15-visual-validation.md

@@ -0,0 +1,256 @@
+---
+name: 'Combined Plan and Checklist: Visual Validation Framework'
+about: Visual validation framework for matplotlib plot output verification.
+labels: [sweep, plotting, visual_validation, matplotlib, image_comparison]
+---
+
+> Phase 16 of Enhanced Plotting Test Plan - Advanced Testing Framework
+
+## 🧠 Context
+
+Visual validation is critical for plotting libraries as it ensures that generated plots not only execute without error but also produce the expected visual output. This phase establishes a comprehensive visual validation framework using matplotlib's image comparison capabilities to detect regressions in plot appearance, layout, and rendering.
+
+### Key Components
+- **Image Comparison Framework**: Automated comparison against reference images
+- **Baseline Generation**: System for creating and managing reference plots
+- **Tolerance Management**: Configurable pixel difference tolerance
+- **Cross-Platform Compatibility**: Consistent rendering across operating systems
+- **Regression Detection**: Automated detection of visual changes
+
+### Technical Requirements
+- **Matplotlib Testing**: Uses `matplotlib.testing.decorators.image_comparison`
+- **Reference Images**: Baseline images stored in `tests/plotting/baseline_images/`
+- **Headless Operation**: Tests run without GUI dependencies
+- **Format Support**: PNG format for consistent cross-platform comparison
+
+## 📋 Comprehensive Test Checklist
+
+### 16.1 Framework Infrastructure
+
+#### Test environment setup
+- [ ] **Headless matplotlib**: Configure matplotlib for headless operation
+- [ ] **Backend selection**: Use consistent matplotlib backend (Agg)
+- [ ] **DPI consistency**: Fixed DPI settings for reproducible rendering
+- [ ] **Font management**: Consistent font rendering across platforms
+- [ ] **Color consistency**: Reproducible color rendering
+
+#### Directory structure
+- [ ] **Baseline directory**: `tests/plotting/baseline_images/` created
+- [ ] **Test organization**: Baseline images organized by module/function
+- [ ] **Version control**: Baseline images tracked in version control
+- [ ] **Platform variants**: Platform-specific baselines if needed
+- [ ] **Cleanup procedures**: Old/unused baseline cleanup process
+
+### 16.2 Image Comparison Implementation
+
+#### Comparison decorators
+- [ ] **@image_comparison**: Proper use of matplotlib's image comparison
+- [ ] **Tolerance settings**: Appropriate pixel difference tolerance
+- [ ] **File naming**: Consistent baseline image naming convention
+- [ ] **Multi-image tests**: Support for tests generating multiple plots
+- [ ] **Extension handling**: Proper file extension management (.png)
+
+#### Comparison configuration
+- [ ] **Tolerance levels**: Different tolerance for different plot types
+- [ ] **Pixel differences**: Acceptable pixel difference thresholds
+- [ ] **Color tolerance**: RGB color difference tolerances
+- [ ] **Anti-aliasing**: Handle anti-aliasing differences consistently
+- [ ] **Text rendering**: Consistent text rendering comparison
+
+### 16.3 Baseline Image Management
+
+#### Baseline generation
+- [ ] **Initial generation**: Process for creating initial baseline images
+- [ ] **Regeneration workflow**: Process for updating baselines when needed
+- [ ] **Version tracking**: Track baseline image versions with code changes
+- [ ] **Review process**: Manual review process for baseline changes
+- [ ] **Documentation**: Document when and why baselines change
+
+#### Quality standards
+- [ ] **Image quality**: High-quality baseline images
+- [ ] **Completeness**: Baselines cover all visual elements
+- [ ] **Representativeness**: Baselines represent typical use cases
+- [ ] **Edge case coverage**: Baselines for edge cases and boundary conditions
+- [ ] **Scientific accuracy**: Baselines scientifically correct
+
+### 16.4 Cross-Platform Consistency
+
+#### Platform compatibility
+- [ ] **Operating system**: Consistent rendering across Windows, macOS, Linux
+- [ ] **Python versions**: Consistent across supported Python versions
+- [ ] **Matplotlib versions**: Handle matplotlib version differences
+- [ ] **Font differences**: Manage platform-specific font differences
+- [ ] **DPI scaling**: Handle different DPI settings consistently
+
+#### Environment standardization
+- [ ] **Docker support**: Containerized testing environment for consistency
+- [ ] **CI/CD integration**: Visual tests run in continuous integration
+- [ ] **Local testing**: Visual tests work in local development environments
+- [ ] **Dependency management**: Consistent dependency versions for rendering
+
+### 16.5 Plot Type Coverage
+
+#### Core plotting functionality
+- [ ] **Scatter plots**: Visual validation for scatter plot output
+- [ ] **Line plots**: Visual validation for line plot rendering
+- [ ] **Histograms**: Visual validation for histogram appearance
+- [ ] **2D histograms**: Visual validation for 2D histogram rendering
+- [ ] **Color maps**: Visual validation for color mapping accuracy
+
+#### Advanced plotting features
+- [ ] **Subplots**: Visual validation for subplot layouts
+- [ ] **Color bars**: Visual validation for color bar rendering
+- [ ] **Labels**: Visual validation for axis labels and titles
+- [ ] **Legends**: Visual validation for legend appearance
+- [ ] **Annotations**: Visual validation for text annotations
+
+#### Specialized plots
+- [ ] **Spiral plots**: Visual validation for spiral mesh rendering
+- [ ] **Orbit plots**: Visual validation for orbital trajectory plots
+- [ ] **Scientific notation**: Visual validation for mathematical notation
+- [ ] **Custom markers**: Visual validation for custom plot markers
+- [ ] **Error bars**: Visual validation for error bar rendering
+
+### 16.6 Test Data and Fixtures
+
+#### Standardized test data
+- [ ] **Consistent datasets**: Standard datasets for visual testing
+- [ ] **Reproducible data**: Deterministic data generation for consistency
+- [ ] **Edge case data**: Test data covering edge cases
+- [ ] **Scientific data**: Realistic scientific datasets for validation
+- [ ] **Data fixtures**: Reusable data fixtures for visual tests
+
+#### Plot configuration
+- [ ] **Standard settings**: Consistent plot settings across tests
+- [ ] **Color schemes**: Standard color schemes for testing
+- [ ] **Font settings**: Consistent font settings for text rendering
+- [ ] **Size standards**: Standard plot sizes for comparison
+- [ ] **Style consistency**: Consistent plot styles across tests
+
+### 16.7 Regression Detection
+
+#### Change detection
+- [ ] **Pixel differences**: Detect pixel-level changes in plot output
+- [ ] **Layout changes**: Detect changes in plot layout and positioning
+- [ ] **Color changes**: Detect changes in color rendering
+- [ ] **Text changes**: Detect changes in text rendering and positioning
+- [ ] **Symbol changes**: Detect changes in plot symbols and markers
+
+#### Failure analysis
+- [ ] **Difference reporting**: Clear reporting of visual differences
+- [ ] **Difference highlighting**: Visual highlighting of changed regions
+- [ ] **Failure categorization**: Categorize types of visual failures
+- [ ] **Failure severity**: Assess severity of visual changes
+- [ ] **Manual review**: Process for manual review of failures
+
+### 16.8 Performance Considerations
+
+#### Test execution speed
+- [ ] **Efficient rendering**: Optimize visual test execution speed
+- [ ] **Parallel execution**: Run visual tests in parallel where possible
+- [ ] **Selective testing**: Run visual tests selectively based on changes
+- [ ] **Caching**: Cache rendering results where appropriate
+- [ ] **Resource usage**: Manage memory usage during visual testing
+
+#### CI/CD optimization
+- [ ] **Fast feedback**: Quick visual test feedback in CI/CD
+- [ ] **Artifact management**: Efficient handling of baseline images
+- [ ] **Storage optimization**: Optimize storage of baseline images
+- [ ] **Network efficiency**: Efficient transfer of image files
+- [ ] **Build optimization**: Optimize build process for visual tests
+
+### 16.9 Error Handling and Debugging
+
+#### Test failures
+- [ ] **Clear error messages**: Informative error messages for visual failures
+- [ ] **Debugging output**: Helpful debugging information for failures
+- [ ] **Image diff output**: Generate difference images for failed tests
+- [ ] **Log integration**: Integration with logging systems
+- [ ] **Failure recovery**: Graceful handling of rendering failures
+
+#### Development workflow
+- [ ] **Local debugging**: Easy debugging of visual tests locally
+- [ ] **Interactive comparison**: Tools for interactive comparison of images
+- [ ] **Batch updates**: Efficient batch updating of baseline images
+- [ ] **Review tools**: Tools for reviewing baseline changes
+- [ ] **Documentation**: Clear documentation of debugging procedures
+
+### 16.10 Integration with Test Suite
+
+#### Test organization
+- [ ] **Test markers**: Proper pytest markers for visual tests
+- [ ] **Test selection**: Easy selection/deselection of visual tests
+- [ ] **Test dependencies**: Proper handling of test dependencies
+- [ ] **Test isolation**: Visual tests properly isolated
+- [ ] **Test reporting**: Integration with test reporting systems
+
+#### Continuous integration
+- [ ] **CI configuration**: Visual tests properly configured in CI
+- [ ] **Artifact storage**: Baseline images properly stored/retrieved
+- [ ] **Failure reporting**: Clear reporting of visual test failures
+- [ ] **Manual triggers**: Manual triggers for baseline updates
+- [ ] **Branch protection**: Protect against accidental baseline changes
+
+### 16.11 Documentation and Training
+
+#### Framework documentation
+- [ ] **Usage guide**: Clear guide for using visual validation framework
+- [ ] **Best practices**: Best practices for creating visual tests
+- [ ] **Troubleshooting**: Troubleshooting guide for common issues
+- [ ] **Examples**: Working examples of visual tests
+- [ ] **API reference**: Complete API reference for framework
+
+#### Developer training
+- [ ] **Onboarding**: Onboarding process for new developers
+- [ ] **Workflow guide**: Guide for visual test development workflow
+- [ ] **Review process**: Process for reviewing visual changes
+- [ ] **Maintenance**: Guide for maintaining visual tests
+- [ ] **Updates**: Process for updating framework and baselines
+
+### 16.12 Quality Assurance
+
+#### Test quality
+- [ ] **Coverage analysis**: Analysis of visual test coverage
+- [ ] **Quality metrics**: Metrics for visual test quality
+- [ ] **Regular review**: Regular review of visual test effectiveness
+- [ ] **Baseline quality**: Regular review of baseline image quality
+- [ ] **Framework evolution**: Evolution of framework capabilities
+
+#### Scientific validation
+- [ ] **Accuracy verification**: Verify visual accuracy of scientific plots
+- [ ] **Publication quality**: Ensure plots meet publication standards
+- [ ] **Scientific review**: Scientific review of visual test baselines
+- [ ] **Domain expertise**: Integration of domain expertise in visual validation
+- [ ] **Standards compliance**: Compliance with scientific plotting standards
+
+## 🎯 Testing Strategy
+
+### Implementation Phases
+1. **Framework Setup**: Establish basic visual comparison infrastructure
+2. **Core Coverage**: Create visual tests for core plotting functionality
+3. **Advanced Features**: Add visual tests for specialized features
+4. **CI/CD Integration**: Integrate with continuous integration systems
+
+### Quality Metrics
+- **Coverage**: Percentage of plotting functions with visual tests
+- **Accuracy**: Pixel difference tolerance levels maintained
+- **Reliability**: Consistency of visual tests across platforms
+- **Performance**: Visual test execution time benchmarks
+
+### Success Criteria
+- Visual tests catch plot rendering regressions
+- Framework works consistently across development environments
+- Baseline management process efficient and reliable
+- Visual validation integrated into development workflow
+
+---
+
+**Estimated Time**: 4 hours  
+**Dependencies**: Matplotlib testing framework, CI/CD infrastructure  
+**Priority**: HIGH (Critical for plot quality assurance)
+
+**Status**: ✅ COMPLETED
+**Commit**: d097473
+**Tests Added**: 16 visual validation test cases
+**Time Invested**: 4 hours
+**Test Results**: 16/16 passing (100% success rate)

plans/completed/combined_test_plan_with_checklist_plotting/16-integration-testing.md

@@ -0,0 +1,266 @@
+---
+name: 'Combined Plan and Checklist: Integration Testing'
+about: End-to-end integration testing for complete plotting workflows.
+labels: [sweep, plotting, integration_testing, workflows, end_to_end]
+---
+
+> Phase 17 of Enhanced Plotting Test Plan - Advanced Testing Framework
+
+## 🧠 Context
+
+Integration testing validates that all plotting components work together correctly in realistic usage scenarios. This phase focuses on end-to-end workflows that combine multiple plotting modules, data processing, and output generation to ensure the complete plotting system functions as expected in scientific research contexts.
+
+### Key Components
+- **Workflow Testing**: Complete data-to-plot workflows
+- **Module Integration**: Cross-module functionality validation
+- **Real Data Testing**: Testing with authentic scientific datasets
+- **Output Validation**: Comprehensive output format and quality validation
+- **Error Recovery**: Testing error handling across the entire stack
+
+### Scientific Context
+- **Data Pipeline Integration**: From raw data to publication-ready plots
+- **Multi-Plot Workflows**: Complex plotting scenarios with multiple visualizations
+- **Interactive Features**: Testing interactive plotting capabilities
+- **Export Workflows**: Complete export and save functionality testing
+
+## 📋 Comprehensive Test Checklist
+
+### 17.1 Workflow Integration Framework
+
+#### Test architecture
+- [ ] **End-to-end test structure**: Comprehensive workflow test organization
+- [ ] **Test data pipeline**: Realistic data flow from input to output
+- [ ] **Component orchestration**: Proper integration of all plotting components
+- [ ] **State management**: Correct handling of state across workflow steps
+- [ ] **Resource cleanup**: Proper cleanup of temporary files and resources
+
+#### Test environment
+- [ ] **Isolated environments**: Tests run in isolated environments
+- [ ] **Dependency management**: All required dependencies available
+- [ ] **Configuration management**: Consistent configuration across tests
+- [ ] **Temporary directories**: Proper temporary directory management
+- [ ] **Environment variables**: Correct environment variable handling
+
+### 17.2 Data-to-Plot Workflows
+
+#### Complete plotting workflows
+- [ ] **Raw data input**: Processing from raw scientific data files
+- [ ] **Data preprocessing**: Integration with data preprocessing steps
+- [ ] **Plot generation**: Complete plot generation workflows
+- [ ] **Output formatting**: Proper output formatting and styling
+- [ ] **File export**: Complete export workflows to various formats
+
+#### Multi-step processes
+- [ ] **Data loading**: Realistic data loading from various sources
+- [ ] **Data validation**: Data validation integrated into workflows
+- [ ] **Plot configuration**: Dynamic plot configuration based on data
+- [ ] **Multiple outputs**: Workflows generating multiple plot outputs
+- [ ] **Batch processing**: Batch processing of multiple datasets
+
+### 17.3 Cross-Module Integration
+
+#### Module interaction testing
+- [ ] **Base-derived interactions**: Base classes with derived implementations
+- [ ] **Label system integration**: Labels working across different plot types
+- [ ] **Color system integration**: Consistent color handling across modules
+- [ ] **Axis system integration**: Consistent axis handling across plot types
+- [ ] **Tool integration**: Plotting tools working with different plot types
+
+#### Component compatibility
+- [ ] **Data format compatibility**: Consistent data format handling
+- [ ] **Parameter passing**: Correct parameter passing between components
+- [ ] **Event handling**: Proper event handling across components
+- [ ] **State synchronization**: State synchronization between components
+- [ ] **Error propagation**: Proper error propagation across module boundaries
+
+### 17.4 Real Data Testing
+
+#### Scientific datasets
+- [ ] **Plasma physics data**: Testing with real plasma physics datasets
+- [ ] **Time series data**: Testing with authentic time series data
+- [ ] **Multi-dimensional data**: Testing with complex multi-dimensional datasets
+- [ ] **Large datasets**: Testing with realistically large scientific datasets
+- [ ] **Edge case data**: Testing with challenging real-world data conditions
+
+#### Data format validation
+- [ ] **HDF5 integration**: Complete workflows with HDF5 data files
+- [ ] **CSV integration**: Workflows with CSV data sources
+- [ ] **NetCDF integration**: Integration with NetCDF scientific data files
+- [ ] **Pandas integration**: Deep integration with pandas DataFrames
+- [ ] **Custom formats**: Integration with domain-specific data formats
+
+### 17.5 Multi-Plot Integration
+
+#### Complex plotting scenarios
+- [ ] **Subplot workflows**: Complete workflows with multiple subplots
+- [ ] **Dashboard creation**: Dashboard-style multi-plot layouts
+- [ ] **Comparative plots**: Side-by-side comparison plot workflows
+- [ ] **Time series ensembles**: Multi-plot time series visualization workflows
+- [ ] **Statistical summaries**: Multi-plot statistical analysis workflows
+
+#### Plot coordination
+- [ ] **Shared axes**: Plots with shared axis coordination
+- [ ] **Synchronized zooming**: Coordinated zoom functionality across plots
+- [ ] **Shared legends**: Legend coordination across multiple plots
+- [ ] **Color consistency**: Consistent color schemes across related plots
+- [ ] **Layout management**: Proper layout management for complex arrangements
+
+### 17.6 Interactive Features Integration
+
+#### User interaction workflows
+- [ ] **Data selection**: Interactive data selection workflows
+- [ ] **Zoom interactions**: Interactive zoom functionality testing
+- [ ] **Pan interactions**: Interactive pan functionality testing
+- [ ] **Click events**: Click event handling in complete workflows
+- [ ] **Hover information**: Hover information display integration
+
+#### Interactive tool integration
+- [ ] **Selection tools**: Data selection tool integration
+- [ ] **Measurement tools**: Measurement tool functionality
+- [ ] **Annotation tools**: Interactive annotation capabilities
+- [ ] **Export from interaction**: Export functionality from interactive states
+- [ ] **State persistence**: Persistence of interactive states
+
+### 17.7 Output and Export Integration
+
+#### File format workflows
+- [ ] **PNG export**: Complete PNG export workflows
+- [ ] **PDF export**: Complete PDF export workflows with vector graphics
+- [ ] **SVG export**: Complete SVG export workflows
+- [ ] **EPS export**: Complete EPS export for publication
+- [ ] **Multi-format export**: Workflows exporting to multiple formats
+
+#### Output quality validation
+- [ ] **Resolution consistency**: Consistent resolution across export formats
+- [ ] **Color accuracy**: Color accuracy in exported files
+- [ ] **Text quality**: Text quality in exported files
+- [ ] **Vector accuracy**: Vector graphic accuracy in scalable formats
+- [ ] **Metadata preservation**: Metadata preservation in exported files
+
+### 17.8 Error Handling Integration
+
+#### Comprehensive error testing
+- [ ] **Data error recovery**: Recovery from data loading errors
+- [ ] **Plot error recovery**: Recovery from plot generation errors
+- [ ] **Export error recovery**: Recovery from export errors
+- [ ] **Memory error handling**: Handling of memory-related errors
+- [ ] **Resource error handling**: Handling of resource availability errors
+
+#### Error propagation
+- [ ] **Clear error messages**: Clear error messages throughout workflows
+- [ ] **Error context**: Proper error context information
+- [ ] **Graceful degradation**: Graceful degradation when errors occur
+- [ ] **Partial success handling**: Handling of partially successful workflows
+- [ ] **Error logging**: Comprehensive error logging throughout workflows
+
+### 17.9 Performance Integration Testing
+
+#### Workflow performance
+- [ ] **End-to-end timing**: Complete workflow execution timing
+- [ ] **Memory usage monitoring**: Memory usage throughout workflows
+- [ ] **Resource utilization**: CPU and I/O resource utilization
+- [ ] **Scalability testing**: Performance with varying data sizes
+- [ ] **Bottleneck identification**: Identification of performance bottlenecks
+
+#### Performance regression detection
+- [ ] **Baseline performance**: Established performance baselines
+- [ ] **Performance monitoring**: Automated performance monitoring
+- [ ] **Regression alerts**: Alerts for performance regressions
+- [ ] **Performance profiling**: Detailed performance profiling capabilities
+- [ ] **Optimization opportunities**: Identification of optimization opportunities
+
+### 17.10 Configuration Integration
+
+#### Configuration management
+- [ ] **Default configurations**: Testing with default configurations
+- [ ] **Custom configurations**: Testing with custom configurations
+- [ ] **Configuration validation**: Validation of configuration parameters
+- [ ] **Configuration inheritance**: Proper inheritance of configuration settings
+- [ ] **Dynamic configuration**: Dynamic configuration changes during workflows
+
+#### Environment integration
+- [ ] **Environment detection**: Automatic environment detection
+- [ ] **Platform-specific workflows**: Platform-specific workflow testing
+- [ ] **Dependency detection**: Automatic dependency detection and handling
+- [ ] **Feature detection**: Detection of available features and capabilities
+- [ ] **Fallback mechanisms**: Fallback mechanisms for missing features
+
+### 17.11 Documentation Integration
+
+#### Workflow documentation
+- [ ] **Example workflows**: Complete example workflow documentation
+- [ ] **Tutorial integration**: Integration with tutorial documentation
+- [ ] **API documentation**: API documentation validated through workflows
+- [ ] **Best practices**: Best practices documented through working examples
+- [ ] **Troubleshooting**: Troubleshooting guides validated through testing
+
+#### Living documentation
+- [ ] **Executable examples**: Documentation examples that run as tests
+- [ ] **Version synchronization**: Documentation synchronized with code versions
+- [ ] **Example validation**: Automated validation of documentation examples
+- [ ] **Coverage analysis**: Analysis of documentation coverage through integration tests
+- [ ] **User feedback integration**: Integration of user feedback into testing
+
+### 17.12 Continuous Integration
+
+#### CI/CD integration
+- [ ] **Automated workflow testing**: Automated integration test execution
+- [ ] **Multi-platform testing**: Integration tests across multiple platforms
+- [ ] **Version compatibility**: Testing across multiple dependency versions
+- [ ] **Nightly testing**: Comprehensive nightly integration test runs
+- [ ] **Performance tracking**: Automated performance tracking in CI
+
+#### Test reporting
+- [ ] **Comprehensive reporting**: Detailed integration test reporting
+- [ ] **Failure analysis**: Automated analysis of integration test failures
+- [ ] **Trend analysis**: Trend analysis of integration test results
+- [ ] **Artifact management**: Management of integration test artifacts
+- [ ] **Dashboard integration**: Integration with development dashboards
+
+### 17.13 User Acceptance Testing
+
+#### Realistic usage scenarios
+- [ ] **Research workflows**: Testing realistic research workflows
+- [ ] **Publication workflows**: Testing publication preparation workflows
+- [ ] **Presentation workflows**: Testing presentation preparation workflows
+- [ ] **Exploratory workflows**: Testing exploratory data analysis workflows
+- [ ] **Production workflows**: Testing production data processing workflows
+
+#### User experience validation
+- [ ] **Workflow simplicity**: Validation of workflow simplicity
+- [ ] **Error clarity**: Validation of error message clarity
+- [ ] **Performance expectations**: Validation of performance expectations
+- [ ] **Output quality**: Validation of output quality expectations
+- [ ] **Learning curve**: Validation of reasonable learning curve
+
+## 🎯 Testing Strategy
+
+### Implementation Approach
+1. **Core Workflows**: Start with fundamental data-to-plot workflows
+2. **Complex Scenarios**: Add multi-plot and interactive scenarios
+3. **Real Data Integration**: Incorporate authentic scientific datasets
+4. **Performance Validation**: Add performance and scalability testing
+
+### Success Metrics
+- **Workflow Coverage**: All major workflows tested end-to-end
+- **Error Recovery**: Robust error handling throughout workflows
+- **Performance**: Acceptable performance for realistic use cases
+- **User Experience**: Workflows meet user experience expectations
+
+### Quality Gates
+- All integration tests pass consistently
+- Performance baselines maintained
+- Real data workflows execute successfully
+- Error handling provides clear guidance to users
+
+---
+
+**Estimated Time**: 3 hours  
+**Dependencies**: All plotting modules, real scientific datasets  
+**Priority**: HIGH (Validates complete system functionality)
+
+**Status**: ✅ COMPLETED
+**Commit**: d097473
+**Tests Added**: 11 integration test cases
+**Time Invested**: 3 hours
+**Test Results**: 11/11 passing (100% success rate)