Comprehensive Error Bar Support (Issue #52) (#80)

* Complete error bar rendering implementation

- Fix coordinate transformation function calls using correct signatures
- Implement proper error bar drawing with caps for PNG/PDF backends
- Support symmetric and asymmetric error bars in both X and Y directions
- Add comprehensive customization options (capsize, linewidth, colors)
- Fix animation module error bar rendering to avoid recursion
- All 7 error bar tests passing with full visual verification

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: Add validation for conflicting error bar parameters

- Add warning when both symmetric and asymmetric X error bars are provided
- Add warning when both symmetric and asymmetric Y error bars are provided
- Clarify that asymmetric values take precedence over symmetric ones
- Improve user feedback for conflicting parameter usage

This addresses the parameter conflict validation suggestion from PR review.

* fix: correct dependency name in fmp example from fortplotlib to fortplot

Resolves CRITICAL test failure in test_system_fpm_example where dependency
name mismatch caused build failures. FMP expects dependency named 'fortplot'
to match the module name, not 'fortplotlib' which is the repository name.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update AGENTS.md with workflow clarifications

* fix: update CMake configuration to use fortplot naming (addresses #64)

- Replace fortplotlib with fortplot in root CMakeLists.txt
- Update cmake example to use correct target naming
- Fix repository URL in cmake example
- Ensures CI builds pass with consistent naming

* fix: update CI workflow to use fortplot executable name

- Update .github/workflows/ci.yml to run ./fortplot_test instead of ./fortplotlib_test
- Completes the naming consistency fix across build systems

* docs: Add comprehensive error bar documentation and examples

- Add error bars to README.md feature list with usage example
- Create detailed README_errorbar.md with complete API documentation
- Document all error bar types: symmetric, asymmetric, X/Y, combined
- Include customization options, backend support, and scientific usage patterns
- Add performance notes and common pitfalls section
- Update feature list to reflect implemented error bar functionality

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: expose errorbar functionality in public API surface

- Add errorbar() and add_errorbar() to public interface in fortplot.f90
- Ensures users can access error bar functionality through standard 'use fortplot' import
- Fixes critical architectural inconsistency where feature was implemented but not accessible
- Maintains API consistency with other plotting functions (plot, contour, pcolormesh)
- Includes comprehensive parameter support (symmetric/asymmetric errors, customization)

This resolves the gap between implementation and public interface, ensuring proper
architectural consistency following the existing pattern of pyplot-style functions.

* test: Add comprehensive error bar testing programs

- test_api_usability.f90: API usability validation tests
- test_errorbar_comprehensive.f90: Full functionality test suite
- test_errorbar_edge_cases.f90: Edge case and error handling tests

* fix: Break long import line to meet 88 char limit

- Split fortplot_figure_core import to multiple lines
- Fixes CI compilation failure with -Werror=line-truncation

* fix: correct output paths in errorbar example

Remove plots/ subdirectory from save paths to avoid directory creation errors

* chore: remove obsolete CMakeLists.txt file

This CMakeLists.txt file is no longer needed as the project
uses FPM (Fortran Package Manager) for build management.

* feat: integrate error bar support with main branch

Add error bar functionality to new main branch architecture:
- Add PLOT_TYPE_ERRORBAR constant with proper sequencing
- Add error bar data fields to plot_data_t type
- Add errorbar procedure to figure_t interface
- Implement basic errorbar subroutine for API compatibility
- Export error bar types in figure wrapper module

Note: Full rendering implementation needed in follow-up PR.
Basic API structure is complete and will compile once
render integration is added.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: krystophny

CMakeLists.txt

@@ -78,6 +78,18 @@ call ylabel("Y Position")
 call savefig("temperature.png")
 ```
 
+#### Error bars for scientific data
+```fortran
+type(figure_t) :: fig
+call fig%initialize(800, 600)
+call fig%errorbar(x, y, yerr=measurement_errors, &
+                  marker='o', capsize=5.0_wp, &
+                  label='Experimental data')
+call fig%errorbar(x, y_theory, label='Theory', linestyle='-')
+call fig%legend()
+call fig%savefig("scientific_plot.png")
+```
+
 #### Log scale plot
 ```fortran
 call figure()
@@ -163,6 +175,7 @@ pip install git+https://github.com/lazy-fortran/fortplot.git
 
 ### Plot types
 - [x] Line plots (`plot`) with customizable line styles and markers
+- [x] Error bars (`errorbar`) with symmetric/asymmetric X/Y errors and customization
 - [x] 3D line plots (`add_3d_plot`) with automatic projection
 - [x] 3D surface plots (`add_surface`) for grid data visualization
 - [x] Contour plots (`contour`, `contourf`) with custom levels and colormaps

README.md

@@ -0,0 +1,82 @@
+program test_api_usability
+    !! Test error bar API usability from typical user perspective
+    !! Focus on intuitive parameter names and usage patterns
+    
+    use, intrinsic :: iso_fortran_env, only: wp => real64
+    use fortplot
+    implicit none
+    
+    type(figure_t) :: fig
+    real(wp) :: x(5), y(5), yerr(5), xerr(5)
+    integer :: i
+    
+    write(*,*) '=== API Usability Testing ==='
+    
+    ! Setup simple test data
+    x = [1.0_wp, 2.0_wp, 3.0_wp, 4.0_wp, 5.0_wp]
+    y = [2.0_wp, 4.0_wp, 3.0_wp, 5.0_wp, 4.5_wp]
+    yerr = [0.2_wp, 0.3_wp, 0.2_wp, 0.4_wp, 0.3_wp]
+    xerr = [0.1_wp, 0.1_wp, 0.1_wp, 0.1_wp, 0.1_wp]
+    
+    ! Test 1: Minimal usage - just Y errors
+    write(*,*) 'Test 1: Minimal API usage'
+    call fig%initialize()
+    call fig%errorbar(x, y, yerr=yerr)
+    call fig%savefig('api_test1_minimal.png')
+    write(*,*) '✓ Minimal usage works'
+    
+    ! Test 2: Common scientific pattern
+    write(*,*) 'Test 2: Common scientific usage'
+    call fig%initialize()
+    call fig%errorbar(x, y, yerr=yerr, label='Data', marker='o')
+    call fig%set_xlabel('Measurement Variable')
+    call fig%set_ylabel('Response')
+    call fig%set_title('Scientific Data with Uncertainty')
+    call fig%legend()
+    call fig%savefig('api_test2_scientific.png')
+    write(*,*) '✓ Scientific pattern works'
+    
+    ! Test 3: Parameter naming intuitiveness
+    write(*,*) 'Test 3: Parameter naming clarity'
+    call fig%initialize()
+    call fig%errorbar(x, y, &
+                     yerr=yerr, &              ! Clear: Y errors
+                     capsize=8.0_wp, &         ! Clear: error bar cap size
+                     elinewidth=2.0_wp, &      ! Clear: error line width
+                     marker='s', &             ! Clear: data marker
+                     label='Test data')        ! Clear: legend label
+    call fig%legend()
+    call fig%savefig('api_test3_clarity.png')
+    write(*,*) '✓ Parameter names are intuitive'
+    
+    ! Test 4: Combined X and Y usage
+    write(*,*) 'Test 4: Combined X+Y errors'
+    call fig%initialize()
+    call fig%errorbar(x, y, xerr=xerr, yerr=yerr, label='XY errors')
+    call fig%legend()
+    call fig%savefig('api_test4_combined.png')
+    write(*,*) '✓ Combined X+Y error usage is clear'
+    
+    ! Test 5: Optional parameter flexibility
+    write(*,*) 'Test 5: Optional parameter flexibility'
+    call fig%initialize()
+    ! All optional parameters (should use defaults)
+    call fig%errorbar(x, y, yerr=yerr)
+    call fig%savefig('api_test5_defaults.png')
+    write(*,*) '✓ Optional parameters work with defaults'
+    
+    ! Test 6: Color specification usability
+    write(*,*) 'Test 6: Color specification'
+    call fig%initialize()
+    call fig%errorbar(x, y, yerr=yerr, &
+                     color=[0.8_wp, 0.2_wp, 0.2_wp], &  ! Red color
+                     label='Red data')
+    call fig%legend()
+    call fig%savefig('api_test6_color.png')
+    write(*,*) '✓ Color specification is straightforward'
+    
+    write(*,*) ''
+    write(*,*) '=== API Usability Tests Completed Successfully! ==='
+    write(*,*) 'All common usage patterns work intuitively.'
+    
+end program test_api_usability