Package pulse.search.direction

Class PathOptimiser

  • All Implemented Interfaces:
    Serializable, Descriptive, Reflexive
    Direct Known Subclasses:
    GradientBasedOptimiser, ParticleSwarmOptimiser
    public abstract class PathOptimiser
extends PropertyHolder
implements Reflexive
    An abstract class that defines the mathematical basis of solving the reverse heat conduction problem.

    Defines the method for calculating the gradient of the target function (the sum of squared residuals, SSR) and a search iteration method, which is used in the main loop of the SearchTask's run method. Declares (but not defines!) the methods for finding the direction of the minimum. This class is closely linked with another abstract search class, the LinearSolver.

    See Also:
    LinearOptimiser, Serialized Form

    • Constructor Detail

      • PathOptimiser

        protected PathOptimiser()
        Abstract constructor that sets up the default ITERATION_LIMIT, ERROR_TOLERANCE and GRADIENT_RESOLUTION for this PathSolver. In addition, sets up a list of search flags defined by the Flag.defaultList method.

    • Method Detail

      • reset

        public void reset()
        Resets the default ITERATION_LIMIT, ERROR_TOLERANCE and GRADIENT_RESOLUTION values for this PathSolver. In addition, sets up a list of search flags defined by the Flag.defaultList method.

      • iteration

        public abstract boolean iteration​(GeneralTask task)
                           throws SolverException

        This method sets out the basic algorithm for estimating the minimum of the target function, which is defined as the sum of squared residuals (SSR), or the deviations of the model solution (a DifferenceScheme used to solve the Problem for this task) from the empirical values (the ExperimentalData). The algorithm will go through the following steps: (1) find the direction, which points to the minimum, using the concrete direction method; (2) estimate the magnitude of the step to reach the minimum using the LinearSolver; (3) assign a new set of parameters to the SearchTask; (4) calculate the new SSR value.

        Parameters:
        task - a SearchTask that needs to be driven to a minimum of SSR.
        Returns:
        the SSR value with the newly found parameters.
        Throws:
        SolverException
        See Also:
        direction(Path), LinearOptimiser

      • prepare

        public abstract void prepare​(GeneralTask task)
                      throws SolverException
        Defines a set of procedures to be run at the end of the search iteration.
        Parameters:
        task - the SearchTask undergoing optimisation
        Throws:
        SolverException

      • setErrorTolerance

        public void setErrorTolerance​(NumericProperty errorTolerance)

      • setMaxIterations

        public void setMaxIterations​(NumericProperty maxIterations)

      • genericProperties

        public List<Property> genericProperties()
        This method has been overriden to account for each individual flag in the List<Flag> set out by this class.
        Overrides:
        genericProperties in class Accessible
        Returns:
        This will return a List<Property> containing all properties belonging to this Accessible, which are not assignable from the NumericProperty class.

      • listedKeywords

        public Set<NumericPropertyKeyword> listedKeywords()

        The types of the listed parameters for this class include: ERROR_TOLERANCE, ITERATION_LIMIT. Also, all the flags in this class are treated as separate listed parameters.

        Overrides:
        listedKeywords in class PropertyHolder
        Returns:
        a set of NumericPropertyKeyword instances, which have been explicitly marked as a listed parameter for this PropertyHolder.
        See Also:
        NumericPropertyKeyword

      • set

        public void set​(NumericPropertyKeyword type,
                NumericProperty property)
        The accepted types are: ERROR_TOLERANCE, ITERATION_LIMIT.
        Specified by:
        set in class Accessible
        Parameters:
        type - the type, which must be equal by definition to property.getType().
        property - the property, which contains new information.

      • ignoreSiblings

        public boolean ignoreSiblings()
        Description copied from class: PropertyHolder
        Should Accessibles that belong to this PropertyHolder be ignored when this PropertyHolder is displayed in a table?
        Overrides:
        ignoreSiblings in class PropertyHolder
        Returns:
        false for PathSolver
        See Also:
        PropertyHolderTable

      • update

        public void update​(Property property)
        Finds a Flag equivalent to flag in the originalList and substitutes its value with flag.getValue.
        Overrides:
        update in class Accessible
        Parameters:
        property - the Property, which will update a similar property of this Accessible.

      • setInstance

        public static void setInstance​(PathOptimiser selectedPathOptimiser)

      • compatibleWith

        public boolean compatibleWith​(OptimiserStatistic os)
        Checks if this optimiser is compatible with the statistic passed to the method as its argument.By default, this will accept any OptimiserStatistic
        Parameters:
        os - a selected optimiser metric
        Returns:
        true, if not specified otherwise by its subclass implementation.

      • initState

        public abstract IterativeState initState​(GeneralTask t)
        Creates a new Path suitable for this PathSolver
        Parameters:
        t - the task, the optimisation path of which will be tracked
        Returns:
        a Path instance