Progress.H File Reference

Progress bar for iterative solvers. More...

#include <fmt/color.h>
#include <fmt/core.h>
#include <string>

Include dependency graph for Progress.H:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	printIterationProgress (const std::string &solver, int iter, int maxIter, double error, double tol, int barWidth=50)
	Print an iteration progress line for a solver.
void	printConvergenceStatus (const std::string &solver, bool converged, int iter, int maxIter, double error, double tol, int barWidth=50)
	Print the final convergence status line.

Detailed Description

Progress bar for iterative solvers.

Provides a colored terminal progress bar that shows solver convergence status in real-time. Green fill indicates progress; red indicates failure.

Definition in file Progress.H.

Function Documentation

printConvergenceStatus()

void printConvergenceStatus ( const std::string &  solver, bool  converged, int  iter, int  maxIter, double  error, double  tol, int  barWidth = 50  )

inline

Print the final convergence status line.

Overwrites the progress bar with a final status:

• Green bar (partial) + "CONVERGED" if converged
• Red bar at failure point + "FAILED" if not converged

Parameters

solver	Solver name
converged	Whether the solver converged
iter	Final iteration count
maxIter	Maximum allowed iterations
error	Final mismatch/error value
tol	Convergence tolerance
barWidth	Width of the progress bar in characters (default: 50)

Definition at line 100 of file Progress.H.

  {
    // Overwrite the last progress line
    fmt::print("\033[1F\033[2K");
 
    float ratio = maxIter == 0 ? 0.0f : static_cast<float>(iter) / maxIter;
    int filled = static_cast<int>(ratio * barWidth);
 
    fmt::print(fg(fmt::color::cyan) | fmt::emphasis::bold, "{:<16}", solver);
 
    if (converged) {
        // Green bar up to convergence point, gray for the rest
        for (int i = 0; i < filled; ++i)
            fmt::print(bg(fmt::color::green), " ");
        for (int i = filled; i < barWidth; ++i)
            fmt::print(bg(fmt::color::dark_gray), " ");
        fmt::print("\033[0m");
 
        fmt::print("  ");
        fmt::print(fg(fmt::color::green) | fmt::emphasis::bold, "CONVERGED");
        fmt::print(fg(fmt::color::white), " in ");
        fmt::print(fg(fmt::color::yellow) | fmt::emphasis::bold, "{}", iter);
        fmt::print(fg(fmt::color::white), " iterations");
        fmt::print(fg(fmt::color::white), "  error {:.6e}\n", error);
    } else {
        // Red bar up to failure point, dark gray for the rest
        for (int i = 0; i < filled; ++i)
            fmt::print(bg(fmt::color::red), " ");
        for (int i = filled; i < barWidth; ++i)
            fmt::print(bg(fmt::color::dark_gray), " ");
        fmt::print("\033[0m");
 
        fmt::print("  ");
        fmt::print(fg(fmt::color::red) | fmt::emphasis::bold, "FAILED");
        fmt::print(fg(fmt::color::white), " after ");
        fmt::print(fg(fmt::color::yellow) | fmt::emphasis::bold, "{}", iter);
        fmt::print(fg(fmt::color::white), " iterations");
        fmt::print(fg(fmt::color::white), "  error {:.6e}\n", error);
    }
}

Here is the caller graph for this function:

printIterationProgress()

void printIterationProgress ( const std::string &  solver, int  iter, int  maxIter, double  error, double  tol, int  barWidth = 50  )

inline

Print an iteration progress line for a solver.

Displays a colored progress bar with iteration count and error magnitude.

• Green bar: proportional to iterations completed out of maxIter
• Red bar at failure point when solver diverges

Parameters

solver	Solver name (e.g. "Newton-Raphson", "Gauss-Seidel")
iter	Current iteration number (1-based)
maxIter	Maximum allowed iterations
error	Current mismatch/error value
tol	Convergence tolerance
barWidth	Width of the progress bar in characters (default: 50)

Definition at line 50 of file Progress.H.

  {
    float ratio = maxIter == 0 ? 0.0f : static_cast<float>(iter) / maxIter;
    int filled = static_cast<int>(ratio * barWidth);
 
    // Move cursor up to overwrite previous line (except on first iteration)
    if (iter > 1)
        fmt::print("\033[1F\033[2K");
 
    fmt::print(fg(fmt::color::cyan) | fmt::emphasis::bold, "{:<16}", solver);
 
    // Progress bar
    for (int i = 0; i < filled; ++i)
        fmt::print(bg(fmt::color::green), " ");
    for (int i = filled; i < barWidth; ++i)
        fmt::print(bg(fmt::color::dark_gray), " ");
 
    // Reset colors
    fmt::print("\033[0m");
 
    // Stats
    fmt::print("  iter ");
    fmt::print(fg(fmt::color::yellow) | fmt::emphasis::bold, "{:>4}", iter);
    fmt::print(fg(fmt::color::white), "/{:<4}", maxIter);
    fmt::print("  error ");
    fmt::print(fg(fmt::color::yellow), "{:.6e}", error);
    fmt::print(fg(fmt::color::white), "  tol {:.0e}\n", tol);
}

Here is the caller graph for this function: