Package jline.solvers

Class Solver

java.lang.Object
jline.solvers.Solver
Direct Known Subclasses:
EnsembleSolver, NetworkSolver, SolverLQNS
public abstract class Solver extends Object
Abstract base class for model solution algorithms and analysis tools.

This class provides the fundamental infrastructure for solving queueing models using various analytical and simulation algorithms. It manages solver configuration, result storage, random number generation, and validation of solver options.

Concrete implementations must provide the runAnalyzer() method to perform the actual model solution.

See Also:

  • Field Details

    • model

      public Model model
      The model to be solved

    • name

      public String name
      Name identifier for this solver instance

    • options

      public SolverOptions options
      Configuration options for the solver

    • result

      public SolverResult result
      Results from the most recent solver execution

    • enableChecks

      public boolean enableChecks
      Flag controlling whether to perform validation checks

    • random

      public Random random
      Random number generator for stochastic algorithms

  • Constructor Details

    • Solver

      protected Solver(String name, SolverOptions options)
      Constructs a solver with the specified name and options.
      Parameters:
      name - the solver name identifier
      options - configuration options for the solver

    • Solver

      protected Solver(Model model, String name, SolverOptions options)
      Constructs a solver with the specified model, name, and options.
      Parameters:
      model - the model to be solved
      name - the solver name identifier
      options - configuration options for the solver

    • Solver

      protected Solver(String name)
      Constructs a solver with the specified name using default options.
      Parameters:
      name - the solver name identifier

  • Method Details

    • defaultOptions

      public static SolverOptions defaultOptions()
      Returns a new SolverOptions instance with default settings.
      Returns:
      default solver options

    • listValidOptions

      public static Map<String,List<String>> listValidOptions()
      Returns lists of valid options and methods supported by solvers.
      Returns:
      map containing "allOptions" and "allMethods" lists

    • parseOptions

      public static SolverOptions parseOptions(Object... varargin) throws IllegalArgumentException
      Parses option parameters into a SolverOptions data structure.
      Parameters:
      varargin - variable arguments in key-value pairs
      Returns:
      parsed solver options
      Throws:
      IllegalArgumentException - if arguments are invalid

    • parseOptions

      public static SolverOptions parseOptions(SolverOptions options, Object... varargin) throws IllegalArgumentException
      Parses option parameters into an existing SolverOptions instance.
      Parameters:
      options - existing options object to modify
      varargin - variable arguments in key-value pairs
      Returns:
      modified solver options
      Throws:
      IllegalArgumentException - if arguments are invalid

    • getName

      public String getName()
      Returns the name identifier of this solver.
      Returns:
      the solver name

    • getOptions

      public SolverOptions getOptions()
      Returns the current solver options.
      Returns:
      the solver options

    • setOptions

      public void setOptions(SolverOptions options)
      Sets new solver options.
      Parameters:
      options - the new solver options to set

    • getResults

      public SolverResult getResults()
      Returns the results from the most recent solver execution.
      Returns:
      the solver results

    • hasResults

      public boolean hasResults()
      Checks if the solver has computed results.
      Returns:
      true if results are available, false otherwise

    • isJavaAvailable

      public boolean isJavaAvailable()
      Checks if Java runtime is available for solver execution. Always returns true in this Java implementation.
      Returns:
      true indicating Java is available

    • isValidOption

      public boolean isValidOption(String optName)
      Checks if the specified option name is valid for this solver.
      Parameters:
      optName - the option name to validate
      Returns:
      true if the option is valid, false otherwise

    • reset

      public void reset()
      Clears previously stored results and resets the random number generator.

    • resetRandomGeneratorSeed

      public void resetRandomGeneratorSeed(long seed)
      Assigns a new seed to the random number generator. This sets the master seed for all random number generation in the system.
      Parameters:
      seed - the seed value for random number generation

    • runAnalyzer

      public abstract void runAnalyzer() throws IllegalAccessException, ParserConfigurationException, IOException
      Executes the solver algorithm to analyze the model. This abstract method must be implemented by concrete solver classes.
      Throws:
      IllegalAccessException - if access to required resources is denied
      ParserConfigurationException - if XML parsing configuration fails
      IOException - if I/O operations fail

    • runAnalyzerChecks

      public void runAnalyzerChecks(SolverOptions options)
      Performs validation checks before running the analyzer. Verifies model compatibility and method validity.
      Parameters:
      options - the solver options to validate
      Throws:
      RuntimeException - if validation fails

    • setChecks

      public void setChecks(boolean bool)
      Enables or disables validation checks during solver execution.
      Parameters:
      bool - true to enable checks, false to disable

    • supports

      public boolean supports(Network model)
      Checks if this solver supports the given network model. Default implementation returns true; subclasses should override to provide specific feature validation.
      Parameters:
      model - the network model to check
      Returns:
      true if the model is supported, false otherwise