module fortplot !! Top-level public interface for fortplot - Modern Fortran plotting library !! !! This module serves as a thin facade that re-exports the complete fortplot API. !! It delegates all functionality to specialized modules while maintaining full !! backward compatibility with existing code. !! !! = Architecture = !! This module is organized as a facade pattern, delegating to: !! - fortplot_matplotlib: Matplotlib-compatible pyplot-style functions !! - fortplot_global: Global figure instance management !! - fortplot_figure_core: Core figure type and constants !! - fortplot_animation: Animation framework !! - fortplot_validation: Testing utilities !! - fortplot_colors: Color handling !! - fortplot_contour_regions: Contour extraction !! - fortplot_logging: Logging functionality !! !! = Key Types = !! - figure_t: Main plotting canvas for creating and managing plots !! - animation_t: Animation framework for dynamic visualizations !! - color_t: Advanced color handling with matplotlib syntax support !! - validation_result_t: Testing utilities for plot output validation !! !! = Core Plot Types = !! - Line plots: plot(), add_plot() - Basic line and scatter plotting !! - Contour plots: contour(), contourf() - 2D field visualization !! - Heat maps: pcolormesh() - Pseudocolor mesh plots !! - Vector fields: streamplot() - Flow visualization with streamlines !! - Statistical: hist(), boxplot(), errorbar() - Data distribution plots !! - 3D plots: add_3d_plot(), add_surface() - Three-dimensional visualization !! !! = Output Backends = !! - PNG: High-quality raster graphics for publications !! - PDF: Vector graphics for scalable documents !! - ASCII: Terminal-based plots for remote/headless environments !! !! = Two Output Paths = !! The pyplot-style `savefig()` and `figure_t%savefig()` always use the !! direct-render path (PNG, PDF, or ASCII), dispatched by file extension. !! They do NOT produce Vega-Lite JSON regardless of the suffix. !! !! The Vega-Lite spec path is a separate opt-in API: !! - Build marks: vl_line(), vl_point(), vl_bar(), vl_area() !! - Assemble: vl_layer_add(), vl_channel() !! - Export: figure_to_spec(), spec_to_json(), spec_to_json_file() !! - Persist: spec_savefig() !! !! Users porting mplvega scripts should note that mplvega's savefig dispatches !! on `.vl.json`/`.html` suffixes to produce Vega-Lite output; fortplot's !! savefig does not. Use the `vl_*`/`spec_*` API for that path. !! !! = Quick Start Examples = !! ! Simple line plot !! use fortplot !! call plot(x_data, y_data, label="measurements") !! call show() !! !! ! Advanced figure with multiple plots !! type(figure_t) :: fig !! call fig%initialize(800, 600) !! call fig%add_plot(x, y, label="data", linestyle='-') !! call fig%add_contour(x_grid, y_grid, z_field) !! call fig%legend() !! call fig%savefig('results.pdf') !! !! Author: fortplot contributors use iso_fortran_env, only: wp => real64 ! Core types and constants use fortplot_figure_core, only: figure_t use fortplot_datetime, only: datetime_t use fortplot_constants, only: EPSILON_COMPARE, EPSILON_GEOMETRY, & XLABEL_VERTICAL_OFFSET, YLABEL_HORIZONTAL_OFFSET, & TICK_MARK_LENGTH, TITLE_VERTICAL_OFFSET ! Animation functionality use fortplot_animation, only: animation_t, FuncAnimation ! Logging functionality use fortplot_logging, only: set_log_level, get_log_level, & LOG_LEVEL_SILENT, LOG_LEVEL_ERROR, & LOG_LEVEL_WARNING, LOG_LEVEL_INFO, LOG_LEVEL_DEBUG ! Validation functionality use fortplot_validation, only: validation_result_t, validate_file_exists, & validate_file_size, & validate_png_format, validate_pdf_format, & validate_ascii_format, & compare_with_baseline ! Color functionality use fortplot_colors, only: color_t, parse_color, parse_color_rgba, is_valid_color, & validate_color_for_backend, clear_color_cache ! Contour extraction functionality use fortplot_contour_regions, only: contour_region_t, contour_polygon_t, & extract_contour_regions ! Annotation functionality with coordinate constants use fortplot_annotations, only: COORD_DATA, COORD_FIGURE, COORD_AXIS ! Vega-Lite spec types and builder API use fortplot_spec_types, only: spec_t, mark_t, encoding_t, channel_t, & data_t, data_column_t, scale_t, axis_t, & layer_t use fortplot_spec_builder, only: vl_line, vl_point, vl_bar, vl_area, & vl_layer_add, vl_channel, spec_savefig use fortplot_spec_frontend_adapters, only: figure_to_spec use fortplot_spec_json, only: spec_to_json, spec_to_json_file, & escape_json_string use fortplot_spec_json_parse, only: json_to_spec ! Matplotlib-compatible API (all pyplot-style functions) use fortplot_matplotlib, only: plot, contour, contour_filled, contourf, & pcolormesh, streamplot, quiver, add_quiver, & hist, histogram, scatter, errorbar, boxplot, & bar, barh, text, annotate, & imshow, pie, polar, step, stem, & fill, fill_between, twinx, twiny, colorbar, & xlabel, ylabel, title, suptitle, legend, grid, & savefig, savefig_with_status, figure, subplot, & subplots, subplots_grid, & add_plot, add_contour, add_contour_filled, & add_contourf, & add_pcolormesh, add_errorbar, & add_3d_plot, add_surface, add_scatter, & set_xscale, set_yscale, xscale, yscale, & xlim, ylim, & set_line_width, set_ydata, use_axis, & get_active_axis, minorticks_on, & axhline, axvline, hlines, vlines, & set_xticks, set_yticks, & show, show_viewer, & ion, ioff, draw, pause, & ensure_global_figure_initialized, get_global_figure implicit none private ! ========================================================================= ! PUBLIC INTERFACE RE-EXPORTS ! ========================================================================= ! Core types and constants public :: figure_t, datetime_t, wp ! Numerical constants public :: EPSILON_COMPARE, EPSILON_GEOMETRY, & XLABEL_VERTICAL_OFFSET, YLABEL_HORIZONTAL_OFFSET, TICK_MARK_LENGTH, & TITLE_VERTICAL_OFFSET ! Coordinate system constants for annotations public :: COORD_DATA, COORD_FIGURE, COORD_AXIS ! Matplotlib-compatible plotting functions public :: plot, contour, contour_filled, contourf, pcolormesh public :: streamplot, quiver public :: add_quiver public :: hist, histogram, scatter, errorbar, boxplot public :: bar, barh public :: imshow, pie, polar, step, stem public :: fill, fill_between, twinx, twiny public :: colorbar public :: text, annotate public :: axhline, axvline, hlines, vlines ! Figure management and configuration public :: figure, subplot, subplots, subplots_grid public :: xlabel, ylabel, title, suptitle, legend, grid public :: xlim, ylim, set_xscale, set_yscale, xscale, yscale public :: set_line_width, set_ydata, use_axis, get_active_axis, minorticks_on public :: set_xticks, set_yticks public :: savefig, savefig_with_status ! Extended plotting functions public :: add_plot, add_contour, add_contour_filled, add_contourf public :: add_pcolormesh public :: add_errorbar, add_3d_plot, add_surface, add_scatter ! Display functions public :: show, show_viewer public :: ion, ioff, draw, pause ! Global figure access public :: ensure_global_figure_initialized, get_global_figure ! Animation interface public :: animation_t, FuncAnimation ! Logging interface public :: set_log_level, get_log_level public :: LOG_LEVEL_SILENT, LOG_LEVEL_ERROR public :: LOG_LEVEL_WARNING, LOG_LEVEL_INFO, LOG_LEVEL_DEBUG ! Validation interface public :: validation_result_t public :: validate_file_exists, validate_file_size public :: validate_png_format, validate_pdf_format, validate_ascii_format public :: compare_with_baseline ! Color interface public :: color_t public :: parse_color, parse_color_rgba, is_valid_color public :: validate_color_for_backend, clear_color_cache ! Contour region extraction interface public :: contour_region_t, contour_polygon_t, extract_contour_regions ! Vega-Lite spec types public :: spec_t, mark_t, encoding_t, channel_t public :: data_t, data_column_t, scale_t, axis_t, layer_t ! Vega-Lite builder API public :: vl_line, vl_point, vl_bar, vl_area public :: vl_layer_add, vl_channel public :: spec_savefig, figure_to_spec public :: spec_to_json, spec_to_json_file, json_to_spec public :: escape_json_string ! ========================================================================= ! STYLE CONSTANTS (matplotlib-compatible) ! ========================================================================= ! Line style constants !! Solid line style for continuous data visualization !! Usage: call plot(x, y, linestyle=LINESTYLE_SOLID) !! Visual: ———————————————————— character(len=*), parameter, public :: LINESTYLE_SOLID = '-' !! Dashed line style for highlighting trends or secondary data !! Usage: call plot(x, y, linestyle=LINESTYLE_DASHED) !! Visual: ---- ---- ---- ---- character(len=*), parameter, public :: LINESTYLE_DASHED = '--' !! Dotted line style for reference lines or uncertainty bounds !! Usage: call plot(x, y, linestyle=LINESTYLE_DOTTED) !! Visual: •••••••••••••••••••• character(len=*), parameter, public :: LINESTYLE_DOTTED = ':' !! Dash-dot line style for mixed emphasis visualization !! Usage: call plot(x, y, linestyle=LINESTYLE_DASHDOT) !! Visual: ——•——•——•——• character(len=*), parameter, public :: LINESTYLE_DASHDOT = '-.' !! No line style - displays only markers without connecting lines !! Usage: call plot(x, y, linestyle=LINESTYLE_NONE) !! Visual: • • • • (markers only) character(len=*), parameter, public :: LINESTYLE_NONE = 'None' ! Marker style constants !! Circular markers for standard data point visualization !! Usage: call scatter(x, y, marker=MARKER_CIRCLE) !! Visual: ● (filled circle) character(len=*), parameter, public :: MARKER_CIRCLE = 'o' !! Cross-shaped markers for outliers or special data points !! Usage: call scatter(x, y, marker=MARKER_CROSS) !! Visual: ✕ (diagonal cross) character(len=*), parameter, public :: MARKER_CROSS = 'x' !! Square markers for categorical or discrete data visualization !! Usage: call scatter(x, y, marker=MARKER_SQUARE) !! Visual: ■ (filled square) character(len=*), parameter, public :: MARKER_SQUARE = 's' !! Diamond-shaped markers for highlighting key data points !! Usage: call scatter(x, y, marker=MARKER_DIAMOND) !! Visual: ♦ (filled diamond) character(len=*), parameter, public :: MARKER_DIAMOND = 'D' !! Plus-sign markers for positive values or additive data !! Usage: call scatter(x, y, marker=MARKER_PLUS) !! Visual: ＋ (orthogonal plus) character(len=*), parameter, public :: MARKER_PLUS = '+' !! Star-shaped markers for exceptional or peak values !! Usage: call scatter(x, y, marker=MARKER_STAR) !! Visual: ★ (filled star) character(len=*), parameter, public :: MARKER_STAR = '*' !! Upward triangle markers for increasing trends or maxima !! Usage: call scatter(x, y, marker=MARKER_TRIANGLE_UP) !! Visual: ▲ (filled upward triangle) character(len=*), parameter, public :: MARKER_TRIANGLE_UP = '^' !! Downward triangle markers for decreasing trends or minima !! Usage: call scatter(x, y, marker=MARKER_TRIANGLE_DOWN) !! Visual: ▼ (filled downward triangle) character(len=*), parameter, public :: MARKER_TRIANGLE_DOWN = 'v' !! Pentagon-shaped markers for specialized scientific data !! Usage: call scatter(x, y, marker=MARKER_PENTAGON) !! Visual: ⬟ (filled pentagon) character(len=*), parameter, public :: MARKER_PENTAGON = 'p' !! Hexagon-shaped markers for crystallographic or geometric data !! Usage: call scatter(x, y, marker=MARKER_HEXAGON) !! Visual: ⬢ (filled hexagon) character(len=*), parameter, public :: MARKER_HEXAGON = 'h' ! This module is now a pure facade - no implementation code needed ! All functionality is delegated to the specialized modules above end module fortplot